Semua pengaturan

Referensi lengkap untuk setiap kunci settings.json Claude Code: di mana masing-masing berada, tipe dan defaultnya, serta contoh siap tempel, dengan indeks setiap kunci.

Kembali ke indeks

Halaman referensi ini mencantumkan setiap kunci yang dibaca Claude Code dari file pengaturan, ditambah kelompok kunci pendek yang disimpannya di ~/.claude.json sebagai gantinya. Untuk memilih file, atau memeriksa prioritas, mulai dengan File pengaturan dan prioritas.

Indeks pengaturan

Setiap kunci di bawah ini tertaut ke entrinya. Cakupan mencantumkan file tempat kunci tersebut dapat ditempatkan: User adalah ~/.claude/settings.json, Project adalah .claude/settings.json, Local adalah .claude/settings.local.json, dan Managed adalah apa yang di-deploy oleh organisasi Anda. File apa pun berarti keempatnya, dan Global config berarti ~/.claude.json.

Model dan respons

Pilih model mana yang digunakan Claude Code dan bagaimana ia merespons. Untuk mengetahui bagaimana pengaturan ini berinteraksi dengan perintah /model dan environment variable, lihat Konfigurasi model.

advisorModel

Pilih model mana yang menjawab ketika Claude memanggil advisor tool sisi server. Hapus nilainya untuk mematikan advisor. Advisor harus setidaknya sama mampunya dengan model utama Anda. Lihat Memilih model advisor untuk pasangan yang diterima dan apa yang terjadi ketika Anda memilih pasangan yang tidak diterima.

Anda biasanya tidak mengedit kunci ini secara manual. Jalankan /advisor untuk membuka pemilih yang menampilkan pilihan saat ini, model yang dapat menjadi advisor, dan No advisor. Claude Code menyimpan pilihan Anda ke kunci ini di ~/.claude/settings.json. Jika Anda memilih dari klien Remote Control atau dalam sesi yang terhubung ke worker jarak jauh, pilihan tersebut hanya berlaku untuk sesi itu dan tidak mengubah kunci ini.

Jika akun Anda memerlukan persetujuan kredit penggunaan, terima terlebih dahulu dengan menjalankan /model fable. Sebelum Anda melakukannya, memilih Fable di /advisor tidak menyimpan apa pun dan Claude Code meminta Anda menjalankan /model fable terlebih dahulu.

• Cakupan: Any file
• Tipe: string, salah satu alias "fable", "opus", atau "sonnet", yang di-resolve ke versi default Claude Code saat ini dari keluarga model tersebut, atau ID model lengkap seperti "claude-opus-5-5"
• Default: tidak diatur, sehingga advisor mati
• Override per sesi: --advisor diutamakan daripada kunci ini untuk satu sesi. CLAUDE_CODE_DISABLE_ADVISOR_TOOL mematikan advisor, dan kunci ini tidak dapat menyalakannya kembali

{
  "advisorModel": "opus"
}

Kunci ini tidak berpengaruh pada penyedia yang advisor-nya tidak tersedia, seperti Amazon Bedrock. Pada Claude Platform on AWS, kunci ini memerlukan Claude Code v2.1.300 atau yang lebih baru. "fable" memerlukan akses Fable.

alwaysThinkingEnabled

Matikan extended thinking untuk setiap sesi dengan mengatur ini ke false. Thinking aktif secara default, sehingga true tidak mengubah apa pun. Kebanyakan orang mengatur ini melalui /config daripada mengedit file.

Pada model yang selalu melakukan thinking, seperti Opus 5.5, Sonnet 5.5, Haiku 5.5, dan model Fable, false tidak berpengaruh. Pada penyedia pihak ketiga Claude Code menghilangkan parameter thinking alih-alih mematikan thinking, sehingga model adaptive-reasoning mungkin tetap melakukan thinking. Dengan thinking dimatikan pada Anthropic API, Claude Code mengirim effort high alih-alih tingkat yang lebih tinggi ke model yang diketahuinya tidak menerima kombinasi tersebut, seperti Opus 5.

• Cakupan: Any file
• Tipe: Boolean
  • true: tidak berpengaruh; thinking sudah aktif
  • false: Claude Code mematikan extended thinking untuk setiap sesi
• Default: tidak diatur, sehingga thinking aktif untuk model yang mendukungnya
• Override per sesi: MAX_THINKING_TOKENS diutamakan daripada kunci ini untuk satu sesi: 0 mematikan thinking, dengan batasan model dan penyedia yang sama seperti false, dan nilai positif menyalakan thinking bahkan ketika kunci ini false. Pada model adaptive-reasoning, angka itu sendiri diabaikan

{
  "alwaysThinkingEnabled": false
}

availableModels

Batasi model mana yang dapat dipilih orang untuk sesi utama, subagent, skills, dan advisor. Daftar terkelola membatasi /model, --model, dan kunci model di file milik developer sendiri; model di luar daftar tidak dapat dipilih. Dengan pencocokan prefiks default, ini tidak menyentuh opsi Default dengan sendirinya; pasangkan dengan enforceAvailableModels untuk itu.

• Cakupan: Any file. Deploy di pengaturan terkelola untuk memberlakukannya bagi organisasi.
• Tipe: array alias atau ID model
• Default: tidak diatur, sehingga setiap model tersedia

Contoh ini hanya mengizinkan orang memilih model Sonnet dan Haiku:

{
  "availableModels": ["sonnet", "haiku"]
}

Entri ID model seperti "claude-opus-5" juga mengizinkan versi yang lebih baru yang memperluasnya, seperti Opus 5.5. Untuk memblokir salah satu versi tersebut, gunakan deniedModels. Agar setiap entri ID model hanya mengizinkan versi yang disebutkannya, gunakan availableModelsMatch. Lihat Membatasi pemilihan model. Untuk ID penyedia pihak ketiga, lihat Menyematkan model untuk deployment pihak ketiga.

availableModelsMatch

Pilih cara entri availableModels mencocokkan ID model. Secara default, entri ID model juga mengizinkan versi yang lebih baru yang memperluasnya, sehingga "claude-opus-5" mengizinkan Opus 5.5. Dengan "exact", setiap entri ID model hanya mengizinkan versi yang disebutkannya, sehingga versi yang lebih baru dari model tersebut tetap diblokir sampai Anda mencantumkannya. Memerlukan Claude Code v2.1.283 atau yang lebih baru.

• Cakupan: Managed. Claude Code mengabaikan kunci ini di pengaturan user, project, dan local serta di --settings, dengan peringatan
• Tipe: string, salah satu dari:
  • "prefix": entri ID model mengizinkan versinya dan ID model apa pun yang memperluasnya dengan segmen lain
  • "exact": entri ID model hanya mengizinkan versi yang disebutkannya, sehingga "claude-opus-5" mengizinkan Opus 5 tetapi tidak claude-opus-5-5. Entri seperti "claude-opus-4-5" juga mengizinkan ID model Anthropic bertanggalnya claude-opus-4-5-20251101. Alias keluarga seperti "opus" tetap mengizinkan seluruh keluarga, dan entri best, opusplan, serta default diabaikan
• Default: "prefix"

Contoh ini mengizinkan Opus 5 dan Sonnet 5 tanpa rilis yang lebih baru dari keduanya:

{
  "availableModels": ["claude-opus-5", "claude-sonnet-5"],
  "availableModelsMatch": "exact"
}

Dengan "exact", opsi Default juga dibatasi pada model yang tercantum setiap kali daftar menyebutkan setidaknya satu model atau keluarga. Lihat Memblokir model atau versi tertentu.

deniedModels

Blokir model tertentu, dengan atau tanpa allowlist availableModels dan bahkan ketika daftar tersebut mengizinkannya. Claude Code menyembunyikan model yang diblokir dari pemilih /model, dan model tersebut tidak dapat dipilih di mana pun availableModels diberlakukan. Sesi pada opsi Default juga tidak menjalankan model yang diblokir, seperti yang dijelaskan di Memblokir model atau versi tertentu. Memerlukan Claude Code v2.1.283 atau yang lebih baru.

• Cakupan: Managed. Claude Code mengabaikan kunci ini di pengaturan user, project, dan local serta di --settings, dengan peringatan
• Tipe: array alias atau ID model
  • Alias keluarga seperti "opus" memblokir setiap model dalam keluarga tersebut
  • ID model seperti "claude-opus-5-5" memblokir versi tersebut dalam setiap penulisan, termasuk ID bertanggal dan ID khusus penyedia
  • ID model tanpa versi minor, seperti "claude-opus-5", juga memblokir versi minor yang lebih baru seperti Opus 5.5. Tulis "claude-opus-5-0" untuk memblokir Opus 5 saja
  • Entri best, opusplan, dan default diabaikan
• Default: tidak diatur, sehingga tidak ada model yang diblokir

Contoh ini mengizinkan model Opus dan Sonnet serta memblokir Opus 5.5:

{
  "availableModels": ["opus", "sonnet"],
  "deniedModels": ["claude-opus-5-5"]
}

Lihat Memblokir model atau versi tertentu.

effortLevel

Atur tingkat effort default untuk model yang belum Anda simpan tingkatnya. Tingkat yang lebih rendah lebih cepat dan lebih murah untuk tugas yang sederhana, dan tingkat yang lebih tinggi bernalar lebih mendalam pada masalah yang kompleks.

Ketika Anda menjalankan /effort low, medium, high, atau xhigh dalam sesi interaktif di mesin Anda, Claude Code menyimpan tingkat tersebut untuk model aktif di bawah modelSettings alih-alih menulis kunci ini. Sebelum v2.1.251, /effort menulis kunci ini.

Dalam file pengaturan yang sama, Claude Code menggunakan tingkat tersimpan milik model alih-alih kunci ini. modelSettings menjelaskan prioritas lintas file.

Dalam sesi yang terhubung ke worker jarak jauh, dalam eksekusi -p, dan di Agent SDK, /effort hanya berlaku untuk sesi tersebut. Menyesuaikan tingkat effort mencantumkan pilihan interaktif yang juga hanya berlaku untuk sesi tersebut. Pesan yang dicetak /effort menyebutkan mana yang terjadi.

• Cakupan: Any file
• Tipe: string, salah satu dari:
  • "low": penalaran paling sedikit, untuk tugas singkat, terbatas, dan sensitif terhadap latensi yang tidak sensitif terhadap kecerdasan
  • "medium": mengurangi penggunaan token untuk pekerjaan yang sensitif terhadap biaya yang dapat mengorbankan sebagian kecerdasan
  • "high": menyeimbangkan penggunaan token dan kecerdasan
  • "xhigh": penalaran lebih mendalam dengan pengeluaran token yang lebih tinggi
• Default: tidak diatur
• Override per sesi: --effort diutamakan daripada kunci ini untuk satu sesi, dan CLAUDE_CODE_EFFORT_LEVEL diutamakan daripada keduanya

{
  "effortLevel": "xhigh"
}

Di file pengaturan user Anda, ~/.claude/settings.json, kunci ini adalah bentuk lama yang ditulis /effort sebelum menyimpan tingkat per model, dan kunci ini tetap berlaku di tempat sebelumnya berlaku, pada Opus 5, Fable 5.1, dan model yang lebih lama. Opus 5.5 dan model yang dirilis setelahnya mengabaikannya dan dimulai pada default masing-masing sampai Anda menyimpan tingkat untuk model tersebut, yang ditulis /effort di bawah modelSettings. Di pengaturan project, local, dan terkelola, serta dengan --settings, kunci ini berlaku untuk setiap model.

enforceAvailableModels

Pemilih /model memiliki opsi Default, dan pengaturan model default menjelaskan model yang menjadi hasil resolve-nya. Allowlist availableModels membatasi model yang dapat Anda sebutkan, tetapi dengan pencocokan prefiks default, allowlist tersebut tidak memetakan ulang default tipe akun Anda, sehingga Default masih dapat di-resolve ke model di luar daftar. Kunci ini menutup celah tersebut. Memerlukan Claude Code v2.1.175 atau yang lebih baru.

Ketika organisasi Anda men-deploy pengaturan terkelola apa pun, Claude Code membaca kunci ini hanya dari sumber terkelola dan mengabaikannya di file Anda yang lain.

Untuk cara kunci ini berlaku pada pemeriksaan model saat startup, lihat Amazon Bedrock dan Google Cloud's Agent Platform.

• Cakupan: Any file
• Tipe: Boolean
  • true: ketika Default akan di-resolve ke model di luar availableModels, Claude Code me-resolve-nya ke model tersedia pertama dalam daftar
  • false: kunci ini tidak mengubah cara Default di-resolve
• Default: false

Contoh ini membatasi pilihan bernama ke model Sonnet dan Haiku dan membuat Default di-resolve ke yang pertama di antara keduanya yang tersedia:

{
  "availableModels": ["sonnet", "haiku"],
  "enforceAvailableModels": true
}

Kunci ini tidak berpengaruh ketika availableModels tidak diatur atau kosong. Lihat Memberlakukan allowlist untuk model Default. Memerlukan Claude Code v2.1.175 atau yang lebih baru.

fallbackModel

Sebutkan model cadangan yang akan dicoba Claude Code, secara berurutan, ketika model utama Anda kelebihan beban atau tidak tersedia. Claude Code beralih ke model tersedia berikutnya dalam rantai untuk sisa giliran dan menampilkan pemberitahuan. Tanpa rantai, Claude Code mencoba ulang model yang sama lalu menampilkan error dari server, dan Anda mencoba ulang atau beralih model sendiri.

Peralihan berarti satu giliran dengan prompt cache yang dingin pada model fallback; pesan Anda berikutnya mencoba model utama terlebih dahulu lagi.

• Cakupan: Any file
• Tipe: array alias atau ID model; "default" diperluas menjadi model default
• Default: tidak diatur, sehingga permintaan yang gagal tidak dicoba ulang pada model lain
• Override per sesi: --fallback-model diutamakan daripada kunci ini untuk satu sesi

Contoh ini mencoba Sonnet 5 terlebih dahulu, lalu Haiku 4.5, ketika model utama Anda gagal:

{
  "fallbackModel": ["claude-sonnet-5", "claude-haiku-4-5"]
}

Tidak seperti kebanyakan pengaturan array, kunci ini tidak digabungkan lintas file pengaturan: file dengan prioritas tertinggi yang mendefinisikannya menyediakan seluruh rantai. Jika file project Anda mengatur ["claude-sonnet-5"] dan file user Anda mengatur ["claude-haiku-4-5"], rantainya hanya ["claude-sonnet-5"]. Claude Code menyimpan paling banyak tiga model berbeda yang diizinkan dari daftar dan mengabaikan sisanya. Lihat Rantai model fallback.

fastMode

Aktifkan fast mode untuk sesi di mana fitur ini tersedia, untuk pekerjaan interaktif seperti iterasi cepat atau debugging langsung di mana Anda menginginkan kecepatan dengan biaya per token yang lebih tinggi. Anda biasanya tidak mengedit kunci ini secara manual. Menjalankan /fast menulis fastMode: true ke ~/.claude/settings.json, dan menjalankannya lagi untuk mematikan fast mode akan menghapus kunci tersebut.

Pada Anthropic API, hanya Fable 5.2, Opus 5.5, Opus 5, dan Opus 4.8 yang mendukung fast mode. Menjalankan /fast dari model lain akan mengalihkan Anda ke Opus, dan beralih ke model yang tidak didukung akan mematikan fast mode. Lihat Beralih model saat fast mode aktif. Pada Google Cloud's Agent Platform, /fast mengalihkan Anda ke Fable 5.2 sebagai gantinya dan tidak menulis kunci ini, dan Claude Code mengabaikan true yang tersimpan.

• Cakupan: Any file
• Tipe: Boolean
  • true: Claude Code mengaktifkan fast mode untuk sesi di mana fitur ini tersedia. Pada Fable 5.2, Anda juga harus menjalankan /fast saat menggunakan Fable 5.2
  • false: fast mode tetap mati
• Default: tidak diatur, sehingga fast mode mati
• Override per sesi: CLAUDE_CODE_DISABLE_FAST_MODE mematikan fast mode untuk satu sesi, dan kunci ini tidak dapat menyalakannya kembali

{
  "fastMode": true
}

fastModePerSessionOptIn

Biasanya, menjalankan /fast menyimpan fastMode ke pengaturan user seseorang, sehingga sesi baru pada model yang didukung dimulai dengan fast mode aktif. Pada Fable 5.2, hal itu hanya terjadi jika mereka mengaktifkannya saat menggunakan Fable 5.2. Agar setiap orang menjalankan /fast di setiap sesi yang menginginkannya, atur kunci ini ke true. Claude Code membiarkan fastMode di file mereka, sehingga mematikan kunci ini memulihkan perilaku lama.

Owner pada paket Team atau Enterprise dapat men-deploy-nya ke seluruh organisasi melalui pengaturan terkelola server. Ketika pengaturan terkelola mengatur kunci ini, /fast on ditolak di luar sesi terminal interaktif dan melaporkan bahwa organisasi Anda telah menonaktifkan fast mode. Hal itu mencakup mode non-interaktif, ekstensi VS Code, dan sesi cloud.

• Cakupan: Any file
• Tipe: Boolean
  • true: fastMode: true yang tersimpan tidak lagi mengaktifkan fast mode saat sesi dimulai, sehingga setiap orang menjalankan /fast di setiap sesi yang menginginkannya; fastMode: true yang diberikan dengan --settings tetap berlaku untuk sesi tersebut kecuali pengaturan terkelola mengatur kunci ini
  • false: fastMode: true yang tersimpan berfungsi seperti yang dijelaskan fastMode
• Default: false

{
  "fastModePerSessionOptIn": true
}

Lihat Mewajibkan opt-in per sesi.

language

Buat Claude merespons dalam bahasa selain bahasa Inggris secara default. Tidak ada daftar tetap untuk respons: Claude Code meneruskan nilai apa adanya ke Claude sebagai instruksi untuk selalu merespons dalam bahasa tersebut, sehingga nama bahasa apa pun yang dapat dibaca Claude akan berfungsi. Claude Code tidak memeriksa nilainya, sehingga nama yang salah eja sampai ke Claude sebagaimana ditulis alih-alih menghasilkan error. Nilai yang sama mengatur bahasa untuk dikte suara, yang memang memiliki daftar tetap bahasa dikte yang didukung, dan untuk judul sesi yang dibuat otomatis.

• Cakupan: Any file
• Tipe: string, nama bahasa apa pun, seperti "japanese", "spanish", atau "french"; Claude Code tidak memvalidasinya
• Default: tidak diatur; judul sesi kemudian mengikuti bahasa percakapan Anda

{
  "language": "japanese"
}

maxEffortLevel

Batasi tingkat effort yang dapat digunakan sesi, dengan tetap menyediakan tingkat yang lebih rendah. Tingkat yang lebih tinggi akan berjalan pada batas tersebut, termasuk yang berasal dari /effort, pemilih /model, --effort, CLAUDE_CODE_EFFORT_LEVEL, frontmatter effort milik skill atau subagent, atau default milik model itu sendiri. Claude Code menerapkan batas itu sendiri sebelum setiap permintaan, sehingga batas tersebut berlaku di setiap penyedia, termasuk Amazon Bedrock, Google Cloud's Agent Platform, dan Microsoft Foundry. Memerlukan Claude Code v2.1.267 atau yang lebih baru.

• Cakupan: Any file. Deploy di pengaturan terkelola untuk memberlakukannya bagi organisasi. Ketika beberapa cakupan mengatur batas, batas terendah yang berlaku, sehingga batas yang diatur di satu cakupan tidak dapat dinaikkan dari cakupan lain
• Tipe: string, salah satu dari "low", "medium", "high", "xhigh", atau "max". Nilai "max" tidak mengatur batas
• Default: tidak diatur, sehingga tidak ada batas yang berlaku
• Batas per model: tambahkan maxEffortLevel ke entri modelSettings milik model. Entri tersebut menggantikan kunci ini untuk model itu hanya dalam sumber pengaturan yang mengatur keduanya, seperti pengaturan user Anda atau satu sumber terkelola. Atur "max" di sana untuk membebaskan model dari batas sumber tersebut; Claude Code tetap menerapkan batas dari sumber lain

Contoh ini membatasi setiap model pada medium dan membebaskan Sonnet 4.6:

{
  "maxEffortLevel": "medium",
  "modelSettings": {
    "claude-sonnet-4-6": {
      "maxEffortLevel": "max"
    }
  }
}

Ketika organisasi Anda juga mengatur batas effort untuk suatu model, batas yang lebih rendah dari keduanya yang berlaku.

model

Atur model yang digunakan setiap sesi baru, sehingga Anda tidak perlu memilihnya dengan /model setiap kali. Mengaturnya di sini tidak menghalangi Anda beralih di tengah sesi. Jika admin Anda mengatur model default organisasi untuk menimpa pilihan user, Anda mendapatkan model tersebut bahkan ketika Anda mengatur kunci ini di pengaturan user, project, atau local.

• Cakupan: Any file
• Tipe: string, alias model atau ID model lengkap
• Default: tidak diatur, sehingga Claude Code menggunakan model default akun Anda
• Override per sesi: --model diutamakan daripada ANTHROPIC_MODEL, dan keduanya diutamakan daripada kunci ini untuk satu sesi, termasuk daripada model terkelola; daftar availableModels tetap berlaku untuk pilihan tersebut

{
  "model": "claude-sonnet-5"
}

Nilai di sini memiliki prioritas lebih tinggi daripada ANTHROPIC_DEFAULT_MODEL, yang hanya digunakan Claude Code ketika tidak ada hal lain yang memilih model.

modelOverrides

Petakan ID model Anthropic ke ID model khusus penyedia, seperti ARN inference profile Amazon Bedrock. Setiap entri pemilih model kemudian menggunakan nilai yang dipetakan saat memanggil API penyedia. Administrator menggunakan ini pada Amazon Bedrock, Google Cloud's Agent Platform, dan Microsoft Foundry untuk merutekan setiap versi model ke inference profile, nama versi, atau deployment tertentu untuk tata kelola, alokasi biaya, atau perutean regional.

• Cakupan: Any file
• Tipe: objek yang memetakan ID model ke ID model penyedia
• Default: tidak diatur

Contoh ini merutekan setiap panggilan untuk Opus 4.6 ke inference profile Bedrock yang disebutkan:

{
  "modelOverrides": {
    "claude-opus-4-6": "arn:aws:bedrock:us-east-1:123456789012:inference-profile/example"
  }
}

Lihat Menimpa ID model per versi.

modelPicker

Cantumkan model yang ditawarkan pemilih /model, dalam urutan yang Anda tulis dan dengan label yang Anda pilih, sehingga pemilih mencantumkan model yang dijalankan organisasi Anda, setelah jajaran bawaan atau sebagai penggantinya. model setiap baris diambil apa adanya, sehingga menerima apa pun yang diterima --model: alias seperti opus, ID model Anthropic, atau ID berformat penyedia untuk Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry, atau LLM gateway. Memerlukan Claude Code v2.1.242 atau yang lebih baru.

• Cakupan: User or managed. Claude Code membaca kunci ini dari pengaturan terkelola, --settings, dan pengaturan user, serta mengabaikannya di pengaturan project dan local sehingga repositori yang Anda clone tidak dapat melabeli ulang pemilih. Yang tertinggi dari ketiganya yang mengatur kunci ini menyediakan seluruh jajaran, dan Claude Code tidak pernah menggabungkan jajaran dari dua sumber.
• Tipe: objek dengan array baris options dan Boolean replaceBuiltInOptions opsional
• Default: tidak diatur, sehingga pemilih menampilkan jajaran bawaan

Contoh ini menambahkan dua deployment Bedrock setelah jajaran bawaan, dengan nama yang dikenali tim Anda:

{
  "modelPicker": {
    "options": [
      { "model": "us.anthropic.claude-opus-4-8", "label": "Opus (production)" },
      {
        "model": "us.anthropic.claude-sonnet-4-6",
        "label": "Sonnet (production)",
        "description": "Day-to-day work"
      }
    ]
  }
}

Field untuk modelPicker

Kunci ini menerima dua field, satu untuk baris itu sendiri dan satu untuk menentukan apakah baris tersebut menggantikan jajaran bawaan atau menambahkannya.

