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 menautkan ke entrinya. Scope mencantumkan file tempat kunci dapat digunakan: User adalah ~/.claude/settings.json, Project adalah .claude/settings.json, Local adalah .claude/settings.local.json, dan Managed adalah apa yang organisasi Anda terapkan. Any file berarti keempat file tersebut, dan Global config berarti ~/.claude.json.

Model dan respons

Pilih model mana yang digunakan Claude Code dan cara meresponsnya. Untuk cara pengaturan ini berinteraksi dengan perintah /model dan variabel lingkungan, lihat Konfigurasi model.

advisorModel

Pilih model mana yang menjawab ketika Claude memanggil alat advisor di sisi server. Biarkan tidak disetel untuk mematikan advisor. Advisor harus setidaknya sama mampu dengan model utama Anda. Lihat Pilih model advisor untuk pasangan yang diterima dan apa yang terjadi ketika Anda memilih yang tidak diterima.

Anda biasanya tidak mengedit kunci ini dengan tangan. Jalankan /advisor untuk membuka pemilih yang menunjukkan pilihan saat ini, model yang dapat memberikan saran, dan Tidak ada advisor. Claude Code menyimpan pilihan Anda ke kunci ini di ~/.claude/settings.json. Jika Anda memilih dari klien Remote Control atau dalam sesi yang terpasang ke pekerja jarak jauh, pilihan berlaku hanya untuk sesi itu dan tidak mengubah kunci ini.

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

• Scope: Any file
• Type: string, salah satu alias "fable", "opus", atau "sonnet", yang diselesaikan ke versi default Claude Code saat ini dari keluarga model itu, atau ID model lengkap seperti "claude-opus-5-5"
• Default: tidak disetel, jadi advisor dimatikan
• Per-session overrides: --advisor mengambil alih kunci ini untuk satu sesi. CLAUDE_CODE_DISABLE_ADVISOR_TOOL mematikan advisor, dan kunci ini tidak dapat menghidupkannya kembali

{
  "advisorModel": "opus"
}

Kunci ini tidak berpengaruh pada penyedia tempat advisor tidak tersedia, seperti Amazon Bedrock dan Claude Platform di AWS. "fable" memerlukan akses Fable.

alwaysThinkingEnabled

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

Pada model yang selalu berpikir, 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 daripada mematikan thinking, jadi model adaptive-reasoning mungkin masih berpikir. Dengan thinking dimatikan di Anthropic API, Claude Code mengirim effort high daripada level yang lebih tinggi ke model yang diketahui tidak menerima kombinasi itu, seperti Opus 5.

• Scope: Any file
• Type: Boolean
  • true: tidak berpengaruh; thinking sudah aktif
  • false: Claude Code mematikan extended thinking untuk setiap sesi
• Default: tidak disetel, jadi thinking aktif untuk model yang mendukungnya
• Per-session overrides: MAX_THINKING_TOKENS mengambil alih kunci ini untuk satu sesi: 0 mematikan thinking, di bawah batasan model dan penyedia yang sama seperti false, dan nilai positif menghidupkan 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, subagents, skills, dan advisor. Daftar terkelola membatasi /model, --model, dan kunci model dalam file pengembang sendiri; model di luar itu tidak dapat dipilih. Dengan pencocokan awalan default, ini tidak menyentuh opsi Default dengan sendirinya; pasangkan dengan enforceAvailableModels untuk itu.

• Scope: Any file. Terapkan dalam pengaturan terkelola untuk memberlakukannya untuk organisasi.
• Type: array alias model atau ID
• Default: tidak disetel, jadi setiap model tersedia

Contoh ini memungkinkan orang memilih hanya model Sonnet dan Haiku:

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

Entri ID model seperti "claude-opus-5" juga memungkinkan versi yang lebih baru yang memperpanjangnya, seperti Opus 5.5. Untuk memblokir salah satu versi itu, gunakan deniedModels. Untuk membuat setiap entri ID model hanya memungkinkan versi yang dinamainya, gunakan availableModelsMatch. Lihat Batasi pemilihan model. Untuk ID penyedia pihak ketiga, lihat Sematkan model untuk deployment pihak ketiga.

availableModelsMatch

Pilih bagaimana entri availableModels cocok dengan ID model. Secara default entri ID model juga memungkinkan versi yang lebih baru yang memperpanjangnya, jadi "claude-opus-5" memungkinkan Opus 5.5. Dengan "exact", setiap entri ID model hanya memungkinkan versi yang dinamainya, jadi versi yang lebih baru dari model itu tetap diblokir sampai Anda mencantumkannya. Memerlukan Claude Code v2.1.283 atau lebih baru.

• Scope: Managed. Claude Code mengabaikan kunci dalam pengaturan pengguna, proyek, dan lokal serta dalam --settings, dengan peringatan
• Type: string, salah satu dari:
  • "prefix": entri ID model memungkinkan versinya dan ID model apa pun yang memperpanjangnya dengan segmen lain
  • "exact": entri ID model hanya memungkinkan versi yang dinamainya, jadi "claude-opus-5" memungkinkan Opus 5 tetapi bukan claude-opus-5-5. Entri seperti "claude-opus-4-5" juga memungkinkan ID model Anthropic bertanggalnya, claude-opus-4-5-20251101. Alias keluarga seperti "opus" masih memungkinkan seluruh keluarga, dan entri best, opusplan, dan default diabaikan
• Default: "prefix"

Contoh ini memungkinkan Opus 5 dan Sonnet 5 dan tidak ada 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 kapan pun daftar menamai setidaknya satu model atau keluarga. Lihat Blokir model atau versi tertentu.

deniedModels

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

• Scope: Managed. Claude Code mengabaikan kunci dalam pengaturan pengguna, proyek, dan lokal serta dalam --settings, dengan peringatan
• Type: array alias model atau ID
  • Alias keluarga seperti "opus" memblokir setiap model dalam keluarga itu
  • ID model seperti "claude-opus-5-5" memblokir versi itu dalam setiap ejaan, termasuk ID tanggal dan 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 disetel, jadi tidak ada model yang diblokir

Contoh ini memungkinkan model Opus dan Sonnet dan memblokir Opus 5.5:

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

Lihat Blokir model atau versi tertentu.

effortLevel

Tetapkan tingkat effort default untuk model yang belum Anda simpan tingkatnya. Level yang lebih rendah lebih cepat dan lebih murah pada tugas yang mudah, dan level yang lebih tinggi bernalar lebih dalam pada masalah yang kompleks.

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

Dalam file pengaturan yang sama, Claude Code menggunakan level yang disimpan model daripada kunci ini. modelSettings menyatakan preseden lintas file.

Dalam sesi yang terpasang ke pekerja jarak jauh, dalam jalankan -p, dan dalam Agent SDK, /effort berlaku hanya untuk sesi itu. Sesuaikan tingkat effort mencantumkan pilihan interaktif yang juga berlaku hanya untuk sesi itu. Pesan yang dicetak /effort mengatakan mana yang terjadi.

• Scope: Any file
• Type: string, salah satu dari:
  • "low": penalaran paling sedikit, untuk tugas pendek, terbatas, sensitif latensi yang bukan sensitif intelijen
  • "medium": mengurangi penggunaan token untuk pekerjaan sensitif biaya yang dapat menukar beberapa intelijen
  • "high": menyeimbangkan penggunaan token dan intelijen
  • "xhigh": penalaran lebih dalam dengan pengeluaran token yang lebih tinggi
• Default: tidak disetel
• Per-session overrides: --effort mengambil alih kunci ini untuk satu sesi, dan CLAUDE_CODE_EFFORT_LEVEL mengambil alih keduanya

{
  "effortLevel": "xhigh"
}

Dalam file pengaturan pengguna Anda, ~/.claude/settings.json, kunci ini adalah bentuk yang lebih lama /effort ditulis sebelum menyimpan level per model, dan terus berlaku di mana ia berlaku sebelumnya, pada Opus 5, Fable 5.1, dan model yang lebih awal. Opus 5.5 dan model yang dirilis setelahnya mengabaikannya dan mulai pada default mereka sendiri sampai Anda menyimpan level untuk mereka, yang ditulis /effort di bawah modelSettings. Dalam pengaturan proyek, lokal, dan terkelola, dan dengan --settings, kunci ini berlaku untuk setiap model.

enforceAvailableModels

Pemilih /model memiliki opsi Default, dan default model setting menjelaskan model yang diselesaikannya. Daftar availableModels membatasi model yang dapat Anda beri nama, tetapi dengan pencocokan awalan default itu tidak memetakan ulang default tipe akun Anda, jadi Default masih dapat diselesaikan ke model di luar daftar. Kunci ini menutup celah itu. Memerlukan Claude Code v2.1.175 atau lebih baru.

Ketika organisasi Anda menerapkan pengaturan terkelola apa pun, Claude Code membaca kunci ini dari sumber terkelola saja dan mengabaikannya dalam file lain Anda.

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

• Scope: Any file
• Type: Boolean
  • true: ketika Default akan diselesaikan ke model di luar availableModels, Claude Code menyelesaikannya ke model pertama yang tersedia dalam daftar
  • false: kunci ini tidak mengubah cara Default diselesaikan
• Default: false

