Skip to main content
Codebase besar dapat berupa satu repository dengan jutaan baris atau monorepo dengan banyak paket. Claude Code bekerja pada ukuran apa pun, tetapi seiring dengan pertumbuhan codebase, default yang disesuaikan untuk proyek yang lebih kecil dapat mengisi jendela konteks dengan instruksi dan pembacaan file yang tidak terkait dengan tugas, menghabiskan token dan menurunkan kinerja Claude. Panduan ini menunjukkan kepada pengembang individual dan tim teknik bagaimana membatasi Claude ke bagian codebase yang disentuh oleh tugas. Setiap bagian mencatat apakah pengaturan bersifat pribadi untuk mesin Anda atau berkomitmen pada repository.

​
Apa yang panduan ini cakup

Tabel di bawah mencantumkan setiap pengaturan dan apa yang dicapainya. Pohon file setelahnya adalah monorepo contoh yang dirujuk oleh setiap sampel kode di halaman ini.

​
Settings on this page

Setiap pengaturan di bawah ini independen. Mereka berlapis daripada menggantikan satu sama lain, jadi terapkan mana pun yang sesuai dengan repository Anda. Pilih di mana memulai Claude menentukan di mana file pengaturan Anda berada, jadi baca terlebih dahulu. Satukan semuanya menunjukkan semuanya digabungkan.
Untuk teknik alur kerja yang menjaga konteks tetap kecil di repository apa pun, seperti menjalankan eksplorasi di subagent sehingga pembacaan file tetap keluar dari percakapan utama, lihat Best practices untuk Claude Code. Untuk meluncurkan konfigurasi baseline ke setiap pengembang di organisasi Anda, lihat Siapkan Claude Code untuk organisasi Anda.

​
The example monorepo

Contoh di seluruh halaman ini merujuk pada monorepo dengan tiga paket. Pola yang sama bekerja di codebase pohon tunggal besar: di mana contoh menggunakan packages/api/, gantikan dengan direktori subsistem Anda sendiri seperti src/backend/ atau lib/core/.

​
Pilih di mana memulai Claude

Di mana Anda meluncurkan claude menentukan file mana yang dapat dibaca dan diedit Claude tanpa hibah izin tambahan, file CLAUDE.md mana yang dimuat ke konteks saat startup, dan pengaturan proyek mana yang berlaku. Pengaturan proyek di .claude/settings.json tidak diwariskan dari direktori induk dengan cara file CLAUDE.md. Untuk mengetahui direktori mana .claude/settings.json yang dibaca sesi, lihat di mana Claude Code mencari setiap file. Setiap bagian di bawah menyatakan apakah file pengaturannya berada di repository root atau di subdirektori tempat Anda memulai, dan apakah itu berkomitmen atau disimpan secara lokal.

​
Layer CLAUDE.md files by directory

Dalam codebase besar, satu CLAUDE.md di repository root cenderung baik tumbuh untuk mencakup konvensi setiap subsistem, menghabiskan konteks pada instruksi yang tidak terkait dengan tugas saat ini, atau tetap terlalu umum untuk berguna. Membagi instruksi di seluruh file per-direktori berarti Claude memuat aturan repository-wide plus hanya konvensi untuk kode yang sedang Anda kerjakan. Claude Code memuat setiap file CLAUDE.md dari direktori kerja Anda dan setiap direktori induk saat peluncuran, kemudian memuat file setiap subdirektori sesuai kebutuhan. File root menetapkan aturan yang berlaku di seluruh repositori dan setiap subdirektori menambahkan miliknya sendiri. Pemisahan umum adalah dua level:
  • Root CLAUDE.md: instruksi yang berlaku di mana-mana, seperti standar coding dan konvensi commit
  • Per-subdirektori CLAUDE.md: konvensi spesifik untuk stack area itu. Dalam monorepo itu satu per paket. Dalam pohon tunggal besar itu satu per subsistem seperti src/db/ atau src/api/
Komitkan file ini ke repository sehingga rekan kerja mewarisinya. Pemilik setiap direktori biasanya memelihara filenya. Untuk memangkas file yang sudah diperiksa, jalankan pemeriksaan /doctor. Root CLAUDE.md menyimpan aturan yang berlaku di setiap paket:
CLAUDE.md
CLAUDE.md setiap subdirektori, di sini packages/api/CLAUDE.md, menambahkan konvensi spesifik untuk area itu:
packages/api/CLAUDE.md