settings.json, satu untuk setiap tempat Anda menyimpan pengaturan:
settings.jsonpengembang di~/.claude/settings.jsonsettings.jsontim di.claude/settings.json, yang dikomit ke repositorimanaged-settings.jsonorganisasi
Pengaturan Anda sendiri
Pengaturan pribadi satu pengembang. Ini memilih model dan upaya, menyesuaikan terminal, dan pra-menyetujui perintah baca-saja dan satu pembacaan file. Semua yang tidak tercantum mempertahankan defaultnya. File seperti ini masuk ke~/.claude/settings.json, di mana file ini berlaku untuk setiap proyek yang Anda buka.
- Copyable settings file
- What each key does
Simpan ini sebagai
~/.claude/settings.json. Ini adalah JSON yang valid tanpa komentar, jadi Anda dapat menempelkannya apa adanya dan menghapus kunci yang tidak Anda inginkan.~/.claude/settings.json
Pengaturan bersama tim
Pengaturan bersama satu tim, dikomit ke repositori sehingga semua orang yang mengklonnya mendapatkan izin, hooks, dan marketplace plugin yang sama. Simpan file seperti ini di.claude/settings.json di bagian atas repositori. Apa yang perlu diketahui sebelum Anda mengkomitnya:
- Sesi cloud di luar thread proyek juga membacanya. Sesi cloud dengan satu repositori dimulai di dalam klon, sehingga file yang di-commit juga berlaku di sana.
- Telemetri masuk dalam pengaturan terkelola atau pribadi. Claude Code mengabaikan variabel pengekspor OpenTelemetry dalam file pengaturan repositori, kecuali beberapa nilai yang mematikan telemetri. Atur mereka dalam pengaturan terkelola untuk organisasi Anda, atau dalam
~/.claude/settings.jsonsetiap orang. - Aturan izin menunggu kepercayaan. Aturan izin dan entri
extraKnownMarketplacesberlaku setelah setiap orang mempercayai folder ini sendiri, bukan hanya folder induk; aturan deny dan ask berlaku di setiap sesi, terpercaya atau tidak. - Hook adalah skrip di repo. Hook file ini menjalankan
.claude/hooks/block-rm.sh; How a hook resolves memandu penulisannya. - Aturan cocok dengan perintah dan jalur seperti yang ditulis.
Bash(git push *)tidak cocok dengangit -C . push.Read(./.env)sendiri menghentikan alat file dan perintah yang menyebutkan file, seperticat .env, tetapi bukangrep -rdijalankan di seluruh direktori; bloksandboxdalam file ini menutup celah itu, karena sandbox menambahkan jalur denyReadAnda ke apa yang tidak dapat dibaca oleh setiap perintah yang di-sandbox.
- Copyable settings file
- What each key does
Simpan ini sebagai
.claude/settings.json di bagian atas repositori dan komitnya. Ini adalah JSON yang valid tanpa komentar, jadi Anda dapat menempelkannya apa adanya dan menghapus kunci yang tidak Anda inginkan..claude/settings.json
Pengaturan terkelola organisasi
Filemanaged-settings.json yang menunjukkan bentuk kunci terkelola, dengan satu nilai yang masuk akal untuk masing-masing. Ini bukan kebijakan yang direkomendasikan: pilih kunci yang sesuai dengan persyaratan Anda sendiri dan tetapkan nilai Anda sendiri. Contoh menetapkan kunci-kunci ini:
forceLoginMethoddanforceLoginOrgUUIDmenyematkan metode login dan organisasiavailableModelsdanenforceAvailableModelsmembatasi model mana yang dapat digunakan sesipermissions.denymemblokir dua pembacaan file dan perintahcurlseperti yang ditulis Claude, dandisableBypassPermissionsModemenghapus mode izin bypassallowManagedPermissionRulesOnlydanallowManagedMcpServersOnlymembuat daftar izin izin terkelola dan MCP satu-satunya yang berlakuallowedMcpServersmenyematkan server MCP berdasarkan URLstrictKnownMarketplacesmemungkinkan satu marketplace pluginsandboxmembuat sandbox perintah dengan allowlist jaringan tetap dan tanpa retry tanpa sandbox. KuncifailIfUnavailable-nya mencegah Claude Code dimulai di tempat sandbox tidak dapat berjalanrequiredMinimumVersionmenetapkan versi Claude Code minimumcleanupPeriodDaysmempersingkat retensi transkrip sesi dan data lokal lainnya menjadi tujuh haricompanyAnnouncementsmenampilkan pesan saat startup
managed-settings.json, atau JSON yang sama melalui MDM atau server-managed settings. Satu file yang diterapkan berlaku untuk setiap mesin atau akun yang dicapainya. Untuk memberikan grup nilai yang berbeda, terapkan file atau profil yang berbeda ke grup itu, karena server-managed settings belum mendukung kebijakan per-grup.
- Copyable settings file
- What each key does
Terapkan ini sebagai
managed-settings.json, atau JSON yang sama melalui MDM atau konsol claude.ai. Ini adalah JSON yang valid tanpa komentar; ganti UUID organisasi contoh, URL server, dan marketplace dengan milik Anda sendiri dan hapus kunci yang tidak Anda inginkan.managed-settings.json