Contoh ini membatasi pilihan bernama ke model Sonnet dan Haiku dan membuat Default diselesaikan ke yang pertama dari mereka yang tersedia:

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

Kunci ini tidak berpengaruh ketika availableModels tidak disetel atau kosong. Lihat Berlakukan daftar untuk model Default. Memerlukan Claude Code v2.1.175 atau lebih baru.

fallbackModel

Beri nama model cadangan untuk Claude Code coba, secara berurutan, ketika model utama Anda kelebihan beban atau tidak tersedia. Claude Code beralih ke model yang tersedia berikutnya dalam rantai untuk sisa giliran dan menunjukkan pemberitahuan. Tanpa rantai, Claude Code mencoba ulang model yang sama dan kemudian menampilkan kesalahan server, dan Anda mencoba ulang atau beralih model sendiri.

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

• Scope: Any file
• Type: array alias model atau ID; "default" berkembang ke model default
• Default: tidak disetel, jadi permintaan yang gagal tidak dicoba ulang pada model lain
• Per-session overrides: --fallback-model mengambil alih kunci ini untuk satu sesi

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

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

Tidak seperti sebagian besar pengaturan array, kunci ini tidak menggabungkan di seluruh file pengaturan: file dengan preseden tertinggi yang mendefinisikannya memasok seluruh rantai. Jika file proyek Anda menetapkan ["claude-sonnet-5"] dan file pengguna Anda menetapkan ["claude-haiku-4-5"], rantainya adalah ["claude-sonnet-5"] saja. Claude Code menyimpan paling banyak tiga model yang diizinkan berbeda dari daftar dan mengabaikan sisanya. Lihat Rantai model fallback.

fastMode

Hidupkan fast mode untuk sesi tempat tersedia, untuk pekerjaan interaktif seperti iterasi cepat atau debugging langsung tempat Anda menginginkan kecepatan dengan biaya yang lebih tinggi per token. Anda biasanya tidak mengedit kunci ini dengan tangan: menjalankan /fast menulis fastMode: true ke ~/.claude/settings.json, dan menjalankannya lagi untuk mematikan fast mode menghapus kunci. Fast mode berjalan hanya pada Opus 5.5, Opus 5, dan Opus 4.8: menghidupkannya dari model lain beralih Anda ke Opus, dan beralih ke model yang tidak didukung mematikannya. Lihat Beralih model saat fast mode aktif.

• Scope: Any file
• Type: Boolean
  • true: Claude Code menghidupkan fast mode untuk sesi tempat tersedia
  • false: fast mode tetap mati
• Default: tidak disetel, jadi fast mode mati
• Per-session overrides: CLAUDE_CODE_DISABLE_FAST_MODE mematikan fast mode untuk satu sesi, dan kunci ini tidak dapat menghidupkannya kembali

{
  "fastMode": true
}

fastModePerSessionOptIn

Biasanya, menjalankan /fast menyimpan fastMode ke pengaturan pengguna seseorang, jadi fast mode aktif di awal setiap sesi yang lebih baru. Tetapkan kunci ini ke true untuk menghentikan itu: fastMode: true yang disimpan tidak lagi menghidupkan fast mode di awal sesi, dan setiap orang harus menjalankan /fast dalam setiap sesi yang mereka inginkan. Claude Code meninggalkan kunci fastMode dalam file mereka, jadi mematikan kunci ini mengembalikan perilaku lama.

Pemilik pada paket Team atau Enterprise dapat menerapkannya di seluruh organisasi melalui pengaturan terkelola server. Ketika pengaturan terkelola menetapkan kunci, /fast on ditolak di luar sesi terminal interaktif dan melaporkan bahwa organisasi Anda telah menonaktifkan fast mode. Itu mencakup mode non-interaktif, ekstensi VS Code, dan sesi cloud.

• Scope: Any file
• Type: Boolean
  • true: fastMode: true yang disimpan tidak lagi menghidupkan fast mode di awal sesi, jadi setiap orang menjalankan /fast dalam setiap sesi yang mereka inginkan; fastMode: true yang dilewatkan dengan --settings masih dihitung untuk sesi itu kecuali pengaturan terkelola menetapkan kunci ini
  • false: fastMode: true yang disimpan menghidupkan fast mode di awal setiap sesi yang lebih baru
• Default: false

{
  "fastModePerSessionOptIn": true
}

Lihat Memerlukan opt-in per sesi.

language

Buat Claude merespons dalam bahasa selain Inggris secara default. Tidak ada daftar tetap untuk respons: Claude Code meneruskan nilai secara harfiah ke Claude sebagai instruksi untuk selalu merespons dalam bahasa itu, jadi nama bahasa apa pun yang dapat dibaca Claude berfungsi. Claude Code tidak memeriksa nilai, jadi nama yang salah eja mencapai Claude seperti yang ditulis daripada menghasilkan kesalahan. Nilai yang sama menetapkan bahasa untuk voice dictation, yang memiliki daftar tetap bahasa dictation yang didukung, dan untuk judul sesi yang dibuat secara otomatis.

• Scope: Any file
• Type: string, nama bahasa apa pun, seperti "japanese", "spanish", atau "french"; Claude Code tidak memvalidasinya
• Default: tidak disetel; judul sesi kemudian cocok dengan bahasa percakapan Anda

{
  "language": "japanese"
}

maxEffortLevel

Batasi tingkat effort yang dapat digunakan sesi, meninggalkan level yang lebih rendah tersedia. Level yang lebih tinggi apa pun berjalan pada batas sebagai gantinya, termasuk dari /effort, pemilih /model, --effort, CLAUDE_CODE_EFFORT_LEVEL, frontmatter effort skill atau subagent, atau default model itu sendiri. Claude Code menerapkan batas itu sendiri sebelum setiap permintaan, jadi itu berlaku pada setiap penyedia, termasuk Amazon Bedrock, Agent Platform Google Cloud, dan Microsoft Foundry. Memerlukan Claude Code v2.1.267 atau lebih baru.

• Scope: Any file. Terapkan dalam pengaturan terkelola untuk memberlakukannya untuk organisasi. Ketika beberapa scope menetapkan batas, yang terendah berlaku, jadi batas yang ditetapkan dalam satu scope tidak dapat dinaikkan dari scope lain
• Type: string, salah satu dari "low", "medium", "high", "xhigh", atau "max". Nilai "max" tidak menetapkan batas
• Default: tidak disetel, jadi tidak ada batas yang berlaku
• Per-model caps: tambahkan maxEffortLevel ke entri modelSettings model. Entri itu menggantikan kunci ini untuk model saja dalam sumber pengaturan yang menetapkan keduanya, seperti pengaturan pengguna Anda atau satu sumber terkelola. Tetapkan "max" di sana untuk mengecualikan model dari batas sumber itu; Claude Code masih menerapkan batas dari sumber lain

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

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

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

model

Tetapkan model yang digunakan setiap sesi baru, jadi Anda tidak harus memilih satu dengan /model setiap kali. Menetapkannya di sini tidak menghentikan Anda dari beralih di tengah sesi. Jika admin Anda menetapkan model default organisasi untuk mengesampingkan pilihan pengguna, Anda mendapatkan model itu bahkan ketika Anda menetapkan kunci ini dalam pengaturan pengguna, proyek, atau lokal.

• Scope: Any file
• Type: string, alias model atau ID model lengkap
• Default: tidak disetel, jadi Claude Code menggunakan model default akun Anda
• Per-session overrides: --model mengambil alih ANTHROPIC_MODEL, dan keduanya mengambil alih kunci ini untuk satu sesi, termasuk atas model terkelola; daftar availableModels masih berlaku untuk pilihan

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

Nilai di sini mengalahkan ANTHROPIC_DEFAULT_MODEL, yang Claude Code gunakan hanya ketika tidak ada yang lain memilih model.

modelOverrides

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

• Scope: Any file
• Type: object memetakan ID model ke ID model penyedia
• Default: tidak disetel

Contoh ini merutekan setiap panggilan untuk Opus 4.6 ke profil inferensi Bedrock bernama:

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

Lihat Ganti ID model per versi.

modelPicker

Daftar model yang ditawarkan pemilih /model, dalam urutan yang Anda tulis dan di bawah label yang Anda pilih, jadi pemilih mencantumkan model yang dijalankan organisasi Anda, setelah barisan bawaan atau sebagai gantinya. model setiap baris diambil secara harfiah, jadi itu menerima apa pun yang diterima --model: alias seperti opus, ID model Anthropic, atau ID format penyedia untuk Amazon Bedrock, Agent Platform Google Cloud, Microsoft Foundry, atau gateway LLM. Memerlukan Claude Code v2.1.242 atau lebih baru.

• Scope: User or managed. Claude Code membaca kunci dari pengaturan terkelola, --settings, dan pengaturan pengguna, dan mengabaikannya dalam pengaturan proyek dan lokal jadi repositori yang Anda klon tidak dapat memberi label ulang pemilih. Yang tertinggi dari ketiga itu yang menetapkan kunci memasok seluruh barisan, dan Claude Code tidak pernah menggabungkan barisan dari dua sumber.
• Type: object dengan array options dari baris dan Boolean replaceBuiltInOptions opsional
• Default: tidak disetel, jadi pemilih menunjukkan barisan bawaan

