Semua pengaturan

Indeks pengaturan

Model dan respons

advisorModel

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

{
  "advisorModel": "opus"
}

alwaysThinkingEnabled

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

{
  "alwaysThinkingEnabled": false
}

availableModels

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

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

availableModelsMatch

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

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

deniedModels

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

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

effortLevel

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

{
  "effortLevel": "xhigh"
}

enforceAvailableModels

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

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

fallbackModel

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

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

fastMode

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

{
  "fastMode": true
}

fastModePerSessionOptIn

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

{
  "fastModePerSessionOptIn": true
}

language

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

{
  "language": "japanese"
}

maxEffortLevel

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

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

model

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

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

modelOverrides

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

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

modelPicker

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

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

Field untuk modelPicker

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

modelPricing

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

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

Field untuk modelPricing

Model mana yang dikenai baris modelPricing

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

modelSettings

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

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

outputStyle

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

{
  "outputStyle": "Explanatory"
}

promptCacheTtl

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

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

showThinkingSummaries

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

{
  "showThinkingSummaries": true
}

subagentPromptCacheTtl

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

{
  "subagentPromptCacheTtl": "1h"
}

switchModelsOnFlag

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

{
  "switchModelsOnFlag": false
}

ultracode

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

{
  "ultracode": true
}

Pengaturan izin

allowManagedPermissionRulesOnly

• 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

• 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
}

autoMode

• 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

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

autoMode.classifyAllShell

• 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
  }
}

disableAutoMode

• 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

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

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

useAutoModeDuringPlan

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

{
  "useAutoModeDuringPlan": false
}

permissions.allow

• 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

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

Sintaks aturan izin

permissions.ask

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

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

permissions.deny

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

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

permissions.additionalDirectories

• 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/"]
  }
}

permissions.blockReadsOutsideWorkingDirectories

• 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

• 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
  }
}

Perintah sandboxed di bawah blokir

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

• ~/.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

permissions.blockWritesOutsideWorkingDirectories

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

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

Apa yang ditolak blokir penulisan dan apa yang tetap dapat ditulis

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

Loloskan satu direktori melalui blokir baca atau tulis

permissions.defaultMode

• 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"
  }
}

permissions.denyInsteadOfPrompting

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

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

Apa lagi yang dihentikan denyInsteadOfPrompting

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

Pesan dari denyInsteadOfPrompting

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

no approval surface in this session; permission request denied automatically

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

permissions.disableBypassPermissionsMode

• 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"
  }
}

skipAutoPermissionPrompt

• 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

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

{
  "skipDangerousModePermissionPrompt": true
}

Pengaturan sandbox

sandbox

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

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

sandbox.enabled

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

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

sandbox.failIfUnavailable

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

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

sandbox.autoAllowBashIfSandboxed

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

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

sandbox.excludedCommands

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

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

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

sandbox.allowUnsandboxedCommands

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

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

sandbox.filesystem

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

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

Prefiks path sandbox

Tempat wildcard berfungsi di path sandbox

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

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