Claude Code artık tek bir oturumda birden fazla dizinle çalışmayı `--add-dir` bayrağı ve `/add-dir` etkileşimli komutunu kullanarak destekliyor. Bu, projeler arasında sürekli bağlam değiştirmeyi ortadan kaldırır.
Çok Dizinli Destek Nedir
Temel İşlevsellik
`--add-dir /path/to/dir` bayrağı, çalışma dizininizi değiştirmeden dizinleri Claude Code oturumunuza ekler. Etkileşimli oturumlar sırasında çalışma alanınızı dinamik olarak genişletmek için `/add-dir <path>` komutunu kullanın.

Claude Code, performansı korurken farklı dizin yapıları arasındaki dosya ilişkilerini sürdürür. Eklenen dizinlerdeki dosyalara başvurduğunuzda sistem yol çözümlemesini otomatik olarak yönetir.
Temel Kullanım Alanları
Monorepolar
Oturum değiştirmeden ön uç, arka uç ve paylaşılan modüller arasında çalışın. Mantıksal ayrıma sahip büyük uygulamalar, tüm bileşenlere birleşik erişimden faydalanır.

Paylaşılan Yapılandırma Dosyaları
Ayrı konumlarda depolanan yapılandırma dosyalarına, belgelere ve geliştirme yapıtlarına erişin. Kişisel üretkenlik dosyaları ve ekip belgeleri, oturumlar arasında sürekli olarak erişilebilir hale gelir.
Çapraz Proje Geliştirme
Birbirine bağlı depoları eş zamanlı olarak yönetin. API istemcileri sunucu uygulamalarıyla senkronize kalır. Belgeler, kod değişiklikleriyle birlikte güncellenir.
Uygulama Stratejileri
Çalışma Alanı Kurulumu
- Birincil çalışma dizininizi belirleyin
- `--add-dir` kullanarak ilgili dizinleri ekleyin
- Yaygın yapılandırmalar için kabuk takma adları (shell alias) oluşturun
- Ekip genelinde dizin desenleri oluşturun
Performans Optimizasyonu
- Yalnızca aktif olarak kullandığınız dizinleri ekleyin
- Derleme yapıtları içeren dizinlerden kaçının
- Büyük yapılandırmalarda bağlam belirteci kullanımını izleyin
- Güvenilir erişim için mutlak yollar kullanın
Geliştirme Entegrasyonu
Çok dizinli destek, mevcut Git iş akışları, CI sistemleri ve dağıtım hatları ile çalışır. Apidog gibi API geliştirme araçları, birden fazla proje dizinindeki spesifikasyonları izleyebilir.
Pratik Örnekler
Mikroservis Mimarisi
Hizmet uygulamalarına, paylaşılan kütüphanelere, yapılandırma şablonlarına ve dağıtım betiklerine tek bir oturumda erişin. Yeni hizmetler geliştirirken mevcut desenlere başvurun.
Açık Kaynak Katkıları
Çatallanmış depolar, yukarı akış kaynakları ve kişisel yapılandırmalarla eş zamanlı olarak çalışın. Tüm ilgili kod tabanlarına erişirken temiz katkılar sağlayın.
Kod Olarak Altyapı
Uygulama tanımlarını, dağıtım yapılandırmalarını ve izleme kurulumlarını birden fazla depoda yönetin. Altyapı değişiklikleri sırasında tutarlılığı koruyun.
En İyi Uygulamalar
Yapılandırma Yönetimi
Çözümleme sorunlarından kaçınmak için mutlak yollar kullanın. Tüm dizinler için okuma izinlerini doğrulayın. Ekip tutarlılığı için standartlaştırılmış kurulumlar oluşturun.
Güvenlik Hususları
Dizin içeriklerini eklemeden önce gözden geçirin. Hassas bilgileri ve üretim kimlik bilgilerini hariç tutun. Özel geliştirme dizinleri kullanın.
Performans İzleme
Kapsamlı dizin yapılarıyla bellek kullanımını izleyin. Yerel dizinler, ağa bağlı olanlardan daha iyi performans sağlar. Kullanılmayan dizinleri oturumlardan kaldırın.
Gelişmiş Özellikler
Komut Satırı Entegrasyonu
claude-code --add-dir /path/to/backend --add-dir /path/to/frontend
Etkileşimli Komutlar
/add-dir /path/to/shared-config
/add-dir /path/to/documentation
Ekip İş Akışları
Ekipler arasında çok dizinli yapılandırmaları standartlaştırın. Tutarlı geliştirici deneyimi için yaygın desenleri belgeleyin. İşe alım süreçleriyle entegre edin.
API Geliştirme İş Akışı
Çok dizinli destek, API öncelikli geliştirmeyi iyileştirir. Arka uç hizmetleri, belgeler, istemci SDK'ları ve test paketleri genellikle ayrı depolarda bulunur ancak senkronize güncellemeler gerektirir.
Apidog, çok dizinli çalışma alanınızda çalışan birleşik test arayüzleri sunar. Bu, birden fazla projeyi kapsayan özellikler geliştirirken API tutarlılığını sağlar.

Yaygın Sorun Giderme
Yol Çözümleme Sorunları
- Göreceli yollar yerine mutlak yollar kullanın
- Sembolik bağlantıların doğru çalıştığını doğrulayın
- Dizin izinlerini kontrol edin
Performans Sorunları
- Eklenen dizinleri gerekli olanlarla sınırlayın
- Sistem kaynaklarını izleyin
- Uzun oturumlar sırasında kullanılmayan dizinleri kaldırın
Erişim Kontrolü
- Uygun okuma izinlerini sağlayın
- Hassas veriler içeren dizinleri eklemekten kaçının
- Geliştirmeye özel dizin yapıları kullanın
Gelecekteki Geliştirmeler
Topluluk, kalıcı çalışma alanı kurulumları için yapılandırma dosyaları talep ediyor. Bu, ekip genelinde standardizasyonu sağlayacak ve tekrarlayan kurulum görevlerini azaltacaktır.
Geliştirme platformlarıyla entegrasyon fırsatları genişlemeye devam ediyor. API geliştirme araçları, proje yönetim sistemleri ve işbirliği platformları, geliştirilmiş çalışma alanı yeteneklerinden yararlanabilir.
Sonuç
Claude Code Çok Dizinli desteği, modern geliştirmede iş akışı sürtünmesini ortadan kaldırır. Monorepolar, mikroservisler ve çapraz proje işbirliği, bağlam değiştirme yükü olmadan sorunsuz hale gelir.
Basit iki dizinli yapılandırmalarla başlayın ve proje ihtiyaçlarına göre genişletin. Minimal öğrenme eğrisi, proje karmaşıklığı arttıkça önemli üretkenlik iyileştirmeleri sunar.
Apidog gibi kapsamlı API test araçlarıyla birleştiğinde, çok dizinli destek, kolaylaştırılmış uçtan uca geliştirme deneyimleri yaratır. Maksimum fayda için özel proje gereksinimlerinize uyan yapılandırmaları deneyin.