Contoh ini menambahkan dua deployment Bedrock setelah barisan bawaan, di bawah 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"
      }
    ]
  }
}

Bidang untuk modelPicker

Kunci mengambil dua bidang, satu untuk baris itu sendiri dan satu untuk apakah mereka menggantikan barisan bawaan atau menambahnya.

Entri dalam options juga dapat membawa behavesAs string opsional di samping model nya, yang memerlukan v2.1.257 atau lebih baru. Tetapkan ke ID model yang sudah diketahui versi Claude Code Anda, seperti claude-opus-4-8, pada entri yang model nya lebih baru dari versi Anda. Claude Code kemudian menerapkan kemampuan model yang diketahui itu dan default effort ke entri daripada 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 lain: barisan bawaan, baris yang ditambahkannya untuk entri availableModels, model yang ditemukan penemuan gateway, dan ANTHROPIC_CUSTOM_MODEL_OPTION. Dengan itu mati, Claude Code melewati model yang tercantum yang sudah dicakup barisan bawaan. Label mengubah apa yang ditunjukkan pemilih, bukan model mana yang dijalankan Claude Code.

Daftar availableModels masih berlaku untuk baris ini. Sebelum Anda menambahkan model yang tercantum ke daftar, baca Perilaku penggabungan: ID model tertentu mempersempit entri wildcard keluarganya. Claude Code juga memeriksa setiap baris terhadap sesi sebelum menunjukkan pemilih:

• Dijatuhkan: baris yang tidak dapat disajikan Claude Code, seperti model yang pensiun atau model yang tidak memiliki akses organisasi Anda
• Diarsir: baris yang tidak dapat Anda pilih belum, ditampilkan dengan alasan
• Tidak ada baris yang bertahan: Claude Code menyimpan barisan bawaan, disaring oleh daftar seperti biasa

Claude Code menjatuhkan baris yang tidak dapat diuraikan dan menyimpan sisanya. Lihat Perbaiki file pengaturan yang rusak.

modelPricing

Laporkan pengeluaran pada tarif yang dibayar organisasi Anda daripada harga daftar. Tetapkan ketika organisasi Anda memiliki tarif kontrak, jadi angka dolar yang dilihat pengembang cocok dengan tagihan Anda. Claude Code menerapkan tarif dalam /usage, baris status, total_cost_usd Agent SDK, batas --max-budget-usd, dan OpenTelemetry metrik biaya dan acara. Anda memasok tarif: Claude Code tidak membacanya dari kontrak atau Claude Console Anda. Memerlukan Claude Code v2.1.242 atau lebih baru.

• Scope: Managed. Terapkan kunci melalui pengaturan terkelola server, kebijakan MDM, file managed-settings.json, atau pembantu kebijakan. Claude Code mengabaikannya dalam pengaturan pengguna, proyek, dan lokal, dalam --settings, dan di Windows dalam registri HKCU yang dapat ditulis pengguna. Dengan pengaturan terkelola server, setiap sesi melaporkan biaya pada harga daftar sampai pengambilan pengaturan sesi itu telah mengkonfirmasi pengaturan. Aplikasi host yang menyematkan Claude Code dan menetapkan CLAUDE_CODE_PROVIDER_MANAGED_BY_HOST dapat memasok tabel miliknya sendiri melalui opsi SDK managedSettings, yang Claude Code gunakan hanya ketika tidak ada sumber terkelola yang menetapkan kunci dan hanya dalam Claude Code v2.1.246 atau lebih baru.
• Type: object dengan multiplier opsional dan peta overrides opsional
• Default: tidak disetel, jadi Claude Code melaporkan harga daftar kecuali aplikasi host memasok tabel

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

Contoh ini menetapkan tarif kontrak untuk Sonnet 4.6 dan kemudian mengurangi setiap angka, baris Sonnet disertakan, sebesar 15%:

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

Tetapkan multiplier di atas 1, hingga 10, untuk menandai setiap angka. Markup memerlukan Claude Code v2.1.271 atau lebih baru. Versi yang lebih awal mengabaikan multiplier di atas 1 dengan peringatan dan menyimpan sisa pengaturan.

Untuk langkah-langkahnya, termasuk cara mengkonfirmasi tarif berlaku, lihat Laporkan pengeluaran pada tarif kontrak Anda.

Bidang untuk modelPricing

Claude Code menggunakan tarif baris persis seperti yang Anda tulis, tanpa menambahkan surcharge fast-mode atau tarif inferensi hanya AS. Jika Anda juga menetapkan multiplier, Claude Code menerapkannya di atas tarif baris. Claude Code menjatuhkan baris dengan tarif yang tidak dapat diuraikan, atau multiplier yang tidak dapat diuraikan, dan menyimpan sisanya; lihat Perbaiki file pengaturan yang rusak.

Model mana yang berlaku baris modelPricing

Claude Code memutuskan model mana yang berlaku baris dari kunci baris:

• ID model bawaan: kunci yang digunakan Claude Code itu sendiri untuk model bawaan, apakah kunci itu ID model itu sendiri, seperti claude-sonnet-4-6, atau ID Bedrock, Agent Platform, atau Foundry-nya. Claude Code menerapkan baris ke setiap ID snapshot tanggal dan ID khusus penyedia model itu.
• Kunci lain apa pun: kunci yang bukan ID model bawaan, seperti alias model gateway. Claude Code menerapkan baris ke ID itu saja. Ketika ID model cocok dengan salah satu kunci Anda persis dan juga jatuh di bawah baris yang dikunci oleh ID model bawaan, Claude Code menggunakan kecocokan persis.
• Profil inferensi aplikasi Bedrock: setelah Claude Code telah menyelesaikan profil ke model yang dirutekannya, melalui peta modelOverrides Anda atau pencarian bedrock:GetInferenceProfile, Claude Code menerapkan baris model itu ke profil.

modelSettings

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

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

Edit kunci dengan tangan untuk mengubah atau menghapus level yang Anda simpan.

effortLevel model di sini mengambil preseden atas effortLevel tingkat atas dalam file pengaturan yang sama. Di seluruh file, Claude Code menyelesaikan setiap model secara terpisah: file pengaturan dengan preseden tertinggi yang menetapkan effortLevel untuk model itu atau effortLevel tingkat atas yang berlaku untuk model itu memutuskan, jadi effortLevel dalam pengaturan terkelola mengalahkan level yang Anda simpan dalam pengaturan pengguna. Sesuaikan tingkat effort mencantumkan apa lagi yang dapat mengesampingkan level yang disimpan, seperti --effort saat peluncuran.

Untuk membatasi effort satu model daripada menetapkan levelnya, tambahkan bidang maxEffortLevel ke entri model itu. Bidang memerlukan Claude Code v2.1.267 atau lebih baru.

• Scope: Any file
• Type: object yang memetakan nama model ke object dengan salah satu dari bidang 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 jendela yang disesuaikan untuk model. /autocompact menyimpan di sini. Untuk model itu, nilai ini diutamakan daripada autoCompactWindow tingkat atas dalam file pengaturan yang sama. Memerlukan Claude Code v2.1.288 atau lebih baru
• Default: tidak disetel

Claude Code menulis setiap entri di bawah nama kanonik model, seperti claude-opus-5-5, dan mencocokkan alias model itu, tanggal-akhiran, [1m], dan ID khusus penyedia yang dikenali ke entri yang sama.

Contoh ini menyimpan Opus 5.5 pada high sementara model lain menggunakan level yang disimpan atau default mereka sendiri:

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

Jalankan /effort auto untuk menghapus level yang disimpan untuk model yang Anda gunakan. Claude Code meninggalkan entri lain dan effortLevel tingkat atas apa pun di tempat.

outputStyle

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

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

• Scope: Any file
• Type: string, nama bawaan atau kustom gaya output
• Default: tidak disetel, jadi Claude Code menggunakan gaya default

Contoh ini memilih gaya Explanatory bawaan, yang menambahkan wawasan pendidikan 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 pembantu yang dijalankan Claude Code secara inline dengannya. Masa pakai satu jam menjaga cache tetap hangat di seluruh jeda yang lebih lama, dan API menagih setiap penulisan cache pada tarif yang lebih tinggi daripada masa pakai lima menit. Memerlukan Claude Code v2.1.242 atau lebih baru.

• Scope: Any file
• Type: string, salah satu dari:
  • "5m": cache menyimpan selama lima menit
  • "1h": cache menyimpan selama satu jam
• Default: tidak disetel, jadi setiap permintaan percakapan utama mendapat masa pakai defaultnya
• Per-session overrides: FORCE_PROMPT_CACHING_5M mengambil alih segalanya, kemudian CLAUDE_CODE_PROMPT_CACHE_TTL, kemudian kunci ini, dan terakhir ENABLE_PROMPT_CACHING_1H

Contoh ini menyimpan percakapan utama pada masa pakai satu jam dan meninggalkan subagents pada lima menit:

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

Untuk apa biaya setiap masa pakai, lihat Masa pakai cache.

showThinkingSummaries

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

• Scope: Any file
• Type: Boolean
  • true: Anda melihat ringkasan thinking lengkap ketika Anda memperluas thinking dengan Ctrl+O
  • false: Anthropic API menyensor blok thinking dan Claude Code menunjukkan stub yang runtuh
