397<span id="where-settings-live" />397<span id="where-settings-live" />
398 398
399<h2 id="settings-files-and-who-they-affect">399<h2 id="settings-files-and-who-they-affect">
400 File pengaturan dan siapa yang mereka pengaruhi400 File pengaturan dan siapa yang terpengaruh
401</h2>401</h2>
402 402
403Claude Code membaca pengaturan dari empat file, dan organisasi juga dapat mengirimkan pengaturan yang dikelola dari konsol claude.ai. Setiap sumber memiliki cakupan: set orang dan proyek yang pengaturan yang disimpan di dalamnya berlaku untuk, apakah itu hanya Anda, semua orang di proyek, atau semua orang di organisasi Anda.403Claude Code membaca pengaturan dari empat file, dan organisasi juga dapat mengirimkan pengaturan terkelola dari konsol claude.ai. Setiap sumber memiliki cakupan: set orang dan proyek yang pengaturan yang disimpan di dalamnya berlaku, baik itu hanya Anda, semua orang dalam proyek, atau semua orang di organisasi Anda.
404 404
405| Cakupan | File | Siapa yang terpengaruh | Gunakan untuk |405| Cakupan | File | Siapa yang terpengaruh | Gunakan untuk |
406| :------------- | :--------------------------------------------------------------------------------------------------- | :--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :----------------------------------------------------------------------------- |406| :------------- | :----------------------------------------------------------------------------------------------- | :-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | :----------------------------------------------------------------------------- |
407| Pengguna | `~/.claude/settings.json` | Anda, di setiap proyek di mesin ini | Preferensi pribadi: tema, mode editor, model default, aturan izin Anda sendiri |407| Pengguna | `~/.claude/settings.json` | Anda, di setiap proyek di mesin ini | Preferensi pribadi: tema, mode editor, model default, aturan izin Anda sendiri |
408| Proyek bersama | `.claude/settings.json` | Semua orang yang bekerja di folder yang memuatnya. Dalam repositori git, komitnya sehingga rekan kerja mendapatkannya | Izin tim, hooks, plugins, dan variabel lingkungan yang dibutuhkan proyek |408| Proyek bersama | `.claude/settings.json` | Semua orang yang bekerja di folder yang memuatnya. Di repositori git, commit itu sehingga rekan kerja mendapatkannya | Izin tim, hooks, plugins, dan variabel lingkungan yang dibutuhkan proyek |
409| Proyek lokal | `.claude/settings.local.json` | Anda, hanya di proyek ini. Claude Code menyimpannya keluar dari git saat membuat file; jika Anda membuatnya dengan tangan, tambahkan ke `.gitignore` sendiri | Penggantian pribadi untuk satu proyek, dan pengujian sebelum Anda bagikan |409| Proyek lokal | `.claude/settings.local.json` | Anda, hanya di proyek ini. Claude Code menyimpannya di luar git saat membuat file; jika Anda membuatnya dengan tangan, tambahkan ke `.gitignore` sendiri | Penggantian pribadi untuk satu proyek, dan pengujian sebelum Anda berbagi |
410| Dikelola | `managed-settings.json` dan [sumber yang dikelola](/docs/id/managed-settings#delivery-mechanisms) lainnya | Semua orang yang organisasi Anda terapkan ke; tidak ada yang Anda atur menimpanya, terlepas dari beberapa [pengecualian yang sensitif terhadap keamanan](#exceptions-to-managed-settings-precedence) | Kebijakan keamanan dan persyaratan kepatuhan |410| Terkelola | `managed-settings.json` dan [sumber terkelola](/docs/id/managed-settings#delivery-mechanisms) lainnya | Semua orang organisasi Anda menerapkannya; tidak ada yang Anda atur yang menggantikannya, kecuali beberapa [pengecualian sensitif keamanan](#exceptions-to-managed-settings-precedence) | Kebijakan keamanan dan persyaratan kepatuhan |
411 411
412Di kolom File, `~/.claude` adalah folder `.claude` di direktori home Anda, dan `.claude` telanjang adalah folder `.claude` di dalam proyek Anda.412Di kolom File, `~/.claude` adalah folder `.claude` di direktori home Anda, dan `.claude` kosong adalah folder `.claude` di dalam proyek Anda.
413 413
414<span id="where-each-file-applies" />414<span id="where-each-file-applies" />
415 415
421 421
422Misalkan Anda memiliki tiga proyek di mesin Anda, `website/`, `api/`, dan `acme-app/`, rekan kerja memiliki klon mereka sendiri dari `acme-app/`, dan Anda memulai [sesi cloud](#settings-in-cloud-sessions) di `acme-app/`.422Misalkan Anda memiliki tiga proyek di mesin Anda, `website/`, `api/`, dan `acme-app/`, rekan kerja memiliki klon mereka sendiri dari `acme-app/`, dan Anda memulai [sesi cloud](#settings-in-cloud-sessions) di `acme-app/`.
423 423
424Grafik di bawah menunjukkan folder mana yang pengaturan berlaku saat Anda memulai Claude Code dari mereka. Klik file pengaturan untuk melihat folder yang dicapainya.424Grafik di bawah menunjukkan folder mana yang pengaturan berlaku saat Anda memulai Claude Code dari mereka. Klik file pengaturan untuk melihat folder yang dijangkaunya.
425 425
426<SettingsScope />426<SettingsScope />
427 427
428* **`~/.claude/settings.json`**: setiap proyek di mesin Anda, dan tidak ada di mesin rekan kerja atau dalam sesi cloud428* **`~/.claude/settings.json`**: setiap proyek di mesin Anda, dan tidak ada di mesin rekan kerja atau di sesi cloud
429* **`acme-app/.claude/settings.json`**: `acme-app/` Anda. Ia mencapai klon rekan kerja dan sesi cloud hanya jika Anda melakukan komit file ke kontrol versi; sampai Anda melakukannya, itu adalah file di disk Anda seperti yang lain dan tidak ada orang lain yang memilikinya429* **`acme-app/.claude/settings.json`**: `acme-app/` Anda. Ini menjangkau klon rekan kerja dan sesi cloud hanya jika Anda commit file ke kontrol versi; sampai Anda melakukannya, itu adalah file di disk Anda seperti yang lain dan tidak ada orang lain yang memilikinya
430* **`acme-app/.claude/settings.local.json`**: hanya `acme-app/` Anda. Claude Code menambahkannya ke pengecualian git global Anda saat pertama kali menulis file, sehingga tetap keluar dari komit Anda; jika Anda membuat file dengan tangan, [tambahkan ke `.gitignore` sendiri](#keep-personal-settings-out-of-a-repository)430* **`acme-app/.claude/settings.local.json`**: hanya `acme-app/` Anda. Claude Code menambahkannya ke pengecualian git global Anda pertama kali menulis file, sehingga tetap keluar dari commit Anda; jika Anda membuat file dengan tangan, [tambahkan ke `.gitignore` sendiri](#keep-personal-settings-out-of-a-repository)
431* **Pengaturan yang dikelola**, apakah file `managed-settings.json`, kebijakan MDM, atau [pengaturan yang dikelola server](/docs/id/server-managed-settings) dari konsol claude.ai: setiap proyek di setiap mesin yang organisasi Anda terapkan ke, atau yang Anda masuk dengan akun organisasi Anda. Hanya pengaturan yang dikelola server yang mencapai sesi cloud431* **Pengaturan terkelola**, baik file `managed-settings.json`, kebijakan MDM, atau [pengaturan yang dikelola server](/docs/id/server-managed-settings) dari konsol claude.ai: setiap proyek di setiap mesin organisasi Anda menerapkannya, atau yang Anda masuk dengan akun organisasi Anda. Hanya pengaturan yang dikelola server yang menjangkau sesi cloud
432 432
433<span id="which-files-you-have" />433<span id="which-files-you-have" />
434 434
438 438
439Menginstal Claude Code tidak membuat file pengaturan apa pun. Jika mesin atau proyek Anda sudah memiliki satu, itu berasal dari salah satu sumber ini:439Menginstal Claude Code tidak membuat file pengaturan apa pun. Jika mesin atau proyek Anda sudah memiliki satu, itu berasal dari salah satu sumber ini:
440 440
441* **Dikelola**: organisasi Anda menerapkannya. Anda tidak membuat atau mengeditnya.441* **Terkelola**: organisasi Anda menerapkannya. Anda tidak membuat atau mengeditnya.
442* **Proyek bersama**: proyek yang sudah menggunakan Claude Code mungkin memiliki satu yang dikomit. Jika tidak, buatnya di `.claude/settings.json` di folder proyek.442* **Proyek bersama**: proyek yang sudah menggunakan Claude Code mungkin memiliki satu yang di-commit. Jika tidak, buatnya di `.claude/settings.json` di folder proyek.
443* **Pengguna** dan **Proyek lokal**: buatnya sendiri, atau biarkan Claude Code membuatnya. Ia menulis `~/.claude/settings.json` saat pertama kali Anda mengubah opsi di menu `/config` yang disimpannya dalam pengaturan pengguna, seperti tema, dan `.claude/settings.local.json` saat pertama kali Anda memberikan persetujuan berdiri di prompt izin, seperti "Ya, dan jangan tanya lagi" untuk perintah Bash. Beberapa opsi `/config`, termasuk **Tampilkan tips**, disimpan ke `.claude/settings.local.json` sebagai gantinya.443* **Pengguna** dan **Proyek lokal**: buatnya sendiri, atau biarkan Claude Code membuatnya. Ini menulis `~/.claude/settings.json` pertama kali Anda mengubah opsi di menu `/config` yang disimpannya dalam pengaturan pengguna, seperti tema, dan `.claude/settings.local.json` pertama kali Anda memberikan persetujuan berdiri di prompt izin, seperti "Ya, dan jangan tanya lagi" untuk perintah Bash. Beberapa opsi `/config`, termasuk **Tampilkan tips**, disimpan ke `.claude/settings.local.json` sebagai gantinya dari file pengguna.
444 444
445<Info>445<Info>
446 Di Windows, `~/.claude` berarti `%USERPROFILE%\.claude`. Untuk menyimpan file direktori home di tempat lain, atur [`CLAUDE_CONFIG_DIR`](/docs/id/env-vars); Claude Code kemudian menyimpan pengaturan, riwayat sesi, dan plugins Anda di sana sebagai gantinya.446 Di Windows, `~/.claude` berarti `%USERPROFILE%\.claude`. Untuk menyimpan file direktori home di tempat lain, atur [`CLAUDE_CONFIG_DIR`](/docs/id/env-vars); Claude Code kemudian menyimpan pengaturan, riwayat sesi, dan plugins Anda di sana sebagai gantinya.
447</Info>447</Info>
448 448
449Claude Code juga menyimpan file kelima, [`~/.claude.json`](/docs/id/claude-directory#ce-claude-json), yang ditulis untuk dirinya sendiri; Anda tidak perlu mengeditnya. Ia menyimpan sesi masuk Anda, konfigurasi [server MCP](/docs/id/mcp), status per-proyek seperti keputusan kepercayaan, dan [kunci konfigurasi global](/docs/id/settings-reference#global-config-settings) yang `/config` tulis untuk Anda.449Claude Code juga menyimpan file kelima, [`~/.claude.json`](/docs/id/claude-directory#ce-claude-json), yang ditulis untuk dirinya sendiri; Anda tidak perlu mengeditnya. Ini menyimpan sesi masuk Anda, konfigurasi [server MCP](/docs/id/mcp), status per-proyek seperti keputusan kepercayaan, dan [kunci konfigurasi global](/docs/id/settings-reference#global-config-settings) yang `/config` tulis untuk Anda.
450 450
451<h3 id="share-settings-with-your-team">451<h3 id="share-settings-with-your-team">
452 Bagikan pengaturan dengan tim Anda452 Bagikan pengaturan dengan tim Anda
453</h3>453</h3>
454 454
455Komit `.claude/settings.json` sehingga semua orang yang mengkloning repositori mendapatkan izin, hooks, telemetri, dan plugins yang sama. Setiap rekan kerja masih dapat menimpanya untuk diri mereka sendiri di `.claude/settings.local.json` mereka sendiri, jadi pengecualian pribadi tidak perlu komit. Untuk file tim lengkap, lihat [pengaturan bersama tim](/docs/id/settings-example#a-teams-shared-settings).455Commit `.claude/settings.json` sehingga semua orang yang mengkloning repositori mendapatkan izin, hooks, dan plugins yang sama. Setiap rekan kerja masih dapat menggantikannya untuk diri mereka sendiri di `.claude/settings.local.json` mereka sendiri, sehingga pengecualian pribadi tidak perlu commit. Untuk file tim lengkap, lihat [pengaturan bersama tim](/docs/id/settings-example#a-teams-shared-settings).
456 456
457Beberapa dari apa yang Anda komit menunggu sampai setiap rekan kerja [mempercayai folder](/docs/id/permissions#project-allow-rules-and-workspace-trust), dan beberapa kunci tidak pernah berlaku dari file repositori; [Troubleshoot pengaturan yang tidak berlaku](#common-cases) mencakup keduanya.457Beberapa dari apa yang Anda commit menunggu sampai setiap rekan kerja [mempercayai folder](/docs/id/permissions#project-allow-rules-and-workspace-trust), dan beberapa kunci tidak pernah berlaku dari file repositori; [Troubleshoot a setting that doesn't apply](#common-cases) mencakup keduanya.
458 458
459<span id="local-settings-file" />459<span id="local-settings-file" />
460 460
465<span id="keep-personal-settings-out-of-the-repository" />465<span id="keep-personal-settings-out-of-the-repository" />
466 466
467<h3 id="keep-personal-settings-out-of-a-repository">467<h3 id="keep-personal-settings-out-of-a-repository">
468 Simpan pengaturan pribadi keluar dari repositori468 Jaga pengaturan pribadi keluar dari repositori
469</h3>469</h3>
470 470
471Untuk mengubah pengaturan untuk diri sendiri di satu proyek tanpa mengubahnya untuk rekan kerja Anda, simpan di `.claude/settings.local.json` di dalam proyek. Claude Code menerapkan file itu di atas `.claude/settings.json` yang dikomit, jadi jika file tim Anda menetapkan `"model": "claude-sonnet-5"` dan Anda menginginkan Opus, masukkan `"model": "claude-opus-5-5"` di file lokal Anda dan hanya sesi Anda yang berubah.471Untuk mengubah pengaturan untuk diri sendiri di satu proyek tanpa mengubahnya untuk rekan kerja Anda, simpan di `.claude/settings.local.json` di dalam proyek. Claude Code menerapkan file itu di atas `.claude/settings.json` yang di-commit, jadi jika file tim Anda menetapkan `"model": "claude-sonnet-5"` dan Anda menginginkan Opus, masukkan `"model": "claude-opus-5-5"` di file lokal Anda dan hanya sesi Anda yang berubah.
472 472
473Claude Code juga menulis ke file ini, menyimpannya keluar dari komit Anda, dan menerapkan aturan izinnya tanpa langkah kepercayaan:473Claude Code juga menulis ke file ini, menyimpannya keluar dari commit Anda, dan menerapkan aturan izinnya tanpa langkah kepercayaan:
474 474
475* **Claude Code juga menulisnya.** Saat Claude meminta izin untuk menjalankan perintah Bash dan Anda memilih "Ya, dan jangan tanya lagi", Claude Code menyimpan [persetujuan izin](/docs/id/permissions#permission-system) itu di sini sebagai aturan `allow`.475* **Claude Code juga menulisnya.** Ketika Claude meminta izin untuk menjalankan perintah Bash dan Anda memilih "Ya, dan jangan tanya lagi", Claude Code menyimpan [persetujuan izin](/docs/id/permissions#permission-system) itu di sini sebagai aturan `allow`.
476* **Anda tidak perlu gitignore sendiri, kecuali Anda membuatnya dengan tangan.** Saat pertama kali Claude Code menulis file di repositori git yang belum mengabaikannya, ia menambahkan `**/.claude/settings.local.json` ke file pengecualian git global Anda, sehingga file tetap keluar dari komit Anda di setiap repositori. File itu adalah `core.excludesFile` saat konfigurasi git global Anda menetapkannya ke jalur absolut atau jalur dengan awalan `~`; jika tidak, itu adalah `$XDG_CONFIG_HOME/git/ignore`, atau `~/.config/git/ignore` saat `XDG_CONFIG_HOME` tidak diatur. Jika Anda membuat file dengan tangan dan Claude Code belum menulisnya, tambahkan ke `.gitignore` sendiri.476* **Anda tidak perlu gitignore sendiri, kecuali Anda membuatnya dengan tangan.** Pertama kali Claude Code menulis file di repositori git yang tidak sudah mengabaikannya, itu menambahkan `**/.claude/settings.local.json` ke file pengecualian git global Anda, sehingga file tetap keluar dari commit Anda di setiap repositori. File itu adalah `core.excludesFile` ketika konfigurasi git global Anda menetapkannya ke jalur absolut atau jalur dengan awalan `~`; jika tidak, itu adalah `$XDG_CONFIG_HOME/git/ignore`, atau `~/.config/git/ignore` ketika `XDG_CONFIG_HOME` tidak diatur. Jika Anda membuat file dengan tangan dan Claude Code belum menulis ke dalamnya, tambahkan ke `.gitignore` sendiri.
477* **Aturan allow-nya tidak menunggu kepercayaan saat file tetap tidak dilacak.** Karena file adalah milik Anda dan bukan repositori, Claude Code menerapkan aturan `allow`-nya tanpa langkah [kepercayaan workspace](/docs/id/permissions#project-allow-rules-and-workspace-trust) yang diperlukan untuk file yang dikomit. Jika file dilacak oleh git, langkah kepercayaan juga berlaku untuk itu; lihat [Saat file pengaturan lokal Anda memerlukan kepercayaan](/docs/id/permissions#when-your-local-settings-file-needs-trust).477* **Aturan izinnya tidak menunggu kepercayaan sementara file tetap tidak dilacak.** Karena file adalah milik Anda dan bukan repositori, Claude Code menerapkan aturan `allow` tanpa langkah [kepercayaan ruang kerja](/docs/id/permissions#project-allow-rules-and-workspace-trust) yang diperlukan untuk file yang di-commit. Jika file dilacak oleh git, langkah kepercayaan juga berlaku untuk itu; lihat [Ketika file pengaturan lokal Anda memerlukan kepercayaan](/docs/id/permissions#when-your-local-settings-file-needs-trust).
478 478
479<span id="where-claude-code-looks-for-each-file" />479<span id="where-claude-code-looks-for-each-file" />
480 480
483<span id="local-allow-rules-dont-wait-for-workspace-trust" />483<span id="local-allow-rules-dont-wait-for-workspace-trust" />
484 484
485<h4 id="where-claude-code-keeps-the-local-file-in-a-git-repository">485<h4 id="where-claude-code-keeps-the-local-file-in-a-git-repository">
486 Tempat Claude Code menyimpan file lokal dalam repositori git486 Tempat Claude Code menyimpan file lokal di repositori git
487</h4>487</h4>
488 488
489Saat Claude meminta izin untuk menjalankan perintah Bash dan Anda memilih "Ya, dan jangan tanya lagi", Claude Code menyimpan persetujuan itu sebagai aturan `allow` di `.claude/settings.local.json`. Jika Anda memulai Claude Code di subdirektori repositori git, ia membaca dan menulis file itu di akar repositori dan menerapkan persetujuan di seluruh repositori. Dalam [worktree](/docs/id/worktrees), ia menggunakan file di akar checkout utama.489Ketika Claude meminta izin untuk menjalankan perintah Bash dan Anda memilih "Ya, dan jangan tanya lagi", Claude Code menyimpan persetujuan itu sebagai aturan `allow` di `.claude/settings.local.json`. Jika Anda memulai Claude Code di subdirektori repositori git, itu membaca dan menulis file itu di akar repositori dan menerapkan persetujuan di seluruh repositori. Di [worktree](/docs/id/worktrees), itu menggunakan file di akar checkout utama.
490 490
491Dua aturan memenuhi syarat lokasi akar:491Dua aturan memenuhi syarat lokasi akar:
492 492
493* **Saat file tetap dengan `.claude/settings.json` sebagai gantinya**: di luar repositori git, saat akar repositori adalah direktori home Anda, di Windows, atau saat akar repositori atau entri `.git` atau `.claude`-nya tidak dimiliki oleh pengguna Anda.493* **Ketika file tetap dengan `.claude/settings.json` sebagai gantinya**: di luar repositori git, ketika akar repositori adalah direktori home Anda, di Windows, atau ketika akar repositori atau entri `.git` atau `.claude` tidak dimiliki oleh pengguna Anda.
494* **Jalur dalam file tidak berlabuh di akar repositori**: aturan izin yang dimulai dengan `/` atau jalur sandbox relatif [berlabuh di direktori kerja utama sesi](/docs/id/permissions#read-and-edit) sebagai gantinya.494* **Jalur dalam file tidak jangkar di akar repositori**: aturan izin yang dimulai dengan `/` atau jalur sandbox relatif [jangkar di direktori kerja utama sesi](/docs/id/permissions#read-and-edit) sebagai gantinya.
495 495
496Sebelum v2.1.211, Claude Code menyimpan file di direktori awal. Ia masih membaca file yang versi sebelumnya tinggalkan di sana bersama file akar; saat keduanya menetapkan kunci yang sama, nilai akar berlaku, dan aturan izin dari kedua file berlaku. Helper [`resolveSettings()`](/docs/id/agent-sdk/typescript#resolvesettings) SDK Agent selalu membaca file dari direktori awal.496Sebelum v2.1.211, Claude Code menyimpan file di direktori awal. Itu masih membaca file versi sebelumnya yang ditinggalkan di sana di samping file akar; di mana keduanya menetapkan kunci yang sama, nilai akar berlaku, dan aturan izin dari kedua file berlaku. Helper [`resolveSettings()`](/docs/id/agent-sdk/typescript#resolvesettings) SDK Agent selalu membaca file dari direktori awal.
497 497
498Claude Code membaca `.claude/settings.json` bersama dari [direktori kerja utama](/docs/id/permissions#working-directories) sesi, jadi untuk menggunakan file yang dikomit di akar repositori, mulai Claude Code di sana. Setelah Anda [memindahkan sesi dengan `/cd`](/docs/id/permissions#move-the-session-to-another-directory), Claude Code membaca kedua file proyek dari direktori baru sebagai gantinya, menempatkan file lokal dengan aturan yang sama. Membacanya dari direktori yang Anda pindahkan memerlukan Claude Code v2.1.246 atau lebih baru.498Claude Code membaca `.claude/settings.json` bersama dari [direktori kerja utama](/docs/id/permissions#working-directories) sesi, jadi untuk menggunakan file yang di-commit di akar repositori, mulai Claude Code di sana. Setelah Anda [memindahkan sesi dengan `/cd`](/docs/id/permissions#move-the-session-to-another-directory), Claude Code membaca kedua file proyek dari direktori baru sebagai gantinya, menempatkan file lokal dengan aturan yang sama. Membaca mereka dari direktori yang Anda pindahkan memerlukan Claude Code v2.1.246 atau lebih baru.
499 499
500<span id="managed-settings-delivery" />500<span id="managed-settings-delivery" />
501 501
508<span id="settings-your-organization-manages" />508<span id="settings-your-organization-manages" />
509 509
510<h3 id="check-what-your-organization-enforces">510<h3 id="check-what-your-organization-enforces">
511 Periksa apa yang diterapkan organisasi Anda511 Periksa apa yang organisasi Anda terapkan
512</h3>512</h3>
513 513
514Jika organisasi Anda mengelola Claude Code, beberapa pengaturan diputuskan untuk Anda dan tidak ada yang Anda masukkan dalam file Anda sendiri yang mengubahnya. Untuk melihat mana, jalankan `/status`: baris `Setting sources` menamai sumber yang dikelola yang berlaku untuk Anda. Pengaturan yang dikelola berlaku di mana pun Claude Code berjalan di mesin ini; [Apa yang dapat diubah pengembang](/docs/id/managed-settings#what-a-developer-can-change) mencakup hak admin lokal dan tools selain Claude Code.514Jika organisasi Anda mengelola Claude Code, beberapa pengaturan diputuskan untuk Anda dan tidak ada yang Anda masukkan dalam file Anda sendiri yang mengubahnya. Untuk melihat mana, jalankan `/status`: baris `Setting sources` menamai sumber terkelola yang berlaku untuk Anda. Pengaturan terkelola berlaku di mana pun Claude Code berjalan di mesin ini; [Apa yang dapat diubah pengembang](/docs/id/managed-settings#what-a-developer-can-change) mencakup hak admin lokal dan alat selain Claude Code.
515 515
516Pengaturan yang dikelola mencapai Anda melalui [mekanisme pengiriman](/docs/id/managed-settings#delivery-mechanisms) di halaman pengaturan yang dikelola, paling umum:516Pengaturan terkelola menjangkau Anda melalui [mekanisme pengiriman](/docs/id/managed-settings#delivery-mechanisms) di halaman pengaturan terkelola, paling umum:
517 517
518* [Pengaturan yang dikelola server](/docs/id/server-managed-settings), yang Claude Code ambil dari konsol admin claude.ai atau [gateway aplikasi Claude](/docs/id/claude-apps-gateway) yang di-host sendiri518* [Pengaturan yang dikelola server](/docs/id/server-managed-settings), yang Claude Code ambil dari konsol admin claude.ai atau [gateway aplikasi Claude](/docs/id/claude-apps-gateway) yang di-host sendiri
519* Kebijakan MDM atau tingkat OS, dan file `managed-settings.json` di direktori sistem519* Kebijakan MDM atau tingkat OS, dan file `managed-settings.json` di direktori sistem
520* Host penyematan seperti Claude Desktop, melalui opsi SDK `managedSettings`; lihat [Kontrol kebijakan dari host penyematan](/docs/id/managed-settings#parent-settings-from-embedding-hosts)520* Host penyematan seperti Claude Desktop, melalui opsi SDK `managedSettings`; lihat [Kontrol kebijakan dari host penyematan](/docs/id/managed-settings#parent-settings-from-embedding-hosts)
521 521
522Dalam sesi [Cowork](https://claude.com/docs/cowork/overview) yang berjalan di mesin Anda di aplikasi Claude Desktop, Claude Code tidak mengambil pengaturan yang dikelola server dari konsol admin claude.ai, dan ia membaca kebijakan yang diterapkan ke perangkat Anda kecuali konfigurasi Claude Desktop organisasi Anda menetapkan `requireCoworkFullVmSandbox`. [Tempat dan kapan kebijakan berlaku](/docs/id/managed-settings#where-and-when-a-policy-applies) mencakup Cowork dan sesi cloud.522Di sesi [Cowork](https://claude.com/docs/cowork/overview) yang berjalan di mesin Anda di aplikasi Claude Desktop, Claude Code tidak mengambil pengaturan yang dikelola server dari konsol admin claude.ai, dan itu membaca kebijakan yang diterapkan ke perangkat Anda kecuali konfigurasi Claude Desktop organisasi Anda menetapkan `requireCoworkFullVmSandbox`. [Di mana dan kapan kebijakan berlaku](/docs/id/managed-settings#where-and-when-a-policy-applies) mencakup Cowork dan sesi cloud.
523 523
524Jika Anda adalah administrator, [Siapkan Claude Code untuk organisasi Anda](/docs/id/admin-setup) memandu memilih apa yang akan diterapkan, dan [Terapkan pengaturan yang dikelola](/docs/id/managed-settings) mencakup pengiriman dan cara mengonfirmasi kebijakan berlaku.524Jika Anda adalah administrator, [Siapkan Claude Code untuk organisasi Anda](/docs/id/admin-setup) memandu memilih apa yang akan diterapkan, dan [Terapkan pengaturan terkelola](/docs/id/managed-settings) mencakup pengiriman dan cara mengonfirmasi kebijakan berlaku.
525 525
526<h2 id="change-a-setting">526<h2 id="change-a-setting">
527 Ubah pengaturan527 Ubah pengaturan
743* **Level yang lebih tinggi menetapkannya.** File pengaturan lain, flag `--settings`, atau sumber yang dikelola menetapkan kunci di atas milik Anda; [tumpukan](#settings-precedence) mengatakan mana. Flag atau variabel lingkungan juga dapat menimpa kunci atas namanya sendiri, diputuskan kunci demi kunci; entri kunci di [referensi pengaturan](/docs/id/settings-reference) mengatakan mana yang digunakan Claude Code, dan [entri `env`](/docs/id/settings-reference#env) mencakup nilai `env` yang dikelola versus ekspor shell.743* **Level yang lebih tinggi menetapkannya.** File pengaturan lain, flag `--settings`, atau sumber yang dikelola menetapkan kunci di atas milik Anda; [tumpukan](#settings-precedence) mengatakan mana. Flag atau variabel lingkungan juga dapat menimpa kunci atas namanya sendiri, diputuskan kunci demi kunci; entri kunci di [referensi pengaturan](/docs/id/settings-reference) mengatakan mana yang digunakan Claude Code, dan [entri `env`](/docs/id/settings-reference#env) mencakup nilai `env` yang dikelola versus ekspor shell.
744* **Kunci keamanan menyimpan nilai ketatnya.** Untuk beberapa kunci Claude Code menghormati nilai yang membatasi dari file apa pun, jadi `true` proyek untuk [`disableClaudeAiConnectors`](/docs/id/settings-reference#disableclaudeaiconnectors) tetap aktif; lihat [Pengecualian untuk urutan prioritas pengaturan yang dikelola](#exceptions-to-managed-settings-precedence).744* **Kunci keamanan menyimpan nilai ketatnya.** Untuk beberapa kunci Claude Code menghormati nilai yang membatasi dari file apa pun, jadi `true` proyek untuk [`disableClaudeAiConnectors`](/docs/id/settings-reference#disableclaudeaiconnectors) tetap aktif; lihat [Pengecualian untuk urutan prioritas pengaturan yang dikelola](#exceptions-to-managed-settings-precedence).
745* **File tidak dapat menetapkan nilai itu.** Nilai [`permissions.defaultMode`](/docs/id/settings-reference#permissions-defaultmode) `auto` dan `bypassPermissions` tidak berlaku dari pengaturan proyek atau lokal; aturnya dalam pengaturan pengguna atau yang dikelola sebagai gantinya, atau lewatkan `--permission-mode` untuk satu sesi. Sebelum v2.1.257, `bypassPermissions` berlaku dari file apa pun.745* **File tidak dapat menetapkan nilai itu.** Nilai [`permissions.defaultMode`](/docs/id/settings-reference#permissions-defaultmode) `auto` dan `bypassPermissions` tidak berlaku dari pengaturan proyek atau lokal; aturnya dalam pengaturan pengguna atau yang dikelola sebagai gantinya, atau lewatkan `--permission-mode` untuk satu sesi. Sebelum v2.1.257, `bypassPermissions` berlaku dari file apa pun.
746
747 Variabel ekspor telemetri dalam blok [`env`](/docs/id/settings-reference#env) juga tidak berlaku dari pengaturan proyek atau lokal, terlepas dari beberapa nilai off. [Variabel yang diabaikan Claude Code dalam `env`](/docs/id/settings-reference#variables-claude-code-ignores-in-env) mencantumkan variabel dan nilai-nilai tersebut.
746* **File rusak.** JSON tidak valid atau nilai yang ditolak membuat Claude Code melewati file atau entri; lihat [Perbaiki file pengaturan yang rusak](#fix-a-broken-settings-file).748* **File rusak.** JSON tidak valid atau nilai yang ditolak membuat Claude Code melewati file atau entri; lihat [Perbaiki file pengaturan yang rusak](#fix-a-broken-settings-file).
747 749
748<h4 id="a-change-you-made-in-claude-code-is-lost-in-new-sessions">750<h4 id="a-change-you-made-in-claude-code-is-lost-in-new-sessions">
766Dua hal menjaga kunci di `.claude/settings.json` dari penerapan untuk semua orang yang mengkloning:768Dua hal menjaga kunci di `.claude/settings.json` dari penerapan untuk semua orang yang mengkloning:
767 769
768* **Claude Code mengabaikan kunci dalam file repositori.** Cari `User, local, or managed`, `User or managed`, `Managed`, atau `Global config` di kolom Scope dari [indeks pengaturan](/docs/id/settings-reference#settings-index). Kunci-kunci itu tidak pernah berlaku dari file bersama, terlepas dari beberapa yang file repositori masih dapat matikan. Setiap entri itu mengatakan demikian pada baris Scope-nya. Kunci `Global config` hanya berlaku dari `~/.claude.json`.770* **Claude Code mengabaikan kunci dalam file repositori.** Cari `User, local, or managed`, `User or managed`, `Managed`, atau `Global config` di kolom Scope dari [indeks pengaturan](/docs/id/settings-reference#settings-index). Kunci-kunci itu tidak pernah berlaku dari file bersama, terlepas dari beberapa yang file repositori masih dapat matikan. Setiap entri itu mengatakan demikian pada baris Scope-nya. Kunci `Global config` hanya berlaku dari `~/.claude.json`.
771
772 Di dalam kunci `env`, variabel ekspor telemetri tidak pernah berlaku dari file bersama juga, terlepas dari beberapa nilai off; lihat [Variabel yang diabaikan Claude Code dalam `env`](/docs/id/settings-reference#variables-claude-code-ignores-in-env).
769* **Kunci menunggu kepercayaan.** Aturan `permissions.allow`, `permissions.additionalDirectories`, `extraKnownMarketplaces`, dan sebagian besar nilai [`env`](/docs/id/settings-reference#env) hanya berlaku setelah setiap rekan kerja [mempercayai folder](/docs/id/permissions#project-allow-rules-and-workspace-trust). Sampai saat itu mereka masih melihat prompt dan tidak mendapatkan plugins dari marketplace yang dideklarasikan file. Aturan `deny` dan `ask` berlaku segera.773* **Kunci menunggu kepercayaan.** Aturan `permissions.allow`, `permissions.additionalDirectories`, `extraKnownMarketplaces`, dan sebagian besar nilai [`env`](/docs/id/settings-reference#env) hanya berlaku setelah setiap rekan kerja [mempercayai folder](/docs/id/permissions#project-allow-rules-and-workspace-trust). Sampai saat itu mereka masih melihat prompt dan tidak mendapatkan plugins dari marketplace yang dideklarasikan file. Aturan `deny` dan `ask` berlaku segera.
770 774
771<h4 id="permission-rules-combine-differently-than-you-expected">775<h4 id="permission-rules-combine-differently-than-you-expected">