Entri di options juga dapat membawa string behavesAs opsional di samping model-nya, yang memerlukan v2.1.257 atau yang lebih baru. Atur ke ID model yang sudah dikenali versi Claude Code Anda, seperti claude-opus-4-8, pada entri yang model-nya lebih baru dari versi Anda. Claude Code kemudian menerapkan kemampuan dan default effort model yang dikenal tersebut ke entri alih-alih memperlakukan modelnya sebagai tidak dikenal. Label entri dan ID model yang dikirim Claude Code dalam permintaan tidak berubah.

Dengan replaceBuiltInOptions aktif, Claude Code menyembunyikan setiap baris lainnya: jajaran bawaan, baris yang ditambahkannya untuk entri availableModels, model yang ditemukan penemuan gateway, dan ANTHROPIC_CUSTOM_MODEL_OPTION. Dengan opsi ini mati, Claude Code melewati model tercantum yang sudah dicakup jajaran bawaan. Label mengubah apa yang ditampilkan pemilih, bukan model mana yang dijalankan Claude Code.

Allowlist availableModels tetap berlaku untuk baris-baris ini. Sebelum Anda menambahkan model tercantum ke allowlist, baca Perilaku penggabungan: ID model tertentu mempersempit entri wildcard keluarganya. Claude Code juga memeriksa setiap baris terhadap sesi sebelum menampilkan pemilih:

• Dihapus: baris yang tidak dapat dilayani Claude Code, seperti model yang sudah dihentikan atau model yang tidak dapat diakses organisasi Anda
• Berwarna abu-abu: baris yang belum dapat Anda pilih, ditampilkan beserta alasannya
• Tidak ada baris yang tersisa: Claude Code mempertahankan jajaran bawaan, difilter oleh allowlist seperti biasa

Claude Code menghapus baris yang tidak dapat diurainya dan mempertahankan sisanya. Lihat Memperbaiki file pengaturan yang rusak.

modelPricing

Laporkan pengeluaran dengan tarif yang dibayar organisasi Anda alih-alih harga daftar. Atur ketika organisasi Anda memiliki tarif kontrak, sehingga angka dolar yang dilihat developer sesuai dengan tagihan Anda. Claude Code menerapkan tarif tersebut di /usage, baris status, total_cost_usd milik Agent SDK, batas --max-budget-usd, serta metrik dan event biaya OpenTelemetry. Anda yang menyediakan tarifnya: Claude Code tidak membacanya dari kontrak Anda atau Claude Console. Memerlukan Claude Code v2.1.242 atau yang lebih baru.

• Cakupan: Managed. Deploy kunci ini melalui pengaturan terkelola server, kebijakan MDM, file managed-settings.json, atau policy helper. Claude Code mengabaikannya di pengaturan user, project, dan local, di --settings, dan di Windows pada registri HKCU yang dapat ditulis user. Dengan pengaturan terkelola server, setiap sesi melaporkan biaya dengan harga daftar sampai pengambilan pengaturan sesi tersebut telah mengonfirmasi pengaturan. Aplikasi host yang menyematkan Claude Code dan mengatur CLAUDE_CODE_PROVIDER_MANAGED_BY_HOST dapat menyediakan tabelnya sendiri melalui opsi SDK managedSettings, yang digunakan Claude Code hanya ketika tidak ada sumber terkelola yang mengatur kunci ini dan hanya di Claude Code v2.1.246 atau yang lebih baru.
• Tipe: objek dengan multiplier opsional dan map overrides opsional
• Default: tidak diatur, sehingga Claude Code melaporkan harga daftar kecuali aplikasi host menyediakan tabel

Atur multiplier saja untuk diskon atau markup datar, overrides saja untuk tarif per model, atau keduanya.

Contoh ini mengatur tarif kontrak untuk Sonnet 4.6 lalu mengurangi setiap angka, termasuk baris Sonnet, sebesar 15%:

{
  "modelPricing": {
    "multiplier": 0.85,
    "overrides": {
      "claude-sonnet-4-6": {
        "input": 2.4,
        "output": 12,
        "cacheRead": 0.24,
        "cacheWrite": 3
      }
    }
  }
}

Atur multiplier di atas 1, hingga 10, untuk menaikkan setiap angka. Markup memerlukan Claude Code v2.1.271 atau yang lebih baru. Versi sebelumnya mengabaikan multiplier di atas 1 dengan peringatan dan mempertahankan sisa pengaturan.

Untuk langkah-langkahnya, termasuk cara mengonfirmasi bahwa tarif sudah berlaku, lihat Melaporkan pengeluaran dengan tarif kontrak Anda.

Field untuk modelPricing

Claude Code menggunakan tarif sebuah baris persis seperti yang Anda tulis, tanpa menambahkan biaya tambahan fast mode atau tarif inferensi khusus AS. Jika Anda juga mengatur multiplier, Claude Code menerapkannya di atas tarif baris tersebut. Claude Code menghapus baris dengan tarif yang tidak dapat diurainya, atau multiplier yang tidak dapat diurainya, dan mempertahankan sisanya; lihat Memperbaiki file pengaturan yang rusak.

Model mana yang dikenai baris modelPricing

Claude Code menentukan model mana yang dikenai sebuah baris berdasarkan kunci baris tersebut:

• ID model bawaan: kunci yang digunakan Claude Code sendiri untuk model bawaan, baik kunci tersebut adalah ID model itu sendiri, seperti claude-sonnet-4-6, atau ID Bedrock, Agent Platform, atau Foundry-nya. Claude Code menerapkan baris tersebut ke setiap ID snapshot bertanggal dan ID khusus penyedia dari model tersebut.
• Kunci lainnya: kunci yang bukan ID model bawaan, seperti alias model gateway. Claude Code menerapkan baris tersebut hanya ke satu ID itu. Ketika ID model cocok persis dengan salah satu kunci Anda dan juga termasuk dalam baris yang dikunci oleh ID model bawaan, Claude Code menggunakan yang cocok persis.
• Application inference profile Bedrock: setelah Claude Code me-resolve profile ke model yang dirutekannya, melalui map modelOverrides Anda atau lookup bedrock:GetInferenceProfile, Claude Code menerapkan baris model tersebut ke profile.

modelSettings

Simpan tingkat effort untuk setiap model yang Anda gunakan. Memerlukan Claude Code v2.1.251 atau yang lebih baru.

Dalam sesi interaktif di mesin Anda, ketika Anda menyimpan low, medium, high, atau xhigh sebagai default Anda dengan /effort atau slider effort pada pemilih /model, Claude Code menulis tingkat tersebut di sini di bawah model yang Anda gunakan, sehingga Anda jarang mengedit kunci ini sendiri. Ketika Anda memilih salah satu tingkat tersebut di pemilih model ekstensi VS Code, Claude Code menyimpannya di sini dengan cara yang sama. Entri effortLevel mencantumkan sesi di mana /effort hanya berlaku untuk sesi tersebut.

Edit kunci ini secara manual untuk mengubah atau menghapus tingkat yang Anda simpan.

effortLevel milik model di sini diutamakan daripada effortLevel tingkat atas di file pengaturan yang sama. Lintas file, Claude Code me-resolve setiap model secara terpisah: file pengaturan dengan prioritas tertinggi yang mengatur effortLevel untuk model tersebut atau effortLevel tingkat atas yang berlaku untuk model tersebut yang menentukan, sehingga effortLevel di pengaturan terkelola memiliki prioritas lebih tinggi daripada tingkat yang Anda simpan di pengaturan user. Menyesuaikan tingkat effort mencantumkan hal lain yang dapat menimpa tingkat tersimpan, seperti --effort saat peluncuran.

Untuk membatasi effort satu model alih-alih mengatur tingkatnya, tambahkan field maxEffortLevel ke entri model tersebut. Field ini memerlukan Claude Code v2.1.267 atau yang lebih baru.

• Cakupan: Any file
• Tipe: objek yang memetakan nama model ke objek dengan satu atau beberapa field berikut:
  • effortLevel: salah satu dari "low", "medium", "high", atau "xhigh"
  • maxEffortLevel: tingkat effort tertinggi yang dapat digunakan model
  • autoCompactWindow: jumlah token dari 100000 hingga 1000000, atau "auto" untuk window yang disesuaikan untuk model tersebut. /autocompact menyimpan di sini. Untuk model tersebut, nilai ini diutamakan daripada autoCompactWindow tingkat atas di file pengaturan yang sama. Memerlukan Claude Code v2.1.288 atau yang lebih baru
• Default: tidak diatur

Claude Code menulis setiap entri di bawah nama kanonis model, seperti claude-opus-5-5, dan mencocokkan alias, ID bersufiks tanggal, [1m], serta ID khusus penyedia yang dikenali dari model tersebut ke entri yang sama.

Contoh ini mempertahankan Opus 5.5 pada high sementara model lain menggunakan tingkat tersimpan atau default masing-masing:

{
  "modelSettings": {
    "claude-opus-5-5": {
      "effortLevel": "high"
    }
  }
}

Jalankan /effort auto untuk menghapus tingkat tersimpan untuk model yang Anda gunakan. Claude Code membiarkan entri lain dan effortLevel tingkat atas apa pun tetap di tempatnya.

outputStyle

Pilih gaya output berdasarkan nama. Gaya output adalah kumpulan instruksi tersimpan yang mengubah peran, nada, dan format output Claude, seperti gaya bawaan Explanatory dan Learning atau gaya yang Anda tulis sendiri.

Jika Anda mengubah kunci ini selama sesi, Claude menggunakan gaya baru mulai dari pesan Anda berikutnya. Untuk biaya pesan tersebut dalam prompt caching, lihat Mengubah gaya output. Sebelum v2.1.251, perubahan hanya berlaku setelah Anda menjalankan /clear atau memulai sesi baru.

• Cakupan: Any file
• Tipe: string, nama gaya output bawaan atau kustom
• Default: tidak diatur, sehingga Claude Code menggunakan gaya default

Contoh ini memilih gaya bawaan Explanatory, yang menambahkan wawasan edukatif di antara tugas:

{
  "outputStyle": "Explanatory"
}

promptCacheTtl

Pilih berapa lama prompt cache menyimpan percakapan utama. Kunci ini berlaku untuk giliran interaktif, -p, dan Agent SDK Anda, bersama dengan helper yang dijalankan Claude Code secara inline bersamanya. Masa berlaku satu jam menjaga cache tetap hangat selama jeda yang lebih lama, dan API menagih setiap penulisan cache dengan tarif yang lebih tinggi dibandingkan masa berlaku lima menit. Memerlukan Claude Code v2.1.242 atau yang lebih baru.

• Cakupan: Any file
• Tipe: string, salah satu dari:
  • "5m": cache bertahan selama lima menit
  • "1h": cache bertahan selama satu jam
• Default: tidak diatur, sehingga setiap permintaan percakapan utama mendapatkan masa berlaku default-nya
• Override per sesi: FORCE_PROMPT_CACHING_5M diutamakan daripada semua yang lain, lalu CLAUDE_CODE_PROMPT_CACHE_TTL, lalu kunci ini, dan terakhir ENABLE_PROMPT_CACHING_1H

Contoh ini mempertahankan percakapan utama pada masa berlaku satu jam dan membiarkan subagent pada lima menit:

{
  "promptCacheTtl": "1h",
  "subagentPromptCacheTtl": "5m"
}

Untuk biaya setiap masa berlaku, lihat Masa berlaku cache.

showThinkingSummaries

Lihat ringkasan extended thinking Claude dalam sesi interaktif. Atur ini jika Anda menginginkan ringkasan lengkap ketika Anda memperluas thinking dengan Ctrl+O. Ketika tidak diatur atau false, Anthropic API menyunting thinking block dan Claude Code menampilkan stub yang diciutkan.

• Cakupan: Any file
• Tipe: Boolean
  • true: Anda melihat ringkasan thinking lengkap ketika Anda memperluas thinking dengan Ctrl+O
  • false: Anthropic API menyunting thinking block dan Claude Code menampilkan stub yang diciutkan
• Default: false

{
  "showThinkingSummaries": true
}

Penyuntingan hanya mengubah apa yang Anda lihat, bukan apa yang dihasilkan model. Untuk mengurangi pengeluaran thinking, turunkan budget atau nonaktifkan thinking sebagai gantinya.

subagentPromptCacheTtl

Pilih berapa lama prompt cache menyimpan permintaan yang dibuat Claude Code di luar percakapan utama. Kunci ini berlaku untuk subagent, workflow, dan permintaan latar belakang serta helper milik Claude Code sendiri, seperti compaction dan judul sesi. Masa berlaku satu jam menjaga cache tetap hangat selama jeda yang lebih lama, dan API menagih setiap penulisan cache dengan tarif yang lebih tinggi dibandingkan masa berlaku lima menit. Memerlukan Claude Code v2.1.242 atau yang lebih baru.

• Cakupan: Any file
• Tipe: string, salah satu dari:
  • "5m": cache bertahan selama lima menit
  • "1h": cache bertahan selama satu jam
• Default: tidak diatur, sehingga setiap permintaan ini mendapatkan masa berlaku default-nya
• Override per sesi: FORCE_PROMPT_CACHING_5M diutamakan daripada semua yang lain, lalu CLAUDE_CODE_SUBAGENT_PROMPT_CACHE_TTL, lalu kunci ini, lalu ENABLE_PROMPT_CACHING_1H, yang meminta masa berlaku satu jam pada setiap permintaan. Untuk posisi prioritas nilai frontmatter milik subagent sendiri, lihat Memilih TTL sendiri

Contoh ini memberikan masa berlaku satu jam kepada subagent dan permintaan lain di luar percakapan utama:

{
  "subagentPromptCacheTtl": "1h"
}

Kunci ini mencakup permintaan yang tidak dicakup promptCacheTtl, jadi atur keduanya untuk memilih masa berlaku bagi setiap permintaan yang dibuat Claude Code. Untuk perbedaan cache subagent dengan cache percakapan utama, lihat Subagent dan cache.

switchModelsOnFlag

Pilih apa yang terjadi ketika pengklasifikasi keamanan menandai permintaan: beralih ke model fallback dan melanjutkan, atau berhenti sejenak agar Anda dapat memilih antara beralih dan mengedit prompt.

• Cakupan: Any file. Muncul di /config sebagai Switch models when a message is flagged, dengan opsi Switch automatically dan Ask each time.
• Tipe: Boolean
  • true: Claude Code beralih ke model fallback dan melanjutkan
  • false: dalam sesi interaktif, Claude Code berhenti sejenak agar Anda dapat memilih antara beralih dan mengedit prompt; di tempat dialog tidak dapat ditampilkan, seperti eksekusi -p, permintaan yang ditandai berakhir sebagai error
• Default: tidak diatur. Claude Code beralih secara otomatis, meskipun mungkin bertanya terlebih dahulu dalam sesi interaktif

{
  "switchModelsOnFlag": false
}

Lihat Bertanya sebelum beralih.

ultracode

Mulai sesi dengan ultracode aktif. Dengan opsi ini aktif, Claude merencanakan workflow untuk setiap tugas substantif alih-alih menunggu Anda memintanya. Claude merencanakan workflow hanya ketika dynamic workflows diaktifkan untuk Anda dan model Anda mendukung effort xhigh. Kunci ini tidak mengubah tingkat effort sesi: ultracode berjalan pada tingkat mana pun yang digunakan sesi. Claude Code membaca kunci ini tetapi tidak pernah menulisnya: /effort ultracode mengaktifkan ultracode hanya untuk sesi saat ini.

• Cakupan: Any file
• Tipe: Boolean
  • true: sesi dimulai dengan ultracode aktif ketika dynamic workflows diaktifkan untuk Anda dan model Anda mendukung xhigh
  • false: sesi dimulai dengan ultracode mati
• Default: tidak diatur, sehingga ultracode mati
• Override per sesi: /effort ultracode mengaktifkan ultracode untuk satu sesi tanpa kunci ini, dan /effort ultracode off mematikannya untuk satu sesi ketika kunci ini true. Flag --effort ultracode juga mengaktifkannya untuk satu sesi, pada effort xhigh

{
  "ultracode": true
}

Tingkat effort sesi berasal dari effortLevel, modelSettings, dan sumber effort lainnya, dan batas effort seperti maxEffortLevel menurunkan tingkat tersebut tanpa mematikan ultracode. Hal ini dan bentuk /effort ultracode off memerlukan Claude Code v2.1.284 atau yang lebih baru. Sebelum v2.1.284, ultracode: true menjalankan sesi pada effort xhigh, dan batas effort di bawah xhigh membuat ultracode tetap mati. Permintaan kontrol apply_flag_settings Agent SDK juga menerima kunci ini.

Pengaturan izin

Tentukan apa yang dapat dilakukan Claude tanpa bertanya, mode izin default untuk sesi baru, dan apa yang diizinkan pengklasifikasi auto mode. Untuk sintaks aturan dan model izin, lihat Konfigurasi izin.

allowManagedPermissionRulesOnly

Jadikan pengaturan terkelola satu-satunya sumber pengaturan aturan izin. Claude Code kemudian mengabaikan aturan allow, ask, dan deny dalam file pengguna, proyek, lokal, dan --settings, mengabaikan --allowedTools, menyembunyikan pilihan selalu-izinkan dalam dialog izin, dan berhenti menyimpan aturan baru.

Ketika pengaturan induk dari host penyematan berlaku, Claude Code memperlakukan mereka sebagai bagian dari tingkat terkelola. Claude Code menghapus aturan allow dan additionalDirectories mereka, dan mempertahankan aturan deny dan ask mereka kecuali aturan Read dan Edit yang polanya dimulai dengan !. Host tidak dapat mengukir jalur dari aturan terkelola dengan aturan !, terlepas dari apakah Anda menetapkan kunci ini.

Aturan --disallowedTools dan aturan deny dan ask sesi saat ini masih berlaku, termasuk setelah Claude Code memuat ulang pengaturan di tengah sesi. Mereka hanya membatasi, jadi mereka tidak dapat memperluas apa yang diberikan aturan terkelola. Sebelum v2.1.257, Claude Code menghapus aturan baris perintah dan sesi tersebut pada pemuatan ulang pengaturan pertama.

Untuk apa yang dapat diukir pola ! dalam aturan --disallowedTools atau sesi, lihat aturan Read dan Edit.

Ketika Anda menetapkan kunci ini, Claude Code v2.1.282 atau lebih baru juga mengabaikan frontmatter allowed-tools dalam skill dan file .claude/commands/ dari sumber-sumber berikut:

• Direktori .claude/ milik repositori
• Direktori ~/.claude/skills/ dan ~/.claude/commands/ Anda, termasuk skill yang disinkronkan dari claude.ai
• Direktori --add-dir
• Plugin yang dideklarasikan dengan manifest .claude-plugin di dalam ~/.claude/skills/ atau .claude/skills/ proyek
• Plugin yang dimuat hanya untuk satu sesi, yang id-nya berakhiran @inline, ketika semua kondisi berikut terpenuhi:
  • Sesi tersebut adalah sesi Code atau sesi Cowork, selain sesi cloud, yang Claude Code-nya dimulai oleh aplikasi Claude Desktop itu sendiri
  • Pengaturan terkelola Anda menetapkan kunci ini, bukan hanya pengaturan induk dari host penyematan
  • Sesi menjalankan Claude Code v2.1.305 atau lebih baru

Skill dari pengaturan terkelola dan skill bawaan tetap mempertahankan allowed-tools mereka. Plugin @inline di luar sesi Desktop tersebut juga tetap mempertahankannya, kecuali plugin yang bernama anthropic-skills. disallowed-tools milik skill tetap berlaku. Untuk apa yang dilihat pengembang ketika Claude Code mengabaikan field tersebut, lihat Ketika hanya aturan izin terkelola yang berlaku.

• Scope: Managed
• Type: Boolean
  • true: pengaturan terkelola menjadi satu-satunya sumber pengaturan aturan izin
  • false: Claude Code menerapkan aturan izin dari file pengguna, proyek, lokal, dan --settings selain yang terkelola
• Default: tidak diatur, jadi Claude Code menerapkan aturan izin dari pengaturan pengguna, proyek, dan lokal serta dari --settings, selain yang terkelola

{
  "allowManagedPermissionRulesOnly": true
}

Kunci ini tidak mengunci allowlist server MCP; untuk itu, atur allowManagedMcpServersOnly. Lihat Pengaturan hanya terkelola.

autoMode

Tambahkan aturan Anda sendiri ke apa yang diblokir dan diizinkan oleh pengklasifikasi auto mode. Gunakan untuk memberi tahu pengklasifikasi repo, bucket, dan domain mana yang dipercaya organisasi Anda, sehingga berhenti memblokir operasi internal sehari-hari. Pengklasifikasi dilengkapi dengan aturan allow dan deny bawaan. Sertakan string literal "$defaults" dalam array untuk mempertahankan aturan bawaan tersebut pada posisi itu dan tambahkan milik Anda di sekitarnya; tinggalkan untuk menggantinya dengan milik Anda.

• Scope: User or managed
• Type: objek dengan array environment, allow, soft_deny, dan hard_deny dari aturan prosa, ditambah Boolean classifyAllShell
• Default: tidak diatur, jadi pengklasifikasi hanya menggunakan aturan bawaannya

Contoh ini mempertahankan aturan soft_deny bawaan, melalui "$defaults", dan menambahkan satu lagi yang memblokir terraform apply:

{
  "autoMode": {
    "soft_deny": ["$defaults", "Never run terraform apply"]
  }
}

Ketika lebih dari satu file tersebut menetapkan array yang sama, Claude Code menggabungkan entri. Untuk format aturan dan bagaimana setiap array diterapkan, lihat Konfigurasi auto mode.

autoMode.classifyAllShell

Kirim setiap perintah Bash dan PowerShell melalui pengklasifikasi auto mode saat auto mode aktif. Secara default, auto mode hanya menangguhkan aturan allow yang dapat menjalankan kode arbitrer: aturan untuk seluruh tool dan aturan wildcard seperti Bash(*), dan awalan interpreter atau shell-wrapper seperti Bash(python *). Perintah yang cocok dengan aturan allow lain, seperti Bash(npm test), melewati pengklasifikasi kecuali membawa domain yang diizinkan per-perintah. Ketika melewati, argumen destruktif yang tidak diantisipasi awalan aturan dapat lolos tanpa terlihat. Menetapkan kunci ini menangguhkan setiap aturan allow shell untuk sesi sehingga pengklasifikasi melihat setiap perintah. Memerlukan Claude Code v2.1.193 atau lebih baru.

• Scope: User or managed. Dibaca di mana pun autoMode dibaca.
• Type: Boolean
  • true: saat auto mode aktif, Claude Code mengirim setiap perintah Bash dan PowerShell melalui pengklasifikasi dan menangguhkan aturan allow shell Anda; di luar auto mode aturan masih berlaku
  • false: auto mode hanya menangguhkan aturan allow yang dapat menjalankan kode arbitrer, seperti Bash(*) dan Bash(python *); perintah yang cocok dengan aturan allow lain melewati pengklasifikasi kecuali membawa domain yang diizinkan per-perintah, dan setiap perintah shell lainnya melaluinya
• Default: false

{
  "autoMode": {
    "classifyAllShell": true
  }
}

Lihat Arahkan semua perintah shell melalui pengklasifikasi.

disableAutoMode

Hapus auto mode dari siklus Shift+Tab. Setiap sesi yang sebaliknya akan dimulai dalam auto mode, baik dari --permission-mode auto, file pengaturan, atau default bawaan, dimulai dalam default sebagai gantinya. Administrator menetapkannya dalam pengaturan terkelola untuk mencegah pengembang di organisasi mereka menggunakan auto mode.

• Scope: Any file. Paling berguna dalam pengaturan terkelola, di mana pengguna tidak dapat menimpanya. Juga diterima di bawah permissions sebagai permissions.disableAutoMode.
• Type: string "disable"
• Default: tidak diatur

{
  "disableAutoMode": "disable"
}

permissions

Kontrol tool mana yang dapat digunakan Claude tanpa bertanya, tool mana yang meminta konfirmasi, dan tool mana yang diblokir. Atur juga mode izin default untuk sesi baru. Setiap kunci permissions.* di bawah bersarang di bawah objek ini.