• Default: false

{
  "showThinkingSummaries": true
}

Penyensoran mengubah hanya apa yang Anda lihat, bukan apa yang dihasilkan model. Untuk mengurangi pengeluaran thinking, turunkan anggaran atau matikan thinking sebagai gantinya.

subagentPromptCacheTtl

Pilih berapa lama prompt cache menyimpan permintaan yang dibuat Claude Code di luar percakapan utama. Kunci ini berlaku untuk subagents, workflows, dan permintaan latar belakang dan pembantu Claude Code sendiri, seperti pemadatan dan judul sesi. Masa pakai satu jam menjaga cache tetap hangat di seluruh jeda yang lebih lama, dan API menagih setiap penulisan cache pada tarif yang lebih tinggi daripada masa pakai lima menit. Memerlukan Claude Code v2.1.242 atau lebih baru.

• Scope: Any file
• Type: string, salah satu dari:
  • "5m": cache menyimpan selama lima menit
  • "1h": cache menyimpan selama satu jam
• Default: tidak disetel, jadi setiap permintaan ini mendapat masa pakai defaultnya
• Per-session overrides: FORCE_PROMPT_CACHING_5M mengambil alih segalanya, kemudian CLAUDE_CODE_SUBAGENT_PROMPT_CACHE_TTL, kemudian kunci ini, kemudian ENABLE_PROMPT_CACHING_1H, yang meminta masa pakai satu jam pada setiap permintaan. Untuk di mana nilai frontmatter subagent sendiri berada, lihat Pilih TTL sendiri

Contoh ini memberikan subagents dan permintaan lain di luar percakapan utama masa pakai satu jam:

{
  "subagentPromptCacheTtl": "1h"
}

Kunci ini mencakup permintaan yang tidak dicakup promptCacheTtl, jadi tetapkan keduanya untuk memilih masa pakai untuk setiap permintaan yang dibuat Claude Code. Untuk bagaimana cache subagent berbeda dari percakapan utama, lihat Subagents dan cache.

switchModelsOnFlag

Pilih apa yang terjadi ketika pengklasifikasi keamanan menandai permintaan: beralih ke model fallback dan lanjutkan, atau jeda sehingga Anda dapat memilih antara beralih dan mengedit prompt.

• Scope: Any file. Muncul dalam /config sebagai Switch models when a message is flagged, dengan opsi Switch automatically dan Ask each time.
• Type: Boolean
  • true: Claude Code beralih ke model fallback dan lanjutkan
  • false: dalam sesi interaktif Claude Code jeda sehingga Anda dapat memilih antara beralih dan mengedit prompt; di mana tidak ada dialog yang dapat ditampilkan, seperti jalankan -p, permintaan yang ditandai berakhir sebagai kesalahan
• Default: tidak disetel. Claude Code beralih secara otomatis, meskipun mungkin bertanya terlebih dahulu dalam sesi interaktif

{
  "switchModelsOnFlag": false
}

Lihat Tanya sebelum beralih.

ultracode

Mulai sesi dengan ultracode aktif. Dengan itu aktif, Claude merencanakan workflow untuk setiap tugas substansial daripada menunggu Anda meminta. Claude merencanakan workflows hanya ketika dynamic workflows diaktifkan untuk Anda dan model Anda mendukung effort xhigh. Kunci ini tidak mengubah tingkat effort sesi: ultracode berjalan pada level mana pun yang digunakan sesi. Claude Code membaca kunci ini tetapi tidak pernah menulisnya: /effort ultracode menghidupkan ultracode hanya untuk sesi saat ini.

• Scope: Any file
• Type: 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 disetel, jadi ultracode mati
• Per-session overrides: /effort ultracode menghidupkan ultracode untuk satu sesi tanpa kunci ini, dan /effort ultracode off mematikannya untuk satu sesi ketika kunci ini true. Flag --effort ultracode juga menghidupkannya 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 level itu tanpa mematikan ultracode. Ini dan bentuk /effort ultracode off memerlukan Claude Code v2.1.284 atau lebih baru. Sebelum v2.1.284, ultracode: true menjalankan sesi pada effort xhigh, dan batas effort di bawah xhigh membuat ultracode tidak tersedia. Permintaan kontrol apply_flag_settings Agent SDK juga menerima kunci.

Pengaturan izin

Tentukan apa yang dapat dilakukan Claude tanpa bertanya, mode izin mana yang digunakan saat sesi dimulai, 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 selalu meminta konfirmasi, dan tool mana yang diblokir, serta atur mode izin yang digunakan saat sesi dimulai. Setiap kunci permissions.* di bawah bersarang di bawah objek ini.

• Scope: Any file
• Type: objek dengan allow, ask, deny, additionalDirectories, blockReadsOutsideWorkingDirectories, defaultMode, 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.
• Type: Boolean
  • true: sama dengan tidak diatur; ketika auto mode tersedia, pengklasifikasi meninjau setiap perintah shell selama perencanaan alih-alih meminta persetujuan Anda, kecuali penghapusan jalur kritis. false di salah satu file ini masih mematikannya
  • 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
  }
}

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.

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

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.defaultMode

Atur mode izin yang digunakan saat sesi baru dimulai. Ketika Anda membiarkannya tidak diatur, sesi dimulai dalam default bawaan untuk surface Anda.

• 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.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. 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, kemudian perluas atau persempit apa yang dapat disentuh perintah bersandbox dengan sub-objek filesystem, network, dan credentials. Sandbox berjalan di macOS, Linux, dan WSL2.

• Scope: 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, jadi Claude Code menjalankan perintah tanpa sandbox

Ini mengaktifkan sandbox, melewati permintaan izin untuk perintah bersandbox, menjalankan docker di luar sandbox, membuka dua jalur penulisan tambahan, menyembunyikan file kredensial AWS Anda, dan pra-mengizinkan GitHub dan npm:

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

Ketika pengaturan terkelola menetapkan kunci Boolean seperti enabled atau failIfUnavailable, nilai tersebut menimpa apa pun yang ditetapkan pengembang. Claude Code menggabungkan kunci array di seluruh cakupan pengaturan yang dimuat sesi, jadi pengembang dapat menambahkan entri; lihat Keep developers from widening the policy untuk kunci khusus pengaturan terkelola. Untuk mewajibkan sandbox bagi organisasi, lihat Enforce sandboxing with managed settings.

sandbox.enabled

Aktifkan sandboxing untuk perintah Bash. Ketika 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 menerapkan sandbox pada setiap proyek.

• Scope: Any file, dengan batasan pada pengaturan proyek dan lokal
• Type: Boolean
  • true: Claude Code membuat sandbox untuk perintah Bash
  • false: Perintah Bash berjalan tanpa sandbox
• Default: false

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

Di Linux dan WSL2 sandbox memerlukan bubblewrap dan socat; lihat Set up Linux and WSL2. Ketika sandbox tidak dapat dimulai, Claude Code menjalankan perintah tanpa sandbox kecuali Anda juga menetapkan failIfUnavailable.

sandbox.failIfUnavailable

Buat Claude Code keluar dengan kesalahan saat startup ketika sandbox.enabled adalah true tetapi sandbox tidak dapat dimulai, karena dependensi hilang atau platform tidak didukung. 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 dengan kunci ini aktif. Lihat Enforce sandboxing with managed settings.

• Scope: 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

Contoh ini mengaktifkan sandbox untuk mesin terkelola dan menetapkan failIfUnavailable ke true:

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

Lihat Enforce sandboxing with managed settings.

sandbox.autoAllowBashIfSandboxed

Biarkan Claude Code menjalankan perintah Bash bersandbox tanpa permintaan izin. Perintah yang tidak dapat berjalan di sandbox masih melalui alur izin reguler, dan aturan deny serta aturan ask yang dibatasi konten seperti Bash(git push *) masih berlaku; aturan Bash ask yang kosong dilewati untuk perintah bersandbox. Atur ke false untuk mengirim perintah bersandbox melalui alur izin reguler juga, yang disebut tab Mode /sandbox sebagai mode izin reguler.

• Scope: Any file
• Type: Boolean
  • true: Claude Code menjalankan perintah Bash bersandbox tanpa permintaan izin, kecuali dalam kasus yang dijelaskan di Auto-allow mode; CLAUDE_CODE_SUBPROCESS_ENV_SCRUB mematikan auto-allow
  • false: perintah bersandbox melalui alur izin reguler, jadi aturan allow dan mode izin Anda yang memutuskan. Tab Mode /sandbox menyebut ini mode izin reguler
• Default: true

Ini menjaga sandbox tetap aktif dan mengirim perintah bersandbox melalui alur izin reguler:

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

Lihat Auto-allow mode untuk hal yang masih dimintakan izin dalam auto-allow mode dan cara kerjanya 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 konten aturan izin Bash(...): perintah yang persis, awalan seperti docker *, atau pola wildcard. Pola tanpa wildcard adalah kecocokan persis, jadi 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 bersandbox bahkan dalam kondisi itu. Entri docker * saja tidak mengeluarkan npm ci && docker build . dari sandbox.

• Scope: Any file, dengan batasan pada pengaturan proyek dan lokal
• Type: array pola perintah
• Default: tidak diatur, jadi tidak ada perintah yang dikecualikan

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

