Skip to main content
Halaman ini berisi tiga contoh file settings.json, satu untuk setiap tempat Anda menyimpan pengaturan:
  • settings.json pengembang di ~/.claude/settings.json
  • settings.json tim di .claude/settings.json, yang dikomit ke repositori
  • managed-settings.json organisasi
Masing-masing adalah file yang masuk akal untuk pembaca itu, sehingga Anda dapat melihat bentuknya dan menyalin bagian yang Anda inginkan. Tidak ada satupun yang merupakan baseline yang direkomendasikan. Setiap nilai berasal dari entri kunci di referensi pengaturan, yang memiliki tipe, default, dan tempat pengaturannya dapat dilakukan. Setiap contoh memiliki dua tab. Copyable settings file adalah file seperti yang Anda simpan. What each key does adalah file yang sama dengan komentar di atas setiap kunci; Claude Code tidak menerima komentar dalam file pengaturan, jadi salin dari tab pertama.

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.
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, telemetri, dan marketplace plugin yang sama. Simpan file seperti ini di .claude/settings.json di bagian atas repositori. Tiga hal yang perlu diketahui sebelum Anda mengkomitnya:
  • Sesi cloud membacanya juga. Sesi cloud session di Claude Code di web dimulai dari klon repositori, jadi file yang dikomit berlaku di sana juga.
  • Aturan izin menunggu kepercayaan. Aturan izin dan entri extraKnownMarketplaces berlaku 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.
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

File managed-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:
  • forceLoginMethod dan forceLoginOrgUUID menyematkan metode login dan organisasi
  • availableModels dan enforceAvailableModels membatasi model mana yang dapat digunakan sesi
  • permissions.deny memblokir dua pembacaan file dan curl, dan disableBypassPermissionsMode menghapus mode izin bypass
  • allowManagedPermissionRulesOnly dan allowManagedMcpServersOnly membuat daftar izin izin terkelola dan MCP satu-satunya yang berlaku
  • allowedMcpServers menyematkan server MCP berdasarkan URL
  • strictKnownMarketplaces memungkinkan satu marketplace plugin
  • sandbox membuat sandbox perintah dengan daftar izin jaringan tetap dan tanpa retry tanpa sandbox
  • requiredMinimumVersion menetapkan versi Claude Code minimum
  • cleanupPeriodDays mempersingkat retensi transkrip sesi dan data lokal lainnya menjadi tujuh hari
  • companyAnnouncements menampilkan pesan saat startup
Administrator menerapkan file seperti ini sebagai 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.
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