• Scope: Any file
• Type: objek dengan allow, ask, deny, additionalDirectories, blockReadsOutsideWorkingDirectories, blockWritesOutsideWorkingDirectories, defaultMode, denyInsteadOfPrompting, disableBypassPermissionsMode, dan disableAutoMode
• Default: tidak diatur

Contoh ini menyetujui perintah npm run tanpa bertanya, meminta konfirmasi sebelum git push, memblokir pembacaan .env, dan memulai sesi dalam acceptEdits:

{
  "permissions": {
    "allow": ["Bash(npm run *)"],
    "ask": ["Bash(git push *)"],
    "deny": ["Read(./.env)"],
    "defaultMode": "acceptEdits"
  }
}

Tiga array aturan berbagi satu sintaks; lihat Sintaks aturan izin di bawah permissions.allow. Untuk bagaimana aturan izin dari file berbeda digabungkan, lihat bagaimana aturan izin digabungkan di seluruh cakupan; untuk bagaimana kunci pengaturan secara umum digabungkan, lihat Prioritas pengaturan pada panduan pengaturan.

useAutoModeDuringPlan

Pilih apakah Claude Code menggunakan pengklasifikasi auto mode untuk meninjau perintah shell dalam plan mode. Dengan default true, pengklasifikasi meninjau setiap perintah selama perencanaan ketika auto mode tersedia dan Anda tidak melihat permintaan izin, kecuali untuk penghapusan jalur kritis. Atur false untuk mendapatkan permintaan izin untuk setiap perintah di luar set read-only bawaan. Muncul dalam /config sebagai Use auto mode during plan.

• Scope: User, local, or managed. Repositori tidak dapat mematikannya untuk Anda.
  • false di salah satu file ini atau di --settings mematikannya, kecuali Anda mengecualikan file pengguna atau lokal tersebut dengan opsi seperti --setting-sources. Mengabaikan file yang dikecualikan memerlukan Claude Code v2.1.314 atau lebih baru
• Type: Boolean
  • true: sama dengan tidak diatur; ketika auto mode tersedia, pengklasifikasi meninjau perintah shell selama perencanaan
  • false: Anda mendapatkan permintaan izin untuk setiap perintah di luar set read-only bawaan
• Default: true

{
  "useAutoModeDuringPlan": false
}

permissions.allow

Daftar penggunaan tool yang disetujui Claude Code tanpa bertanya kepada Anda. Dalam aturan MCP, * hanya dapat muncul dalam nama tool setelah awalan mcp__<server>__, seperti mcp__github__get_*; tidak dapat muncul dalam nama server.

• Scope: Any file
• Type: array string aturan izin
• Default: tidak diatur
• Per-session overrides: --allowedTools menambahkan aturan allow untuk satu sesi, dan aturan deny dari file pengaturan apa pun masih memblokir tool yang dinamainya

Contoh ini menyetujui git diff dan memungkinkan Claude Code membaca .zshrc Anda tanpa bertanya:

{
  "permissions": {
    "allow": ["Bash(git diff *)", "Read(~/.zshrc)"]
  }
}

Claude Code menerapkan aturan allow dari .claude/settings.json proyek hanya setelah Anda menerima dialog kepercayaan workspace untuk folder itu.

Sintaks aturan izin

Aturan izin mengikuti format Tool atau Tool(specifier). Claude Code mengevaluasi aturan deny terlebih dahulu, kemudian ask, kemudian allow, dan kecocokan pertama memutuskan terlepas dari seberapa spesifik setiap aturan; lihat urutan evaluasi aturan izin.

Setiap baris menunjukkan satu bentuk aturan dan apa yang cocok dengannya.

Untuk sintaks aturan lengkap, termasuk perilaku wildcard, pola khusus tool untuk aturan Read, Edit, WebFetch, MCP, dan Agent, serta keterbatasan keamanan pola Bash, lihat Sintaks aturan izin.

permissions.ask

Daftar penggunaan tool yang meminta konfirmasi Anda bahkan dalam mode izin yang sebaliknya akan menyetujuinya, seperti acceptEdits atau bypassPermissions. Dalam mode dontAsk Claude Code menolak penggunaan tool yang cocok alih-alih meminta konfirmasi.

• Scope: Any file
• Type: array string aturan izin
• Default: tidak diatur

{
  "permissions": {
    "ask": ["Bash(git push *)"]
  }
}

permissions.deny

Daftar penggunaan tool yang diblokir Claude Code. Gunakan untuk file yang menyimpan kunci API, rahasia, atau nilai lingkungan: Claude Code mengecualikan file yang cocok dari penemuan file dan hasil pencarian, menolak pembacaannya, dan memblokir tool Edit dan Write pada jalur yang cocok.

Aturan deny Read dan Edit berlaku untuk tool file bawaan Claude, untuk perintah file yang dikenali Claude Code dalam Bash, seperti cat, head, tail, sed, dan tee, dan untuk target pengalihan Bash seperti > file dan < file; aturan tersebut tidak berlaku untuk perintah yang membaca file tanpa menamakannya, seperti grep -r pattern ., atau untuk subprocess arbitrer, jadi untuk penegakan tingkat OS aktifkan sandbox.

• Scope: Any file
• Type: array string aturan izin
• Default: tidak diatur
• Per-session overrides: --disallowedTools menambahkan aturan deny untuk satu sesi bersama kunci ini

Contoh ini menolak pembacaan file .env, direktori secrets, dan file kredensial, serta memblokir perintah curl:

{
  "permissions": {
    "deny": [
      "Read(./.env)",
      "Read(./.env.*)",
      "Read(./secrets/**)",
      "Read(./config/credentials.json)",
      "Bash(curl *)"
    ]
  }
}

Nama tool menerima pola glob, jadi "*" memblokir setiap tool dan "mcp__*" memblokir setiap tool MCP. Claude Code mengabaikan aturan deny untuk tool EndConversation selama tool lain masih tersedia untuk Claude. Aturan deny Bash cocok dengan perintah seperti yang ditulis Claude, jadi Bash(curl *) tidak menghentikan /usr/bin/curl atau sh -c 'curl …'; lihat apa yang tidak cocok dengan aturan Bash. Kunci ini menggantikan konfigurasi ignorePatterns yang sudah deprecated.

permissions.additionalDirectories

Berikan akses file kepada Claude ke direktori di luar direktori tempat Anda memulai, sebagai direktori kerja tambahan. Sebagian besar konfigurasi .claude/ tidak ditemukan dari direktori ini.

• Scope: Any file, dengan batasan pada akses tulis sandbox yang diberikan oleh entri proyek dan lokal
• Type: array jalur direktori
• Default: tidak diatur
• Per-session overrides: --add-dir dan /add-dir menambahkan direktori untuk satu sesi bersama kunci ini

{
  "permissions": {
    "additionalDirectories": ["../docs/"]
  }
}

Seperti aturan allow, entri dalam .claude/settings.json proyek berlaku hanya setelah Anda menerima dialog kepercayaan workspace untuk folder itu.

permissions.blockReadsOutsideWorkingDirectories

Buat tool file Claude menolak pembacaan di luar direktori kerja Anda dalam setiap mode izin, termasuk bypassPermissions. Claude Code menolak panggilan Read, Grep, Glob, dan LSP pada jalur tersebut dan memberi tahu Claude untuk meminta Anda menambahkan direktori dengan /add-dir. File yang dibutuhkan Claude Code sendiri tetap dapat dibaca, seperti skill, plugin, aturan, agent, perintah Anda, dan file memori CLAUDE.md di bawah ~/.claude/. Memerlukan Claude Code v2.1.257 atau lebih baru.

Claude Code tidak menolak perintah shell dengan cara yang sama:

• Tindakan yang tidak disetujui otomatis oleh mode mana pun mencakup kapan perintah shell yang membaca jalur tersebut meminta konfirmasi Anda
• Perintah sandboxed di bawah blokir mencakup apa yang dapat dibaca perintah sandboxed

Perintah Bash yang tidak dapat dilacak oleh parser shell, seperti yang mengubah direktori lebih dari sekali atau menjalankan subshell, meminta konfirmasi Anda bahkan dalam auto mode dan mode bypassPermissions. Permintaan izin muncul bahkan ketika perintah tidak menamai jalur apa pun di luar direktori kerja. Permintaan izin ini tidak berlaku ketika perintah berjalan dalam sandbox dan sandbox memberlakukan blokir.

Claude Code juga menulis true di sini ketika Anda memilih untuk memblokir pembacaan tersebut pada permintaan izin auto mode sebelum pembacaan pertama di luar direktori kerja.

• Scope: Any file. true di file apa pun berlaku, jadi repositori dapat mengaktifkan blokir untuk dirinya sendiri tetapi tidak dapat mengangkat blokir Anda.
• Type: Boolean
  • true: tool file Claude menolak pembacaan di luar direktori kerja
  • false: sama dengan tidak diatur; blokir masih berlaku jika file lain menetapkan true
• Default: tidak diatur, jadi pembacaan di luar direktori kerja mengikuti mode izin Anda

{
  "permissions": {
    "blockReadsOutsideWorkingDirectories": true
  }
}

Untuk mengangkat blokir, hapus kunci dari setiap file pengaturan yang menetapkannya, kemudian mulai ulang setiap sesi yang sedang berjalan.

Direktori yang Anda tambahkan dengan --add-dir, /add-dir, atau additionalDirectories dalam pengaturan pengguna atau terkelola Anda dihitung sebagai direktori kerja untuk blokir. Direktori yang ditambahkan hanya dalam pengaturan repositori tidak dihitung: yang ada di .claude/settings.json, dan yang ada di .claude/settings.local.json kecuali git melaporkan file itu sebagai tidak dilacak. Dalam direktori yang bukan repositori git, atau ketika git melacak file tersebut, Claude Code memperlakukan .claude/settings.local.json sebagai pengaturan repositori, jadi letakkan direktori yang ingin tetap dapat dibaca dalam pengaturan pengguna Anda sebagai gantinya.

Ketika autoMemoryDirectory berasal dari .claude/settings.json proyek, atau dari .claude/settings.local.json yang diperlakukan sebagai disediakan repositori, Claude Code tidak memuat auto memory apa pun dari direktori itu dan tidak menyimpan apa pun ke dalamnya.

Perintah sandboxed di bawah blokir

Ketika sandboxing aktif, blokir juga mencakup perintah sandboxed. Claude Code menolak akses baca perintah tersebut ke direktori home Anda dan ke akar lain yang menyimpan file pengguna: /Users, /home, /root, /Volumes, /mnt, /media, /run/media, dan /srv. Kemudian Claude Code membuka kembali direktori kerja, worktree yang dibuat Claude Code dalam sesi, direktori temp sesi, dan bagian dari ~/.claude yang dibutuhkan perintah, seperti skill dan plugin. Saat blokir berlaku, entri allowRead dan allowWrite dari pengaturan repositori tidak dihitung.

Ketika direktori kerja sesi adalah git worktree yang ditautkan, termasuk yang dimasuki Claude Code di tengah sesi, direktori .git umum repositori tetap dapat dibaca dan ditulis oleh perintah sandboxed, sehingga git terus bekerja di sana.

Dalam kasus-kasus ini blokir tidak menjangkau perintah sandboxed, sementara tool file Claude terus memberlakukannya:

