Claude Code kini mendukung pengerjaan di berbagai direktori dalam satu sesi menggunakan flag --add-dir dan perintah interaktif /add-dir. Ini menghilangkan pergantian konteks yang konstan antar proyek.
Apa Itu Dukungan Multi-direktori
Fungsionalitas Inti
Flag --add-dir /path/to/dir menambahkan direktori ke sesi Claude Code Anda tanpa mengubah direktori kerja Anda. Gunakan /add-dir <path> selama sesi interaktif untuk memperluas ruang kerja Anda secara dinamis.
Claude Code mempertahankan hubungan file di berbagai struktur direktori sambil menjaga kinerja. Sistem secara otomatis menangani resolusi jalur saat Anda mereferensikan file dari direktori yang ditambahkan.
Kasus Penggunaan Utama
Monorepos
Bekerja di seluruh modul frontend, backend, dan bersama tanpa berpindah sesi. Aplikasi besar dengan pemisahan logis mendapat manfaat dari akses terpadu ke semua komponen.
File Konfigurasi Bersama
Akses file konfigurasi, dokumentasi, dan artefak pengembangan yang disimpan di lokasi terpisah. File produktivitas pribadi dan dokumentasi tim menjadi konsisten tersedia di seluruh sesi.
Pengembangan Lintas Proyek
Kelola repositori yang saling terhubung secara bersamaan. Klien API tetap sinkron dengan implementasi server. Dokumentasi diperbarui seiring dengan perubahan kode.
Strategi Implementasi
Penyiapan Ruang Kerja
- Identifikasi direktori kerja utama Anda
- Tambahkan direktori terkait menggunakan
--add-dir - Buat alias shell untuk konfigurasi umum
- Tetapkan pola direktori di seluruh tim
Optimasi Kinerja
- Tambahkan hanya direktori yang Anda gunakan secara aktif
- Hindari direktori dengan artefak build
- Pantau penggunaan token konteks dengan konfigurasi besar
- Gunakan jalur absolut untuk akses yang andal
Integrasi Pengembangan
Dukungan multi-direktori bekerja dengan alur kerja Git yang ada, sistem CI, dan pipeline deployment. Alat pengembangan API seperti Apidog dapat memantau spesifikasi di beberapa direktori proyek.
Contoh Praktis
Arsitektur Mikroservis
Akses implementasi layanan, pustaka bersama, template konfigurasi, dan skrip deployment dalam satu sesi. Referensikan pola yang ada saat mengembangkan layanan baru.
Kontribusi Sumber Terbuka
Bekerja dengan repositori yang di-fork, sumber upstream, dan konfigurasi pribadi secara bersamaan. Pertahankan kontribusi yang bersih sambil mengakses semua basis kode yang relevan.
Infrastruktur sebagai Kode
Kelola definisi aplikasi, konfigurasi deployment, dan pengaturan pemantauan di beberapa repositori. Pertahankan konsistensi selama perubahan infrastruktur.
Praktik Terbaik
Manajemen Konfigurasi
Gunakan jalur absolut untuk menghindari masalah resolusi. Verifikasi izin baca untuk semua direktori. Buat penyiapan standar untuk konsistensi tim.
Pertimbangan Keamanan
Tinjau konten direktori sebelum menambahkannya. Kecualikan informasi sensitif dan kredensial produksi. Gunakan direktori pengembangan khusus.
Pemantauan Kinerja
Perhatikan penggunaan memori dengan struktur direktori yang luas. Direktori lokal memberikan kinerja yang lebih baik daripada yang terpasang di jaringan. Hapus direktori yang tidak digunakan dari sesi.
Fitur Lanjutan
Integrasi Baris Perintah
claude-code --add-dir /path/to/backend --add-dir /path/to/frontend
Perintah Interaktif
/add-dir /path/to/shared-config
/add-dir /path/to/documentation
Alur Kerja Tim
Standardisasi konfigurasi multi-direktori di seluruh tim. Dokumentasikan pola umum untuk pengalaman pengembang yang konsisten. Integrasikan dengan proses orientasi.
Alur Kerja Pengembangan API
Dukungan multi-direktori meningkatkan pengembangan API-first. Layanan backend, dokumentasi, SDK klien, dan rangkaian pengujian seringkali ada di repositori terpisah tetapi memerlukan pembaruan yang sinkron.
Apidog menyediakan antarmuka pengujian terpadu yang berfungsi di seluruh ruang kerja multi-direktori Anda. Ini memastikan konsistensi API saat Anda mengembangkan fitur yang mencakup beberapa proyek.
Memecahkan Masalah Umum
Masalah Resolusi Jalur
- Gunakan jalur absolut daripada relatif
- Verifikasi tautan simbolis berfungsi dengan benar
- Periksa izin direktori
Masalah Kinerja
- Batasi direktori yang ditambahkan ke yang diperlukan saja
- Pantau sumber daya sistem
- Hapus direktori yang tidak digunakan selama sesi panjang
Kontrol Akses
- Pastikan izin baca yang tepat
- Hindari menambahkan direktori dengan data sensitif
- Gunakan struktur direktori khusus pengembangan
Peningkatan di Masa Depan
Komunitas meminta file konfigurasi untuk penyiapan ruang kerja yang persisten. Ini akan memungkinkan standardisasi di seluruh tim dan mengurangi tugas penyiapan yang berulang.
Peluang integrasi dengan platform pengembangan terus berkembang. Alat pengembangan API, sistem manajemen proyek, dan platform kolaborasi dapat memanfaatkan kemampuan ruang kerja yang ditingkatkan.
Kesimpulan
Dukungan Multi-direktori Claude Code menghilangkan gesekan alur kerja dalam pengembangan modern. Monorepo, mikroservis, dan kolaborasi lintas proyek menjadi mulus tanpa overhead pergantian konteks.
Mulai dengan konfigurasi dua direktori sederhana dan perluas berdasarkan kebutuhan proyek. Kurva pembelajaran minimal memberikan peningkatan produktivitas yang signifikan seiring bertambahnya kompleksitas proyek.
Dikombinasikan dengan alat pengujian API yang komprehensif seperti Apidog, dukungan multi-direktori menciptakan pengalaman pengembangan ujung-ke-ujung yang efisien. Eksperimen dengan konfigurasi yang sesuai dengan persyaratan proyek spesifik Anda untuk manfaat maksimal.