Claude Code menjaga panggilan Bash tetap bersandbox ketika memiliki salah satu bentuk ini, di antara lainnya:

• Perintah yang dimulai dengan sudo, eval, atau xargs
• cd, pushd, atau popd, di mana pun muncul dalam panggilan
• Substitusi perintah, subshell, atau blok alur kontrol seperti if atau for
• Pengalihan, seperti docker build . > build.log, selain yang hanya menduplikasi deskriptor file, seperti 2>&1
• Nama perintah yang berasal dari variabel
• git clone, git init, git worktree add, git worktree move, atau git bundle create dengan argumen jalur yang absolut, dimulai dengan ~, atau berisi segmen ..

Misalnya, cd build && docker compose up tetap bersandbox di bawah entri docker *, dan menambahkan entri cd tidak mengubah itu. Di bawah entri git *, git clone <url> vendor/lib berjalan di luar sandbox, tetapi git clone <url> ~/tools tetap bersandbox. Sebuah clone menulis seluruh pohon file, mungkin termasuk file yang dapat dieksekusi, ke mana pun jalur tujuannya menunjuk.

Perintah yang dikecualikan masih melalui alur izin reguler. Pengecualian adalah kemudahan, bukan batas keamanan: ketika alat hanya perlu menulis ke tempat tertentu, filesystem.allowWrite menjaganya tetap bersandbox.

Entri dari cakupan pengaturan yang dimuat sesi digabungkan menjadi satu daftar kecuali 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 kunci khusus pengaturan terkelola yang mencakup daftar ini.

sandbox.allowUnsandboxedCommands

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

• Scope: Any file, dengan batasan pada pengaturan proyek dan lokal
• Type: Boolean
  • true: Claude dapat mencoba ulang perintah di luar sandbox dengan parameter dangerouslyDisableSandbox setelah sandbox memblokirnya
  • false: Claude Code mengabaikan parameter itu, jadi selama sandbox berjalan, perintah yang dijalankan Claude bersandbox kecuali cocok dengan entri excludedCommands
• Default: true

Ini memberlakukan strict sandbox mode untuk semua orang yang dicakup 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 berlaku terhadap nilai true dari proyek, tetapi tidak membuat sandbox diwajibkan admin. Tetap berlaku 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 The unsandboxed retry escape hatch.

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

sandbox.filesystem

Kontrol jalur mana yang dapat dibaca dan ditulis perintah bersandbox. 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, dan dapat membaca sisa sistem file, termasuk file kredensial. Perluas atau persempit itu dengan empat daftar jalur, atau matikan lapisan sistem file dengan disabled. Lihat Filesystem isolation untuk batas default.

• Scope: Any file
• Type: object dengan array allowWrite, denyWrite, denyRead, dan allowRead, ditambah Boolean allowManagedReadPathsOnly dan disabled
• Default: tidak diatur, jadi batas baca dan tulis default berlaku

Ini memungkinkan perintah bersandbox menulis ke direktori build dan kubeconfig Anda, dan menyembunyikan file kredensial AWS Anda:

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

Claude Code memberlakukan daftar ini di batas sandbox OS, jadi daftar tersebut berlaku untuk setiap subprocess yang dimulai perintah bersandbox, 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 ada kunci yang berlaku, Claude Code menggabungkan daftar ini di seluruh file pengaturan yang dimuat sesi. allowManagedReadPathsOnly membatasi allowRead ke entri dari pengaturan terkelola, dan allowManagedDomainsOnly melakukan hal yang sama untuk domain yang diizinkan. Kunci repositori mengecualikan entri dari file pengaturan repositori.

Configure sandboxing mencakup sumber yang Anda kecualikan dengan --setting-sources. Ketika Anda mengedit daftar selama sesi, Claude Code menerapkan perubahan ke sesi yang berjalan.

Awalan jalur sandbox

Jalur di allowWrite, denyWrite, denyRead, allowRead, dan credentials.files diselesaikan berdasarkan awalannya:

Awalan //path untuk jalur absolut juga berfungsi. Jika Anda menggunakan /path dengan slash tunggal dan mengharapkan resolusi relatif proyek, beralihlah ke ./path. Sintaks ini berbeda dari Read and Edit permission rules, yang menggunakan //path untuk absolut dan /path untuk relatif proyek: jalur sistem file sandbox menggunakan konvensi standar, jadi /tmp/build adalah jalur absolut.

Claude Code menghapus garis miring di akhir jalur direktori, jadi ~/.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 jalur di bawah entri denyRead atau denyWrite yang ditulis dengan garis miring di akhir.

Di mana wildcard berfungsi dalam path sandbox

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

Dalam ~/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 di /sandbox dalam sebuah sesi memberikan peringatan 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, atau direktori yang menampungnya, ke allowWrite untuk aturan allow atau denyWrite untuk aturan deny.

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