• Isolasi sistem file dimatikan melalui sandbox.filesystem.disabled
• allowManagedReadPathsOnly diatur
• Jalur direktori tempat Anda memulai Claude Code mengandung karakter glob seperti *, ?, atau [

Di bawah blokir, Claude Code membuka kembali file konfigurasi git global Anda untuk perintah sandboxed sehingga git tetap mempertahankan identitas dan pengaturan Anda:

• ~/.gitconfig
• File config, ignore, dan attributes di bawah $XDG_CONFIG_HOME/git, yang default ke ~/.config/git
• File yang dinamai konfigurasi git global Anda melalui [include], [includeIf], core.excludesFile, atau core.attributesFile

Claude Code menilai setiap file secara terpisah. Ketika file terletak di tempat perintah sandboxed dapat menulis, secara langsung atau melalui symlink, Claude Code tidak membuka kembali file yang dinamainya.

Di Linux dan WSL2, file konfigurasi yang merupakan symlink dapat tetap tidak dapat dibaca di jalurnya sendiri, dan git kemudian berjalan tanpanya. ~/.git-credentials dan $XDG_CONFIG_HOME/git/credentials tetap diblokir.

Jika file yang dibuka kembali menyimpan rahasia, seperti token http.extraHeader, tambahkan jalurnya ke sandbox.filesystem.denyRead. Entri denyRead yang mencakup file selalu diutamakan daripada pembukaan kembali ini.

permissions.blockWritesOutsideWorkingDirectories

Buat tool Write, Edit, dan NotebookEdit menolak jalur di luar direktori kerja Anda dalam setiap mode izin, termasuk bypassPermissions, kecuali beberapa file milik Claude Code sendiri. Kunci ini tidak membatasi perintah shell, tool MCP, atau program yang dijalankan hook. Untuk membatasi tempat perintah shell menulis, aktifkan sandboxing. Memerlukan Claude Code v2.1.314 atau lebih baru.

Setelah kunci ini aktif, Claude Code juga menghapus tool EnterWorktree dan ExitWorktree atau menolak panggilan ke tool tersebut. Untuk tetap bekerja di worktree, ikuti Claude tidak memiliki tool EnterWorktree.

• Scope: Any file. true di file apa pun yang dimuat sesi berlaku, jadi repositori dapat mengaktifkan blokir untuk dirinya sendiri tetapi tidak dapat mengangkat blokir Anda. Dalam sesi cloud, Claude Code mungkin tidak menerapkan kunci ini, karena tool file berjalan dalam kontainer yang merupakan batas itu sendiri.
• Type: Boolean
  • true: mengaktifkan blokir
  • false: sama dengan tidak diatur; blokir masih berlaku jika file lain menetapkan true
• Default: tidak diatur, jadi penulisan di luar direktori kerja mengikuti mode izin Anda. Blokir juga aktif selama Claude Code tidak dapat membaca objek permissions dalam pengaturan terkelola Anda.

{
  "permissions": {
    "blockWritesOutsideWorkingDirectories": true
  }
}

Untuk menguji blokir, minta Claude menggunakan tool Write untuk membuat file di luar direktori kerja Anda, seperti ~/block-test.txt jika direktori home Anda bukan salah satunya. Claude Code menolak panggilan tersebut, dan penolakannya menyatakan bahwa pengaturan memblokir penulisan di luar direktori kerja.

Untuk mengangkat blokir, hapus kunci dari setiap file pengaturan yang menetapkannya, kemudian mulai ulang Claude Code.

Apa yang ditolak blokir penulisan dan apa yang tetap dapat ditulis

Beberapa file milik Claude Code sendiri tetap dapat ditulis, seperti file rencana, scratchpad, direktori tmp milik sesi latar belakang, dan file .md dalam auto memory proyek ini.

Selain file Anda sendiri di luar direktori kerja, blokir menolak penulisan ke:

• File pengaturan Claude Code: Claude Code menolak penulisan ini di dalam direktori kerja juga, karena file pengaturan dapat mengangkat blokir. Edit file pengaturan sendiri.
• Direktori yang hanya ditambahkan oleh pengaturan repositori: direktori yang dicantumkan additionalDirectories hanya di .claude/settings.json, atau di .claude/settings.local.json kecuali git melaporkan file itu sebagai tidak dilacak
• Worktree milik subagent: pengeditan file oleh subagent isolation: worktree ditolak ketika worktree-nya berada di luar direktori kerja
• Auto memory di direktori yang dipilih repositori: direktori yang dinamai autoMemoryDirectory dalam pengaturan repositori

File pengaturan tetap ditolak apa pun yang Anda tambahkan. Untuk meloloskan penulisan dalam kasus-kasus lainnya, tambahkan direktori kerja. /add-dir memerlukan direktori yang sudah ada, jadi sebutkan direktori .claude/worktrees di root repositori untuk worktree subagent.

Loloskan satu direktori melalui blokir baca atau tulis

Untuk memungkinkan Claude menjangkau satu direktori di luar proyek saat blockReadsOutsideWorkingDirectories atau blockWritesOutsideWorkingDirectories bernilai true, tambahkan direktori tersebut sebagai direktori kerja. Jalankan /add-dir <directory> dalam sesi, berikan --add-dir <directory> saat Anda memulai Claude Code, atau cantumkan di bawah additionalDirectories dalam pengaturan pengguna atau terkelola Anda. Tidak ada aturan allow yang dapat meloloskan tool file Claude melalui kedua blokir tersebut.

permissions.defaultMode

Atur mode izin default untuk sesi baru. Ketika Anda membiarkannya tidak diatur, default bawaan untuk surface Anda berlaku.

• Scope: Any file. auto dan bypassPermissions tidak berlaku dari pengaturan proyek atau lokal, jadi atur keduanya dalam ~/.claude/settings.json sebagai gantinya. Sebelum v2.1.257, bypassPermissions berlaku dari file apa pun. Untuk percakapan yang dimulai ekstensi VS Code, Claude Code hanya membaca nilai pengguna, terkelola, dan --settings.
• Type: string, salah satu dari:
  • "default": Claude Code hanya menjalankan pembacaan tanpa bertanya
  • "acceptEdits": Claude Code juga menjalankan pengeditan file dan perintah sistem file umum seperti mkdir dan mv tanpa bertanya
  • "plan": Claude Code membaca dan merencanakan tetapi memblokir pengeditan sampai Anda menyetujui rencana
  • "auto": Claude Code berjalan tanpa permintaan izin sehari-hari; sebelum tindakan seperti perintah shell dan permintaan jaringan berjalan, pengklasifikasi latar belakang memeriksa bahwa tindakan tersebut selaras dengan permintaan Anda
  • "dontAsk": Claude Code secara otomatis menolak setiap panggilan yang sebaliknya akan meminta konfirmasi, meskipun mod yang Anda instal masih dapat menyetujui sebagian dari panggilan tersebut. Pembacaan file di dalam direktori kerja Anda, tindakan lain yang tidak memerlukan persetujuan, dan tool yang sudah disetujui sebelumnya masih berjalan, kecuali pembacaan dari jalur jaringan
  • "bypassPermissions": Claude Code menjalankan semuanya tanpa bertanya
  • "manual": alias untuk "default"
• Default: tidak diatur
• Per-session overrides: --permission-mode, dan ekuivalennya --dangerously-skip-permissions untuk bypassPermissions, diutamakan daripada kunci ini untuk satu sesi

{
  "permissions": {
    "defaultMode": "acceptEdits"
  }
}

Aturan izin berlapis di atas setiap mode: aturan deny memblokir dalam setiap mode, termasuk bypassPermissions. Lihat Mode izin. Dalam sesi cloud, Claude Code hanya menghormati acceptEdits, plan, default, dan auto dari kunci ini. Untuk percakapan yang dimulai ekstensi VS Code, lihat pengaturan mana yang dibaca ekstensi untuk mode izin awal.

permissions.denyInsteadOfPrompting

Atur ini ke true agar sesi tetap berjalan ketika tidak ada orang yang dapat menjawab permintaan izin. Claude Code menolak panggilan tool yang sebaliknya akan menunggu permintaan izin, dan giliran berlanjut. Memerlukan Claude Code v2.1.319 atau lebih baru.

Panggilan tetap dijalankan jika aturan allow, mode izin Anda, atau pengklasifikasi auto mode menyetujuinya. Untuk mengizinkan sebagian besar panggilan yang sebaliknya akan meminta konfirmasi, jawab dari hook PermissionRequest.

• Scope: User or managed, dan --settings. Repositori tidak dapat menetapkannya untuk Anda.
• Type: Boolean
  • true: Claude Code menolak panggilan yang sebaliknya akan meminta konfirmasi
  • false: sama dengan tidak diatur; panggilan tetap ditolak jika sumber lain di antara sumber ini menetapkan true
• Default: tidak diatur, jadi panggilan yang memerlukan persetujuan meminta konfirmasi Anda

Dalam ~/.claude/settings.json, contoh ini memulai sesi dalam auto mode dan menolak apa pun yang masih akan kembali ke permintaan izin:

{
  "permissions": {
    "defaultMode": "auto",
    "denyInsteadOfPrompting": true
  }
}

Kunci ini berlaku dalam eksekusi -p, sesi terminal interaktif, ekstensi VS Code, sesi lokal di aplikasi Desktop, subagent, dan tim agent. Untuk menolak apa yang akan meminta konfirmasi dalam satu eksekusi non-interaktif saja, berikan --permission-prompts none dengan -p.

Apa lagi yang dihentikan denyInsteadOfPrompting

Dengan pengaturan ini aktif, Claude Code juga menghentikan permintaan jawaban berikut:

• Tool pertanyaan dan rencana: Claude Code tidak menyertakan AskUserQuestion, EnterPlanMode, dan ExitPlanMode, sehingga sesi dalam plan mode tidak dapat keluar darinya dengan sendirinya. Rekan tim dalam tim agent tetap memiliki EnterPlanMode dan ExitPlanMode
• Elisitasi MCP: Claude Code membatalkan permintaan elisitasi kecuali hook Elicitation menjawabnya
• Host izin: Claude Code tidak bertanya kepada callback canUseTool atau --permission-prompt-tool Anda. Untuk menyetujui panggilan dari kode, jawab dari hook PermissionRequest. Beberapa panggilan ditolak sebelum hook mana pun ditanya, seperti penghapusan jalur kritis dalam mode auto yang tidak dicakup aturan ask mana pun.
• Pemberitahuan penagihan pengklasifikasi: di mana pemberitahuan tentang permintaan pengklasifikasi yang ditagih akan membuka dialog, Claude Code tidak menampilkannya dan menolak tindakan yang memerlukan permintaan tersebut

Sesi masih dapat menunggu dialog kepercayaan workspace dan persetujuan server MCP proyek. Jawab keduanya sebelum Anda membiarkan sesi berjalan.

Pesan dari denyInsteadOfPrompting

Pesan-pesan ini melaporkan panggilan yang ditolak. Pesan tersebut bukan permintaan izin, jadi tidak ada yang menunggu jawaban Anda.

Penolakan yang dibaca Claude dapat diawali dengan teks ini:

Permission for this tool use was denied. It requires approval, and this session has no approval surface

Dalam output stream-json, eksekusi yang memancarkan pesan permission_denied melaporkan decision_reason ini:

no approval surface in this session; permission request denied automatically

Dalam auto mode dengan pengaturan ini aktif, giliran berakhir setelah 20 panggilan berturut-turut yang diblokir pengklasifikasi atau ditolak pemeriksaan keamanan, dan Anda melihat pesan ini:

20 actions were refused and no work went ahead in between, so Claude stopped.

Eksekusi -p melaporkan giliran tersebut sebagai error_during_execution.

permissions.disableBypassPermissionsMode

Cegah siapa pun memasuki mode bypassPermissions. Claude Code kemudian menolak flag --dangerously-skip-permissions, dan mengabaikan permissionMode: bypassPermissions dalam definisi agent, sehingga subagent berjalan dengan mode izin sesi induk.

• Scope: Any file. Biasanya diatur dalam pengaturan terkelola untuk menegakkan kebijakan organisasi.
• Type: string "disable"
• Default: tidak diatur
• Per-session overrides: kunci ini diutamakan daripada --dangerously-skip-permissions, yang ditolak Claude Code saat kunci diatur

{
  "permissions": {
    "disableBypassPermissionsMode": "disable"
  }
}

Sebelum v2.1.223, Claude Code menerapkan mode izin frontmatter bahkan dengan bypass dinonaktifkan.

skipAutoPermissionPrompt

Lewati pemberitahuan satu kali yang menjelaskan auto mode yang ditampilkan Claude Code ketika Anda pertama kali memasuki auto mode sendiri, misalnya melalui pengaturan Anda sendiri atau pemilih mode, bukan ketika default bawaan memulai sesi di dalamnya. Claude Code menampilkan pemberitahuan itu sekali dan kemudian mencatat bahwa pemberitahuan itu sudah ditampilkan, jadi kunci ini hanya penting di tempat pemberitahuan belum muncul.

• Scope: User or managed. Repositori tidak dapat menetapkannya untuk Anda.
• Type: Boolean
  • true: Claude Code melewati pemberitahuan
  • false: sama dengan tidak diatur; pemberitahuan muncul sekali kecuali file lain di antara file ini menetapkan true
• Default: tidak diatur, jadi pemberitahuan muncul sekali

{
  "skipAutoPermissionPrompt": true
}

skipDangerousModePermissionPrompt

Lewati dialog konfirmasi yang ditampilkan Claude Code sebelum sesi memasuki mode bypassPermissions, baik dari --dangerously-skip-permissions atau dari defaultMode: "bypassPermissions". Claude Code menulis true di sini dalam pengaturan pengguna Anda ketika Anda menerima dialog itu sekali.

• Scope: User, local, or managed, dan file yang diberikan dengan --settings. Sesi latar belakang hanya menghitung pengaturan pengguna dan terkelola. Repositori yang tidak dipercaya tidak dapat melewati dialog untuk Anda.
• Type: Boolean
  • true: Claude Code melewati dialog konfirmasi sebelum sesi memasuki mode bypassPermissions
  • false: sama dengan tidak diatur; dialog muncul kecuali file lain di antara file ini menetapkan true
• Default: tidak diatur, jadi dialog muncul

{
  "skipDangerousModePermissionPrompt": true
}

Pengaturan sandbox

Isolasi perintah yang dijalankan Claude dari sistem file, jaringan, dan kredensial Anda. Untuk cara kerja sandboxing dan persyaratan platform, lihat Sandboxing.

sandbox

Isolasi perintah Bash yang dijalankan Claude dari sistem file dan jaringan Anda dengan sandboxing. Aktifkan sandbox dengan enabled, lalu persempit atau perluas apa yang dapat disentuh oleh perintah yang di-sandbox dengan sub-objek filesystem, network, dan credentials. Sandbox berjalan di macOS, Linux, dan WSL2.

• Cakupan: Any file
• Tipe: objek dengan enabled, failIfUnavailable, autoAllowBashIfSandboxed, excludedCommands, allowUnsandboxedCommands, enableWeakerNestedSandbox, enableWeakerNetworkIsolation, allowAppleEvents, allowNestedUserNamespaces, bwrapPath, socatPath, ignoreViolations, dan ripgrep, ditambah objek filesystem, network, dan credentials
• Default: tidak diatur, sehingga Claude Code menjalankan perintah tanpa sandbox

Ini mengaktifkan sandbox, melewati permintaan izin untuk perintah yang di-sandbox, menjalankan docker di luar sandbox, membuka dua path tulis tambahan, menyembunyikan file kredensial AWS Anda, dan mengizinkan GitHub serta npm terlebih dahulu:

{
  "sandbox": {
    "enabled": true,
    "autoAllowBashIfSandboxed": true,
    "excludedCommands": ["docker *"],
    "filesystem": {
      "allowWrite": ["/tmp/build", "~/.kube"],
      "denyRead": ["~/.aws/credentials"]
    },
    "network": {
      "allowedDomains": ["github.com", "*.npmjs.org"]
    }
  }
}

Ketika pengaturan terkelola mengatur kunci Boolean seperti enabled atau failIfUnavailable, nilai tersebut menimpa apa pun yang diatur oleh developer. Claude Code menggabungkan kunci array di seluruh cakupan pengaturan yang dimuat sesi, sehingga developer dapat menambahkan entri; lihat Mencegah developer memperluas kebijakan untuk penguncian yang khusus berasal dari pengaturan terkelola. Untuk mewajibkan sandbox bagi organisasi, lihat Menegakkan sandboxing dengan pengaturan terkelola.

sandbox.enabled

Aktifkan sandboxing untuk perintah Bash. Saat Anda memilih mode di panel /sandbox, Claude Code menulis kunci ini ke .claude/settings.local.json untuk proyek saat ini; atur di ~/.claude/settings.json untuk men-sandbox setiap proyek.

• Cakupan: Any file, dengan batasan pada pengaturan proyek dan lokal
• Tipe: Boolean
  • true: Claude Code men-sandbox perintah Bash
  • false: perintah Bash berjalan tanpa sandbox
• Default: false

{
  "sandbox": {
    "enabled": true
  }
}

Di Linux dan WSL2, sandbox memerlukan bubblewrap dan socat; lihat Menyiapkan Linux dan WSL2. Ketika sandbox tidak dapat dimulai, Claude Code menjalankan perintah tanpa sandbox, kecuali jika Anda juga mengatur failIfUnavailable.

sandbox.failIfUnavailable

Buat Claude Code keluar dengan error saat startup ketika sandbox.enabled bernilai true tetapi sandbox tidak dapat dimulai karena platform tidak mendukungnya atau pemeriksaan dependensi gagal. Tanpa kunci ini, Claude Code menjalankan perintah tanpa sandbox. Deployment terkelola yang mewajibkan sandboxing sebagai gerbang keamanan dapat menggunakan pengaturan ini.

Di platform yang tidak didukung sandbox, Claude Code tidak dapat dimulai saat kunci ini aktif. Lihat Menegakkan sandboxing dengan pengaturan terkelola.

• Cakupan: Any file, dengan batasan pada pengaturan proyek dan lokal
• Tipe: Boolean
  • true: Claude Code keluar dengan error saat startup ketika sandbox.enabled bernilai true tetapi sandbox tidak dapat dimulai. Jika sandbox lolos pemeriksaan tersebut lalu gagal diinisialisasi, sesi tetap berjalan dan Claude Code menolak setiap perintah yang di-sandbox
  • false: Claude Code menjalankan perintah tanpa sandbox ketika sandbox tidak dapat dimulai
• Default: false

Ini mengaktifkan sandbox untuk mesin terkelola dan mengatur failIfUnavailable ke true:

{
  "sandbox": {
    "enabled": true,
    "failIfUnavailable": true
  }
}

Lihat Menegakkan sandboxing dengan pengaturan terkelola.

sandbox.autoAllowBashIfSandboxed

Izinkan Claude Code menjalankan perintah Bash yang di-sandbox tanpa permintaan izin. Perintah yang tidak dapat berjalan di sandbox tetap melalui alur izin biasa, dan aturan deny serta aturan ask yang dibatasi pada konten seperti Bash(git push *) tetap berlaku; aturan ask Bash polos dilewati untuk perintah yang di-sandbox. Atur ke false untuk juga mengirim perintah yang di-sandbox melalui alur izin biasa, yang oleh tab Mode di /sandbox disebut mode izin reguler.

• Cakupan: Any file
• Tipe: Boolean
  • true: Claude Code menjalankan perintah Bash yang di-sandbox tanpa permintaan izin, kecuali dalam kasus yang dijelaskan di Mode auto-allow; CLAUDE_CODE_SUBPROCESS_ENV_SCRUB mematikan auto-allow
  • false: perintah yang di-sandbox melalui alur izin biasa, sehingga aturan allow dan mode izin Anda yang menentukan. Tab Mode di /sandbox menyebut ini mode izin reguler
• Default: true

Ini mempertahankan sandbox tetap aktif dan mengirim perintah yang di-sandbox melalui alur izin biasa:

{
  "sandbox": {
    "enabled": true,
    "autoAllowBashIfSandboxed": false
  }
}

Lihat Mode auto-allow untuk hal-hal yang masih memicu permintaan izin dalam mode auto-allow dan bagaimana perilakunya dalam plan mode.

sandbox.excludedCommands

Sebutkan perintah yang dijalankan Claude Code di luar sandbox, seperti alat yang tidak berfungsi di dalamnya. Setiap entri menggunakan sintaks yang sama dengan isi aturan izin Bash(...): perintah persis, prefiks seperti docker *, atau pola wildcard. Pola tanpa wildcard adalah pencocokan persis, sehingga docker hanya cocok dengan docker tanpa argumen.

Entri Anda mengeluarkan panggilan Bash dari sandbox hanya ketika entri tersebut mencakup setiap perintah di dalamnya, dan beberapa bentuk panggilan tetap di-sandbox bahkan dalam kondisi itu. Entri docker * saja tidak mengeluarkan npm ci && docker build . dari sandbox.

• Cakupan: Any file, dengan batasan pada pengaturan proyek dan lokal
• Tipe: array pola perintah
• Default: tidak diatur, sehingga tidak ada perintah yang dikecualikan

{
  "sandbox": {
    "excludedCommands": ["docker *"]
  }
}

Claude Code mempertahankan panggilan Bash tetap di-sandbox ketika panggilan tersebut memiliki salah satu bentuk berikut, di antara bentuk lainnya:

• Perintah yang diawali dengan sudo, eval, atau xargs
• cd, pushd, atau popd, di mana pun letaknya dalam panggilan
• Substitusi perintah, subshell, atau blok alur kontrol seperti if atau for
• Pengalihan (redirection), seperti docker build . > build.log atau heredoc <<EOF, selain yang hanya menduplikasi file descriptor, seperti yang dilakukan 2>&1
• Nama perintah yang berasal dari variabel
• git clone, git init, git worktree add, git worktree move, atau git bundle create dengan argumen path yang absolut, diawali dengan ~, atau berisi segmen ..

Sebagai contoh, cd build && docker compose up tetap di-sandbox di bawah entri docker *, dan menambahkan entri cd tidak mengubahnya. Di bawah entri git *, git clone <url> vendor/lib berjalan di luar sandbox, tetapi git clone <url> ~/tools tetap di-sandbox. Clone menulis seluruh pohon file, mungkin termasuk file yang dapat dieksekusi, ke mana pun path tujuannya mengarah.

Perintah yang dikecualikan tetap melalui alur izin biasa. Pengecualian adalah kemudahan, bukan batas keamanan: ketika sebuah alat hanya perlu menulis ke lokasi tertentu, filesystem.allowWrite mempertahankannya tetap di-sandbox.

Entri dari cakupan pengaturan yang dimuat sesi digabungkan menjadi satu daftar, kecuali jika sandbox diwajibkan admin. Selama sandbox diwajibkan admin, Claude Code mengabaikan entri di .claude/settings.json dan .claude/settings.local.json, sehingga repositori yang di-clone tidak dapat mengeluarkan perintah dari sandbox. Entri di pengaturan terkelola, --settings, dan ~/.claude/settings.json Anda tetap berlaku, dan tidak ada penguncian khusus pengaturan terkelola yang mencakup daftar ini.

sandbox.allowUnsandboxedCommands

Izinkan Claude mencoba ulang perintah di luar sandbox dengan parameter dangerouslyDisableSandbox setelah sandbox memblokirnya. Ketika bernilai false, Claude Code mengabaikan parameter tersebut. Selama sandbox berjalan, perintah yang dijalankan Claude kemudian di-sandbox kecuali jika cocok dengan entri excludedCommands. Tab Overrides di /sandbox menampilkan status tersebut sebagai Strict sandbox mode. Nilai false di pengaturan terkelola mengaktifkan strict sandbox mode untuk developer yang dicakupnya.

• Cakupan: Any file, dengan sebuah batasan pada pengaturan proyek dan lokal
• Tipe: Boolean
  • true: Claude dapat mencoba ulang perintah di luar sandbox dengan parameter dangerouslyDisableSandbox setelah sandbox memblokirnya
  • false: Claude Code mengabaikan parameter tersebut, sehingga selama sandbox berjalan, perintah yang dijalankan Claude di-sandbox kecuali jika cocok dengan entri excludedCommands
• Default: true

Ini menegakkan strict sandbox mode untuk semua orang yang dicakup oleh pengaturan terkelola:

{
  "sandbox": {
    "enabled": true,
    "allowUnsandboxedCommands": false
  }
}

Nilai false dari pengaturan terkelola atau --settings juga membuat sandbox diwajibkan admin. Nilai false di pengaturan pengguna Anda tetap bertahan terhadap nilai true dari proyek, tetapi tidak membuat sandbox diwajibkan admin. Bertahan terhadap nilai proyek memerlukan Claude Code v2.1.285 atau lebih baru.

Siapa yang menyetujui retry tanpa sandbox bergantung pada mode izin dan aturan allow Anda. Lihat Jalan keluar retry tanpa sandbox.

Untuk melihat kapan perintah yang Anda ketik sendiri di prompt shell mode ! berjalan di-sandbox, lihat strict sandbox mode.

sandbox.filesystem

Kontrol path mana yang dapat dibaca dan ditulis oleh perintah yang di-sandbox. Secara default, perintah tersebut dapat menulis ke direktori kerja, direktori temp per pengguna, dan direktori yang Anda tambahkan dengan --add-dir, /add-dir, atau permissions.additionalDirectories, serta dapat membaca bagian sistem file lainnya, termasuk file kredensial. Perluas atau persempit hal itu dengan empat daftar path, atau matikan lapisan sistem file dengan disabled. Lihat Isolasi sistem file untuk batas default.

• Cakupan: Any file
• Tipe: objek dengan array allowWrite, denyWrite, denyRead, dan allowRead, ditambah Boolean allowManagedReadPathsOnly dan disabled
• Default: tidak diatur, sehingga batas baca dan tulis default berlaku

Ini memungkinkan perintah yang di-sandbox menulis ke direktori build dan kubeconfig Anda, serta menyembunyikan file kredensial AWS Anda:

{
  "sandbox": {
    "filesystem": {
      "allowWrite": ["/tmp/build", "~/.kube"],
      "denyRead": ["~/.aws/credentials"]
    }
  }
}

Claude Code menegakkan daftar-daftar ini pada batas sandbox OS, sehingga daftar tersebut berlaku untuk setiap subproses yang dimulai oleh perintah yang di-sandbox, seperti kubectl, terraform, atau npm. Claude Code menambahkan aturan izin Anda ke daftar yang sama: aturan allow dan deny Edit ke allowWrite dan denyWrite, aturan deny Read ke denyRead, dan aturan allow dan deny WebFetch(domain:...) ke daftar domain network.

Kecuali jika suatu penguncian berlaku, Claude Code menggabungkan daftar-daftar ini di seluruh file pengaturan yang dimuat sesi. allowManagedReadPathsOnly membatasi allowRead hanya pada entri dari pengaturan terkelola, dan allowManagedDomainsOnly melakukan hal yang sama untuk domain yang diizinkan. Penguncian repositori mengecualikan entri dari file pengaturan repositori.

Mengonfigurasi sandboxing membahas sumber yang Anda kecualikan dengan --setting-sources. Saat Anda mengedit daftar selama sesi, Claude Code menerapkan perubahan tersebut pada sesi yang sedang berjalan.

Prefiks path sandbox

Path di allowWrite, denyWrite, denyRead, allowRead, dan credentials.files di-resolve berdasarkan prefiksnya:

Prefiks //path untuk path absolut juga berfungsi. Jika Anda menggunakan /path dengan satu garis miring dengan harapan resolusi relatif terhadap proyek, ganti ke ./path. Sintaks ini berbeda dari aturan izin Read dan Edit, yang menggunakan //path untuk path absolut dan /path untuk path relatif terhadap proyek: path sistem file sandbox menggunakan konvensi standar, sehingga /tmp/build adalah path absolut.

Claude Code menghapus garis miring di akhir path direktori, sehingga ~/.aws dan ~/.aws/ cocok dengan direktori yang sama. Sebelum v2.1.224, Claude Code meneruskan garis miring di akhir tersebut ke sandbox, dan Claude masih dapat membaca atau menulis path di bawah entri denyRead atau denyWrite yang ditulis dengan garis miring di akhir.

Tempat wildcard berfungsi di path sandbox

Wildcard *, ?, dan ** berfungsi di keempat daftar path sandbox.filesystem di macOS, dan di lebih sedikit tempat di Linux dan WSL2:

Di ~/keys/*.pem, wildcard muncul setelah nama direktori pertama, yaitu home untuk direktori home /home/alice:

~/keys/*.pem              the entry
/home/alice/keys/*.pem    its full path
 ^^^^                     the first directory name, home

Di Linux dan WSL2, tab Config dari /sandbox dalam sesi memperingatkan tentang aturan izin Edit yang berisi wildcard selain /** di akhir. Wildcard tersebut tidak berfungsi untuk perintah yang di-sandbox. Tambahkan setiap path yang seharusnya dicakup aturan tersebut, atau direktori yang menampungnya, ke allowWrite untuk aturan allow atau ke denyWrite untuk aturan deny.

Nama direktori dengan kurung siku, kurung kurawal, atau kurung biasa

Untuk mengizinkan atau memblokir direktori yang namanya berisi kurung siku, tulis nama tersebut apa adanya, seperti ./app/[slug]. Dalam entri tersebut, [slug] adalah nama asli direktori, termasuk kurung sikunya:

app/
└── [slug]/
    └── page.tsx

Entri tersebut mencakup semua yang ada di bawah direktori, jadi jangan tambahkan /** di akhir. Di macOS serta di Linux dan WSL2, direktori app/[slug] harus sudah ada saat perintah yang di-sandbox dimulai.

• Kurung siku seperti [slug]: di setiap daftar di macOS, serta di denyRead dan allowRead di Linux dan WSL2, kurung siku di ./app/[slug] juga merupakan pola. Entri tersebut kemudian juga cocok dengan path apa pun di bawah app yang namanya berupa satu karakter dari slug, seperti app/s atau app/g. Dengan entri tersebut di allowRead, atau di allowWrite di macOS, perintah yang di-sandbox juga dapat menjangkau path tersebut. Ganti nama path mana pun yang tidak seharusnya dijangkau.
• Kurung siku seperti [user-id] atau [post-id], di mana karakter di kiri tanda hubung diurutkan setelah karakter di kanannya: ./app/[user-id] hanya mencakup direktori dengan nama persis tersebut, di setiap daftar di setiap platform. Sebelum v2.1.304, perintah yang di-sandbox di Linux dan WSL2 gagal dimulai selama denyRead atau allowRead berisi entri seperti itu.
• Kurung kurawal dan kurung biasa: ini adalah karakter biasa, sehingga ~/data/{keys,tokens} mencakup satu direktori bernama {keys,tokens}, bukan dua alternatif. Untuk mencakup ~/data/keys dan ~/data/tokens, tambahkan masing-masing sebagai entri tersendiri.

sandbox.filesystem.allowWrite

Tambahkan path tempat perintah yang di-sandbox dapat menulis, di luar direktori kerja, direktori temp per pengguna, dan direktori yang telah Anda tambahkan dengan --add-dir, /add-dir, atau permissions.additionalDirectories. Gunakan ini ketika subproses seperti kubectl atau alat build perlu menulis di luar proyek.

• Cakupan: Any file, dengan batasan pada pengaturan proyek dan lokal
• Tipe: array string path, menggunakan prefiks path sandbox
• Default: tidak diatur, sehingga perintah yang di-sandbox dapat menulis ke direktori kerja, direktori temp per pengguna, direktori yang telah Anda tambahkan dengan --add-dir atau /add-dir, dan direktori di permissions.additionalDirectories

Ini memungkinkan build menulis di bawah /tmp/build dan memungkinkan kubectl memperbarui kubeconfig Anda:

{
  "sandbox": {
    "filesystem": {
      "allowWrite": ["/tmp/build", "~/.kube"]
    }
  }
}

Claude Code menggabungkan entri allowWrite dan path dari aturan allow Edit(...) Anda di seluruh cakupan pengaturan yang dimuat sesi, dengan mengecualikan yang berasal dari pengaturan repositori selama permissions.blockReadsOutsideWorkingDirectories aktif. Penguncian repositori juga dapat mengecualikan entri repositori. Entri allowWrite tidak dapat mencabut path yang dilindungi.

sandbox.filesystem.denyWrite

Blokir perintah yang di-sandbox agar tidak menulis ke path tertentu, termasuk path di dalam direktori yang sebenarnya dapat ditulis.

• Cakupan: Any file
• Tipe: array string path, menggunakan prefiks path sandbox
• Default: tidak diatur

Ini mencegah perintah yang di-sandbox mengubah konfigurasi sistem atau menginstal binary:

{
  "sandbox": {
    "filesystem": {
      "denyWrite": ["/etc", "/usr/local/bin"]
    }
  }
}

Claude Code menggabungkan entri di setiap cakupan pengaturan yang dimuat sesi, dan menambahkan path dari aturan deny Edit(...) Anda.

sandbox.filesystem.denyRead

Blokir perintah yang di-sandbox agar tidak membaca path tertentu, seperti file kredensial yang jika tidak diblokir akan terekspos oleh kebijakan baca default. Untuk melindungi file kredensial dan menjaganya tetap dapat digunakan melalui proxy sandbox, lihat sandbox.credentials sebagai gantinya.

• Cakupan: Any file
• Tipe: array string path, menggunakan prefiks path sandbox
• Default: tidak diatur, sehingga perintah yang di-sandbox tetap memiliki akses baca default, yang mencakup file kredensial seperti ~/.aws/credentials

{
  "sandbox": {
    "filesystem": {
      "denyRead": ["~/.aws/credentials"]
    }
  }
}

Claude Code menggabungkan entri di setiap cakupan pengaturan yang dimuat sesi, dan menambahkan path dari aturan deny Read(...) Anda. Ketika filesystem.disabled bernilai true, Claude Code tidak menegakkan entri ini.

sandbox.filesystem.allowRead

Buka kembali akses baca untuk path tertentu di dalam wilayah yang diblokir oleh denyRead, untuk membangun akses baca yang hanya mencakup workspace. Entri denyRead persis atau wildcard tetap diblokir di dalam allowRead yang lebih luas, seperti yang ditunjukkan oleh tabel tumpang tindih. Ketika entri denyRead wildcard seperti ~/**/.env cocok dengan sebuah direktori, Claude Code juga memblokir pembacaan isinya. Sebelum v2.1.236 di macOS, Claude Code membuka kembali path yang cocok dengan entri denyRead wildcard di mana pun entri allowRead yang lebih luas mencakupnya, dan membiarkan isi direktori yang cocok tetap dapat dibaca.

• Cakupan: Any file, dengan batasan pada pengaturan proyek dan lokal
• Tipe: array string path, menggunakan prefiks path sandbox
• Default: tidak diatur

Ini memblokir pembacaan direktori home Anda kecuali proyek itu sendiri:

{
  "sandbox": {
    "filesystem": {
      "denyRead": ["~/"],
      "allowRead": ["."]
    }
  }
}

Claude Code me-resolve entri . ke root proyek di pengaturan proyek dan ke ~/.claude di pengaturan pengguna. Claude Code menggabungkan entri di seluruh file pengaturan yang dimuat sesi, kecuali jika allowManagedReadPathsOnly diatur, dan mengecualikan entri dari pengaturan repositori selama permissions.blockReadsOutsideWorkingDirectories aktif. Penguncian repositori juga dapat mengecualikan entri repositori.

sandbox.filesystem.allowManagedReadPathsOnly

Hanya patuhi entri allowRead yang berasal dari pengaturan terkelola, sehingga developer tidak dapat membuka kembali akses baca ke path yang diblokir oleh organisasi Anda. Claude Code tetap menggabungkan entri denyRead dari setiap cakupan pengaturan yang dimuat sesi.

• Cakupan: Managed
• Tipe: Boolean
  • true: Claude Code hanya mematuhi entri allowRead dari pengaturan terkelola
  • false: entri allowRead dari file pengaturan lain dapat ikut digabungkan
• Default: false

Ini memblokir pembacaan direktori home, membuka kembali ~/work, dan mencegah developer membuka kembali hal lainnya:

{
  "sandbox": {
    "filesystem": {
      "denyRead": ["~/"],
      "allowRead": ["~/work"],
      "allowManagedReadPathsOnly": true
    }
  }
}

Lihat Mencegah developer memperluas kebijakan.

sandbox.filesystem.disabled

Lewati isolasi sistem file sambil tetap mempertahankan isolasi jaringan. Perintah yang di-sandbox mendapatkan akses baca dan tulis tanpa batas ke sistem file host, dan egress jaringannya tetap dibatasi pada network.allowedDomains. Gunakan ini ketika Anda men-sandbox untuk mengontrol ke mana perintah terhubung, bukan apa yang ditulisnya.

• Cakupan: User or managed. Ketika pengaturan terkelola mengonfigurasi sandbox.filesystem dalam bentuk apa pun, atau mencantumkan entri sandbox.credentials.files dengan "mode": "deny", hanya pengaturan terkelola yang dapat mengaturnya.
• Tipe: Boolean
  • true: Claude Code melewati isolasi sistem file dan mempertahankan isolasi jaringan
  • false: isolasi sistem file tetap aktif
• Default: false, sehingga isolasi sistem file tetap aktif

Ini membiarkan sistem file terbuka dan membatasi egress jaringan ke GitHub dan npm:

{
  "sandbox": {
    "enabled": true,
    "filesystem": {
      "disabled": true
    },
    "network": {
      "allowedDomains": ["github.com", "*.npmjs.org"]
    }
  }
}

Dengan lapisan ini dimatikan, Claude Code tidak menegakkan entri denyRead maupun entri deny di credentials.files, sementara entri credentials.envVars dan entri mask yang diterapkan tetap berfungsi. autoAllowBashIfSandboxed tetap bernilai default true, jadi atur ke false agar permintaan izin tetap muncul. Lihat Menonaktifkan isolasi sistem file untuk daftar lengkap sumber yang dapat mengaturnya dan apa yang berubah ketika isolasi dimatikan.

sandbox.ignoreViolations

Bungkam laporan pelanggaran sandbox untuk path yang Anda perkirakan akan diperiksa oleh sebuah perintah lalu ditolak, seperti alat yang memeriksa /etc/hosts saat startup, sehingga penolakan tersebut tidak muncul sebagai pelanggaran atau dalam apa yang dilihat Claude. Sandbox tetap memblokir akses tersebut; hanya laporannya yang disembunyikan. Kunci adalah substring untuk dicocokkan dengan perintah, dengan * mencocokkan setiap perintah, dan nilai adalah substring pelanggaran yang diabaikan untuk perintah tersebut, seperti path sistem file.

• Cakupan: Any file, dengan batasan pada pengaturan proyek dan lokal
• Tipe: objek yang memetakan substring perintah ke array substring pelanggaran, biasanya path
• Default: tidak diatur, sehingga setiap pelanggaran dilaporkan

{
  "sandbox": {
    "ignoreViolations": {
      "*": ["/etc/hosts"]
    }
  }
}

sandbox.enableWeakerNestedSandbox

Jalankan sandbox Linux di dalam container Docker tanpa hak istimewa, tempat bubblewrap tidak dapat me-mount /proc baru. Sebagai gantinya, sandbox bagian dalam melakukan bind-mount /proc yang sudah ada di container, yang mengekspos informasi proses yang akan disembunyikan oleh mount baru. Ini mengurangi keamanan; gunakan hanya ketika container luar sudah menyediakan isolasi yang Anda butuhkan.

• Cakupan: Any file, dengan batasan pada pengaturan proyek dan lokal
• Tipe: Boolean
  • true: sandbox bagian dalam melakukan bind-mount /proc yang sudah ada di container alih-alih me-mount yang baru
  • false: sandbox me-mount /proc baru, yang tidak berfungsi di container Docker tanpa hak istimewa
• Default: false

{
  "sandbox": {
    "enabled": true,
    "enableWeakerNestedSandbox": true
  }
}

Hanya Linux dan WSL2. Lihat Bubblewrap gagal dimulai di dalam container.

sandbox.enableWeakerNetworkIsolation

Izinkan perintah yang di-sandbox di macOS menjangkau layanan kepercayaan TLS sistem, com.apple.trustd.agent. Alat berbasis Go seperti gh, gcloud, dan terraform membutuhkannya untuk memverifikasi sertifikat TLS ketika Anda menggunakan network.httpProxyPort dengan proxy MITM dan CA kustom. Ini mengurangi keamanan dengan membuka potensi jalur eksfiltrasi data melalui layanan kepercayaan tersebut.

• Cakupan: Any file, dengan batasan pada pengaturan proyek dan lokal
• Tipe: Boolean
  • true: perintah yang di-sandbox di macOS dapat menjangkau com.apple.trustd.agent
  • false: perintah yang di-sandbox di macOS tidak dapat menjangkau layanan kepercayaan TLS sistem
• Default: false

{
  "sandbox": {
    "enabled": true,
    "enableWeakerNetworkIsolation": true
  }
}

Jika Anda tidak menggunakan proxy MITM, cantumkan alat yang gagal di excludedCommands sebagai gantinya; lihat CLI berbasis Go gagal dalam verifikasi TLS di macOS.

sandbox.allowAppleEvents

Izinkan perintah yang di-sandbox di macOS mengirim Apple Events, yang dibutuhkan oleh open, osascript, dan alat yang membuka URL di browser; tanpanya, perintah tersebut gagal dengan error -600. Ini menghapus isolasi eksekusi kode: perintah yang di-sandbox dapat meluncurkan aplikasi lain tanpa sandbox tanpa meminta pengguna, dan dapat mengirim perintah AppleScript ke aplikasi yang sedang berjalan seperti Terminal, dengan tunduk pada prompt persetujuan otomatisasi macOS per aplikasi (TCC).

• Cakupan: User or managed
• Tipe: Boolean
  • true: perintah yang di-sandbox di macOS dapat mengirim Apple Events
  • false: perintah yang di-sandbox di macOS tidak dapat mengirim Apple Events, sehingga open dan osascript gagal dengan error -600
• Default: false

{
  "sandbox": {
    "enabled": true,
    "allowAppleEvents": true
  }
}

Untuk mempertahankan isolasi dan tetap menjalankan salah satu alat tersebut, tambahkan alat itu ke excludedCommands sebagai gantinya. Lihat Apple Events di macOS.

sandbox.allowNestedUserNamespaces

Izinkan perintah yang di-sandbox di Linux dan WSL2 membuat user namespace, yang dibutuhkan oleh sandbox milik Chromium dan Electron sendiri, bubblewrap bersarang, dan unshare. Jika Anda mengatur kunci ini ke true, Anda mematikan sebuah batas keamanan: kode dari perintah yang di-sandbox dapat berakhir berjalan di luar sandbox. Untuk Podman atau Buildah rootless, gunakan excludedCommands sebagai gantinya, karena sandbox juga menghentikannya dengan cara lain. Memerlukan Claude Code v2.1.305 atau lebih baru.

• Cakupan: User or managed. Nilai true berlaku jika berasal dari ~/.claude/settings.json, JSON yang diteruskan dengan --settings, atau pengaturan terkelola. Claude Code mengabaikan true di .claude/settings.json atau .claude/settings.local.json milik proyek. Dalam sesi dengan CLAUDE_CODE_SUBPROCESS_ENV_SCRUB diatur ke 1, Claude Code mengabaikan true dari setiap sumber. Nilai false berlaku dari file mana pun, sesuai prioritas pengaturan.
• Tipe: Boolean
  • true: perintah yang di-sandbox dapat membuat user namespace
  • false: kunci ini tidak mengizinkan hal tambahan apa pun, dan default sandbox berlaku
• Default: false

{
  "sandbox": {
    "enabled": true,
    "allowNestedUserNamespaces": true
  }
}

Dengan kunci ini aktif, jangan mengandalkan pembatasan sandbox apa pun, termasuk path yang dilindungi dan entri credentials.files, untuk menghentikan perintah berbahaya. Dalam mode auto-allow, perintah tersebut dapat berjalan tanpa permintaan izin. Jika organisasi Anda memiliki tim keamanan, konsultasikan dengan mereka sebelum Anda mengaktifkan kunci ini.

Untuk menemukan perbaikan bagi alat Anda, lihat Chromium atau Podman rootless gagal di dalam sandbox di Linux.

sandbox.ripgrep

Arahkan sandbox ke binary ripgrep milik Anda sendiri alih-alih yang digunakan Claude Code, misalnya ketika platform Anda memerlukan rg yang di-build secara berbeda.

• Cakupan: User or managed
• Tipe: objek dengan command, yaitu path ke binary ripgrep, dan args opsional, yaitu array argumen yang ditambahkan di depan
• Default: tidak diatur, sehingga sandbox menggunakan binary ripgrep yang sama dengan Claude Code. Itu adalah binary bawaan kecuali jika Anda mengatur USE_BUILTIN_RIPGREP ke 0

{
  "sandbox": {
    "ripgrep": {
      "command": "/usr/local/bin/rg"
    }
  }
}

sandbox.bwrapPath

Arahkan sandbox ke binary bubblewrap yang diinstal di luar PATH, seperti salinan vendored di host air-gapped. Claude Code menggunakan path tersebut baik untuk pemeriksaan dependensi saat startup maupun saat membungkus setiap perintah yang di-sandbox.

• Cakupan: Managed. Claude Code hanya membacanya dari pengaturan terkelola agar file pengguna, proyek, atau lokal tidak dapat mengarahkan sandbox ke binary lain.
• Tipe: string, path absolut; Claude Code membuang path relatif dan kembali ke pencarian PATH
• Default: tidak diatur, sehingga Claude Code mencari bwrap di PATH

{
  "sandbox": {
    "enabled": true,
    "bwrapPath": "/opt/admin/bwrap"
  }
}

Hanya Linux dan WSL2.

sandbox.socatPath

Arahkan proxy jaringan sandbox ke binary socat yang diinstal di luar PATH.

• Cakupan: Managed
• Tipe: string, path absolut; Claude Code membuang path relatif dan kembali ke pencarian PATH
• Default: tidak diatur, sehingga Claude Code mencari socat di PATH

{
  "sandbox": {
    "enabled": true,
    "socatPath": "/opt/admin/socat"
  }
}

Hanya Linux dan WSL2.

sandbox.credentials

Deklarasikan file kredensial dan environment variable yang akan dilindungi dari perintah yang di-sandbox. Setiap entri menyebutkan path file atau name variabel dan sebuah mode: deny menyembunyikan kredensial di dalam sandbox, dan mask menampilkan placeholder kepada perintah yang di-sandbox sementara proxy sandbox menyisipkan nilai asli pada permintaan keluar. Claude Code hanya melindungi entri yang Anda cantumkan; tidak ada daftar deny kredensial bawaan.

• Cakupan: Any file. Claude Code hanya mematuhi entri mask, allowPlaintextInject, awsPairs, dan sigv4 dari pengaturan pengguna, pengaturan terkelola, dan flag --settings.
• Tipe: objek dengan files, envVars, allowPlaintextInject, awsPairs, dan sigv4
• Default: tidak diatur, sehingga tidak ada kredensial yang dilindungi

Ini menyembunyikan file kredensial AWS Anda dan menghapus GITHUB_TOKEN dari perintah yang di-sandbox:

{
  "sandbox": {
    "credentials": {
      "files": [{ "path": "~/.aws/credentials", "mode": "deny" }],
      "envVars": [{ "name": "GITHUB_TOKEN", "mode": "deny" }]
    }
  }
}

Perlindungan file deny adalah bagian dari lapisan sistem file, sehingga tidak berlaku ketika Anda menonaktifkan isolasi sistem file; perlindungan environment variable tetap berlaku.

Entri kredensial yang tidak valid di pengaturan terkelola

Ketika entri sandbox.credentials terkelola gagal validasi, Claude Code tetap melindungi kredensial sebisa mungkin:

• Entri di files atau envVars yang masih memiliki path atau name yang valid dan mode berupa mask atau deny, seperti entri yang pola extract-nya tidak memiliki capturing group, diturunkan menjadi mode: "deny" dengan peringatan, sehingga kredensial tetap diblokir, bukan di-mask, sampai Anda memperbaiki entri tersebut. Entri files yang diturunkan mengunci filesystem.disabled seperti entri deny eksplisit, dan peringatannya mencatat bahwa blokir bacanya tidak ditegakkan jika pengaturan terkelola mematikan isolasi sistem file.
• Entri dengan mode yang tidak dikenal atau path atau name yang tidak valid dihapus.
• Setiap kasus memunculkan peringatan; baik entri diturunkan maupun dihapus, entri valid lainnya tetap ditegakkan.

Berlaku di v2.1.191 dan yang lebih baru; sebelum v2.1.221, setiap entri yang tidak valid dihapus. Untuk kunci terkelola lain dengan penanganan per bidang, lihat Entri tidak valid di pengaturan terkelola.

sandbox.credentials.files

Lindungi file atau direktori kredensial dari perintah yang di-sandbox. Dengan "mode": "deny", Claude Code memblokir pembacaan path di dalam sandbox, blokir baca yang sama seperti sandbox.filesystem.denyRead. Dengan "mode": "mask", perintah yang di-sandbox di Linux dan WSL2 membaca salinan sentinel dari file tersebut, dan proxy sandbox menyisipkan nilai asli pada permintaan keluar ke injectHosts milik entri tersebut; di macOS, file tersebut justru tidak dapat dibaca di dalam sandbox. "mode": "mask" memerlukan Claude Code v2.1.221 atau lebih baru.

• Cakupan: Any file. Claude Code membuang entri mask dari .claude/settings.json proyek dan .claude/settings.local.json lokal.
• Tipe: array objek, masing-masing dengan path dan mode berupa "deny" atau "mask", ditambah bidang mask untuk file yang opsional
• Default: tidak diatur, sehingga tidak ada file kredensial yang dilindungi

Ini menyembunyikan file kredensial AWS Anda dan me-mask file hosts gh, dengan menyisipkan nilai asli hanya pada permintaan ke api.github.com:

{
  "sandbox": {
    "credentials": {
      "files": [
        { "path": "~/.aws/credentials", "mode": "deny" },
        { "path": "~/.config/gh/hosts.yml", "mode": "mask", "injectHosts": ["api.github.com"] }
      ]
    }
  }
}

Path menggunakan prefiks yang sama dengan pengaturan sandbox.filesystem.*, dan Claude Code menggabungkan array dari setiap cakupan pengaturan yang dimuat sesi. Melindungi kredensial membahas apa yang tetap berlaku dari sumber yang Anda kecualikan dengan --setting-sources. Entri mask memerlukan Claude Code v2.1.221 atau lebih baru.

Substitusi mask hanya berjalan melalui proxy sandbox, jadi atur sandbox.network.tlsTerminate, atau allowPlaintextInject untuk jaringan pengujian HTTP biasa. mask berlaku untuk satu file, jadi cantumkan setiap file kredensial secara terpisah. Claude Code menerima tetapi mengabaikan bidang mask pada entri deny. Me-mask kredensial membahas sumber pengaturan mana yang dipatuhi, dan Me-mask file kredensial membahas kapan sebuah entri kembali menjadi deny.

Bidang mask untuk file

Entri mask menerima bidang opsional berikut. Tanpa extract atau decode, Claude Code mengganti seluruh isi file dengan satu sentinel. Di macOS dengan isolasi sistem file aktif, Claude Code menerapkan entri mask sebagai deny sebelum extract atau decode dijalankan; lihat Me-mask file kredensial.

Ini hanya me-mask nilai oauth_token di file hosts gh, mengganti setiap salinan lain nilai tersebut di file, membuat file tidak dapat dibaca jika pola tidak cocok dengan apa pun, dan menyisipkan token asli hanya pada permintaan ke api.github.com:

{
  "sandbox": {
    "credentials": {
      "files": [
        {
          "path": "~/.config/gh/hosts.yml",
          "mode": "mask",
          "extract": "oauth_token:\\s*(\\S+)",
          "maskDuplicates": true,
          "onExtractNoMatch": "deny",
          "injectHosts": ["api.github.com"]
        }
      ]
    }
  }
}

sandbox.credentials.envVars

Lindungi environment variable dari perintah yang di-sandbox. Dengan "mode": "deny", Claude Code menghapus variabel dari environment perintah yang di-sandbox. Dengan "mode": "mask", perintah yang di-sandbox melihat nilai sentinel per sesi, dan proxy sandbox menyisipkan nilai asli pada permintaan keluar ke injectHosts milik entri tersebut, sehingga alat seperti gh dan npm tetap dapat melakukan autentikasi tanpa pernah memegang kredensial asli.

• Cakupan: Any file. Claude Code membuang entri mask dari .claude/settings.json proyek dan .claude/settings.local.json lokal.
• Tipe: array objek, masing-masing dengan name dan mode berupa "deny" atau "mask", ditambah bidang mask untuk environment variable yang opsional
• Default: tidak diatur, sehingga tidak ada environment variable yang dilindungi

Ini menghapus NPM_TOKEN dari perintah yang di-sandbox dan me-mask GITHUB_TOKEN, dengan menyisipkan nilai asli hanya pada permintaan ke api.github.com:

{
  "sandbox": {
    "credentials": {
      "envVars": [
        { "name": "NPM_TOKEN", "mode": "deny" },
        { "name": "GITHUB_TOKEN", "mode": "mask", "injectHosts": ["api.github.com"] }
      ]
    }
  }
}

name harus diawali dengan huruf atau garis bawah dan hanya berisi huruf, angka, dan garis bawah. Claude Code menggabungkan array dari setiap cakupan pengaturan yang dimuat sesi, dan menerapkan deny ketika variabel yang sama muncul dengan kedua mode. Melindungi kredensial membahas apa yang tetap berlaku dari sumber yang Anda kecualikan dengan --setting-sources.

Substitusi mask hanya berjalan melalui proxy sandbox, jadi atur sandbox.network.tlsTerminate, atau allowPlaintextInject untuk jaringan pengujian HTTP biasa; lihat Me-mask kredensial. Claude Code menerima tetapi mengabaikan bidang mask pada entri deny.

Bidang mask untuk environment variable

Entri mask menerima bidang opsional berikut. Tanpa extract atau decode, Claude Code mengganti seluruh nilai dengan satu sentinel. extract dan decode tidak dapat digabungkan pada entri yang sama.

Ini hanya me-mask kata sandi di dalam DATABASE_URL, menghapus variabel tersebut jika pola tidak cocok dengan apa pun, dan me-mask JWT di SERVICE_JWT sambil membiarkan setiap claim kecuali api_key tetap dapat dibaca:

{
  "sandbox": {
    "credentials": {
      "envVars": [
        {
          "name": "DATABASE_URL",
          "mode": "mask",
          "extract": "://[^:]+:([^@]+)@",
          "onExtractNoMatch": "deny"
        },
        {
          "name": "SERVICE_JWT",
          "mode": "mask",
          "decode": "jwt",
          "maskClaims": ["api_key"]
        }
      ]
    }
  }
}

sandbox.credentials.allowPlaintextInject

Izinkan substitusi mask pada permintaan HTTP biasa selain pada HTTPS yang di-terminate TLS. Pada HTTP biasa, identitas upstream tidak diverifikasi dan kredensial dikirim dalam cleartext, jadi biarkan ini nonaktif di luar jaringan pengujian tepercaya.

• Cakupan: User or managed
• Tipe: Boolean
  • true: Claude Code mengizinkan substitusi mask pada permintaan HTTP biasa selain pada HTTPS yang di-terminate TLS
  • false: Claude Code hanya mengizinkan substitusi mask pada HTTPS yang di-terminate TLS
• Default: false

{
  "sandbox": {
    "credentials": {
      "allowPlaintextInject": true
    }
  }
}

sandbox.credentials.awsPairs

Kelompokkan environment variable yang di-mask yang membentuk satu kredensial AWS untuk penandatanganan ulang SigV4 ketika kredensial Anda berada di variabel dengan nama non-standar. Claude Code menautkan trio konvensional AWS_ACCESS_KEY_ID, AWS_SECRET_ACCESS_KEY, dan AWS_SESSION_TOKEN secara otomatis ketika Anda me-mask seluruh nilainya, sehingga Anda hanya memerlukan kunci ini untuk nama lain. Memerlukan Claude Code v2.1.224 atau lebih baru.

• Cakupan: User or managed
• Tipe: array objek, masing-masing dengan accessKeyIdVar, secretAccessKeyVar, dan opsional sessionTokenVar, yang menyebutkan entri sandbox.credentials.envVars
• Default: tidak diatur, sehingga hanya trio konvensional yang dipasangkan

Ini menautkan tiga variabel dengan nama kustom menjadi satu kredensial AWS untuk penandatanganan ulang:

{
  "sandbox": {
    "credentials": {
      "awsPairs": [
        {
          "accessKeyIdVar": "MY_KEY_ID",
          "secretAccessKeyVar": "MY_SECRET_KEY",
          "sessionTokenVar": "MY_SESSION_TOKEN"
        }
      ]
    }
  }
}

Setiap variabel yang disebutkan harus berupa entri mask seluruh nilai di sandbox.credentials.envVars, tanpa extract atau decode, dan hanya dapat mengisi satu slot di seluruh pasangan. Aturan berikut juga berlaku:

• Proxy menandatangani ulang permintaan pada host yang tercantum di injectHosts milik entri access key ID
• Ketika sessionTokenVar diatur, proxy mengirim token asli sebagai x-amz-security-token pada permintaan yang ditandatangani ulang
• Menyebutkan salah satu variabel konvensional dalam sebuah pasangan menggantikan pemasangan otomatis

sandbox.credentials.sigv4

Pilih apa yang dilakukan proxy sandbox terhadap bentuk permintaan AWS yang tidak dapat ditandatangani ulang: streaming untuk upload streaming aws-chunked, presigned untuk URL presigned, dan sigv4a untuk tanda tangan asimetris SigV4A. Ini hanya berlaku untuk permintaan yang ditandatangani dengan access key ID placeholder dari pasangan yang di-mask. Memerlukan Claude Code v2.1.224 atau lebih baru.

• Cakupan: User or managed
• Tipe: objek dengan streaming, presigned, dan sigv4a, masing-masing salah satu dari:
  • "deny": proxy menggagalkan permintaan
  • "passthrough": proxy meneruskan permintaan yang ditandatangani dengan placeholder yang di-mask, sehingga alat menerima penolakan dari AWS sendiri
• Default: tidak diatur, sehingga setiap bentuk bernilai "deny"

Ini meneruskan upload streaming alih-alih menggagalkannya di proxy:

{
  "sandbox": {
    "credentials": {
      "sigv4": {
        "streaming": "passthrough"
      }
    }
  }
}

Dengan deny, proxy menggagalkan permintaan. Dengan passthrough, proxy meneruskan permintaan dengan tanda tangan yang dihitung dari placeholder yang di-mask, sehingga AWS menolaknya dan alat pemanggil menerima respons AWS sendiri alih-alih error proxy.

sandbox.network

Kontrol host, port, dan socket mana yang dapat dijangkau oleh perintah yang di-sandbox. Sandbox merutekan lalu lintas keluar melalui proxy yang menegakkan daftar-daftar ini; lihat Isolasi jaringan untuk cara proxy memutuskan dan kapan ia meminta persetujuan.

• Cakupan: Any file. strictAllowlist, allowManagedDomainsOnly, dan tlsTerminate dibaca dari lebih sedikit sumber, seperti yang dijelaskan di entrinya masing-masing.
• Tipe: objek dengan sub-kunci di bawah
• Default: tidak diatur, sehingga tidak ada domain yang diizinkan terlebih dahulu dan mode izin Anda menentukan apa yang terjadi pada setiap host baru

Ini mengizinkan GitHub dan npm terlebih dahulu, memblokir uploads.github.com, dan memungkinkan perintah melakukan bind ke localhost:

{
  "sandbox": {
    "network": {
      "allowedDomains": ["github.com", "*.npmjs.org"],
      "deniedDomains": ["uploads.github.com"],
      "allowLocalBinding": true
    }
  }
}

Claude Code menggabungkan sub-kunci array di seluruh cakupan pengaturan, sehingga proyek dapat menambahkan domain ke daftar pengguna Anda, kecuali jika penguncian repositori berlaku. Aturan izin allow dan deny WebFetch(domain:...) mengisi daftar allow dan deny yang sama.

sandbox.network.allowUnixSockets

Cantumkan path socket Unix yang dapat dihubungkan oleh perintah yang di-sandbox di macOS. Claude Code mengabaikan daftar ini di Linux dan WSL2, tempat filter seccomp tidak dapat memeriksa path socket; gunakan allowAllUnixSockets di sana sebagai gantinya.

• Cakupan: Any file, dengan batasan pada pengaturan proyek dan lokal
• Tipe: array string, masing-masing berupa path socket
• Default: tidak diatur, sehingga sandbox macOS memblokir setiap socket Unix

{
  "sandbox": {
    "network": {
      "allowUnixSockets": ["~/.ssh/agent-socket"]
    }
  }
}

Path socket dapat memberikan akses yang luas: mengizinkan /var/run/docker.sock, misalnya, memungkinkan perintah yang di-sandbox mengontrol daemon Docker. Lihat Keterbatasan keamanan.

sandbox.network.allowAllUnixSockets

Izinkan perintah yang di-sandbox terhubung ke setiap socket Unix. Di Linux dan WSL2, filter seccomp milik sandbox memblokir panggilan socket(AF_UNIX, ...), sehingga ini adalah satu-satunya cara untuk mengizinkan socket Unix di sana. Ketika filter tersebut tidak ada, yang dilaporkan oleh /sandbox di tab Dependencies-nya, sandbox tidak memblokir panggilan socket Unix. Lihat Menyiapkan Linux dan WSL2 untuk asal filter tersebut.

• Cakupan: Any file, dengan batasan pada pengaturan proyek dan lokal
• Tipe: Boolean
  • true: perintah yang di-sandbox dapat terhubung ke setiap socket Unix. Di Linux dan WSL2, perintah tersebut juga dapat terhubung ke socket VM, yaitu keluarga alamat AF_VSOCK
  • false: sandbox memblokir koneksi socket Unix: di macOS kecuali path di allowUnixSockets, dan di Linux dan WSL2 melalui filter seccomp jika filter tersebut ada
• Default: false

{
  "sandbox": {
    "network": {
      "allowAllUnixSockets": true
    }
  }
}

Di WSL2, true juga membuka kembali socket interop yang meluncurkan binary Windows seperti cmd.exe dan powershell.exe.

sandbox.network.allowLocalBinding

Izinkan perintah yang di-sandbox di macOS mendengarkan port jaringan, misalnya untuk memulai server dev, dan terhubung ke port mana pun di localhost. Perintah yang mendengarkan pada alamat non-loopback menerima koneksi dari mesin lain. Kunci ini tidak berpengaruh di Linux dan WSL2, tempat setiap perintah yang di-sandbox memiliki antarmuka loopback sendiri. Untuk menjangkau server di host dari Linux atau WSL2, lihat Perintah gagal menjangkau server di localhost.

• Cakupan: Any file, dengan batasan pada pengaturan proyek dan lokal
• Tipe: Boolean
  • true: perintah yang di-sandbox di macOS dapat mendengarkan pada alamat lokal mana pun dan terhubung ke port mana pun di localhost
  • false: perintah yang di-sandbox di macOS tidak dapat mendengarkan port atau terhubung langsung ke server di localhost
• Default: false

{
  "sandbox": {
    "network": {
      "allowLocalBinding": true
    }
  }
}

sandbox.network.allowMachLookup

Cantumkan nama layanan XPC dan Mach tambahan yang boleh dicari oleh sandbox macOS. Alat yang berkomunikasi melalui XPC, seperti iOS Simulator atau Playwright, memerlukan layanannya dicantumkan di sini. Perintah yang di-sandbox dapat menjangkau ke luar sandbox ke setiap layanan yang Anda cantumkan, dan sandbox tidak membatasi apa yang dilakukan layanan tersebut untuk perintah-perintah itu.

• Cakupan: Any file, dengan batasan pada pengaturan proyek dan lokal
• Tipe: array string, masing-masing berupa nama layanan; satu * di akhir mencocokkan prefiks, dan "*" saja mencocokkan setiap layanan
• Default: tidak diatur

Ini mengizinkan setiap layanan di bawah prefiks com.apple.CoreSimulator.:

{
  "sandbox": {
    "network": {
      "allowMachLookup": ["com.apple.CoreSimulator.*"]
    }
  }
}

sandbox.network.allowedDomains

Izinkan domain terlebih dahulu untuk lalu lintas keluar dari perintah yang di-sandbox, sehingga sandbox tidak meminta persetujuan untuk domain tersebut. Wildcard seperti *.example.com mencocokkan subdomain, dan akhiran :port opsional membatasi entri ke satu port; entri tanpa port mencocokkan setiap port.

• Cakupan: Any file, dengan batasan pada pengaturan proyek dan lokal. Hanya pengaturan terkelola ketika allowManagedDomainsOnly diatur.
• Tipe: array string, masing-masing berupa domain, pola wildcard, atau literal IP, dengan akhiran :port opsional
• Default: tidak diatur, sehingga mode izin Anda menentukan apa yang terjadi pada setiap host baru

Ini mengizinkan terlebih dahulu GitHub di setiap port, setiap subdomain npm, dan satu host API hanya di port 443:

{
  "sandbox": {
    "network": {
      "allowedDomains": ["github.com", "*.npmjs.org", "api.example.com:443"]
    }
  }
}

Tulis literal IPv6 dalam kurung siku, dengan port opsional: "[::1]" mengizinkan setiap port dan "[::1]:443" satu port. Bentuk berkurung siku memerlukan Claude Code v2.1.229 atau lebih baru. Lihat Alamat IPv6 di daftar domain.

sandbox.network.deniedDomains

Blokir domain untuk lalu lintas keluar dari perintah yang di-sandbox, menggunakan sintaks wildcard, port, dan IPv6 yang sama seperti allowedDomains. Domain yang ditolak tetap diblokir bahkan ketika entri allowedDomains juga mencocokkannya.

• Cakupan: Any file
• Tipe: array string, masing-masing berupa domain, pola wildcard, atau literal IP, dengan akhiran :port opsional
• Default: tidak diatur

{
  "sandbox": {
    "network": {
      "deniedDomains": ["sensitive.cloud.example.com"]
    }
  }
}

Claude Code menggabungkan daftar ini dari setiap sumber pengaturan yang dimuat sesi bahkan ketika allowManagedDomainsOnly diatur, sehingga developer selalu dapat memperketat daftar deny. Untuk literal IPv6, lihat Alamat IPv6 di daftar domain.

Entri yang ditulis dengan titik di akhir yang menandai nama domain yang sepenuhnya memenuhi syarat, seperti example.com., memblokir koneksi yang sama dengan example.com.

sandbox.network.strictAllowlist

Tolak akses perintah yang di-sandbox ke host di luar allowlist alih-alih meminta persetujuan. Allowlist tersebut adalah allowedDomains ditambah domain dari aturan allow WebFetch(domain:...), atau hanya entri pengaturan terkelola ketika allowManagedDomainsOnly diatur. Penguncian yang berlaku tanpa sandbox yang diwajibkan admin membahas entri repositori. Memerlukan Claude Code v2.1.219 atau lebih baru.

• Cakupan: User or managed. Repositori tidak dapat mengaktifkan atau menonaktifkannya.
• Tipe: Boolean
  • true: Claude Code menolak akses perintah yang di-sandbox ke host di luar allowlist
  • false: kecuali jika file pengaturan tepercaya lain mengatur true, Claude Code memutuskan host di luar allowlist berdasarkan mode izin alih-alih langsung menolaknya: dalam auto mode, Claude Code memeriksa host terhadap domain yang diizinkan per perintah milik perintah tersebut, dalam mode dontAsk Claude Code menolak, dalam mode bypassPermissions dan dalam sesi plan mode terminal interaktif tempat bypass tersedia Claude Code mengizinkan, dan selain itu Claude Code bertanya kepada Anda
• Default: false

{
  "sandbox": {
    "network": {
      "strictAllowlist": true
    }
  }
}

Claude Code menegakkan ini hanya untuk perintah yang di-sandbox; tool dalam proses seperti WebFetch tetap mengikuti aturan izin-nya. Ketika salah satu sumber yang dipatuhi mengaturnya ke true, pengaturan ini tetap aktif. Lihat Isolasi jaringan. Memerlukan Claude Code v2.1.219 atau lebih baru.

sandbox.network.allowManagedDomainsOnly

Mengunci allowlist jaringan pada apa yang didefinisikan oleh pengaturan terkelola. Claude Code kemudian hanya mematuhi allowedDomains dan aturan allow WebFetch(domain:...) dari pengaturan terkelola, mengabaikan domain dari pengaturan pengguna, proyek, lokal, dan --settings, serta memblokir domain yang tidak diizinkan secara otomatis alih-alih meminta izin.

• Cakupan: Managed
• Tipe: Boolean
  • true: Claude Code hanya mematuhi allowedDomains dan aturan allow WebFetch(domain:...) dari pengaturan terkelola serta memblokir domain yang tidak diizinkan alih-alih meminta izin
  • false: domain dari file pengaturan lain dapat digabungkan ke dalam allowlist
• Default: false

Contoh ini mengunci allowlist pada GitHub dan npm serta mengabaikan domain apa pun yang ditambahkan oleh developer:

{
  "sandbox": {
    "network": {
      "allowManagedDomainsOnly": true,
      "allowedDomains": ["github.com", "*.npmjs.org"]
    }
  }
}

Selama kunci ini bernilai true, sandbox bersifat wajib oleh admin, dan hanya pengaturan terkelola yang dapat menetapkan port proxy.

Domain yang ditolak tetap digabungkan dari setiap sumber yang dimuat oleh sesi. Lihat Mencegah developer memperluas kebijakan.

sandbox.network.httpProxyPort

Mengarahkan sandbox ke proxy HTTP Anda sendiri alih-alih proxy yang dijalankan oleh Claude Code. Organisasi melakukan ini untuk menginspeksi lalu lintas HTTPS, menerapkan aturan penyaringan mereka sendiri, atau mencatat permintaan. Proxy Anda mengambil alih penyaringan, dan Claude Code berhenti menerapkan daftar domain serta permintaan izin jaringannya pada lalu lintas yang dikirim ke sana. Jika tidak ditetapkan, Claude Code memulai proxy-nya sendiri untuk lalu lintas HTTP.

• Cakupan: Any file, kecuali jika pengaturan sandbox lain membatasi file mana yang dapat menetapkan port
• Tipe: angka, sebuah port TCP lokal
• Default: tidak ditetapkan, sehingga Claude Code menjalankan proxy-nya sendiri

{
  "sandbox": {
    "network": {
      "httpProxyPort": 8080
    }
  }
}

Tetapkan juga socksProxyPort jika proxy Anda juga harus membawa lalu lintas SOCKS; jika hanya salah satu dari keduanya yang ditetapkan, Claude Code tetap menjalankan proxy-nya sendiri untuk protokol lainnya. Lihat Konfigurasi proxy kustom.

sandbox.network.socksProxyPort

Mengarahkan sandbox ke proxy SOCKS5 Anda sendiri alih-alih proxy yang dijalankan oleh Claude Code. Proxy Anda mengambil alih penyaringan, dan Claude Code berhenti menerapkan daftar domain serta permintaan izin jaringannya pada lalu lintas yang dikirim ke sana. Jika tidak ditetapkan, Claude Code memulai proxy-nya sendiri untuk lalu lintas SOCKS.

• Cakupan: Any file, kecuali jika pengaturan sandbox lain membatasi file mana yang dapat menetapkan port
• Tipe: angka, sebuah port TCP lokal
• Default: tidak ditetapkan, sehingga Claude Code menjalankan proxy-nya sendiri

{
  "sandbox": {
    "network": {
      "socksProxyPort": 8081
    }
  }
}

Lihat Konfigurasi proxy kustom.

sandbox.network.tlsTerminate

Membuat proxy sandbox melakukan terminasi TLS sehingga dapat membaca isi permintaan HTTPS. Fitur ini bersifat eksperimental, dan substitusi kredensial mask memerlukannya. Tetapkan {} untuk menghasilkan otoritas sertifikat sementara untuk sesi, atau tetapkan caCertPath dan caKeyPath untuk menggunakan milik Anda sendiri.

• Cakupan: User or managed. Repositori tidak dapat mengaktifkannya atau menyediakan otoritas sertifikat.
• Tipe: objek dengan string opsional caCertPath dan caKeyPath, masing-masing berupa path file
• Default: tidak ditetapkan, sehingga proxy tidak melakukan terminasi atau inspeksi TLS

{
  "sandbox": {
    "network": {
      "tlsTerminate": {}
    }
  }
}

Jika lebih dari satu sumber yang dipatuhi menetapkannya, Claude Code menggunakan nilai dari sumber dengan prioritas tertinggi: pengaturan terkelola, lalu flag --settings, lalu pengaturan pengguna.

Memori dan konteks

Kendalikan apa yang dimuat Claude Code ke dalam konteks, bagaimana Claude Code melakukan compaction, dan di mana Claude Code menyimpan memori dan rencana. Lihat Kelola konteks dan Memori.

autoCompactEnabled

Minta Claude Code memadatkan percakapan secara otomatis saat konteks mendekati batas. Muncul di /config sebagai Auto-compact, dan mengubahnya di sana akan menulis kunci ini ke pengaturan pengguna Anda.

• Cakupan: Any file
• Tipe: Boolean
  • true: Claude Code memadatkan percakapan secara otomatis saat konteks mendekati batas
  • false: Claude Code tidak memadatkan secara otomatis
• Default: true
• Override per sesi: DISABLE_AUTO_COMPACT mematikan auto-compact untuk satu sesi; mana pun dari keduanya yang mematikannya, yang lain tidak dapat menyalakannya kembali

{
  "autoCompactEnabled": false
}

Perintah manual /compact tetap berfungsi saat auto-compact dimatikan. Jika Anda mematikan auto-compact, idle compaction juga ikut mati.

autoCompactWindow

Atur seberapa penuh context window sebelum Claude Code melakukan compaction secara otomatis.

• Cakupan: Any file
• Tipe: jumlah token, dari 100000 hingga 1000000. Claude Code membatasi nilainya pada context window model Anda; ikhtisar model mencantumkan window setiap model
• Default: tidak diatur, sehingga Claude Code memilih window yang disesuaikan untuk model Anda
• Override per sesi: --autocompact diutamakan daripada kunci ini untuk satu sesi, dan CLAUDE_CODE_AUTO_COMPACT_WINDOW diutamakan daripada keduanya kecuali Claude Code mengabaikan nilai variabel tersebut

{
  "autoCompactWindow": 500000
}

Perintah /autocompact menyimpan window untuk model saat ini di bawah modelSettings, yang diutamakan daripada kunci ini dalam file yang sama untuk model tersebut. Mengatur auto-compact window menjelaskan bagaimana perintah, flag, variabel, dan pengaturan saling berinteraksi.

autoMemoryDirectory

Simpan auto memory di direktori pilihan Anda alih-alih default per proyek.

• Cakupan: Any file
• Tipe: string, path direktori absolut atau berawalan ~/
• Default: tidak diatur, sehingga Claude Code menggunakan ~/.claude/projects/<project>/memory/

{
  "autoMemoryDirectory": "~/my-memory-dir"
}

Dari pengaturan proyek atau lokal, Claude Code menghormati kunci ini berdasarkan aturan kepercayaan workspace yang sama seperti hook, karena repositori yang di-clone dapat menyediakan file-file tersebut.

autoMemoryEnabled

Nyalakan atau matikan auto memory. Jika false, Claude tidak membaca dari atau menulis ke direktori auto memory. Anda juga dapat mengubahnya dengan /memory selama sesi, yang menulis kunci ini ke pengaturan pengguna Anda.

• Cakupan: Any file
• Tipe: Boolean
  • true: sama seperti tidak diatur; auto memory tetap menyala kecuali sesuatu yang berprioritas lebih tinggi daripada kunci ini mematikannya untuk sesi tersebut, seperti --bare, safe mode, atau CLAUDE_CODE_DISABLE_AUTO_MEMORY
  • false: Claude tidak membaca dari atau menulis ke direktori auto memory
• Default: true
• Override per sesi: CLAUDE_CODE_DISABLE_AUTO_MEMORY diutamakan daripada kunci ini untuk satu sesi, ke arah mana pun

{
  "autoMemoryEnabled": false
}

bashOutputMaxChars

Atur berapa banyak karakter dari output perintah Bash atau PowerShell yang berhasil yang diterima Claude secara inline. Saat output melewati batas, Claude Code menyimpannya ke file dan Claude menerima pratinjau singkat beserta path file tersebut. Naikkan batasnya saat output perintah, seperti build yang verbose atau log test suite lengkap, secara rutin melebihi default dan Anda ingin Claude membacanya tanpa membuka file. Memerlukan Claude Code v2.1.261 atau yang lebih baru.

• Cakupan: Any file
• Tipe: jumlah karakter, bilangan bulat positif. Claude Code membatasi nilainya dalam rentang 4000 hingga 128000
• Default: tidak diatur, sehingga Claude menerima hingga 30.000 karakter secara inline

{
  "bashOutputMaxChars": 100000
}

Saat Anda mengatur kunci ini, Claude Code mengabaikan environment variable BASH_MAX_OUTPUT_LENGTH.

claudeMd

Sisipkan instruksi bergaya CLAUDE.md sebagai memori yang dikelola organisasi tanpa men-deploy file terpisah. Claude Code memuat teks tersebut sebagai entri memori terkelola sebelum file CLAUDE.md pengguna dan proyek.

• Cakupan: Managed
• Tipe: string, teks file CLAUDE.md; tulis seperti Anda menulis file tersebut, termasuk Markdown, dengan jeda baris sebagai \n
• Default: tidak diatur

Contoh ini men-deploy dua aturan sebagai daftar Markdown singkat:

{
  "claudeMd": "# Engineering rules\n\n- Always run make lint before committing.\n- Never push directly to main."
}

Lihat Deploy CLAUDE.md untuk seluruh organisasi.

claudeMdExcludes

Lewati file CLAUDE.md tertentu saat Claude Code memuat memori. Dalam monorepo besar, gunakan ini untuk melewati file CLAUDE.md dari tim lain yang tidak relevan dengan pekerjaan Anda; Kecualikan file CLAUDE.md yang tidak relevan dalam panduan codebase besar membahas kasus tersebut. Pola dicocokkan dengan path file absolut.

• Cakupan: Any file
• Tipe: array string, masing-masing berupa pola glob atau path absolut
• Default: tidak diatur, sehingga Claude Code memuat setiap CLAUDE.md yang ditemukannya

{
  "claudeMdExcludes": ["**/vendor/**/CLAUDE.md"]
}

Pengecualian hanya berlaku untuk file memori pengguna, proyek, dan lokal; file CLAUDE.md kebijakan terkelola tidak dapat dikecualikan.

env

Atur environment variable untuk setiap sesi dan untuk subproses yang dijalankan Claude Code dari sesi tersebut. Sebagian besar variabel dalam referensi environment variable dapat ditempatkan di sini, yang merupakan cara Anda menerapkan variabel ke setiap sesi atau meluncurkannya ke tim Anda. Pengaturan proyek dan lokal tidak dapat mengatur sebagian di antaranya.

• Cakupan: Any file
• Tipe: objek yang memetakan nama variabel ke nilai string
• Default: tidak diatur

Contoh ini mematikan compaction otomatis dan merutekan permintaan API melalui proxy:

{
  "env": {
    "DISABLE_AUTO_COMPACT": "1",
    "ANTHROPIC_BASE_URL": "https://proxy.example.com"
  }
}

Bagaimana nilai env berinteraksi dengan shell Anda

• Nilai di sini menimpa variabel yang sama yang diekspor di shell Anda, dan saat lebih dari satu file pengaturan mengatur suatu variabel, yang memiliki prioritas tertinggi yang berlaku. Variabel yang diabaikan Claude Code di env mencantumkan pengecualian untuk pengaturan proyek dan lokal.
• Saat aplikasi Claude Desktop atau runner lingkungan self-hosted memulai sesi, lingkungan peluncuran yang dibangunnya yang diutamakan: Claude Code mengabaikan nilai env dari file pengaturan mana pun untuk variabel yang sudah diatur oleh lingkungan peluncuran. Log debug menyebutkan setiap variabel yang diabaikan.
• Untuk membatalkan ekspor shell, atur variabel ke "". Claude Code memperlakukan nilai kosong sebagai tidak diatur untuk pemilihan penyedia, dan subproses mewarisi nilai kosong tersebut.
• NO_COLOR dan FORCE_COLOR yang diatur di sini hanya mencapai subproses. Untuk mengubah warna antarmuka Claude Code sendiri, atur keduanya di shell Anda sebelum menjalankan claude.
• Nilai di sini berupa teks biasa di file pengaturan dan mencapai setiap subproses yang dijalankan Claude Code. Untuk token bearer OTLP yang berotasi, gunakan otelHeadersHelper; untuk kredensial API, gunakan apiKeyHelper.

Kapan Claude Code menerapkan nilai env

• Dari pengaturan pengguna, --settings, dan pengaturan terkelola: saat startup, dan lagi di sesi yang sedang berjalan saat perubahan yang disimpan mengubah env gabungan.
• Dari pengaturan proyek dan lokal: setelah Anda memercayai workspace, atau saat startup dalam mode -p, yang tidak pernah menampilkan dialog kepercayaan, dan lagi saat perubahan yang disimpan mengubah env gabungan.
• Variabel yang diklasifikasikan Claude Code sebagai aman, seperti pemilihan model, timeout dan batas, serta toggle fitur: saat startup dari setiap file pengaturan, selain variabel yang tidak dapat diatur oleh pengaturan proyek dan lokal.
• Setelah Anda memindahkan sesi dengan /cd pada v2.1.246 atau yang lebih baru: nilai env proyek dan lokal dari direktori baru, di atas nilai dari direktori sebelumnya.

Variabel yang diabaikan Claude Code di env

• Pengaturan proyek dan lokal tidak dapat mengatur variabel yang seharusnya tidak dikendalikan oleh repositori yang di-checkout; atur variabel tersebut di shell, pengaturan pengguna, atau pengaturan terkelola Anda. Claude Code membuang masing-masing variabel tersebut, selain beberapa nilai yang mematikan telemetri, dan mencatat peringatan yang dapat Anda lihat dengan claude --debug. Variabel tersebut meliputi:

  • Variabel yang memilih tempat Claude Code menyimpan atau menulis filenya sendiri: CLAUDE_CONFIG_DIR, CLAUDE_CODE_TMPDIR, dan variabel direktori sistem operasi seperti HOME, TMPDIR, TMP, TEMP, dan keluarga XDG_*.

  • Variabel Windows yang memilih program dan konfigurasi seluruh mesin untuk proses yang dijalankan Claude Code, seperti SystemRoot, ComSpec, ProgramData, LOCALAPPDATA, PATHEXT, PSModulePath, dan keluarga ProgramFiles.

  • Variabel yang mengekspor konten sesi: OTEL_LOG_RAW_API_BODIES dan pasangan tracing beta terperinci ENABLE_BETA_TRACING_DETAILED dan BETA_TRACING_ENDPOINT.

  • Variabel exporter OpenTelemetry yang menyalakan telemetri, memilih tujuannya, atau memilih konten yang ditangkapnya:

    • CLAUDE_CODE_ENABLE_TELEMETRY, ditambah pasangan beta telemetri yang ditingkatkan CLAUDE_CODE_ENHANCED_TELEMETRY_BETA dan ENABLE_ENHANCED_TELEMETRY_BETA
    • Pemilih exporter OTEL_LOGS_EXPORTER, OTEL_METRICS_EXPORTER, dan OTEL_TRACES_EXPORTER
    • Variabel konten OTEL_LOG_USER_PROMPTS, OTEL_LOG_ASSISTANT_RESPONSES, OTEL_LOG_TOOL_CONTENT, dan OTEL_LOG_TOOL_DETAILS
    • Variabel OTEL_EXPORTER_OTLP_* yang namanya diakhiri dengan _ENDPOINT, _HEADERS, _PROTOCOL, _CERTIFICATE, _CLIENT_KEY, atau _INSECURE, dalam bentuk generik dan per sinyal, seperti OTEL_EXPORTER_OTLP_ENDPOINT dan OTEL_EXPORTER_OTLP_METRICS_HEADERS
    • OTEL_EXPORTER_PROMETHEUS_HOST dan OTEL_EXPORTER_PROMETHEUS_PORT

    Hanya nilai-nilai berikut yang masih berlaku dari pengaturan proyek dan lokal, karena nilai tersebut mematikan sesuatu: none untuk ketiga pemilih exporter, dan nilai mati seperti 0 untuk OTEL_LOG_USER_PROMPTS, OTEL_LOG_TOOL_CONTENT, dan OTEL_LOG_TOOL_DETAILS. Nilai seperti itu menimpa variabel yang sama di pengaturan pengguna Anda, tetapi tidak menimpa variabel yang diatur oleh lingkungan tempat Anda menjalankan Claude Code, file --settings, atau pengaturan terkelola.

    Saat file pengaturan proyek atau lokal mengatur variabel dalam grup ini, sesi interaktif lokal menampilkan pemberitahuan saat startup. Jalankan /status atau claude doctor untuk melihat variabel mana yang diabaikan Claude Code dan mana yang mematikan telemetri; keduanya mencantumkan nama, tidak pernah nilai. Eksekusi non-interaktif dengan -p atau sesi Agent SDK tidak menampilkan pemberitahuan, jadi periksa bahwa collector Anda masih menerima data setelah Anda melakukan upgrade. Jika tidak, atur variabel tersebut di pengaturan pengguna, pengaturan terkelola, lingkungan job, atau file yang Anda berikan dengan --settings.

    Pengabaian grup ini di pengaturan proyek dan lokal memerlukan Claude Code v2.1.282 atau yang lebih baru.

  • Variabel yang mengubah cara Claude Code dimulai atau disinkronkan, seperti CLAUDE_CODE_PROCESS_WRAPPER, CLAUDE_CODE_SYNC_SKILLS, CLAUDE_CODE_SYNC_PLUGINS, CLAUDE_CODE_PLUGIN_CACHE_DIR, dan CLAUDE_CODE_PLUGIN_SEED_DIR.

  • Variabel yang mengatur proses masuk claude.ai Anda, seperti CLAUDE_CODE_OAUTH_TOKEN, CLAUDE_CODE_OAUTH_REFRESH_TOKEN, dan CLAUDE_CODE_OAUTH_SCOPES.

  • Variabel mode pembaca layar CLAUDE_AX_SCREEN_READER dan variabel lain yang namanya diawali dengan CLAUDE_AX_, seperti CLAUDE_AX_STARTUP_QUIET_MS.

  • CLAUDE_CODE_USER_DIALOG_TIMEOUT_MS, yang mengatur pengatur waktu pada dialog yang belum dijawab.

  • CLAUDE_CODE_DISABLE_ATTACHMENTS, yang mematikan pemrosesan lampiran.

  • CLAUDE_CODE_DISABLE_FILE_MENTIONS, yang menghentikan Claude Code dari memperluas mention @ untuk file dan direktori.

  Sebelum v2.1.251, pengaturan proyek dan lokal juga dapat mengatur variabel dalam daftar ini yang memilih tempat Claude Code menulis filenya atau yang mengekspor konten sesi, kecuali HOME dan XDG_CONFIG_HOME. Sebelum v2.1.290, pengaturan tersebut juga dapat mengatur variabel pengatur waktu dialog dan CLAUDE_CODE_DISABLE_ATTACHMENTS.

• Variabel identitas yang dimiliki oleh lingkungan hosting Claude Code, seperti CLAUDE_CODE_REMOTE dan CLAUDE_CODE_ACCOUNT_UUID, diabaikan dari setiap file.

• CLAUDE_CODE_MESSAGING_SOCKET dan CLAUDE_CODE_MESSAGING_TOKEN, yang diekspor sendiri oleh Claude Code, diabaikan dari setiap file. Pengabaian variabel socket memerlukan Claude Code v2.1.224 atau yang lebih baru, dan pengabaian token memerlukan v2.1.228 atau yang lebih baru.

• CLAUDE_CODE_PROJECT_DIR_NAME, yang dibaca Claude Code hanya dari lingkungan peluncuran, diabaikan dari setiap file; memerlukan v2.1.234 atau yang lebih baru.

• CLAUDE_CODE_RESTRICTED, yang dibaca Claude Code hanya dari lingkungan peluncuran, diabaikan dari setiap file.

• CLAUDE_CODE_DISABLE_POWERSHELL_CMD_RM_DENY, yang dibaca Claude Code hanya dari lingkungan peluncuran, diabaikan dari setiap file. Variabel ini memerlukan Claude Code v2.1.283 atau yang lebih baru.

• CLAUDE_CODE_DISABLE_DANGEROUS_RM_TIMEOUT, CLAUDE_CODE_DISABLE_SUBSTITUTION_RM_PROMPT, CLAUDE_CODE_DISABLE_INLINE_SHELL_RM_PROMPT, dan CLAUDE_CODE_DISABLE_MOUNTED_DRIVE_RM_PROMPT, yang dibaca Claude Code hanya dari lingkungan peluncuran, diabaikan dari setiap file.

• CLAUDE_CODE_EVEN_MORE_DANGEROUSLY_SKIP_PERMISSIONS, yang dibaca Claude Code hanya dari lingkungan peluncuran, diabaikan dari setiap file.

• CLAUDE_CODE_WARN_DISK_FREE_GIB dan CLAUDE_CODE_WARN_MEMORY_FREE_GIB, yang dibaca Claude Code hanya dari lingkungan peluncuran, diabaikan dari setiap file. Variabel ini memerlukan Claude Code v2.1.304 atau yang lebih baru.

fileCheckpointingEnabled

Minta Claude Code membuat snapshot file sebelum setiap pengeditan agar /rewind dapat memulihkannya. Muncul di /config sebagai Rewind code (checkpoints), dan mengubahnya di sana akan menulis kunci ini ke pengaturan pengguna Anda.

• Cakupan: Any file
• Tipe: Boolean
  • true: Claude Code membuat snapshot file sebelum setiap pengeditan agar /rewind dapat memulihkannya
  • false: Claude Code tidak membuat snapshot file, sehingga /rewind tidak dapat memulihkannya
• Default: true
• Override per sesi: CLAUDE_CODE_DISABLE_FILE_CHECKPOINTING mematikan checkpointing untuk satu sesi; mana pun dari keduanya yang mematikannya, yang lain tidak dapat menyalakannya kembali

{
  "fileCheckpointingEnabled": false
}

Dalam eksekusi -p atau sesi Agent SDK, Claude Code mengabaikan kunci ini. SDK menyalakan checkpointing dengan opsi enableFileCheckpointing, dan eksekusi -p biasa memerlukan CLAUDE_CODE_ENABLE_SDK_FILE_CHECKPOINTING=true. Lihat File checkpointing di Agent SDK.

idleCompaction

Idle compaction memadatkan percakapan panjang yang Anda tinggalkan. Pesan Anda berikutnya kemudian mengirimkan ringkasan alih-alih seluruh percakapan. Setelah dipadatkan, percakapan menampilkan pemberitahuan:

• Terminal: baris yang diawali dengan Compacted while idle, before the prompt cache expired
• Panel chat VS Code: pemberitahuan yang menyertakan a summary written while you were away
• Aplikasi desktop: pemberitahuan yang sama, di dalam baris yang labelnya menyertakan Claude Code notice. Jika Anda tidak melihat baris tersebut atau teksnya, beralihlah ke mode tampilan Verbose.

Idle compaction menyala secara default untuk percakapan yang memenuhi semua kondisi berikut:

• Sesi: Anda berada dalam sesi terminal interaktif, di panel chat ekstensi VS Code, atau di tab Code aplikasi desktop saat sesi berjalan di mesin Anda atau melalui SSH
• Auto-compaction: autoCompactEnabled menyala
• Prompt cache: percakapan menggunakan TTL prompt cache satu jam
• Ukuran: konteks percakapan telah mencapai ambang token, yang dapat Anda ubah dari default-nya sebesar 200.000
• Waktu idle: sekitar satu jam telah berlalu sejak permintaan terakhir, dan komputer Anda tetap menyala hingga saat itu

Untuk mematikan idle compaction, atur kunci ini ke false.

• Cakupan: Any file
• Tipe: Boolean
  • true: Claude Code memadatkan percakapan idle yang memenuhi kondisi
  • false: Claude Code tidak melakukan compaction saat sesi Anda idle
• Default: true
• Override per sesi: DISABLE_AUTO_COMPACT mematikan idle compaction bersama dengan auto-compaction

{
  "idleCompaction": false
}

Untuk mematikan atau menyalakan idle compaction dari dalam sesi terminal, jalankan /config dan ubah baris Idle compaction. Pilihan Anda disimpan ke pengaturan pengguna Anda dan langsung berlaku. Baris ini memerlukan Claude Code v2.1.302 atau yang lebih baru. Jika Anda menjalankan salah satu versi tersebut dan /config tidak menampilkan baris tersebut, periksa penyebab berikut:

• Sumber pengaturan lain mengatur kunci ini: nilai di pengaturan terkelola, flag --settings, atau file pengaturan proyek atau lokal menimpa pengaturan pengguna Anda. Ubah kunci di sumber tersebut
• Feature flag tidak tersedia pada versi sebelum v2.1.314: jika Claude Code tidak dapat mengambil feature flag dari Anthropic, idle compaction tidak berjalan, sehingga tidak ada yang perlu dimatikan

Kunci ini memerlukan Claude Code v2.1.290 atau yang lebih baru. Pada versi sebelumnya, yang mengabaikan kunci ini, matikan autoCompactEnabled untuk menghentikan idle compaction.

Mengubah ambang idle compaction

Atur CLAUDE_CODE_IDLE_COMPACT_MIN_TOKENS ke jumlah token yang harus dicapai konteks percakapan sebelum idle compaction berlaku untuknya. Gunakan bilangan bulat positif. Nilai di bawah 100000 dinaikkan menjadi 100000, ambang terendah.

Pada default, percakapan pada context window 200K akan auto-compact sebelum mencapai 200.000 token. Contoh ini menurunkan ambang menjadi 150.000 agar percakapan tersebut memenuhi syarat:

{
  "env": {
    "CLAUDE_CODE_IDLE_COMPACT_MIN_TOKENS": "150000"
  }
}

Idle compaction di VS Code dan aplikasi desktop

Pemberitahuan seperti ini berarti Claude Code mengganti percakapan Anda sebelumnya dengan ringkasan yang sekarang menjadi dasar kerja Claude:

Compacted using a summary written while you were away · turn off with "idleCompaction": false in settings.json

Anda tidak perlu melakukan apa pun. Untuk mematikan idle compaction, atur idleCompaction ke false di ~/.claude/settings.json pada mesin atau distribusi WSL tempat sesi berjalan, atau di file pengaturan lainnya.

plansDirectory

Pilih tempat Claude Code menyimpan file rencana yang ditulisnya dalam plan mode. Claude Code me-resolve path relatif terhadap root proyek.

• Cakupan: Any file
• Tipe: string, path relatif terhadap root proyek
• Default: tidak diatur, sehingga Claude Code menggunakan ~/.claude/plans

{
  "plansDirectory": "./plans"
}

Claude Code menyimpan rencana di ~/.claude/plans alih-alih direktori yang Anda atur dalam kasus seperti berikut:

• Di luar root proyek: path ter-resolve ke luar root proyek, seperti "../plans".
• Backslash di macOS, Linux, dan WSL: path yang ter-resolve berisi backslash, seperti "docs\\plans" bergaya Windows. Tulis "docs/plans", yang juga berfungsi di Windows.

skillListingBudgetFraction

Setiap giliran, Claude melihat daftar skill Anda beserta deskripsinya, dan Claude Code membatasi daftar tersebut pada porsi tertentu dari context window. Saat daftar melebihi batas, Claude Code mempertahankan nama setiap skill tetapi membuang deskripsi skill yang paling jarang digunakan, sehingga Claude masih dapat memanggil skill tersebut tetapi lebih kecil kemungkinannya untuk memilihnya sendiri. Naikkan kunci ini untuk menjaga lebih banyak deskripsi tetap terlihat dengan konsekuensi lebih banyak konteks per giliran.

• Cakupan: Any file
• Tipe: angka, pecahan yang lebih besar dari 0 dan paling banyak 1
• Default: 0.01, yang mencadangkan 1% dari context window

{
  "skillListingBudgetFraction": 0.02
}

Untuk melihat berapa banyak konteks yang digunakan daftar tersebut dan skill mana yang paling banyak berkontribusi, jalankan /doctor.

skillListingMaxDescChars

Setiap giliran, Claude melihat daftar skill Anda yang menampilkan teks description dan when_to_use setiap skill. Kunci ini membatasi berapa banyak karakter dari teks tersebut yang ditampilkan Claude Code per skill; teks yang lebih panjang dipotong pada batas tersebut.

• Cakupan: Any file
• Tipe: jumlah karakter, bilangan bulat positif
• Default: 1536

{
  "skillListingMaxDescChars": 2048
}

Naikkan untuk menjaga deskripsi panjang tetap utuh dengan konsekuensi lebih banyak konteks per giliran; turunkan untuk memuat lebih banyak skill di bawah skillListingBudgetFraction.

taskOutputMaxChars

[!WARNING]

Dihapus di v2.1.277, bersama dengan tool TaskOutput yang ukurannya diatur olehnya. Mengaturnya tidak berpengaruh pada versi saat ini. Claude membaca file output tugas latar belakang dengan Read sebagai gantinya.

Hingga v2.1.276, Anda mengatur kunci ini ke jumlah karakter output tugas latar belakang yang diterima Claude secara inline saat membaca tugas tersebut dengan tool TaskOutput.

Interface dan terminal

Ubah tampilan dan perilaku Claude Code di terminal Anda: tema, mode editor, status line, spinner, notifikasi dalam sesi, dan aksesibilitas. Lihat Konfigurasi terminal.

askUserQuestionTimeout

Biarkan dialog AskUserQuestion yang belum dijawab melanjutkan secara otomatis setelah periode waktu idle, mengirimkan opsi apa pun yang telah Anda pilih. Atur ini ketika Anda pergi dan ingin Claude melanjutkan tanpa Anda. Dengan default, pertanyaan menunggu sampai Anda menjawabnya. Untuk kapan timer berhenti sementara atau tidak pernah dimulai, lihat Question auto-continue timeout.

• Scope: User or managed
• Type: string, salah satu dari "60s", "5m", "10m", atau "never"
• Default: "never"

{
  "askUserQuestionTimeout": "5m"
}

Muncul di /config sebagai Question auto-continue timeout, yang menulis kunci ini ke pengaturan pengguna; Claude Code menyembunyikan baris saat pengaturan terkelola atau flag --settings mengatur kunci.

autoContinueAtUsageLimit

Setelah batas penggunaan claude.ai menghentikan sesi Anda, tunggu di sesi terbuka dan lanjutkan tugas secara otomatis setelah reset. Lihat Matikan automatic continue. Memerlukan Claude Code v2.1.234 atau lebih baru.

• Scope: User or managed. Baca dari pengaturan pengguna, --settings, dan pengaturan terkelola saja. Ketika tidak ada yang mengatur kunci, file pengaturan proyek atau lokal yang mengaturnya mematikan fitur daripada diabaikan.
• Type: Boolean
  • true: setelah batas penggunaan claude.ai menghentikan sesi Anda, Claude Code menunggu di sesi terbuka dan melanjutkan tugas secara otomatis setelah reset
  • false: Claude Code tidak memulai penantian dengan sendirinya. Anda masih dapat memulai penantian sendiri dari menu opsi batas penggunaan
• Default: true

{
  "autoContinueAtUsageLimit": false
}

Muncul di /config sebagai Continue automatically at usage limit, yang menulis kunci ini ke pengaturan pengguna; Claude Code menyembunyikan baris saat pengaturan terkelola atau flag --settings mengatur kunci.

autoScrollEnabled

Ikuti output baru ke bagian bawah percakapan dalam fullscreen rendering. Matikan untuk tetap di tempat Anda menggulir sementara Claude terus bekerja; prompt izin masih menggulir ke tampilan.

• Scope: Any file
• Type: Boolean
  • true: percakapan mengikuti output baru ke bagian bawah
  • false: Anda tetap di tempat Anda menggulir sementara Claude terus bekerja; prompt izin masih muncul di bawah transkrip
• Default: true

{
  "autoScrollEnabled": false
}

Muncul di /config sebagai Auto-scroll ketika fullscreen rendering aktif, yang menulis kunci ini ke pengaturan pengguna.

axScreenReader

Render output yang ramah pembaca layar: teks datar tanpa batas dekoratif atau animasi. Mode pembaca layar menggunakan renderer klasik, jadi pengaturan tui tidak berpengaruh saat aktif; sesi latar belakang yang terlampir masih merender fullscreen.

• Scope: User or managed. Anda juga dapat mengatur kunci ini dalam file yang Anda berikan dengan --settings. Claude Code mengabaikan kunci ini dalam pengaturan proyek dan lokal, jadi baik repositori maupun .claude/settings.local.json milik Anda sendiri tidak dapat mengaktifkan atau mematikan mode pembaca layar.
• Type: Boolean
  • true: Claude Code merender teks datar tanpa batas dekoratif atau animasi, menggunakan renderer klasik
  • false: Claude Code merender secara normal
• Default: unset, jadi mode pembaca layar mati
• Per-session overrides: --ax-screen-reader mengambil alih CLAUDE_AX_SCREEN_READER, dan keduanya mengambil alih kunci ini untuk satu sesi

{
  "axScreenReader": true
}

bashEditDiffEnabled

Pilih apakah Claude Code mencatat file yang diubah dalam repositori Git saat perintah Bash berjalan. Ketika mencatatnya, Anda melihat diff mereka di terminal setelah perintah, dan PostToolUse Bash hooks Anda menerima daftar file yang diubah.

File yang terdaftar tidak selalu merupakan file yang diubah perintah. Perubahan yang dibuat program lain atau panggilan Bash lain saat perintah berjalan juga dapat muncul di sana.

Atur kunci ke true untuk mencatatnya dalam setiap mode izin. Memerlukan Claude Code v2.1.269 atau lebih baru.

• Scope: User or managed. true hanya dihitung dari pengaturan pengguna Anda, JSON yang dilewatkan dengan --settings, atau pengaturan terkelola, jadi true dalam .claude/settings.json atau .claude/settings.local.json repositori tidak dapat mengaktifkan pencatatan. false dalam file repositori apa pun masih mematikannya kecuali file preseden lebih tinggi mengatur true.
• Type: Boolean
• Default: unset, jadi Claude Code mencatat perubahan dalam mode auto dan mode bypassPermissions ketika mengarahkan Claude untuk mengedit file melalui Bash
• Per-session overrides: CLAUDE_CODE_BASH_EDIT_DIFF mengambil alih kunci ini untuk satu sesi

{
  "bashEditDiffEnabled": true
}

companyAnnouncements

Tampilkan pengumuman organisasi Anda kepada pengguna saat startup. Ketika Anda mencantumkan lebih dari satu, Claude Code memilih satu secara acak untuk setiap sesi; pada peluncuran pertama seseorang, ini menampilkan entri pertama.

• Scope: Any file
• Type: array of strings
• Default: unset, jadi tidak ada pengumuman yang ditampilkan

{
  "companyAnnouncements": [
    "Welcome to Acme Corp! Review our code guidelines at docs.example.com"
  ]
}

defaultShell

Pilih apakah Bash atau PowerShell menjalankan perintah shell yang Anda ketik dengan prefix ! di kotak input, yang dijalankan Claude Code secara langsung dan ditambahkan ke sesi.

"powershell" hanya berfungsi saat tool PowerShell aktif. Tool ini aktif secara default di Windows tanpa Git Bash, dan di Windows dengan Git Bash untuk akun claude.ai dan Console. Di sesi Amazon Bedrock, Google Cloud's Agent Platform, dan Microsoft Foundry, serta di macOS, Linux, dan WSL, atur CLAUDE_CODE_USE_POWERSHELL_TOOL=1 untuk mengaktifkan tool. Atur variabel itu ke 0 untuk mematikan tool.

• Scope: Any file
• Type: string, salah satu dari:
  • "bash": Claude Code menjalankan perintah ! Anda di Bash
  • "powershell": Claude Code menjalankan perintah ! Anda di PowerShell
• Default: "bash", atau "powershell" di Windows ketika Bash tidak tersedia

{
  "defaultShell": "powershell"
}

Jika shell yang Anda beri nama tidak tersedia, Claude Code menggunakan yang lain: "powershell" kembali ke Bash ketika tool PowerShell mati, dan "bash" kembali ke PowerShell ketika Bash tidak terinstal.

dialogExpiry

Atur tenggat waktu untuk dialog yang Claude Code teruskan ke klien jarak jauh, seperti host Remote Control atau SDK, dan untuk dialog persetujuan untuk pesan lintas sesi yang ditahan. Di Claude Code v2.1.236 atau lebih baru, tenggat waktu yang sama membatasi prompt persetujuan kredit penggunaan Fable pertengahan sesi dalam sesi yang mungkin tidak ada siapa pun di terminal. Ketika tidak ada jawaban sebelum tenggat waktu, Claude Code membatalkan dialog dan melanjutkan dengan default tanpa tindakan. Memerlukan Claude Code v2.1.224 atau lebih baru.

• Scope: User or managed
• Type: string, salah satu dari "60s", "5m", "10m", atau "never", yang menonaktifkan tenggat waktu
• Default: "5m"
• Per-session overrides: CLAUDE_CODE_USER_DIALOG_TIMEOUT_MS mengambil alih kunci ini untuk satu sesi

{
  "dialogExpiry": "10m"
}

Prompt izin dan pertanyaan AskUserQuestion menggunakan alur mereka sendiri dan tidak diatur oleh tenggat waktu ini. Muncul di /config sebagai Dialog expiry, yang menulis kunci ini ke pengaturan pengguna; baris memerlukan Claude Code v2.1.232 atau lebih baru, dan Claude Code menyembunyikannya saat pengaturan terkelola atau flag --settings mengatur kunci.

editorMode

Pilih mode pengikatan kunci untuk prompt input.

• Scope: Any file
• Type: string, salah satu dari:
  • "normal": pintasan keyboard standar dalam input prompt
  • "vim": pengeditan gaya vim dengan mode NORMAL, INSERT, dan VISUAL
• Default: "normal"

{
  "editorMode": "vim"
}

Muncul di /config sebagai Editor mode, yang menulis kunci ini ke pengaturan pengguna.

emojiCompletionEnabled

Tampilkan saran emoji ketika Anda mengetik : ditambah shortcode dalam input prompt, dan ganti shortcode yang selesai seperti :heart: dengan emojinya. Atur ke false untuk mematikan keduanya.

• Scope: Any file
• Type: Boolean
  • true: Claude Code menampilkan saran emoji setelah : dan mengganti shortcode yang selesai dengan emojinya
  • false: Claude Code tidak menyarankan emoji atau mengganti shortcode
• Default: true

{
  "emojiCompletionEnabled": false
}

Lihat Emoji shortcodes.

fileSuggestion

Jalankan perintah Anda sendiri untuk menyediakan pelengkapan otomatis jalur file @ daripada saran file bawaan. Saran bawaan menggunakan traversal filesystem cepat; monorepo besar mungkin lebih baik dengan pengindeksan khusus proyek seperti indeks file yang sudah dibangun.

• Scope: Any file. Di bawah status line dan file suggestion gates, Claude Code mematikan perintah atau menjalankan hanya nilai terkelola, dan melewati milik Anda tanpa peringatan.
• Type: object dengan type, selalu "command", dan command, perintah shell untuk dijalankan
• Default: unset, jadi Claude Code menggunakan saran file bawaan

{
  "fileSuggestion": {
    "type": "command",
    "command": "~/.claude/file-suggestion.sh"
  }
}

Setelah Anda menyimpan ini, ketik @ diikuti bagian dari jalur dalam prompt: saran berasal dari output perintah Anda.

Command input dan output

Claude Code menjalankan perintah dengan variabel lingkungan yang sama seperti hooks, termasuk CLAUDE_PROJECT_DIR, dan berhenti menunggu setelah lima detik. Perintah menerima JSON di stdin dengan field query yang menampung apa yang telah Anda ketik sejauh ini:

{"query": "src/comp"}

Cetak jalur file yang dipisahkan baris baru ke stdout. Claude Code menampilkan paling banyak 15:

src/components/Button.tsx
src/components/Modal.tsx
src/components/Form.tsx

Skrip berikut membaca query dan menyerahkannya ke indeks file repositori:

#!/bin/bash
query=$(cat | jq -r '.query')
# Replace your-repo-file-index with your own file search command
your-repo-file-index --query "$query" | head -20

footerLinksRegexes

Render lencana yang dapat diklik tambahan di footer di bawah kotak input ketika regex cocok dengan output giliran: hasil tool, termasuk konten file dan halaman yang diambil, dan respons Claude sendiri. Gunakan untuk mengubah ID yang dicetak oleh CLI proyek, seperti alat review dan pelacak masalah, menjadi tautan sesi.

• Scope: User or managed
• Type: array of objects, masing-masing dengan type diatur ke "regex", regex pattern, template url, dan label opsional; placeholder {name} dalam url dan label diisi dari grup penangkapan bernama dalam pattern
• Default: unset, jadi tidak ada lencana yang dirender

Contoh ini cocok dengan kunci masalah seperti PROJ-1234 dan membangun setiap tautan dari kunci yang ditangkap:

{
  "footerLinksRegexes": [
    {
      "type": "regex",
      "pattern": "\\b(?<key>PROJ-\\d+)\\b",
      "url": "https://issues.example.com/browse/{key}",
      "label": "{key}"
    }
  ]
}

Dengan ini dikonfigurasi, ketika PROJ-1234 muncul dalam hasil tool atau dalam balasan Claude, lencana PROJ-1234 muncul di footer menautkan ke https://issues.example.com/browse/PROJ-1234.

Batasan lencana

Setiap URL, label, dan jumlah lencana entri dibatasi sebagai berikut:

Ketika giliran selesai, Claude Code mencocokkan regex pattern setiap entri terhadap output giliran di thread utama, jadi regex yang lambat memblokir UI sampai selesai. Quantifier bersarang seperti (a+)+$ dapat memakan waktu secara eksponensial terhadap input tertentu dan membekukan sesi, jadi jaga setiap pattern linear dan hindari penggandaan + atau *.

Lencana footer dirender bersama status line kustom ketika satu dikonfigurasi; tidak ada yang menggantikan yang lain. Gunakan status line untuk baris yang didorong skrip yang menghitung kontennya sendiri dari data sesi, dan lencana footer untuk mengubah ID dari percakapan menjadi tautan tanpa skrip.

keybindingFlavor

[!WARNING]

Tidak direkomendasikan sejak v2.1.261 dan tidak berpengaruh. Kunci pengeditan kata prompt selalu mengikuti konvensi readline, seperti di Bash. Claude Code masih menerima keybindingFlavor, jadi file pengaturan yang mengaturnya tetap valid.

Di v2.1.238 hingga v2.1.260, mengaturnya ke "readline" membuat Ctrl+W menghapus kembali ke spasi sebelumnya daripada hanya kata sebelumnya.

• Scope: Any file
• Type: string, "classic" atau "readline"
• Default: unset

maxProseWidth

Batasi lebar prosa dalam respons Claude sehingga baris tetap dapat dibaca di terminal lebar. Paragraf, judul, daftar, dan blockquote membungkus dalam jumlah kolom ini, sementara tabel dan blok kode menjaga lebar terminal penuh. Memerlukan Claude Code v2.1.282 atau lebih baru.

• Scope: Any file
• Type: number of terminal columns, a whole number, minimum 40. Claude Code mengabaikan nilai apa pun yang lain
• Default: unset, jadi prosa membungkus di tepi terminal

{
  "maxProseWidth": 80
}

prefersReducedMotion

Kurangi atau matikan animasi antarmuka seperti spinner, shimmer, dan efek flash. Muncul di /config sebagai Reduce motion.

• Scope: Any file
• Type: Boolean
  • true: Claude Code mengurangi atau mematikan animasi antarmuka seperti spinner, shimmer, dan efek flash
  • false: sama dengan unset; Claude Code menampilkan animasinya
• Default: false

{
  "prefersReducedMotion": true
}

promptSuggestionEnabled

Tampilkan atau sembunyikan prompt suggestions, prediksi yang dikelabuhi yang muncul dalam input prompt Anda. Atur ke false, atau matikan Prompt suggestions di /config, untuk menyembunyikannya.

• Scope: Any file
• Type: Boolean
  • true: Anda melihat saran prompt dalam input prompt Anda
  • false: Claude Code menyembunyikan saran prompt
• Default: true
• Per-session overrides: CLAUDE_CODE_ENABLE_PROMPT_SUGGESTION mengambil alih kunci ini untuk satu sesi

{
  "promptSuggestionEnabled": false
}

Saran prompt memerlukan akun claude.ai atau Console dengan telemetri aktif. Di Amazon Bedrock, Google Cloud's Agent Platform, dan Microsoft Foundry, atau dengan telemetri dimatikan, seperti oleh DISABLE_TELEMETRY, kunci ini tidak berpengaruh dan hanya CLAUDE_CODE_ENABLE_PROMPT_SUGGESTION=1 mengaktifkannya.

respectGitignore

Kontrol apakah pemilih file @ mengeluarkan file yang cocok dengan pola .gitignore. Muncul di /config sebagai Respect .gitignore in file picker.

• Scope: Any file. Ketika tidak ada file pengaturan yang mengaturnya, Claude Code kembali ke respectGitignore di ~/.claude.json, yang toggle /config tulis.
• Type: Boolean
  • true: pemilih file @ mengeluarkan file yang cocok dengan pola .gitignore
  • false: pemilih file @ menyertakan file yang cocok dengan pola .gitignore
• Default: true

{
  "respectGitignore": false
}

respondToBashCommands

Pilih apakah Claude merespons setelah Anda menjalankan perintah shell dengan prefix ! di kotak input. Secara default, Claude Code menambahkan output perintah ke percakapan dan Claude membalasnya. Atur kunci ini ke false untuk menambahkan output ke konteks tanpa balasan, sehingga Anda dapat menjalankan beberapa perintah dan menanyakan tentang mereka bersama-sama.

• Scope: Any file
• Type: Boolean
  • true: Claude Code menambahkan output perintah ke percakapan dan Claude membalasnya
  • false: Claude Code menambahkan output ke konteks tanpa balasan
• Default: true

{
  "respondToBashCommands": false
}

Lihat Shell mode dengan prefix !.

showClearContextOnPlanAccept

Ketika Claude menyelesaikan rencana dalam plan mode, ini menampilkan menu persetujuan. Perencanaan dapat menggunakan banyak konteks, jadi kunci ini menambahkan opsi pertama ke menu itu, Yes, clear context and …, yang menyetujui rencana, menghapus konteks percakapan, dan mulai mengimplementasikan dari rencana saja. Sisa label menamai mode izin sesi berlanjut, dan menunjukkan berapa banyak konteks Anda yang digunakan perencanaan.

• Scope: Any file
• Type: Boolean
  • true: menu persetujuan rencana mendapat opsi pertama, Yes, clear context and …, yang menyetujui rencana dan menghapus konteks percakapan
  • false: menu persetujuan rencana tidak menampilkan opsi clear-context
• Default: false

{
  "showClearContextOnPlanAccept": true
}

showTurnDuration

Tampilkan atau sembunyikan pesan durasi giliran setelah setiap respons, seperti "Cooked for 1m 6s · done 6:05 PM". Jam setelah "done" menunjukkan kapan giliran selesai; timeFormat dan timeZone mengontrol format dan zonanya. Muncul di /config sebagai Show turn duration.

• Scope: Any file. Nilai di ~/.claude.json dari versi yang lebih lama berlaku ketika tidak ada file pengaturan yang mengaturnya.
• Type: Boolean
  • true: Anda melihat pesan durasi giliran setelah setiap respons
  • false: Claude Code menyembunyikan pesan durasi giliran
• Default: true

{
  "showTurnDuration": false
}

spellcheck

Garis bawahi kata-kata yang salah eja dalam input prompt saat Anda mengetik, menggunakan pemeriksa ejaan yang Anda instal. Claude Code hanya memeriksa teks dalam kotak input. Check spelling as you type mencakup penginstalan aspell, hunspell, atau ispell dan apa yang diperiksa pemeriksa. Memerlukan Claude Code v2.1.235 atau lebih baru.

• Scope: User or managed. Blok dari tier tertinggi yang mengaturnya berlaku secara keseluruhan.
• Type: object dengan enabled (Boolean), checker ("aspell", "hunspell", "ispell", atau "auto"), language (string, dilewatkan ke pemeriksa sebagai nama kamus), dan color (string, nama warna terminal, #rrggbb, rgb(r,g,b), ansi256(n), atau ansi:<name>)
• Default: unset, jadi pemeriksaan ejaan mati; checker default ke "auto", yang pertama dari tiga ditemukan di PATH; language default ke kamus pemeriksa sendiri; color default ke warna kesalahan tema

{
  "spellcheck": { "enabled": true, "language": "en_GB" }
}

spinnerTipsEnabled

Saat Claude bekerja, baris spinner berputar melalui tips pendek tentang fitur Claude Code, seperti "Use Plan Mode to prepare for a complex request before making changes. Press Shift+Tab twice to enable." Atur kunci ini ke false untuk menyembunyikannya. Muncul di /config sebagai Show tips.

• Scope: Any file
• Type: Boolean
  • true: Anda melihat tips dalam spinner saat Claude bekerja
  • false: Claude Code menyembunyikan tips spinner
• Default: true

{
  "spinnerTipsEnabled": false
}

spinnerTipsOverride

Tambahkan tips Anda sendiri ke spinner tips yang Claude Code tampilkan saat Claude bekerja, atau ganti tips bawaan dengan milik Anda. Claude Code menempatkan tips Anda dalam rotasi yang sama dengan yang bawaan.

Jika Anda mengatur spinnerTipsEnabled ke false, Claude Code menyembunyikan semua tips, milik Anda termasuk.

• Scope: Any file. Claude Code menghormati objek tip, tipsFile, label, dan excludeDefault dari pengaturan pengguna, flag --settings, dan pengaturan terkelola; dari pengaturan proyek dan lokal hanya membaca tips string biasa.
• Type: object dengan field tips, tipsFile, label, dan excludeDefault, masing-masing opsional
• Default: unset, jadi Claude Code hanya menampilkan tips bawaan

Objek tip, tipsFile, label, dan aturan baris Scope yang pengaturan proyek dan lokal hanya berkontribusi string biasa memerlukan Claude Code v2.1.247 atau lebih baru.

Setiap entri tips adalah string biasa atau objek dengan field ini:

Claude Code membaca string biasa sebagai tip dengan default tersebut dan id berbasis posisi, jadi riwayat tampilan direset ketika Anda mengurutkan ulang daftar. Berikan tip id untuk menjaga riwayatnya di seluruh edit.

Claude Code membaca paling banyak 200 tips di seluruh tips dan tipsFile, dan menjatuhkan entri tidak valid dengan peringatan debug daripada menolak file pengaturan.

Gunakan field yang tersisa untuk menamai file tips, atur awalan, dan sembunyikan tips bawaan:

• tipsFile: jalur absolut atau ~/ ke file JSON lokal yang menampung array entri yang sama, atau objek dengan array tips, hingga 256 KB. Claude Code membaca file sekali per proses, jadi memuat edit Anda pada awal berikutnya. Anda tidak dapat mengaturnya melalui pengaturan terkelola server; deploy inline tips di sana, atau deploy jalur di managed-settings.json on-disk.
• label: awalan Claude Code menampilkan sebelum tips dari pengaturan pengguna, --settings, dan terkelola, hingga 40 karakter. Default adalah Tip, awalan yang sama seperti tips bawaan, dan tips dari pengaturan proyek dan lokal selalu menggunakannya.
• excludeDefault: atur ke true untuk menyembunyikan tips bawaan dan hanya menampilkan milik Anda. Ketika Claude Code tidak dapat memuat salah satu tips Anda, misalnya karena tipsFile tidak ada atau setiap entri tidak valid, ia menjaga rotasi bawaan daripada spinner kosong.

Ketika lebih dari satu file pengaturan mengatur kunci, Claude Code menampilkan tips dari semuanya dan mengambil tipsFile, label, dan excludeDefault dari mana pun pengaturan terkelola, flag --settings, dan pengaturan pengguna adalah yang tertinggi-preseden yang mengatur masing-masing.

Contoh ini, dalam pengaturan pengguna Anda, menambahkan tip string biasa dan tip objek ke rotasi di bawah awalan Acme tip:

{
  "spinnerTipsOverride": {
    "label": "Acme tip",
    "tips": [
      "Run /review before opening a PR",
      {
        "id": "gateway-errors",
        "text": "Seeing 5xx errors? Check the gateway status page first",
        "cooldownSessions": 5,
        "priority": 2
      }
    ]
  }
}

Setiap field dalam contoh mengubah satu hal tentang cara Claude Code menampilkan tips:

• label: Claude Code menampilkan kedua tips sebagai Acme tip: ... daripada Tip: ....
• String biasa: Claude Code memberikannya default, jadi dapat muncul lagi di sesi berikutnya.
• id: Claude Code mengetik riwayat tampilan tip kedua pada gateway-errors, jadi cooldown masih berlaku setelah Anda menambah atau mengurutkan ulang tips.
• cooldownSessions: setelah Claude Code menampilkan tip gateway-errors, tidak menampilkan tip itu lagi sampai lima sesi kemudian.
• priority: ketika tip gateway-errors dan tip lain belum ditampilkan untuk jumlah sesi yang sama, misalnya ketika tidak ada yang ditampilkan, Claude Code menampilkan gateway-errors terlebih dahulu. String biasa memiliki prioritas default, 0.

Saat Claude bekerja, Claude Code menampilkan tips Anda dalam spinner dengan awalan Anda, seperti Acme tip: Run /review before opening a PR.

spinnerVerbs

Saat giliran sedang berlangsung, spinner menampilkan kata kerja yang berputar seperti "Accomplishing", "Architecting", atau "Baking". Gunakan kunci ini untuk menambahkan kata kerja Anda sendiri ke rotasi itu atau ganti daftar bawaan dengan milik Anda.

• Scope: Any file
• Type: object dengan array verbs string dan mode, salah satu dari:
  • "append": Claude Code menambahkan kata kerja Anda ke set bawaan
  • "replace": Claude Code hanya menampilkan kata kerja Anda
• Default: unset, jadi Claude Code menggunakan kata kerja bawaan

Contoh ini menambahkan dua kata kerja ke set bawaan:

{
  "spinnerVerbs": {
    "mode": "append",
    "verbs": ["Pondering", "Crafting"]
  }
}

Dalam mode "replace" dengan array verbs kosong, Claude Code menjaga kata kerja bawaan.

statusLine

Jalankan perintah Anda sendiri untuk merender status line di bawah prompt dengan konteks seperti model, biaya, atau cabang git. Field opsional menyesuaikan spasi, menambahkan re-run berkala, dan menyembunyikan indikator mode vim bawaan ketika skrip Anda merender vim.mode sendiri.

• Scope: Any file. Ketika allowManagedHooksOnly aktif, atau disableAllHooks diatur di luar pengaturan terkelola, hanya nilai pengaturan terkelola yang berjalan.
• Type: object dengan type diatur ke "command" dan string command, ditambah padding opsional sebagai jumlah karakter, refreshInterval sebagai jumlah detik, minimum 1, dan hideVimModeIndicator sebagai Boolean
• Default: unset, jadi tidak ada status line

Contoh ini mencetak nama model dan penggunaan konteks, dan menambahkan dua karakter spasi horizontal:

{
  "statusLine": {
    "type": "command",
    "command": "jq -r '\"[\\(.model.display_name)] \\(.context_window.used_percentage // 0)% context\"'",
    "padding": 2
  }
}

Contoh memerlukan jq terinstal dan berjalan dalam shell. Untuk PowerShell dan setara Git Bash, lihat Windows configuration; untuk setup lengkap, lihat Manually configure a status line.

subagentStatusLine

Ketika Claude menjalankan subagents, Claude Code mencantumkannya dalam tampilan tugas di bawah prompt, satu baris per subagent menampilkan name · description · token count. Kunci ini memungkinkan Anda menjalankan perintah Anda sendiri untuk menulis ulang baris tersebut, misalnya untuk menampilkan penggunaan konteks setiap subagent sebagai persentase. Pada setiap refresh, Claude Code mengirim baris yang terlihat sebagai satu objek JSON di stdin, dengan array tasks membawa id, name, status, model, tokenCount, dan lainnya setiap subagent, dan mengganti baris untuk setiap id yang Anda tulis kembali sebagai baris {"id", "content"}. Baris yang tidak Anda tulis kembali menjaga rendering default.

• Scope: Any file. Ketika allowManagedHooksOnly aktif, atau disableAllHooks diatur di luar pengaturan terkelola, hanya nilai pengaturan terkelola yang berjalan.
• Type: object dengan type diatur ke "command" dan string command
• Default: unset, jadi Claude Code merender baris default

{
  "subagentStatusLine": {
    "type": "command",
    "command": "jq -c '.tasks[] | {id, content: \"\\(.name): \\(.tokenCount) tokens\"}'"
  }
}

Lihat Subagent status lines.

syntaxHighlightingDisabled

Claude Code mewarnai kode berdasarkan bahasa dalam diff, blok kode, dan pratinjau file yang ditampilkan di terminal, dengan highlighter bawaannya. Atur kunci ini ke true untuk menampilkannya sebagai teks biasa, misalnya jika warna bertentangan dengan tema terminal Anda atau memperlambat pembaca layar.

• Scope: Any file
• Type: Boolean
  • true: Claude Code mematikan penyorotan sintaks dalam diff, blok kode, dan pratinjau file
  • false: Claude Code menyoroti sintaks
• Default: false

{
  "syntaxHighlightingDisabled": true
}

terminalProgressBarEnabled

Beberapa terminal dapat menampilkan indikator kemajuan di tab atau di taskbar untuk program yang berjalan di dalamnya. Saat Claude bekerja, Claude Code melaporkan status sedang berlangsung ke terminal, sehingga Anda dapat melihat dari tab atau jendela lain apakah sesi masih sibuk. Indikator tetap terlihat setelah giliran berakhir sementara subagents latar belakang atau dynamic workflows masih berjalan, dan jelas setelah sesi idle.

Claude Code melaporkannya hanya di terminal yang mendukung indikator: ConEmu, Ghostty 1.2.0 atau lebih baru, dan iTerm2 3.6.6 atau lebih baru. Atur kunci ini ke false untuk menghentikan Claude Code melaporkannya. Muncul di /config sebagai Terminal progress bar.

• Scope: Any file. Nilai di ~/.claude.json dari versi yang lebih lama berlaku ketika tidak ada file pengaturan yang mengaturnya.
• Type: Boolean
  • true: Anda melihat progress bar terminal di terminal yang mendukungnya
  • false: Claude Code menyembunyikan progress bar terminal
• Default: true

{
  "terminalProgressBarEnabled": false
}

terminalTitleFromRename

Claude Code mengatur judul tab terminal Anda. Secara default menggunakan judul yang dihasilkan dari percakapan, dan setelah Anda memberi sesi nama dengan /rename atau --name, tab menampilkan nama itu. Atur kunci ini ke false untuk menjaga judul yang dihasilkan di tab bahkan setelah Anda memberi nama sesi. Nama itu sendiri masih berlaku, jadi /resume <name> dan pemilih sesi menemukannya.

• Scope: Any file
• Type: Boolean
  • true: judul tab terminal menampilkan nama sesi yang Anda atur
  • false: tab menjaga judul yang Claude Code hasilkan dari percakapan Anda
• Default: true

{
  "terminalTitleFromRename": false
}

Untuk menghentikan Claude Code memperbarui judul terminal sama sekali, atur CLAUDE_CODE_DISABLE_TERMINAL_TITLE ke 1.

theme

Pilih tema warna untuk antarmuka. Muncul di /config sebagai Theme.

• Scope: Any file. Nilai di ~/.claude.json dari versi yang lebih lama berlaku ketika tidak ada file pengaturan yang mengaturnya.
• Type: string, salah satu dari:
  • "auto": cocok dengan latar belakang terminal Anda yang terang atau gelap
  • "dark": tema gelap
  • "light": tema terang
  • "dark-daltonized": tema gelap dengan warna ramah buta warna
  • "light-daltonized": tema terang dengan warna ramah buta warna
  • "dark-ansi": tema gelap hanya menggunakan palet warna ANSI terminal Anda
  • "light-ansi": tema terang hanya menggunakan palet warna ANSI terminal Anda
  • "custom:<slug>" atau "custom:<plugin-name>:<slug>": tema kustom dari ~/.claude/themes/ atau plugin
• Default: "dark"

{
  "theme": "light-daltonized"
}

Lihat Create a custom theme.

timeFormat

Pilih cara Claude Code menulis waktu yang ditampilkan dalam antarmuka, seperti done 6:05 PM di akhir setiap pesan durasi giliran dan stempel waktu dalam transcript viewer. Untuk memilih preset, jalankan /config dan atur Time format. Memerlukan Claude Code v2.1.257 atau lebih baru.

• Scope: Any file
• Type: string, salah satu dari:
  • "auto": sama dengan unset; setiap waktu menjaga format bawaan, yang mengikuti lokal Anda pada pesan durasi giliran
  • "12-hour": jam 12 jam
  • "24-hour": jam 24 jam
  • "24-hour-utc": jam 24 jam di UTC dengan Z setelah menit, seperti 18:05Z; Claude Code mengabaikan timeZone untuk preset ini
  • Pola strftime seperti "%H:%M": Claude Code menulis setiap waktu dengan pola. Nilai apa pun yang berisi % adalah pola, dan nilai apa pun di luar preset menghitung sebagai "auto"
• Default: "auto"

{
  "timeFormat": "24-hour"
}

/config hanya menawarkan preset, jadi untuk menggunakan pola strftime, tambahkan kunci ke file pengaturan. Contoh ini menampilkan setiap waktu sebagai jam 24 jam dua digit:

{
  "timeFormat": "%H:%M"
}

Pesan durasi giliran dan transcript viewer kemudian menampilkan waktu seperti 18:05. Dalam transcript viewer, pola adalah seluruh stempel waktu, jadi tambahkan direktif tanggal ketika Anda menginginkan tanggal di sana. Contoh ini menempatkan tanggal di depan jam:

{
  "timeFormat": "%Y-%m-%d %H:%M"
}

Permukaan yang sama kemudian menampilkan waktu seperti 2026-09-01 18:05.

timeZone

Tampilkan waktu dalam antarmuka di zona waktu selain sistem Anda. Atur ke nama zona waktu IANA, seperti "UTC" atau "Europe/Dublin". Waktu yang timeFormat kontrol kemudian menampilkan di zona ini. Jika timeFormat adalah "24-hour-utc", waktu tetap di UTC dan Claude Code mengabaikan kunci ini. /config tidak memiliki baris untuk kunci ini, jadi atur dalam file pengaturan. Memerlukan Claude Code v2.1.257 atau lebih baru.

• Scope: Any file
• Type: string, nama zona waktu IANA. Ketika Claude Code tidak mengenali nama, menggunakan zona waktu sistem Anda
• Default: unset, jadi waktu menampilkan di zona waktu sistem Anda

{
  "timeZone": "Europe/Dublin"
}

tui

Pilih renderer UI terminal. Gunakan "fullscreen" untuk renderer alt-screen bebas flicker fullscreen dengan scrollback virtual, atau "default" untuk renderer main-screen klasik. Menjalankan /tui fullscreen atau /tui default menulis kunci ini untuk Anda.

• Scope: Any file
• Type: string, salah satu dari:
  • "default": renderer main-screen klasik
  • "fullscreen": renderer alt-screen bebas flicker dengan scrollback virtual
• Default: unset, jadi Claude Code memilih renderer untuk Anda
• Per-session overrides: CLAUDE_CODE_NO_FLICKER dan CLAUDE_CODE_DISABLE_ALTERNATE_SCREEN mengambil alih kunci ini untuk satu sesi: CLAUDE_CODE_NO_FLICKER=1 mengaktifkan fullscreen, dan CLAUDE_CODE_NO_FLICKER=0 atau CLAUDE_CODE_DISABLE_ALTERNATE_SCREEN=1 mematikannya; ketika keduanya diatur, Claude Code mematikannya