Semua pengaturan

​

Indeks pengaturan

​

Model dan respons

​

advisorModel

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

​

alwaysThinkingEnabled

• 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

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

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

​

availableModelsMatch

• 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, termasuk ID tanggal versi itu, jadi "claude-opus-5" memungkinkan Opus 5 tetapi bukan claude-opus-5-5. Alias keluarga seperti "opus" masih memungkinkan seluruh keluarga, dan entri best, opusplan, dan default diabaikan
• Default: "prefix"

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

​

deniedModels

• 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

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

​

effortLevel

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

​

enforceAvailableModels

• 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

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

​

fallbackModel

• 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

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

​

fastMode

• 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

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

​

language

• 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

• 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

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

​

model

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

​

modelOverrides

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

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

​

modelPicker

• 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

{
  "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

• 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

​

modelPricing

• 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

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

​

Bidang untuk modelPricing

​

Model mana yang berlaku baris modelPricing

• 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

• 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

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

​

outputStyle

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

{
  "outputStyle": "Explanatory"
}

​

promptCacheTtl

• 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

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

​

showThinkingSummaries

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

​

subagentPromptCacheTtl

• 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

{
  "subagentPromptCacheTtl": "1h"
}

​

switchModelsOnFlag

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

​

ultracode

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

​

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

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

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

• Scope: Any file
• Type: object dengan enabled, failIfUnavailable, autoAllowBashIfSandboxed, excludedCommands, allowUnsandboxedCommands, enableWeakerNestedSandbox, enableWeakerNetworkIsolation, allowAppleEvents, bwrapPath, socatPath, ignoreViolations, dan ripgrep, ditambah objek filesystem, network, dan credentials
• Default: tidak diatur, jadi 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

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

​

sandbox.failIfUnavailable

• Scope: Any file, dengan batasan pada pengaturan proyek dan lokal
• Type: Boolean
  • true: Claude Code keluar dengan kesalahan saat startup ketika sandbox.enabled adalah true tetapi sandbox tidak dapat dimulai
  • false: Claude Code menjalankan perintah tanpa sandbox ketika sandbox tidak dapat dimulai
• Default: false

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

​

sandbox.autoAllowBashIfSandboxed

• 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

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

​

sandbox.excludedCommands

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

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

​

sandbox.allowUnsandboxedCommands

• 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

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

​

sandbox.filesystem

• 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

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

​

Awalan jalur sandbox

• allowWrite dan denyWrite: di macOS, wildcard berfungsi. Di Linux dan WSL2, sandbox memasang jalur konkret, jadi Claude Code melewati entri yang berisi *, ?, atau [ setelah /** di akhir dihapus, dan entri itu tidak berpengaruh. Claude Code menambahkan jalur dari aturan izin Edit Anda ke daftar ini, jadi batas yang sama berlaku untuknya, dan tab Config /sandbox memperingatkan tentang aturan izin Edit dan Read yang berisi wildcard.
• denyRead dan allowRead: wildcard berfungsi di setiap platform. Di Linux dan WSL2, Claude Code memperluas entri baca ke jalur konkret yang cocok, yang tidak dilakukannya untuk daftar tulis.

​

sandbox.filesystem.allowWrite

• 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

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

​

sandbox.filesystem.denyWrite

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

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

​

sandbox.filesystem.denyRead

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

​

sandbox.filesystem.allowRead

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

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

​

sandbox.filesystem.allowManagedReadPathsOnly

• 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

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

​

sandbox.filesystem.disabled

• 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

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

​

sandbox.ignoreViolations

• 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

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

​

sandbox.enableWeakerNetworkIsolation

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

​

sandbox.allowAppleEvents

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

​

sandbox.ripgrep

• 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

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

​

sandbox.socatPath

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

​

sandbox.credentials

• 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

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

​

Entri kredensial tidak valid dalam pengaturan terkelola

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

​

sandbox.credentials.files

• 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

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

​

Bidang mask untuk file

{
  "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

• 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

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

​

Bidang mask untuk environment variable

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