Untuk mengizinkan atau memblokir direktori yang namanya berisi kurung siku, tulis nama tersebut apa adanya, seperti ./app/[slug]. Dalam entri itu, [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 ketika 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 dalam ./app/[slug] juga merupakan pola. Entri tersebut kemudian juga cocok dengan path apa pun di bawah app yang bernama 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 seharusnya tidak 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 itu, 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 semacam itu.
• Kurung kurawal dan tanda kurung: 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 jalur tempat perintah bersandbox 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 ketika subprocess seperti kubectl atau alat build perlu menulis di luar proyek.

• Scope: Any file, dengan batasan pada pengaturan proyek dan lokal
• Type: array string jalur, menggunakan sandbox path prefixes
• Default: tidak diatur, jadi perintah bersandbox 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 jalur dari aturan izin allow Edit(...) Anda di seluruh cakupan pengaturan yang dimuat sesi, dengan mengecualikan yang berasal dari pengaturan repositori selama permissions.blockReadsOutsideWorkingDirectories aktif. Kunci repositori juga dapat mengecualikan entri repositori. Entri allowWrite tidak dapat membuka protected path.

sandbox.filesystem.denyWrite

Blokir perintah bersandbox dari menulis ke jalur tertentu, termasuk jalur di dalam direktori yang sebenarnya dapat ditulis.

• Scope: Any file
• Type: array string jalur, menggunakan sandbox path prefixes
• Default: tidak diatur

Ini mencegah perintah bersandbox mengubah konfigurasi sistem atau memasang binari:

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

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

sandbox.filesystem.denyRead

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

• Scope: Any file
• Type: array string jalur, menggunakan sandbox path prefixes
• Default: tidak diatur, jadi perintah bersandbox mempertahankan default read access, 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 jalur dari aturan izin deny Read(...) Anda. Ketika filesystem.disabled adalah true, Claude Code tidak memberlakukan entri ini.

sandbox.filesystem.allowRead

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

• Scope: Any file, dengan batasan pada pengaturan proyek dan lokal
• Type: array string jalur, menggunakan sandbox path prefixes
• Default: tidak diatur

Ini memblokir pembacaan direktori home Anda kecuali proyek itu sendiri:

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

Claude Code menyelesaikan entri . ke akar proyek dalam pengaturan proyek dan ke ~/.claude dalam pengaturan pengguna. Claude Code menggabungkan entri di seluruh file pengaturan yang dimuat sesi kecuali allowManagedReadPathsOnly diatur, dan mengecualikan entri dari pengaturan repositori selama permissions.blockReadsOutsideWorkingDirectories aktif. Kunci repositori juga dapat mengecualikan entri repositori.

sandbox.filesystem.allowManagedReadPathsOnly

Hormati hanya entri allowRead yang berasal dari pengaturan terkelola, sehingga pengembang tidak dapat membuka kembali akses baca ke jalur yang diblokir organisasi Anda. Claude Code tetap menggabungkan entri denyRead dari setiap cakupan pengaturan yang dimuat sesi.

• Scope: Managed
• Type: Boolean
  • true: Claude Code hanya menghormati 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 pengembang membuka kembali apa pun selain itu:

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

Lihat Keep developers from widening the policy.

sandbox.filesystem.disabled

Lewati isolasi sistem file sambil mempertahankan isolasi jaringan. Perintah bersandbox mendapatkan akses baca dan tulis tanpa batas ke sistem file host, dan egress jaringannya tetap terbatas pada network.allowedDomains. Gunakan ketika Anda memakai sandbox untuk mengontrol tempat perintah terhubung, bukan apa yang ditulisnya. Memerlukan Claude Code v2.1.216 atau lebih baru.

• Scope: User or managed. Ketika pengaturan terkelola mengonfigurasi sandbox.filesystem sama sekali, atau mencantumkan entri sandbox.credentials.files dengan "mode": "deny", hanya pengaturan terkelola yang dapat menetapkannya.
• Type: Boolean
  • true: Claude Code melewati isolasi sistem file dan mempertahankan isolasi jaringan
  • false: isolasi sistem file tetap aktif
• Default: false, jadi 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 mati, Claude Code tidak memberlakukan entri denyRead atau entri deny credentials.files, sementara entri credentials.envVars dan entri mask yang diterapkan tetap bekerja. autoAllowBashIfSandboxed tetap default ke true, jadi atur ke false agar permintaan izin tetap muncul. Lihat Disable filesystem isolation untuk daftar lengkap sumber yang dapat menetapkannya dan apa yang berubah ketika isolasi mati. Memerlukan Claude Code v2.1.216 atau lebih baru.

sandbox.ignoreViolations

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

• Scope: Any file, dengan batasan pada pengaturan proyek dan lokal
• Type: object yang memetakan substring perintah ke array substring pelanggaran, biasanya jalur
• Default: tidak diatur, jadi setiap pelanggaran dilaporkan

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

sandbox.enableWeakerNestedSandbox

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

• Scope: Any file, dengan batasan pada pengaturan proyek dan lokal
• Type: Boolean
  • true: sandbox bagian dalam melakukan bind-mount /proc milik kontainer yang sudah ada alih-alih memasang yang baru
  • false: sandbox memasang /proc baru, yang tidak berfungsi dalam kontainer Docker tanpa hak istimewa
• Default: false

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

Hanya Linux dan WSL2. Lihat Bubblewrap fails to start inside a container.

sandbox.enableWeakerNetworkIsolation

Biarkan perintah bersandbox 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 jalur eksfiltrasi data potensial melalui layanan kepercayaan.

• Scope: Any file, dengan batasan pada pengaturan proyek dan lokal
• Type: Boolean
  • true: perintah bersandbox di macOS dapat menjangkau com.apple.trustd.agent
  • false: perintah bersandbox 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 Go-based CLIs fail TLS verification on macOS.

sandbox.allowAppleEvents

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

• Scope: User or managed
• Type: Boolean
  • true: perintah bersandbox di macOS dapat mengirim Apple Events
  • false: perintah bersandbox di macOS tidak dapat mengirim Apple Events, jadi open dan osascript gagal dengan kesalahan -600
• Default: false

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

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

sandbox.allowNestedUserNamespaces

Izinkan perintah yang di-sandbox di Linux dan WSL2 membuat user namespace, yang diperlukan oleh sandbox milik Chromium dan Electron, bubblewrap bersarang, dan unshare. Jika Anda mengatur kunci ini ke true, Anda menonaktifkan 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 dihitung dari ~/.claude/settings.json, JSON yang diteruskan dengan --settings, atau pengaturan terkelola. Claude Code mengabaikan nilai 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 nilai true dari setiap sumber. Nilai false dihitung dari file mana pun, sesuai prioritas pengaturan.
• Tipe: Boolean
  • true: perintah yang di-sandbox dapat membuat user namespace
  • false: kunci ini tidak mengizinkan apa pun tambahan, dan default sandbox berlaku
• Default: false

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

Dengan kunci ini aktif, jangan mengandalkan pembatasan sandbox mana 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 tool Anda, lihat Chromium atau Podman rootless gagal di dalam sandbox di Linux.

sandbox.ripgrep

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

• Scope: User or managed
• Type: object dengan command, jalur ke binari ripgrep, dan args opsional, array argumen untuk ditambahkan di depan
• Default: tidak diatur, jadi sandbox menggunakan binari ripgrep yang sama dengan Claude Code. Itu adalah binari bawaan kecuali Anda menetapkan USE_BUILTIN_RIPGREP ke 0

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

sandbox.bwrapPath

Arahkan sandbox ke binari bubblewrap yang dipasang di luar PATH, seperti salinan vendor di host air-gapped. Claude Code menggunakan jalur ini baik untuk pemeriksaan dependensi saat startup maupun ketika membungkus setiap perintah bersandbox.

• Scope: Managed. Claude Code membacanya hanya dari pengaturan terkelola sehingga file pengguna, proyek, atau lokal tidak dapat mengarahkan sandbox ke binari yang berbeda.
• Type: string, jalur absolut; Claude Code membuang jalur relatif dan kembali ke pencarian PATH
• Default: tidak diatur, jadi Claude Code menemukan bwrap di PATH

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

Hanya Linux dan WSL2.

sandbox.socatPath

Arahkan proxy jaringan sandbox ke binari socat yang dipasang di luar PATH.

• Scope: Managed
• Type: string, jalur absolut; Claude Code membuang jalur relatif dan kembali ke pencarian PATH
• Default: tidak diatur, jadi Claude Code menemukan 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 bersandbox. Setiap entri menyebutkan path file atau name variabel dan sebuah mode: deny menyembunyikan kredensial di dalam sandbox, dan mask menampilkan placeholder kepada perintah bersandbox sementara sandbox proxy mengganti nilai aslinya pada permintaan keluar. Claude Code hanya melindungi entri yang Anda cantumkan; tidak ada daftar deny kredensial bawaan.

• Scope: Any file. Claude Code menghormati entri mask, allowPlaintextInject, awsPairs, dan sigv4 hanya dari pengaturan pengguna, pengaturan terkelola, dan flag --settings.
• Type: object dengan files, envVars, allowPlaintextInject, awsPairs, dan sigv4
• Default: tidak diatur, jadi tidak ada kredensial yang dilindungi

Ini menyembunyikan file kredensial AWS Anda dan menghapus GITHUB_TOKEN dari perintah bersandbox:

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

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

Entri kredensial tidak valid dalam pengaturan terkelola

Ketika entri sandbox.credentials terkelola gagal validasi, Claude Code tetap melindungi kredensial sejauh memungkinkan:

• Entri di files atau envVars yang masih memiliki path atau name yang valid dan mode bernilai mask atau deny, seperti entri yang pola extract-nya tidak memiliki grup penangkap, diturunkan menjadi mode: "deny" dengan peringatan, sehingga kredensial tetap diblokir, bukan disamarkan, sampai Anda memperbaiki entri tersebut. Entri files yang diturunkan mengunci filesystem.disabled seperti entri deny eksplisit, dan peringatannya mencatat bahwa blok bacanya tidak diberlakukan 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 yang tersisa tetap diberlakukan.

Berlaku di v2.1.191 dan lebih baru; sebelum v2.1.221, setiap entri tidak valid dihapus. Untuk kunci terkelola lainnya dengan penanganan per bidang, lihat Invalid entries in managed settings.

sandbox.credentials.files

Lindungi file atau direktori kredensial dari perintah bersandbox. Dengan "mode": "deny", Claude Code memblokir pembacaan jalur di dalam sandbox, blok baca yang sama dengan sandbox.filesystem.denyRead. Dengan "mode": "mask", perintah bersandbox di Linux dan WSL2 membaca salinan sentinel dari file, dan proxy sandbox mengganti nilai aslinya pada permintaan keluar ke injectHosts milik entri itu; di macOS, file justru tidak dapat dibaca di dalam sandbox. "mode": "mask" memerlukan Claude Code v2.1.221 atau lebih baru.

• Scope: Any file. Claude Code membuang entri mask dari .claude/settings.json proyek dan .claude/settings.local.json lokal.
• Type: array objek, masing-masing dengan path dan mode bernilai "deny" atau "mask", ditambah mask fields for files opsional
• Default: tidak diatur, jadi tidak ada file kredensial yang dilindungi

Ini menyembunyikan file kredensial AWS Anda dan menyamarkan file hosts gh, mengganti nilai aslinya 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"] }
      ]
    }
  }
}

Jalur menggunakan prefixes yang sama dengan pengaturan sandbox.filesystem.*, dan Claude Code menggabungkan array dari setiap cakupan pengaturan yang dimuat sesi. Protect credentials mencakup apa yang masih 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 uji HTTP biasa. mask berlaku untuk satu file, jadi cantumkan setiap file kredensial secara terpisah. Claude Code menerima tetapi mengabaikan bidang mask pada entri deny. Mask credentials mencakup sumber pengaturan mana yang dihormati, dan Mask credential files mencakup kapan entri kembali ke deny.

Bidang mask untuk file

Entri mask menerima bidang opsional berikut. Tanpa extract atau decode, Claude Code mengganti seluruh konten file dengan satu sentinel. Di macOS dengan isolasi sistem file aktif, Claude Code menerapkan entri mask sebagai deny sebelum extract atau decode berjalan; lihat Mask credential files.

Ini hanya menyamarkan nilai oauth_token di file hosts gh, mengganti setiap salinan lainnya di file, membuat file tidak dapat dibaca jika pola tidak cocok dengan apa pun, dan mengganti token aslinya 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 bersandbox. Dengan "mode": "deny", Claude Code menghapus variabel dari environment perintah bersandbox. Dengan "mode": "mask", perintah bersandbox melihat nilai sentinel per sesi, dan proxy sandbox mengganti nilai aslinya pada permintaan keluar ke injectHosts milik entri itu, sehingga alat seperti gh dan npm tetap dapat mengautentikasi tanpa pernah memegang kredensial asli.

• Scope: Any file. Claude Code membuang entri mask dari .claude/settings.json proyek dan .claude/settings.local.json lokal.
• Type: array objek, masing-masing dengan name dan mode bernilai "deny" atau "mask", ditambah mask fields for environment variables opsional
• Default: tidak diatur, jadi tidak ada environment variable yang dilindungi

Ini menghapus NPM_TOKEN dari perintah bersandbox dan menyamarkan GITHUB_TOKEN, mengganti nilai aslinya 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 dimulai dengan huruf atau garis bawah dan hanya berisi huruf, digit, 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. Protect credentials mencakup apa yang masih 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 uji HTTP biasa; lihat Mask credentials. 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 menyamarkan kata sandi di dalam DATABASE_URL, menghapus pengaturan variabel jika pola tidak cocok dengan apa pun, dan menyamarkan JWT di SERVICE_JWT sambil membiarkan setiap klaim 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 HTTPS dengan terminasi TLS. Pada HTTP biasa, identitas upstream tidak diverifikasi dan kredensial dikirim dalam cleartext, jadi biarkan mati di luar jaringan uji tepercaya.

• Scope: User or managed
• Type: Boolean
  • true: Claude Code mengizinkan substitusi mask pada permintaan HTTP biasa selain HTTPS dengan terminasi TLS
  • false: Claude Code mengizinkan substitusi mask hanya pada HTTPS dengan terminasi TLS
• Default: false

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

sandbox.credentials.awsPairs

Kelompokkan environment variable tersamarkan yang membentuk satu kredensial AWS untuk SigV4 re-signing ketika kredensial Anda berada dalam variabel dengan nama non-standar. Claude Code menghubungkan trio konvensional AWS_ACCESS_KEY_ID, AWS_SECRET_ACCESS_KEY, dan AWS_SESSION_TOKEN secara otomatis ketika Anda menyamarkan seluruh nilainya, jadi Anda hanya memerlukan kunci ini untuk nama lain. Memerlukan Claude Code v2.1.224 atau lebih baru.

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

Ini menghubungkan tiga variabel bernama kustom menjadi satu kredensial AWS untuk re-signing:

{
  "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 melakukan re-sign pada permintaan ke host yang tercantum di injectHosts milik entri ID kunci akses
• Ketika sessionTokenVar diatur, proxy mengirim token asli sebagai x-amz-security-token pada permintaan yang di-re-sign
• Menyebutkan salah satu variabel konvensional dalam pasangan akan menggantikan pemasangan otomatis

sandbox.credentials.sigv4

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

• Scope: User or managed
• Type: object dengan streaming, presigned, dan sigv4a, masing-masing salah satu dari:
  • "deny": proxy menggagalkan permintaan
  • "passthrough": proxy meneruskan permintaan yang ditandatangani dengan placeholder tersamarkan, sehingga alat menerima penolakan dari AWS sendiri
• Default: tidak diatur, jadi setiap bentuk bernilai "deny"

Ini meneruskan unggahan 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 tersamarkan, sehingga AWS menolaknya dan alat pemanggil menerima respons dari AWS sendiri alih-alih kesalahan proxy.

sandbox.network

Kontrol host, port, dan soket mana yang dapat dijangkau perintah bersandbox. Sandbox merutekan lalu lintas keluar melalui proxy yang memberlakukan daftar ini; lihat Network isolation untuk cara proxy memutuskan dan kapan meminta persetujuan.

• Scope: Any file. strictAllowlist, allowManagedDomainsOnly, dan tlsTerminate dibaca dari lebih sedikit sumber, seperti yang dijelaskan di entrinya masing-masing.
• Type: object dengan sub-kunci di bawah
• Default: tidak diatur, jadi tidak ada domain yang pra-diizinkan dan mode izin Anda menentukan apa yang terjadi pada setiap host baru

Ini pra-mengizinkan GitHub dan npm, 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, jadi proyek dapat menambahkan domain ke daftar pengguna Anda kecuali ada kunci repositori yang berlaku. Aturan izin allow dan deny WebFetch(domain:...) mengisi daftar allow dan deny yang sama.

sandbox.network.allowUnixSockets

Cantumkan jalur soket Unix yang dapat dihubungi perintah bersandbox di macOS. Claude Code mengabaikan daftar ini di Linux dan WSL2, tempat filter seccomp tidak dapat memeriksa jalur soket; gunakan allowAllUnixSockets di sana sebagai gantinya.

• Scope: Any file, dengan batasan pada pengaturan proyek dan lokal
• Type: array string, masing-masing jalur soket
• Default: tidak diatur, jadi sandbox macOS memblokir setiap soket Unix

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

Jalur soket dapat memberikan akses luas: mengizinkan /var/run/docker.sock, misalnya, memungkinkan perintah bersandbox mengontrol daemon Docker. Lihat Security limitations.

sandbox.network.allowAllUnixSockets

Biarkan perintah bersandbox terhubung ke setiap soket Unix. Di Linux dan WSL2, seccomp filter sandbox memblokir panggilan socket(AF_UNIX, ...), jadi ini adalah satu-satunya cara untuk mengizinkan soket Unix di sana. Ketika filter tidak ada, yang dilaporkan /sandbox di tab Dependencies, sandbox tidak memblokir panggilan soket Unix. Lihat Set up Linux and WSL2 untuk asal filter tersebut.

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

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

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

sandbox.network.allowLocalBinding

Biarkan perintah bersandbox di macOS mendengarkan pada 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 bersandbox memiliki antarmuka loopback sendiri. Untuk menjangkau server di host dari Linux atau WSL2, lihat A command fails to reach a server on localhost.

• Scope: Any file, dengan batasan pada pengaturan proyek dan lokal
• Type: Boolean
  • true: perintah bersandbox di macOS dapat mendengarkan pada alamat lokal mana pun dan terhubung ke port mana pun di localhost
  • false: perintah bersandbox di macOS tidak dapat mendengarkan pada 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.

• Scope: Any file, dengan batasan pada pengaturan proyek dan lokal
• Type: array string, masing-masing nama layanan; satu * di akhir cocok dengan awalan, dan "*" saja cocok dengan setiap layanan
• Default: tidak diatur

Contoh berikut mengizinkan setiap layanan di bawah prefiks com.apple.CoreSimulator.:

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

sandbox.network.allowedDomains

Pra-izinkan domain untuk lalu lintas keluar dari perintah bersandbox, sehingga sandbox tidak meminta persetujuan untuknya. Wildcard seperti *.example.com cocok dengan subdomain, dan akhiran :port opsional membatasi entri ke satu port; entri tanpa port cocok dengan setiap port.

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

Ini pra-mengizinkan 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 dengan tanda kurung siku, dengan port opsional: "[::1]" mengizinkan setiap port dan "[::1]:443" satu port. Bentuk dengan tanda kurung siku memerlukan Claude Code v2.1.229 atau lebih baru. Lihat IPv6 addresses in domain lists.

sandbox.network.deniedDomains

Blokir domain untuk lalu lintas keluar dari perintah bersandbox, menggunakan sintaks wildcard, port, dan IPv6 yang sama dengan allowedDomains. Domain yang ditolak tetap diblokir bahkan ketika entri allowedDomains juga cocok dengannya.

• Scope: Any file
• Type: array string, masing-masing 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, jadi pengembang selalu dapat memperketat daftar deny. Untuk literal IPv6, lihat IPv6 addresses in domain lists.

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 bersandbox ke host di luar allowlist alih-alih meminta persetujuan. Allowlist adalah allowedDomains ditambah domain dari aturan allow WebFetch(domain:...), atau hanya entri pengaturan terkelola ketika allowManagedDomainsOnly diatur. Locks that apply without an admin-required sandbox mencakup entri repositori. Memerlukan Claude Code v2.1.219 atau lebih baru.

• Scope: User or managed. Repositori tidak dapat mengaktifkan atau menonaktifkannya.
• Type: Boolean
  • true: Claude Code menolak akses perintah bersandbox ke host di luar allowlist
  • false: kecuali file pengaturan tepercaya lain menetapkan true, Claude Code memutuskan host di luar allowlist berdasarkan mode izin alih-alih langsung menolaknya: dalam auto mode, Claude Code memeriksa host terhadap per-command allowed domains milik perintah tersebut, dalam mode dontAsk menolak, dalam mode bypassPermissions dan dalam sesi plan mode terminal interaktif tempat bypass tersedia mengizinkan, dan selain itu meminta persetujuan Anda
• Default: false

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

Claude Code memberlakukan ini hanya untuk perintah bersandbox; tool dalam proses seperti WebFetch tetap mengikuti aturan izin masing-masing. Ketika salah satu sumber yang dihormati menetapkannya ke true, pengaturan ini tetap aktif. Lihat Network isolation. Memerlukan Claude Code v2.1.219 atau lebih baru.

sandbox.network.allowManagedDomainsOnly

Kunci allowlist jaringan ke apa yang didefinisikan pengaturan terkelola. Claude Code kemudian hanya menghormati allowedDomains dan aturan allow WebFetch(domain:...) dari pengaturan terkelola, mengabaikan domain dari pengaturan pengguna, proyek, lokal, dan --settings, dan memblokir domain yang tidak diizinkan secara otomatis alih-alih meminta persetujuan.

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

Ini mengunci allowlist ke GitHub dan npm dan mengabaikan domain apa pun yang ditambahkan pengembang:

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

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

Domain yang ditolak tetap digabungkan dari setiap sumber yang dimuat sesi. Lihat Keep developers from widening the policy.

sandbox.network.httpProxyPort

Arahkan sandbox ke proxy HTTP milik Anda sendiri alih-alih proxy yang dijalankan Claude Code. Organisasi melakukan ini untuk memeriksa lalu lintas HTTPS, menerapkan aturan penyaringan sendiri, atau mencatat permintaan ke log. Proxy Anda mengambil alih penyaringan, dan Claude Code berhenti menerapkan daftar domain dan permintaan persetujuan jaringannya pada lalu lintas yang dikirim ke sana. Ketika tidak diatur, Claude Code memulai proxy sendiri untuk lalu lintas HTTP.

• Scope: Any file, kecuali pengaturan sandbox lain membatasi file mana yang dapat menetapkan port
• Type: number, port TCP lokal
• Default: tidak diatur, jadi Claude Code menjalankan proxy sendiri

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

Atur juga socksProxyPort jika proxy Anda juga harus membawa lalu lintas SOCKS; jika hanya salah satu dari keduanya yang diatur, Claude Code tetap menjalankan proxy sendiri untuk protokol lainnya. Lihat Custom proxy configuration.

sandbox.network.socksProxyPort

Arahkan sandbox ke proxy SOCKS5 milik Anda sendiri alih-alih proxy yang dijalankan Claude Code. Proxy Anda mengambil alih penyaringan, dan Claude Code berhenti menerapkan daftar domain dan permintaan persetujuan jaringannya pada lalu lintas yang dikirim ke sana. Ketika tidak diatur, Claude Code memulai proxy sendiri untuk lalu lintas SOCKS.

• Scope: Any file, kecuali pengaturan sandbox lain membatasi file mana yang dapat menetapkan port
• Type: number, port TCP lokal
• Default: tidak diatur, jadi Claude Code menjalankan proxy sendiri

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

Lihat Custom proxy configuration.

sandbox.network.tlsTerminate

Buat proxy sandbox melakukan terminasi TLS sehingga dapat membaca konten permintaan HTTPS. Ini bersifat eksperimental, dan credential substitution mask memerlukannya. Atur {} untuk menghasilkan otoritas sertifikat sementara untuk sesi, atau atur caCertPath dan caKeyPath untuk menggunakan milik Anda sendiri.

• Scope: User or managed. Repositori tidak dapat mengaktifkannya atau menyediakan otoritas sertifikat.
• Type: object dengan string caCertPath dan caKeyPath opsional, masing-masing jalur file
• Default: tidak diatur, jadi proxy tidak melakukan terminasi atau memeriksa TLS

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

Ketika lebih dari satu sumber yang dihormati menetapkannya, Claude Code menggunakan nilai dari sumber dengan prioritas tertinggi: pengaturan terkelola, kemudian flag --settings, kemudian 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 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_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, atau di panel chat ekstensi VS Code atau tab Code aplikasi desktop pada akun yang dipilih Anthropic
• Auto-compaction: autoCompactEnabled menyala
• Prompt cache: percakapan menggunakan TTL prompt cache satu jam
• Feature flag: Claude Code dapat mengambil feature flag dari Anthropic
• Ukuran: konteks percakapan telah mencapai ambang token, yang dapat Anda ubah dari default-nya sebesar 200.000
• Waktu idle: sekitar 54 menit telah berlalu sejak permintaan terakhir, dan komputer Anda dalam keadaan menyala pada 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: 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 atau file pengaturan lainnya.

Di panel chat ekstensi VS Code dan tab Code aplikasi desktop, idle compaction berjalan untuk akun yang dipilih Anthropic. Claude Code menulis ringkasan saat Anda tidak ada, lalu melakukan compaction dengan ringkasan tersebut hanya jika pesan Anda berikutnya datang satu jam atau lebih setelah permintaan terakhir.

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. Memerlukan Claude Code v2.1.217 atau lebih baru.

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 bawaan; tidak ada plugin atau language server yang terlibat. 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

{
  "tui": "fullscreen"
}

Di bawah tmux -CC atau melalui SSH ke Windows, Claude Code menjaga renderer klasik kecuali Anda mengatur CLAUDE_CODE_NO_FLICKER=1. Sesi latar belakang dibuka dari agent view selalu menggunakan renderer fullscreen terlepas dari pengaturan ini.

verbose

Secara default, transkrip meruntuhkan setiap panggilan tool menjadi ringkasan pendek, seperti perintah yang Claude jalankan dan jumlah baris output, dan Anda menekan Ctrl+O untuk beralih seluruh transkrip ke tampilan yang diperluas ketika Anda menginginkan detail. Atur kunci ini ke true untuk menampilkan input dan output lengkap setiap panggilan tool secara inline saat terjadi, yang berguna ketika Anda men-debug hook, server MCP, atau perintah shell panjang. Muncul di /config sebagai Verbose output.

• 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 output tool lengkap
  • false: Anda melihat ringkasan terpotong dari output tool
• Default: false
• Per-session overrides: --verbose mengambil alih kunci ini untuk satu sesi

{
  "verbose": true
}

Nilai viewMode atau pilihan /focus lengket menimpa kunci ini setiap sesi.

viewMode

Atur tampilan transkrip Claude Code dimulai: "default", "verbose", atau "focus". Ketika diatur, menimpa pilihan /focus lengket dan pengaturan verbose.

• Scope: Any file
• Type: string, salah satu dari:
  • "default": transkrip normal dengan output tool terpotong
  • "verbose": transkrip dengan output tool lengkap
  • "focus": hanya prompt terakhir Anda, ringkasan satu baris panggilan tool dengan edit diffstats, dan respons akhir. Focus view memerlukan renderer fullscreen
• Default: unset, jadi pengaturan verbose dan pilihan /focus terakhir Anda berlaku
• Per-session overrides: --verbose mengambil alih kunci ini untuk satu sesi

{
  "viewMode": "focus"
}

vimInsertModeRemaps

Petakan urutan INSERT-mode dua kunci ke Escape dalam mode editor vim. Setiap kunci adalah tepat dua karakter yang dapat dicetak yang diketik berurutan, dan "<Esc>" adalah satu-satunya target yang didukung; Claude Code mengabaikan entri lain.

• Scope: User or managed. Repositori tidak dapat memetakan ulang keystroke Anda.
• Type: object memetakan urutan dua karakter ke "<Esc>"
• Default: unset

{
  "vimInsertModeRemaps": {
    "jj": "<Esc>"
  }
}

Tidak berpengaruh kecuali editorMode adalah "vim". Lihat Remap INSERT-mode key sequences.

voice

Aktifkan voice dictation dan pilih cara kunci diksi berperilaku. Claude Code menulis objek ini untuk Anda ketika Anda menjalankan /voice.

• Scope: Any file
• Type: object dengan enabled sebagai Boolean, autoSubmit sebagai Boolean yang berlaku dalam mode hold saja, dan mode, salah satu dari:
  • "hold": Anda menahan kunci diksi saat berbicara dan melepasnya untuk berhenti
  • "tap": Anda mengetuk kunci sekali untuk mulai merekam dan lagi untuk mengirim
• Default: unset, jadi diksi mati; ketika enabled adalah true dan mode unset, Claude Code menggunakan "hold"

Contoh ini mengaktifkan diksi dan membuat kunci mengetuk sekali untuk mulai merekam dan lagi untuk mengirim:

{
  "voice": {
    "enabled": true,
    "mode": "tap"
  }
}

autoSubmit mengirim prompt ketika Anda melepaskan kunci dalam mode hold. Voice dictation memerlukan akun claude.ai.

voiceEnabled

[!WARNING]

Tidak direkomendasikan sejak v2.1.92, ketika objek voice menggantinya. Claude Code masih membacanya jadi file pengaturan yang lebih lama tetap bekerja, tetapi konfigurasi baru harus mengatur voice.enabled.

Aktifkan voice dictation dengan bentuk Boolean tunggal yang mendahului objek voice. Ketika keduanya diatur, voice.enabled berlaku.

• Scope: Any file
• Type: Boolean
  • true: voice dictation aktif ketika Anda masuk dengan akun claude.ai dan kebijakan organisasi Anda memungkinkan suara, kecuali voice.enabled diatur
  • false: voice dictation mati, kecuali voice.enabled diatur
• Default: unset

{
  "voiceEnabled": true
}

wheelScrollAccelerationEnabled

Percepat kecepatan scroll roda mouse selama scroll cepat dalam fullscreen rendering. Atur ke false untuk laju scroll konstan per takik roda.

• Scope: Any file
• Type: Boolean
  • true: Claude Code mempercepat kecepatan scroll roda mouse selama scroll cepat
  • false: Claude Code menggulir pada laju konstan per takik roda
• Default: true

{
  "wheelScrollAccelerationEnabled": false
}

Git dan atribusi

Kontrol atribusi yang ditambahkan Claude Code ke commit dan pull request serta cara kerjanya dengan git.

attribution

Sesuaikan atribusi yang ditambahkan Claude Code ke commit git dan pull request. Commit mendapatkan git trailer seperti Co-Authored-By secara default; deskripsi pull request mendapatkan teks biasa. Atur setiap bagian secara terpisah dengan sub-kunci di bawah ini.

• Scope: Any file
• Type: object dengan string commit dan pr serta Boolean sessionUrl, atau false untuk menyembunyikan semua atribusi. Nilai false memerlukan Claude Code v2.1.281 atau lebih baru; versi sebelumnya menolaknya dan melewati seluruh file pengaturan pengguna, proyek, atau lokal yang menahannya
• Default: tidak diatur, jadi Claude Code menggunakan atribusi standar yang ditampilkan di bawah setiap sub-kunci