> ## Documentation Index > Fetch the complete documentation index at: https://code.claude.com/docs/llms.txt > Use this file to discover all available pages before exploring further. # 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](#all-settings) Halaman referensi ini mencantumkan setiap kunci yang dibaca Claude Code dari file pengaturan, ditambah [kelompok kunci pendek](#global-config-settings) yang disimpannya di `~/.claude.json` sebagai gantinya. Untuk memilih file, atau memeriksa prioritas, mulai dengan [File pengaturan dan prioritas](https://code.claude.com/docs/id/settings.md). ## Indeks pengaturan Setiap kunci di bawah menautkan ke entrinya. Scope mencantumkan [file](https://code.claude.com/docs/id/settings.md#settings-files-and-who-they-affect) 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](https://code.claude.com/docs/id/managed-settings.md). `Any file` berarti keempat file tersebut, dan `Global config` berarti [`~/.claude.json`](#global-config-settings). | Key | Description | Topic | Scope | | :- | :- | :- | :- | | [`advisorModel`](#advisormodel) | Pilih model mana yang menjawab ketika Claude menggunakan [tool advisor](https://code.claude.com/docs/id/advisor.md) | Model dan respons | Any file | | [`agent`](#agent) | Mulai setiap sesi sebagai [subagent](https://code.claude.com/docs/id/sub-agents.md) bernama dengan prompt, tool, dan modelnya | Agents, sessions, and worktrees | Any file | | [`agentPushNotifEnabled`](#agentpushnotifenabled) | Biarkan Claude mengirim [notifikasi push ke ponsel Anda](https://code.claude.com/docs/id/remote-control.md#mobile-push-notifications) ketika Claude memutuskan untuk melakukannya | Remote, desktop, and notifications | Any file | | [`allowAllClaudeAiMcps`](#allowallclaudeaimcps) | Muat [konektor claude.ai](https://code.claude.com/docs/id/mcp.md) yang Claude Code ambil sendiri bersama dengan [`managed-mcp.json`](https://code.claude.com/docs/id/managed-mcp#exclusive-control-with-managed-mcp-json) yang diterapkan | MCP | Managed | | [`allowClaudeInChromeWithManagedMcp`](#allowclaudeinchromewithmanagedmcp) | Biarkan server [Claude in Chrome](https://code.claude.com/docs/id/chrome.md) bawaan berjalan bersama dengan [`managed-mcp.json`](https://code.claude.com/docs/id/managed-mcp#exclusive-control-with-managed-mcp-json) yang diterapkan | MCP | Managed | | [`allowedChannelPlugins`](#allowedchannelplugins) | Ganti allowlist default [plugin channel](https://code.claude.com/docs/id/channels.md#restrict-which-channel-plugins-can-run) yang dapat mendorong pesan | Plugins and skills | Managed | | [`allowedHttpHookUrls`](#allowedhttphookurls) | Batasi URL mana yang dapat ditargetkan oleh [HTTP hooks](https://code.claude.com/docs/id/hooks.md) | Hooks and automation | Any file | | [`allowedMcpServers`](#allowedmcpservers) | Buat allowlist [server MCP](https://code.claude.com/docs/id/mcp.md) mana yang dapat ditambahkan pengguna | MCP | Any file | | [`allowedProviders`](#allowedproviders) | Batasi [penyedia API](https://code.claude.com/docs/id/third-party-integrations.md) mana yang dapat digunakan mesin | Authentication and providers | Managed | | [`allowManagedHooksOnly`](#allowmanagedhooksonly) | Jalankan hanya [hooks](https://code.claude.com/docs/id/hooks.md) yang organisasi Anda terapkan | Hooks and automation | Managed | | [`allowManagedMcpServersOnly`](#allowmanagedmcpserversonly) | Buat allowlist [MCP](https://code.claude.com/docs/id/mcp.md) terkelola menjadi satu-satunya yang berlaku | MCP | Managed | | [`allowManagedPermissionRulesOnly`](#allowmanagedpermissionrulesonly) | Buat [pengaturan terkelola](https://code.claude.com/docs/id/managed-settings.md) menjadi satu-satunya sumber pengaturan [aturan izin](https://code.claude.com/docs/id/permissions.md#managed-settings) | Permission settings | Managed | | [`alwaysThinkingEnabled`](#alwaysthinkingenabled) | Matikan [extended thinking](https://code.claude.com/docs/id/model-config.md#extended-thinking) untuk setiap sesi | Model dan respons | Any file | | [`apiKeyHelper`](#apikeyhelper) | Hasilkan [kredensial API](https://code.claude.com/docs/id/authentication.md#credential-management) dengan perintah Anda sendiri | Authentication and providers | Any file | | [`askUserQuestionTimeout`](#askuserquestiontimeout) | Biarkan pertanyaan yang tidak terjawab [lanjut otomatis](https://code.claude.com/docs/id/tools-reference.md#question-auto-continue-timeout) setelah waktu idle | Interface and terminal | User or managed | | [`appendPlugins`](#appendplugins) | Jalankan [mods](https://code.claude.com/docs/id/plugins/mods/admin.md) organisasi Anda setelah setiap mod yang dipasang pengguna | Plugins and skills | User or managed | | [`attribution`](#attribution) | Sesuaikan atribusi yang Claude Code tambahkan ke commit dan pull request | Git and attribution | Any file | | [`attribution.commit`](#attribution-commit) | Ubah atau sembunyikan trailer yang Claude Code tambahkan ke commit | Git and attribution | Any file | | [`attribution.pr`](#attribution-pr) | Ubah atau sembunyikan baris atribusi dalam deskripsi pull request | Git and attribution | Any file | | [`attribution.sessionUrl`](#attribution-sessionurl) | Hilangkan tautan sesi claude.ai dari commit [cloud](https://code.claude.com/docs/id/claude-code-on-the-web.md) dan [Remote Control](https://code.claude.com/docs/id/remote-control.md) | Git and attribution | Any file | | [`autoCompactEnabled`](#autocompactenabled) | Matikan atau nyalakan [compaction otomatis](https://code.claude.com/docs/id/context-window.md) | Memory and context | Any file | | [`autoCompactWindow`](#autocompactwindow) | Atur seberapa penuh konteks sebelum Claude Code [melakukan compaction](https://code.claude.com/docs/id/context-window.md) | Memory and context | Any file | | [`autoConnectIde`](#autoconnectide) | Terhubung ke [VS Code](https://code.claude.com/docs/id/vs-code.md) atau [JetBrains](https://code.claude.com/docs/id/jetbrains.md#from-external-terminals) IDE yang sedang berjalan secara otomatis dari terminal eksternal | Global config settings | Global config | | [`autoContinueAtUsageLimit`](#autocontinueatusagelimit) | Tunggu di sesi terbuka dan [lanjutkan tugas secara otomatis](https://code.claude.com/docs/id/interactive-mode.md#wait-for-a-usage-limit-to-reset) setelah batas penggunaan claude.ai direset | Interface and terminal | User or managed | | [`autoInstallIdeExtension`](#autoinstallideextension) | Matikan instalasi otomatis [ekstensi IDE](https://code.claude.com/docs/id/vs-code.md#install-the-extension) dari terminal VS Code | Global config settings | Global config | | [`autoMemoryDirectory`](#automemorydirectory) | Simpan [auto memory](https://code.claude.com/docs/id/memory.md#auto-memory) di direktori pilihan Anda | Memory and context | Any file | | [`autoMemoryEnabled`](#automemoryenabled) | Matikan atau nyalakan [auto memory](https://code.claude.com/docs/id/memory.md#auto-memory) | Memory and context | Any file | | [`autoMode`](#automode) | Tambahkan aturan izinkan dan tolak Anda sendiri ke pengklasifikasi [auto mode](https://code.claude.com/docs/id/permission-modes.md#eliminate-prompts-with-auto-mode) | Permission settings | User or managed | | [`autoMode.classifyAllShell`](#automode-classifyallshell) | Kirim setiap perintah shell melalui [pengklasifikasi auto mode](https://code.claude.com/docs/id/permission-modes.md#what-the-classifier-blocks-by-default), bahkan yang cocok dengan aturan izinkan yang sempit | Permission settings | User or managed | | [`autoScrollEnabled`](#autoscrollenabled) | [Ikuti output baru](https://code.claude.com/docs/id/fullscreen.md#auto-follow) ke bawah dalam rendering fullscreen | Interface and terminal | Any file | | [`autoUpdatesChannel`](#autoupdateschannel) | Ikuti [saluran rilis](https://code.claude.com/docs/id/setup.md#configure-release-channel) stabil daripada terbaru | Updates and versioning | Any file | | [`availableModels`](#availablemodels) | [Batasi model mana](https://code.claude.com/docs/id/model-config.md#restrict-model-selection) yang dapat dipilih orang | Model dan respons | Any file | | [`availableModelsMatch`](#availablemodelsmatch) | Buat setiap entri ID model `availableModels` [hanya mengizinkan versi yang dinamainya](https://code.claude.com/docs/id/model-config.md#block-specific-models-or-versions) | Model dan respons | Managed | | [`awaySummaryEnabled`](#awaysummaryenabled) | Matikan [ringkasan sesi](https://code.claude.com/docs/id/interactive-mode.md#session-recap) yang ditampilkan ketika Anda kembali ke terminal | Remote, desktop, and notifications | Any file | | [`awsAuthRefresh`](#awsauthrefresh) | Segarkan [kredensial Bedrock](https://code.claude.com/docs/id/amazon-bedrock.md#advanced-credential-configuration) yang kedaluwarsa di `.aws` dengan perintah Anda sendiri | Authentication and providers | Any file | | [`awsCredentialExport`](#awscredentialexport) | Sediakan [kredensial Bedrock](https://code.claude.com/docs/id/amazon-bedrock.md#advanced-credential-configuration) sebagai JSON dari perintah Anda sendiri | Authentication and providers | Any file | | [`axScreenReader`](#axscreenreader) | Render [output yang ramah pembaca layar](https://code.claude.com/docs/id/accessibility.md) | Interface and terminal | User or managed | | [`bashEditDiffEnabled`](#basheditdiffenabled) | Catat [file yang berubah saat perintah Bash berjalan](https://code.claude.com/docs/id/hooks.md#bash) dalam setiap mode izin | Interface and terminal | User or managed | | [`bashOutputMaxChars`](#bashoutputmaxchars) | Atur berapa banyak [output](https://code.claude.com/docs/id/tools-reference.md#output-limits) perintah yang berhasil yang Claude terima secara inline | Memory and context | Any file | | [`blockedMarketplaces`](#blockedmarketplaces) | Blokir sumber [marketplace plugin](https://code.claude.com/docs/id/plugins/overview.md) untuk organisasi Anda | Plugins and skills | Managed | | [`browserExternalPageTools`](#browserexternalpagetools) | Jauhkan tool Claude dari halaman eksternal dalam pane Browser [desktop](https://code.claude.com/docs/id/desktop.md) | Tools | Managed | | [`channelsEnabled`](#channelsenabled) | Izinkan [channel](https://code.claude.com/docs/id/channels.md#enable-channels-for-your-organization) untuk organisasi Anda | Plugins and skills | Managed | | [`claudeInChromeDefaultEnabled`](#claudeinchromedefaultenabled) | Nyalakan [integrasi Chrome](https://code.claude.com/docs/id/chrome.md) saat sesi dimulai, di CLI interaktif dan ekstensi VS Code | Global config settings | Global config | | [`claudeMd`](#claudemd) | Injeksikan instruksi [CLAUDE.md](https://code.claude.com/docs/id/memory.md#deploy-organization-wide-claude-md) di seluruh organisasi dari pengaturan terkelola | Memory and context | Managed | | [`claudeMdExcludes`](#claudemdexcludes) | Lewati file [CLAUDE.md](https://code.claude.com/docs/id/memory.md#exclude-specific-claude-md-files) tertentu ketika memori dimuat | Memory and context | Any file | | [`cleanupPeriodDays`](#cleanupperioddays) | Pilih berapa hari Claude Code menyimpan [transkrip](https://code.claude.com/docs/id/data-usage.md#data-retention) sebelum menghapusnya | Privacy and telemetry | Any file | | [`companyAnnouncements`](#companyannouncements) | Tampilkan pengumuman organisasi Anda saat startup | Interface and terminal | Any file | | [`copyFullResponse`](#copyfullresponse) | Buat [`/copy`](https://code.claude.com/docs/id/commands) menyalin respons lengkap tanpa menampilkan pemilih | Global config settings | Global config | | [`copyOnSelect`](#copyonselect) | Matikan penyalinan otomatis teks yang Anda pilih dengan mouse dalam [rendering fullscreen](https://code.claude.com/docs/id/fullscreen.md#use-the-mouse) dan tampilan agent | Global config settings | Global config | | [`crossSessionInbound`](#crosssessioninbound) | Pilih apakah Claude Code mengirimkan [pesan dari sesi lain Anda](https://code.claude.com/docs/id/cross-session-messaging.md#control-inbound-messages), menampilkan pemberitahuan tanpa mengirimkannya, atau menolaknya | Agents, sessions, and worktrees | Any file | | [`defaultShell`](#defaultshell) | Pilih apakah Bash atau PowerShell menjalankan perintah shell yang Anda ketik dengan awalan [`!`](https://code.claude.com/docs/id/interactive-mode#shell-mode-with-prefix) | Interface and terminal | Any file | | [`defaultToAgentsView`](#defaulttoagentsview) | Buka [tampilan agent](https://code.claude.com/docs/id/agent-view.md) daripada percakapan baru ketika Anda menjalankan `claude` tanpa argumen | Global config settings | Global config | | [`deniedMcpServers`](#deniedmcpservers) | Blokir [server MCP](https://code.claude.com/docs/id/mcp.md) tertentu berdasarkan URL, perintah, atau nama | MCP | Any file | | [`deniedModels`](#deniedmodels) | [Blokir model tertentu](https://code.claude.com/docs/id/model-config.md#block-specific-models-or-versions), bahkan yang `availableModels` izinkan | Model dan respons | Managed | | [`desktopSessionCleanupPeriodDays`](#desktopsessioncleanupperioddays) | Atur batas usia dalam hari untuk [transkrip Claude Desktop dan Cowork](https://code.claude.com/docs/id/claude-directory.md#cleaned-up-automatically) | Privacy and telemetry | User or managed | | [`dialogExpiry`](#dialogexpiry) | Atur berapa lama Claude Code menunggu [Remote Control](https://code.claude.com/docs/id/remote-control.md) atau host SDK menjawab dialog yang diteruskan sebelum membatalkan dialog | Interface and terminal | User or managed | | [`diffTool`](#difftool) | Pilih apakah perubahan file yang diusulkan Claude terbuka di penampil diff [VS Code](https://code.claude.com/docs/id/vs-code.md) atau [JetBrains](https://code.claude.com/docs/id/jetbrains.md#features) atau tetap di terminal | Global config settings | Global config | | [`disableAgentView`](#disableagentview) | Matikan agent latar belakang dan [tampilan agent](https://code.claude.com/docs/id/agent-view.md) | Agents, sessions, and worktrees | Any file | | [`disableAllHooks`](#disableallhooks) | Matikan [hooks](https://code.claude.com/docs/id/hooks.md), [baris status](https://code.claude.com/docs/id/statusline.md) kustom, dan perintah saran file [`@`](https://code.claude.com/docs/id/interactive-mode#quick-commands) kustom sekaligus | Hooks and automation | Any file | | [`disableArtifact`](#disableartifact) | Deprecated; gunakan `enableArtifact` untuk mematikan [tool Artifact](https://code.claude.com/docs/id/artifacts.md) | Remote, desktop, and notifications | Any file | | [`disableAutoMode`](#disableautomode) | Hapus [auto mode](https://code.claude.com/docs/id/permission-modes.md#eliminate-prompts-with-auto-mode) dari siklus mode izin | Permission settings | Any file | | [`disableBrowserExternalNavigation`](#disablebrowserexternalnavigation) | Batasi pane Browser [desktop](https://code.claude.com/docs/id/desktop.md) ke localhost untuk orang dan Claude | Tools | Managed | | [`disableBundledSkills`](#disablebundledskills) | Matikan [skill](https://code.claude.com/docs/id/skills.md#bundled-skills) dan [workflow](https://code.claude.com/docs/id/workflows.md) yang disertakan dengan Claude Code | Plugins and skills | Any file | | [`disableClaudeAiConnectors`](#disableclaudeaiconnectors) | Matikan [konektor claude.ai](https://code.claude.com/docs/id/mcp.md#disable-claude-ai-connectors) sehingga Claude Code tidak mengambilnya | MCP | Any file | | [`disableCommandPluginSources`](#disablecommandpluginsources) | Blokir [plugin](https://code.claude.com/docs/id/plugins/overview.md) yang dipasang dengan menjalankan perintah yang dideklarasikan marketplace | Plugins and skills | Managed | | [`disableDeepLinkRegistration`](#disabledeeplinkregistration) | Hentikan Claude Code dari mendaftarkan penanganan [`claude-cli://`](https://code.claude.com/docs/id/deep-links) | Remote, desktop, and notifications | Any file | | [`disableDesktopLocalSessions`](#disabledesktoplocalsessions) | Matikan sesi [Desktop Code](https://code.claude.com/docs/id/desktop.md#local-sessions-on-managed-devices) yang berjalan di perangkat, meninggalkan SSH untuk host lain dan cloud | Remote, desktop, and notifications | Managed | | [`disabledMcpjsonServers`](#disabledmcpjsonservers) | Tolak server tertentu dari [`.mcp.json`](https://code.claude.com/docs/id/mcp#project-scope) proyek | MCP | Any file | | [`disableMobileSimulatorTools`](#disablemobilesimulatortools) | Blokir tool Claude dalam pane iOS Simulator [desktop](https://code.claude.com/docs/id/desktop.md) | Tools | Managed | | [`disableRemoteControl`](#disableremotecontrol) | Matikan [Remote Control](https://code.claude.com/docs/id/remote-control.md) di mana pun dapat dimulai | Remote, desktop, and notifications | Any file | | [`disableSideloadFlags`](#disablesideloadflags) | Tolak flag CLI yang sideload [plugin](https://code.claude.com/docs/id/plugins/overview.md), [subagent](https://code.claude.com/docs/id/sub-agents.md), dan [server MCP](https://code.claude.com/docs/id/mcp.md) | Enterprise and managed settings | Managed | | [`disableSkillShellExecution`](#disableskillshellexecution) | Hentikan [skill](https://code.claude.com/docs/id/skills.md) dan perintah kustom dari menjalankan shell inline | Plugins and skills | Any file | | [`disableWorkflows`](#disableworkflows) | Matikan [workflow dinamis](https://code.claude.com/docs/id/workflows.md) untuk semua orang; gunakan `enableWorkflows` untuk diri sendiri | Hooks and automation | Any file | | [`editorMode`](#editormode) | Gunakan [pintasan keyboard vim](https://code.claude.com/docs/id/interactive-mode.md#vim-editor-mode) dalam prompt input | Interface and terminal | Any file | | [`effortLevel`](#effortlevel) | Atur [tingkat effort](https://code.claude.com/docs/id/model-config.md#adjust-effort-level) default untuk model tanpa tingkat yang disimpan | Model dan respons | Any file | | [`emojiCompletionEnabled`](#emojicompletionenabled) | Matikan saran dan penggantian emoji [`:shortcode:`](https://code.claude.com/docs/id/interactive-mode#emoji-shortcodes) dalam input prompt | Interface and terminal | Any file | | [`enableAllProjectMcpServers`](#enableallprojectmcpservers) | Setujui setiap server dalam file [`.mcp.json`](https://code.claude.com/docs/id/mcp#project-server-approvals-and-workspace-trust) proyek tanpa prompt | MCP | Any file | | [`enableArtifact`](#enableartifact) | Matikan [tool Artifact](https://code.claude.com/docs/id/artifacts.md) dengan `false` di file mana pun; tidak ada file yang dapat menghidupkannya kembali | Remote, desktop, and notifications | Any file | | [`enabledMcpjsonServers`](#enabledmcpjsonservers) | Setujui server tertentu dari [`.mcp.json`](https://code.claude.com/docs/id/mcp#project-server-approvals-and-workspace-trust) proyek | MCP | Any file | | [`enabledPlugins`](#enabledplugins) | Nyalakan atau matikan [plugin](https://code.claude.com/docs/id/plugins/overview.md) individual per cakupan | Plugins and skills | Any file | | [`enableWorkflows`](#enableworkflows) | Nyalakan atau matikan [workflow dinamis](https://code.claude.com/docs/id/workflows.md) terhadap default paket Anda | Hooks and automation | Any file | | [`enforceAvailableModels`](#enforceavailablemodels) | Jaga [pilihan Default `/model`](https://code.claude.com/docs/id/model-config#enforce-the-allowlist-for-the-default-model) tetap dalam allowlist `availableModels` Anda | Model dan respons | Any file | | [`env`](#env) | Atur [environment variable](https://code.claude.com/docs/id/env-vars.md#in-settings-files) untuk setiap sesi dan subproses-nya | Memory and context | Any file | | [`externalEditorContext`](#externaleditorcontext) | Tampilkan respons terakhir Claude sebagai komentar ketika Anda menekan [Ctrl+G](https://code.claude.com/docs/id/interactive-mode.md#general-controls) untuk mengedit | Global config settings | Global config | | [`extraKnownMarketplaces`](#extraknownmarketplaces) | Daftarkan [marketplace](https://code.claude.com/docs/id/plugins/overview.md) untuk repositori atau organisasi | Plugins and skills | Any file | | [`fallbackModel`](#fallbackmodel) | Beri nama [model cadangan](https://code.claude.com/docs/id/model-config.md#fallback-model-chains) untuk ketika model utama kelebihan beban | Model dan respons | Any file | | [`fastMode`](#fastmode) | Nyalakan [fast mode](https://code.claude.com/docs/id/fast-mode.md) untuk sesi tempat fitur tersebut tersedia | Model dan respons | Any file | | [`fastModePerSessionOptIn`](#fastmodepersessionoptin) | Wajibkan orang untuk menyalakan [fast mode](https://code.claude.com/docs/id/fast-mode.md) setiap sesi | Model dan respons | Any file | | [`feedbackDrafts`](#feedbackdrafts) | Kontrol apakah Claude mengantre [draft umpan balik](https://code.claude.com/docs/id/tools-reference.md#sendfeedback-tool-behavior) untuk Anda tinjau | Privacy and telemetry | User or managed | | [`feedbackSurveyRate`](#feedbacksurveyrate) | Ubah seberapa sering [survei kualitas sesi](https://code.claude.com/docs/id/data-usage.md#session-quality-surveys) muncul | Privacy and telemetry | Any file | | [`fileCheckpointingEnabled`](#filecheckpointingenabled) | Matikan atau nyalakan snapshot file yang [`/rewind`](https://code.claude.com/docs/id/checkpointing) pulihkan | Memory and context | Any file | | [`fileSuggestion`](#filesuggestion) | Sediakan pelengkapan otomatis file [`@`](https://code.claude.com/docs/id/interactive-mode#quick-commands) dari perintah Anda sendiri | Interface and terminal | Any file | | [`footerLinksRegexes`](#footerlinksregexes) | Buat ID masalah atau tinjauan dalam output menjadi [tautan yang dapat diklik](https://code.claude.com/docs/id/statusline.md#clickable-links) di bawah kotak input | Interface and terminal | User or managed | | [`forceLoginGatewayUrl`](#forcelogingatewayurl) | Atur [URL gateway](https://code.claude.com/docs/id/claude-apps-gateway#set-the-gateway-url) yang dihubungi layar login | Authentication and providers | User or managed | | [`forceLoginMethod`](#forceloginmethod) | [Batasi login](https://code.claude.com/docs/id/authentication.md#restrict-login-to-your-organization) ke claude.ai, Claude Console, atau [gateway cloud](https://code.claude.com/docs/id/claude-apps-gateway) | Authentication and providers | Any file | | [`forceLoginOrgUUID`](#forceloginorguuid) | [Pin login claude.ai ke organisasi Anda](https://code.claude.com/docs/id/authentication.md#restrict-login-to-your-organization); hanya sumber terkelola yang memberlakukannya | Authentication and providers | Any file | | [`forceRemoteSettingsRefresh`](#forceremotesettingsrefresh) | Blokir startup hingga [pengaturan yang dikelola server](https://code.claude.com/docs/id/server-managed-settings.md) selesai diambil ulang | Enterprise and managed settings | Managed | | [`gatewayInternalNetworks`](#gatewayinternalnetworks) | Biarkan `/login` menjangkau [gateway cloud](https://code.claude.com/docs/id/claude-apps-gateway#allow-a-gateway-on-public-address-space-you-own) pada ruang IPv4 publik yang organisasi Anda gunakan secara internal | Authentication and providers | Managed | | [`gcpAuthRefresh`](#gcpauthrefresh) | Segarkan [kredensial Google Cloud](https://code.claude.com/docs/id/google-vertex-ai.md#advanced-credential-configuration) dengan perintah Anda sendiri | Authentication and providers | Any file | | [`hooks`](#hooks) | Jalankan perintah Anda sendiri sebagai [hooks](https://code.claude.com/docs/id/hooks.md) pada titik dalam siklus hidup Claude Code | Hooks and automation | Any file | | [`httpHookAllowedEnvVars`](#httphookallowedenvvars) | Batasi variabel env mana yang dapat dimasukkan [HTTP hooks](https://code.claude.com/docs/id/hooks.md) ke header | Hooks and automation | Any file | | [`idleCompaction`](#idlecompaction) | Hentikan Claude Code dari melakukan compaction pada percakapan panjang saat sesi terminal Anda idle | Memory and context | Any file | | [`includeCoAuthoredBy`](#includecoauthoredby) | Deprecated; gunakan `attribution` untuk menyembunyikan atau mengubah atribusi commit dan PR | Git and attribution | Any file | | [`includeGitInstructions`](#includegitinstructions) | Hapus instruksi commit dan PR bawaan dari konteks Claude | Git and attribution | Any file | | [`inputNeededNotifEnabled`](#inputneedednotifenabled) | Dapatkan [notifikasi push](https://code.claude.com/docs/id/remote-control.md#mobile-push-notifications) ketika Claude menunggu Anda | Remote, desktop, and notifications | Any file | | [`isolatePeerMachines`](#isolatepeermachines) | Tanyakan Anda sebelum Claude [mengirim pesan ke salah satu sesi Anda di mesin lain](https://code.claude.com/docs/id/cross-session-messaging.md#require-approval-for-cross-machine-messages) | Agents, sessions, and worktrees | Any file | | [`keybindingFlavor`](#keybindingflavor) | Deprecated dan tidak berpengaruh; pintasan pengeditan kata selalu [mengikuti konvensi readline](https://code.claude.com/docs/id/interactive-mode.md#make-ctrl-w-delete-back-to-whitespace) | Interface and terminal | Any file | | [`language`](#language) | Biarkan Claude merespons dalam bahasa selain Inggris | Model dan respons | Any file | | [`leftArrowOpensAgents`](#leftarrowopensagents) | Matikan pintasan `←` yang [menempatkan sesi di latar belakang dan membuka tampilan agent](https://code.claude.com/docs/id/agent-view.md#switch-sessions-without-leaving-the-terminal) | Global config settings | Global config | | [`managedMcpServers`](#managedmcpservers) | Sediakan [server MCP](https://code.claude.com/docs/id/managed-mcp.md#provide-servers-through-managed-settings) jarak jauh kepada setiap pengguna bersama dengan yang mereka tambahkan | MCP | Managed | | [`managedSourcesBehavior`](#managedsourcesbehavior) | Gabungkan setiap [sumber terkelola](https://code.claude.com/docs/id/managed-settings.md#how-claude-code-combines-managed-sources) yang Anda terapkan daripada hanya menggunakan sumber dengan prioritas tertinggi | Enterprise and managed settings | Managed | | [`maxEffortLevel`](#maxeffortlevel) | Batasi [tingkat effort](https://code.claude.com/docs/id/model-config.md#adjust-effort-level) untuk setiap model atau per model, di setiap penyedia | Model dan respons | Any file | | [`maxProseWidth`](#maxprosewidth) | Batasi seberapa lebar prosa dalam respons Claude berjalan di terminal yang lebar | Interface and terminal | Any file | | [`minimumVersion`](#minimumversion) | Cegah [pembaruan otomatis](https://code.claude.com/docs/id/setup.md#pin-a-minimum-version) memasang apa pun di bawah suatu versi | Updates and versioning | Any file | | [`model`](#model) | Ubah [model](https://code.claude.com/docs/id/model-config.md#set-a-default-model-for-new-sessions) yang digunakan Claude Code saat dimulai | Model dan respons | Any file | | [`modelOverrides`](#modeloverrides) | [Petakan ID model](https://code.claude.com/docs/id/model-config.md#override-model-ids-per-version) ke ID penyedia Anda, seperti ARN Bedrock | Model dan respons | Any file | | [`modelPicker`](#modelpicker) | Pilih model mana yang dicantumkan oleh [pemilih `/model`](https://code.claude.com/docs/id/model-config#available-models), dalam urutan Anda sendiri dan dengan label Anda sendiri | Model dan respons | User or managed | | [`modelPricing`](#modelpricing) | Laporkan pengeluaran dengan tarif kontrak organisasi Anda daripada harga daftar | Model dan respons | Managed | | [`modelSettings`](#modelsettings) | Simpan [tingkat effort](https://code.claude.com/docs/id/model-config.md#adjust-effort-level) atau [jendela auto-compact](https://code.claude.com/docs/id/model-config.md#set-the-auto-compact-window) per model, atau batasi effort satu model | Model dan respons | Any file | | [`otelHeadersHelper`](#otelheadershelper) | Hasilkan header [OpenTelemetry](https://code.claude.com/docs/id/monitoring-usage.md#dynamic-headers) yang berputar dengan perintah Anda sendiri | Authentication and providers | Any file | | [`outputStyle`](#outputstyle) | Ubah peran, nada, dan format output Claude dengan [gaya output](https://code.claude.com/docs/id/output-styles.md) | Model dan respons | Any file | | [`parentSettingsBehavior`](#parentsettingsbehavior) | Terapkan atau lepaskan pembatasan yang diteruskan oleh [host SDK atau IDE](https://code.claude.com/docs/id/managed-settings.md#let-an-embedding-host-add-policy) ketika Anda menerapkan [pengaturan terkelola](https://code.claude.com/docs/id/managed-settings.md) | Enterprise and managed settings | Managed | | [`permissionExplainerEnabled`](#permissionexplainerenabled) | Dihapus di v2.1.257, bersama dengan penjelasan perintah `Ctrl+E` pada permintaan izin shell | Global config settings | Global config | | [`permissions`](#permissions) | Atur aturan izinkan, tanya, dan tolak serta [mode izin](https://code.claude.com/docs/id/permission-modes.md) awal | Permission settings | Any file | | [`permissions.additionalDirectories`](#permissions-additionaldirectories) | Berikan Claude akses file ke [direktori di luar direktori saat ini](https://code.claude.com/docs/id/permissions.md#working-directories) | Permission settings | Any file | | [`permissions.allow`](#permissions-allow) | Setujui [penggunaan tool](https://code.claude.com/docs/id/permissions.md#permission-rule-syntax) yang tercantum tanpa prompt | Permission settings | Any file | | [`permissions.ask`](#permissions-ask) | Selalu minta konfirmasi sebelum [penggunaan tool](https://code.claude.com/docs/id/permissions.md#permission-rule-syntax) yang tercantum | Permission settings | Any file | | [`permissions.blockReadsOutsideWorkingDirectories`](#permissions-blockreadsoutsideworkingdirectories) | Buat tool file menolak pembacaan di luar [direktori kerja](https://code.claude.com/docs/id/permissions.md#working-directories) dalam setiap mode izin | Permission settings | Any file | | [`permissions.defaultMode`](#permissions-defaultmode) | Atur [mode izin](https://code.claude.com/docs/id/permission-modes.md#which-mode-a-session-starts-in) yang digunakan sesi baru saat dimulai | Permission settings | Any file | | [`permissions.deny`](#permissions-deny) | Blokir [penggunaan tool](https://code.claude.com/docs/id/permissions.md#permission-rule-syntax) yang tercantum, termasuk pembacaan file yang menyimpan rahasia | Permission settings | Any file | | [`permissions.disableBypassPermissionsMode`](#permissions-disablebypasspermissionsmode) | Cegah siapa pun memasuki [mode bypassPermissions](https://code.claude.com/docs/id/permission-modes.md#skip-all-checks-with-bypasspermissions-mode) | Permission settings | Any file | | [`plansDirectory`](#plansdirectory) | Pilih tempat [plan mode](https://code.claude.com/docs/id/permission-modes.md#analyze-before-you-edit-with-plan-mode) menulis file rencana | Memory and context | Any file | | [`pluginConfigs`](#pluginconfigs) | Simpan jawaban yang Anda berikan pada dialog konfigurasi [plugin](https://code.claude.com/docs/id/plugins/overview.md) | Plugins and skills | User or managed | | [`pluginSuggestionMarketplaces`](#pluginsuggestionmarketplaces) | Pilih [marketplace](https://code.claude.com/docs/id/plugins/org.md#restrict-what-users-can-install) mana yang dapat menampilkan saran instalasi plugin di `/plugin` | Plugins and skills | Managed | | [`pluginTrustMessage`](#plugintrustmessage) | Tambahkan teks Anda sendiri ke peringatan kepercayaan [plugin](https://code.claude.com/docs/id/plugins/overview.md) | Plugins and skills | Managed | | [`policyHelper`](#policyhelper) | Jalankan executable yang menghitung [pengaturan terkelola](https://code.claude.com/docs/id/managed-settings.md#compute-the-policy-with-a-helper-program) saat startup | Enterprise and managed settings | Managed | | [`policyHelper.path`](#policyhelper-path) | Beri nama [executable pembantu](https://code.claude.com/docs/id/managed-settings.md#compute-the-policy-with-a-helper-program) yang Claude Code jalankan | Enterprise and managed settings | Managed | | [`policyHelper.refreshIntervalMs`](#policyhelper-refreshintervalms) | Jalankan kembali [pembantu](https://code.claude.com/docs/id/managed-settings.md#compute-the-policy-with-a-helper-program) di latar belakang pada interval | Enterprise and managed settings | Managed | | [`policyHelper.timeoutMs`](#policyhelper-timeoutms) | Atur berapa lama Claude Code menunggu [pembantu](https://code.claude.com/docs/id/managed-settings.md#compute-the-policy-with-a-helper-program) | Enterprise and managed settings | Managed | | [`preferredNotifChannel`](#preferrednotifchannel) | Pilih [bel terminal atau notifikasi desktop](https://code.claude.com/docs/id/terminal-config.md#get-a-terminal-bell-or-notification) untuk penyelesaian tugas | Remote, desktop, and notifications | Any file | | [`prefersReducedMotion`](#prefersreducedmotion) | [Kurangi atau matikan](https://code.claude.com/docs/id/accessibility.md#accessibility-settings) animasi spinner, shimmer, dan flash | Interface and terminal | Any file | | [`prependPlugins`](#prependplugins) | Jalankan [mods](https://code.claude.com/docs/id/plugins/mods/admin.md) organisasi Anda sebelum setiap mod yang dipasang pengguna | Plugins and skills | User or managed | | [`processWrapper`](#processwrapper) | Jalankan proses latar belakang Claude Code melalui [peluncur perusahaan](https://code.claude.com/docs/id/corporate-launcher.md) di macOS dan Linux | Agents, sessions, and worktrees | User or managed | | [`promptCacheTtl`](#promptcachettl) | Pilih [masa pakai cache prompt](https://code.claude.com/docs/id/prompt-caching.md#cache-lifetime) untuk percakapan utama | Model dan respons | Any file | | [`promptSuggestionEnabled`](#promptsuggestionenabled) | Sembunyikan [saran prompt](https://code.claude.com/docs/id/interactive-mode.md#prompt-suggestions) berwarna abu-abu dalam kotak input | Interface and terminal | Any file | | [`prStatusFooterEnabled`](#prstatusfooterenabled) | Matikan lencana [status tinjauan PR](https://code.claude.com/docs/id/interactive-mode.md#pr-review-status) di footer prompt dan pemeriksaan pull request di baliknya | Global config settings | Global config | | [`prUrlTemplate`](#prurltemplate) | Arahkan tautan PR ke alat code review internal daripada github.com | Git and attribution | Any file | | [`remote.defaultEnvironmentId`](#remote-defaultenvironmentid) | Pilih [lingkungan cloud](https://code.claude.com/docs/id/cloud-environments.md) default untuk `claude --cloud`; ID `ccpool_` yang di-host sendiri hanya dibaca dari pengaturan pengguna dan terkelola serta `--settings` | Remote, desktop, and notifications | Any file | | [`remoteControlAtStartup`](#remotecontrolatstartup) | Hubungkan [Remote Control](https://code.claude.com/docs/id/remote-control.md#enable-remote-control-for-all-sessions) secara otomatis ketika sesi dimulai | Remote, desktop, and notifications | Any file | | [`requiredMaximumVersion`](#requiredmaximumversion) | [Tolak untuk memulai](https://code.claude.com/docs/id/setup.md#pin-a-minimum-version) pada versi yang lebih baru daripada yang diizinkan organisasi Anda | Updates and versioning | Managed | | [`requiredMinimumVersion`](#requiredminimumversion) | [Tolak untuk memulai](https://code.claude.com/docs/id/setup.md#pin-a-minimum-version) pada versi yang lebih lama daripada yang diwajibkan organisasi Anda | Updates and versioning | Managed | | [`respectGitignore`](#respectgitignore) | Jauhkan file yang diabaikan git dari [pemilih file `@`](https://code.claude.com/docs/id/interactive-mode#quick-commands) | Interface and terminal | Any file | | [`respondToBashCommands`](#respondtobashcommands) | Hentikan Claude dari merespons setelah [perintah shell `!`](https://code.claude.com/docs/id/interactive-mode#shell-mode-with-prefix) berjalan | Interface and terminal | Any file | | [`sandbox`](#sandbox) | [Isolasi perintah Bash](https://code.claude.com/docs/id/sandboxing.md) dari sistem file dan jaringan Anda di macOS, Linux, dan WSL2 | Sandbox settings | Any file | | [`sandbox.allowAppleEvents`](#sandbox-allowappleevents) | Biarkan perintah [bersandbox](https://code.claude.com/docs/id/sandboxing.md) mengirim Apple Events di macOS | Sandbox settings | User or managed | | [`sandbox.allowNestedUserNamespaces`](#sandbox-allownestedusernamespaces) | Biarkan perintah [bersandbox](https://code.claude.com/docs/id/sandboxing.md#chromium-or-rootless-podman-fails-inside-the-sandbox-on-linux) membuat user namespace di Linux dan WSL2 | Sandbox settings | User or managed | | [`sandbox.allowUnsandboxedCommands`](#sandbox-allowunsandboxedcommands) | Biarkan Claude mencoba ulang perintah yang diblokir di luar [sandbox](https://code.claude.com/docs/id/sandboxing.md#the-unsandboxed-retry-escape-hatch), atau larang hal itu | Sandbox settings | Any file | | [`sandbox.autoAllowBashIfSandboxed`](#sandbox-autoallowbashifsandboxed) | Jalankan perintah [bersandbox](https://code.claude.com/docs/id/sandboxing.md#auto-allow-mode) tanpa permintaan izin | Sandbox settings | Any file | | [`sandbox.bwrapPath`](#sandbox-bwrappath) | Arahkan [sandbox](https://code.claude.com/docs/id/sandboxing.md) ke biner bubblewrap di luar `PATH` | Sandbox settings | Managed | | [`sandbox.credentials`](#sandbox-credentials) | Sembunyikan atau samarkan file kredensial dan variabel di dalam [sandbox](https://code.claude.com/docs/id/sandboxing.md#protect-credentials) | Sandbox settings | Any file | | [`sandbox.credentials.allowPlaintextInject`](#sandbox-credentials-allowplaintextinject) | Biarkan [kredensial yang disamarkan](https://code.claude.com/docs/id/sandboxing.md#mask-credentials) mencapai layanan HTTP biasa di jaringan uji terpercaya | Sandbox settings | User or managed | | [`sandbox.credentials.awsPairs`](#sandbox-credentials-awspairs) | Tautkan variabel kunci AWS bernama kustom ke satu kredensial untuk [penandatanganan ulang](https://code.claude.com/docs/id/sandboxing.md#re-sign-aws-requests) | Sandbox settings | User or managed | | [`sandbox.credentials.envVars`](#sandbox-credentials-envvars) | Hapus atau samarkan environment variable di dalam [sandbox](https://code.claude.com/docs/id/sandboxing.md#mask-environment-variables) | Sandbox settings | Any file | | [`sandbox.credentials.files`](#sandbox-credentials-files) | Blokir atau samarkan pembacaan file kredensial di dalam [sandbox](https://code.claude.com/docs/id/sandboxing.md#mask-credential-files) | Sandbox settings | Any file | | [`sandbox.credentials.sigv4`](#sandbox-credentials-sigv4) | Pilih apakah permintaan streaming, presigned, atau [AWS SigV4A](https://code.claude.com/docs/id/sandboxing.md#re-sign-aws-requests) gagal atau diteruskan | Sandbox settings | User or managed | | [`sandbox.enabled`](#sandbox-enabled) | Nyalakan [sandboxing Bash](https://code.claude.com/docs/id/sandboxing.md#get-started) di macOS, Linux, dan WSL2 | Sandbox settings | Any file | | [`sandbox.enableWeakerNestedSandbox`](#sandbox-enableweakernestedsandbox) | Jalankan [sandbox](https://code.claude.com/docs/id/sandboxing.md) Linux di dalam kontainer yang tidak istimewa | Sandbox settings | Any file | | [`sandbox.enableWeakerNetworkIsolation`](#sandbox-enableweakernetworkisolation) | Biarkan `gh`, `gcloud`, dan `terraform` memverifikasi TLS di balik proxy MITM di dalam [sandbox](https://code.claude.com/docs/id/sandboxing.md#go-based-clis-fail-tls-verification-on-macos) di macOS | Sandbox settings | Any file | | [`sandbox.excludedCommands`](#sandbox-excludedcommands) | Beri nama perintah yang dapat dijalankan Claude Code di luar [sandbox](https://code.claude.com/docs/id/sandboxing.md) | Sandbox settings | Any file | | [`sandbox.failIfUnavailable`](#sandbox-failifunavailable) | Tolak untuk memulai ketika [sandbox](https://code.claude.com/docs/id/sandboxing.md) tidak dapat dimulai, daripada berjalan tanpa sandbox | Sandbox settings | Any file | | [`sandbox.filesystem`](#sandbox-filesystem) | Kontrol jalur mana yang dapat dibaca dan ditulis perintah [bersandbox](https://code.claude.com/docs/id/sandboxing.md#filesystem-isolation) | Sandbox settings | Any file | | [`sandbox.filesystem.allowManagedReadPathsOnly`](#sandbox-filesystem-allowmanagedreadpathsonly) | Hentikan pengembang dari membuka kembali [jalur baca yang diblokir organisasi Anda](https://code.claude.com/docs/id/sandboxing.md#keep-developers-from-widening-the-policy) | Sandbox settings | Managed | | [`sandbox.filesystem.allowRead`](#sandbox-filesystem-allowread) | Buka kembali pembacaan di dalam wilayah yang diblokir [`denyRead`](#sandbox-filesystem-denyread) | Sandbox settings | Any file | | [`sandbox.filesystem.allowWrite`](#sandbox-filesystem-allowwrite) | Tambahkan jalur yang dapat ditulis perintah [bersandbox](https://code.claude.com/docs/id/sandboxing.md) | Sandbox settings | Any file | | [`sandbox.filesystem.denyRead`](#sandbox-filesystem-denyread) | Blokir perintah [bersandbox](https://code.claude.com/docs/id/sandboxing.md) dari membaca jalur tertentu | Sandbox settings | Any file | | [`sandbox.filesystem.denyWrite`](#sandbox-filesystem-denywrite) | Blokir perintah [bersandbox](https://code.claude.com/docs/id/sandboxing.md) dari menulis ke jalur tertentu | Sandbox settings | Any file | | [`sandbox.filesystem.disabled`](#sandbox-filesystem-disabled) | [Matikan isolasi sistem file](https://code.claude.com/docs/id/sandboxing.md#disable-filesystem-isolation) sambil tetap mempertahankan isolasi jaringan | Sandbox settings | User or managed | | [`sandbox.ignoreViolations`](#sandbox-ignoreviolations) | Senyapkan laporan pelanggaran untuk jalur yang memang diperkirakan akan diperiksa oleh suatu perintah | Sandbox settings | Any file | | [`sandbox.network`](#sandbox-network) | Kontrol host, port, dan soket mana yang dapat dijangkau perintah [bersandbox](https://code.claude.com/docs/id/sandboxing.md#network-isolation) | Sandbox settings | Any file | | [`sandbox.network.allowAllUnixSockets`](#sandbox-network-allowallunixsockets) | Biarkan perintah [bersandbox](https://code.claude.com/docs/id/sandboxing.md) terhubung ke setiap soket Unix | Sandbox settings | Any file | | [`sandbox.network.allowedDomains`](#sandbox-network-alloweddomains) | Izinkan domain sebelumnya sehingga perintah [bersandbox](https://code.claude.com/docs/id/sandboxing.md) tidak meminta izin untuk domain tersebut | Sandbox settings | Any file | | [`sandbox.network.allowLocalBinding`](#sandbox-network-allowlocalbinding) | Biarkan perintah [bersandbox](https://code.claude.com/docs/id/sandboxing.md) mendengarkan pada port jaringan dan terhubung ke localhost di macOS | Sandbox settings | Any file | | [`sandbox.network.allowMachLookup`](#sandbox-network-allowmachlookup) | Biarkan alat macOS [bersandbox](https://code.claude.com/docs/id/sandboxing.md) seperti iOS Simulator atau Playwright menjangkau layanan XPC mereka | Sandbox settings | Any file | | [`sandbox.network.allowManagedDomainsOnly`](#sandbox-network-allowmanageddomainsonly) | Kunci allowlist jaringan ke [pengaturan terkelola](https://code.claude.com/docs/id/sandboxing.md#keep-developers-from-widening-the-policy) | Sandbox settings | Managed | | [`sandbox.network.allowUnixSockets`](#sandbox-network-allowunixsockets) | Cantumkan jalur soket Unix yang dapat digunakan perintah [bersandbox](https://code.claude.com/docs/id/sandboxing.md) di macOS | Sandbox settings | Any file | | [`sandbox.network.deniedDomains`](#sandbox-network-denieddomains) | Blokir domain untuk perintah [bersandbox](https://code.claude.com/docs/id/sandboxing.md), bahkan di dalam wildcard yang diizinkan | Sandbox settings | Any file | | [`sandbox.network.httpProxyPort`](#sandbox-network-httpproxyport) | Rutekan lalu lintas HTTP [sandbox](https://code.claude.com/docs/id/sandboxing.md#custom-proxy-configuration) melalui proxy Anda sendiri | Sandbox settings | Any file | | [`sandbox.network.socksProxyPort`](#sandbox-network-socksproxyport) | Rutekan lalu lintas SOCKS [sandbox](https://code.claude.com/docs/id/sandboxing.md#custom-proxy-configuration) melalui proxy Anda sendiri | Sandbox settings | Any file | | [`sandbox.network.strictAllowlist`](#sandbox-network-strictallowlist) | Tolak host di luar [allowlist](https://code.claude.com/docs/id/sandboxing.md#network-isolation) daripada meminta izin | Sandbox settings | User or managed | | [`sandbox.network.tlsTerminate`](#sandbox-network-tlsterminate) | Biarkan proxy [sandbox](https://code.claude.com/docs/id/sandboxing.md#network-isolation) menghentikan TLS sehingga dapat membaca permintaan HTTPS | Sandbox settings | User or managed | | [`sandbox.ripgrep`](#sandbox-ripgrep) | Gunakan biner ripgrep Anda sendiri di dalam [sandbox](https://code.claude.com/docs/id/sandboxing.md) | Sandbox settings | User or managed | | [`sandbox.socatPath`](#sandbox-socatpath) | Arahkan proxy [sandbox](https://code.claude.com/docs/id/sandboxing.md) ke biner `socat` di luar `PATH` | Sandbox settings | Managed | | [`showClearContextOnPlanAccept`](#showclearcontextonplanaccept) | Tampilkan opsi "clear context" pada [layar penerimaan rencana](https://code.claude.com/docs/id/permission-modes.md#review-and-approve-a-plan) | Interface and terminal | Any file | | [`showThinkingSummaries`](#showthinkingsummaries) | Lihat ringkasan [thinking](https://code.claude.com/docs/id/model-config.md#extended-thinking) Claude daripada stub yang diciutkan | Model dan respons | Any file | | [`showTurnDuration`](#showturnduration) | Sembunyikan durasi "Cooked for" setelah setiap respons | Interface and terminal | Any file | | [`skillListingBudgetFraction`](#skilllistingbudgetfraction) | Cadangkan lebih banyak atau lebih sedikit konteks untuk [daftar skill](https://code.claude.com/docs/id/skills.md#skill-descriptions-are-cut-short) | Memory and context | Any file | | [`skillListingMaxDescChars`](#skilllistingmaxdescchars) | Batasi panjang deskripsi setiap skill dalam [daftar skill](https://code.claude.com/docs/id/skills.md#skill-descriptions-are-cut-short) | Memory and context | Any file | | [`skillOverrides`](#skilloverrides) | [Sembunyikan atau ciutkan skill](https://code.claude.com/docs/id/skills.md#override-skill-visibility-from-settings) tanpa mengedit SKILL.md-nya | Plugins and skills | Any file | | [`skipAutoPermissionPrompt`](#skipautopermissionprompt) | Lewati pemberitahuan satu kali yang ditampilkan Claude Code ketika Anda pertama kali memasuki [auto mode](https://code.claude.com/docs/id/permission-modes.md#eliminate-prompts-with-auto-mode) sendiri daripada melalui default bawaan | Permission settings | User or managed | | [`skipDangerousModePermissionPrompt`](#skipdangerousmodepermissionprompt) | Lewati dialog konfirmasi sebelum [mode bypassPermissions](https://code.claude.com/docs/id/permission-modes.md#skip-all-checks-with-bypasspermissions-mode) | Permission settings | User, local, or managed | | [`skipWebFetchPreflight`](#skipwebfetchpreflight) | Lewati [pemeriksaan nama host WebFetch](https://code.claude.com/docs/id/tools-reference.md#webfetch-tool-behavior) ketika Anthropic tidak dapat dijangkau | Privacy and telemetry | Any file | | [`spellcheck`](#spellcheck) | Garis bawahi kata-kata yang salah eja dalam input prompt dengan [pemeriksa ejaan](https://code.claude.com/docs/id/interactive-mode.md#check-spelling-as-you-type) yang Anda pasang | Interface and terminal | User or managed | | [`spinnerTipsEnabled`](#spinnertipsenabled) | Sembunyikan tips dalam spinner saat Claude bekerja | Interface and terminal | Any file | | [`spinnerTipsOverride`](#spinnertipsoverride) | Tambahkan tips Anda sendiri ke rotasi spinner, atau ganti tips bawaan | Interface and terminal | Any file | | [`spinnerVerbs`](#spinnerverbs) | Tambahkan atau ganti kata kerja yang ditampilkan saat giliran berjalan | Interface and terminal | Any file | | [`sshConfigs`](#sshconfigs) | Tambahkan [koneksi SSH](https://code.claude.com/docs/id/desktop.md#pre-configure-ssh-connections-for-your-team) ke pemilih lingkungan Desktop | Remote, desktop, and notifications | User or managed | | [`sshHostAllowlist`](#sshhostallowlist) | Batasi host mana yang dapat dijangkau [sesi SSH Desktop](https://code.claude.com/docs/id/desktop.md#restrict-which-ssh-hosts-users-can-connect-to) | Remote, desktop, and notifications | Managed | | [`sshHostCommands`](#sshhostcommands) | Tambahkan [koneksi SSH yang host-nya berasal dari perintah](https://code.claude.com/docs/id/desktop.md#create-an-ssh-connection-from-a-command) ke pemilih lingkungan Desktop | Remote, desktop, and notifications | User or managed | | [`statusLine`](#statusline) | Jalankan perintah Anda sendiri untuk merender [baris status](https://code.claude.com/docs/id/statusline.md) di bawah prompt | Interface and terminal | Any file | | [`strictKnownMarketplaces`](#strictknownmarketplaces) | Buat allowlist sumber [marketplace](https://code.claude.com/docs/id/plugins/overview.md) yang dapat ditambahkan dan digunakan pengguna untuk memasang | Plugins and skills | Managed | | [`strictPluginOnlyCustomization`](#strictpluginonlycustomization) | Blokir [skill](https://code.claude.com/docs/id/skills.md), [agent](https://code.claude.com/docs/id/sub-agents.md), [hooks](https://code.claude.com/docs/id/hooks.md), dan [server MCP](https://code.claude.com/docs/id/mcp.md) dari sumber pengguna dan proyek | Plugins and skills | Managed | | [`strictPluginOnlyCustomization.agents`](#strictpluginonlycustomization-agents) | Kunci [agent](https://code.claude.com/docs/id/sub-agents.md) ke sumber plugin dan terkelola | Plugins and skills | Managed | | [`strictPluginOnlyCustomization.hooks`](#strictpluginonlycustomization-hooks) | Kunci [hooks](https://code.claude.com/docs/id/hooks.md) ke sumber plugin dan terkelola | Plugins and skills | Managed | | [`strictPluginOnlyCustomization.mcp`](#strictpluginonlycustomization-mcp) | Kunci [server MCP](https://code.claude.com/docs/id/mcp.md) ke sumber plugin dan terkelola | Plugins and skills | Managed | | [`strictPluginOnlyCustomization.skills`](#strictpluginonlycustomization-skills) | Kunci [skill](https://code.claude.com/docs/id/skills.md) ke sumber plugin dan terkelola | Plugins and skills | Managed | | [`subagentPromptCacheTtl`](#subagentpromptcachettl) | Pilih [masa pakai cache prompt](https://code.claude.com/docs/id/prompt-caching.md#cache-lifetime) untuk subagent dan permintaan lain di luar percakapan utama | Model dan respons | Any file | | [`subagentStatusLine`](#subagentstatusline) | Tulis ulang baris dalam tampilan tugas [subagent](https://code.claude.com/docs/id/sub-agents.md) dengan perintah Anda sendiri | Interface and terminal | Any file | | [`switchModelsOnFlag`](#switchmodelsonflag) | Alihkan model secara otomatis atau jeda ketika [pengklasifikasi keamanan](https://code.claude.com/docs/id/model-config.md#ask-before-switching) menandai permintaan | Model dan respons | Any file | | [`syncClaudeAiPlugins`](#syncclaudeaiplugins) | Hentikan pemuatan [plugin yang diaktifkan di akun claude.ai Anda](https://code.claude.com/docs/id/plugins/loading.md#synced-plugins) dan hentikan pengunduhan yang baru | Plugins and skills | User, local, or managed | | [`syncClaudeAiSkills`](#syncclaudeaiskills) | Hentikan pemuatan [skill yang diaktifkan di akun claude.ai Anda](https://code.claude.com/docs/id/skills.md#how-synced-skills-behave) dan hentikan pengunduhan yang baru | Plugins and skills | User, local, or managed | | [`syntaxHighlightingDisabled`](#syntaxhighlightingdisabled) | Matikan penyorotan sintaks dalam diff dan blok kode | Interface and terminal | Any file | | [`taskOutputMaxChars`](#taskoutputmaxchars) | Dihapus di v2.1.277, bersama dengan tool `TaskOutput` yang ukurannya diatur olehnya | Memory and context | Any file | | [`teammateDefaultModel`](#teammatedefaultmodel) | Dihapus di v2.1.234; lihat [Tentukan rekan tim dan model](https://code.claude.com/docs/id/agent-teams.md#specify-teammates-and-models) untuk cara Claude Code memilih model rekan tim | Global config settings | Global config | | [`teammateMode`](#teammatemode) | Pilih cara [rekan tim tim agent](https://code.claude.com/docs/id/agent-teams.md#choose-a-display-mode) ditampilkan | Agents, sessions, and worktrees | Any file | | [`terminalProgressBarEnabled`](#terminalprogressbarenabled) | Sembunyikan bilah kemajuan terminal di terminal yang mendukungnya | Interface and terminal | Any file | | [`terminalTitleFromRename`](#terminaltitlefromrename) | Hentikan [`/rename`](https://code.claude.com/docs/id/sessions#name-your-sessions) dan `--name` dari mengubah judul tab terminal | Interface and terminal | Any file | | [`theme`](#theme) | Pilih [tema warna](https://code.claude.com/docs/id/terminal-config.md#match-the-color-theme) antarmuka, bawaan atau kustom | Interface and terminal | Any file | | [`timeFormat`](#timeformat) | Tampilkan waktu dalam antarmuka dalam format 12 jam atau 24 jam, dalam UTC, atau dengan pola strftime | Interface and terminal | Any file | | [`timeZone`](#timezone) | Tampilkan waktu dalam antarmuka di zona waktu selain zona waktu sistem Anda | Interface and terminal | Any file | | [`tui`](#tui) | Pilih renderer terminal [fullscreen](https://code.claude.com/docs/id/fullscreen.md) atau klasik | Interface and terminal | Any file | | [`ultracode`](#ultracode) | Biarkan Claude merencanakan [workflow](https://code.claude.com/docs/id/workflows.md#let-claude-decide-with-ultracode) untuk setiap tugas substansial tanpa diminta | Model dan respons | Any file | | [`useAutoModeDuringPlan`](#useautomodeduringplan) | Biarkan pengklasifikasi [auto mode](https://code.claude.com/docs/id/permission-modes.md#eliminate-prompts-with-auto-mode) meninjau perintah shell dalam [plan mode](https://code.claude.com/docs/id/permission-modes.md#analyze-before-you-edit-with-plan-mode); atur `false` untuk mendapatkan permintaan izin sebagai gantinya | Permission settings | User, local, or managed | | [`verbose`](#verbose) | Tampilkan [output tool lengkap](https://code.claude.com/docs/id/cli-reference.md#cli-flags) daripada ringkasan terpotong; `viewMode` diutamakan ketika keduanya diatur | Interface and terminal | Any file | | [`viewMode`](#viewmode) | Mulai setiap sesi dalam [tampilan default, verbose, atau focus](https://code.claude.com/docs/id/cli-reference.md#cli-flags) | Interface and terminal | Any file | | [`vimInsertModeRemaps`](#viminsertmoderemaps) | Petakan [urutan mode INSERT](https://code.claude.com/docs/id/interactive-mode.md#remap-insert-mode-key-sequences) dua tombol seperti `jj` ke Escape | Interface and terminal | User or managed | | [`voice`](#voice) | Nyalakan [dikte suara](https://code.claude.com/docs/id/voice-dictation.md) dan pilih mode tahan atau ketuk | Interface and terminal | Any file | | [`voiceEnabled`](#voiceenabled) | Nyalakan [dikte suara](https://code.claude.com/docs/id/voice-dictation.md) dengan bentuk tombol tunggal yang lebih lama | Interface and terminal | Any file | | [`wheelScrollAccelerationEnabled`](#wheelscrollaccelerationenabled) | Matikan [akselerasi roda mouse](https://code.claude.com/docs/id/fullscreen.md#mouse-wheel-scrolling) dalam rendering fullscreen | Interface and terminal | Any file | | [`workflowKeywordTriggerEnabled`](#workflowkeywordtriggerenabled) | Biarkan kata `ultracode` dalam prompt memulai [workflow](https://code.claude.com/docs/id/workflows.md); atur `false` untuk mengetiknya tanpa memulai workflow | Hooks and automation | Any file | | [`workflowSizeGuideline`](#workflowsizeguideline) | Atur jumlah agent yang Claude targetkan dalam [workflow dinamis](https://code.claude.com/docs/id/workflows.md) | Hooks and automation | Any file | | [`worktree`](#worktree) | Konfigurasikan cara Claude Code membuat git [worktree](https://code.claude.com/docs/id/worktrees.md) | Agents, sessions, and worktrees | Any file | | [`worktree.baseRef`](#worktree-baseref) | Buat branch [worktree](https://code.claude.com/docs/id/worktrees.md) baru dari branch default remote atau HEAD lokal Anda | Agents, sessions, and worktrees | Any file | | [`worktree.bgIsolation`](#worktree-bgisolation) | Biarkan sesi latar belakang mengedit salinan kerja tanpa [worktree](https://code.claude.com/docs/id/worktrees.md) | Agents, sessions, and worktrees | Any file | | [`worktree.location`](#worktree-location) | Pilih tempat [sesi SSH Desktop](https://code.claude.com/docs/id/desktop.md#ssh-sessions) membuat worktree-nya di mesin remote | Agents, sessions, and worktrees | User | | [`worktree.sparsePaths`](#worktree-sparsepaths) | Check out hanya direktori yang Anda butuhkan di setiap [worktree](https://code.claude.com/docs/id/worktrees.md) | Agents, sessions, and worktrees | Any file | | [`worktree.symlinkDirectories`](#worktree-symlinkdirectories) | Buat symlink direktori besar ke setiap [worktree](https://code.claude.com/docs/id/worktrees.md) daripada menduplikasinya | Agents, sessions, and worktrees | Any file | | [`wslInheritsWindowsSettings`](#wslinheritswindowssettings) | Biarkan WSL membaca [pengaturan terkelola](https://code.claude.com/docs/id/managed-settings.md) dari rantai kebijakan Windows | Enterprise and managed settings | Managed | ## 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](https://code.claude.com/docs/id/model-config.md). ### `advisorModel` Pilih model mana yang menjawab ketika Claude memanggil [alat advisor](https://code.claude.com/docs/id/advisor.md) di sisi server. Biarkan tidak disetel untuk mematikan advisor. Advisor harus setidaknya sama mampu dengan model utama Anda. Lihat [Pilih model advisor](https://code.claude.com/docs/id/advisor.md#choose-an-advisor-model) 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](https://code.claude.com/docs/id/remote-control.md) 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](https://code.claude.com/docs/id/advisor.md#fable-advisor-and-usage-credits), 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`](#scopes) * **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`](https://code.claude.com/docs/id/env-vars) mematikan advisor, dan kunci ini tidak dapat menghidupkannya kembali ```json settings.json theme={null} { "advisorModel": "opus" } ``` Kunci ini tidak berpengaruh pada penyedia tempat advisor [tidak tersedia](https://code.claude.com/docs/id/advisor.md#requirements), seperti Amazon Bedrock dan Claude Platform di AWS. `"fable"` memerlukan [akses Fable](https://code.claude.com/docs/id/advisor.md#choose-an-advisor-model). ### `alwaysThinkingEnabled` Matikan [extended thinking](https://code.claude.com/docs/id/model-config.md#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](https://code.claude.com/docs/id/third-party-integrations.md) 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](https://code.claude.com/docs/id/errors.md#effort-isnt-available-with-thinking-turned-off), seperti Opus 5. * **Scope**: [`Any file`](#scopes) * **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`](https://code.claude.com/docs/id/env-vars) 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 ```json settings.json theme={null} { "alwaysThinkingEnabled": false } ``` ### `availableModels` Batasi model mana yang dapat dipilih orang untuk sesi utama, [subagents](https://code.claude.com/docs/id/sub-agents.md), [skills](https://code.claude.com/docs/id/skills.md), dan [advisor](https://code.claude.com/docs/id/advisor.md). 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`](#enforceavailablemodels) untuk itu. * **Scope**: [`Any file`](#scopes). 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: ```json settings.json theme={null} { "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`](#deniedmodels). Untuk membuat setiap entri ID model hanya memungkinkan versi yang dinamainya, gunakan [`availableModelsMatch`](#availablemodelsmatch). Lihat [Batasi pemilihan model](https://code.claude.com/docs/id/model-config.md#restrict-model-selection). ### `availableModelsMatch` Pilih bagaimana entri [`availableModels`](#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`](#scopes). 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"` Contoh ini memungkinkan Opus 5 dan Sonnet 5 dan tidak ada rilis yang lebih baru dari keduanya: ```json managed-settings.json theme={null} { "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](https://code.claude.com/docs/id/model-config.md#block-specific-models-or-versions). ### `deniedModels` Blokir model tertentu, dengan atau tanpa daftar [`availableModels`](#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](https://code.claude.com/docs/id/model-config.md#block-specific-models-or-versions). Memerlukan Claude Code v2.1.283 atau lebih baru. * **Scope**: [`Managed`](#scopes). 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: ```json managed-settings.json theme={null} { "availableModels": ["opus", "sonnet"], "deniedModels": ["claude-opus-5-5"] } ``` Lihat [Blokir model atau versi tertentu](https://code.claude.com/docs/id/model-config.md#block-specific-models-or-versions). ### `effortLevel` Tetapkan [tingkat effort](https://code.claude.com/docs/id/model-config.md#adjust-effort-level) 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`](#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`](#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](https://code.claude.com/docs/id/model-config.md#adjust-effort-level) mencantumkan pilihan interaktif yang juga berlaku hanya untuk sesi itu. Pesan yang dicetak `/effort` mengatakan mana yang terjadi. * **Scope**: [`Any file`](#scopes) * **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`](https://code.claude.com/docs/id/env-vars) mengambil alih keduanya ```json settings.json theme={null} { "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`](#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](https://code.claude.com/docs/id/model-config#default-model-setting) menjelaskan model yang diselesaikannya. Daftar [`availableModels`](#availablemodels) membatasi model yang dapat Anda beri nama, tetapi dengan [pencocokan awalan](#availablemodelsmatch) 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](https://code.claude.com/docs/id/amazon-bedrock.md#when-your-organization-enforces-a-model-allowlist) dan [Agent Platform Google Cloud](https://code.claude.com/docs/id/google-vertex-ai.md#when-your-organization-enforces-a-model-allowlist). * **Scope**: [`Any file`](#scopes) * **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: ```json settings.json theme={null} { "availableModels": ["sonnet", "haiku"], "enforceAvailableModels": true } ``` Kunci ini tidak berpengaruh ketika `availableModels` tidak disetel atau kosong. Lihat [Berlakukan daftar untuk model Default](https://code.claude.com/docs/id/model-config.md#enforce-the-allowlist-for-the-default-model). 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](https://code.claude.com/docs/id/prompt-caching.md#switching-models) dingin pada model fallback; pesan Anda berikutnya mencoba model utama terlebih dahulu lagi. * **Scope**: [`Any file`](#scopes) * **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: ```json settings.json theme={null} { "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](https://code.claude.com/docs/id/model-config.md#fallback-model-chains). ### `fastMode` Hidupkan [fast mode](https://code.claude.com/docs/id/fast-mode.md) 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](https://code.claude.com/docs/id/fast-mode.md#switch-models-while-fast-mode-is-on). * **Scope**: [`Any file`](#scopes) * **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`](https://code.claude.com/docs/id/env-vars) mematikan fast mode untuk satu sesi, dan kunci ini tidak dapat menghidupkannya kembali ```json settings.json theme={null} { "fastMode": true } ``` ### `fastModePerSessionOptIn` Biasanya, menjalankan `/fast` menyimpan [`fastMode`](#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](https://code.claude.com/docs/id/server-managed-settings.md). 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](https://code.claude.com/docs/id/headless.md), [ekstensi VS Code](https://code.claude.com/docs/id/vs-code.md), dan [sesi cloud](https://code.claude.com/docs/id/claude-code-on-the-web.md). * **Scope**: [`Any file`](#scopes) * **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` ```json settings.json theme={null} { "fastModePerSessionOptIn": true } ``` Lihat [Memerlukan opt-in per sesi](https://code.claude.com/docs/id/fast-mode.md#require-per-session-opt-in). ### `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](https://code.claude.com/docs/id/voice-dictation.md#change-the-dictation-language), yang memiliki daftar tetap [bahasa dictation yang didukung](https://code.claude.com/docs/id/voice-dictation.md#change-the-dictation-language), dan untuk judul sesi yang dibuat secara otomatis. * **Scope**: [`Any file`](#scopes) * **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 ```json settings.json theme={null} { "language": "japanese" } ``` ### `maxEffortLevel` Batasi [tingkat effort](https://code.claude.com/docs/id/model-config.md#adjust-effort-level) 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`](https://code.claude.com/docs/id/env-vars), 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`](#scopes). 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`](#modelsettings) model. Entri itu menggantikan kunci ini untuk model saja dalam sumber pengaturan yang menetapkan keduanya, seperti pengaturan pengguna Anda atau satu [sumber terkelola](https://code.claude.com/docs/id/managed-settings.md#how-claude-code-combines-managed-sources). 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: ```json settings.json theme={null} { "maxEffortLevel": "medium", "modelSettings": { "claude-sonnet-4-6": { "maxEffortLevel": "max" } } } ``` Ketika organisasi Anda juga menetapkan [batas effort](https://code.claude.com/docs/id/model-config.md#organization-effort-limits) 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](https://code.claude.com/docs/id/model-config.md#organization-default-model) untuk mengesampingkan pilihan pengguna, Anda mendapatkan model itu bahkan ketika Anda menetapkan kunci ini dalam pengaturan pengguna, proyek, atau lokal. * **Scope**: [`Any file`](#scopes) * **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`](https://code.claude.com/docs/id/env-vars), dan keduanya mengambil alih kunci ini untuk satu sesi, termasuk atas `model` terkelola; daftar [`availableModels`](#availablemodels) masih berlaku untuk pilihan ```json settings.json theme={null} { "model": "claude-sonnet-5" } ``` Nilai di sini mengalahkan [`ANTHROPIC_DEFAULT_MODEL`](https://code.claude.com/docs/id/model-config#set-a-default-model-for-new-sessions), 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](https://code.claude.com/docs/id/model-config.md#override-model-ids-per-version) untuk merutekan setiap versi model ke profil inferensi, nama versi, atau deployment tertentu untuk tata kelola, alokasi biaya, atau perutean regional. * **Scope**: [`Any file`](#scopes) * **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: ```json settings.json theme={null} { "modelOverrides": { "claude-opus-4-6": "arn:aws:bedrock:us-east-1:123456789012:inference-profile/example" } } ``` Lihat [Ganti ID model per versi](https://code.claude.com/docs/id/model-config.md#override-model-ids-per-version). ### `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`](#scopes). 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: ```json managed-settings.json theme={null} { "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. | Bidang | Tipe | Apa yang dilakukannya | | :- | :- | :- | | `options` | array baris, masing-masing dengan `model` yang diperlukan dan `label`, `description`, dan `behavesAs` opsional | Baris yang ditunjukkan pemilih, dalam urutan ini, kecuali baris yang diarsir pindah ke bawah. Tanpa `label`, Claude Code memberi judul baris dengan nama bawaan untuk model yang diketahuinya, atau ID model sebaliknya, dan tanpa `description` itu menulis baris kedua generik | | `replaceBuiltInOptions` | Boolean, default `false` | Tetapkan ke `true` untuk menunjukkan hanya baris ini, **Default**, dan baris untuk model yang sudah digunakan sesi. Biarkan tidak disetel untuk menambahkan baris ini setelah barisan bawaan | 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`](#availablemodels), model yang ditemukan [penemuan gateway](https://code.claude.com/docs/id/llm-gateway-protocol.md#model-discovery), dan [`ANTHROPIC_CUSTOM_MODEL_OPTION`](https://code.claude.com/docs/id/model-config#add-a-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`](#availablemodels) masih berlaku untuk baris ini. Sebelum Anda menambahkan model yang tercantum ke daftar, baca [Perilaku penggabungan](https://code.claude.com/docs/id/model-config.md#merge-behavior): 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](https://code.claude.com/docs/id/settings.md#fix-a-broken-settings-file). ### `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](https://code.claude.com/docs/id/statusline.md), `total_cost_usd` Agent SDK, batas [`--max-budget-usd`](https://code.claude.com/docs/id/cli-reference), dan [OpenTelemetry](https://code.claude.com/docs/id/monitoring-usage.md) 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`](#scopes). Terapkan kunci melalui pengaturan terkelola server, kebijakan MDM, file `managed-settings.json`, atau [pembantu kebijakan](https://code.claude.com/docs/id/managed-settings.md#compute-the-policy-with-a-helper-program). Claude Code mengabaikannya dalam pengaturan pengguna, proyek, dan lokal, dalam `--settings`, dan di Windows dalam [registri HKCU](https://code.claude.com/docs/id/managed-settings.md#where-each-mechanism-stores-the-policy) yang dapat ditulis pengguna. Dengan pengaturan terkelola server, setiap sesi melaporkan biaya pada harga daftar sampai [pengambilan pengaturan](https://code.claude.com/docs/id/server-managed-settings.md#fetch-and-caching-behavior) sesi itu telah mengkonfirmasi pengaturan. Aplikasi host yang menyematkan Claude Code dan menetapkan [`CLAUDE_CODE_PROVIDER_MANAGED_BY_HOST`](https://code.claude.com/docs/id/env-vars) dapat memasok tabel miliknya sendiri melalui opsi SDK [`managedSettings`](https://code.claude.com/docs/id/agent-sdk/typescript#options), 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%: ```json managed-settings.json theme={null} { "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](https://code.claude.com/docs/id/costs.md#report-spend-at-your-contracted-rates). #### Bidang untuk `modelPricing` | Bidang | Tipe | Apa yang dilakukannya | | :- | :- | :- | | `multiplier` | angka lebih besar dari 0 dan paling banyak 10 | Menskalakan setiap biaya yang dihitung Claude Code, apakah baris `overrides` mencakupnya atau tidak. Di bawah 1 adalah diskon, di atas 1 markup | | `overrides` | peta ID model ke objek tarif dengan `input`, `output`, `cacheRead`, dan `cacheWrite`, masing-masing 0 hingga 10000 | Tarif USD-per-juta-token untuk model itu, keempat diperlukan. `cacheWrite` mencakup penulisan cache lima menit dan satu jam. Lihat [Model mana yang berlaku baris modelPricing](#which-models-a-modelpricing-row-applies-to) | Claude Code menggunakan tarif baris persis seperti yang Anda tulis, tanpa menambahkan surcharge fast-mode atau [tarif inferensi hanya AS](https://platform.claude.com/docs/en/about-claude/pricing). 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](https://code.claude.com/docs/id/settings.md#fix-a-broken-settings-file). #### 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`](#modeloverrides) Anda atau pencarian [`bedrock:GetInferenceProfile`](https://code.claude.com/docs/id/amazon-bedrock#iam-configuration), Claude Code menerapkan baris model itu ke profil. ### `modelSettings` Simpan [tingkat effort](https://code.claude.com/docs/id/model-config.md#adjust-effort-level) 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](https://code.claude.com/docs/id/vs-code.md#use-the-prompt-box), Claude Code menyimpannya di sini dengan cara yang sama. Entri [`effortLevel`](#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`](#effortlevel) tingkat atas dalam file pengaturan yang sama. Di seluruh file, Claude Code menyelesaikan setiap model secara terpisah: file [pengaturan](https://code.claude.com/docs/id/settings.md#settings-precedence) dengan preseden tertinggi yang menetapkan `effortLevel` untuk model itu atau `effortLevel` tingkat atas yang [berlaku untuk model itu](#effortlevel) memutuskan, jadi `effortLevel` dalam pengaturan terkelola mengalahkan level yang Anda simpan dalam pengaturan pengguna. [Sesuaikan tingkat effort](https://code.claude.com/docs/id/model-config.md#adjust-effort-level) mencantumkan apa lagi yang dapat mengesampingkan level yang disimpan, seperti `--effort` saat peluncuran. Untuk membatasi effort satu model daripada menetapkan levelnya, tambahkan bidang [`maxEffortLevel`](#maxeffortlevel) ke entri model itu. Bidang memerlukan Claude Code v2.1.267 atau lebih baru. * **Scope**: [`Any file`](#scopes) * **Type**: object yang memetakan nama model ke object dengan salah satu dari bidang berikut: * `effortLevel`: salah satu dari `"low"`, `"medium"`, `"high"`, atau `"xhigh"` * [`maxEffortLevel`](#maxeffortlevel): tingkat effort tertinggi yang dapat digunakan model * `autoCompactWindow`: jumlah token dari `100000` hingga `1000000`, atau `"auto"` untuk jendela yang disesuaikan untuk model. [`/autocompact`](https://code.claude.com/docs/id/model-config#set-the-auto-compact-window) menyimpan di sini. Untuk model itu, nilai ini diutamakan daripada [`autoCompactWindow`](#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: ```json settings.json theme={null} { "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](https://code.claude.com/docs/id/output-styles.md) 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](https://code.claude.com/docs/id/prompt-caching.md#changing-output-style). Sebelum v2.1.251, edit berlaku hanya setelah Anda menjalankan `/clear` atau memulai sesi baru. * **Scope**: [`Any file`](#scopes) * **Type**: string, nama [bawaan](https://code.claude.com/docs/id/output-styles.md#built-in-output-styles) atau [kustom](https://code.claude.com/docs/id/output-styles.md#create-a-custom-output-style) gaya output * **Default**: tidak disetel, jadi Claude Code menggunakan gaya default Contoh ini memilih gaya Explanatory bawaan, yang menambahkan wawasan pendidikan antara tugas: ```json settings.json theme={null} { "outputStyle": "Explanatory" } ``` ### `promptCacheTtl` Pilih berapa lama [prompt cache](https://code.claude.com/docs/id/prompt-caching.md) 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](https://platform.claude.com/docs/en/build-with-claude/prompt-caching#pricing) daripada masa pakai lima menit. Memerlukan Claude Code v2.1.242 atau lebih baru. * **Scope**: [`Any file`](#scopes) * **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](https://code.claude.com/docs/id/prompt-caching.md#which-ttl-each-request-gets) * **Per-session overrides**: [`FORCE_PROMPT_CACHING_5M`](https://code.claude.com/docs/id/env-vars) mengambil alih segalanya, kemudian [`CLAUDE_CODE_PROMPT_CACHE_TTL`](https://code.claude.com/docs/id/env-vars), kemudian kunci ini, dan terakhir [`ENABLE_PROMPT_CACHING_1H`](https://code.claude.com/docs/id/env-vars) Contoh ini menyimpan percakapan utama pada masa pakai satu jam dan meninggalkan subagents pada lima menit: ```json settings.json theme={null} { "promptCacheTtl": "1h", "subagentPromptCacheTtl": "5m" } ``` Untuk apa biaya setiap masa pakai, lihat [Masa pakai cache](https://code.claude.com/docs/id/prompt-caching.md#cache-lifetime). ### `showThinkingSummaries` Lihat ringkasan [extended thinking](https://code.claude.com/docs/id/model-config.md#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`](#scopes) * **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` ```json settings.json theme={null} { "showThinkingSummaries": true } ``` Penyensoran mengubah hanya apa yang Anda lihat, bukan apa yang dihasilkan model. Untuk mengurangi pengeluaran thinking, [turunkan anggaran atau matikan thinking](https://code.claude.com/docs/id/model-config.md#extended-thinking) sebagai gantinya. ### `subagentPromptCacheTtl` Pilih berapa lama [prompt cache](https://code.claude.com/docs/id/prompt-caching.md) menyimpan permintaan yang dibuat Claude Code di luar percakapan utama. Kunci ini berlaku untuk [subagents](https://code.claude.com/docs/id/sub-agents.md), [workflows](https://code.claude.com/docs/id/workflows.md), 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](https://platform.claude.com/docs/en/build-with-claude/prompt-caching#pricing) daripada masa pakai lima menit. Memerlukan Claude Code v2.1.242 atau lebih baru. * **Scope**: [`Any file`](#scopes) * **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](https://code.claude.com/docs/id/prompt-caching.md#which-ttl-each-request-gets) * **Per-session overrides**: [`FORCE_PROMPT_CACHING_5M`](https://code.claude.com/docs/id/env-vars) mengambil alih segalanya, kemudian [`CLAUDE_CODE_SUBAGENT_PROMPT_CACHE_TTL`](https://code.claude.com/docs/id/env-vars), kemudian kunci ini, kemudian [`ENABLE_PROMPT_CACHING_1H`](https://code.claude.com/docs/id/env-vars), yang meminta masa pakai satu jam pada setiap permintaan. Untuk di mana nilai frontmatter subagent sendiri berada, lihat [Pilih TTL sendiri](https://code.claude.com/docs/id/prompt-caching.md#choose-the-ttl-yourself) Contoh ini memberikan subagents dan permintaan lain di luar percakapan utama masa pakai satu jam: ```json settings.json theme={null} { "subagentPromptCacheTtl": "1h" } ``` Kunci ini mencakup permintaan yang tidak dicakup [`promptCacheTtl`](#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](https://code.claude.com/docs/id/prompt-caching.md#subagents-and-the-cache). ### `switchModelsOnFlag` Pilih apa yang terjadi ketika [pengklasifikasi keamanan menandai permintaan](https://code.claude.com/docs/id/model-config.md#automatic-model-fallback): beralih ke model fallback dan lanjutkan, atau jeda sehingga Anda dapat memilih antara beralih dan mengedit prompt. * **Scope**: [`Any file`](#scopes). 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](https://code.claude.com/docs/id/model-config.md#ask-before-switching) dalam sesi interaktif ```json settings.json theme={null} { "switchModelsOnFlag": false } ``` Lihat [Tanya sebelum beralih](https://code.claude.com/docs/id/model-config.md#ask-before-switching). ### `ultracode` Mulai sesi dengan [ultracode](https://code.claude.com/docs/id/workflows.md#let-claude-decide-with-ultracode) aktif. Dengan itu aktif, Claude merencanakan workflow untuk setiap tugas substansial daripada menunggu Anda meminta. Claude merencanakan workflows hanya ketika [dynamic workflows](https://code.claude.com/docs/id/workflows.md) 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`](#scopes) * **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` ```json settings.json theme={null} { "ultracode": true } ``` Tingkat effort sesi berasal dari [`effortLevel`](#effortlevel), [`modelSettings`](#modelsettings), dan [sumber effort](https://code.claude.com/docs/id/model-config.md#adjust-effort-level) lainnya, dan [batas effort](https://code.claude.com/docs/id/model-config.md#organization-effort-limits) seperti [`maxEffortLevel`](#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](https://code.claude.com/docs/id/permissions.md). ### `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](https://code.claude.com/docs/id/managed-settings.md#let-an-embedding-host-add-policy) 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](https://code.claude.com/docs/id/permissions.md#read-and-edit). Ketika Anda menetapkan kunci ini, Claude Code v2.1.282 atau lebih baru juga mengabaikan frontmatter [`allowed-tools`](https://code.claude.com/docs/id/skills#pre-approve-tools-for-a-skill) 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](https://code.claude.com/docs/id/skills.md#where-synced-skills-load) * Direktori `--add-dir` * [Plugin yang dideklarasikan dengan manifest `.claude-plugin`](https://code.claude.com/docs/id/plugins/loading#plugins-shared-through-a-repository) di dalam `~/.claude/skills/` atau `.claude/skills/` proyek * Plugin yang dimuat hanya untuk satu sesi, yang id-nya berakhiran [`@inline`](https://code.claude.com/docs/id/plugins/loading#find-where-a-plugin-came-from), ketika semua kondisi berikut terpenuhi: * Sesi tersebut adalah [sesi Code](https://code.claude.com/docs/id/desktop.md#environment-configuration) atau [sesi Cowork](https://code.claude.com/docs/id/managed-settings.md#where-and-when-a-policy-applies), selain sesi cloud, yang Claude Code-nya dimulai oleh aplikasi Claude Desktop itu sendiri * Pengaturan terkelola Anda menetapkan kunci ini, bukan hanya [pengaturan induk](https://code.claude.com/docs/id/managed-settings.md#let-an-embedding-host-add-policy) 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`](https://code.claude.com/docs/id/skills#names-reserved-for-synced-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](https://code.claude.com/docs/id/skills.md#when-only-managed-permission-rules-apply). * **Scope**: [`Managed`](#scopes) * **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 ```json managed-settings.json theme={null} { "allowManagedPermissionRulesOnly": true } ``` Kunci ini tidak mengunci allowlist server MCP; untuk itu, atur [`allowManagedMcpServersOnly`](#allowmanagedmcpserversonly). Lihat [Pengaturan hanya terkelola](https://code.claude.com/docs/id/managed-settings.md#managed-only-settings). ### `autoMode` Tambahkan aturan Anda sendiri ke apa yang diblokir dan diizinkan oleh pengklasifikasi [auto mode](https://code.claude.com/docs/id/permission-modes.md#eliminate-prompts-with-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](https://code.claude.com/docs/id/auto-mode-config.md#inspect-the-defaults-and-your-effective-config). 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`](#scopes) * **Type**: objek dengan array `environment`, `allow`, `soft_deny`, dan `hard_deny` dari aturan prosa, ditambah Boolean [`classifyAllShell`](#automode-classifyallshell) * **Default**: tidak diatur, jadi pengklasifikasi hanya menggunakan [aturan bawaannya](https://code.claude.com/docs/id/auto-mode-config.md#inspect-the-defaults-and-your-effective-config) Contoh ini mempertahankan aturan `soft_deny` bawaan, melalui `"$defaults"`, dan menambahkan satu lagi yang memblokir `terraform apply`: ```json settings.json theme={null} { "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](https://code.claude.com/docs/id/auto-mode-config.md). ### `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](https://code.claude.com/docs/id/sandboxing.md#per-command-allowed-domains-in-auto-mode). 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`](#scopes). Dibaca di mana pun [`autoMode`](#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](https://code.claude.com/docs/id/sandboxing.md#per-command-allowed-domains-in-auto-mode), dan setiap perintah shell lainnya melaluinya * **Default**: `false` ```json settings.json theme={null} { "autoMode": { "classifyAllShell": true } } ``` Lihat [Arahkan semua perintah shell melalui pengklasifikasi](https://code.claude.com/docs/id/auto-mode-config.md#route-all-shell-commands-through-the-classifier). ### `disableAutoMode` Hapus [auto mode](https://code.claude.com/docs/id/permission-modes.md#eliminate-prompts-with-auto-mode) dari siklus `Shift+Tab`. Setiap sesi yang sebaliknya akan [dimulai dalam auto mode](https://code.claude.com/docs/id/permission-modes.md#which-mode-a-session-starts-in), 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`](#scopes). Paling berguna dalam [pengaturan terkelola](https://code.claude.com/docs/id/managed-settings.md), di mana pengguna tidak dapat menimpanya. Juga diterima di bawah `permissions` sebagai `permissions.disableAutoMode`. * **Type**: string `"disable"` * **Default**: tidak diatur ```json settings.json theme={null} { "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](https://code.claude.com/docs/id/permission-modes.md) yang digunakan saat sesi dimulai. Setiap kunci `permissions.*` di bawah bersarang di bawah objek ini. * **Scope**: [`Any file`](#scopes) * **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`: ```json settings.json theme={null} { "permissions": { "allow": ["Bash(npm run *)"], "ask": ["Bash(git push *)"], "deny": ["Read(./.env)"], "defaultMode": "acceptEdits" } } ``` Tiga array aturan berbagi satu sintaks; lihat [Sintaks aturan izin](#permission-rule-syntax) di bawah `permissions.allow`. Untuk bagaimana aturan izin dari file berbeda digabungkan, lihat [bagaimana aturan izin digabungkan di seluruh cakupan](https://code.claude.com/docs/id/permissions.md#settings-precedence); untuk bagaimana kunci pengaturan secara umum digabungkan, lihat [Prioritas pengaturan](https://code.claude.com/docs/id/settings.md#settings-precedence) 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](https://code.claude.com/docs/id/permission-modes.md#critical-paths). 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`](#scopes). 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](https://code.claude.com/docs/id/permission-modes.md#critical-paths). `false` di salah satu file ini masih mematikannya * `false`: Anda mendapatkan permintaan izin untuk setiap perintah di luar set read-only bawaan * **Default**: `true` ```json settings.json theme={null} { "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____`, seperti `mcp__github__get_*`; tidak dapat muncul dalam nama server. * **Scope**: [`Any file`](#scopes) * **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: ```json settings.json theme={null} { "permissions": { "allow": ["Bash(git diff *)", "Read(~/.zshrc)"] } } ``` Claude Code menerapkan aturan `allow` dari `.claude/settings.json` proyek hanya setelah Anda menerima [dialog kepercayaan workspace](https://code.claude.com/docs/id/permissions.md#project-allow-rules-and-workspace-trust) 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](https://code.claude.com/docs/id/permissions.md#manage-permissions). Setiap baris menunjukkan satu bentuk aturan dan apa yang cocok dengannya. | Aturan | Apa yang cocok | | :- | :- | | `Bash` | Setiap perintah Bash | | `Bash(npm run *)` | Perintah yang dimulai dengan `npm run` | | `Read(./.env)` | Pembacaan file `.env` | | `WebFetch(domain:example.com)` | Permintaan fetch ke example.com | 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](https://code.claude.com/docs/id/permissions.md#permission-rule-syntax). ### `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`](#scopes) * **Type**: array string aturan izin * **Default**: tidak diatur ```json settings.json theme={null} { "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](https://code.claude.com/docs/id/permissions.md#read-and-edit) 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](https://code.claude.com/docs/id/permissions.md#redirections) 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](https://code.claude.com/docs/id/sandboxing.md). * **Scope**: [`Any file`](#scopes) * **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`: ```json settings.json theme={null} { "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`](https://code.claude.com/docs/id/tools-reference#endconversation-tool-behavior) 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](https://code.claude.com/docs/id/permissions.md#bash-rule-limits). 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](https://code.claude.com/docs/id/permissions.md#working-directories) tambahan. Sebagian besar konfigurasi `.claude/` [tidak ditemukan](https://code.claude.com/docs/id/permissions.md#additional-directories-grant-file-access-not-configuration) dari direktori ini. * **Scope**: [`Any file`](#scopes), dengan [batasan pada akses tulis sandbox](https://code.claude.com/docs/id/sandboxing.md#repository-settings-under-an-admin-required-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 ```json settings.json theme={null} { "permissions": { "additionalDirectories": ["../docs/"] } } ``` Seperti aturan `allow`, entri dalam `.claude/settings.json` proyek berlaku hanya setelah Anda menerima [dialog kepercayaan workspace](https://code.claude.com/docs/id/permissions.md#project-allow-rules-and-workspace-trust) untuk folder itu. ### `permissions.blockReadsOutsideWorkingDirectories` Buat tool file Claude menolak pembacaan di luar [direktori kerja](https://code.claude.com/docs/id/permissions.md#working-directories) 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](https://code.claude.com/docs/id/permission-modes.md#actions-no-mode-auto-approves) mencakup kapan perintah shell yang membaca jalur tersebut meminta konfirmasi Anda * [Perintah sandboxed di bawah blokir](#sandboxed-commands-under-the-block) 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](https://code.claude.com/docs/id/sandboxing.md) 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](https://code.claude.com/docs/id/permission-modes.md#first-read-outside-the-working-directories). * **Scope**: [`Any file`](#scopes). `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](https://code.claude.com/docs/id/permission-modes.md) Anda ```json settings.json theme={null} { "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`](#automemorydirectory) berasal dari `.claude/settings.json` proyek, atau dari `.claude/settings.local.json` yang [diperlakukan sebagai disediakan repositori](https://code.claude.com/docs/id/permissions.md#when-your-local-settings-file-needs-trust), Claude Code tidak memuat [auto memory](https://code.claude.com/docs/id/memory.md#storage-location) 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](https://code.claude.com/docs/id/sandboxing.md) 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](https://code.claude.com/docs/id/worktrees.md) 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](https://code.claude.com/docs/id/worktrees.md) 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`](#sandbox-filesystem-disabled) * [`allowManagedReadPathsOnly`](#sandbox-filesystem-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`](#sandbox-filesystem-denyread). Entri `denyRead` yang mencakup file selalu diutamakan daripada pembukaan kembali ini. ### `permissions.defaultMode` Atur [mode izin](https://code.claude.com/docs/id/permission-modes.md) yang digunakan saat sesi baru dimulai. Ketika Anda membiarkannya tidak diatur, sesi dimulai dalam [default bawaan](https://code.claude.com/docs/id/permission-modes.md#which-mode-a-session-starts-in) untuk surface Anda. * **Scope**: [`Any file`](#scopes). `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](https://code.claude.com/docs/id/plugins/mods/overview.md) yang Anda instal masih dapat menyetujui [sebagian dari panggilan tersebut](https://code.claude.com/docs/id/permissions.md#precedence-among-rules-hooks-and-mods). 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](https://code.claude.com/docs/id/permissions.md#network-paths) * `"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 ```json settings.json theme={null} { "permissions": { "defaultMode": "acceptEdits" } } ``` Aturan izin berlapis di atas setiap mode: aturan `deny` memblokir dalam setiap mode, termasuk `bypassPermissions`. Lihat [Mode izin](https://code.claude.com/docs/id/permission-modes.md). 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](https://code.claude.com/docs/id/permission-modes.md#switch-permission-modes). ### `permissions.disableBypassPermissionsMode` Cegah siapa pun memasuki mode `bypassPermissions`. Claude Code kemudian menolak flag `--dangerously-skip-permissions`, dan mengabaikan `permissionMode: bypassPermissions` dalam [definisi agent](https://code.claude.com/docs/id/sub-agents.md#permission-modes), sehingga subagent berjalan dengan mode izin sesi induk. * **Scope**: [`Any file`](#scopes). Biasanya diatur dalam [pengaturan terkelola](https://code.claude.com/docs/id/managed-settings.md) 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 ```json settings.json theme={null} { "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](https://code.claude.com/docs/id/permission-modes.md#eliminate-prompts-with-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`](#scopes). 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 ```json settings.json theme={null} { "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`](#scopes). 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 ```json settings.json theme={null} { "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](https://code.claude.com/docs/id/sandboxing.md). ### `sandbox` Isolasi perintah Bash yang dijalankan Claude dari sistem file dan jaringan Anda dengan [sandboxing](https://code.claude.com/docs/id/sandboxing.md). 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`](#scopes) * **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: ```json settings.json theme={null} { "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](https://code.claude.com/docs/id/sandboxing.md#keep-developers-from-widening-the-policy) untuk kunci khusus pengaturan terkelola. Untuk mewajibkan sandbox bagi organisasi, lihat [Enforce sandboxing with managed settings](https://code.claude.com/docs/id/sandboxing.md#enforce-sandboxing-with-managed-settings). ### `sandbox.enabled` Aktifkan [sandboxing](https://code.claude.com/docs/id/sandboxing.md) 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`](#scopes), dengan [batasan pada pengaturan proyek dan lokal](https://code.claude.com/docs/id/sandboxing.md#repository-settings-under-an-admin-required-sandbox) * **Type**: Boolean * `true`: Claude Code membuat sandbox untuk perintah Bash * `false`: Perintah Bash berjalan tanpa sandbox * **Default**: `false` ```json settings.json theme={null} { "sandbox": { "enabled": true } } ``` Di Linux dan WSL2 sandbox memerlukan `bubblewrap` dan `socat`; lihat [Set up Linux and WSL2](https://code.claude.com/docs/id/sandboxing.md#set-up-linux-and-wsl2). Ketika sandbox tidak dapat dimulai, Claude Code menjalankan perintah tanpa sandbox kecuali Anda juga menetapkan [`failIfUnavailable`](#sandbox-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](https://code.claude.com/docs/id/sandboxing.md#enforce-sandboxing-with-managed-settings). * **Scope**: [`Any file`](#scopes), dengan [batasan pada pengaturan proyek dan lokal](https://code.claude.com/docs/id/sandboxing.md#repository-settings-under-an-admin-required-sandbox) * **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` Ini membuat setiap mesin terkelola menjalankan perintah dalam sandbox atau menolak untuk dimulai: ```json managed-settings.json theme={null} { "sandbox": { "enabled": true, "failIfUnavailable": true } } ``` Lihat [Enforce sandboxing with managed settings](https://code.claude.com/docs/id/sandboxing.md#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`](#scopes) * **Type**: Boolean * `true`: Claude Code menjalankan perintah Bash bersandbox tanpa permintaan izin, kecuali dalam kasus yang dijelaskan di [Auto-allow mode](https://code.claude.com/docs/id/sandboxing.md#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: ```json settings.json theme={null} { "sandbox": { "enabled": true, "autoAllowBashIfSandboxed": false } } ``` Lihat [Auto-allow mode](https://code.claude.com/docs/id/sandboxing.md#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](https://code.claude.com/docs/id/permissions.md#permission-rule-syntax) `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`](#scopes), dengan [batasan pada pengaturan proyek dan lokal](https://code.claude.com/docs/id/sandboxing.md#repository-settings-under-an-admin-required-sandbox) * **Type**: array pola perintah * **Default**: tidak diatur, jadi tidak ada perintah yang dikecualikan ```json settings.json theme={null} { "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 vendor/lib` berjalan di luar sandbox, tetapi `git clone ~/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`](#sandbox-filesystem-allowwrite) menjaganya tetap bersandbox. Entri dari cakupan pengaturan yang dimuat sesi digabungkan menjadi satu daftar kecuali sandbox [diwajibkan admin](https://code.claude.com/docs/id/sandboxing.md#repository-settings-under-an-admin-required-sandbox). 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`](#sandbox-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`](#scopes), dengan [batasan pada pengaturan proyek dan lokal](https://code.claude.com/docs/id/sandboxing.md#turn-off-the-retry-with-strict-sandbox-mode) * **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: ```json managed-settings.json theme={null} { "sandbox": { "enabled": true, "allowUnsandboxedCommands": false } } ``` Nilai `false` dari pengaturan terkelola atau `--settings` juga membuat sandbox [diwajibkan admin](https://code.claude.com/docs/id/sandboxing.md#repository-settings-under-an-admin-required-sandbox). 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](https://code.claude.com/docs/id/sandboxing.md#the-unsandboxed-retry-escape-hatch). Untuk melihat kapan perintah yang Anda ketik sendiri di [prompt mode shell `!`](https://code.claude.com/docs/id/interactive-mode#shell-mode-with-prefix) berjalan bersandbox, lihat [strict sandbox mode](https://code.claude.com/docs/id/sandboxing.md#turn-off-the-retry-with-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](https://code.claude.com/docs/id/sandboxing.md#filesystem-isolation) untuk batas default. * **Scope**: [`Any file`](#scopes) * **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: ```json settings.json theme={null} { "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](https://code.claude.com/docs/id/sandboxing.md#permission-rules) 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`](#sandbox-network). Kecuali ada kunci yang berlaku, Claude Code menggabungkan daftar ini di seluruh file pengaturan yang dimuat sesi. [`allowManagedReadPathsOnly`](#sandbox-filesystem-allowmanagedreadpathsonly) membatasi `allowRead` ke entri dari pengaturan terkelola, dan [`allowManagedDomainsOnly`](#sandbox-network-allowmanageddomainsonly) melakukan hal yang sama untuk domain yang diizinkan. [Kunci repositori](https://code.claude.com/docs/id/sandboxing.md#repository-settings-under-an-admin-required-sandbox) mengecualikan entri dari file pengaturan repositori. [Configure sandboxing](https://code.claude.com/docs/id/sandboxing.md#configure-sandboxing) mencakup sumber yang Anda kecualikan dengan `--setting-sources`. Ketika Anda mengedit daftar selama sesi, Claude Code [menerapkan perubahan ke sesi yang berjalan](https://code.claude.com/docs/id/settings.md#when-edits-take-effect). #### Awalan jalur sandbox Jalur di `allowWrite`, `denyWrite`, `denyRead`, `allowRead`, dan [`credentials.files`](#sandbox-credentials-files) diselesaikan berdasarkan awalannya: | Awalan | Arti | Contoh | | :- | :- | :- | | `/` | Jalur absolut dari akar sistem file | `/tmp/build` tetap `/tmp/build` | | `~/` | Relatif terhadap direktori home | `~/.kube` menjadi `$HOME/.kube` | | `./` atau tanpa awalan | Relatif terhadap akar proyek untuk pengaturan proyek, atau ke `~/.claude` untuk pengaturan pengguna | `./output` di `.claude/settings.json` diselesaikan ke `/output` | 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](https://code.claude.com/docs/id/permissions.md#read-and-edit), 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. Claude Code juga menghapus `/**` di akhir, jadi `~/build/**` dan `~/build` mencakup direktori yang sama. Apakah wildcard seperti `*` berfungsi bergantung pada daftar tempat entri berada dan pada platform: * **`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. Kurung kurawal dicocokkan sebagai karakter biasa dalam nama, jadi `~/data/{keys,tokens}` mencakup direktori yang secara harfiah 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`](#scopes), dengan [batasan pada pengaturan proyek dan lokal](https://code.claude.com/docs/id/sandboxing.md#repository-settings-under-an-admin-required-sandbox) * **Type**: array string jalur, menggunakan [sandbox path prefixes](#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`](#permissions-additionaldirectories) Ini memungkinkan build menulis di bawah `/tmp/build` dan memungkinkan `kubectl` memperbarui kubeconfig Anda: ```json settings.json theme={null} { "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`](#sandboxed-commands-under-the-block) aktif. [Kunci repositori](https://code.claude.com/docs/id/sandboxing.md#repository-settings-under-an-admin-required-sandbox) juga dapat mengecualikan entri repositori. Entri `allowWrite` tidak dapat membuka [protected path](https://code.claude.com/docs/id/sandboxing.md#protected-paths). ### `sandbox.filesystem.denyWrite` Blokir perintah bersandbox dari menulis ke jalur tertentu, termasuk jalur di dalam direktori yang sebenarnya dapat ditulis. * **Scope**: [`Any file`](#scopes) * **Type**: array string jalur, menggunakan [sandbox path prefixes](#sandbox-path-prefixes) * **Default**: tidak diatur Ini mencegah perintah bersandbox mengubah konfigurasi sistem atau memasang binari: ```json settings.json theme={null} { "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`](#sandbox-credentials) sebagai gantinya. * **Scope**: [`Any file`](#scopes) * **Type**: array string jalur, menggunakan [sandbox path prefixes](#sandbox-path-prefixes) * **Default**: tidak diatur, jadi perintah bersandbox mempertahankan [default read access](https://code.claude.com/docs/id/sandboxing.md#filesystem-isolation), yang mencakup file kredensial seperti `~/.aws/credentials` ```json settings.json theme={null} { "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`](#sandbox-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`](#sandbox-filesystem-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](https://code.claude.com/docs/id/sandboxing.md#configure-sandboxing). 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`](#scopes), dengan [batasan pada pengaturan proyek dan lokal](https://code.claude.com/docs/id/sandboxing.md#repository-settings-under-an-admin-required-sandbox) * **Type**: array string jalur, menggunakan [sandbox path prefixes](#sandbox-path-prefixes) * **Default**: tidak diatur Ini memblokir pembacaan direktori home Anda kecuali proyek itu sendiri: ```json settings.json theme={null} { "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`](#sandbox-filesystem-allowmanagedreadpathsonly) diatur, dan mengecualikan entri dari pengaturan repositori selama [`permissions.blockReadsOutsideWorkingDirectories`](#sandboxed-commands-under-the-block) aktif. [Kunci repositori](https://code.claude.com/docs/id/sandboxing.md#repository-settings-under-an-admin-required-sandbox) juga dapat mengecualikan entri repositori. ### `sandbox.filesystem.allowManagedReadPathsOnly` Hormati hanya entri [`allowRead`](#sandbox-filesystem-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`](#scopes) * **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: ```json managed-settings.json theme={null} { "sandbox": { "filesystem": { "denyRead": ["~/"], "allowRead": ["~/work"], "allowManagedReadPathsOnly": true } } } ``` Lihat [Keep developers from widening the policy](https://code.claude.com/docs/id/sandboxing.md#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`](#sandbox-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`](#scopes). 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: ```json settings.json theme={null} { "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`](#sandbox-autoallowbashifsandboxed) tetap default ke `true`, jadi atur ke `false` agar permintaan izin tetap muncul. Lihat [Disable filesystem isolation](https://code.claude.com/docs/id/sandboxing.md#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`](#scopes), dengan [batasan pada pengaturan proyek dan lokal](https://code.claude.com/docs/id/sandboxing.md#repository-settings-under-an-admin-required-sandbox) * **Type**: object yang memetakan substring perintah ke array substring pelanggaran, biasanya jalur * **Default**: tidak diatur, jadi setiap pelanggaran dilaporkan ```json settings.json theme={null} { "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`](#scopes), dengan [batasan pada pengaturan proyek dan lokal](https://code.claude.com/docs/id/sandboxing.md#repository-settings-under-an-admin-required-sandbox) * **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` ```json settings.json theme={null} { "sandbox": { "enabled": true, "enableWeakerNestedSandbox": true } } ``` Hanya Linux dan WSL2. Lihat [Bubblewrap fails to start inside a container](https://code.claude.com/docs/id/sandboxing.md#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`](#sandbox-network-httpproxyport) dengan proxy MITM dan CA kustom. Ini mengurangi keamanan dengan membuka jalur eksfiltrasi data potensial melalui layanan kepercayaan. * **Scope**: [`Any file`](#scopes), dengan [batasan pada pengaturan proyek dan lokal](https://code.claude.com/docs/id/sandboxing.md#repository-settings-under-an-admin-required-sandbox) * **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` ```json settings.json theme={null} { "sandbox": { "enabled": true, "enableWeakerNetworkIsolation": true } } ``` Jika Anda tidak menggunakan proxy MITM, cantumkan alat yang gagal di [`excludedCommands`](#sandbox-excludedcommands) sebagai gantinya; lihat [Go-based CLIs fail TLS verification on macOS](https://code.claude.com/docs/id/sandboxing.md#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`](#scopes) * **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` ```json settings.json theme={null} { "sandbox": { "enabled": true, "allowAppleEvents": true } } ``` Untuk mempertahankan isolasi dan tetap menjalankan satu alat seperti itu, tambahkan ke [`excludedCommands`](#sandbox-excludedcommands) sebagai gantinya. Lihat [Apple Events on macOS](https://code.claude.com/docs/id/sandboxing.md#security-limitations). ### `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`](#sandbox-excludedcommands) sebagai gantinya, karena sandbox juga menghentikannya dengan cara lain. Memerlukan Claude Code v2.1.305 atau lebih baru. * **Cakupan**: [`User or managed`](#scopes). Nilai `true` dihitung dari `~/.claude/settings.json`, JSON yang diteruskan dengan `--settings`, atau [pengaturan terkelola](https://code.claude.com/docs/id/managed-settings.md). Claude Code mengabaikan nilai `true` di `.claude/settings.json` atau `.claude/settings.local.json` milik proyek. Dalam sesi dengan [`CLAUDE_CODE_SUBPROCESS_ENV_SCRUB`](https://code.claude.com/docs/id/env-vars#variables) diatur ke `1`, Claude Code mengabaikan nilai `true` dari setiap sumber. Nilai `false` dihitung dari file mana pun, sesuai [prioritas pengaturan](https://code.claude.com/docs/id/settings.md#settings-precedence). * **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` ```json settings.json theme={null} { "sandbox": { "enabled": true, "allowNestedUserNamespaces": true } } ``` Dengan kunci ini aktif, jangan mengandalkan pembatasan sandbox mana pun, termasuk [path yang dilindungi](https://code.claude.com/docs/id/sandboxing.md#protected-paths) dan entri [`credentials.files`](#sandbox-credentials-files), untuk menghentikan perintah berbahaya. Dalam [mode auto-allow](https://code.claude.com/docs/id/sandboxing.md#auto-allow-mode), 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](https://code.claude.com/docs/id/sandboxing.md#chromium-or-rootless-podman-fails-inside-the-sandbox-on-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`](#scopes) * **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`](https://code.claude.com/docs/id/env-vars) ke `0` ```json settings.json theme={null} { "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`](#scopes). 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` ```json managed-settings.json theme={null} { "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`](#scopes) * **Type**: string, jalur absolut; Claude Code membuang jalur relatif dan kembali ke pencarian `PATH` * **Default**: tidak diatur, jadi Claude Code menemukan `socat` di `PATH` ```json managed-settings.json theme={null} { "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](https://code.claude.com/docs/id/sandboxing.md#protect-credentials). 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](https://code.claude.com/docs/id/sandboxing.md#mask-credentials) mengganti nilai aslinya pada permintaan keluar. Claude Code hanya melindungi entri yang Anda cantumkan; tidak ada daftar deny kredensial bawaan. * **Scope**: [`Any file`](#scopes). 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: ```json settings.json theme={null} { "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](https://code.claude.com/docs/id/sandboxing.md#disable-filesystem-isolation); 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`](https://code.claude.com/docs/id/sandboxing#disable-filesystem-isolation) 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](https://code.claude.com/docs/id/managed-settings.md#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`](#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`](#scopes). 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](#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`: ```json settings.json theme={null} { "sandbox": { "credentials": { "files": [ { "path": "~/.aws/credentials", "mode": "deny" }, { "path": "~/.config/gh/hosts.yml", "mode": "mask", "injectHosts": ["api.github.com"] } ] } } } ``` Jalur menggunakan [prefixes](#sandbox-path-prefixes) yang sama dengan pengaturan `sandbox.filesystem.*`, dan Claude Code menggabungkan array dari setiap cakupan pengaturan yang dimuat sesi. [Protect credentials](https://code.claude.com/docs/id/sandboxing.md#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`](#sandbox-network-tlsterminate), atau [`allowPlaintextInject`](#sandbox-credentials-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](https://code.claude.com/docs/id/sandboxing.md#mask-credentials) mencakup sumber pengaturan mana yang dihormati, dan [Mask credential files](https://code.claude.com/docs/id/sandboxing.md#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](https://code.claude.com/docs/id/sandboxing.md#mask-credential-files). | Bidang | Tipe | Apa yang dilakukannya | | :- | :- | :- | | `extract` | string, ekspresi reguler dengan setidaknya satu grup penangkap | Samarkan hanya teks yang ditangkap oleh grup 1 dari setiap kecocokan, sehingga sisa file tetap dapat diurai. Jika `decode` juga diatur, Claude Code memeriksa setiap tangkapan sebagai kemungkinan JWT alih-alih langsung menggantinya. Memerlukan v2.1.221 atau lebih baru | | `onExtractNoMatch` | `"warn"`, `"deny"`, atau `"error"`; default `"warn"` | Apa yang terjadi ketika `extract` atau `decode` tidak menemukan apa pun untuk disamarkan. `warn` membiarkan file dapat dibaca apa adanya di dalam sandbox, `deny` membuatnya tidak dapat dibaca, dan `error` menghentikan penyiapan sandbox sampai Anda memperbaiki konfigurasi. Claude Code memperlakukan `deny` sebagai `error` ketika blok baca tidak akan diberlakukan, karena Anda [menonaktifkan isolasi sistem file](https://code.claude.com/docs/id/sandboxing.md#disable-filesystem-isolation) atau entri [`sandbox.filesystem.allowRead`](#sandbox-filesystem-allowread) membuka kembali jalur tersebut. Memerlukan v2.1.221 atau lebih baru; kasus `decode` memerlukan v2.1.224 atau lebih baru | | `decode` | string `"jwt"` | Temukan JSON Web Token (JWT) di file, dengan pola bawaan atau dengan `extract` jika diatur, verifikasi setiap kandidat, dan ganti dengan token palsu yang valid secara struktural, sehingga kode di dalam sandbox yang mendekode token tetap bekerja. Ketika tidak ada kandidat yang terverifikasi, `onExtractNoMatch` menentukan hasilnya. Memerlukan v2.1.224 atau lebih baru | | `maskClaims` | array string, setidaknya satu nama klaim; memerlukan `decode` | Samarkan hanya klaim payload tingkat atas yang disebutkan di dalam setiap JWT yang terverifikasi dan bangun kembali token di sekitar payload yang dimodifikasi, sehingga klaim lain tetap dapat dibaca. Ketika tidak ada klaim yang disebutkan yang cocok, `onExtractNoMatch` menentukan hasilnya. Memerlukan v2.1.224 atau lebih baru | | `maskDuplicates` | Boolean, default `false` | Ganti juga salinan verbatim dari setiap nilai yang disamarkan di tempat lain di file, seperti rahasia yang ditempel ke dalam komentar. Claude Code mencocokkan substring mentah, jadi gunakan hanya untuk rahasia panjang dengan entropi tinggi. Hanya dipertimbangkan ketika `extract` atau `decode` diatur. Memerlukan v2.1.221 atau lebih baru | | `injectHosts` | array string, masing-masing host yang juga diterima oleh [`sandbox.network.allowedDomains`](#sandbox-network-alloweddomains) | Persempit host tempat proxy sandbox mengganti nilai aslinya. Ketika tidak diatur, proxy menggantinya pada permintaan ke setiap host di `sandbox.network.allowedDomains`. Memerlukan v2.1.221 atau lebih baru | 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`: ```json settings.json theme={null} { "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`](#scopes). 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](#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`: ```json settings.json theme={null} { "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](https://code.claude.com/docs/id/sandboxing.md#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`](#sandbox-network-tlsterminate), atau [`allowPlaintextInject`](#sandbox-credentials-allowplaintextinject) untuk jaringan uji HTTP biasa; lihat [Mask credentials](https://code.claude.com/docs/id/sandboxing.md#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. | Bidang | Tipe | Apa yang dilakukannya | | :- | :- | :- | | `extract` | string, ekspresi reguler dengan setidaknya satu grup penangkap | Samarkan hanya teks yang ditangkap oleh grup 1 dari setiap kecocokan, seperti kata sandi di dalam string koneksi `DATABASE_URL`, sehingga sisa nilai tetap dapat diurai. Memerlukan v2.1.224 atau lebih baru | | `onExtractNoMatch` | `"warn"`, `"deny"`, atau `"error"`; default `"warn"`. Pada entri dengan `decode`, hanya `"warn"` yang diterima | Apa yang terjadi ketika `extract` tidak cocok dengan apa pun. `warn` meneruskan variabel tanpa disamarkan, `deny` menghapus pengaturan variabel di dalam sandbox, dan `error` menghentikan penyiapan sandbox sampai Anda memperbaiki konfigurasi. Memerlukan v2.1.224 atau lebih baru | | `decode` | string `"jwt"` | Verifikasi bahwa seluruh nilai adalah JWT dan ganti dengan token palsu yang valid secara struktural, sehingga kode di dalam sandbox yang mendekode token tetap bekerja; proxy mengganti seluruh token asli saat egress. Nilai yang tidak terverifikasi diteruskan tanpa disamarkan dengan peringatan. Memerlukan v2.1.224 atau lebih baru | | `maskClaims` | array string, setidaknya satu nama klaim; memerlukan `decode` | Samarkan hanya klaim payload tingkat atas yang disebutkan di dalam JWT yang didekode dan bangun kembali token di sekitar payload yang dimodifikasi, sehingga klaim lain tetap dapat dibaca. Ketika tidak ada klaim yang disebutkan yang cocok, variabel diteruskan tanpa disamarkan dengan peringatan. Memerlukan v2.1.224 atau lebih baru | | `injectHosts` | array string, masing-masing host yang juga diterima oleh [`sandbox.network.allowedDomains`](#sandbox-network-alloweddomains) | Persempit host tempat proxy sandbox mengganti nilai aslinya. Ketika tidak diatur, proxy menggantinya pada permintaan ke setiap host di `sandbox.network.allowedDomains`. Tulis tujuan IPv6 sebagai alamat terkompresi tanpa kurung, seperti `"::1"`, bukan bentuk dengan tanda kurung siku; lihat [IPv6 destinations in `injectHosts`](https://code.claude.com/docs/id/sandboxing#ipv6-destinations-in-injecthosts) | 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: ```json settings.json theme={null} { "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`](#scopes) * **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` ```json settings.json theme={null} { "sandbox": { "credentials": { "allowPlaintextInject": true } } } ``` ### `sandbox.credentials.awsPairs` Kelompokkan environment variable tersamarkan yang membentuk satu kredensial AWS untuk [SigV4 re-signing](https://code.claude.com/docs/id/sandboxing.md#re-sign-aws-requests) 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`](#scopes) * **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: ```json settings.json theme={null} { "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`](#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](https://code.claude.com/docs/id/sandboxing.md#re-sign-aws-requests): `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`](#scopes) * **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: ```json settings.json theme={null} { "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](https://code.claude.com/docs/id/sandboxing.md#network-isolation) untuk cara proxy memutuskan dan kapan meminta persetujuan. * **Scope**: [`Any file`](#scopes). `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](https://code.claude.com/docs/id/sandboxing.md#hosts-outside-your-allowed-domains) Ini pra-mengizinkan GitHub dan npm, memblokir `uploads.github.com`, dan memungkinkan perintah melakukan bind ke localhost: ```json settings.json theme={null} { "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](https://code.claude.com/docs/id/sandboxing.md#repository-settings-under-an-admin-required-sandbox) yang berlaku. [Aturan izin](https://code.claude.com/docs/id/sandboxing.md#permission-rules) 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`](#sandbox-network-allowallunixsockets) di sana sebagai gantinya. * **Scope**: [`Any file`](#scopes), dengan [batasan pada pengaturan proyek dan lokal](https://code.claude.com/docs/id/sandboxing.md#repository-settings-under-an-admin-required-sandbox) * **Type**: array string, masing-masing jalur soket * **Default**: tidak diatur, jadi sandbox macOS memblokir setiap soket Unix ```json settings.json theme={null} { "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](https://code.claude.com/docs/id/sandboxing.md#security-limitations). ### `sandbox.network.allowAllUnixSockets` Biarkan perintah bersandbox terhubung ke setiap soket Unix. Di Linux dan WSL2, [seccomp filter](https://code.claude.com/docs/id/sandboxing.md#set-up-linux-and-wsl2) 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](https://code.claude.com/docs/id/sandboxing.md#set-up-linux-and-wsl2) untuk asal filter tersebut. * **Scope**: [`Any file`](#scopes), dengan [batasan pada pengaturan proyek dan lokal](https://code.claude.com/docs/id/sandboxing.md#repository-settings-under-an-admin-required-sandbox) * **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` ```json settings.json theme={null} { "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](https://code.claude.com/docs/id/sandboxing.md#a-command-fails-to-reach-a-server-on-localhost). * **Scope**: [`Any file`](#scopes), dengan [batasan pada pengaturan proyek dan lokal](https://code.claude.com/docs/id/sandboxing.md#repository-settings-under-an-admin-required-sandbox) * **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` ```json settings.json theme={null} { "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`](#scopes), dengan [batasan pada pengaturan proyek dan lokal](https://code.claude.com/docs/id/sandboxing.md#repository-settings-under-an-admin-required-sandbox) * **Type**: array string, masing-masing nama layanan; satu `*` di akhir cocok dengan awalan, dan `"*"` saja cocok dengan setiap layanan * **Default**: tidak diatur Ini mengizinkan setiap layanan di bawah awalan `com.apple.coresimulator.`: ```json settings.json theme={null} { "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`](#scopes), dengan [batasan pada pengaturan proyek dan lokal](https://code.claude.com/docs/id/sandboxing.md#repository-settings-under-an-admin-required-sandbox). Hanya pengaturan terkelola ketika [`allowManagedDomainsOnly`](#sandbox-network-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](https://code.claude.com/docs/id/sandboxing.md#hosts-outside-your-allowed-domains) Ini pra-mengizinkan GitHub di setiap port, setiap subdomain npm, dan satu host API hanya di port 443: ```json settings.json theme={null} { "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](https://code.claude.com/docs/id/sandboxing.md#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`](#sandbox-network-alloweddomains). Domain yang ditolak tetap diblokir bahkan ketika entri `allowedDomains` juga cocok dengannya. * **Scope**: [`Any file`](#scopes) * **Type**: array string, masing-masing domain, pola wildcard, atau literal IP, dengan akhiran `:port` opsional * **Default**: tidak diatur ```json settings.json theme={null} { "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](https://code.claude.com/docs/id/sandboxing.md#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`](#sandbox-network-alloweddomains) ditambah domain dari aturan allow `WebFetch(domain:...)`, atau hanya entri pengaturan terkelola ketika [`allowManagedDomainsOnly`](#sandbox-network-allowmanageddomainsonly) diatur. [Locks that apply without an admin-required sandbox](https://code.claude.com/docs/id/sandboxing.md#locks-that-apply-without-an-admin-required-sandbox) mencakup entri repositori. Memerlukan Claude Code v2.1.219 atau lebih baru. * **Scope**: [`User or managed`](#scopes). 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](https://code.claude.com/docs/id/sandboxing.md#per-command-allowed-domains-in-auto-mode) 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` ```json settings.json theme={null} { "sandbox": { "network": { "strictAllowlist": true } } } ``` Claude Code memberlakukan ini hanya untuk perintah bersandbox; tool dalam proses seperti `WebFetch` tetap mengikuti [aturan izin](https://code.claude.com/docs/id/sandboxing.md#permission-rules) masing-masing. Ketika salah satu sumber yang dihormati menetapkannya ke `true`, pengaturan ini tetap aktif. Lihat [Network isolation](https://code.claude.com/docs/id/sandboxing.md#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`](#scopes) * **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: ```json managed-settings.json theme={null} { "sandbox": { "network": { "allowManagedDomainsOnly": true, "allowedDomains": ["github.com", "*.npmjs.org"] } } } ``` Selama kunci ini bernilai `true`, sandbox [diwajibkan admin](https://code.claude.com/docs/id/sandboxing.md#repository-settings-under-an-admin-required-sandbox), dan hanya pengaturan terkelola yang dapat menetapkan [port proxy](#sandbox-network-httpproxyport). Domain yang ditolak tetap digabungkan dari setiap sumber yang dimuat sesi. Lihat [Keep developers from widening the policy](https://code.claude.com/docs/id/sandboxing.md#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`](#scopes), kecuali [pengaturan sandbox lain membatasi file mana yang dapat menetapkan port](https://code.claude.com/docs/id/sandboxing.md#custom-proxy-configuration) * **Type**: number, port TCP lokal * **Default**: tidak diatur, jadi Claude Code menjalankan proxy sendiri ```json settings.json theme={null} { "sandbox": { "network": { "httpProxyPort": 8080 } } } ``` Atur juga [`socksProxyPort`](#sandbox-network-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](https://code.claude.com/docs/id/sandboxing.md#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`](#scopes), kecuali [pengaturan sandbox lain membatasi file mana yang dapat menetapkan port](https://code.claude.com/docs/id/sandboxing.md#custom-proxy-configuration) * **Type**: number, port TCP lokal * **Default**: tidak diatur, jadi Claude Code menjalankan proxy sendiri ```json settings.json theme={null} { "sandbox": { "network": { "socksProxyPort": 8081 } } } ``` Lihat [Custom proxy configuration](https://code.claude.com/docs/id/sandboxing.md#custom-proxy-configuration). ### `sandbox.network.tlsTerminate` Buat proxy sandbox melakukan terminasi TLS sehingga dapat membaca konten permintaan HTTPS. Ini bersifat eksperimental, dan [credential substitution](https://code.claude.com/docs/id/sandboxing.md#mask-credentials) `mask` memerlukannya. Atur `{}` untuk menghasilkan otoritas sertifikat sementara untuk sesi, atau atur `caCertPath` dan `caKeyPath` untuk menggunakan milik Anda sendiri. * **Scope**: [`User or managed`](#scopes). 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 ```json settings.json theme={null} { "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 Kontrol apa yang dimuat Claude Code ke dalam konteks, bagaimana cara mengompaknya, dan di mana menyimpan memori dan rencana. Lihat [Kelola konteks](https://code.claude.com/docs/id/context-window.md) dan [Memori](https://code.claude.com/docs/id/memory.md). ### `autoCompactEnabled` Buat Claude Code [mengompak percakapan secara otomatis](https://code.claude.com/docs/id/context-window.md#when-your-context-fills-up) ketika konteks mendekati batas. Muncul di `/config` sebagai **Auto-compact**, dan mengalihkannya di sana menulis kunci ini ke pengaturan pengguna Anda. * **Scope**: [`Any file`](#scopes) * **Type**: Boolean * `true`: Claude Code mengompak percakapan secara otomatis ketika konteks mendekati batas * `false`: Claude Code tidak mengompak secara otomatis * **Default**: `true` * **Per-session overrides**: [`DISABLE_AUTO_COMPACT`](https://code.claude.com/docs/id/env-vars) mematikan auto-compact untuk satu sesi; mana pun dari keduanya yang mematikannya, yang lain tidak dapat menghidupkannya kembali ```json settings.json theme={null} { "autoCompactEnabled": false } ``` Perintah manual `/compact` terus bekerja saat auto-compact dimatikan. Jika Anda mematikan auto-compact, [idle compaction](#idlecompaction) juga ikut mati. ### `autoCompactWindow` Atur seberapa penuh jendela konteks sebelum Claude Code [mengompak secara otomatis](https://code.claude.com/docs/id/context-window.md#when-your-context-fills-up). * **Scope**: [`Any file`](#scopes) * **Type**: jumlah token, dari `100000` hingga `1000000`. Claude Code membatasi nilai pada jendela konteks model Anda; [ringkasan model](https://platform.claude.com/docs/en/about-claude/models/overview) mencantumkan jendela setiap model * **Default**: tidak diatur, jadi Claude Code memilih jendela yang disesuaikan untuk model Anda * **Per-session overrides**: [`--autocompact`](https://code.claude.com/docs/id/cli-reference#cli-flags) diutamakan daripada kunci ini untuk satu sesi, dan [`CLAUDE_CODE_AUTO_COMPACT_WINDOW`](https://code.claude.com/docs/id/env-vars) diutamakan daripada keduanya kecuali Claude Code [mengabaikan nilai variabel tersebut](https://code.claude.com/docs/id/model-config.md#claude_code_auto_compact_window-values) ```json settings.json theme={null} { "autoCompactWindow": 500000 } ``` Perintah [`/autocompact`](https://code.claude.com/docs/id/commands#all-commands) menyimpan window untuk model saat ini di bawah [`modelSettings`](#modelsettings), yang diutamakan daripada kunci ini dalam file yang sama untuk model tersebut. [Atur window auto-compact](https://code.claude.com/docs/id/model-config.md#set-the-auto-compact-window) mencakup cara perintah, flag, variabel, dan pengaturan berinteraksi. ### `autoMemoryDirectory` Simpan [memori otomatis](https://code.claude.com/docs/id/memory.md#storage-location) di direktori pilihan Anda alih-alih default per-proyek. * **Scope**: [`Any file`](#scopes) * **Type**: string, jalur direktori absolut atau dengan awalan `~/` * **Default**: tidak diatur, jadi Claude Code menggunakan `~/.claude/projects//memory/` ```json settings.json theme={null} { "autoMemoryDirectory": "~/my-memory-dir" } ``` Dari pengaturan proyek atau lokal, Claude Code menghormati kunci ini di bawah [aturan kepercayaan ruang kerja yang sama dengan hooks](https://code.claude.com/docs/id/permissions.md#what-runs-before-you-trust-a-folder), karena repositori yang dikloning dapat menyediakan file-file tersebut. ### `autoMemoryEnabled` Hidupkan atau matikan [memori otomatis](https://code.claude.com/docs/id/memory.md#enable-or-disable-auto-memory). Ketika `false`, Claude tidak membaca dari atau menulis ke direktori memori otomatis. Anda juga dapat mengalihkannya dengan `/memory` selama sesi, yang menulis kunci ini ke pengaturan pengguna Anda. * **Scope**: [`Any file`](#scopes) * **Type**: Boolean * `true`: sama dengan tidak diatur; memori otomatis tetap aktif kecuali sesuatu yang mengungguli kunci ini mematikannya untuk sesi, seperti `--bare`, mode aman, atau `CLAUDE_CODE_DISABLE_AUTO_MEMORY` * `false`: Claude tidak membaca dari atau menulis ke direktori memori otomatis * **Default**: `true` * **Per-session overrides**: [`CLAUDE_CODE_DISABLE_AUTO_MEMORY`](https://code.claude.com/docs/id/env-vars) mengambil alih kunci ini untuk satu sesi, dalam kedua arah ```json settings.json theme={null} { "autoMemoryEnabled": false } ``` ### `bashOutputMaxChars` Atur berapa banyak karakter dari [output](https://code.claude.com/docs/id/tools-reference.md#output-limits) perintah Bash atau PowerShell yang berhasil yang diterima Claude secara inline. Ketika output melampaui batas, Claude Code menyimpannya ke file dan Claude menerima pratinjau singkat ditambah jalur file. Naikkan batas ketika output perintah, seperti build verbose atau log test-suite lengkap, secara rutin melampaui default dan Anda ingin Claude membacanya tanpa membuka file. Memerlukan Claude Code v2.1.261 atau lebih baru. * **Scope**: [`Any file`](#scopes) * **Type**: jumlah karakter, bilangan bulat positif. Claude Code menjepit nilai ke dalam rentang `4000` hingga `128000` * **Default**: tidak diatur, jadi Claude menerima hingga 30.000 karakter secara inline ```json settings.json theme={null} { "bashOutputMaxChars": 100000 } ``` Ketika Anda menetapkan kunci ini, Claude Code mengabaikan variabel lingkungan [`BASH_MAX_OUTPUT_LENGTH`](https://code.claude.com/docs/id/env-vars). ### `claudeMd` Injeksikan instruksi gaya CLAUDE.md sebagai memori yang dikelola organisasi tanpa menerapkan file terpisah. Claude Code memuat teks sebagai entri memori terkelola di depan file CLAUDE.md pengguna dan proyek. * **Scope**: [`Managed`](#scopes) * **Type**: string, teks file CLAUDE.md; tuliskan seperti yang Anda lakukan pada file, Markdown disertakan, dengan jeda baris sebagai `\n` * **Default**: tidak diatur Contoh ini menerapkan dua aturan sebagai daftar Markdown pendek: ```json managed-settings.json theme={null} { "claudeMd": "# Engineering rules\n\n- Always run make lint before committing.\n- Never push directly to main." } ``` Lihat [Terapkan CLAUDE.md di seluruh organisasi](https://code.claude.com/docs/id/memory.md#deploy-organization-wide-claude-md). ### `claudeMdExcludes` Lewati file `CLAUDE.md` tertentu ketika Claude Code memuat [memori](https://code.claude.com/docs/id/memory.md#exclude-specific-claude-md-files). Dalam monorepo besar, gunakan untuk melewati file CLAUDE.md dari tim lain yang tidak relevan dengan pekerjaan Anda; [Kecualikan file CLAUDE.md yang tidak relevan](https://code.claude.com/docs/id/large-codebases.md#exclude-irrelevant-claude-md-files) dalam panduan codebases besar memandu kasus tersebut. Pola cocok dengan jalur file absolut. * **Scope**: [`Any file`](#scopes) * **Type**: array string, masing-masing pola glob atau jalur absolut * **Default**: tidak diatur, jadi Claude Code memuat setiap CLAUDE.md yang ditemukannya ```json settings.json theme={null} { "claudeMdExcludes": ["**/vendor/**/CLAUDE.md"] } ``` Pengecualian hanya berlaku untuk file memori pengguna, proyek, dan lokal; file CLAUDE.md kebijakan terkelola tidak dapat dikecualikan. ### `env` Atur variabel lingkungan untuk setiap sesi dan untuk subproses yang dimulai Claude Code darinya. Variabel apa pun dalam [referensi variabel lingkungan](https://code.claude.com/docs/id/env-vars.md) dapat masuk di sini, yang merupakan cara Anda menerapkannya ke setiap sesi atau meluncurkannya ke tim Anda. Pengaturan proyek dan lokal tidak dapat menetapkan [beberapa di antaranya](#variables-claude-code-ignores-in-env). * **Scope**: [`Any file`](#scopes) * **Type**: objek yang memetakan nama variabel ke nilai string * **Default**: tidak diatur Contoh ini mematikan pemadatan otomatis dan merutekan permintaan API melalui proxy: ```json settings.json theme={null} { "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 ketika lebih dari satu file pengaturan menetapkan variabel, [yang dengan preseden tertinggi](https://code.claude.com/docs/id/settings.md#settings-precedence) berlaku. [Variabel yang Claude Code abaikan dalam `env`](#variables-claude-code-ignores-in-env) mencantumkan pengecualian untuk pengaturan proyek dan lokal. * Ketika aplikasi Claude Desktop atau [lingkungan self-hosted](https://code.claude.com/docs/id/self-hosted-environments) runner memulai sesi, lingkungan peluncuran yang dibangunnya mengambil alih: Claude Code mengabaikan nilai `env` dari file pengaturan apa pun untuk variabel yang sudah ditetapkan lingkungan peluncuran. [Debug log](https://code.claude.com/docs/id/debug-your-config.md) 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. * `NO_COLOR` dan `FORCE_COLOR` yang ditetapkan di sini hanya mencapai subproses. Untuk mengubah warna antarmuka Claude Code sendiri, atur di shell Anda sebelum meluncurkan `claude`. * Nilai di sini adalah teks biasa dalam file pengaturan dan mencapai setiap subproses yang dimulai Claude Code. Untuk token pembawa OTLP yang berputar, gunakan [`otelHeadersHelper`](#otelheadershelper); untuk kredensial API, gunakan [`apiKeyHelper`](#apikeyhelper). #### Ketika Claude Code menerapkan nilai `env` * Dari pengaturan pengguna, `--settings`, dan pengaturan terkelola: saat startup, dan lagi dalam sesi yang berjalan ketika perubahan tersimpan mengubah `env` yang digabungkan. * Dari pengaturan proyek dan lokal: setelah Anda mempercayai ruang kerja, atau saat startup dalam mode `-p`, yang tidak pernah menampilkan dialog kepercayaan, dan lagi ketika perubahan tersimpan mengubah `env` yang digabungkan. * Variabel yang Claude Code klasifikasikan sebagai aman, seperti pemilihan model, timeout dan batas, dan toggle fitur: saat startup dari setiap file pengaturan, kecuali [variabel yang tidak dapat ditetapkan pengaturan proyek dan lokal](#variables-claude-code-ignores-in-env). * Setelah Anda [memindahkan sesi dengan `/cd`](https://code.claude.com/docs/id/permissions#move-the-session-to-another-directory) pada v2.1.246 atau lebih baru: nilai `env` direktori baru, di atas direktori sebelumnya. #### Variabel yang Claude Code abaikan dalam `env` * Pengaturan proyek dan lokal tidak dapat menetapkan variabel yang tidak boleh dikontrol repositori yang diperiksa; atur di shell, pengaturan pengguna, atau pengaturan terkelola Anda. Claude Code menghapus masing-masing, kecuali beberapa nilai yang mematikan telemetri, dan mencatat peringatan yang dapat Anda lihat dengan `claude --debug`. Mereka termasuk: * Variabel yang memilih di mana Claude Code menyimpan atau menulis file-nya 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 tingkat mesin untuk proses yang dimulai Claude Code, seperti `SystemRoot`, `ComSpec`, `ProgramData`, `LOCALAPPDATA`, `PATHEXT`, `PSModulePath`, dan keluarga `ProgramFiles`. * Variabel yang mengekspor konten sesi: [`OTEL_LOG_RAW_API_BODIES`](https://code.claude.com/docs/id/env-vars#variables) dan pasangan pelacakan beta terperinci `ENABLE_BETA_TRACING_DETAILED` dan `BETA_TRACING_ENDPOINT`. * Variabel [OpenTelemetry exporter](https://code.claude.com/docs/id/monitoring-usage.md) yang menghidupkan telemetri, memilih ke mana telemetri pergi, atau memilih konten apa yang ditangkapnya: * `CLAUDE_CODE_ENABLE_TELEMETRY`, ditambah pasangan telemetri yang ditingkatkan beta `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 berakhir 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 ini yang masih berlaku dari pengaturan proyek dan lokal, karena mereka mematikan sesuatu: `none` untuk tiga pemilih exporter, dan nilai off seperti `0` untuk `OTEL_LOG_USER_PROMPTS`, `OTEL_LOG_TOOL_CONTENT`, dan `OTEL_LOG_TOOL_DETAILS`. Nilai seperti itu menimpa variabel yang sama dalam pengaturan pengguna Anda, tetapi bukan yang ditetapkan lingkungan tempat Anda memulai Claude Code, file `--settings`, atau pengaturan terkelola. Ketika file pengaturan proyek atau lokal menetapkan variabel dalam grup ini, sesi interaktif lokal menampilkan pemberitahuan saat startup. Jalankan `/status` atau `claude doctor` untuk melihat mana yang Claude Code abaikan dan mana yang mematikan telemetri; keduanya mencantumkan nama, tidak pernah nilai. Jalankan non-interaktif dengan `-p` atau sesi Agent SDK tidak menampilkan pemberitahuan, jadi periksa bahwa kolektor Anda masih menerima data setelah Anda upgrade. Jika tidak, atur variabel dalam pengaturan pengguna Anda, pengaturan terkelola, lingkungan pekerjaan, atau file yang Anda lewatkan dengan `--settings`. Mengabaikan grup ini dalam pengaturan proyek dan lokal memerlukan Claude Code v2.1.282 atau 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](https://code.claude.com/docs/id/accessibility.md) `CLAUDE_AX_SCREEN_READER` dan variabel lain yang namanya diawali dengan `CLAUDE_AX_`, seperti [`CLAUDE_AX_STARTUP_QUIET_MS`](https://code.claude.com/docs/id/env-vars#variables). * [`CLAUDE_CODE_USER_DIALOG_TIMEOUT_MS`](https://code.claude.com/docs/id/env-vars#variables), yang mengatur pengatur waktu pada dialog yang tidak dijawab. * [`CLAUDE_CODE_DISABLE_ATTACHMENTS`](https://code.claude.com/docs/id/env-vars#variables), yang mematikan pemrosesan lampiran. * [`CLAUDE_CODE_DISABLE_FILE_MENTIONS`](https://code.claude.com/docs/id/env-vars#variables), yang menghentikan Claude Code dari memperluas mention `@` untuk file dan direktori. Sebelum v2.1.251, pengaturan proyek dan lokal juga dapat menetapkan variabel dalam daftar ini yang memilih di mana Claude Code menulis file-nya atau yang mengekspor konten sesi, kecuali `HOME` dan `XDG_CONFIG_HOME`. Sebelum v2.1.290, pengaturan tersebut juga dapat menetapkan variabel pengatur waktu dialog dan `CLAUDE_CODE_DISABLE_ATTACHMENTS`. * Variabel identitas yang dimiliki 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`](https://code.claude.com/docs/id/env-vars#variables), yang diekspor Claude Code sendiri, diabaikan dari setiap file. Mengabaikan variabel soket memerlukan Claude Code v2.1.224 atau lebih baru, dan mengabaikan token memerlukan v2.1.228 atau lebih baru. * [`CLAUDE_CODE_PROJECT_DIR_NAME`](https://code.claude.com/docs/id/sessions#name-the-project-directory-yourself), yang dibaca Claude Code hanya dari lingkungan peluncuran, diabaikan dari setiap file; memerlukan v2.1.234 atau lebih baru. * [`CLAUDE_CODE_RESTRICTED`](https://code.claude.com/docs/id/env-vars#variables), yang dibaca Claude Code hanya dari lingkungan peluncuran, diabaikan dari setiap file. * [`CLAUDE_CODE_DISABLE_POWERSHELL_CMD_RM_DENY`](https://code.claude.com/docs/id/env-vars#variables), yang dibaca Claude Code hanya dari lingkungan peluncuran, diabaikan dari setiap file. Variabel memerlukan Claude Code v2.1.283 atau 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`](https://code.claude.com/docs/id/env-vars#variables), 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`](https://code.claude.com/docs/id/env-vars#variables), yang dibaca Claude Code hanya dari lingkungan peluncuran, diabaikan dari setiap file. Variabel-variabel ini memerlukan Claude Code v2.1.304 atau lebih baru. ### `fileCheckpointingEnabled` Buat Claude Code membuat snapshot file sebelum setiap edit sehingga [`/rewind`](https://code.claude.com/docs/id/checkpointing) dapat memulihkannya. Muncul di `/config` sebagai **Rewind code (checkpoints)**, dan mengalihkannya di sana menulis kunci ini ke pengaturan pengguna Anda. * **Scope**: [`Any file`](#scopes) * **Type**: Boolean * `true`: Claude Code membuat snapshot file sebelum setiap edit sehingga `/rewind` dapat memulihkannya * `false`: Claude Code tidak membuat snapshot file, jadi `/rewind` tidak dapat memulihkannya * **Default**: `true` * **Per-session overrides**: [`CLAUDE_CODE_DISABLE_FILE_CHECKPOINTING`](https://code.claude.com/docs/id/env-vars) mematikan checkpointing untuk satu sesi; mana pun dari keduanya yang mematikannya, yang lain tidak dapat menghidupkannya kembali ```json settings.json theme={null} { "fileCheckpointingEnabled": false } ``` Dalam jalankan `-p` atau sesi Agent SDK, Claude Code mengabaikan kunci ini. SDK menghidupkan checkpointing dengan opsi `enableFileCheckpointing`-nya, dan jalankan `-p` bare memerlukan `CLAUDE_CODE_ENABLE_SDK_FILE_CHECKPOINTING=true`. Lihat [File checkpointing dalam Agent SDK](https://code.claude.com/docs/id/agent-sdk/file-checkpointing.md). ### `idleCompaction` Idle compaction [mengompak](https://code.claude.com/docs/id/context-window.md#what-survives-compaction) percakapan panjang yang Anda tinggalkan, sesaat sebelum prompt cache-nya kedaluwarsa. Pesan Anda berikutnya kemudian mengirim ringkasan alih-alih seluruh percakapan. Ketika Anda kembali, percakapan menampilkan baris yang diawali dengan `Compacted while idle, before the prompt cache expired`. Idle compaction aktif secara default untuk percakapan yang memenuhi semua kondisi berikut: * **Sesi**: Anda berada dalam sesi terminal interaktif * **Auto-compaction**: [`autoCompactEnabled`](#autocompactenabled) aktif * **Prompt cache**: percakapan menggunakan [TTL prompt cache satu jam](https://code.claude.com/docs/id/prompt-caching.md#which-ttl-each-request-gets) * **Feature flag**: Claude Code dapat [mengambil feature flag dari Anthropic](https://code.claude.com/docs/id/env-vars.md#features-that-need-feature-flag-fetching) * **Ukuran**: konteks percakapan telah mencapai ambang token, yang dapat Anda [ubah](#change-the-idle-compaction-threshold) dari default 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`. * **Scope**: [`Any file`](#scopes) * **Type**: Boolean * `true`: Claude Code mengompak percakapan idle yang memenuhi kondisi * `false`: Claude Code tidak mengompak saat sesi Anda idle * **Default**: `true` * **Per-session overrides**: [`DISABLE_AUTO_COMPACT`](https://code.claude.com/docs/id/env-vars) mematikan idle compaction bersama dengan auto-compaction ```json settings.json theme={null} { "idleCompaction": false } ``` Untuk mematikan atau mengaktifkan idle compaction dari dalam sesi, 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 lebih baru. Jika Anda menjalankan salah satu versi tersebut dan `/config` tidak menampilkan baris tersebut, periksa penyebab berikut: * **Sumber pengaturan lain menetapkan kunci ini**: nilai dalam pengaturan terkelola, flag `--settings`, atau file pengaturan proyek atau lokal menimpa pengaturan pengguna Anda. Ubah kunci di sumber tersebut * **Feature flag tidak tersedia**: di tempat Claude Code tidak dapat [mengambil feature flag dari Anthropic](https://code.claude.com/docs/id/env-vars.md#features-that-need-feature-flag-fetching), idle compaction tidak berjalan, sehingga tidak ada yang perlu dimatikan Kunci ini memerlukan Claude Code v2.1.290 atau lebih baru. Pada versi sebelumnya, yang mengabaikan kunci ini, matikan [`autoCompactEnabled`](#autocompactenabled) untuk menghentikan idle compaction. #### Ubah ambang idle compaction Atur [`CLAUDE_CODE_IDLE_COMPACT_MIN_TOKENS`](https://code.claude.com/docs/id/env-vars) 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. Dengan default, percakapan pada context window 200K melakukan auto-compact sebelum mencapai 200.000 token. Contoh ini menurunkan ambang menjadi 150.000 sehingga percakapan tersebut memenuhi syarat: ```json settings.json theme={null} { "env": { "CLAUDE_CODE_IDLE_COMPACT_MIN_TOKENS": "150000" } } ``` ### `plansDirectory` Pilih di mana Claude Code menyimpan file rencana yang ditulisnya dalam [plan mode](https://code.claude.com/docs/id/permission-modes.md#analyze-before-you-edit-with-plan-mode). Claude Code menyelesaikan jalur relatif terhadap akar proyek. * **Scope**: [`Any file`](#scopes) * **Type**: string, jalur relatif terhadap akar proyek * **Default**: tidak diatur, jadi Claude Code menggunakan `~/.claude/plans` ```json settings.json theme={null} { "plansDirectory": "./plans" } ``` Claude Code menyimpan rencana di `~/.claude/plans` alih-alih direktori yang Anda atur dalam kasus seperti berikut: * **Di luar akar proyek**: jalur diselesaikan di luar akar proyek, seperti halnya `"../plans"`. * **Backslash di macOS, Linux, dan WSL**: jalur yang diselesaikan mengandung backslash, seperti halnya `"docs\\plans"` gaya Windows. Tulis `"docs/plans"`, yang juga berfungsi di Windows. ### `skillListingBudgetFraction` Setiap giliran, Claude melihat [daftar keterampilan Anda](https://code.claude.com/docs/id/skills.md#skill-descriptions-are-cut-short) dengan deskripsinya, dan Claude Code membatasi daftar itu pada bagian jendela konteks. Ketika daftar melampaui batas, Claude Code menyimpan nama setiap keterampilan tetapi menghapus deskripsi keterampilan yang paling jarang digunakan, sehingga Claude masih dapat memanggil keterampilan tersebut tetapi kurang mungkin memilih satu sendiri. Naikkan kunci ini untuk menyimpan lebih banyak deskripsi yang terlihat dengan mengorbankan lebih banyak konteks per giliran. * **Scope**: [`Any file`](#scopes) * **Type**: angka, fraksi lebih besar dari `0` dan paling banyak `1` * **Default**: `0.01`, yang mereservasi 1% dari jendela konteks ```json settings.json theme={null} { "skillListingBudgetFraction": 0.02 } ``` Untuk melihat berapa banyak konteks yang digunakan daftar dan keterampilan mana yang berkontribusi paling banyak, jalankan `/doctor`. ### `skillListingMaxDescChars` Setiap giliran, Claude melihat [daftar keterampilan Anda](https://code.claude.com/docs/id/skills.md#skill-descriptions-are-cut-short) yang menampilkan teks `description` dan `when_to_use` setiap keterampilan. Kunci ini membatasi berapa banyak karakter dari teks itu yang ditampilkan Claude Code per keterampilan; teks yang lebih panjang dipotong pada batas. * **Scope**: [`Any file`](#scopes) * **Type**: jumlah karakter, bilangan bulat positif * **Default**: `1536` ```json settings.json theme={null} { "skillListingMaxDescChars": 2048 } ``` Naikkan untuk menyimpan deskripsi panjang utuh dengan mengorbankan lebih banyak konteks per giliran; turunkan untuk menyesuaikan lebih banyak keterampilan di bawah [`skillListingBudgetFraction`](#skilllistingbudgetfraction). ### `taskOutputMaxChars` > [!WARNING] > > Dihapus dalam v2.1.277, bersama dengan alat `TaskOutput` yang diukurnya. Menetapkannya tidak berpengaruh pada versi saat ini. Claude membaca [file output](https://code.claude.com/docs/id/tools-reference.md#background-commands) tugas latar belakang dengan `Read` sebagai gantinya. Melalui v2.1.276, Anda menetapkan kunci ini ke jumlah karakter dari [output tugas latar belakang](https://code.claude.com/docs/id/tools-reference.md#background-commands) yang diterima Claude secara inline ketika membacanya dengan alat `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](https://code.claude.com/docs/id/terminal-config.md). ### `askUserQuestionTimeout` Biarkan dialog [`AskUserQuestion`](https://code.claude.com/docs/id/tools-reference) 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](https://code.claude.com/docs/id/tools-reference.md#question-auto-continue-timeout). * **Scope**: [`User or managed`](#scopes) * **Type**: string, salah satu dari `"60s"`, `"5m"`, `"10m"`, atau `"never"` * **Default**: `"never"` ```json settings.json theme={null} { "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](https://code.claude.com/docs/id/interactive-mode.md#turn-automatic-continue-off). Memerlukan Claude Code v2.1.234 atau lebih baru. * **Scope**: [`User or managed`](#scopes). 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](https://code.claude.com/docs/id/interactive-mode.md#start-a-wait-yourself) dari menu opsi batas penggunaan * **Default**: `true` ```json settings.json theme={null} { "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](https://code.claude.com/docs/id/fullscreen.md). Matikan untuk tetap di tempat Anda menggulir sementara Claude terus bekerja; prompt izin masih menggulir ke tampilan. * **Scope**: [`Any file`](#scopes) * **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` ```json settings.json theme={null} { "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](https://code.claude.com/docs/id/agent-view.md) yang terlampir masih merender fullscreen. * **Scope**: [`User or managed`](#scopes). 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`](https://code.claude.com/docs/id/cli-reference#cli-flags) mengambil alih [`CLAUDE_AX_SCREEN_READER`](https://code.claude.com/docs/id/env-vars), dan keduanya mengambil alih kunci ini untuk satu sesi ```json settings.json theme={null} { "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](https://code.claude.com/docs/id/hooks.md#bash) 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`](#scopes). `true` hanya dihitung dari pengaturan pengguna Anda, JSON yang dilewatkan dengan `--settings`, atau [pengaturan terkelola](https://code.claude.com/docs/id/managed-settings.md), 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](https://code.claude.com/docs/id/settings.md#settings-precedence) 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`](https://code.claude.com/docs/id/env-vars) mengambil alih kunci ini untuk satu sesi ```json settings.json theme={null} { "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`](#scopes) * **Type**: array of strings * **Default**: unset, jadi tidak ada pengumuman yang ditampilkan ```json settings.json theme={null} { "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 `!`](https://code.claude.com/docs/id/interactive-mode#shell-mode-with-prefix) di kotak input, yang dijalankan Claude Code secara langsung dan ditambahkan ke sesi. `"powershell"` hanya berfungsi saat [tool PowerShell](https://code.claude.com/docs/id/tools-reference.md#powershell-tool) 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`](#scopes) * **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 ```json settings.json theme={null} { "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](https://code.claude.com/docs/id/remote-control.md#limitations), seperti host Remote Control atau SDK, dan untuk dialog persetujuan untuk [pesan lintas sesi yang ditahan](https://code.claude.com/docs/id/cross-session-messaging.md#control-inbound-messages). Di Claude Code v2.1.236 atau lebih baru, tenggat waktu yang sama membatasi prompt persetujuan kredit penggunaan [Fable](https://code.claude.com/docs/id/model-config.md#fable-and-usage-credits) 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`](#scopes) * **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`](https://code.claude.com/docs/id/env-vars) mengambil alih kunci ini untuk satu sesi ```json settings.json theme={null} { "dialogExpiry": "10m" } ``` Prompt izin dan pertanyaan [`AskUserQuestion`](https://code.claude.com/docs/id/tools-reference#askuserquestion-tool-behavior) 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`](#scopes) * **Type**: string, salah satu dari: * `"normal"`: pintasan keyboard standar dalam input prompt * `"vim"`: pengeditan gaya vim dengan mode NORMAL, INSERT, dan VISUAL * **Default**: `"normal"` ```json settings.json theme={null} { "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`](#scopes) * **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` ```json settings.json theme={null} { "emojiCompletionEnabled": false } ``` Lihat [Emoji shortcodes](https://code.claude.com/docs/id/interactive-mode.md#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`](#scopes). Di bawah [status line dan file suggestion gates](#status-line-and-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 ```json settings.json theme={null} { "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](https://code.claude.com/docs/id/hooks.md), 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: ```json theme={null} {"query": "src/comp"} ``` Cetak jalur file yang dipisahkan baris baru ke stdout. Claude Code menampilkan paling banyak 15: ```text theme={null} src/components/Button.tsx src/components/Modal.tsx src/components/Form.tsx ``` Skrip berikut membaca query dan menyerahkannya ke indeks file repositori: ```bash theme={null} #!/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`](#scopes) * **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: ```json settings.json theme={null} { "footerLinksRegexes": [ { "type": "regex", "pattern": "\\b(?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: | Constraint | Behavior | | :- | :- | | URL origin | Nilai yang ditangkap dikodekan URL dan URL yang dibangun harus berbagi asal literal template. Penangkapan dapat mengisi segmen jalur atau nilai query tetapi tidak dapat mengubah tempat tautan menunjuk | | URL length | URL yang dibangun lebih panjang dari 2048 karakter dijatuhkan | | URL scheme | Harus `https`, `http`, atau skema deep-link editor atau workspace yang diakui: `vscode`, `vscode-insiders`, `cursor`, `windsurf`, `zed`, `jetbrains`, `idea`, `slack`, `linear`, `notion`, `figma` | | Label | Default ke teks yang cocok dan dipotong menjadi 28 kolom tampilan | | Badge count | Paling banyak 5 lencana dirender. Yang tertua digantikan oleh kecocokan yang lebih baru dan `/clear` menghapusnya | 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](https://code.claude.com/docs/id/statusline.md) 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](https://code.claude.com/docs/id/interactive-mode.md#make-ctrl-w-delete-back-to-whitespace), 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`](#scopes) * **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`](#scopes) * **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 ```json settings.json theme={null} { "maxProseWidth": 80 } ``` ### `prefersReducedMotion` Kurangi atau matikan animasi antarmuka seperti spinner, shimmer, dan efek flash. Muncul di `/config` sebagai **Reduce motion**. * **Scope**: [`Any file`](#scopes) * **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` ```json settings.json theme={null} { "prefersReducedMotion": true } ``` ### `promptSuggestionEnabled` Tampilkan atau sembunyikan [prompt suggestions](https://code.claude.com/docs/id/interactive-mode.md#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`](#scopes) * **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`](https://code.claude.com/docs/id/env-vars) mengambil alih kunci ini untuk satu sesi ```json settings.json theme={null} { "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`](https://code.claude.com/docs/id/env-vars), 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`](#scopes). 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` ```json settings.json theme={null} { "respectGitignore": false } ``` ### `respondToBashCommands` Pilih apakah Claude merespons setelah Anda menjalankan perintah shell dengan [prefix `!`](https://code.claude.com/docs/id/interactive-mode#shell-mode-with-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`](#scopes) * **Type**: Boolean * `true`: Claude Code menambahkan output perintah ke percakapan dan Claude membalasnya * `false`: Claude Code menambahkan output ke konteks tanpa balasan * **Default**: `true` ```json settings.json theme={null} { "respondToBashCommands": false } ``` Lihat [Shell mode dengan prefix `!`](https://code.claude.com/docs/id/interactive-mode#shell-mode-with-prefix). ### `showClearContextOnPlanAccept` Ketika Claude menyelesaikan rencana dalam [plan mode](https://code.claude.com/docs/id/permission-modes.md#review-and-approve-a-plan), 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`](#scopes) * **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` ```json settings.json theme={null} { "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`](#timeformat) dan [`timeZone`](#timezone) mengontrol format dan zonanya. Muncul di `/config` sebagai **Show turn duration**. * **Scope**: [`Any file`](#scopes). 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` ```json settings.json theme={null} { "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](https://code.claude.com/docs/id/interactive-mode.md#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`](#scopes). 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:`) * **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 ```json settings.json theme={null} { "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`](#scopes) * **Type**: Boolean * `true`: Anda melihat tips dalam spinner saat Claude bekerja * `false`: Claude Code menyembunyikan tips spinner * **Default**: `true` ```json settings.json theme={null} { "spinnerTipsEnabled": false } ``` ### `spinnerTipsOverride` Tambahkan tips Anda sendiri ke [spinner tips](#spinnertipsenabled) 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`](#spinnertipsenabled) ke `false`, Claude Code menyembunyikan semua tips, milik Anda termasuk. * **Scope**: [`Any file`](#scopes). 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: | Field | Required | Description | | :- | :- | :- | | `id` | Yes | Hingga 64 huruf, digit, `.`, `_`, atau `-`. Claude Code mengetik riwayat tampilan tip padanya, jadi cooldown tip bertahan pengurutan ulang daftar. Dari dua entri dengan id yang sama, Claude Code menggunakan yang pertama | | `text` | Yes | Tip, satu baris hingga 500 karakter. Claude Code menghapus escape ANSI dan karakter kontrol dan meruntuhkan spasi | | `cooldownSessions` | No | Sesi Claude Code menunggu sebelum menampilkan tip lagi, `0` hingga `1000`, default `0` | | `priority` | No | Urutan di antara tips yang belum ditampilkan sama lamanya, lebih tinggi dulu, `-10` hingga `10`, default `0` | 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](https://code.claude.com/docs/id/server-managed-settings.md); 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`: ```json settings.json theme={null} { "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`](#scopes) * **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: ```json settings.json theme={null} { "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](https://code.claude.com/docs/id/statusline.md) 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`](#scopes). Ketika [`allowManagedHooksOnly`](#allowmanagedhooksonly) aktif, atau [`disableAllHooks`](#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: ```json settings.json theme={null} { "statusLine": { "type": "command", "command": "jq -r '\"[\\(.model.display_name)] \\(.context_window.used_percentage // 0)% context\"'", "padding": 2 } } ``` Contoh memerlukan [`jq`](https://jqlang.org/) terinstal dan berjalan dalam shell. Untuk PowerShell dan setara Git Bash, lihat [Windows configuration](https://code.claude.com/docs/id/statusline.md#windows-configuration); untuk setup lengkap, lihat [Manually configure a status line](https://code.claude.com/docs/id/statusline.md#manually-configure-a-status-line). ### `subagentStatusLine` Ketika Claude menjalankan [subagents](https://code.claude.com/docs/id/sub-agents.md), 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`](#scopes). Ketika [`allowManagedHooksOnly`](#allowmanagedhooksonly) aktif, atau [`disableAllHooks`](#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 ```json settings.json theme={null} { "subagentStatusLine": { "type": "command", "command": "jq -c '.tasks[] | {id, content: \"\\(.name): \\(.tokenCount) tokens\"}'" } } ``` Lihat [Subagent status lines](https://code.claude.com/docs/id/statusline.md#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`](#scopes) * **Type**: Boolean * `true`: Claude Code mematikan penyorotan sintaks dalam diff, blok kode, dan pratinjau file * `false`: Claude Code menyoroti sintaks * **Default**: `false` ```json settings.json theme={null} { "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](https://code.claude.com/docs/id/sub-agents.md#run-subagents-in-foreground-or-background) atau [dynamic workflows](https://code.claude.com/docs/id/workflows.md) 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`](#scopes). 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` ```json settings.json theme={null} { "terminalProgressBarEnabled": false } ``` ### `terminalTitleFromRename` Claude Code mengatur judul tab terminal Anda. Secara default menggunakan judul yang dihasilkan dari percakapan, dan setelah Anda memberi sesi [nama](https://code.claude.com/docs/id/sessions.md#name-your-sessions) 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 ` dan pemilih sesi menemukannya. * **Scope**: [`Any file`](#scopes) * **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` ```json settings.json theme={null} { "terminalTitleFromRename": false } ``` Untuk menghentikan Claude Code memperbarui judul terminal sama sekali, atur [`CLAUDE_CODE_DISABLE_TERMINAL_TITLE`](https://code.claude.com/docs/id/env-vars) ke `1`. ### `theme` Pilih tema warna untuk antarmuka. Muncul di `/config` sebagai **Theme**. * **Scope**: [`Any file`](#scopes). 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:"` atau `"custom::"`: tema kustom dari `~/.claude/themes/` atau plugin * **Default**: `"dark"` ```json settings.json theme={null} { "theme": "light-daltonized" } ``` Lihat [Create a custom theme](https://code.claude.com/docs/id/terminal-config.md#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](https://code.claude.com/docs/id/interactive-mode.md#transcript-viewer). Untuk memilih preset, jalankan `/config` dan atur **Time format**. Memerlukan Claude Code v2.1.257 atau lebih baru. * **Scope**: [`Any file`](#scopes) * **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`](#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"` ```json settings.json theme={null} { "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: ```json settings.json theme={null} { "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: ```json settings.json theme={null} { "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](https://www.iana.org/time-zones), seperti `"UTC"` atau `"Europe/Dublin"`. Waktu yang [`timeFormat`](#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`](#scopes) * **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 ```json settings.json theme={null} { "timeZone": "Europe/Dublin" } ``` ### `tui` Pilih renderer UI terminal. Gunakan `"fullscreen"` untuk renderer alt-screen bebas flicker [fullscreen](https://code.claude.com/docs/id/fullscreen.md) dengan scrollback virtual, atau `"default"` untuk renderer main-screen klasik. Menjalankan `/tui fullscreen` atau `/tui default` menulis kunci ini untuk Anda. * **Scope**: [`Any file`](#scopes) * **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](https://code.claude.com/docs/id/fullscreen.md#fullscreen-by-default) * **Per-session overrides**: [`CLAUDE_CODE_NO_FLICKER`](https://code.claude.com/docs/id/env-vars) dan [`CLAUDE_CODE_DISABLE_ALTERNATE_SCREEN`](https://code.claude.com/docs/id/env-vars) 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 ```json settings.json theme={null} { "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](https://code.claude.com/docs/id/agent-view.md) 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`](#scopes). 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`](https://code.claude.com/docs/id/cli-reference#cli-flags) mengambil alih kunci ini untuk satu sesi ```json settings.json theme={null} { "verbose": true } ``` Nilai [`viewMode`](#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`](#verbose). * **Scope**: [`Any file`](#scopes) * **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](#tui) * **Default**: unset, jadi pengaturan `verbose` dan pilihan `/focus` terakhir Anda berlaku * **Per-session overrides**: [`--verbose`](https://code.claude.com/docs/id/cli-reference#cli-flags) mengambil alih kunci ini untuk satu sesi ```json settings.json theme={null} { "viewMode": "focus" } ``` ### `vimInsertModeRemaps` Petakan urutan INSERT-mode dua kunci ke Escape dalam [mode editor vim](https://code.claude.com/docs/id/interactive-mode.md#vim-editor-mode). Setiap kunci adalah tepat dua karakter yang dapat dicetak yang diketik berurutan, dan `""` adalah satu-satunya target yang didukung; Claude Code mengabaikan entri lain. * **Scope**: [`User or managed`](#scopes). Repositori tidak dapat memetakan ulang keystroke Anda. * **Type**: object memetakan urutan dua karakter ke `""` * **Default**: unset ```json settings.json theme={null} { "vimInsertModeRemaps": { "jj": "" } } ``` Tidak berpengaruh kecuali `editorMode` adalah `"vim"`. Lihat [Remap INSERT-mode key sequences](https://code.claude.com/docs/id/interactive-mode.md#remap-insert-mode-key-sequences). ### `voice` Aktifkan [voice dictation](https://code.claude.com/docs/id/voice-dictation.md) dan pilih cara kunci diksi berperilaku. Claude Code menulis objek ini untuk Anda ketika Anda menjalankan `/voice`. * **Scope**: [`Any file`](#scopes) * **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: ```json settings.json theme={null} { "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`](#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`](#scopes) * **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 ```json settings.json theme={null} { "voiceEnabled": true } ``` ### `wheelScrollAccelerationEnabled` Percepat kecepatan scroll roda mouse selama scroll cepat dalam [fullscreen rendering](https://code.claude.com/docs/id/fullscreen.md#mouse-wheel-scrolling). Atur ke `false` untuk laju scroll konstan per takik roda. * **Scope**: [`Any file`](#scopes) * **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` ```json settings.json theme={null} { "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](https://git-scm.com/docs/git-interpret-trailers) 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`](#scopes) * **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](https://code.claude.com/docs/id/settings.md#fix-a-broken-settings-file) yang menahannya * **Default**: tidak diatur, jadi Claude Code menggunakan atribusi standar yang ditampilkan di bawah setiap sub-kunci Untuk menyembunyikan semua atribusi, atur `attribution` ke `false`. Dalam file pengaturan yang juga dibaca versi sebelumnya, atur [`commit`](#attribution-commit) dan [`pr`](#attribution-pr) ke string kosong dan [`sessionUrl`](#attribution-sessionurl) ke `false` sebagai gantinya. Contoh ini mengganti atribusi commit, menghapus atribusi pull request, dan menghilangkan tautan sesi: ```json settings.json theme={null} { "attribution": { "commit": "Generated with AI\n\nCo-Authored-By: AI ", "pr": "", "sessionUrl": false } } ``` Setelah Anda mengatur `commit` atau `pr`, Claude Code mengabaikan pengaturan `includeCoAuthoredBy` yang sudah usang dan menggunakan teks defaultnya untuk mana pun dari keduanya yang Anda biarkan tidak diatur. Claude Code memberitahu Claude bahwa instruksi Anda sendiri tentang atribusi, seperti aturan CLAUDE.md atau [memory](https://code.claude.com/docs/id/memory.md), mengambil alih baris commit dan PR ini, kecuali baris diatur dalam [managed settings](https://code.claude.com/docs/id/managed-settings.md). ### `includeCoAuthoredBy` > [!WARNING] > > Sudah usang sejak v2.0.62, ketika [`attribution`](#attribution) menggantinya. Claude Code masih membacanya, tetapi konfigurasi baru harus mengatur `attribution`. Gunakan [`attribution`](#attribution) sebagai gantinya, yang menggantikan kunci ini dan memungkinkan Anda mengubah atau menyembunyikan trailer commit, teks pull request, dan tautan sesi secara terpisah. Claude Code masih menghormati `includeCoAuthoredBy: false` dari file pengaturan yang mendahului `attribution`, tetapi mengabaikannya setelah Anda mengatur `attribution.commit` atau `attribution.pr`. * **Scope**: [`Any file`](#scopes) * **Type**: Boolean * `true`: sama dengan tidak diatur; Claude Code menambahkan trailer commit dan teks atribusi pull request * `false`: Claude Code menghilangkan trailer commit dan teks atribusi pull request, kecuali `attribution` mengatur `commit` atau `pr`, dalam hal ini aturan [`attribution`](#attribution) berlaku * **Default**: `true` ```json settings.json theme={null} { "includeCoAuthoredBy": false } ``` Untuk menyembunyikan semua atribusi, lihat [`attribution`](#attribution). ### `includeGitInstructions` Claude Code memberikan Claude dua bagian konteks terkait git: instruksi bawaan untuk cara menulis commit dan pull request, dalam deskripsi alat Bash, dan snapshot status git dari repositori Anda. Snapshot menyimpan cabang saat ini, cabang utama, output `git status`, dan commit terbaru. Claude Code membacanya ketika percakapan dimulai. Atur kunci ini ke `false` untuk meninggalkan keduanya, misalnya ketika Anda menggunakan skill alur kerja git Anda sendiri. * **Scope**: [`Any file`](#scopes) * **Type**: Boolean * `true`: Claude Code menyertakan instruksi alur kerja commit dan pull request bawaan serta snapshot status git. Sesi cloud tidak pernah menyertakan snapshot * `false`: Claude Code meninggalkan keduanya * **Default**: `true` * **Per-session overrides**: [`CLAUDE_CODE_DISABLE_GIT_INSTRUCTIONS`](https://code.claude.com/docs/id/env-vars) mengambil alih kunci ini untuk satu sesi ```json settings.json theme={null} { "includeGitInstructions": false } ``` Jika Anda mengganti system prompt dalam [mode non-interaktif](https://code.claude.com/docs/id/headless.md) atau Agent SDK, sesi dimulai tanpa snapshot meskipun kunci ini bernilai `true`: * **Eksekusi `-p`**: Anda mengganti prompt ketika meneruskan [`--system-prompt`](https://code.claude.com/docs/id/cli-reference#system-prompt-flags) atau `--system-prompt-file`. Anda juga menggantinya ketika menjalankan agent kustom dengan prompt-nya sendiri, yang dipilih dengan [`--agent`](https://code.claude.com/docs/id/sub-agents#invoke-subagents-explicitly) atau pengaturan [`agent`](#agent). Di luar [bare mode](https://code.claude.com/docs/id/headless.md#start-faster-with-bare-mode), untuk mempertahankan snapshot, jalankan tanpa agent kustom dan tambahkan instruksi Anda dengan [`--append-system-prompt`](https://code.claude.com/docs/id/cli-reference#system-prompt-flags) alih-alih mengganti prompt. * **[Agent SDK](https://code.claude.com/docs/id/agent-sdk/modifying-system-prompts.md)**: Anda mengganti prompt dengan system prompt kustom atau agent thread utama kustom. Jika Anda tidak mengatur system prompt, SDK menggunakan default minimalnya dan sesi juga dimulai tanpa snapshot. Di luar [bare mode](https://code.claude.com/docs/id/headless.md#start-faster-with-bare-mode), untuk mempertahankan snapshot, gunakan preset `claude_code` tanpa `agent` kustom. ### `prUrlTemplate` Arahkan tautan PR yang dirender Claude Code, di lencana footer dan dalam ringkasan hasil alat, ke alat tinjauan kode internal alih-alih `github.com`. Claude Code mengganti `{host}`, `{owner}`, `{repo}`, `{number}`, dan `{url}` dari URL PR. Tautan [permintaan penggabungan GitLab](https://code.claude.com/docs/id/interactive-mode.md#gitlab-merge-requests) di kedua permukaan mempertahankan URL GitLab mereka. * **Scope**: [`Any file`](#scopes) * **Type**: string, template URL menggunakan salah satu dari lima placeholder * **Default**: tidak diatur ```json settings.json theme={null} { "prUrlTemplate": "https://reviews.example.com/{owner}/{repo}/pull/{number}" } ``` Claude Code menerapkan template hanya ke tautan yang dirender sendiri; nomor PR yang ditulis Claude dalam pesan, seperti `#123`, tetap seperti yang ditulis Claude. URL yang tidak memiliki bentuk `/pull/` dibiarkan tidak berubah. ### `attribution.commit` Atur teks atribusi yang ditambahkan Claude Code ke commit git, termasuk trailer apa pun. Atur ke string kosong untuk menyembunyikan atribusi commit. * **Scope**: [`Any file`](#scopes) * **Type**: string * **Default**: tidak diatur, jadi Claude Code menambahkan `Co-Authored-By: `. Nama adalah model yang digunakan saat commit dibuat, seperti `Claude Sonnet 5`. Ketika [subagent](https://code.claude.com/docs/id/sub-agents.md) membuat commit, trailer menamai model subagent. * Ketika Claude Code mengenali model sebagai model Claude tetapi tidak dapat mengkonfirmasi versi pastinya, ia menulis `Claude` saja. * Ketika tidak dapat mencocokkan ID model ke model Claude apa pun, seperti model pihak ketiga yang disajikan melalui [`ANTHROPIC_BASE_URL`](https://code.claude.com/docs/id/env-vars) kustom, ia menulis `Claude Code`. Contoh ini mengganti trailer default dengan baris kustom dan trailer `Co-Authored-By` kustom: ```json settings.json theme={null} { "attribution": { "commit": "Generated with AI\n\nCo-Authored-By: AI " } } ``` ### `attribution.pr` Atur teks atribusi yang ditambahkan Claude Code ke deskripsi pull request. Atur ke string kosong untuk menyembunyikan atribusi pull request. * **Scope**: [`Any file`](#scopes) * **Type**: string * **Default**: tidak diatur, jadi Claude Code menambahkan `🤖 Generated with [Claude Code](https://claude.com/claude-code)` ```json settings.json theme={null} { "attribution": { "pr": "" } } ``` ### `attribution.sessionUrl` Pilih apakah Claude Code menambahkan tautan sesi claude.ai ketika melakukan commit atau membuka pull request dari sesi [cloud](https://code.claude.com/docs/id/claude-code-on-the-web.md) atau [Remote Control](https://code.claude.com/docs/id/remote-control.md). Claude Code menambahkan tautan sebagai trailer `Claude-Session` pada commit dan sebagai tautan dalam deskripsi pull request. Atur ke `false` untuk menghilangkan tautan. * **Scope**: [`Any file`](#scopes) * **Type**: Boolean * `true`: Claude Code menambahkan tautan sesi claude.ai ketika melakukan commit atau membuka pull request dari sesi cloud atau Remote Control * `false`: Claude Code menghilangkan tautan * **Default**: `true` ```json settings.json theme={null} { "attribution": { "sessionUrl": false } } ``` ## Hooks dan otomasi Daftarkan hooks, batasi hook mana yang berjalan, dan kontrol alur kerja. Untuk acara hook dan payload, lihat [referensi hooks](https://code.claude.com/docs/id/hooks.md). ### `allowedHttpHookUrls` Batasi URL mana yang dapat ditargetkan oleh [HTTP hooks](https://code.claude.com/docs/id/hooks.md#http-hook-fields). Ketika Anda menentukan kunci ini, Claude Code menjalankan HTTP hook hanya jika URL-nya cocok dengan salah satu pola dan memblokir sisanya tanpa menjalankannya; array kosong memblokir setiap HTTP hook. * **Scope**: [`Any file`](#scopes). Array digabungkan di seluruh file pengaturan. * **Type**: array pola URL, dengan `*` sebagai wildcard * **Default**: tidak diatur, jadi URL apa pun diizinkan Contoh ini memungkinkan URL apa pun di bawah `https://hooks.example.com/` dan URL `http://localhost` apa pun: ```json settings.json theme={null} { "allowedHttpHookUrls": ["https://hooks.example.com/*", "http://localhost:*"] } ``` Pencocokan nama host tidak peka huruf besar-kecil dan memperlakukan `hooks.example.com.`, dengan titik trailing yang menandai nama domain yang sepenuhnya memenuhi syarat, sama seperti `hooks.example.com`, yang merupakan cara DNS memperlakukannya. Allowlist berlaku untuk hooks dari setiap sumber, termasuk pengaturan terkelola. Dalam opsi `managedSettings` Agent SDK, Claude Code mengabaikan kunci ini ketika daftarnya berisi entri, jadi teruskan daftar tersebut dalam opsi `settings` SDK sebagai gantinya. Lihat [apa yang dilakukan setiap nilai dalam pengaturan induk](https://code.claude.com/docs/id/claude-apps-gateway#how-hook-and-skill-keys-in-parent-settings-take-effect). ### `allowManagedHooksOnly` Batasi eksekusi hook ke hooks yang digunakan organisasi Anda. * **Scope**: [`Managed`](#scopes) * **Type**: Boolean * `true`: hanya hook terkelola yang berjalan, ditambah hook Agent SDK dan hooks dari plugin yang dipaksa diaktifkan oleh pengaturan terkelola Anda. Lihat [Apa yang berjalan di bawah `allowManagedHooksOnly`](#what-runs-under-allowmanagedhooksonly) * `false`: hooks dari setiap cakupan pengaturan dan plugin berjalan * **Default**: tidak diatur, jadi hooks dari setiap cakupan pengaturan dan plugin berjalan ```json managed-settings.json theme={null} { "allowManagedHooksOnly": true } ``` #### Apa yang berjalan di bawah `allowManagedHooksOnly` Ketika Anda menyetelnya ke `true`, Claude Code mengubah hook dan perintah seperti hook mana yang dimuat: * **Hook terkelola dan SDK berjalan**: hooks dari pengaturan terkelola dan hooks yang didaftarkan [Agent SDK](https://code.claude.com/docs/id/agent-sdk/overview.md) dalam proses * **Hook plugin yang dipaksa diaktifkan berjalan**: hooks dari plugin yang dipaksa diaktifkan oleh pengaturan terkelola Anda melalui [`enabledPlugins`](#enabledplugins). Claude Code cocok dengan ID `plugin@marketplace` lengkap, jadi plugin dengan nama yang sama dari marketplace berbeda tetap diblokir. Ini memungkinkan Anda mendistribusikan hooks yang telah diverifikasi melalui marketplace organisasi sambil memblokir segalanya. Sebuah [mod](https://code.claude.com/docs/id/plugins/mods/overview.md) dalam plugin seperti itu dimuat hanya ketika [dihitung sebagai milik organisasi Anda](https://code.claude.com/docs/id/plugins/mods/admin.md#install-your-organizations-mods) * **Segalanya yang lain diblokir**: user, project, dan local hooks, hooks dan mods dari plugin lain yang diinstal, dan hooks yang dideklarasikan dalam frontmatter agent. [Mods yang tertanam dalam Claude Code](https://code.claude.com/docs/id/plugins/mods/overview.md#mods-built-into-claude-code) terus berjalan. Untuk memblokir hanya mods pengguna, atur [`allowManagedModsOnly`](https://code.claude.com/docs/id/plugins/mods/admin#set-options-on-the-built-in-guard) sebagai gantinya. * **Plugin bersumber perintah dinonaktifkan**: Claude Code juga menonaktifkan plugin dengan [`command` source](https://code.claude.com/docs/id/plugins/marketplace-reference#command-plugin-source), termasuk plugin yang dipaksa diaktifkan dalam `enabledPlugins` terkelola, kecuali Anda menyetel [`disableCommandPluginSources`](#disablecommandpluginsources) ke `false` secara eksplisit * **Perintah marketplace `headersHelper` diblokir**: Claude Code juga memblokir marketplace [`headersHelper` commands](https://code.claude.com/docs/id/plugins/host-marketplace#authenticate-archive-downloads) kecuali [`disableCommandPluginSources`](#disablecommandpluginsources) secara eksplisit diatur ke `false`, kecuali untuk marketplace yang dideklarasikan oleh pengaturan terkelola itu sendiri. Memerlukan Claude Code v2.1.238 atau lebih baru * **Baris status dan file suggestion menyempit ke pengaturan terkelola**: Claude Code membaca [`statusLine`](https://code.claude.com/docs/id/statusline), [`fileSuggestion`](#filesuggestion), dan [`subagentStatusLine`](https://code.claude.com/docs/id/statusline#subagent-status-lines) dari pengaturan terkelola saja, mengikuti [gerbang baris status dan file suggestion](#status-line-and-file-suggestion-gates) Perintah [`/goal`](https://code.claude.com/docs/id/goal) tidak dapat berjalan saat kunci ini diatur, karena bergantung pada hooks. ### `disableAllHooks` Matikan [hooks](https://code.claude.com/docs/id/hooks.md#disable-or-remove-hooks), [baris status](https://code.claude.com/docs/id/statusline.md) kustom apa pun, dan perintah [file suggestion](#filesuggestion) kustom apa pun. Gunakan untuk mematikan semua ini secara sementara tanpa menghapusnya dari pengaturan Anda. * **Scope**: [`Any file`](#scopes). Hanya pengaturan terkelola yang dapat menonaktifkan hook terkelola. * **Type**: Boolean * `true`: Claude Code mematikan hooks, baris status kustom apa pun, dan perintah file suggestion kustom apa pun * `false`: hooks, baris status, dan perintah file suggestion berjalan * **Default**: tidak diatur, jadi hooks berjalan ```json settings.json theme={null} { "disableAllHooks": true } ``` Jangkauan tergantung pada file mana yang membawa kunci: * **Dalam pengaturan terkelola**: Claude Code menonaktifkan setiap hook yang dikonfigurasi, termasuk yang terkelola, dan terus menjalankan hooks yang didaftarkan [Agent SDK](https://code.claude.com/docs/id/agent-sdk/overview.md) dalam proses * **Dalam opsi `managedSettings` Agent SDK**: Claude Code memperlakukan kunci ini sebagai `allowManagedHooksOnly: true`, jadi lihat [apa yang berjalan di bawah `allowManagedHooksOnly`](#what-runs-under-allowmanagedhooksonly) untuk mengetahui hook mana yang berhenti. Pada mesin tempat administrator men-deploy pengaturan terkelola, Claude Code mengabaikan kunci ini kecuali administrator [mengizinkan host penyemat menambahkan kebijakan](https://code.claude.com/docs/id/managed-settings.md#let-an-embedding-host-add-policy). Memerlukan Claude Code v2.1.309 atau lebih baru. * **Dalam file pengaturan lainnya**: Claude Code menonaktifkan user, project, local, dan plugin hooks; hook terkelola, hook Agent SDK, dan hooks dari plugin yang dipaksa diaktifkan dalam [`enabledPlugins`](#enabledplugins) terkelola terus berjalan Kunci ini juga menghentikan [mods](https://code.claude.com/docs/id/plugins/mods/overview.md), yaitu plugin yang kodenya mendaftarkan hook: * **Dalam pengaturan terkelola**: mods di setiap plugin yang diinstal berhenti, termasuk milik organisasi Anda * **Dalam file pengaturan lainnya**: mods yang Anda instal berhenti, dan [mods organisasi Anda](https://code.claude.com/docs/id/plugins/mods/admin.md#install-your-organizations-mods) terus berjalan Mods yang tertanam dalam Claude Code terus berjalan dalam kedua kasus. Masing-masing memiliki [tombol pengaturannya sendiri](https://code.claude.com/docs/id/plugins/mods/overview.md#mods-built-into-claude-code). Menjaga hook Agent SDK tetap berjalan ketika pengaturan terkelola menyetel kunci ini memerlukan Claude Code v2.1.242 atau lebih baru. Perintah [`/goal`](https://code.claude.com/docs/id/goal) tidak dapat berjalan saat hooks dinonaktifkan, dan menu `/hooks` menampilkan pemberitahuan alih-alih hooks Anda. #### Gerbang baris status dan file suggestion Claude Code membuat dua keputusan untuk `statusLine`, `fileSuggestion`, dan `subagentStatusLine`, dalam urutan ini: * **Matikan sepenuhnya**: ketika pengaturan terkelola menyetel `disableAllHooks`, atau ketika folder tidak dipercaya di bawah [aturan kepercayaan workspace yang sama dengan hooks dalam file pengaturan](https://code.claude.com/docs/id/permissions.md#what-runs-before-you-trust-a-folder) * **Menyempit ke pengaturan terkelola**: ketika [`allowManagedHooksOnly`](#allowmanagedhooksonly) diatur, ketika `disableAllHooks` adalah `true` di luar pengaturan terkelola setelah [prioritas pengaturan](https://code.claude.com/docs/id/hooks.md#disable-or-remove-hooks) diterapkan, atau ketika Anda memulai Claude Code dengan `--safe-mode` Di bawah penyempitan, Claude Code menjalankan nilai terkelola jika satu digunakan. Jika tidak, Claude Code melewati nilai Anda tanpa peringatan: baris status dinonaktifkan, dan `@` autocomplete kembali ke file suggestion bawaan. ### `disableWorkflows` Matikan [dynamic workflows](https://code.claude.com/docs/id/workflows.md#turn-workflows-off) dan perintah workflow bundel untuk semua orang yang dijangkau pengaturan Anda, seperti organisasi melalui pengaturan terkelola. Untuk menyalakan atau mematikan alur kerja hanya untuk diri sendiri, gunakan [`enableWorkflows`](#enableworkflows) sebagai gantinya, yang ditulis oleh toggle **Dynamic workflows** di `/config` ke pengaturan pengguna Anda. * **Scope**: [`Any file`](#scopes) * **Type**: Boolean * `true`: Claude Code mematikan dynamic workflows dan perintah workflow bundel untuk semua orang yang dijangkau pengaturan Anda * `false`: sama dengan tidak diatur; apakah alur kerja aktif kemudian mengikuti [`enableWorkflows`](#enableworkflows) dan default paket Anda * **Default**: `false` * **Per-session overrides**: [`CLAUDE_CODE_DISABLE_WORKFLOWS`](https://code.claude.com/docs/id/env-vars) mematikan alur kerja untuk satu sesi; mana pun dari keduanya yang mematikannya, yang lain tidak dapat menyalakannya kembali ```json settings.json theme={null} { "disableWorkflows": true } ``` ### `enableWorkflows` Nyalakan atau matikan [dynamic workflows](https://code.claude.com/docs/id/workflows.md) untuk diri sendiri ketika default paket Anda bukan apa yang Anda inginkan. Muncul di `/config` sebagai **Dynamic workflows**, yang menulis kunci ini ke pengaturan pengguna Anda dan menghapusnya lagi ketika Anda beralih kembali ke default paket Anda. Untuk mematikan alur kerja untuk semua orang dari pengaturan terkelola, gunakan [`disableWorkflows`](#disableworkflows) sebagai gantinya. * **Scope**: [`Any file`](#scopes) * **Type**: Boolean * `true`: Claude Code menyalakan dynamic workflows untuk Anda * `false`: Claude Code mematikan dynamic workflows untuk Anda * **Default**: tidak diatur, jadi alur kerja aktif kecuali Anda berada di paket Pro, di mana alur kerja dimatikan * **Per-session overrides**: [`CLAUDE_CODE_DISABLE_WORKFLOWS`](https://code.claude.com/docs/id/env-vars) mematikan alur kerja untuk satu sesi, dan `true` di sini tidak dapat menyalakannya kembali saat diatur ```json settings.json theme={null} { "enableWorkflows": true } ``` [`disableWorkflows`](#disableworkflows) dan kebijakan alur kerja organisasi Anda juga diutamakan: `enableWorkflows: true` tidak dapat menyalakan alur kerja kembali saat sumber apa pun mematikan alur kerja. Claude Code menyembunyikan baris `/config` saat sumber selain pengaturan pengguna Anda menyetel `enableWorkflows`, atau menyetel `disableWorkflows` ke `true`. ### `hooks` Jalankan perintah, prompt, agent, permintaan HTTP, atau tool MCP Anda sendiri sebagai [hooks](https://code.claude.com/docs/id/hooks.md) pada titik dalam siklus hidup Claude Code, seperti sebelum panggilan tool atau ketika sesi dimulai; [referensi hooks](https://code.claude.com/docs/id/hooks.md#hook-events) mencantumkan setiap acara, payload-nya, dan exit code-nya. Setiap acara memetakan ke daftar grup matcher, dan setiap grup mencantumkan handler yang akan dijalankan ketika matcher berlaku. * **Scope**: [`Any file`](#scopes). Hooks digabungkan di seluruh file daripada menggantikan satu sama lain, dan hooks dari pengaturan terkelola tidak dapat dihapus dari file lain. * **Type**: object yang dikunci oleh [hook event](https://code.claude.com/docs/id/hooks.md#hook-events); setiap nilai adalah array dari grup `{ "matcher", "hooks" }` yang entri `hooks`-nya memiliki `type` dari `"command"`, `"prompt"`, `"agent"`, `"http"`, atau `"mcp_tool"` * **Default**: tidak diatur, jadi tidak ada hooks yang berjalan Contoh ini menjalankan skrip sebelum setiap panggilan tool Bash: ```json settings.json theme={null} { "hooks": { "PreToolUse": [ { "matcher": "Bash", "hooks": [ { "type": "command", "command": "~/.claude/hooks/check-bash.sh" } ] } ] } } ``` Untuk setiap acara, pola matcher, dan bidang handler, lihat [referensi hooks](https://code.claude.com/docs/id/hooks.md#configuration). Untuk mematikan hooks, lihat [`disableAllHooks`](#disableallhooks); untuk membatasi hooks ke yang digunakan organisasi Anda, lihat [`allowManagedHooksOnly`](#allowmanagedhooksonly). ### `httpHookAllowedEnvVars` [HTTP hook](https://code.claude.com/docs/id/hooks.md#http-hook-fields) dapat menempatkan nilai environment variable ke dalam header permintaan, misalnya header `Authorization: Bearer $HOOK_TOKEN`, tetapi hanya untuk variabel yang dicantumkan hook dalam `allowedEnvVars`-nya sendiri. Kunci ini menetapkan batas luar pada daftar itu untuk setiap HTTP hook: hook dapat menggunakan variabel hanya jika baik `allowedEnvVars`-nya sendiri maupun kunci ini menamakannya. Gunakan untuk menghentikan hook dari membaca rahasia yang tidak seharusnya, bahkan ketika definisi hook memintanya. * **Scope**: [`Any file`](#scopes). Array digabungkan di seluruh file pengaturan. * **Type**: array nama environment variable * **Default**: tidak diatur, jadi daftar `allowedEnvVars` hook sendiri berlaku Contoh ini membatasi interpolasi header ke `MY_TOKEN` dan `HOOK_SECRET`: ```json settings.json theme={null} { "httpHookAllowedEnvVars": ["MY_TOKEN", "HOOK_SECRET"] } ``` Allowlist berlaku untuk hooks dari setiap sumber, termasuk pengaturan terkelola. Dalam opsi `managedSettings` Agent SDK, Claude Code mengabaikan kunci ini ketika daftarnya berisi entri, jadi teruskan daftar tersebut dalam opsi `settings` SDK sebagai gantinya. Lihat [apa yang dilakukan setiap nilai dalam pengaturan induk](https://code.claude.com/docs/id/claude-apps-gateway#how-hook-and-skill-keys-in-parent-settings-take-effect). ### `workflowKeywordTriggerEnabled` Pilih apakah mengetik kata kunci `ultracode` dalam prompt memicu [dynamic workflow](https://code.claude.com/docs/id/workflows.md#ask-for-a-workflow-in-your-prompt). Atur ke `false` untuk mengetik kata tanpa memicu satu. * **Scope**: [`Any file`](#scopes). Muncul di `/config` sebagai **Ultracode keyword trigger**. * **Type**: Boolean * `true`: mengetik `ultracode` dalam prompt memicu dynamic workflow * `false`: Anda dapat mengetik kata tanpa memicu satu * **Default**: `true` ```json settings.json theme={null} { "workflowKeywordTriggerEnabled": false } ``` Pengaturan upaya `ultracode`, `/workflows`, dan perintah alur kerja yang disimpan tidak terpengaruh. ### `workflowSizeGuideline` Atur [jumlah agent yang Claude targetkan](https://code.claude.com/docs/id/workflows.md#set-a-size-guideline) dalam dynamic workflows yang ditulisnya. Claude Code mengirimkan nilai ke Claude sebagai saran, bukan batas yang diberlakukan: `"small"` meminta lebih sedikit dari 5 agent, `"medium"` lebih sedikit dari 10, dan `"large"` lebih sedikit dari 50. Pilih `"small"` ketika Anda ingin membatasi apa yang dihabiskan alur kerja. Memerlukan Claude Code v2.1.219 atau lebih baru. * **Scope**: [`Any file`](#scopes). Nilai di sana diutamakan daripada pilihan **Dynamic workflow size** di `/config`, yang disimpan Claude Code di `~/.claude.json`, dan Claude Code menyembunyikan baris itu saat file pengaturan menyetel kunci. * **Type**: string, salah satu dari: * `"unrestricted"`: tidak ada panduan, jadi Claude mengukur alur kerja ke tugas * `"small"`: Claude menargetkan lebih sedikit dari 5 agent * `"medium"`: Claude menargetkan lebih sedikit dari 10 agent * `"large"`: Claude menargetkan lebih sedikit dari 50 agent * **Default**: `"medium"`, atau `"small"` ketika Anda masuk di paket Pro dengan Claude Code v2.1.271 atau lebih baru ```json settings.json theme={null} { "workflowSizeGuideline": "small" } ``` Memerlukan Claude Code v2.1.219 atau lebih baru; pada v2.1.202 hingga v2.1.218, atur panduan di `/config` sebagai gantinya. ## Plugins dan skills Aktifkan plugins, daftarkan marketplaces, batasi sumber plugin mana yang diizinkan organisasi, dan kontrol skills mana yang dimuat. Untuk menginstal dan membangun plugins, lihat [Plugins](https://code.claude.com/docs/id/plugins/overview.md). ### `disableBundledSkills` Matikan [skills](https://code.claude.com/docs/id/skills.md) dan workflows yang disertakan dengan Claude Code. Claude Code menghapus skills dan workflows bundel sepenuhnya, sementara perintah bawaan seperti `/init` tetap dapat diketik tetapi disembunyikan dari model. * **Scope**: [`Any file`](#scopes) * **Type**: Boolean * `true`: Claude Code menghapus skills dan workflows bundel dan menyembunyikan perintah bawaan seperti `/init` dari model * `false`: skills bundel dimuat * **Default**: unset, jadi skills bundel dimuat * **Per-session overrides**: [`CLAUDE_CODE_DISABLE_BUNDLED_SKILLS`](https://code.claude.com/docs/id/env-vars) diatur ke `1` mematikan skills bundel untuk satu sesi; mana pun dari keduanya yang mematikannya, yang lain tidak dapat menghidupkannya kembali ```json settings.json theme={null} { "disableBundledSkills": true } ``` Skills dari plugins, `.claude/skills/`, dan `.claude/commands/` tidak terpengaruh. `/doctor` tetap dapat diketik seperti perintah bawaan; untuk menyembunyikannya, atur [`DISABLE_DOCTOR_COMMAND`](https://code.claude.com/docs/id/env-vars) sebagai gantinya. ### `disableSkillShellExecution` Matikan eksekusi shell inline untuk `` !`...` `` dan ` ```! ` blocks dalam [skills](https://code.claude.com/docs/id/skills.md) dan perintah kustom dari sumber pengguna, proyek, plugin, atau direktori tambahan. Claude Code mengganti setiap perintah dengan `[shell command execution disabled by policy]` alih-alih menjalankannya. * **Scope**: [`Any file`](#scopes). Sebuah `true` dalam managed settings tidak dapat ditimpa oleh `false` di tempat lain. * **Type**: Boolean * `true`: Claude Code mengganti setiap perintah shell inline dengan `[shell command execution disabled by policy]` alih-alih menjalankannya * `false`: shell inline berjalan * **Default**: unset, jadi shell inline berjalan ```json settings.json theme={null} { "disableSkillShellExecution": true } ``` Skills bundel dan skills yang digunakan melalui managed settings tidak terpengaruh. ### `skillOverrides` Sembunyikan atau lipat [skill](https://code.claude.com/docs/id/skills.md#override-skill-visibility-from-settings) tanpa mengedit `SKILL.md`-nya. Claude Code menerapkan nilai di bawah nama setiap skill ke daftar skill yang Claude lihat dan ke autocomplete `/` Anda. * **Scope**: [`Any file`](#scopes). Menu `/skills` menulis ke `.claude/settings.local.json`. * **Type**: object mapping nama skill ke salah satu dari: * `"on"`: Claude melihat skill dan Anda dapat mengetik `/name` * `"name-only"`: Claude melihat skill berdasarkan nama tanpa deskripsinya * `"user-invocable-only"`: Claude tidak melihat skill, tetapi Anda masih dapat mengetik `/name` * `"off"`: Claude tidak melihat skill dan `/name` disembunyikan dari autocomplete * **Default**: unset, jadi setiap skill adalah `"on"` Contoh ini mencantumkan `legacy-context` ke Claude hanya berdasarkan nama dan menyembunyikan `deploy` dari Claude dan dari autocomplete `/`: ```json settings.json theme={null} { "skillOverrides": { "legacy-context": "name-only", "deploy": "off" } } ``` Overrides tidak berlaku untuk plugin skills, yang Anda kelola melalui `/plugin`. Dalam managed settings dan file yang dilewatkan dengan `--settings`, kunci pada alias skill bundel, seperti `checkup` untuk `/doctor`, juga berlaku untuk skill; lihat [bagaimana kunci alias menggabungkan dengan kunci pada nama skill itu sendiri](https://code.claude.com/docs/id/skills.md#override-skill-visibility-from-settings). ### `syncClaudeAiSkills` Matikan unduhan [skills yang diaktifkan untuk akun claude.ai Anda](https://code.claude.com/docs/id/skills.md#how-synced-skills-behave). Claude Code mengunduhnya ke `~/.claude/skills/synced/` dalam [sesi terminal di mana Anda masuk dengan akun claude.ai Anda](https://code.claude.com/docs/id/skills.md#where-synced-skills-load), interaktif atau non-interaktif, dan dalam sesi Cowork dan cloud. Atur `false` untuk menghentikan unduhan itu dan berhenti memuat skills yang sudah disinkronkan. Claude Code hanya menghormati `false`: `true` sama dengan unset dan tidak menghidupkan sinkronisasi di mana sebaliknya mati. * **Scope**: [`User, local, or managed`](#scopes), dan file yang dilewatkan dengan `--settings`. Repositori tidak dapat mematikannya untuk Anda. * **Type**: Boolean * `false`: Claude Code berhenti mengunduh skills yang disinkronkan dan berhenti memuat yang sudah ada di `~/.claude/skills/synced/`. Dalam user atau managed settings, itu juga memindahkannya ke `~/.claude/skills/.trash/` * `true`: sama dengan unset * **Default**: unset, jadi sesi yang masuk dengan akun claude.ai Anda menyinkronkan skills Anda Contoh ini mencegah mesin mengunduh skills akun dalam sesi apa pun: ```json settings.json theme={null} { "syncClaudeAiSkills": false } ``` ### `syncClaudeAiPlugins` Matikan unduhan [plugins yang diaktifkan untuk akun claude.ai Anda](https://code.claude.com/docs/id/plugins/loading.md#synced-plugins). Claude Code mengunduhnya ke `~/.claude/plugins/synced/` pada awal sesi terminal di mana Anda masuk dengan akun claude.ai Anda dan dalam sesi Cowork, dan memuat masing-masing sebagai `@synced`. Atur `false` untuk menghentikan unduhan itu dan berhenti memuat plugins yang sudah disinkronkan. Claude Code hanya menghormati `false`: `true` sama dengan unset dan tidak menghidupkan sinkronisasi di mana sebaliknya mati. Memerlukan Claude Code v2.1.273 atau lebih baru. * **Scope**: [`User, local, or managed`](#scopes), dan file yang dilewatkan dengan `--settings`. Repositori tidak dapat mematikannya untuk Anda. * **Type**: Boolean * `false`: Claude Code berhenti mengunduh plugins yang disinkronkan dan berhenti memuat yang sudah ada di `~/.claude/plugins/synced/`. Dalam user atau managed settings, itu juga memindahkannya ke `~/.claude/plugins/.trash/` * `true`: sama dengan unset * **Default**: unset, jadi sesi yang masuk dengan akun claude.ai Anda menyinkronkan plugins Anda Untuk mematikan satu plugin yang disinkronkan daripada semuanya, atur `"@synced": false` dalam [`enabledPlugins`](#enabledplugins). Contoh ini mencegah mesin mengunduh plugins akun dalam sesi apa pun: ```json settings.json theme={null} { "syncClaudeAiPlugins": false } ``` ### `allowedChannelPlugins` Pilih [channel](https://code.claude.com/docs/id/channels.md) plugins mana yang dapat mendorong pesan ke dalam sesi di organisasi Anda. Ketika Anda mengaturnya, Claude Code menggunakan daftar Anda sebagai pengganti daftar allowlist default Anthropic; setiap entri menamai plugin dan marketplace tempat asalnya. * **Scope**: [`Managed`](#scopes) * **Type**: array objek, masing-masing dengan string `marketplace` dan `plugin`. Sebuah entri dapat sebagai gantinya menjadi string `"plugin@marketplace"` seperti `"telegram@claude-plugins-official"`, yang Claude Code perlakukan sebagai objek yang setara. Bentuk string memerlukan Claude Code v2.1.267 atau lebih baru; versi sebelumnya menolak seluruh nilai `allowedChannelPlugins` ketika berisi satu * **Default**: unset, jadi Claude Code menggunakan daftar allowlist default Anthropic Contoh ini menghidupkan channels dan hanya mengizinkan plugin Telegram dari marketplace resmi Anthropic: ```json managed-settings.json theme={null} { "channelsEnabled": true, "allowedChannelPlugins": [ { "marketplace": "claude-plugins-official", "plugin": "telegram" } ] } ``` Array kosong memblokir setiap channel plugin. Kunci ini berlaku setelah channels melewati gerbang [`channelsEnabled`](#channelsenabled) untuk akun: pada paket Team dan Enterprise, dan pada akun Console dengan managed settings, itu berarti `channelsEnabled: true`. Lihat [Batasi plugins channel mana yang dapat berjalan](https://code.claude.com/docs/id/channels.md#restrict-which-channel-plugins-can-run). ### `blockedMarketplaces` Blokir sumber marketplace plugin untuk organisasi Anda. Claude Code memeriksa daftar blokir pada penambahan marketplace dan pada instalasi, pembaruan, penyegaran, dan auto-update plugin, jadi marketplace yang ditambahkan seseorang sebelum Anda menetapkan kebijakan tidak dapat digunakan untuk mengambil plugins. Sumber yang diblokir diperiksa sebelum unduhan, jadi mereka tidak pernah menyentuh filesystem. Jika Anda menetapkan kunci ini dalam [konsol admin claude.ai](https://code.claude.com/docs/id/server-managed-settings.md), claude.ai juga menerapkannya ketika siapa pun di organisasi Anda menambahkan marketplace dari repositori git di claude.ai, seperti yang dijelaskan [Bagaimana pembatasan bekerja](https://code.claude.com/docs/id/plugins/org.md#restrict-what-users-can-install). * **Scope**: [`Managed`](#scopes) * **Type**: array objek sumber marketplace, dalam bentuk yang sama seperti [`strictKnownMarketplaces`](#allowed-source-types) * **Default**: unset, jadi tidak ada marketplace yang diblokir Contoh ini memblokir satu repositori GitHub sebagai sumber marketplace: ```json managed-settings.json theme={null} { "blockedMarketplaces": [ { "source": "github", "repo": "untrusted/plugins" } ] } ``` Entri `github` dapat menggunakan [bentuk owner-wildcard](#owner-wildcards) `"owner/*"` untuk memblokir setiap repositori di bawah pemilik GitHub itu, yang memerlukan Claude Code v2.1.223 atau lebih baru. Tambahkan `{ "source": "skills-dir" }` untuk menghentikan Claude Code memuat [`@skills-dir` plugins](https://code.claude.com/docs/id/plugins/loading#plugins-shared-through-a-repository) dari `~/.claude/skills/` maupun `.claude/skills/` proyek, tanpa membatasi marketplace apa pun. Lihat [Pembatasan marketplace yang dikelola](https://code.claude.com/docs/id/plugins/org.md#restrict-what-users-can-install). ### `channelsEnabled` Izinkan [channels](https://code.claude.com/docs/id/channels.md) untuk organisasi Anda. Pada paket Team dan Enterprise claude.ai, Claude Code memblokir channels sampai Anda mengaturnya ke `true`. Untuk akun [Anthropic Console](https://code.claude.com/docs/id/authentication.md#claude-console-authentication) yang mengautentikasi dengan kunci API, channels diizinkan secara default. Jika organisasi Anda menerapkan managed settings, Claude Code juga memblokir channels pada akun tersebut sampai Anda mengatur kunci ini ke `true`. * **Scope**: [`Managed`](#scopes) * **Type**: Boolean * `true`: Claude Code mengizinkan channels untuk organisasi Anda * `false`: sama dengan unset; apakah channels diblokir tergantung pada paket Anda, seperti yang dikatakan Default * **Default**: unset; channels diblokir pada paket Team dan Enterprise dan pada akun Console dengan managed settings, dan diizinkan pada paket Pro dan Max dan pada akun Console tanpa managed settings ```json managed-settings.json theme={null} { "channelsEnabled": true } ``` Untuk membatasi plugins mana yang dapat mendaftar sebagai channels setelah diaktifkan, atur [`allowedChannelPlugins`](#allowedchannelplugins). Lihat [Kontrol enterprise](https://code.claude.com/docs/id/channels.md#enterprise-controls). ### `disableCommandPluginSources` Blokir [sumber plugin `command`](https://code.claude.com/docs/id/plugins/marketplace-reference#command-plugin-source), yang menginstal plugin dengan menjalankan perintah yang dideklarasikan marketplace pada mesin pengguna. Ketika Anda mengaturnya ke `true`, Claude Code tidak pernah menjalankan perintah, tidak menginstal atau memperbarui plugins yang bersumber perintah, dan berhenti memuat yang sudah diinstal. Atur ke `false` untuk mengizinkannya secara eksplisit. Kapan pun itu memblokir sumber perintah, apakah Anda mengaturnya ke `true` atau membiarkannya unset di bawah [`allowManagedHooksOnly`](#allowmanagedhooksonly), itu juga memblokir perintah marketplace [`headersHelper`](https://code.claude.com/docs/id/plugins/host-marketplace#authenticate-archive-downloads), kecuali untuk marketplace yang managed settings sendiri deklarasikan. Memerlukan Claude Code v2.1.229 atau lebih baru, dan blokir `headersHelper` memerlukan v2.1.238 atau lebih baru. * **Scope**: [`Managed`](#scopes) * **Type**: Boolean * `true`: Claude Code tidak pernah menjalankan perintah yang dideklarasikan marketplace, tidak menginstal atau memperbarui plugins yang bersumber perintah, dan berhenti memuat yang sudah diinstal * `false`: Claude Code mengizinkan plugins yang bersumber perintah secara eksplisit * **Default**: unset, jadi Claude Code mengikuti [`allowManagedHooksOnly`](#allowmanagedhooksonly): organisasi yang membatasi eksekusi hook ke managed settings juga mendapatkan sumber perintah dinonaktifkan ```json managed-settings.json theme={null} { "disableCommandPluginSources": true } ``` Memerlukan Claude Code v2.1.229 atau lebih baru. ### `pluginSuggestionMarketplaces` Namai marketplaces yang plugins-nya dapat muncul sebagai saran instalasi kontekstual, dalam tips spinner dan disematkan di bagian atas tab **Discover** `/plugin`. Tip frontend-design pihak pertama bawaan tidak terpengaruh. Saran berasal dari deklarasi `relevance` setiap plugin dalam entri marketplace-nya. * **Scope**: [`Managed`](#scopes) * **Type**: array nama marketplace * **Default**: unset, jadi tidak ada saran yang dideklarasikan marketplace yang muncul ```json managed-settings.json theme={null} { "pluginSuggestionMarketplaces": ["acme-corp-plugins"] } ``` Nama berlaku hanya ketika marketplace terdaftar di mesin dan sumber terdaftarnya juga dideklarasikan dalam managed settings yang sama, baik sebagai entri [`extraKnownMarketplaces`](#extraknownmarketplaces) untuk nama itu atau sebagai entri [`strictKnownMarketplaces`](#strictknownmarketplaces). Claude Code mengabaikan marketplace yang terdaftar dari sumber berbeda di bawah nama yang diizinkan. Marketplace resmi dikecualikan dari persyaratan sumber: mengizinkan nama saja sudah cukup, karena nama itu hanya dapat terdaftar dari sumber Anthropic resmi. Lihat [Sarankan plugins berdasarkan konteks](https://code.claude.com/docs/id/plugins/relevance.md). ### `pluginTrustMessage` Tambahkan teks organisasi Anda sendiri ke peringatan kepercayaan plugin yang Claude Code tunjukkan sebelum instalasi, misalnya untuk mengkonfirmasi bahwa plugins dari marketplace internal Anda telah dikurasi. * **Scope**: [`Managed`](#scopes) * **Type**: string * **Default**: unset, jadi Claude Code menunjukkan peringatan standar saja ```json managed-settings.json theme={null} { "pluginTrustMessage": "All plugins from our marketplace are approved by IT" } ``` ### `strictKnownMarketplaces` Batasi sumber marketplace plugin mana yang dapat ditambahkan dan diinstal oleh orang-orang di organisasi Anda. Claude Code memberlakukan daftar allowlist pada penambahan marketplace dan pada instalasi, pembaruan, penyegaran, dan auto-update plugin, sebelum operasi jaringan atau filesystem apa pun, jadi marketplace yang ditambahkan seseorang sebelum Anda menetapkan kebijakan tidak dapat digunakan untuk mengambil plugins setelah sumbernya tidak lagi cocok. Pengguna yang diblokir melihat kesalahan yang menamai kebijakan yang dikelola. Jika Anda menetapkan kunci ini dalam [konsol admin claude.ai](https://code.claude.com/docs/id/server-managed-settings.md), claude.ai juga menerapkannya ketika siapa pun di organisasi Anda menambahkan marketplace dari repositori git di claude.ai, seperti yang dijelaskan [Bagaimana pembatasan bekerja](https://code.claude.com/docs/id/plugins/org.md#restrict-what-users-can-install). * **Scope**: [`Managed`](#scopes) * **Type**: array objek sumber marketplace; lihat [Tipe sumber yang diizinkan](#allowed-source-types) * **Default**: unset, jadi pengguna dapat menambahkan marketplace apa pun. Array kosong adalah lockdown lengkap yang memblokir setiap sumber marketplace, termasuk marketplace resmi Anthropic Contoh ini mengizinkan dua repositori GitHub, satu disematkan ke ref `v2.0`, dan satu URL `marketplace.json` yang dihosting: ```json managed-settings.json theme={null} { "strictKnownMarketplaces": [ { "source": "github", "repo": "acme-corp/approved-plugins" }, { "source": "github", "repo": "acme-corp/security-tools", "ref": "v2.0" }, { "source": "url", "url": "https://plugins.example.com/marketplace.json" } ] } ``` Anda juga dapat menulis kunci ini sebagai `allowedMarketplaces`; [Alias kunci Marketplace](#marketplace-key-aliases) menjelaskan bagaimana Claude Code memperlakukan alias dan versi mana yang menerimanya. Kunci ini adalah gerbang kebijakan: itu mengontrol apa yang dapat ditambahkan pengguna tetapi tidak mendaftarkan apa pun. Untuk membatasi dan pra-daftar dalam satu file, lihat [Gabungkan dengan `extraKnownMarketplaces`](#combine-with-extraknownmarketplaces). Untuk tampilan yang menghadap pengguna, lihat [Pembatasan marketplace yang dikelola](https://code.claude.com/docs/id/plugins/org.md#restrict-what-users-can-install). #### Tipe sumber yang diizinkan Setiap entri di bawah menunjukkan satu entri daftar allowlist per tipe sumber dan bidang yang diterimanya. Sebagian besar tipe cocok persis; `hostPattern` dan `pathPattern` cocok dengan regex, dan entri `github` dapat menggunakan [wildcard pemilik](#owner-wildcards). | Source | Contoh entri | Bidang | | :- | :- | :- | | `github` | `{ "source": "github", "repo": "acme-corp/plugins", "ref": "main", "path": "marketplace" }` | `repo` diperlukan; `ref` adalah cabang atau tag; `path` adalah subdirektori | | `git` | `{ "source": "git", "url": "https://gitlab.example.com/tools/plugins.git", "ref": "production" }` | `url` diperlukan; `ref` dan `path` seperti untuk `github` | | `url` | `{ "source": "url", "url": "https://plugins.example.com/marketplace.json", "headers": { "Authorization": "Bearer ${TOKEN}" } }` | `url` diperlukan; `headers` menambahkan header HTTP untuk akses yang diautentikasi | | `file` | `{ "source": "file", "path": "/opt/acme-corp/plugins/marketplace.json" }` | `path` diperlukan, jalur absolut ke file `marketplace.json` | | `directory` | `{ "source": "directory", "path": "/opt/acme-corp/approved-marketplaces" }` | `path` diperlukan, jalur absolut ke direktori yang berisi `.claude-plugin/marketplace.json` | | `hostPattern` | `{ "source": "hostPattern", "hostPattern": "^github\\.example\\.com$" }` | `hostPattern` diperlukan, regex yang cocok di mana saja dalam host marketplace; jangkarnya dengan `^` dan `$` untuk mencocokkan seluruh host | | `pathPattern` | `{ "source": "pathPattern", "pathPattern": "^/opt/approved/" }` | `pathPattern` diperlukan, regex yang cocok di mana saja dalam `path` dari sumber `file` dan `directory`; mulai dengan `^` untuk menancapkan awalan | | `skills-dir` | `{ "source": "skills-dir" }` | Tidak ada bidang | Beberapa tipe sumber membawa aturan di luar tabel: * **`url`**: marketplace URL hanya mengunduh file `marketplace.json`, dan Claude Code tidak mengambil file plugin dengan jalur relatif dari server itu, jadi plugins-nya harus menggunakan [sumber plugin](https://code.claude.com/docs/id/plugins/marketplace-reference.md#plugin-sources) selain jalur relatif, seperti URL arsip, yang dapat berada di host yang sama. Untuk plugins dengan jalur relatif, gunakan marketplace berbasis Git sebagai gantinya. Lihat [Plugins dengan jalur relatif gagal dalam marketplaces berbasis URL](https://code.claude.com/docs/id/plugins/troubleshooting.md#plugins-with-relative-paths-fail-in-url-based-marketplaces). * **`hostPattern`**: gunakan untuk mengizinkan setiap marketplace di server GitHub Enterprise atau GitLab internal tanpa mencantumkan setiap repositori. Claude Code mencocokkan sumber `github` terhadap `github.com`, mengambil hostname dari sumber `url`, dan mengambilnya dari sumber `git` tergantung pada bentuk [git URL](https://git-scm.com/docs/git-clone#_git_urls): * URL dengan skema, seperti `https://` atau `ssh://`: hostname dalam URL. * Alamat SSH tanpa skema, dalam bentuk `user@host:path` git, seperti `git@git.example.com:tools/plugins.git`: host antara `@` dan `:`, yang merupakan host yang terhubung git. * Bentuk lain apa pun tanpa skema: tidak ada host, jadi tidak ada entri `hostPattern` `strictKnownMarketplaces` yang cocok dengannya. Untuk `hostPattern` `blockedMarketplaces`, Claude Code mengambil host dari set bentuk yang lebih luas, jadi entri daftar blokir masih dapat cocok dengan bentuk seperti itu. Sebelum v2.1.234, `hostPattern` `strictKnownMarketplaces` juga cocok dengan beberapa bentuk yang git tidak perlakukan sebagai alamat SSH. Sumber `file` dan `directory` tidak memiliki host dan tidak pernah cocok dengan entri `hostPattern`. * **`pathPattern`**: gunakan untuk mengizinkan marketplaces filesystem bersama entri `hostPattern` untuk sumber jaringan. `".*"` mengizinkan setiap jalur lokal; pola yang lebih sempit seperti `"^/opt/approved/"` membatasi ke direktori. * **`skills-dir`**: daftar allowlist apa pun, bahkan yang kosong, menghentikan Claude Code memuat [`@skills-dir` plugins](https://code.claude.com/docs/id/plugins/loading#plugins-shared-through-a-repository) dari `~/.claude/skills/` maupun `.claude/skills/` proyek. Untuk tetap memuatnya, tambahkan entri `{ "source": "skills-dir" }` dan biarkan [`strictPluginOnlyCustomization`](#strictpluginonlycustomization) tidak diatur. Entri tersebut tidak memiliki arti di luar kunci ini dan `blockedMarketplaces`. #### Owner wildcards Entri `github` yang nilai `repo`-nya adalah `"/*"` cocok dengan setiap repositori di bawah pemilik GitHub itu. Wildcard pemilik memerlukan Claude Code v2.1.223 atau lebih baru dan hanya bekerja dalam `strictKnownMarketplaces` dan `blockedMarketplaces`. Di tempat lain sumber `github` muncul, seperti `extraKnownMarketplaces` atau `/plugin marketplace add`, nilai `repo` harus menamai satu repositori. Sebelum v2.1.223, Claude Code membandingkan entri secara harfiah, jadi entri daftar allowlist tidak cocok dengan repositori apa pun dan entri daftar blokir tidak memblokir apa pun; entri repositori tunggal diberlakukan pada setiap versi. Entri ini mengizinkan repositori marketplace apa pun dalam organisasi `acme-corp`: ```json managed-settings.json theme={null} { "strictKnownMarketplaces": [ { "source": "github", "repo": "acme-corp/*" } ] } ``` Hanya seluruh posisi nama-repositori yang dapat menjadi wildcard. Claude Code mengabaikan entri seperti `*`, `*/plugins`, atau `acme-corp/tools-*` sebagai tidak valid, jadi mereka tidak cocok dengan repositori apa pun. Aturan pencocokan berbeda antara dua pengaturan: | Aturan | `strictKnownMarketplaces` | `blockedMarketplaces` | | - | - | - | | Pencocokan ejaan sumber | Bentuk `owner/repo` saja. URL git yang mengkloning repositori yang sama tidak cocok | Ejaan apa pun, termasuk URL git yang diselesaikan ke repositori github.com yang sama | | Kasus pemilik | Peka huruf besar-kecil | Tidak peka huruf besar-kecil | | `ref` | Mengikuti aturan entri yang tepat: entri dengan `ref` hanya cocok dengan sumber dengan ref yang tepat itu, dan entri tanpa satu cocok hanya dengan sumber yang tidak menentukan ref | Entri tanpa `ref` memblokir semua ref dari repositori yang cocok dengannya | | `path` | Lebih longgar daripada aturan entri yang tepat: entri dengan `path` memerlukan nilai yang tepat itu, sementara entri tanpa satu cocok dengan jalur apa pun di dalam repositori | Entri tanpa `path` memblokir semua jalur dari repositori yang cocok dengannya | #### Exact matching Untuk setiap tipe sumber kecuali entri `github` wildcard pemilik dan entri `hostPattern` dan `pathPattern` yang cocok dengan regex, Claude Code hanya mengizinkan penambahan pengguna ketika sumber marketplace cocok dengan entri secara tepat. Untuk sumber berbasis git `github` dan `git`, pencocokan yang tepat mencakup bidang opsional: * `repo` atau `url` harus cocok persis * Bidang `ref` harus cocok persis, atau keduanya harus tidak terdefinisi * Bidang `path` harus cocok persis, atau keduanya harus tidak terdefinisi Misalnya, Claude Code memperlakukan setiap pasangan di bawah sebagai dua sumber berbeda: * `{ "source": "github", "repo": "acme-corp/plugins" }` dan `{ "source": "github", "repo": "acme-corp/plugins", "ref": "main" }` * `{ "source": "github", "repo": "acme-corp/plugins", "path": "marketplace" }` dan `{ "source": "github", "repo": "acme-corp/plugins" }` #### Allow only the official marketplace Untuk mengizinkan marketplace resmi Anthropic dan tidak ada yang lain, cantumkan repositorinya: ```json managed-settings.json theme={null} { "strictKnownMarketplaces": [ { "source": "github", "repo": "anthropics/claude-plugins-official" } ] } ``` Dengan entri ini, Claude Code menjaga marketplace resmi yang sudah terdaftar tetap tersedia dan, di mesin baru, mendaftarkan marketplace secara otomatis pertama kali Anda memulai sesi terminal interaktif. Pendaftaran otomatis paling sering melewatkan: * Lingkungan non-interaktif yang berjalan sebelum sesi terminal interaktif pertama mesin. * Mesin di mana Claude Code sudah berjalan melalui ekstensi VS Code. * Mesin di mana Claude Code sudah menjalankan sesi terminal interaktif di bawah kebijakan yang memblokir marketplace, seperti lockdown array kosong. Claude Code mencatat upaya yang diblokir dan tidak mencoba lagi setelah kebijakan berubah. Pada mesin ini, tambahkan marketplace ke [`extraKnownMarketplaces`](#extraknownmarketplaces) dalam `managed-settings.json` yang sama sehingga Claude Code mendaftarkannya secara otomatis, atau jalankan `claude plugin marketplace add anthropics/claude-plugins-official`. #### Combine with `extraKnownMarketplaces` Dua kunci melakukan pekerjaan berbeda. Tabel ini membandingkannya: | Aspek | `strictKnownMarketplaces` | `extraKnownMarketplaces` | | - | - | - | | Tujuan | Penegakan kebijakan organisasi | Kenyamanan tim | | File pengaturan | Hanya managed settings | File pengaturan apa pun | | Perilaku | Memblokir penambahan yang tidak diizinkan | Mendaftarkan marketplace yang hilang | | Kapan diberlakukan | Sebelum operasi jaringan dan filesystem | Segera dari user atau managed settings; setelah dialog kepercayaan workspace untuk file repositori | | Dapat ditimpa | Tidak, prioritas tertinggi | Ya, oleh pengaturan prioritas lebih tinggi | | Format sumber | Objek sumber langsung | Marketplace bernama dengan objek `source` bersarang | Untuk membatasi dan pra-daftar marketplace untuk semua pengguna, atur keduanya dalam `managed-settings.json`: ```json managed-settings.json theme={null} { "strictKnownMarketplaces": [ { "source": "github", "repo": "acme-corp/plugins" } ], "extraKnownMarketplaces": { "acme-tools": { "source": { "source": "github", "repo": "acme-corp/plugins" } } } } ``` Dengan hanya `strictKnownMarketplaces` yang diatur, pengguna masih dapat menambahkan marketplace yang diizinkan sendiri dengan `/plugin marketplace add`. Marketplace resmi Anthropic adalah satu-satunya yang Claude Code daftarkan secara otomatis, dan hanya ketika daftar allowlist mengizinkannya. [Allow only the official marketplace](#allow-only-the-official-marketplace) mencantumkan mesin yang dilewatkan. ### `strictPluginOnlyCustomization` Blokir skills, agents, hooks, dan MCP servers dari sumber pengguna dan proyek, jadi mereka hanya dapat berasal dari plugins atau managed settings. Gabungkan dengan [`strictKnownMarketplaces`](#strictknownmarketplaces) untuk mengontrol rantai pasokan kustomisasi penuh: daftar allowlist marketplace mengontrol plugins mana yang dapat diinstal pengguna. * **Scope**: [`Managed`](#scopes) * **Type**: `true` untuk mengunci semua empat jenis kustomisasi, atau array yang menamai jenis untuk dikunci, dari `"skills"`, `"agents"`, `"hooks"`, dan `"mcp"` * **Default**: unset, jadi tidak ada yang dikunci Contoh ini mengunci skills dan hooks dan membiarkan agents dan MCP servers tidak terkunci: ```json managed-settings.json theme={null} { "strictPluginOnlyCustomization": ["skills", "hooks"] } ``` Jika Anda mengunci surface apa pun, Claude Code juga berhenti memuat [plugin skills-directory](https://code.claude.com/docs/id/plugins/loading.md#skills-directory-plugins-blocked-by-managed-settings), yaitu folder plugin yang disimpan pengguna di bawah `~/.claude/skills/` atau `.claude/skills/`. Pengguna menempatkan folder tersebut sendiri alih-alih menginstalnya dari marketplace, sehingga Claude Code memperlakukannya sebagai kustomisasi pengguna di bawah pengaturan ini. Empat entri sub-kunci di bawah mencantumkan apa lagi yang diblokir setiap surface dan apa yang masih dimuat. Claude Code mengabaikan nama surface yang tidak dikenalinya daripada menggagalkan file pengaturan, jadi Anda dapat menambahkan nama surface baru sebelum setiap klien diperbarui. ### `strictPluginOnlyCustomization.skills` Kunci surface `skills`. Claude Code berhenti memuat skills dari `~/.claude/skills/` dan `.claude/skills/`, perintah kustom dari `~/.claude/commands/` dan `.claude/commands/`, skills dan perintah di bawah direktori `--add-dir`, dan skills yang disinkronkan dari akun claude.ai Anda. Claude Code tetap memuat skill bawaan, skills dalam direktori kebijakan terkelola, dan skills dari plugins selain [plugin skills-directory](https://code.claude.com/docs/id/plugins/loading.md#skills-directory-plugins-blocked-by-managed-settings). * **Scope**: [`Managed`](#scopes) * **Type**: string `"skills"` dalam array [`strictPluginOnlyCustomization`](#strictpluginonlycustomization) * **Default**: tidak dikunci ```json managed-settings.json theme={null} { "strictPluginOnlyCustomization": ["skills"] } ``` ### `strictPluginOnlyCustomization.agents` Kunci surface `agents`. Claude Code berhenti memuat agents dari `~/.claude/agents/`, `.claude/agents/`, dan direktori `--add-dir`. Claude Code tetap memuat agents bawaan, agents dalam direktori kebijakan terkelola, dan agents dari plugins selain [plugin skills-directory](https://code.claude.com/docs/id/plugins/loading.md#skills-directory-plugins-blocked-by-managed-settings). * **Scope**: [`Managed`](#scopes) * **Type**: string `"agents"` dalam array [`strictPluginOnlyCustomization`](#strictpluginonlycustomization) * **Default**: tidak dikunci ```json managed-settings.json theme={null} { "strictPluginOnlyCustomization": ["agents"] } ``` ### `strictPluginOnlyCustomization.hooks` Kunci surface `hooks`: * **Berhenti berjalan**: * Hooks dari `settings.json` pengguna, proyek, dan lokal * Hook frontmatter dalam skills, perintah kustom, dan agents, dari sumber yang akan diblokir oleh penguncian [`skills`](#strictpluginonlycustomization-skills) atau [`agents`](#strictpluginonlycustomization-agents) * **Tetap berjalan**: hooks dalam pengaturan terkelola, dan hooks dari plugins selain [plugin skills-directory](https://code.claude.com/docs/id/plugins/loading.md#skills-directory-plugins-blocked-by-managed-settings) Skills, perintah kustom, dan agents yang hook frontmatter-nya berhenti berjalan tetap dimuat selama surface mereka sendiri tidak dikunci. [Skill](https://code.claude.com/docs/id/skills.md#where-skills-live) pribadi atau proyek yang mendeklarasikan `hooks` dalam frontmatter-nya juga kehilangan pra-persetujuan [`allowed-tools`](https://code.claude.com/docs/id/skills#pre-approve-tools-for-a-skill)-nya, sehingga pengguna Anda mendapatkan permintaan izin untuk tool yang dicantumkan bidang tersebut. Ketika skill seperti itu berjalan dalam subagent melalui [`context: fork`](https://code.claude.com/docs/id/skills#run-skills-in-a-subagent), skill tersebut tetap mempertahankan pra-persetujuannya. Skill yang tidak mendeklarasikan `hooks` juga tetap mempertahankan pra-persetujuannya. * **Scope**: [`Managed`](#scopes) * **Type**: string `"hooks"` dalam array [`strictPluginOnlyCustomization`](#strictpluginonlycustomization) * **Default**: tidak dikunci ```json managed-settings.json theme={null} { "strictPluginOnlyCustomization": ["hooks"] } ``` ### `strictPluginOnlyCustomization.mcp` Kunci surface `mcp`. Claude Code berhenti memuat server MCP dari `~/.claude.json` dan `.mcp.json`. Claude Code tetap memuat server [`managed-mcp.json`](https://code.claude.com/docs/id/managed-mcp), server dari [`managedMcpServers`](#managedmcpservers), dan server MCP dari plugins selain [plugin skills-directory](https://code.claude.com/docs/id/plugins/loading.md#skills-directory-plugins-blocked-by-managed-settings). * **Scope**: [`Managed`](#scopes) * **Type**: string `"mcp"` dalam array [`strictPluginOnlyCustomization`](#strictpluginonlycustomization) * **Default**: tidak dikunci ```json managed-settings.json theme={null} { "strictPluginOnlyCustomization": ["mcp"] } ``` ### `enabledPlugins` Hidupkan atau matikan [plugins](https://code.claude.com/docs/id/plugins/overview.md) individual, dikunci dengan `plugin-name@marketplace-name`. Plugin tanpa entri di scope apa pun kembali ke nilai [`defaultEnabled`](https://code.claude.com/docs/id/plugins/manifest-reference#fields)-nya. Ketika Anda mengaktifkan atau menonaktifkan plugin dengan `/plugin` atau `claude plugin enable`, Claude Code menulis kunci ini untuk Anda. * **Scope**: [`Any file`](#scopes) * **Type**: object mapping `plugin-name@marketplace-name` ke Boolean * **Default**: unset, jadi setiap plugin mengikuti nilai `defaultEnabled`-nya Contoh ini mengaktifkan dua plugins dari marketplace `team-tools` dan menonaktifkan satu dari `personal`: ```json settings.json theme={null} { "enabledPlugins": { "code-formatter@team-tools": true, "deployment-tools@team-tools": true, "experimental-features@personal": false } } ``` Setiap scope melayani tujuan berbeda: * **User settings**: preferensi plugin pribadi Anda * **Project settings**: plugins yang dibagikan dengan semua orang di repositori * **Local settings**: overrides per-mesin, gitignored ketika Claude Code menyimpan pengaturan di sana * **Managed settings**: kebijakan organisasi-lebar. Plugin yang diatur ke `false` di sini diblokir dari instalasi di setiap scope dan disembunyikan dari marketplace Pengaturan proyek mengambil prioritas atas pengaturan pengguna, jadi mengatur plugin ke `false` dalam `~/.claude/settings.json` tidak menonaktifkan plugin yang `.claude/settings.json` proyek aktifkan. Untuk memilih keluar dari plugin yang diaktifkan proyek di mesin Anda, atur ke `false` dalam `.claude/settings.local.json` sebagai gantinya. Plugins yang dipaksa diaktifkan oleh managed settings tidak dapat dinonaktifkan dengan cara ini, karena managed settings menimpa pengaturan lokal. Mengaktifkan plugin dari sumber eksternal seperti repositori GitHub atau paket npm dalam `.claude/settings.json` proyek tidak menginstalnya untuk orang lain. Di setiap jalur yang memuat plugins, Claude Code melaporkan plugin sebagai tidak diinstal sampai setiap pengguna [menginstalnya sendiri](https://code.claude.com/docs/id/plugins/org.md#require-plugins-per-repository). ### `extraKnownMarketplaces` Daftarkan marketplaces plugin tambahan berdasarkan nama, sehingga orang yang membuka repositori, atau semua orang yang managed settings jangkau, mendapatkan marketplace tanpa menambahkannya sendiri. Claude Code mendaftarkan setiap marketplace yang belum diketahuinya. Apakah plugin yang [`enabledPlugins`](#enabledplugins) namai darinya menginstal tergantung pada sumber plugin dan file mana yang mengaktifkannya; entri itu memiliki aturannya. * **Scope**: [`Any file`](#scopes). Claude Code menghormati entri dalam `.claude/settings.json` atau `.claude/settings.local.json` repositori hanya setelah Anda menerima dialog kepercayaan workspace untuk folder itu; dalam folder yang belum Anda percayai, termasuk run `-p` di sana, itu mengabaikannya tanpa pesan. * **Type**: object mapping nama marketplace ke objek dengan objek `source` dan Boolean `autoUpdate` opsional * **Default**: unset Contoh ini mendaftarkan marketplace GitHub dan marketplace dari URL git yang dihosting sendiri: ```json settings.json theme={null} { "extraKnownMarketplaces": { "acme-tools": { "source": { "source": "github", "repo": "acme-corp/claude-plugins" } }, "security-plugins": { "source": { "source": "git", "url": "https://git.example.com/security/plugins.git" } } } } ``` [Apa yang berjalan sebelum Anda mempercayai folder](https://code.claude.com/docs/id/permissions.md#what-runs-before-you-trust-a-folder) membandingkan gerbang kepercayaan dengan konten lain yang dapat disediakan repositori. Anda juga dapat menulis kunci ini sebagai `additionalMarketplaces`; lihat [Alias kunci Marketplace](#marketplace-key-aliases). Atur `"autoUpdate": true` bersama `source` untuk membuat Claude Code menyegarkan marketplace itu dan memperbarui plugins yang diinstal dalam latar belakang setelah startup. Ketika dihilangkan, `claude-plugins-official` dan sebagian besar marketplace resmi Anthropic lainnya default ke `true`, dan marketplace pihak ketiga default ke `false`. Lihat [Konfigurasi auto-updates](https://code.claude.com/docs/id/plugins/install.md#keep-plugins-updated). Ketika lebih dari satu file pengaturan mendefinisikan entri marketplace di bawah nama yang sama, Claude Code menggunakan entri dari file [prioritas tertinggi](https://code.claude.com/docs/id/settings.md#settings-precedence) secara keseluruhan. Entri itu menggantikan entri prioritas lebih rendah dan tidak mewarisi bidang apa pun, jadi redefinisi tidak dapat menggabungkan `source.headers` kredensial satu file dengan URL yang dikontrol file lain. Sebelum v2.1.228, Claude Code menggabungkan entri nama-sama bidang demi bidang, jadi entri dalam file prioritas lebih tinggi dapat mewarisi bidang yang tidak diaturnya, termasuk `headers` file lain. #### Marketplace source types Objek `source` mengambil salah satu bentuk ini: * **`github`**: repositori GitHub, dengan `repo` * **`git`**: URL git apa pun, dengan `url` * **`url`**: URL langsung ke file `marketplace.json`, dengan `url` dan `headers` opsional dan `headersHelper` untuk akses yang diautentikasi. `headersHelper` menamai perintah yang mencetak header yang nilainya terlalu berumur pendek untuk dicantumkan dalam `headers`, dan memerlukan Claude Code v2.1.238 atau lebih baru * **`file`**: jalur lokal ke file `marketplace.json`, dengan `path` * **`directory`**: jalur filesystem lokal, dengan `path`. Gunakan untuk pengembangan, atau untuk marketplace yang organisasi Anda [terapkan ke setiap mesin](https://code.claude.com/docs/id/plugins/mods/admin.md#install-your-organizations-mods). * **`settings`**: marketplace inline yang dideklarasikan langsung dalam file pengaturan tanpa repositori yang dihosting, dengan `name` dan `plugins` Tipe sumber `git` bekerja dengan layanan hosting git apa pun, termasuk GitLab dan Bitbucket yang dihosting sendiri. Claude Code mengkloning repositori dengan autentikasi yang sama yang `git clone` gunakan di mesin itu: pembantu kredensial yang dikonfigurasi atau kunci SSH. Token penyedia seperti `GITHUB_TOKEN` hanya berlaku melalui pembantu kredensial yang membacanya. Lihat [Private repositories](https://code.claude.com/docs/id/plugins/host-marketplace.md#grant-access-to-a-private-marketplace) untuk detail setup. Untuk sumber `github` dan `git`, Claude Code tidak pernah mengunduh konten [Git LFS](https://git-lfs.com) ketika mengkloning repositori marketplace untuk menambahkan atau memperbaruinya. File yang dilacak LFS diperiksa sebagai file pointer, dan output penambahan atau pembaruan melaporkan berapa banyak. Bidang `skipLfs` di dalam objek `source` diterima dan tidak memiliki efek. Sebelum v2.1.274, Claude Code mengunduh konten LFS kecuali Anda mengatur `"skipLfs": true`. Untuk sumber `url`, atur `headersHelper` di dalam objek `source` ketika kredensial dalam `headers` kedaluwarsa dan perintah harus menghasilkan yang baru. Memerlukan Claude Code v2.1.238 atau lebih baru. Untuk apa yang harus dicetak perintah dan di mana Claude Code menjalankannya, lihat [Write the headersHelper command](https://code.claude.com/docs/id/plugins/host-marketplace.md#write-the-headershelper-command), dan untuk kasus di mana Claude Code tidak menjalankannya, lihat [When Claude Code skips a headersHelper command](https://code.claude.com/docs/id/plugins/host-marketplace.md#when-claude-code-skips-a-headershelper-command-or-drops-its-output). Setelah Anda mengatur `headersHelper` pada URL marketplace `https://`, Claude Code menjalankan perintah di dua titik, menggunakan kembali output satu run selama hingga 60 detik: * Sebelum setiap pengambilan `marketplace.json` marketplace itu, termasuk penyegaran nanti. Claude Code mengirim header yang dicetak dengan pengambilan itu. * Sebelum setiap unduhan arsip plugin pada asal URL marketplace, berarti skema, host, dan port yang sama. Claude Code mengirim output dengan unduhan itu, dan tidak ada unduhan lain yang mendapat header. Claude Code mengabaikan `headersHelper` apa pun yang diatur dalam `.claude/settings.json` atau `.claude/settings.local.json` direktori yang Anda tambahkan dengan [`--add-dir`](https://code.claude.com/docs/id/permissions#what-runs-before-you-trust-a-folder), pada sumber `url` dan pada entri plugin inline sama-sama, dan hanya mengirim `headers` tetap yang diatur dalam file itu. [How users accept a headersHelper command](https://code.claude.com/docs/id/plugins/host-marketplace.md#how-users-accept-a-headershelper-command) mencakup file pengaturan lainnya. Plugins yang tercantum dalam sumber `settings` harus mereferensikan sumber eksternal seperti GitHub atau npm, dan `name` harus cocok dengan kunci marketplace. Anda masih mengaktifkan setiap plugin secara terpisah dalam `enabledPlugins`. Contoh ini mendeklarasikan satu plugin inline: ```json settings.json theme={null} { "extraKnownMarketplaces": { "team-tools": { "source": { "source": "settings", "name": "team-tools", "plugins": [ { "name": "code-formatter", "source": { "source": "github", "repo": "acme-corp/code-formatter" } } ] } } } } ``` Entri plugin di bawah `source: 'settings'` yang `source`-nya sendiri adalah [`archive`](https://code.claude.com/docs/id/plugins/marketplace-reference#archive-plugin-source) dapat mengatur `headers` untuk unduhan arsip. Jika nilai yang akan Anda masukkan dalam `headers` berumur pendek, seperti token yang registry Anda cetak atas permintaan, atur perintah `headersHelper` sebagai gantinya. Entri dapat mengatur keduanya. Kedua bidang memerlukan Claude Code v2.1.238 atau lebih baru. Claude Code mengirim `headers` entri, dan apa pun yang dicetak perintah, dengan unduhan arsip plugin itu dan dengan tidak ada unduhan lain. Claude Code menjalankan perintah hanya ketika pengguna [menginstal atau memperbarui plugin itu saja](https://code.claude.com/docs/id/plugins/host-marketplace.md#how-users-accept-a-headershelper-command). Tiga aturan lebih lanjut tergantung pada file mana yang memegang entri: * **`strict`**: tidak seperti entri dalam `marketplace.json` marketplace, entri dalam pengaturan tidak memerlukan `"strict": false`, karena file pengaturan tidak membawa bidang manifest untuk inline. Lihat [Strict mode](https://code.claude.com/docs/id/plugins/marketplace-reference.md#strict-mode). * **Folder trust**: untuk entri dalam `.claude/settings.json` atau `.claude/settings.local.json` proyek, Claude Code menjalankan perintah hanya setelah pengguna juga [mempercayai folder itu](https://code.claude.com/docs/id/permissions.md#what-runs-before-you-trust-a-folder). * **Header filter**: Claude Code menjatuhkan [nama header perutean permintaan dan identitas klien](https://code.claude.com/docs/id/plugins/host-marketplace.md#when-claude-code-skips-a-headershelper-command-or-drops-its-output) dari entri dalam `.claude/settings.json` atau `.claude/settings.local.json` proyek, karena repositori dapat menyediakan file itu. Claude Code menerapkan filter yang sama ke entri katalog dan ke entri dalam pengaturan direktori `--add-dir`, dan tidak ada filter ke entri dalam pengaturan pengguna Anda, file `--settings`, atau managed settings. #### Marketplace key aliases Pada Claude Code v2.1.232 atau lebih baru, Anda dapat menulis `extraKnownMarketplaces` sebagai `additionalMarketplaces` dan `strictKnownMarketplaces` sebagai `allowedMarketplaces`. Claude Code memperlakukan setiap alias sebagai berikut: * Versi sebelumnya mengabaikan alias, jadi pertahankan ejaan kanonik dalam file yang juga dibaca versi lebih lama, seperti file managed settings untuk armada dengan versi Claude Code campuran. * Dalam file pengaturan apa pun yang menerima kunci kanonik, Claude Code membaca alias persis seperti membaca kunci kanonik. * Claude Code dapat menulis ulang `additionalMarketplaces` ke `extraKnownMarketplaces` ketika memperbarui file. * Jika Anda mengatur kedua ejaan dalam satu file, Claude Code menggunakan nilai kanonik dan mengabaikan alias. ### `pluginConfigs` Simpan jawaban non-sensitif yang Anda berikan dialog konfigurasi [`userConfig`](https://code.claude.com/docs/id/plugins/manifest-reference#user-configuration) plugin, dikunci dengan ID plugin. Claude Code menulis kunci ini ke pengaturan pengguna Anda ketika Anda mengisi dialog, jadi Anda tidak perlu mengeditnya dengan tangan. Claude Code menyimpan opsi sensitif dalam Keychain macOS sebagai gantinya, kembali ke `~/.claude/.credentials.json` ketika Keychain menolak penulisan; pada platform tanpa keychain yang didukung, itu menyimpannya dalam `~/.claude/.credentials.json`. * **Scope**: [`User or managed`](#scopes) * **Type**: object mapping ID plugin ke objek dengan bidang `options`, mapping setiap nama opsi ke string, angka, Boolean, atau array string, dan bidang `mcpServers` opsional yang memegang nilai konfigurasi pengguna per-server dalam bentuk yang sama * **Default**: unset Contoh ini menyimpan opsi `api_endpoint` untuk plugin `deployer` dari `acme-tools`: ```json settings.json theme={null} { "pluginConfigs": { "deployer@acme-tools": { "options": { "api_endpoint": "https://api.example.com" } } } } ``` Built-in plugins menyimpan opsi mereka di bawah kunci yang sama dengan sufiks `@builtin`. Misalnya, pengaturan [**Project instructions**](https://code.claude.com/docs/id/memory.md#choose-which-instruction-files-load) yang mengontrol apakah Claude Code membaca file `AGENTS.md` adalah `pluginConfigs["cc-plugin-agents-md@builtin"].options.instructionFiles`. Sebelum v2.1.285, ID plugin tersebut adalah `agents-md@builtin`. Versi yang lebih baru membaca entri di bawah salah satu dari kedua ID tersebut. Claude Code mengabaikan entri proyek dan lokal karena menggantikan nilai ini ke dalam konfigurasi hook plugin, MCP, dan LSP, dan repositori yang dikloning tidak boleh dapat menyediakannya. ### `prependPlugins` Cantumkan managed plugins yang [mods](https://code.claude.com/docs/id/plugins/mods/overview.md)-nya berjalan sebelum setiap mod yang diinstal pengguna, dalam urutan yang tercantum. Ketika Anda mengatur kunci ini dalam managed settings, namai `sec-default@builtin` dalam daftar untuk menjaga guard bawaan. Dalam managed settings, Claude Code melewatkan id yang plugin-nya tidak dihitung sebagai organisasi Anda. Lihat [Install your organization's mods and set the order](https://code.claude.com/docs/id/plugins/mods/admin.md#install-your-organizations-mods) untuk kondisi tersebut dan bagaimana dua kunci pengurutan bekerja bersama. * **Scope**: [`User or managed`](#scopes). Claude Code membaca kunci dari managed settings. Claude Code membaca kunci dari user settings hanya pada mesin tanpa pengaturan terkelola, dalam sesi yang kredensialnya bukan `/login` Team atau Enterprise. Claude Code mengabaikan kunci dalam pengaturan proyek dan lokal dan dalam file `--settings`. * **Type**: array string `plugin-name@marketplace-name` * **Default**: unset ```json managed-settings.json theme={null} { "extraKnownMarketplaces": { "acme-tools": { "source": { "source": "directory", "path": "/opt/acme/claude-plugins" } } }, "enabledPlugins": { "acme-guard@acme-tools": true }, "prependPlugins": ["acme-guard@acme-tools", "sec-default@builtin"] } ``` ### `appendPlugins` Cantumkan managed plugins yang [mods](https://code.claude.com/docs/id/plugins/mods/overview.md)-nya berjalan setelah setiap mod yang diinstal pengguna, dalam urutan yang tercantum. Id yang tercantum dalam `prependPlugins` dan `appendPlugins` adalah prepended. Dalam managed settings, Claude Code melewatkan id yang plugin-nya tidak [dihitung sebagai organisasi Anda](https://code.claude.com/docs/id/plugins/mods/admin.md#install-your-organizations-mods). * **Scope**: [`User or managed`](#scopes). Claude Code membaca kunci dari managed settings. Claude Code membaca kunci dari user settings hanya pada mesin tanpa pengaturan terkelola, dalam sesi yang kredensialnya bukan `/login` Team atau Enterprise. Claude Code mengabaikan kunci dalam pengaturan proyek dan lokal dan dalam file `--settings`. * **Type**: array string `plugin-name@marketplace-name` * **Default**: unset ```json managed-settings.json theme={null} { "extraKnownMarketplaces": { "acme-tools": { "source": { "source": "directory", "path": "/opt/acme/claude-plugins" } } }, "enabledPlugins": { "acme-audit@acme-tools": true }, "appendPlugins": ["acme-audit@acme-tools"] } ``` ## MCP Kontrol server MCP mana yang Claude Code terhubung dan mana yang diizinkan organisasi. Lihat [Terhubung ke alat eksternal dengan MCP](https://code.claude.com/docs/id/mcp.md) dan [Konfigurasi MCP yang dikelola](https://code.claude.com/docs/id/managed-mcp.md). ### `allowAllClaudeAiMcps` Muat [konektor claude.ai](https://code.claude.com/docs/id/mcp.md#use-mcp-servers-from-claude-ai) yang Claude Code ambil sendiri bersama dengan `managed-mcp.json` yang diterapkan. Tanpa kunci ini, `managed-mcp.json` mengambil kontrol eksklusif atas server MCP dan menekan konektor tersebut. * **Scope**: [`Managed`](#scopes). Pengguna tidak dapat mengaktifkan kembali konektor yang kontrol eksklusif tekan. * **Type**: Boolean * `true`: Claude Code memuat konektor claude.ai bersama dengan `managed-mcp.json` yang diterapkan * `false`: `managed-mcp.json` yang diterapkan mengambil kontrol eksklusif atas server MCP dan menekan konektor claude.ai [yang Claude Code ambil sendiri](https://code.claude.com/docs/id/mcp.md#how-connectors-reach-claude-code) * **Default**: `false`, jadi `managed-mcp.json` yang diterapkan menekan konektor claude.ai yang Claude Code ambil sendiri ```json managed-settings.json theme={null} { "allowAllClaudeAiMcps": true } ``` [`allowedMcpServers`](#allowedmcpservers) dan [`deniedMcpServers`](#deniedmcpservers) masih berlaku untuk konektor yang kunci ini muat. Konektor yang dikirimkan ke [sesi cloud](https://code.claude.com/docs/id/claude-code-on-the-web.md) yang hostnya membawa `managed-mcp.json`, seperti runner yang di-host sendiri, tetap ditekan. Lihat [Izinkan konektor claude.ai bersama dengan set yang dikelola](https://code.claude.com/docs/id/managed-mcp.md#allow-claude-ai-connectors-alongside-the-managed-set). ### `allowClaudeInChromeWithManagedMcp` Biarkan server [Claude di Chrome](https://code.claude.com/docs/id/chrome.md) bawaan berjalan bersama dengan `managed-mcp.json` yang diterapkan. Tanpa kunci ini, `managed-mcp.json` yang diterapkan memblokir Claude di Chrome dalam sesi terminal. Memerlukan Claude Code v2.1.282 atau lebih baru. * **Scope**: [`Managed`](#scopes), dari pengaturan yang dikelola perangkat itu sendiri saja: plist yang diterapkan MDM atau kunci registri HKLM, atau file `managed-settings.json` sistem. Claude Code mengabaikannya dalam pengaturan yang dikelola server, dalam registri HKCU yang dapat ditulis pengguna, dan dalam pengaturan pengguna atau proyek. * **Type**: Boolean * `true`: server Claude di Chrome bawaan dapat berjalan bersama dengan `managed-mcp.json` yang diterapkan * `false`: `managed-mcp.json` yang diterapkan memblokir Claude di Chrome dalam sesi terminal * **Default**: `false`, jadi `managed-mcp.json` yang diterapkan memblokir Claude di Chrome dalam sesi terminal ```json managed-settings.json theme={null} { "allowClaudeInChromeWithManagedMcp": true } ``` Entri [`deniedMcpServers`](#deniedmcpservers) untuk `claude-in-chrome` masih memblokir server dengan kunci ini aktif. Lihat [Izinkan Claude di Chrome bersama dengan set yang dikelola](https://code.claude.com/docs/id/managed-mcp.md#allow-claude-in-chrome-alongside-the-managed-set). ### `allowedMcpServers` Daftar putih server MCP yang dapat ditambahkan orang. Claude Code memblokir server apa pun yang tidak cocok dengan entri di mana pun didefinisikan, termasuk server plugin, server yang dilewatkan dengan `--mcp-config`, dan server dari claude.ai. Server bawaan seperti Claude di Chrome, server `ide` yang Claude Code terhubung dalam [VS Code](https://code.claude.com/docs/id/vs-code.md#the-built-in-ide-mcp-server) atau [JetBrains](https://code.claude.com/docs/id/jetbrains.md#the-built-in-ide-mcp-server) IDE yang sedang berjalan, dan server yang CLI sendiri konfigurasi dikecualikan dari daftar putih, dan daftar hitam masih berlaku untuk mereka. Pada Claude Code v2.1.268 atau lebih baru, alat Slack sesi [Claude Tag](https://code.claude.com/docs/id/claude-tag.md) juga dikecualikan dari daftar putih, dan daftar hitam masih berlaku untuk mereka. Server `type: "sdk"` dalam proses dikecualikan dari kedua daftar; [aplikasi yang memulai sesi](https://code.claude.com/docs/id/mcp.md#how-connectors-reach-claude-code) mendaftarkan mereka. Server yang disediakan organisasi Anda juga dikecualikan dari allowlist, dan denylist masih berlaku untuk mereka. Pengecualian mencakup setiap entri [`managedMcpServers`](#managedmcpservers), dan entri [`managed-mcp.json`](https://code.claude.com/docs/id/managed-mcp#exclusive-control-with-managed-mcp-json) apa pun yang nilainya [tidak menggunakan ekspansi `${VAR}` di luar `env`](https://code.claude.com/docs/id/managed-mcp#how-allowlists-and-denylists-apply-to-the-managed-set). Lihat [Bagaimana server dievaluasi](https://code.claude.com/docs/id/managed-mcp.md#how-a-server-is-evaluated) untuk urutan pemeriksaan lengkap. Sebelum v2.1.259, server dari `managed-mcp.json` juga harus cocok. * **Scope**: [`Any file`](#scopes). Entri dari setiap file bergabung menjadi satu daftar putih kecuali [`allowManagedMcpServersOnly`](#allowmanagedmcpserversonly) diatur. Terapkan di pengaturan yang dikelola untuk memberlakukannya. * **Type**: array objek, masing-masing dengan tepat satu kunci. Gunakan `serverName`, string terbatas pada huruf, angka, tanda hubung, dan garis bawah; `serverCommand`, array perintah dan argumennya yang dicocokkan persis; atau `serverUrl`, pola URL dengan wildcard `*` * **Default**: tidak diatur, jadi setiap server diizinkan; array kosong memblokir setiap server yang ditambahkan pengguna Contoh ini hanya mengizinkan server stdio yang perintah `npx` yang terdaftar mulai: ```json settings.json theme={null} { "allowedMcpServers": [ { "serverCommand": ["npx", "-y", "@modelcontextprotocol/server-filesystem"] } ] } ``` Entri [`deniedMcpServers`](#deniedmcpservers) memiliki prioritas, jadi server di kedua daftar diblokir. Setelah daftar berisi entri `serverCommand` apa pun, server stdio harus cocok dengan entri `serverCommand`, dan setelah berisi entri `serverUrl` apa pun, server jarak jauh harus cocok dengan entri `serverUrl`: kecocokan `serverName` tidak lagi mengakui jenis server itu. Lihat [Kontrol berbasis kebijakan dengan daftar putih dan daftar hitam](https://code.claude.com/docs/id/managed-mcp.md#policy-based-control-with-allowlists-and-denylists). ### `allowManagedMcpServersOnly` Buat daftar putih yang dikelola satu-satunya yang berlaku. Claude Code kemudian membaca [`allowedMcpServers`](#allowedmcpservers) dari pengaturan yang dikelola saja dan mengabaikan daftar putih di pengaturan pengguna, proyek, dan lokal; [`deniedMcpServers`](#deniedmcpservers) masih bergabung dari setiap cakupan pengaturan, jadi pengguna masih dapat memblokir server untuk diri mereka sendiri. Administrator menetapkannya sehingga pengaturan pengguna mereka sendiri tidak dapat memperluas apa yang daftar putih yang dikelola izinkan. * **Scope**: [`Managed`](#scopes) * **Type**: Boolean * `true`: Claude Code membaca `allowedMcpServers` dari pengaturan yang dikelola saja dan mengabaikan daftar putih di pengaturan pengguna, proyek, dan lokal * `false`: daftar putih dari setiap cakupan pengaturan bergabung * **Default**: `false`, jadi daftar putih dari setiap cakupan pengaturan bergabung Contoh ini mengunci daftar putih ke pengaturan yang dikelola dan hanya mengizinkan server bernama `github`: ```json managed-settings.json theme={null} { "allowManagedMcpServersOnly": true, "allowedMcpServers": [ { "serverName": "github" } ] } ``` Pengguna masih dapat menambahkan server MCP mereka sendiri; hanya server yang cocok dengan daftar putih yang dikelola yang dimuat. Lihat [Batasi daftar putih ke pengaturan yang dikelola saja](https://code.claude.com/docs/id/managed-mcp.md#restrict-the-allowlist-to-managed-settings-only). ### `deniedMcpServers` Blokir server MCP tertentu. Claude Code menolak untuk memuat server yang cocok di mana pun didefinisikan, termasuk server plugin, server yang dilewatkan dengan `--mcp-config`, server dari `managed-mcp.json`, server dari [`managedMcpServers`](#managedmcpservers), dan konektor claude.ai [yang diambilnya sendiri](https://code.claude.com/docs/id/mcp.md#how-connectors-reach-claude-code). Server `type: "sdk"` dalam proses dikecualikan; aplikasi yang memulai sesi mendaftarkan mereka. * **Scope**: [`Any file`](#scopes). Entri dari setiap file bergabung menjadi satu daftar hitam, dan [`allowManagedMcpServersOnly`](#allowmanagedmcpserversonly) tidak mengubah itu. Terapkan di pengaturan yang dikelola untuk memberlakukannya. * **Type**: array objek, masing-masing dengan tepat satu kunci: `serverName`, string, jadi nama tampilan konektor claude.ai seperti `"claude.ai Slack"` berfungsi; `serverCommand`, array perintah dan argumennya yang cocok persis; atau `serverUrl`, pola URL dengan wildcard `*` * **Default**: tidak diatur, jadi tidak ada server yang diblokir; array kosong juga tidak memblokir apa pun ```json settings.json theme={null} { "deniedMcpServers": [ { "serverName": "filesystem" } ] } ``` Daftar hitam memiliki prioritas atas [`allowedMcpServers`](#allowedmcpservers), jadi server di kedua daftar diblokir. Lihat [Kontrol berbasis kebijakan dengan daftar putih dan daftar hitam](https://code.claude.com/docs/id/managed-mcp.md#policy-based-control-with-allowlists-and-denylists). ### `disableClaudeAiConnectors` Matikan [konektor MCP claude.ai](https://code.claude.com/docs/id/mcp.md#use-mcp-servers-from-claude-ai) [yang Claude Code ambil sendiri](https://code.claude.com/docs/id/mcp.md#how-connectors-reach-claude-code), sehingga tidak mengambil atau menghubungkan mereka. `true` di file pengaturan apa pun berlaku: file `.claude/settings.json` proyek yang diperiksa dapat menolak repositori dari konektor tersebut, tetapi `false` tingkat proyek tidak dapat mengganti `true` tingkat pengguna atau yang dikelola. * **Scope**: [`Any file`](#scopes) * **Type**: Boolean * `true`: Claude Code tidak mengambil atau menghubungkan konektor tersebut * `false`: sama dengan tidak diatur; Claude Code mengambil konektor Anda kecuali file pengaturan lain atau `ENABLE_CLAUDEAI_MCP_SERVERS` mematikannya * **Default**: `false`, jadi Claude Code mengambil konektor Anda * **Per-session overrides**: [`ENABLE_CLAUDEAI_MCP_SERVERS`](https://code.claude.com/docs/id/env-vars) diatur ke `false` mematikan konektor untuk satu sesi; mana pun dari keduanya yang mematikannya, yang lain tidak dapat menghidupkannya kembali ```json settings.json theme={null} { "disableClaudeAiConnectors": true } ``` Server yang Anda lewatkan secara eksplisit dengan `--mcp-config` tidak terpengaruh. Untuk memblokir konektor individual alih-alih semuanya, gunakan [`deniedMcpServers`](#deniedmcpservers). Lihat [Nonaktifkan konektor claude.ai](https://code.claude.com/docs/id/mcp.md#disable-claude-ai-connectors). ### `disabledMcpjsonServers` Tolak server tertentu yang didefinisikan dalam file `.mcp.json` proyek sehingga Claude Code tidak pernah menghubungkannya atau meminta Anda menyetujuinya. Penolakan di file pengaturan apa pun berlaku, termasuk `.claude/settings.json` proyek yang diperiksa ke dalam repositori. * **Scope**: [`Any file`](#scopes) * **Type**: array string, nama server seperti yang muncul di `.mcp.json` * **Default**: tidak diatur ```json settings.json theme={null} { "disabledMcpjsonServers": ["filesystem"] } ``` Claude Code menulis kunci ini ke `.claude/settings.local.json` ketika Anda menolak server di dialog persetujuan. `claude mcp get ` menampilkan server yang ditolak sebagai `✘ Rejected (see disabledMcpjsonServers in settings)`. Penolakan memiliki prioritas atas [`enabledMcpjsonServers`](#enabledmcpjsonservers) dan [`enableAllProjectMcpServers`](#enableallprojectmcpservers). ### `enableAllProjectMcpServers` Setujui setiap server MCP yang didefinisikan dalam file `.mcp.json` proyek tanpa prompt. Claude Code menulis kunci ini ke `.claude/settings.local.json` ketika Anda memilih untuk menyetujui semua server di dialog persetujuan. * **Scope**: [`Any file`](#scopes). Di folder yang dialog kepercayaan Anda belum terima, Claude Code menghormatinya dari pengaturan pengguna, pengaturan yang dikelola, dan `--settings` dan mengabaikannya di file proyek bersama, baik dalam sesi maupun untuk `claude mcp list` dan `claude mcp get`; [Persetujuan server proyek dan kepercayaan ruang kerja](https://code.claude.com/docs/id/mcp.md#project-server-approvals-and-workspace-trust) mengatakan kapan `.claude/settings.local.json` yang tidak dilacak dihitung juga. * **Type**: Boolean * `true`: Claude Code menyetujui setiap server MCP yang didefinisikan dalam file `.mcp.json` proyek tanpa prompt * `false`: Claude Code meminta Anda menyetujui setiap server. Di folder yang dipercaya, `false` di file prioritas lebih tinggi mengganti `true` di file prioritas lebih rendah; di folder yang belum Anda percayai, `true` di file yang dihormati apa pun sudah cukup * **Default**: tidak diatur, jadi Claude Code meminta Anda menyetujui setiap server ```json settings.json theme={null} { "enableAllProjectMcpServers": true } ``` Entri [`disabledMcpjsonServers`](#disabledmcpjsonservers) masih menolak server. ### `enabledMcpjsonServers` Setujui server tertentu yang didefinisikan dalam file `.mcp.json` proyek sehingga Claude Code menghubungkannya tanpa bertanya. Claude Code menulis kunci ini ke `.claude/settings.local.json` ketika Anda menyetujui server di dialog persetujuan. * **Scope**: [`Any file`](#scopes). Di folder yang dialog kepercayaan Anda belum terima, Claude Code menghormatinya dari pengaturan pengguna, pengaturan yang dikelola, dan `--settings` dan mengabaikannya di file proyek bersama, baik dalam sesi maupun untuk `claude mcp list` dan `claude mcp get`; [Persetujuan server proyek dan kepercayaan ruang kerja](https://code.claude.com/docs/id/mcp.md#project-server-approvals-and-workspace-trust) mengatakan kapan `.claude/settings.local.json` yang tidak dilacak dihitung juga. * **Type**: array string, nama server seperti yang muncul di `.mcp.json` * **Default**: tidak diatur Contoh ini menyetujui server `memory` dan `github` dari `.mcp.json` proyek: ```json settings.json theme={null} { "enabledMcpjsonServers": ["memory", "github"] } ``` Entri [`disabledMcpjsonServers`](#disabledmcpjsonservers) masih menolak server. ### `managedMcpServers` Sediakan server MCP jarak jauh untuk setiap pengguna dari pengaturan yang dikelola. Pengguna menyimpan server yang mereka tambahkan sendiri dan tidak dapat mengedit atau menghapus yang Anda sediakan. Memerlukan Claude Code v2.1.259 atau lebih baru. * **Scope**: [`Managed`](#scopes). Claude Code menghapus kunci dengan peringatan di pengaturan pengguna, proyek, dan lokal, dan tidak membacanya di tab Code aplikasi Claude Desktop pada penerapan pihak ketiga atau di sesi Cowork aplikasi, di mana Claude Desktop menyediakan dan mengunci server MCP sesi tersebut sendiri. * **Type**: objek yang dikunci berdasarkan nama server. Setiap entri memiliki bentuk `.mcp.json` untuk server `http` atau `sse`: `url` `https://` yang diperlukan, dan secara opsional `headers`, `oauth`, dan opsi HTTP dan SSE lainnya. Claude Code menghapus entri yang gagal validasi, dan [Apa yang dapat berisi entri](https://code.claude.com/docs/id/managed-mcp.md#what-an-entry-can-contain) mencantumkan kondisinya * **Default**: tidak diatur, jadi pengaturan yang dikelola tidak menyediakan server Contoh ini menyediakan satu server HTTP bernama `search`: ```json managed-settings.json theme={null} { "managedMcpServers": { "search": { "type": "http", "url": "https://search.example.com/mcp" } } } ``` Untuk prioritas, bagaimana server yang disediakan bergabung dengan `managed-mcp.json` dan daftar izin dan tolak, dan apa yang dilihat pengguna, lihat [Sediakan server melalui pengaturan yang dikelola](https://code.claude.com/docs/id/managed-mcp.md#provide-servers-through-managed-settings). ## Agents, sessions, dan worktrees Atur agent default, kontrol rekan kerja dan pesan lintas-sesi, dan konfigurasi worktrees. Lihat [Subagents](https://code.claude.com/docs/id/sub-agents.md) dan [Worktrees](https://code.claude.com/docs/id/worktrees.md). ### `agent` Jalankan thread utama sebagai [subagent](https://code.claude.com/docs/id/sub-agents.md#invoke-subagents-explicitly) bernama, sehingga Claude Code menerapkan system prompt, pembatasan tool, dan model subagent tersebut ke sesi Anda. Kunci yang sama menetapkan agent default untuk sesi yang Anda dispatch dari `claude agents`. * **Scope**: [`Any file`](#scopes) * **Type**: string, nama agent bawaan atau kustom * **Default**: unset, sehingga thread utama berjalan sebagai agent default Claude Code * **Per-session overrides**: `--agent` diutamakan daripada kunci ini untuk satu sesi ```json settings.json theme={null} { "agent": "code-reviewer" } ``` `settings.json` plugin sendiri juga dapat menyediakan kunci ini; lihat [Ship default settings with your plugin](https://code.claude.com/docs/id/plugins/components.md#default-settings). ### `crossSessionInbound` Pilih apa yang dilakukan sesi ini dengan [pesan yang tiba dari sesi Claude Code lain Anda](https://code.claude.com/docs/id/cross-session-messaging.md#control-inbound-messages). Ketika tidak ada nilai yang berlaku, Claude Code memutuskan per pesan dari kelas permission-mode kedua sesi. Memerlukan Claude Code v2.1.224 atau lebih baru. * **Scope**: [`Any file`](#scopes). Nilai proyek atau lokal hanya berlaku ketika lebih ketat daripada nilai managed settings, flag `--settings`, atau user settings yang diberikan. * **Type**: string, salah satu dari: * `"accept"`: Claude Code mengirimkan pesan ke Claude * `"hold"`: Claude Code menampilkan pemberitahuan untuk pesan tanpa mengirimkannya * `"refuse"`: Claude Code menghapus pesan * **Default**: unset, sehingga Claude Code memutuskan per pesan ```json settings.json theme={null} { "crossSessionInbound": "hold" } ``` Claude Code membaca managed settings terlebih dahulu, kemudian flag `--settings`, kemudian user settings, dan menerapkan nilai pertama yang ditemukan. `refuse` lebih ketat daripada `hold`, dan `hold` lebih ketat daripada `accept`. Ketika tidak ada sumber terpercaya yang menetapkan nilai, `hold` atau `refuse` dari proyek atau lokal masih berlaku, menggantikan default per-pesan. Dalam sesi dengan cross-session messaging, kunci ini muncul di `/config` sebagai **Messages from your other sessions**, yang menulisnya ke user settings; baris memerlukan Claude Code v2.1.232 atau lebih baru, dan Claude Code menyembunyikannya saat flag `--settings` atau managed settings menetapkan kunci. Claude Code [warns](https://code.claude.com/docs/id/errors.md#crosssessioninbound-must-be-one-of-accept-hold-refuse) ketika Anda menetapkan nilai yang tidak dikenalinya. Sementara nilai itu ada di file user, project, local, atau `--settings`, Claude Code menahan pesan inbound, bahkan ketika sumber yang memiliki prioritas lebih tinggi menetapkan `accept`. `refuse` yang ditetapkan sumber lain masih berlaku. Perbaiki atau hapus nilai untuk menghapus hold. Ketika nilai yang tidak dikenali ada di [managed settings](https://code.claude.com/docs/id/managed-settings.md), Claude Code malah memperlakukannya sebagai `refuse` sampai administrator memperbaikinya. Sebelum v2.1.248, Claude Code mengabaikan nilai yang tidak dikenali tanpa peringatan. ### `disableAgentView` Matikan [background agents dan agent view](https://code.claude.com/docs/id/agent-view.md): `claude agents`, `--bg`, `/background`, dan supervisor on-demand. Atur di [managed settings](https://code.claude.com/docs/id/managed-settings.md) untuk memberlakukannya untuk organisasi. * **Scope**: [`Any file`](#scopes) * **Type**: Boolean * `true`: Claude Code mematikan `claude agents`, `--bg`, `/background`, dan supervisor on-demand * `false`: agent view tersedia * **Default**: unset, sehingga agent view tersedia * **Per-session overrides**: [`CLAUDE_CODE_DISABLE_AGENT_VIEW`](https://code.claude.com/docs/id/env-vars) mematikan agent view untuk satu sesi; mana pun dari keduanya yang mematikannya, yang lain tidak dapat menghidupkannya kembali ```json settings.json theme={null} { "disableAgentView": true } ``` ### `isolatePeerMachines` Memerlukan persetujuan eksplisit Anda sebelum `SendMessage` Claude mencapai salah satu sesi Anda di luar mesin ini; lihat [Require approval for cross-machine messages](https://code.claude.com/docs/id/cross-session-messaging.md#require-approval-for-cross-machine-messages). Dialog persetujuan muncul bahkan dalam [`bypassPermissions` mode](https://code.claude.com/docs/id/permission-modes#skip-all-checks-with-bypasspermissions-mode). * **Scope**: [`Any file`](#scopes). `true` dari cakupan apa pun berlaku, sehingga file proyek yang di-commit dapat menghidupkan persyaratan tetapi tidak mematikannya. * **Type**: Boolean * `true`: Claude Code meminta persetujuan Anda sebelum `SendMessage` Claude mencapai salah satu sesi Anda di luar mesin ini * `false`: pesan lintas-mesin tidak meminta persetujuan * **Default**: unset, sehingga pesan lintas-mesin tidak meminta persetujuan ```json settings.json theme={null} { "isolatePeerMachines": true } ``` Persetujuan `SendMessage` lintas-mesin memerlukan Claude Code v2.1.224 atau lebih baru. ### `processWrapper` Di macOS dan Linux, tempatkan perintah launcher korporat di depan [background processes yang dimulai Claude Code](https://code.claude.com/docs/id/corporate-launcher.md#what-the-launcher-covers). Claude Code menjalankan launcher dengan baris perintahnya sendiri ditambahkan, sehingga launcher harus exec ke Claude Code; lihat [Run Claude Code behind a corporate launcher](https://code.claude.com/docs/id/corporate-launcher.md) untuk kontrak launcher. Memerlukan Claude Code v2.1.210 atau lebih baru. * **Scope**: [`User or managed`](#scopes) * **Type**: string, perintah launcher sebagai awalan argv, seperti jalur absolut dengan argumen opsional * **Default**: unset, sehingga background processes dimulai tanpa wrapper * **Per-session overrides**: [`CLAUDE_CODE_PROCESS_WRAPPER`](https://code.claude.com/docs/id/env-vars) diutamakan daripada kunci ini untuk satu sesi ```json settings.json theme={null} { "processWrapper": "/opt/corp/launcher --profile claude" } ``` Claude Code mengabaikan launcher di Windows dan memulai setiap proses tanpa wrapper. Memerlukan Claude Code v2.1.210 atau lebih baru. ### `teammateMode` Pilih di mana Claude Code menampilkan rekan kerja [tim agent](https://code.claude.com/docs/id/agent-teams.md): di dalam pane terminal utama Anda, atau di pane terpisah ketika terminal Anda mendukungnya. Lihat [Choose a display mode](https://code.claude.com/docs/id/agent-teams.md#choose-a-display-mode). * **Scope**: [`Any file`](#scopes). Claude Code juga membaca nilai yang ditinggalkan di `~/.claude.json` oleh versi yang lebih lama. * **Type**: string, salah satu dari: * `"in-process"`: rekan kerja berjalan di dalam pane terminal utama Anda * `"auto"`: pane terpisah ketika Anda menjalankan di dalam tmux, atau di dalam iTerm2 dengan `it2` di `PATH` Anda atau tmux terinstal; in-process sebaliknya * `"tmux"`: pane terpisah menggunakan tmux atau iTerm2, terdeteksi dari terminal Anda * `"iterm2"`: pane terpisah native iTerm2 melalui CLI `it2` * **Default**: `"in-process"` * **Per-session overrides**: `--teammate-mode` diutamakan daripada kunci ini untuk satu sesi ```json settings.json theme={null} { "teammateMode": "auto" } ``` ### `worktree` Konfigurasi cara Claude Code membuat dan mengelola [git worktrees](https://code.claude.com/docs/id/worktrees.md) untuk `--worktree`, tool `EnterWorktree`, dan subagent terisolasi serta background sessions. * **Scope**: [`Any file`](#scopes) * **Type**: object dengan `baseRef`, `symlinkDirectories`, `sparsePaths`, dan `bgIsolation` * **Default**: unset Contoh ini membuat branch worktree baru dari `HEAD` Anda saat ini dan membuat symlink `node_modules` ke masing-masing: ```json settings.json theme={null} { "worktree": { "baseRef": "head", "symlinkDirectories": ["node_modules"] } } ``` Untuk menyalin file yang diabaikan gitignore seperti `.env` ke worktree baru, tambahkan file [`.worktreeinclude`](https://code.claude.com/docs/id/worktrees#copy-gitignored-files-into-worktrees) ke root proyek Anda, alih-alih menggunakan pengaturan. ### `worktree.baseRef` Pilih ref mana yang menjadi asal branch worktree baru. `"fresh"` membuat branch dari `origin/` untuk pohon bersih yang cocok dengan remote; `"head"` membuat branch dari `HEAD` lokal Anda saat ini, sehingga commit yang belum di-push dan state feature-branch ada di worktree. * **Scope**: [`Any file`](#scopes) * **Type**: string, salah satu dari: * `"fresh"`: worktree baru membuat branch dari `origin/` * `"head"`: worktree baru membuat branch dari `HEAD` lokal Anda saat ini, termasuk commit yang belum di-push * **Default**: `"fresh"` ```json settings.json theme={null} { "worktree": { "baseRef": "head" } } ``` Di dalam linked worktree, `"head"` merujuk ke `HEAD` worktree itu, bukan milik checkout utama. ### `worktree.symlinkDirectories` Buat symlink direktori dari repositori utama ke setiap worktree sehingga Anda tidak menduplikasi direktori besar di disk. * **Scope**: [`Any file`](#scopes) * **Type**: array of strings, jalur direktori relatif terhadap root repositori * **Default**: unset, sehingga Claude Code tidak membuat symlink direktori apa pun Contoh ini membuat symlink `node_modules` dan `.cache` dari repositori utama ke setiap worktree baru: ```json settings.json theme={null} { "worktree": { "symlinkDirectories": ["node_modules", ".cache"] } } ``` ### `worktree.sparsePaths` Lakukan checkout hanya untuk direktori yang terdaftar di setiap worktree melalui git sparse-checkout. Claude Code menulis hanya direktori tersebut ditambah file tingkat root ke disk, yang lebih cepat di monorepo besar; lihat [Check out only the directories you need](https://code.claude.com/docs/id/large-codebases.md#check-out-only-the-directories-you-need). * **Scope**: [`Any file`](#scopes) * **Type**: array of strings, jalur direktori relatif terhadap root repositori * **Default**: unset, sehingga setiap worktree melakukan checkout seluruh pohon Contoh ini melakukan checkout hanya untuk `packages/my-app` dan `shared/utils`, ditambah file tingkat root, di setiap worktree: ```json settings.json theme={null} { "worktree": { "sparsePaths": ["packages/my-app", "shared/utils"] } } ``` Selama sparse worktree ada, git mengaktifkan `extensions.worktreeConfig` di `.git/config` bersama milik repositori. ### `worktree.bgIsolation` Pilih cara [background sessions](https://code.claude.com/docs/id/agent-view.md#how-file-edits-are-isolated) mengisolasi pengeditan file mereka. Jika Anda memindahkan sesi ke latar belakang dengan `←` atau `/background`, sesi tersebut mengedit file di tempat apa pun nilai kunci ini. Dengan `"worktree"`, Claude Code memblokir `Edit` dan `Write` di checkout utama sampai sesi memanggil `EnterWorktree`; dengan `"none"`, background jobs mengedit working copy secara langsung. Atur `"none"` untuk repositori di mana git worktrees tidak praktis. * **Scope**: [`Any file`](#scopes) * **Type**: string, salah satu dari: * `"worktree"`: Claude Code memblokir `Edit` dan `Write` di checkout utama sampai sesi memanggil `EnterWorktree` * `"none"`: background jobs mengedit working copy secara langsung * **Default**: `"worktree"` ```json settings.json theme={null} { "worktree": { "bgIsolation": "none" } } ``` Di luar repositori git, [`WorktreeCreate` hook](https://code.claude.com/docs/id/worktrees#non-git-version-control) yang gagal melepaskan blok sehingga sesi dapat mengedit direktori kerja di tempat. ### `worktree.location` Pilih folder di mesin remote tempat [sesi SSH Desktop](https://code.claude.com/docs/id/desktop.md#choose-where-ssh-session-worktrees-go) membuat worktree mereka, alih-alih `/.claude/worktrees/`. Hanya aplikasi desktop yang membaca kunci ini: `--worktree`, tool `EnterWorktree`, subagent terisolasi, dan background sessions mengabaikannya. Memerlukan Claude Desktop v1.44121.0 atau lebih baru. * **Scope**: [`User`](#scopes), di `~/.claude/settings.json` pada mesin remote * **Type**: string, jalur absolut atau jalur yang diawali dengan `~/` * **Default**: unset, sehingga worktree ditempatkan di dalam proyek Contoh ini menetapkan folder ke `~/worktrees`: ```json settings.json theme={null} { "worktree": { "location": "~/worktrees" } } ``` **Worktree folder** yang ditetapkan pada koneksi SSH di Desktop diutamakan. Jika organisasi Anda membatasi folder yang boleh digunakan sesi, Desktop menyimpan worktree di dalam proyek. ## Remote, desktop, dan notifikasi Konfigurasi Remote Control, lingkungan cloud, aplikasi desktop, dan notifikasi yang Claude Code kirimkan ketika membutuhkan Anda. Lihat [Remote Control](https://code.claude.com/docs/id/remote-control.md). ### `agentPushNotifEnabled` Izinkan Claude mengirimkan notifikasi push ke ponsel Anda ketika Claude memutuskan bahwa notifikasi tersebut layak dikirim, misalnya ketika tugas yang panjang selesai. Claude dapat mengirimkannya saat [Remote Control](https://code.claude.com/docs/id/remote-control.md) terhubung. Muncul di `/config` sebagai **Push when Claude decides**. Ketika Anda mengubahnya di sana, Claude Code juga menyimpan nilainya ke akun Anda. * **Scope**: [`Any file`](#scopes). Claude Code juga membaca nilai yang ditinggalkan di `~/.claude.json` oleh versi yang lebih lama. * **Type**: Boolean * `true`: Claude dapat mengirimkan notifikasi push ke ponsel Anda ketika Claude memutuskan bahwa notifikasi tersebut layak dikirim * `false`: Claude tidak mengirimkan notifikasi tersebut * **Default**: `false` ```json settings.json theme={null} { "agentPushNotifEnabled": true } ``` Jika Anda menjalankan sesi di bawah server [`claude remote-control`](https://code.claude.com/docs/id/remote-control#start-a-remote-control-session), sesi tersebut mengikuti nilai yang disimpan ke akun Anda, bukan kunci ini. Untuk mengubah nilai tersebut, jalankan `/config` dalam sesi Claude Code di terminal Anda dan aktifkan atau matikan **Push when Claude decides**. Jika toggle sudah menunjukkan nilai yang Anda inginkan, ubah lalu kembalikan agar Claude Code menyimpan nilai tersebut ke akun Anda. Lihat [Mobile push notifications](https://code.claude.com/docs/id/remote-control.md#mobile-push-notifications). ### `awaySummaryEnabled` Tampilkan ringkasan sesi satu baris ketika Anda kembali ke terminal setelah beberapa menit pergi. Atur ke `false`, atau matikan **Session recap** di `/config`, untuk menghentikan ringkasan. * **Scope**: [`Any file`](#scopes) * **Type**: Boolean * `true`: Anda melihat ringkasan sesi satu baris ketika Anda kembali setelah beberapa menit pergi * `false`: Claude Code tidak menampilkan ringkasan * **Default**: unset, jadi ringkasan aktif * **Per-session overrides**: [`CLAUDE_CODE_ENABLE_AWAY_SUMMARY`](https://code.claude.com/docs/id/env-vars) mengambil alih kunci ini untuk satu sesi, dalam kedua arah ```json settings.json theme={null} { "awaySummaryEnabled": false } ``` Claude Code tidak pernah menampilkan ringkasan dalam mode non-interaktif. ### `disableArtifact` > [!WARNING] > > Deprecated, dan diganti oleh [`enableArtifact`](#enableartifact). Claude Code masih menghormati `disableArtifact: true` sebagai setara dengan `enableArtifact: false`, dan mengabaikan `disableArtifact: false`. Gunakan [`enableArtifact`](#enableartifact) sebagai gantinya untuk mematikan alat [Artifact](https://code.claude.com/docs/id/artifacts.md), yang menerbitkan output sesi sebagai halaman web pribadi di claude.ai. Ketika Anda mematikan baris **Artifacts** di `/config`, Claude Code menulis `enableArtifact` ke pengaturan pengguna Anda dan menghapus kunci ini. * **Scope**: [`Any file`](#scopes) * **Type**: Boolean * `true`: Claude Code mematikan alat Artifact untuk setiap sesi yang berlaku file, dan tidak ada file lain yang menghidupkannya kembali * `false`: diabaikan; untuk membiarkan alat tetap aktif, hapus kunci * **Default**: unset, jadi alat mengikuti [availability](https://code.claude.com/docs/id/artifacts.md#availability) akun Anda * **Per-session overrides**: [`CLAUDE_CODE_DISABLE_ARTIFACT`](https://code.claude.com/docs/id/env-vars) diatur ke `1` mematikan alat untuk satu sesi ```json settings.json theme={null} { "disableArtifact": true } ``` [Disable artifacts](https://code.claude.com/docs/id/artifacts.md#disable-artifacts) mencantumkan setiap cara untuk mematikan alat. ### `disableDeepLinkRegistration` Hentikan Claude Code dari mendaftarkan penanganan protokol `claude-cli://` dengan sistem operasi, yang sebaliknya dilakukan setelah Anda mengirimkan prompt pertama dari sesi interaktif. [Deep links](https://code.claude.com/docs/id/deep-links.md) memungkinkan alat eksternal membuka sesi Claude Code dengan prompt yang sudah diisi. Atur ini di lingkungan di mana pendaftaran penanganan protokol dibatasi atau dikelola secara terpisah. * **Scope**: [`Any file`](#scopes) * **Type**: string `"disable"` * **Default**: unset, jadi Claude Code mendaftarkan penanganan ```json settings.json theme={null} { "disableDeepLinkRegistration": "disable" } ``` ### `disableDesktopLocalSessions` Matikan sesi Code yang berjalan di perangkat di [aplikasi desktop](https://code.claude.com/docs/id/desktop.md#local-sessions-on-managed-devices), untuk deployment di mana pengembang harus bekerja di mesin jarak jauh melalui SSH. Dengan kunci diatur ke `true`, pengguna melihat hal berikut di tab Code: * **Pemilih lingkungan**: entri untuk komputer pengguna berwarna abu-abu dan tidak dapat dipilih, dengan tooltip **Disabled by your organization**. Di Windows entri WSL berwarna abu-abu dengan cara yang sama, meskipun apakah sesi WSL berjalan di perangkat terkelola sama sekali [diatur secara terpisah](https://code.claude.com/docs/id/admin-setup.md#wsl-sessions-in-claude-code-desktop). * **Sesi baru**: default ke [koneksi SSH](https://code.claude.com/docs/id/desktop.md#ssh-sessions) pertama jika ada yang dikonfigurasi * **Sesi di perangkat**: aplikasi menolak untuk memulai atau melanjutkan sesi di perangkat, termasuk koneksi SSH kembali ke mesin yang sama * **Sesi SSH ke host lain dan sesi cloud**: tidak terpengaruh Aplikasi desktop membaca kunci ini; CLI terminal mengabaikannya. Memerlukan Claude Desktop v1.37937.0 atau lebih baru. * **Scope**: [`Managed`](#scopes). Secara default, aplikasi desktop membaca kunci dari [satu sumber terkelola](https://code.claude.com/docs/id/managed-settings.md#how-claude-code-combines-managed-sources). * **Type**: Boolean; hanya Boolean JSON `true` yang berlaku * `true`: aplikasi desktop tidak menawarkan sesi Code di perangkat; sesi lokal yang ada tetap terdaftar tetapi tidak dapat dilanjutkan * `false`: sesi lokal tetap tersedia * **Default**: unset, jadi sesi lokal tersedia ```json managed-settings.json theme={null} { "disableDesktopLocalSessions": true } ``` Aplikasi desktop mengabaikan nilai lainnya, dan nilai yang bukan Boolean, seperti string `"true"` atau `1`, juga mencatat peringatan. Pasangkan dengan [`sshConfigs`](#sshconfigs) sehingga pengguna mendarat di koneksi yang berfungsi, dan dengan [`sshHostAllowlist`](#sshhostallowlist) untuk membatasi host mana yang dapat mereka jangkau. Lihat [Local sessions on managed devices](https://code.claude.com/docs/id/desktop.md#local-sessions-on-managed-devices). Claude Desktop memasok sesi Code dengan kebijakan yang berasal dari konfigurasi desktop Anda, misalnya daftar egress allowlist, sandbox sistem file, dan pembatasan MCP dalam deployment pihak ketiga. Claude Code mengabaikan pengaturan induk tersebut kapan pun [sumber admin](https://code.claude.com/docs/id/managed-settings.md#how-claude-code-combines-managed-sources) hadir: pengaturan yang dikelola server, kebijakan MDM atau tingkat OS, atau file pengaturan yang dikelola. Menerapkan kunci ini melalui salah satu dari mereka di perangkat yang tidak memiliki sebelumnya, seperti dalam deployment pihak ketiga, oleh karena itu menghentikan kebijakan yang berasal dari desktop dari penerapan. [Let an embedding host add policy](https://code.claude.com/docs/id/managed-settings.md#let-an-embedding-host-add-policy) mencakup kapan pengaturan induk masih dapat digabung; ini berlaku untuk kunci apa pun yang Anda terapkan dengan cara itu, bukan hanya yang ini. ### `disableRemoteControl` Matikan [Remote Control](https://code.claude.com/docs/id/remote-control.md): Claude Code kemudian menolak `claude remote-control`, flag `--remote-control`, auto-start, dan toggle dalam sesi, dan melaporkan bahwa kebijakan organisasi Anda menonaktifkannya. Tempatkan di [managed settings](https://code.claude.com/docs/id/managed-settings.md) untuk penegakan MDM per perangkat. * **Scope**: [`Any file`](#scopes) * **Type**: Boolean * `true`: Claude Code menolak `claude remote-control`, flag `--remote-control`, auto-start, dan toggle dalam sesi * `false`: Remote Control tetap tersedia * **Default**: `false` ```json settings.json theme={null} { "disableRemoteControl": true } ``` ### `enableArtifact` Matikan tool [Artifact](https://code.claude.com/docs/id/artifacts.md), yang menerbitkan output sesi sebagai halaman web pribadi di claude.ai. Ketika Anda mematikan baris **Artifacts** di `/config`, Claude Code menulis kunci ini ke pengaturan pengguna Anda, jadi Anda biasanya tidak mengeditnya dengan tangan. * **Scope**: [`Any file`](#scopes). Setiap file dapat mematikan alat, dan tidak ada yang dapat menghidupkannya kembali. * **Type**: Boolean * `false`: Claude Code mematikan alat Artifact untuk setiap sesi yang berlaku file * `true`: sama dengan membiarkan kunci unset, karena tidak pernah mengganti `false` dari file lain, dari [`CLAUDE_CODE_DISABLE_ARTIFACT`](https://code.claude.com/docs/id/env-vars), atau dari [admin setting](https://code.claude.com/docs/id/artifacts.md#manage-artifacts-for-your-organization) organisasi Anda * **Default**: unset, jadi alat mengikuti [availability](https://code.claude.com/docs/id/artifacts.md#availability) akun Anda ```json settings.json theme={null} { "enableArtifact": false } ``` Sementara sumber selain pengaturan pengguna Anda sendiri membuat alat tetap mati, Claude Code menyembunyikan baris **Artifacts** di `/config`, karena menghidupkannya di sana tidak akan mengubah apa pun. [Disable artifacts](https://code.claude.com/docs/id/artifacts.md#disable-artifacts) mencantumkan setiap cara untuk mematikan alat. ### `inputNeededNotifEnabled` Dapatkan notifikasi push di ponsel Anda ketika prompt izin atau pertanyaan menunggu input Anda. Claude Code mengirimkan ini hanya saat [Remote Control](https://code.claude.com/docs/id/remote-control.md) terhubung. Muncul di `/config` sebagai **Push when actions required**. * **Scope**: [`Any file`](#scopes). Claude Code juga membaca nilai yang ditinggalkan di `~/.claude.json` oleh versi yang lebih lama. * **Type**: Boolean * `true`: Anda mendapatkan notifikasi push di ponsel Anda ketika prompt izin atau pertanyaan menunggu, saat Remote Control terhubung * `false`: Claude Code tidak mengirimkan notifikasi seperti itu * **Default**: `false` ```json settings.json theme={null} { "inputNeededNotifEnabled": true } ``` Lihat [Mobile push notifications](https://code.claude.com/docs/id/remote-control.md#mobile-push-notifications). ### `preferredNotifChannel` Pilih bagaimana Claude Code memberi tahu Anda ketika tugas selesai atau permintaan izin menunggu. [Notifikasi dari mod](https://code.claude.com/docs/id/plugins/mods/api.md#show-something-without-starting-a-turn) menggunakan pengaturan yang sama. Muncul di `/config` sebagai **Local notifications**. * **Scope**: [`Any file`](#scopes). Claude Code juga membaca nilai yang ditinggalkan di `~/.claude.json` oleh versi yang lebih lama. * **Type**: string, salah satu dari: * `"auto"`: Claude Code mengirimkan notifikasi desktop di iTerm2, Ghostty, dan Kitty, membunyikan bel di Terminal.app hanya ketika bel audibel dimatikan, dan tidak melakukan apa pun di tempat lain * `"terminal_bell"`: Claude Code membunyikan karakter bel di terminal apa pun * `"iterm2"`: Claude Code mengirimkan notifikasi desktop iTerm2 * `"iterm2_with_bell"`: Claude Code mengirimkan notifikasi desktop iTerm2 dan membunyikan bel * `"kitty"`: Claude Code mengirimkan notifikasi desktop Kitty * `"ghostty"`: Claude Code mengirimkan notifikasi desktop Ghostty * `"notifications_disabled"`: Claude Code tidak mengirimkan notifikasi * **Default**: `"auto"` ```json settings.json theme={null} { "preferredNotifChannel": "terminal_bell" } ``` Dengan `"auto"`, Claude Code mengirimkan notifikasi desktop di iTerm2, Ghostty, dan Kitty. Di Terminal.app, Claude Code membunyikan karakter bel hanya ketika Anda telah mematikan bel audibel Terminal, dan di terminal lain tidak melakukan apa pun. Atur `"terminal_bell"` untuk membunyikan karakter bel di terminal apa pun. Lihat [Get a terminal bell or notification](https://code.claude.com/docs/id/terminal-config.md#get-a-terminal-bell-or-notification). ### `remote.defaultEnvironmentId` Pilih [lingkungan cloud](https://code.claude.com/docs/id/cloud-environments.md) default untuk sesi cloud yang Anda buat dari CLI, seperti dengan `claude --cloud`. Claude Code menulis kunci ini ke pengaturan pengguna Anda ketika Anda memilih lingkungan dengan [`/remote-env`](https://code.claude.com/docs/id/cloud-environments#select-an-environment-from-the-cli). * **Scope**: [`Any file`](#scopes). Untuk ID lingkungan yang di-host sendiri, pengaturan pengguna atau terkelola, atau flag `--settings` saja. * **Type**: string, ID lingkungan seperti `env_...` atau `ccpool_...` * **Default**: unset, jadi Claude Code menggunakan lingkungan yang di-host Anthropic ketika daftar Anda memiliki satu, dan sebaliknya lingkungan pertama dalam daftar Anda yang bukan [lingkungan jembatan Remote Control](https://code.claude.com/docs/id/cloud-environments.md#the-default-environment), atau lingkungan pertama ketika setiap satu adalah lingkungan jembatan * **Per-session overrides**: `--environment` mengambil alih kunci ini untuk satu sesi cloud yang dibuatnya ```json settings.json theme={null} { "remote": { "defaultEnvironmentId": "env_0123abcd" } } ``` ID lingkungan yang di-host Anthropic, yang dimulai dengan `env_`, mengikuti prioritas pengaturan standar, jadi nilai dalam pengaturan proyek repositori mengganti pilihan tingkat pengguna Anda. ID [lingkungan yang di-host sendiri](https://code.claude.com/docs/id/self-hosted-environments), yang dimulai dengan `ccpool_`, dihormati hanya dari pengaturan pengguna, pengaturan terkelola, dan flag `--settings`; Claude Code mengabaikan satu dalam pengaturan proyek atau lokal repositori, dan `/remote-env` menunjukkan nilai mana yang diabaikannya, jadi file yang diperiksa tidak dapat mengarahkan sesi ke lingkungan yang di-host sendiri yang tidak Anda pilih. ### `remoteControlAtStartup` Hubungkan [Remote Control](https://code.claude.com/docs/id/remote-control.md) secara otomatis ketika setiap sesi interaktif dimulai, alih-alih menunggu `/remote-control`. Atur ke `true` untuk menghidupkan auto-connect, `false` untuk mematikannya. Muncul di `/config` sebagai **Enable Remote Control for all sessions**. * **Scope**: [`Any file`](#scopes). Claude Code juga membaca nilai yang ditinggalkan di `~/.claude.json` oleh versi yang lebih lama. * **Type**: Boolean * `true`: Claude Code menghubungkan Remote Control secara otomatis ketika setiap sesi interaktif dimulai * `false`: Claude Code menunggu `/remote-control` * **Default**: unset, jadi [auto-connect default](https://code.claude.com/docs/id/remote-control.md#enable-remote-control-for-all-sessions) berlaku * **Per-session overrides**: `--remote-control` menghidupkan Remote Control untuk satu sesi bahkan ketika kunci ini `false`, dan tidak ada flag yang mematikannya untuk satu sesi ```json settings.json theme={null} { "remoteControlAtStartup": true } ``` Claude Code mengabaikan `true` dari pengaturan proyek atau lokal, jadi repositori dapat mematikan auto-connect untuk checkout-nya tetapi tidak dapat menghidupkannya. Untuk perilaku per-scope lengkap, lihat [Enable Remote Control for all sessions](https://code.claude.com/docs/id/remote-control.md#enable-remote-control-for-all-sessions) dan [kunci keamanan di mana nilai yang lebih ketat berlaku](https://code.claude.com/docs/id/settings.md#security-keys-where-the-stricter-value-applies). ### `sshConfigs` Tambahkan koneksi SSH ke pemilih lingkungan [Desktop](https://code.claude.com/docs/id/desktop.md#pre-configure-ssh-connections-for-your-team). Administrator menggunakan `sshConfigs` untuk mendistribusikan koneksi bersama ke tim. Pengguna dapat memilih koneksi terkelola dan [mengatur **Worktree folder** mereka sendiri](https://code.claude.com/docs/id/desktop.md#set-the-worktree-folder-on-an-existing-connection) untuk koneksi tersebut. Mereka tidak dapat mengedit kolom lainnya atau menghapusnya di aplikasi. * **Scope**: [`User or managed`](#scopes). Aplikasi desktop membaca kunci ini. Secara default, aplikasi membaca koneksi terkelola dari [satu sumber terkelola](https://code.claude.com/docs/id/managed-settings.md#how-claude-code-combines-managed-sources). * **Type**: array objek, masing-masing dengan `id`, `name`, dan `sshHost` yang diperlukan dan `sshPort` dan `sshIdentityFile` opsional * **Default**: unset Contoh ini menambahkan satu koneksi bernama `Dev VM` yang terhubung ke `user@dev.example.com`: ```json settings.json theme={null} { "sshConfigs": [ { "id": "dev-vm", "name": "Dev VM", "sshHost": "user@dev.example.com" } ] } ``` ### `sshHostAllowlist` Batasi host yang dapat terhubung oleh [sesi SSH Desktop](https://code.claude.com/docs/id/desktop.md#restrict-which-ssh-hosts-users-can-connect-to). Hanya aplikasi Desktop yang membaca kunci ini; CLI tidak. Pola tidak peka huruf besar-kecil: `*` cocok dengan host apa pun, `*.example.com` cocok dengan `example.com` dan setiap subdomain, dan apa pun yang lain adalah kecocokan tepat terhadap nama host setelah resolusi `~/.ssh/config`. Array kosong mematikan sesi SSH. Dengan Claude Desktop v3.1623.0 atau lebih baru, [jump host](https://code.claude.com/docs/id/desktop.md#allow-jump-hosts) dari sebuah sesi juga harus cocok dengan suatu pola. * **Scope**: [`Managed`](#scopes). Secara default, Desktop membaca kunci dari [satu sumber terkelola](https://code.claude.com/docs/id/managed-settings.md#how-claude-code-combines-managed-sources). * **Type**: array pola nama host * **Default**: unset, jadi host apa pun diizinkan Contoh ini memungkinkan `devboxes.example.com` dan subdomain-nya, ditambah host tepat `bastion.example.com`: ```json managed-settings.json theme={null} { "sshHostAllowlist": ["*.devboxes.example.com", "bastion.example.com"] } ``` Nilai yang tidak dapat dibaca Desktop sebagai daftar host, seperti `true` atau objek, dianggap sebagai array kosong hingga Anda memperbaikinya, kecuali `null`, yang dianggap unset. Memerlukan Claude Desktop v2.26454.0 atau lebih baru. Jika Anda mengatur [`managedSourcesBehavior`](#managedsourcesbehavior) ke `"merge"` di sumber dengan peringkat tertinggi Anda, Desktop menggabungkan daftar dari setiap [sumber admin](https://code.claude.com/docs/id/managed-settings.md#how-claude-code-combines-managed-sources) dan mengizinkan host yang cocok dengan salah satu dari daftar tersebut. Jika Anda mengatur array kosong di satu sumber, sesi SSH tetap aktif untuk host yang dicantumkan oleh sumber lain. ### `sshHostCommands` Tambahkan koneksi SSH yang host-nya berasal dari sebuah perintah ke pemilih lingkungan [Desktop](https://code.claude.com/docs/id/desktop.md#create-an-ssh-connection-from-a-command). Ketika Anda membuat koneksi atau mengganti host-nya, Desktop menjalankan perintah entri tersebut di komputer Anda dan terhubung ke host yang dicetak oleh perintah tersebut. Memerlukan Claude Desktop v3.6556.0 atau lebih baru di macOS atau Linux, dengan masuk menggunakan akun Claude. * **Scope**: [`User or managed`](#scopes). Hanya aplikasi desktop yang membaca kunci ini. Aplikasi membaca entri terkelola dari [satu file pengaturan terkelola atau kebijakan MDM](https://code.claude.com/docs/id/desktop.md#distribute-commands-to-your-team) di komputer, dan mengabaikan kunci ini di [pengaturan terkelola server](https://code.claude.com/docs/id/server-managed-settings.md). * **Type**: array objek, masing-masing dengan `id`, `name`, dan `command` yang diperlukan dan `sshIdentityFile` dan `startDirectory` opsional. Desktop memulai `command` tanpa shell, jadi [tulis sebagai program dan argumen biasa](https://code.claude.com/docs/id/desktop.md#write-the-command). * **Default**: unset Contoh ini menambahkan satu koneksi bernama `Dev box`, di mana `acme-dev create` mewakili alat Anda sendiri: ```json settings.json theme={null} { "sshHostCommands": [ { "id": "devbox", "name": "Dev box", "command": "acme-dev create" } ] } ``` Sebelum Claude Code v2.1.307, tool Edit menolak perubahan yang menambahkan kunci ini ke file pengaturan yang valid, dengan error `Unrecognized field: sshHostCommands`. Pada versi tersebut, tambahkan kunci ini di editor teks sebagai gantinya; Claude Code memuat file yang berisi kunci tersebut. Di Desktop, versi yang diperhitungkan adalah [versi Claude Code di tab Code](https://code.claude.com/docs/id/desktop.md#claude-code-version-in-the-code-tab), bukan versi di terminal Anda. ## Autentikasi dan penyedia Berikan kredensial melalui skrip pembantu dan, untuk organisasi, paksa metode login atau organisasi. Lihat [Autentikasi](https://code.claude.com/docs/id/authentication.md). ### `allowedProviders` Daftarkan layanan yang mesin dapat jangkau Claude melaluinya, seperti API Anthropic, Amazon Bedrock, atau gateway LLM. Sesi pada penyedia yang tidak terdaftar ditolak saat startup, saat login, dan ketika berikutnya menghubungi API, jadi beralih ke penyedia yang tidak terdaftar di tengah sesi juga ditolak. [Pesan penolakan](https://code.claude.com/docs/id/errors.md#managed-settings-dont-allow-this-api-provider) menyebutkan apa yang memilih penyedia dan langkah-langkah untuk melanjutkan. Memerlukan Claude Code v2.1.285 atau lebih baru. * **Scope**: [`Managed`](#scopes). Daftar yang sumber admin mesin sendiri atur, kebijakan MDM dan file pengaturan terkelola, terus berlaku ketika pengaturan terkelola server juga memberikan satu: sesi kemudian dapat menggunakan hanya penyedia di kedua daftar, jadi daftar terkelola server dapat mempersempit apa yang mesin izinkan tetapi tidak pernah memperluas. Sumber mesin mana yang `allowedProviders` dihitung mengikuti [bagaimana Claude Code menggabungkan sumber terkelola](https://code.claude.com/docs/id/managed-settings.md#how-claude-code-combines-managed-sources). Daftar yang disampaikan melalui pengaturan terkelola server saja mencapai hanya sesi yang [mengambil pengaturan terkelola server](https://code.claude.com/docs/id/server-managed-settings.md#platform-availability). * **Type**: array string, masing-masing satu dari: * `"anthropic"`: API Anthropic di host Anthropic sendiri, melalui sign-in claude.ai atau Console atau kunci API. Pasangkan dengan [`forceLoginMethod`](#forceloginmethod) atau [`forceLoginOrgUUID`](#forceloginorguuid) untuk juga membatasi sign-in * `"bedrock"`: [Amazon Bedrock](https://code.claude.com/docs/id/amazon-bedrock.md) * `"vertex"`: [Agent Platform Google Cloud](https://code.claude.com/docs/id/google-vertex-ai.md), sebelumnya Vertex AI * `"foundry"`: [Microsoft Foundry](https://code.claude.com/docs/id/microsoft-foundry.md) * `"anthropicAws"`: [Claude Platform di AWS](https://code.claude.com/docs/id/claude-platform-on-aws.md) * `"mantle"`: endpoint [Mantle](https://code.claude.com/docs/id/amazon-bedrock.md#use-the-mantle-endpoint) Amazon Bedrock. Sesi yang [menjalankan Mantle bersama Invoke API](https://code.claude.com/docs/id/amazon-bedrock.md#run-mantle-alongside-the-invoke-api) menggunakan kedua penyedia, jadi daftarkan `"bedrock"` dan `"mantle"` bersama untuk itu * `"customEndpoint"`: API Anthropic atau API penyedia cloud yang dikirim ke host lain, seperti [gateway LLM](https://code.claude.com/docs/id/llm-gateway) yang dinamai oleh `ANTHROPIC_BASE_URL` atau oleh variabel endpoint penyedia seperti `ANTHROPIC_BEDROCK_BASE_URL`. Claude Code mengakuinya hanya untuk nilai persis yang di-pin oleh blok [`env`](#env) terkelola * `"gateway"`: sign-in [Cloud gateway](https://code.claude.com/docs/id/claude-apps-gateway) * **Default**: tidak diatur, jadi penyedia apa pun dapat digunakan ```json managed-settings.json theme={null} { "allowedProviders": ["anthropic", "bedrock"] } ``` Entri setiap penyedia cloud berarti layanan penyedia itu sendiri, termasuk endpoint regional, FIPS, dan privatnya. Entri yang Claude Code tidak kenali sebagai nama penyedia dijatuhkan dan dilaporkan, dan sisa daftar tetap diberlakukan. Dengan daftar kosong, atau daftar yang setiap entrinya tidak dikenali, Claude Code menolak setiap penyedia dan tidak memulai di mesin. #### Endpoint yang memerlukan pin dalam `env` terkelola Pin adalah nilai variabel endpoint yang diatur dalam blok [`env`](#env) terkelola. Ketika sesi mengirimkan lalu lintas penyedia ke tempat lain selain layanan penyedia itu sendiri, Claude Code mengakuinya hanya jika nilai sesi sama dengan pin. Endpoint ini memerlukan satu: * **Sesi `"customEndpoint"`**: variabel yang menyebutkan host, seperti `ANTHROPIC_BASE_URL` * **Amazon Bedrock**: variabel `AWS_ENDPOINT_URL`, `AWS_ENDPOINT_URL_BEDROCK`, dan `AWS_ENDPOINT_URL_BEDROCK_RUNTIME` SDK AWS ketika mereka menunjuk di luar layanan Bedrock sendiri. Sesi tetap di bawah `"bedrock"` daripada `"customEndpoint"` * **URL sign-in gateway**: sesi tetap di bawah `"gateway"`, dan [`forceLoginGatewayUrl`](#forcelogingatewayurl) juga dihitung sebagai pin Blok `env` mana yang dihitung sebagai pin tergantung pada tempat daftar diatur: * **Sumber administrator di mesin mengatur daftar**: hanya blok `env` dari sumber administrator mesin sendiri yang dihitung * **Hanya pengaturan terkelola server yang mengatur daftar**: nilai `env` dalam pengaturan terkelola server itu juga dihitung Daftar tidak menilai variabel kredensial dan tenancy penyedia cloud atau jalur jaringan, seperti `HTTPS_PROXY` dan pengaturan sertifikat. Atur ini untuk armada dalam blok `env` terkelola. ### `apiKeyHelper` Jalankan perintah Anda sendiri untuk menghasilkan kredensial yang Claude Code kirimkan dengan permintaan model. Claude Code menjalankan perintah melalui shell sistem, `/bin/sh` di macOS dan Linux serta `cmd` di Windows, dan mengirimkan outputnya sebagai header `X-Api-Key` dan `Authorization: Bearer`. Gunakan untuk kredensial dinamis atau berputar, seperti token berumur pendek yang diambil dari vault. * **Scope**: [`Any file`](#scopes) * **Type**: string, baris perintah shell * **Default**: tidak diatur, jadi Claude Code tidak menjalankan pembantu ```json settings.json theme={null} { "apiKeyHelper": "/bin/generate_temp_api_key.sh" } ``` Claude Code menyimpan nilai dalam cache dan menjalankan kembali perintah dalam kasus berikut: * Setelah masa hidup cache, lima menit secara default atau interval yang Anda atur dengan [`CLAUDE_CODE_API_KEY_HELPER_TTL_MS`](https://code.claude.com/docs/id/env-vars). * Ketika permintaan ke API Anthropic, secara langsung atau melalui [gateway LLM](https://code.claude.com/docs/id/llm-gateway), gagal dengan `401` atau `403`. * Sebelum mengirimkan permintaan ke API Anthropic, secara langsung atau melalui gateway LLM, ketika output yang disimpan dalam cache adalah JWT yang kedaluwarsa setelah pembantu menghasilkannya. Memerlukan Claude Code v2.1.246 atau lebih baru. Dua kasus terakhir hanya berlaku ketika output pembantu adalah kredensial yang Claude Code kirimkan dan `ANTHROPIC_AUTH_TOKEN` tidak diatur. Dalam sesi interaktif, ketika perintah berasal dari pengaturan proyek atau lokal, Claude Code tidak menjalankannya sampai Anda menerima prompt kepercayaan workspace. Lihat [Manajemen kredensial](https://code.claude.com/docs/id/authentication.md#credential-management). ### `awsAuthRefresh` Jalankan perintah Anda sendiri, seperti `aws sso login`, untuk menyegarkan kredensial di direktori `.aws` Anda ketika kredensial yang Claude Code miliki untuk [Amazon Bedrock](https://code.claude.com/docs/id/amazon-bedrock.md) berhenti bekerja. Claude Code memeriksa kredensial saat ini terhadap STS terlebih dahulu dan hanya menjalankan perintah ketika pemeriksaan itu gagal, kemudian membaca direktori `.aws` yang telah disegarkan. Ketika pemeriksaan gagal pada saat yang sama di beberapa proses Claude Code yang menggunakan perintah dan kredensial yang sama, seperti terminal atau jendela IDE yang terpisah, satu proses menjalankan perintah dan sisanya menunggu eksekusi tersebut alih-alih memulai eksekusi mereka sendiri. Proses yang telah menunggu 60 detik dengan permintaan yang tertunda menjalankan perintah itu sendiri. Untuk mematikan ini, atur [`CLAUDE_CODE_DISABLE_AUTH_REFRESH_LOCK`](https://code.claude.com/docs/id/env-vars) ke `1`. * **Scope**: [`Any file`](#scopes) * **Type**: string, baris perintah shell * **Default**: tidak diatur, jadi Claude Code tidak menyegarkan kredensial AWS untuk Anda ```json settings.json theme={null} { "awsAuthRefresh": "aws sso login --profile myprofile" } ``` Gunakan kunci ini ketika alur penyegaran Anda menulis ke `.aws`; gunakan [`awsCredentialExport`](#awscredentialexport) ketika alur itu mencetak kredensial sebagai gantinya. Lihat [konfigurasi kredensial lanjutan](https://code.claude.com/docs/id/amazon-bedrock.md#advanced-credential-configuration). ### `awsCredentialExport` Jalankan perintah Anda sendiri yang mencetak kredensial AWS sebagai JSON, sehingga Claude Code dapat memanggil [Amazon Bedrock](https://code.claude.com/docs/id/amazon-bedrock.md) dengan kredensial yang tidak berada di direktori `.aws` Anda. Claude Code menerima bentuk output `aws sts` dan bentuk datar `aws configure export-credentials`, dan membatasi kredensial ke klien Bedrock-nya sendiri, sehingga perintah shell yang Claude jalankan masih melihat kredensial ambient Anda. * **Scope**: [`Any file`](#scopes) * **Type**: string, baris perintah shell * **Default**: tidak diatur, jadi Claude Code menggunakan rantai kredensial AWS ambient ```json settings.json theme={null} { "awsCredentialExport": "/bin/generate_aws_grant.sh" } ``` Tidak seperti [`awsAuthRefresh`](#awsauthrefresh), Claude Code selalu menjalankan perintah ini ketika diatur, tanpa memeriksa kredensial ambient terlebih dahulu. Lihat [konfigurasi kredensial lanjutan](https://code.claude.com/docs/id/amazon-bedrock.md#advanced-credential-configuration). ### `forceLoginMethod` Batasi jenis akun apa yang dapat digunakan orang untuk masuk. Atur `"claudeai"` untuk memungkinkan hanya akun claude.ai, `"console"` untuk memungkinkan hanya akun Claude Console, atau `"gateway"` untuk mengirim orang ke [cloud gateway](https://code.claude.com/docs/id/claude-apps-gateway) alih-alih login pihak pertama. Administrator mengaturnya dalam pengaturan terkelola dan memasangkannya dengan [`forceLoginOrgUUID`](#forceloginorguuid) untuk menjaga login claude.ai pengembang di dalam satu organisasi. Jika Anda mengaturnya ke `"claudeai"` atau `"console"` di file pengaturan apa pun, Claude Code juga berhenti menawarkan [sign-in Console tanpa kunci](https://code.claude.com/docs/id/authentication.md#sign-in-without-an-api-key) dalam sesi yang file itu berlaku. * **Scope**: [`Any file`](#scopes). Claude Code menghormati `"gateway"` dari sumber yang sama dengan [`forceLoginGatewayUrl`](#forcelogingatewayurl) dan memperlakukannya sebagai tidak diatur di tempat lain. * **Type**: string, salah satu dari: * `"claudeai"`: hanya akun claude.ai yang dapat masuk * `"console"`: hanya akun Claude Console yang dapat masuk * `"gateway"`: Claude Code mengirim orang ke cloud gateway alih-alih login pihak pertama * **Default**: tidak diatur, jadi orang memilih metode login ```json settings.json theme={null} { "forceLoginMethod": "claudeai" } ``` Setiap jalur login pihak pertama menerapkan pembatasan, termasuk [ekstensi VS Code](https://code.claude.com/docs/id/vs-code.md), Agent SDK, `claude setup-token`, dan `/install-github-app`, kecuali layar login interaktif terminal, yang dicapai oleh `/login` atau onboarding first-run, yang pra-memilih metode tanpa memberlakukannya. Sebelum v2.1.212, hanya login terminal yang menerapkannya. Lihat [Batasi login ke organisasi Anda](https://code.claude.com/docs/id/authentication.md#restrict-login-to-your-organization) untuk cara setiap jalur login, kredensial lingkungan, dan penyedia pihak ketiga ditangani. Ketika sumber terkelola di mesin mengatur `"gateway"`, Claude Code tidak menggunakan login sisa, kunci API, atau kredensial `apiKeyHelper`. Lihat [Administrator policy requires a Cloud gateway sign-in](https://code.claude.com/docs/id/errors.md#administrator-policy-requires-a-cloud-gateway-sign-in) untuk pesan yang masing-masing menghasilkan. Jika Anda memilih penyedia cloud melalui `CLAUDE_CODE_USE_BEDROCK` atau environment variable serupa, sesi tidak memerlukan sign-in gateway. Sebelum v2.1.261, Claude Code menggunakan login sisa di mesin ini. ### `forceLoginGatewayUrl` Atur URL gateway yang layar Cloud gateway `/login` terhubung, sehingga orang mencapai [cloud gateway](https://code.claude.com/docs/id/claude-apps-gateway) Anda tanpa mengetik alamatnya. Layar tidak memiliki bidang URL: dengan kunci ini diatur, layar menampilkan URL gateway Anda dan terhubung ketika orang menekan Enter; tanpanya, layar memberi tahu mereka untuk menghubungi administrator IT mereka. Dalam pengaturan terkelola, baik kunci ini atau `forceLoginMethod: "gateway"` membuat mesin gateway-only, kecuali untuk sesi yang memilih penyedia cloud dengan `CLAUDE_CODE_USE_*`. `/login` kemudian membuka di layar Cloud gateway tanpa pemilih metode login. Lihat [Administrator policy requires a Cloud gateway sign-in](https://code.claude.com/docs/id/errors.md#administrator-policy-requires-a-cloud-gateway-sign-in) untuk apa yang terjadi pada login pihak pertama atau kunci API yang tersisa. Atur kedua kunci sehingga layar terhubung alih-alih menampilkan kesalahan. * **Scope**: [`User or managed`](#scopes). Dibaca dari sumber terkelola di mesin: `managed-settings.json`, plist macOS atau registri Windows HKLM, atau pembantu kebijakan. Pada mesin yang tidak memiliki satu pun dari sumber tersebut, Claude Code v2.1.295 atau lebih baru juga membacanya dari [pengaturan pengguna](https://code.claude.com/docs/id/claude-apps-gateway#set-the-gateway-url-in-user-settings). Claude Code mengabaikannya dalam pengaturan HKCU dan server-terkelola. * **Type**: string, URL lengkap termasuk skema * **Default**: tidak diatur, jadi layar Cloud gateway menampilkan kesalahan yang memberi tahu orang untuk menghubungi administrator IT mereka ```json managed-settings.json theme={null} { "forceLoginGatewayUrl": "https://claude-gateway.example.com" } ``` Jika nilainya bukan URL yang valid, layar sign-in melaporkannya, dan sisa file pengaturan terkelola masih berlaku. Lihat [Atur URL gateway](https://code.claude.com/docs/id/claude-apps-gateway#set-the-gateway-url). ### `forceLoginOrgUUID` Dari sumber terkelola, perlukan login akun claude.ai untuk milik satu organisasi Anthropic, diberikan sebagai UUID tunggal, atau milik salah satu dari beberapa organisasi, diberikan sebagai array. Dari file pengaturan apa pun, Claude Code juga menggunakan UUID tunggal untuk pra-memilih organisasi itu selama login claude.ai atau Claude Console, dan pra-memilih tidak ada untuk array. Jika Anda mengatur kunci di file pengaturan apa pun, Claude Code juga berhenti menawarkan [sign-in Console tanpa kunci](https://code.claude.com/docs/id/authentication.md#sign-in-without-an-api-key) dalam sesi yang file itu berlaku dan membuat kunci API sebagai gantinya. * **Scope**: [`Any file`](#scopes). Hanya sumber terkelola yang memberlakukan pembatasan; UUID tunggal di file pengaturan lain apa pun pra-memilih organisasi selama login tanpa membatasinya. * **Type**: string, satu UUID, atau array string, beberapa UUID * **Default**: tidak diatur, jadi organisasi apa pun dapat masuk Contoh ini menerima login dari salah satu dari dua organisasi tanpa pra-memilih satu: ```json managed-settings.json theme={null} { "forceLoginOrgUUID": ["xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx", "yyyyyyyy-yyyy-yyyy-yyyy-yyyyyyyyyyyy"] } ``` Jika sumber terkelola mengatur array kosong, atau nilai yang bukan string atau array string, pengguna yang masuk dengan akun Anthropic tidak dapat memulai Claude Code atau menyelesaikan login. Mereka melihat pesan yang menyebutkan `forceLoginOrgUUID` dan meminta mereka untuk menghubungi administrator mereka. [`policyHelper`](#policyhelper) yang menghasilkan nilai dengan tipe yang salah [menggagalkan eksekusinya](#helper-failures) sebagai gantinya. Lihat [Batasi login ke organisasi Anda](https://code.claude.com/docs/id/authentication.md#restrict-login-to-your-organization) untuk cara Claude Code memperlakukan login Claude Console, jalur login lainnya, dan kredensial lingkungan. ### `gatewayInternalNetworks` Deklarasikan blok IPv4 publik yang organisasi Anda gunakan untuk menomori jaringan internalnya, sehingga `/login` menerima [cloud gateway](https://code.claude.com/docs/id/claude-apps-gateway) di sana. Memerlukan Claude Code v2.1.268 atau lebih baru. Tanpa kunci ini, `/login` terhubung ke gateway apa pun pada alamat pribadi dan tidak ada yang lain. Dengan kunci ini, `/login` juga menerima gateway di dalam blok yang terdaftar, hanya melalui koneksi langsung. Alamat mesin itu sendiri pada koneksi itu juga harus berada di dalam blok yang sama. * **Scope**: [`Managed`](#scopes). Baca hanya dari sumber di mesin: `managed-settings.json`, plist macOS atau registri Windows HKLM, atau pembantu kebijakan. Claude Code mengabaikannya dalam pengaturan HKCU dan server-terkelola. * **Type**: array string, paling banyak empat blok CIDR IPv4, masing-masing `/8` hingga `/32`, tidak tumpang tindih satu sama lain, dan tidak ada yang tumpang tindih dengan ruang pribadi. * **Default**: tidak diatur, jadi `/login` hanya menerima gateway pada alamat pribadi ```json managed-settings.json theme={null} { "gatewayInternalNetworks": ["203.0.113.0/24"] } ``` Ganti rentang dokumentasi dalam contoh dengan blok Anda sendiri. Claude Code menolak rentang dokumentasi, rentang yang digunakan klien VPN dan NAT64 secara lokal, dan ruang yang dicadangkan yang tidak ada jaringan yang dinomori darinya, seperti multicast. Jika entri tidak valid, atau nilainya bukan daftar string, `/login` menyebutkan masalahnya dan menolak setiap sign-in gateway baru di mesin sampai Anda memperbaiki nilainya. Sign-in yang ada terus bekerja. Lihat [Izinkan gateway pada ruang alamat publik yang Anda miliki](https://code.claude.com/docs/id/claude-apps-gateway#allow-a-gateway-on-public-address-space-you-own) untuk aturan lengkap dan apa yang dilihat pengembang. ### `gcpAuthRefresh` Jalankan perintah Anda sendiri untuk menyegarkan Google Cloud Application Default Credentials ketika Claude Code menemukan bahwa kredensial telah kedaluwarsa atau tidak dapat dimuat, sehingga permintaan [Google Cloud's Agent Platform](https://code.claude.com/docs/id/google-vertex-ai.md) terus bekerja tanpa Anda perlu melakukan autentikasi ulang secara manual. Ketika beberapa proses Claude Code yang menggunakan perintah dan kredensial yang sama, seperti terminal atau jendela IDE yang terpisah, menemukan bahwa kredensial tersebut kedaluwarsa pada saat yang sama, satu proses menjalankan perintah dan sisanya menunggu eksekusi tersebut alih-alih memulai eksekusi mereka sendiri. Proses yang telah menunggu 60 detik dengan permintaan yang tertunda menjalankan perintah itu sendiri. Untuk mematikan ini, atur [`CLAUDE_CODE_DISABLE_AUTH_REFRESH_LOCK`](https://code.claude.com/docs/id/env-vars) ke `1`. * **Scope**: [`Any file`](#scopes) * **Type**: string, baris perintah shell * **Default**: tidak diatur, jadi kesalahan kredensial Claude Code memberi tahu Anda untuk menjalankan `gcloud auth application-default login` sendiri ```json settings.json theme={null} { "gcpAuthRefresh": "gcloud auth application-default login" } ``` Lihat [konfigurasi kredensial lanjutan](https://code.claude.com/docs/id/google-vertex-ai.md#advanced-credential-configuration). ### `otelHeadersHelper` Jalankan perintah Anda sendiri untuk menghasilkan header yang Claude Code kirimkan dengan ekspor OpenTelemetry, untuk backend yang tokennya berputar. Claude Code menjalankannya saat startup dan secara berkala setelah itu, dan mengharapkan objek JSON dari nilai header string di stdout. * **Scope**: [`Any file`](#scopes) * **Type**: string, jalur yang dapat dieksekusi atau baris perintah shell * **Default**: tidak diatur, jadi Claude Code tidak menambahkan header yang dihasilkan pembantu ```json settings.json theme={null} { "otelHeadersHelper": "/bin/generate_otel_headers.sh" } ``` Atur interval penyegaran dengan [`CLAUDE_CODE_OTEL_HEADERS_HELPER_DEBOUNCE_MS`](https://code.claude.com/docs/id/env-vars). Lihat [Dynamic headers](https://code.claude.com/docs/id/monitoring-usage.md#dynamic-headers) untuk persyaratan skrip dan apa yang terjadi ketika pembantu gagal. ## Pembaruan dan versioning Pilih saluran pembaruan dan, untuk organisasi, tetapkan versi yang dapat dijalankan orang. Lihat [Update Claude Code](https://code.claude.com/docs/id/setup.md#update-claude-code). ### `autoUpdatesChannel` Pilih [saluran rilis](https://code.claude.com/docs/id/setup.md#configure-release-channel) mana yang diikuti pembaruan otomatis latar belakang dan `claude update`. Atur `"stable"` untuk versi yang biasanya berusia sekitar satu minggu dan melewati rilis dengan regresi besar, atau `"latest"` untuk rilis paling terbaru. * **Scope**: [`Any file`](#scopes). Atur di managed settings untuk memberlakukan satu saluran di seluruh organisasi Anda. * **Type**: string, salah satu dari: * `"latest"`: pembaruan mengikuti rilis paling terbaru * `"stable"`: pembaruan mengikuti versi yang biasanya berusia sekitar satu minggu dan melewati rilis dengan regresi besar * **Default**: tidak diatur, jadi Claude Code mengikuti `"latest"` ```json settings.json theme={null} { "autoUpdatesChannel": "stable" } ``` Claude Code menulis `"stable"` ke pengaturan pengguna Anda ketika Anda memilihnya di bawah **Auto-update channel** di `/config`, dan menghapus kunci ketika Anda beralih kembali ke latest di sana. `claude install stable` dan `claude install latest` juga menyimpan saluran yang Anda beri nama. Beralih dari `"latest"` ke `"stable"` di `/config` menanyakan apakah akan mengizinkan downgrade atau tetap di versi saat ini Anda; tetap atur [`minimumVersion`](#minimumversion). Instalasi Homebrew mengabaikan kunci ini: cask `claude-code` melacak stable dan `claude-code@latest` melacak latest, dan `claude update` menunda ke `brew upgrade`. Untuk mematikan pembaruan otomatis sepenuhnya, atur [`DISABLE_AUTOUPDATER`](https://code.claude.com/docs/id/setup#disable-auto-updates) di `env`. ### `minimumVersion` Cegah pembaruan otomatis latar belakang dan `claude update` dari menginstal versi apa pun di bawah yang ini, jadi berpindah ke saluran `"stable"` tidak menurunkan Anda dari build `"latest"` yang lebih baru. Claude Code menulis kunci ini untuk Anda ketika Anda memilih untuk tetap di versi saat ini Anda sambil beralih saluran di `/config`, dan menghapusnya ketika Anda beralih kembali ke `"latest"`. * **Scope**: [`Any file`](#scopes). Atur di managed settings untuk menetapkan minimum di seluruh organisasi yang tidak dapat diturunkan oleh pengaturan pengguna dan proyek. * **Type**: string, nomor versi seperti `"2.1.100"`; nilai yang bukan versi valid diabaikan * **Default**: tidak diatur, jadi pembaruan dapat menginstal versi apa pun yang ditawarkan saluran Contoh ini mengikuti saluran stable dan menolak untuk menginstal versi apa pun di bawah 2.1.100: ```json settings.json theme={null} { "autoUpdatesChannel": "stable", "minimumVersion": "2.1.100" } ``` Kunci ini hanya membatasi pembaruan. Untuk membuat Claude Code menolak memulai di bawah versi, gunakan [`requiredMinimumVersion`](#requiredminimumversion) sebagai gantinya. Lihat [Pin a minimum version](https://code.claude.com/docs/id/setup.md#pin-a-minimum-version). ### `requiredMaximumVersion` Atur versi Claude Code terbaru yang diizinkan organisasi Anda untuk memulai. Ketika versi yang berjalan lebih baru, Claude Code keluar saat startup dan memberi tahu pengguna untuk menginstal versi yang disetujui melalui metode yang disetujui organisasi Anda; `claude install ` mungkin juga berfungsi. Memerlukan Claude Code v2.1.163 atau lebih baru. * **Scope**: [`Managed`](#scopes). Claude Code tidak memberikan peringatan ketika mengabaikan kunci di tempat lain. * **Type**: string, nomor versi seperti `"2.1.150"`; nilai yang bukan versi valid diabaikan * **Default**: tidak diatur, jadi tidak ada batas atas yang berlaku ```json managed-settings.json theme={null} { "requiredMaximumVersion": "2.1.150" } ``` Pembaruan otomatis latar belakang dan `claude update` melewati versi di atas batas, jadi instalasi dalam rentang tetap berada di dalamnya. `claude update`, `claude install`, dan `claude doctor` terus bekerja di atas batas sehingga pengguna dapat pulih. Pasangkan dengan [`requiredMinimumVersion`](#requiredminimumversion) untuk memberlakukan rentang. ### `requiredMinimumVersion` Atur versi Claude Code tertua yang diizinkan organisasi Anda untuk memulai. Ketika versi yang berjalan lebih lama, Claude Code keluar saat startup dan memberi tahu pengguna untuk memperbarui melalui metode yang disetujui organisasi Anda. Pemeriksaan berjalan hanya saat startup, jadi sesi yang sudah berjalan terus berlanjut. Memerlukan Claude Code v2.1.163 atau lebih baru. * **Scope**: [`Managed`](#scopes). Claude Code tidak memberikan peringatan ketika mengabaikan kunci di tempat lain. * **Type**: string, nomor versi seperti `"2.1.150"`; nilai yang bukan versi valid diabaikan * **Default**: tidak diatur, jadi tidak ada batas bawah yang berlaku ```json managed-settings.json theme={null} { "requiredMinimumVersion": "2.1.150" } ``` `claude update`, `claude install`, dan `claude doctor` terus bekerja di bawah batas sehingga pengguna dapat pulih. Tidak seperti [`minimumVersion`](#minimumversion), yang hanya mencegah downgrade, kunci ini memblokir startup. Pasangkan dengan [`requiredMaximumVersion`](#requiredmaximumversion) untuk memberlakukan rentang. ## Tools Matikan alat tertentu di [aplikasi desktop Claude Code](https://code.claude.com/docs/id/desktop.md). CLI terminal mengabaikan kunci-kunci ini. Untuk alat-alat itu sendiri, lihat [Tools available to Claude](https://code.claude.com/docs/id/tools-reference.md). ### `browserExternalPageTools` Hentikan Claude dari menggunakan alatnya untuk membaca atau bertindak pada halaman eksternal di [Browser pane](https://code.claude.com/docs/id/desktop.md#browse-external-sites) aplikasi desktop. Orang-orang di organisasi Anda masih dapat membuka situs eksternal sendiri, dan pratinjau server dev lokal terus bekerja dengan alat Claude. Aplikasi desktop membaca kunci ini; CLI terminal mengabaikannya. * **Scope**: [`Managed`](#scopes) * **Type**: string, `"disabled"`; aplikasi desktop juga menerima `"disable"`, dalam kedua kasus * **Default**: tidak diatur, jadi alat Claude bekerja pada halaman eksternal ```json managed-settings.json theme={null} { "browserExternalPageTools": "disabled" } ``` Nilai lainnya membiarkan alat Claude tetap aktif, dan string yang tidak kosong yang bukan salah satu dari dua nilai yang diterima mencatat peringatan. Untuk memblokir situs eksternal untuk orang-orang dan Claude, atur [`disableBrowserExternalNavigation`](#disablebrowserexternalnavigation) sebagai gantinya. Lihat [Restrict external browsing for your organization](https://code.claude.com/docs/id/desktop.md#restrict-external-browsing-for-your-organization). ### `disableBrowserExternalNavigation` Matikan penjelajahan eksternal di [Browser pane](https://code.claude.com/docs/id/desktop.md#browse-external-sites) aplikasi desktop untuk orang-orang dan Claude. Pratinjau server dev localhost terus bekerja. Aplikasi desktop membaca kunci ini; CLI terminal mengabaikannya. * **Scope**: [`Managed`](#scopes) * **Type**: Boolean; hanya Boolean JSON `true` yang berlaku * `true`: aplikasi desktop mematikan penjelajahan eksternal di Browser pane untuk orang-orang dan Claude; pratinjau localhost terus bekerja * `false`: penjelajahan eksternal tetap aktif * **Default**: tidak diatur, jadi penjelajahan eksternal aktif ```json managed-settings.json theme={null} { "disableBrowserExternalNavigation": true } ``` Aplikasi desktop mengabaikan nilai lainnya, dan nilai yang bukan Boolean, seperti string `"true"` atau `1`, juga mencatat peringatan. Untuk membiarkan penjelajahan eksternal tetap aktif tetapi menjaga alat Claude tetap mati pada halaman eksternal, atur [`browserExternalPageTools`](#browserexternalpagetools) sebagai gantinya. Lihat [Restrict external browsing for your organization](https://code.claude.com/docs/id/desktop.md#restrict-external-browsing-for-your-organization). ### `disableMobileSimulatorTools` Blokir alat Claude untuk [iOS Simulator pane](https://code.claude.com/docs/id/desktop-ios-simulator.md#turn-off-simulator-access) aplikasi desktop. Orang-orang tetap mempertahankan penggunaan manual dari pane; hanya akses Claude yang dihapus, dan tidak ada yang dapat menghidupkannya kembali dari dalam aplikasi. Aplikasi desktop membaca kunci ini; CLI terminal mengabaikannya. * **Scope**: [`Managed`](#scopes) * **Type**: Boolean; hanya Boolean JSON `true` yang berlaku * `true`: aplikasi desktop memblokir alat Claude untuk iOS Simulator pane * `false`: alat simulator Claude mengikuti pengaturan toggle setiap orang di aplikasi desktop * **Default**: tidak diatur, jadi alat simulator Claude mengikuti pengaturan toggle setiap orang di aplikasi desktop ```json managed-settings.json theme={null} { "disableMobileSimulatorTools": true } ``` Aplikasi desktop mengabaikan nilai lainnya, dan nilai yang bukan Boolean, seperti string `"true"` atau `1`, juga mencatat peringatan. ## Privasi dan telemetri Kontrol berapa lama Claude Code menyimpan data sesi dan apa yang dikirimnya. Saklar yang mematikan metrik penggunaan dan laporan kesalahan adalah variabel lingkungan, bukan kunci pengaturan: atur `DISABLE_TELEMETRY`, `DISABLE_ERROR_REPORTING`, atau `CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC` dalam kunci [`env`](#env) atau di shell. [Layanan telemetri](https://code.claude.com/docs/id/data-usage.md#telemetry-services) menjelaskan apa yang masing-masing hentikan. Dua pengecualian mematikan dari file pengaturan: [`feedbackDrafts`](#feedbackdrafts) di bawah untuk umpan balik yang dirancang Claude, dan [`feedbackSurveyRate`](#feedbacksurveyrate) di bawah untuk survei sesi. ### `cleanupPeriodDays` Atur berapa hari Claude Code menyimpan [transkrip sesi dan data aplikasi lainnya](https://code.claude.com/docs/id/claude-directory.md#cleaned-up-automatically) sebelum menghapusnya. Claude Code menjalankan penghapusan sebagai sapuan latar belakang setelah sesi dimulai, selama dapat dengan aman menentukan periode retensi. Sapuan menghapus transkrip tanpa menampilkan pesan, jadi sesi yang belum Anda gunakan lebih lama dari periode retensi tidak lagi muncul di pemilih [`/resume`](https://code.claude.com/docs/id/sessions#resume-a-session). * **Scope**: [`Any file`](#scopes) * **Type**: jumlah hari, bilangan bulat, minimum `1` * **Default**: `30` ```json settings.json theme={null} { "cleanupPeriodDays": 20 } ``` Mengatur `0` gagal validasi, jadi pilih nilai besar seperti `3650` untuk retensi jangka panjang. Untuk menghentikan Claude Code dari penulisan transkrip sama sekali, lihat [Plaintext storage](https://code.claude.com/docs/id/claude-directory.md#plaintext-storage). ### `desktopSessionCleanupPeriodDays` Atur batas usia dalam hari untuk transkrip sesi yang Anda mulai atau lanjutkan terakhir di Claude Desktop atau Cowork. Tanpa kunci ini, Claude Code [menyimpan transkrip tersebut pada usia berapa pun](https://code.claude.com/docs/id/claude-directory.md#cleaned-up-automatically). Claude Code menghapus masing-masing setelah lebih tua dari batas ini dan [`cleanupPeriodDays`](#cleanupperioddays), jadi dengan `cleanupPeriodDays` pada default 30, nilai `7` masih menyimpannya 30 hari. [Dibersihkan secara otomatis](https://code.claude.com/docs/id/claude-directory.md#cleaned-up-automatically) mencantumkan kasus-kasus di mana `cleanupPeriodDays` berlaku sebagai gantinya dan Claude Code mengabaikan kunci ini. Memerlukan Claude Code v2.1.248 atau lebih baru. * **Scope**: [`User or managed`](#scopes). Claude Code juga membaca kunci dari file yang Anda berikan dengan `--settings`, dan mengabaikannya dalam pengaturan proyek dan lokal. * **Type**: jumlah hari, bilangan bulat, minimum `0` * **Default**: `0`, yang tidak menetapkan batas usia ```json settings.json theme={null} { "desktopSessionCleanupPeriodDays": 90 } ``` ### `feedbackDrafts` Kontrol [umpan balik yang dirancang Claude](https://code.claude.com/docs/id/tools-reference.md#sendfeedback-tool-behavior): apakah Claude dapat mengantrekan draf umpan balik untuk Anda tinjau, dan apakah Claude Code menampilkan kartu ketika Claude mengantrekan satu. * **Scope**: [`User or managed`](#scopes) * **Type**: string, salah satu dari `"notify"`, `"quiet"`, atau `"off"` * `"notify"`: Claude Code menampilkan kartu di atas prompt ketika Claude mengantrekan draf, hingga [tiga kartu dalam sesi](https://code.claude.com/docs/id/tools-reference.md#what-you-see-when-claude-drafts) secara default * `"quiet"`: Claude membuat draf tanpa kartu. Anda melihat jumlah draf yang antri di footer prompt dan meninjau mereka di `/feedback` * `"off"`: Claude Code menghapus alat SendFeedback, jadi Claude tidak dapat mengantrekan draf * **Default**: `"notify"` * **Per-session overrides**: [`CLAUDE_CODE_SEND_FEEDBACK`](https://code.claude.com/docs/id/env-vars) diatur ke `0` mematikan fitur untuk satu sesi ```json settings.json theme={null} { "feedbackDrafts": "quiet" } ``` Muncul di `/config` sebagai **Claude-drafted feedback**, yang menulis kunci ini ke pengaturan pengguna Anda. Anda melihat baris `/config` hanya dalam sesi [di mana Claude dapat membuat draf umpan balik](https://code.claude.com/docs/id/tools-reference.md#sessions-without-claude-drafted-feedback); mengatur `"off"` tidak menyembunyikannya, jadi Anda dapat menghidupkan fitur kembali dari baris yang sama. Nilai dalam pengaturan terkelola mengambil alih pengaturan pengguna Anda, jadi ketika administrator menetapkan kunci ini, baris menampilkan nilai terkelola dan mengubahnya tidak berpengaruh. Claude Code mengabaikan kunci ini dalam pengaturan proyek dan lokal. ### `feedbackSurveyRate` Atur probabilitas bahwa [survei kualitas sesi](https://code.claude.com/docs/id/data-usage.md#session-quality-surveys) muncul ketika sesi memenuhi syarat untuk itu. Atur `0` untuk mencegah survei muncul. * **Scope**: [`Any file`](#scopes) * **Type**: angka antara `0` dan `1` * **Default**: tidak diatur, jadi Claude Code menggunakan tingkat yang Anthropic atur dari jarak jauh, atau tingkat bawaan `0.005` di Amazon Bedrock, Platform Agen Google Cloud, dan Microsoft Foundry, yang tidak menerima konfigurasi jarak jauh * **Per-session overrides**: [`CLAUDE_CODE_DISABLE_FEEDBACK_SURVEY`](https://code.claude.com/docs/id/env-vars) diatur ke `1` mematikan survei untuk satu sesi apa pun tingkat kunci ini atur ```json settings.json theme={null} { "feedbackSurveyRate": 0.05 } ``` Tingkat yang sama berlaku untuk survei di ekstensi VS Code. ### `skipWebFetchPreflight` Lewati [pemeriksaan keamanan domain WebFetch](https://code.claude.com/docs/id/data-usage.md#webfetch-domain-safety-check), yang mengirim setiap nama host yang diminta ke `api.anthropic.com` sebelum mengambil. Atur `true` di lingkungan yang memblokir lalu lintas ke Anthropic, seperti Amazon Bedrock, Platform Agen Google Cloud, atau penyebaran Microsoft Foundry dengan egress yang ketat. * **Scope**: [`Any file`](#scopes) * **Type**: Boolean * `true`: Claude Code melewati pemeriksaan keamanan domain WebFetch * `false`: pemeriksaan berjalan sebelum pengambilan pertama ke setiap nama host dalam sesi, dan lagi untuk nama host yang pemeriksaannya sebelumnya diblokir atau gagal * **Default**: tidak diatur, jadi pemeriksaan berjalan sebelum pengambilan pertama ke setiap nama host dalam sesi ```json settings.json theme={null} { "skipWebFetchPreflight": true } ``` Dengan pemeriksaan dilewati, WebFetch mencoba URL apa pun tanpa berkonsultasi dengan daftar blokir, jadi pasangkan dengan [aturan izin `WebFetch`](https://code.claude.com/docs/id/permissions#webfetch) jika Anda perlu membatasi domain mana yang dapat dijangkau Claude. ## Pengaturan enterprise dan terkelola Kunci yang digunakan organisasi untuk menghitung, menyegarkan, dan menggabungkan pengaturan terkelola. Lihat [Siapkan pengaturan terkelola](https://code.claude.com/docs/id/admin-setup.md). ### `disableSideloadFlags` Tolak flag CLI `--plugin-dir`, `--plugin-url`, `--agents`, dan `--mcp-config` saat startup, yang dapat digunakan pengguna untuk melewati [`strictKnownMarketplaces`](#strictknownmarketplaces) untuk satu kali jalankan. Claude Code keluar dengan kesalahan yang menyebutkan flag yang ditolak. Dalam [sesi cloud](https://code.claude.com/docs/id/claude-code-on-the-web.md), Claude Code malah memulai sesi dan menghapus setiap entri `--mcp-config` yang dikirimkan server kecuali entri `type: "sdk"` dalam proses dan alat Slack sesi [Claude Tag](https://code.claude.com/docs/id/claude-tag.md). Memerlukan Claude Code v2.1.193 atau lebih baru. * **Scope**: [`Managed`](#scopes) * **Type**: Boolean * `true`: Claude Code menolak `--plugin-dir`, `--plugin-url`, `--agents`, dan `--mcp-config` saat startup dan keluar dengan kesalahan yang menyebutkannya. Dalam sesi cloud, ia malah memulai sesi dan menghapus setiap entri `--mcp-config` yang dikirimkan server kecuali entri `type: "sdk"` dalam proses dan alat Slack sesi Claude Tag * `false`: Claude Code menerima flag tersebut * **Default**: `false` ```json managed-settings.json theme={null} { "disableSideloadFlags": true } ``` Claude Code masih menerima `--mcp-config` yang servernya adalah semua entri `type: "sdk"` dalam proses, sehingga Agent SDK dan ekstensi VS Code tetap berfungsi. Pengguna masih dapat menambahkan server dengan `claude mcp add` atau file `.mcp.json`; untuk kontrol per-server, atur [`allowedMcpServers`](https://code.claude.com/docs/id/managed-mcp) juga. Memerlukan Claude Code v2.1.193 atau lebih baru. Pemeriksaan yang sama mencakup folder plugin yang dinamai dalam variabel lingkungan [`CLAUDE_CODE_PLUGIN_DIRS`](https://code.claude.com/docs/id/env-vars#variables), yang memerlukan Claude Code v2.1.280 atau lebih baru. Ketika variabel menyebutkan folder, Claude Code keluar dengan kesalahan yang sama, dan kesalahan mengatakan untuk membatalkan pengaturan variabel. Dalam sesi cloud, Claude Code juga mengabaikan pembaruan MCP yang dikirimkan server di tengah sesi, jalur di balik konfigurasi sesi cloud dan panggilan SDK `setMcpServers()` yang mencapai sesi tersebut. Entri `type: "sdk"` dalam proses dan alat Slack sesi Claude Tag tetap dikecualikan di sana juga. Sebelum v2.1.268, baik penghapusan ini maupun penghapusan startup juga menghapus alat Slack sesi Claude Tag. Sebelum v2.1.239, `--mcp-config` yang dikirimkan server memblokir sesi cloud dari dimulai. Aplikasi desktop mengelola beberapa plugin itu sendiri, termasuk plugin yang disinkronkan dari claude.ai dan plugin yang diterapkan organisasi Anda melalui aplikasi. Jika Anda menerapkan kunci ini ke perangkat melalui MDM, kebijakan tingkat OS, atau file pengaturan terkelola, aplikasi desktop tidak melewatkan plugin tersebut ke sesi berikut di perangkat itu: * **[Sesi Code di mesin pengguna](https://code.claude.com/docs/id/desktop.md#environment-configuration)**: mereka juga dimulai tanpa skill yang diaktifkan untuk akun claude.ai pengguna. Plugin yang Claude Code instal dari marketplace dalam pengaturan terkelola Anda masih dimuat. Dalam [Claude Desktop on 3P](https://claude.com/docs/third-party/claude-desktop/overview), server MCP dari plugin yang Anda terapkan ke direktori `org-plugins` perangkat tetap tersedia juga, karena aplikasi desktop terhubung ke mereka sendiri. Sebelum Claude Desktop v1.37937.0, sesi ini gagal saat startup. * **[Sesi Cowork di mesin pengguna](https://code.claude.com/docs/id/managed-settings.md#where-and-when-a-policy-applies)**: skill di dalam plugin tersebut dan skill yang diaktifkan untuk akun claude.ai pengguna tetap tersedia. Dalam [Claude Desktop on 3P](https://claude.com/docs/third-party/claude-desktop/overview), server MCP dari plugin yang Anda terapkan ke direktori `org-plugins` perangkat tetap tersedia juga, karena aplikasi desktop terhubung ke mereka sendiri. Sebelum Claude Desktop v1.44121.0, sesi ini gagal saat startup. ### `forceRemoteSettingsRefresh` Blokir startup CLI hingga Claude Code telah segar mengambil [pengaturan yang dikelola server](https://code.claude.com/docs/id/server-managed-settings.md). Jika pengambilan gagal, Claude Code keluar alih-alih melanjutkan dengan pengaturan yang di-cache atau tidak ada. Atur ketika lingkungan Anda tidak dapat menerima bahkan jendela singkat di mana sesi berjalan tanpa kebijakan terkelolanya. Ketika kunci tidak diatur, Claude Code tidak memblokir startup pada pengambilan, meskipun ketika pengembang masuk saat startup ia menunggu hingga lima detik untuk pengambilan. Sesi gateway Cloud selalu menunggu, dan keluar jika gateway tidak dapat dijangkau. * **Scope**: [`Managed`](#scopes). Claude Code menghormati `true` dari sumber terkelola yang dikontrol admin apa pun, bahkan yang bukan sumber prioritas tertinggi. * **Type**: Boolean * `true`: Claude Code memblokir startup hingga telah segar mengambil pengaturan yang dikelola server, dan keluar jika pengambilan gagal * `false`: Claude Code tidak memblokir startup pada pengambilan, meskipun pada startup masuk ia menunggu hingga lima detik untuk pengambilan * **Default**: `false` ```json managed-settings.json theme={null} { "forceRemoteSettingsRefresh": true } ``` Atur dalam profil MDM atau file pengaturan terkelola untuk memberlakukan startup fail-closed sebelum muatan server pertama tiba. Claude Code menerapkan pemeriksaan hanya dalam sesi yang mengambil pengaturan yang dikelola server, jadi sesi yang [tidak mengambilnya](https://code.claude.com/docs/id/server-managed-settings.md#platform-availability) dimulai tanpa menunggu. Subperintah `claude auth` dikecualikan, sehingga pengguna dapat mengotentikasi ulang ketika kredensial yang kedaluwarsa adalah alasan pengambilan gagal. Lihat [Berlakukan startup fail-closed](https://code.claude.com/docs/id/server-managed-settings.md#enforce-fail-closed-startup). ### `managedSourcesBehavior` Pilih apakah Claude Code menerapkan hanya [sumber terkelola](https://code.claude.com/docs/id/managed-settings.md#how-claude-code-combines-managed-sources) prioritas tertinggi yang disampaikan organisasi Anda, atau menggabungkan setiap sumber admin yang disampaikannya. Secara default Claude Code mengambil sumber prioritas tertinggi yang membawa [kunci kebijakan](https://code.claude.com/docs/id/managed-settings.md#how-claude-code-combines-managed-sources) dan mengabaikan sisanya. Kunci kebijakan adalah kunci pengaturan apa pun selain yang ini dan `wslInheritsWindowsSettings`. Jadi setelah pengaturan yang dikelola server atau kebijakan MDM memberikan kunci kebijakan, file `managed-settings.json` berkontribusi hanya [kunci yang Claude Code baca dari setiap sumber admin](https://code.claude.com/docs/id/managed-settings.md#keys-read-from-every-admin-source). Dengan `"merge"`, setiap sumber admin yang Anda sampaikan berkontribusi kuncinya ke satu kebijakan gabungan. Memerlukan Claude Code v2.1.242 atau lebih baru. Atur `"merge"` hanya di mana setiap sumber [peringkat](https://code.claude.com/docs/id/managed-settings.md#how-claude-code-combines-managed-sources) di bawah yang tertinggi berada di bawah kontrol administrator, karena Claude Code kemudian menambahkan entri dari sumber yang lebih rendah, seperti aturan `permissions.allow`, ke kebijakan. * **Scope**: [`Managed`](#scopes). Claude Code membaca kunci ini dari sumber prioritas tertinggi yang membawa kunci ini atau kunci kebijakan, dan mengabaikan kunci ini di setiap sumber yang peringkatnya lebih rendah, jadi sumber yang lebih rendah tidak dapat memilih dirinya sendiri untuk menggabungkan dengan sumber di atasnya. Baik registri HKCU Windows maupun [pengaturan induk dari host penyematan](https://code.claude.com/docs/id/managed-settings.md#let-an-embedding-host-add-policy) tidak berpartisipasi dalam penggabungan. * **Type**: string, salah satu dari: * `"first-wins"`: sumber prioritas tertinggi yang membawa kunci kebijakan menyediakan kebijakan, dan sumber yang lebih rendah berkontribusi hanya [kunci yang Claude Code baca dari setiap sumber admin](https://code.claude.com/docs/id/managed-settings.md#keys-read-from-every-admin-source) * `"merge"`: setiap sumber admin yang Anda sampaikan berkontribusi kuncinya, digabungkan oleh aturan di bawah * **Default**: `"first-wins"` Sampaikan kunci dalam sumber prioritas tertinggi yang Anda terapkan. Mesin yang tidak pernah menerima pengaturan yang dikelola server memerlukan kunci dalam profil MDM-nya juga, karena Claude Code membaca kunci dari sumber prioritas tertinggi yang membawanya atau kunci kebijakan. File `managed-settings.json` adalah sumber admin dengan peringkat terendah, jadi `"merge"` yang ditetapkan di sana tidak memiliki sumber di bawahnya untuk digabungkan. Dalam pengaturan yang dikelola server, kunci terlihat seperti ini: ```json theme={null} { "managedSourcesBehavior": "merge" } ``` Di bawah `"merge"`, Claude Code menggabungkan setiap kunci berdasarkan jenisnya. Tabel ini memberikan aturan untuk setiap jenis. Baris daftar pembatasan, nilai-diambil-utuh, dan hanya-sumber-tertinggi menyebutkan setiap kunci yang mereka tutupi, dan baris lainnya memberikan contoh: | Jenis kunci | Bagaimana Claude Code menggabungkannya | Kunci | | :- | :- | :- | | Lists | Menggabungkan entri dari setiap sumber | [`permissions.allow`](#permissions-allow), [`sandbox.network.allowedDomains`](#sandbox-network-alloweddomains), dan kunci daftar lainnya | | Locks | Menerapkan nilai paling ketat yang ditetapkan sumber apa pun. Ketika tidak ada sumber yang menetapkan nilai ketat, menerapkan nilai yang lebih longgar hanya dari sumber tertinggi | [`allowManagedPermissionRulesOnly`](#allowmanagedpermissionrulesonly), [`permissions.disableBypassPermissionsMode`](#permissions-disablebypasspermissionsmode), dan kunci boolean atau enum lock lainnya | | Restriction allowlists | Mengambil daftar utuh dari sumber tertinggi yang menetapkannya, tanpa menambahkan entri dari sumber yang lebih rendah. Ketika sumber tertinggi tidak menetapkannya, mengambilnya utuh dari sumber berikutnya ke bawah | [`availableModels`](#availablemodels), [`allowedMcpServers`](#allowedmcpservers), [`allowedProviders`](#allowedproviders), [`strictKnownMarketplaces`](#strictknownmarketplaces), [`allowedChannelPlugins`](#allowedchannelplugins), dan rantai [`fallbackModel`](#fallbackmodel) | | Values taken whole | Mengambil nilai utuh dari sumber tertinggi yang menetapkannya, tanpa menggabungkan entri atau bidang dari sumber yang lebih rendah. Ketika sumber tertinggi tidak menetapkannya, mengambilnya utuh dari sumber berikutnya ke bawah | [`sandbox.credentials.awsPairs`](#sandbox-credentials-awspairs), [`sandbox.ripgrep`](#sandbox-ripgrep) | | Provided MCP servers | Menggabungkan nama server dari setiap sumber. Ketika dua sumber menetapkan nama yang sama, menerapkan entri utuh sumber yang lebih tinggi | [`managedMcpServers`](#managedmcpservers) | | Read from the highest-priority source only | Membaca kunci hanya dari sumber prioritas tertinggi yang membawa kunci kebijakan, jadi nilai sumber yang lebih rendah diabaikan bahkan ketika sumber tertinggi tidak menetapkan apa pun | [`apiKeyHelper`](#apikeyhelper), [`awsAuthRefresh`](#awsauthrefresh), [`awsCredentialExport`](#awscredentialexport), [`gcpAuthRefresh`](#gcpauthrefresh), [`otelHeadersHelper`](#otelheadershelper), `proxyAuthHelper`, [`forceLoginOrgUUID`](#forceloginorguuid), nilai `"claudeai"` dan `"console"` dari [`forceLoginMethod`](#forceloginmethod), [`parentSettingsBehavior`](#parentsettingsbehavior), [`modelPicker`](#modelpicker), [`policyHelper`](#policyhelper), [`permissions.defaultMode`](#permissions-defaultmode) | | `env` | [Menggabungkan per variabel di seluruh sumber admin](https://code.claude.com/docs/id/managed-settings.md#keys-read-from-every-admin-source), di bawah `"first-wins"` dan `"merge"` | [`env`](#env) | | Setiap kunci lainnya | Mengambil nilai dari sumber tertinggi yang menetapkannya | [`cleanupPeriodDays`](#cleanupperioddays), [`model`](#model) | Mengambil `sandbox.credentials.awsPairs` dan `sandbox.ripgrep` utuh memerlukan Claude Code v2.1.257 atau lebih baru. Beberapa kunci menambahkan kondisi yang tidak ditunjukkan tabel: * **[`policyHelper`](#policyhelper)**: Claude Code menghormatinya hanya ketika sumber tertinggi yang membawa kunci kebijakan adalah kebijakan MDM atau file pengaturan terkelola, jadi di bawah pengaturan yang dikelola server tidak berlaku. * **[`modelOverrides`](#modeloverrides)**: berpasangan dengan `availableModels`. Claude Code mengambil `modelOverrides` dari sumber tertinggi yang menetapkannya, kecuali sumber yang lebih tinggi menetapkan `availableModels` tanpa `modelOverrides`. Dalam hal itu, ia mengabaikan `modelOverrides` dari setiap sumber. * **[`forceLoginGatewayUrl`](#forcelogingatewayurl), [`gatewayInternalNetworks`](#gatewayinternalnetworks), dan nilai `"gateway"` dari [`forceLoginMethod`](#forceloginmethod)**: Claude Code tidak pernah membaca salah satu dari mereka dari pengaturan yang dikelola server, jadi nilai di sana tidak berlaku atau menyembunyikan yang ditetapkan dalam kebijakan MDM atau file pengaturan terkelola. Di antara sumber admin di mesin, hanya yang tertinggi-peringkat yang membawa kunci kebijakan yang menyediakannya, terlepas dari apakah pengaturan yang dikelola server juga ada. * **[`allowedProviders`](#allowedproviders)**: setelah aturan tabel, daftar mesin itu sendiri masih membatasi hasilnya, seperti yang dinyatakan catatan Scope entrinya. Untuk mengonfirmasi sumber mana yang digabungkan di mesin, jalankan `/status` dan [baca baris `Setting sources`](https://code.claude.com/docs/id/managed-settings#read-the-source-in-/status). ### `parentSettingsBehavior` Pilih apakah Claude Code menerapkan pengaturan terkelola yang disediakan oleh proses host penyematan, seperti Agent SDK atau ekstensi IDE, ketika tingkat terkelola yang diterapkan admin juga ada. Dengan `"first-wins"`, Claude Code menghapus pengaturan yang disediakan host; dengan `"merge"`, ia menerapkannya di bawah tingkat admin melalui filter hanya-pembatasan. Atur `"merge"` ketika host perlu melewatkan pembatasannya sendiri ke sesi yang diluncurkannya, misalnya Claude Desktop memberikan daftar izin egress gateway. * **Scope**: [`Managed`](#scopes). Claude Code membacanya dari sumber terkelola yang dikontrol admin prioritas tertinggi. * **Type**: string, salah satu dari: * `"first-wins"`: Claude Code menghapus pengaturan yang disediakan host ketika tingkat terkelola yang diterapkan admin ada * `"merge"`: Claude Code menerapkan pengaturan yang disediakan host di bawah tingkat admin melalui filter hanya-pembatasan * **Default**: `"first-wins"` ```json managed-settings.json theme={null} { "parentSettingsBehavior": "merge" } ``` Kunci ini tidak berpengaruh ketika tidak ada tingkat terkelola yang diterapkan admin: pengaturan host kemudian berlaku sebagai satu-satunya tingkat terkelola, masih disaring ke nilai pembatasan. Untuk batasan filter dan bagaimana sumber terkelola berinteraksi, lihat [Pengaturan induk dari host penyematan](https://code.claude.com/docs/id/managed-settings.md#parent-settings-from-embedding-hosts) dan [Batasi pengaturan induk](https://code.claude.com/docs/id/claude-apps-gateway#restrict-parent-settings). ### `policyHelper` Jalankan executable yang Anda terapkan yang menghitung pengaturan terkelola saat startup, sehingga Anda dapat menurunkan kebijakan dari postur perangkat, identitas, atau layanan jarak jauh alih-alih file statis. Claude Code menjalankan helper sebelum menerima prompt pertama dan memperlakukan pengaturan yang dipancarkannya sebagai pengaturan terkelola untuk sesi. * **Scope**: [`Managed`](#scopes). Baca dari plist macOS, registri Windows HKLM, atau file pengaturan terkelola. Claude Code membaca kunci dari sumber terkelola prioritas tertinggi yang membawa [kunci kebijakan](https://code.claude.com/docs/id/managed-settings.md#how-claude-code-combines-managed-sources) dan menjalankan helper hanya ketika sumber itu adalah salah satu dari ketiga itu; ia mengabaikan kunci dalam pengaturan yang dikelola server, registri HKCU, dan pengaturan induk yang disediakan host. * **Type**: object dengan `path`, `timeoutMs`, dan `refreshIntervalMs` * **Default**: unset, jadi tidak ada helper yang berjalan Ketika pengaturan yang dikelola server memberikan kebijakan saat peluncuran, mereka mengambil alih dari sumber helper dan helper tidak berjalan. Jika pengambilan pengaturan yang lebih baru melaporkan pengaturan yang dikelola server dihapus, Claude Code menjalankan helper pada titik itu daripada menunggu peluncuran berikutnya. Outputnya mengatur sisa sesi, dan jalankan yang gagal mengakhiri sesi dengan pesan yang sama seperti [jalankan startup yang gagal](#helper-failures). Contoh ini menjalankan helper dengan timeout 5 detik dan menjalankannya kembali setiap lima menit: ```json managed-settings.json theme={null} { "policyHelper": { "path": "/usr/local/bin/claude-policy", "timeoutMs": 5000, "refreshIntervalMs": 300000 } } ``` #### Tulis output helper Claude Code menjalankan helper tanpa argumen, menetapkan `CLAUDE_CODE_VERSION` dalam lingkungannya, dan membaca amplop JSON dari stdout, dibatasi pada 1 MiB. Letakkan pengaturan di bawah kunci `managedSettings`. Objek pengaturan telanjang tanpa kunci `managedSettings` diuraikan dengan `managedSettings` tidak terdefinisi dan tidak menerapkan apa pun, dan Claude Code melaporkan tidak ada kesalahan: ```json theme={null} { "managedSettings": { "permissions": { "deny": ["Read(//etc/secrets/**)"] } } } ``` Ketika helper memancarkan `managedSettings`, objek itu menjadi satu-satunya sumber pengaturan terkelola untuk jalankan: Claude Code mengabaikan sumber MDM, file, dan HKCU, membaca [kunci lintas-sumber](https://code.claude.com/docs/id/managed-settings.md#keys-read-from-every-admin-source) dari output helper saja, dan tidak pernah menggabungkan [pengaturan induk](https://code.claude.com/docs/id/managed-settings.md#parent-settings-from-embedding-hosts). Pemeriksaan `forceRemoteSettingsRefresh` startup berjalan sebelum helper dan membaca sumber admin apa pun. Helper yang keluar `0` dengan amplop yang menghilangkan `managedSettings` tidak berkontribusi pengaturan terkelola, dan sumber lainnya berlaku seperti biasa. #### Helper failures Jalankan helper gagal ketika: * `path` melanggar aturan dalam [`policyHelper.path`](#policyhelper-path). * Tidak ada file reguler di `path`. Claude Code memeriksa file sebelum memulai helper, dalam anggaran `timeoutMs` yang sama, jadi mount jaringan yang tidak responsif dapat menyebabkan jalankan gagal. * Helper keluar non-zero, masih berjalan ketika `timeoutMs` berlalu, atau tidak dimulai sama sekali, misalnya karena tidak dapat dieksekusi. * Helper menulis lebih dari 1 MiB ke stdout atau stderr. * stdout bukan objek JSON tunggal, atau `managedSettings`-nya memiliki [pelanggaran skema yang tidak dapat diperbaiki Claude Code](https://code.claude.com/docs/id/managed-settings.md#find-entries-claude-code-dropped). Ketika jalankan startup gagal, Claude Code mencetak alasan dan menolak untuk memulai. Setelah keluar non-zero, alasan mencakup stderr helper, atau stdout-nya ketika stderr kosong. Setelah timeout, alasan menyebutkan batas `timeoutMs` dan tidak menyertakan apa pun dari output helper. Penolakan mencakup sesi interaktif, `claude -p`, sesi Agent SDK, [sesi latar belakang](https://code.claude.com/docs/id/agent-view.md), dan sebagian besar subperintah. Penolakan disengaja, jadi helper yang memerlukan ketahanan pemadaman harus melayani dari cache-nya sendiri dan keluar `0`. Ketika penyegaran latar belakang gagal, Claude Code menjaga kebijakan terakhir yang berhasil berlaku, dan `/status` menunjukkan penyegaran yang gagal dengan alasannya hingga penyegaran berhasil. Setiap penyegaran berjalan di bawah `timeoutMs` dan aturan kegagalan yang sama seperti jalankan startup. Dengan `--debug`, Claude Code menulis stderr helper dari setiap jalankan ke [log debug](https://code.claude.com/docs/id/debug-your-config.md). Claude Code melaporkan nilai `policyHelper` yang tidak valid sebagai [entri yang dijatuhkan](https://code.claude.com/docs/id/managed-settings.md#find-entries-claude-code-dropped) dan memulai sesi pada pengaturan terkelola yang tersisa tanpa menjalankan helper. Nilai yang tidak valid mencakup string path telanjang dan `timeoutMs` di bawah [minimumnya](#policyhelper-timeoutms). Untuk mematikan helper, hapus kunci dari sumber yang menetapkannya. ### `policyHelper.path` Beri nama executable helper yang Claude Code jalankan. Untuk apa yang terjadi ketika path melanggar aturan di bawah, lihat [Helper failures](#helper-failures). * **Scope**: [`Managed`](#scopes). Baca dari plist macOS, registri Windows HKLM, atau file pengaturan terkelola, di mana pun [`policyHelper`](#policyhelper) dibaca. * **Type**: string, jalur absolut dalam bentuk ternormalisasi, tanpa segmen `.` atau `..`; di Windows, jalur huruf drive atau UNC yang berakhir dengan `.exe` * **Default**: none; diperlukan ketika `policyHelper` diatur ```json managed-settings.json theme={null} { "policyHelper": { "path": "/usr/local/bin/claude-policy" } } ``` ### `policyHelper.timeoutMs` Atur berapa lama Claude Code menunggu helper sebelum memperlakukan jalankan sebagai gagal. Jalankan yang timeout gagal dengan cara yang sama seperti keluar non-zero, jadi saat startup Claude Code menolak untuk memulai. * **Scope**: [`Managed`](#scopes). Baca dari plist macOS, registri Windows HKLM, atau file pengaturan terkelola, di mana pun [`policyHelper`](#policyhelper) dibaca. * **Type**: integer, milliseconds, minimum `1000` * **Default**: `10000` ```json managed-settings.json theme={null} { "policyHelper": { "path": "/usr/local/bin/claude-policy", "timeoutMs": 5000 } } ``` ### `policyHelper.refreshIntervalMs` Buat Claude Code menjalankan kembali helper di latar belakang pada interval sehingga perubahan kebijakan mencapai sesi yang berjalan. Ketika penyegaran berhasil, outputnya menggantikan pengaturan terkelola sebelumnya tanpa restart; ketika penyegaran gagal, Claude Code menjaga kebijakan yang sudah dimilikinya. * **Scope**: [`Managed`](#scopes). Baca dari plist macOS, registri Windows HKLM, atau file pengaturan terkelola, di mana pun [`policyHelper`](#policyhelper) dibaca. * **Type**: integer, milliseconds: `0` untuk menonaktifkan penyegaran, jika tidak setidaknya `60000` * **Default**: unset, jadi Claude Code menjalankan helper sekali saat startup Contoh ini menjalankan kembali helper setiap lima menit: ```json managed-settings.json theme={null} { "policyHelper": { "path": "/usr/local/bin/claude-policy", "refreshIntervalMs": 300000 } } ``` ### `wslInheritsWindowsSettings` Buat Claude Code di WSL membaca pengaturan terkelola dari rantai kebijakan Windows, dengan HKLM dan file pengaturan terkelola Windows mengambil prioritas atas `/etc/claude-code` dan HKCU di bawahnya. Sementara rantai aktif, Claude Code membaca `/etc/claude-code` hanya ketika [tidak ada dokumen admin Windows yang ada](https://code.claude.com/docs/id/managed-settings.md#present-admin-documents) dalam nilai registri HKLM atau folder `C:\Program Files\ClaudeCode\`. Atur untuk memperluas kebijakan yang sudah Anda terapkan di Windows ke sesi WSL di mesin yang sama, sehingga mereka mengikuti aturan yang sama seperti sesi host. Claude Code menghormatinya hanya ketika diatur dalam kunci registri HKLM atau dalam file pengaturan terkelola atau drop-in di bawah `C:\Program Files\ClaudeCode\`, keduanya memerlukan admin Windows untuk menulis. * **Scope**: [`Managed`](#scopes). Dalam sumber Windows yang dikontrol admin. * **Type**: Boolean * `true`: Claude Code di WSL membaca pengaturan terkelola dari rantai kebijakan Windows, dan membaca `/etc/claude-code` hanya ketika tidak ada dokumen admin Windows yang ada * `false`: WSL membaca hanya `/etc/claude-code` * **Default**: `false`, jadi WSL membaca hanya `/etc/claude-code` ```json managed-settings.json theme={null} { "wslInheritsWindowsSettings": true } ``` Setelah sumber admin mengaktifkan rantai, kebijakan HKCU bergabung dengannya di WSL hanya ketika HKCU juga menetapkan kunci ke `true`. Salinan itu tidak mengaktifkan rantai dengan sendirinya. Sumber Windows yang hanya berisi kunci ini tidak dihitung sebagai sumber kebijakan, jadi sumber prioritas yang lebih rendah masih menyediakan kebijakan. Kunci ini tidak berpengaruh pada Windows asli. Claude Code membaca `true` dan `false` dengan atau tanpa tanda kutip dan membaca `null` sebagai menghapus kunci. Sumber Windows yang dikontrol admin yang menyimpan nilai apa pun yang lain dihitung sebagai [dokumen admin yang ada](https://code.claude.com/docs/id/managed-settings.md#present-admin-documents) dengan rantai diaktifkan: baik `/etc/claude-code` maupun HKCU tidak berlaku, dan peringatan startup menyebutkan kunci. Nilai HKLM atau file folder Windows yang ada tetapi tidak dapat dibaca juga menjaga `/etc/claude-code` dari berlaku terlepas dari apakah rantai aktif. Memerlukan Claude Code v2.1.282 atau lebih baru. ## Pengaturan konfigurasi global Simpan kunci-kunci ini di `~/.claude.json`, bukan di file pengaturan. Claude Code mengabaikannya di tempat lain. Claude Code dan `/config` menulis sebagian besar dari mereka untuk Anda, dan Anda juga dapat mengeditnya secara manual. ### `autoConnectIde` Terhubung ke IDE yang sedang berjalan secara otomatis saat Anda memulai Claude Code dari terminal eksternal. Muncul di `/config` sebagai **Auto-connect to IDE (external terminal)** saat Anda menjalankan Claude Code di luar terminal VS Code atau JetBrains. * **Scope**: [`Global config`](#scopes) * **Type**: Boolean * `true`: Claude Code terhubung ke IDE yang sedang berjalan secara otomatis saat Anda memulainya dari terminal eksternal * `false`: Claude Code tidak terhubung secara otomatis dari terminal eksternal; di dalam terminal VS Code atau JetBrains, atau dengan `--ide`, tetap terhubung * **Default**: `false` * **Per-session overrides**: [`CLAUDE_CODE_AUTO_CONNECT_IDE`](https://code.claude.com/docs/id/env-vars) mengambil alih kunci ini untuk satu sesi, dalam kedua arah ```json ~/.claude.json theme={null} { "autoConnectIde": true } ``` Claude Code mengabaikan kunci ini di `settings.json`. ### `autoInstallIdeExtension` Instal ekstensi IDE Claude Code secara otomatis saat Anda menjalankan Claude Code dari terminal VS Code. Muncul di `/config` sebagai **Auto-install IDE extension** saat Anda menjalankan Claude Code di dalam terminal VS Code atau JetBrains. * **Scope**: [`Global config`](#scopes) * **Type**: Boolean * `true`: Claude Code menginstal ekstensi IDE secara otomatis saat Anda menjalankannya dari terminal VS Code * `false`: Claude Code tidak menginstal ekstensi secara otomatis * **Default**: `true` * **Per-session overrides**: [`CLAUDE_CODE_IDE_SKIP_AUTO_INSTALL`](https://code.claude.com/docs/id/env-vars) diatur ke `1` melewati instalasi untuk satu sesi bahkan ketika kunci ini adalah `true` ```json ~/.claude.json theme={null} { "autoInstallIdeExtension": false } ``` Claude Code mengabaikan kunci ini di `settings.json`. ### `claudeInChromeDefaultEnabled` Mulai setiap sesi CLI interaktif dengan [integrasi Chrome](https://code.claude.com/docs/id/chrome.md) aktif, tanpa harus melewatkan `--chrome` setiap kali. Jika Anda menjalankan [`claude remote-control`](https://code.claude.com/docs/id/remote-control), sesi yang dimulainya untuk salah satu thread [project](https://code.claude.com/docs/id/claude-projects.md) Anda mengikuti kunci ini juga, kecuali dalam mode `bypassPermissions`. Dengan Claude Code v2.1.287 atau yang lebih baru, kunci ini juga berlaku untuk sesi di [ekstensi VS Code](https://code.claude.com/docs/id/vs-code.md#automate-browser-tasks-with-chrome): lihat [Enable Chrome by default](https://code.claude.com/docs/id/chrome.md#enable-chrome-by-default). Menjalankan `/chrome` dan memilih **Enabled by default** mengatur kunci ini untuk Anda. Muncul di `/config` sebagai **Claude in Chrome enabled by default**. * **Scope**: [`Global config`](#scopes) * **Type**: Boolean * `true`: Claude Code menghidupkan integrasi Chrome saat sesi CLI interaktif dimulai, seperti yang dilakukannya saat Anda melewatkan `--chrome`. Di ekstensi VS Code, sesi terhubung ke browser saat dimulai * `false`: sesi CLI interaktif dimulai dengan integrasi Chrome mati, dan Claude Code berhenti [menawarkan untuk mengaturnya](https://code.claude.com/docs/id/chrome.md#install-the-extension-when-claude-asks). Lewatkan `--chrome` untuk menghidupkannya untuk satu sesi interaktif. Di ekstensi VS Code, sesi terhubung saat Anda mengetik `@browser`, seperti saat kunci ini tidak diatur * **Default**: unset, jadi integrasi Chrome mati dan Claude Code masih dapat menawarkan untuk mengaturnya * **Per-session overrides**: `--chrome` dan [`--no-chrome`](https://code.claude.com/docs/id/cli-reference) mengambil alih kunci ini untuk satu sesi interaktif ```json ~/.claude.json theme={null} { "claudeInChromeDefaultEnabled": true } ``` Claude Code mengabaikan kunci ini di `settings.json`. ### `copyFullResponse` Buat [`/copy`](https://code.claude.com/docs/id/commands) menyalin respons penuh setiap kali, tanpa menampilkan picker. Memilih **Always copy full response** di picker tersebut mengatur kunci ini ke `true`. Muncul di `/config` sebagai **Skip the /copy picker**. * **Scope**: [`Global config`](#scopes) * **Type**: Boolean * `true`: `/copy` menyalin respons penuh tanpa menampilkan picker * `false`: saat respons berisi blok kode atau blockquote, `/copy` menampilkan picker di mana Anda memilih satu blok atau respons penuh * **Default**: `false` ```json ~/.claude.json theme={null} { "copyFullResponse": true } ``` Claude Code mengabaikan kunci ini di `settings.json`. ### `copyOnSelect` Salin teks ke clipboard Anda secara otomatis saat Anda selesai memilihnya dengan mouse di [fullscreen rendering](https://code.claude.com/docs/id/fullscreen.md#use-the-mouse) atau [agent view](https://code.claude.com/docs/id/agent-view.md). Muncul di `/config` sebagai **Copy on select** saat fullscreen rendering aktif. * **Scope**: [`Global config`](#scopes) * **Type**: Boolean * `true`: Claude Code menyalin teks ke clipboard Anda saat Anda selesai memilihnya * `false`: memilih teks membiarkan clipboard Anda tidak berubah, dan Anda [menyalin pilihan dengan pintasan keyboard](https://code.claude.com/docs/id/fullscreen.md#use-the-mouse) sebagai gantinya * **Default**: `true` ```json ~/.claude.json theme={null} { "copyOnSelect": false } ``` Claude Code mengabaikan kunci ini di `settings.json`. ### `defaultToAgentsView` Buka [agent view](https://code.claude.com/docs/id/agent-view.md) alih-alih percakapan baru saat Anda menjalankan `claude` tanpa argumen. Muncul di `/config` sebagai **Open agents view by default** kecuali agent view [dimatikan](#disableagentview). * **Scope**: [`Global config`](#scopes) * **Type**: Boolean * `true`: `claude` tanpa argumen membuka agent view, kecuali agent view [dimatikan](#disableagentview) * `false`: `claude` tanpa argumen memulai percakapan baru * **Default**: `false` ```json ~/.claude.json theme={null} { "defaultToAgentsView": true } ``` Claude Code mengabaikan kunci ini di `settings.json`. ### `diffTool` Pilih di mana Claude Code menampilkan diff dari perubahan `Edit` atau `Write` yang diusulkannya saat [VS Code](https://code.claude.com/docs/id/vs-code.md) atau [JetBrains](https://code.claude.com/docs/id/jetbrains.md#features) IDE terhubung: `"auto"` membukanya di diff viewer IDE, `"terminal"` menyimpannya di terminal. Muncul di `/config` sebagai **Diff tool** hanya saat Claude Code terhubung ke VS Code atau JetBrains IDE. * **Scope**: [`Global config`](#scopes) * **Type**: string, salah satu dari: * `"auto"`: Claude Code membuka diff di diff viewer IDE saat VS Code atau JetBrains IDE terhubung * `"terminal"`: Claude Code menyimpan diff di terminal * **Default**: `"auto"` ```json ~/.claude.json theme={null} { "diffTool": "terminal" } ``` Claude Code mengabaikan kunci ini di `settings.json`. ### `externalEditorContext` Saat Anda menekan `Ctrl+G`, Claude Code membuka prompt yang Anda ketik di [external editor](https://code.claude.com/docs/id/interactive-mode.md#general-controls) Anda. Dengan kunci ini aktif, buffer editor dimulai dengan respons sebelumnya Claude sebagai baris komentar `#`, sehingga Anda dapat membacanya saat Anda menulis, dan Claude Code menghapus baris-baris tersebut saat Anda menyimpan. Muncul di `/config` sebagai **Show last response in external editor**. * **Scope**: [`Global config`](#scopes) * **Type**: Boolean * `true`: buffer editor dimulai dengan respons sebelumnya Claude sebagai baris komentar `#`, yang Claude Code hapus saat Anda menyimpan * `false`: buffer editor dibuka hanya dengan prompt Anda * **Default**: `false` ```json ~/.claude.json theme={null} { "externalEditorContext": true } ``` Dengan aktif, buffer yang Claude Code buka terlihat seperti ini, dan hanya teks di bawah garis penanda yang dikirim sebagai prompt Anda: ```text theme={null} # ─── Claude's last response (for reference; removed on save) ─── # I added the retry loop to fetchUser in src/api.ts and a test # for the timeout case. Want me to wire the same retry into # fetchOrders? # ─── Write your reply below this line ────────────────────────── Yes, and cap it at three attempts. ``` Claude Code menyimpan 50 baris terakhir dari respons dan menandai potongan dengan `# … (earlier output truncated)`. Claude Code mengabaikan kunci ini di `settings.json`. ### `leftArrowOpensAgents` Tekan `←` pada prompt kosong untuk [menempatkan sesi di latar belakang dan membuka agent view](https://code.claude.com/docs/id/agent-view.md#switch-sessions-without-leaving-the-terminal). Atur kunci ini ke `false` untuk mematikan pintasan. Muncul di `/config` sebagai **← opens agents** saat agent view tersedia. * **Scope**: [`Global config`](#scopes) * **Type**: Boolean * `true`: menekan `←` pada prompt kosong dalam sesi yang Anda mulai di terminal menempatkannya di latar belakang dan membuka agent view * `false`: Claude Code mematikan pintasan; dalam sesi yang Anda [lampirkan dari agent view](https://code.claude.com/docs/id/agent-view.md#attach-to-a-session), `←` pada prompt kosong masih melepaskan * **Default**: `true` ```json ~/.claude.json theme={null} { "leftArrowOpensAgents": false } ``` Claude Code mengabaikan kunci ini di `settings.json`. ### `permissionExplainerEnabled` > [!WARNING] > > Dihapus di v2.1.257, bersama dengan penjelasan perintah `Ctrl+E` pada prompt izin Bash dan PowerShell. Mengaturnya tidak berpengaruh pada versi saat ini. Melalui v2.1.256, Anda dapat menekan `Ctrl+E` pada prompt izin Bash atau PowerShell untuk melihat penjelasan perintah yang dihasilkan model, dan atur kunci ini ke `false` untuk mematikan pintasan tersebut. * **Scope**: [`Global config`](#scopes). Pada v2.1.256 dan lebih awal. * **Type**: Boolean * **Default**: `true` ### `prStatusFooterEnabled` Tampilkan lencana di footer prompt untuk pull request atau merge request terbuka dari cabang saat ini, dengan garis bawah berwarna yang menunjukkan [statusnya](https://code.claude.com/docs/id/interactive-mode.md#pr-review-status). Muncul di `/config` sebagai **Show PR status footer**. * **Scope**: [`Global config`](#scopes) * **Type**: Boolean * `true`: footer menampilkan lencana di bawah kondisi dalam [PR review status](https://code.claude.com/docs/id/interactive-mode.md#pr-review-status) * `false`: Claude Code melewati pemeriksaan pull request dan merge request footer dan tidak menampilkan lencana tersebut. Sesi yang Anda [lampirkan dari agent view](https://code.claude.com/docs/id/agent-view.md#attach-to-a-session) masih dapat menampilkan tautan biasa ke pull request [yang ditautkan ke sana](https://code.claude.com/docs/id/agent-view.md#pull-request-status) * **Default**: `true` ```json ~/.claude.json theme={null} { "prStatusFooterEnabled": false } ``` Claude Code mengabaikan kunci ini di `settings.json`. ### `teammateDefaultModel` > [!WARNING] > > Dihapus di v2.1.234, bersama dengan baris `/config` **Default teammate model**. Mengaturnya tidak berpengaruh pada versi saat ini. Melalui v2.1.233, Anda mengatur kunci ini ke model untuk rekan tim [agent team](https://code.claude.com/docs/id/agent-teams.md#specify-teammates-and-models) yang prompt Anda tidak menamai model untuk: alias seperti `"sonnet"`, atau `null` untuk mengikuti model lead. Untuk model yang Claude Code pilih untuk rekan tim seperti itu sekarang, lihat [specify teammates and models](https://code.claude.com/docs/id/agent-teams.md#specify-teammates-and-models). * **Scope**: [`Global config`](#scopes). Pada v2.1.233 dan lebih awal. * **Type**: string, alias model atau ID model lengkap, atau `null` * **Default**: unset ## Lihat juga * [Konfigurasi izin](https://code.claude.com/docs/id/permissions.md): sintaks aturan, mode izin, dan kepercayaan ruang kerja * [Variabel lingkungan](https://code.claude.com/docs/id/env-vars.md): setiap `CLAUDE_*`, `ANTHROPIC_*`, dan variabel penyedia yang dibaca Claude Code * [Alat yang tersedia untuk Claude](https://code.claude.com/docs/id/tools-reference.md): alat bawaan dan mana yang memerlukan persetujuan * [Contoh file pengaturan](https://code.claude.com/docs/id/settings-example.md): file pribadi, file tim, dan file terkelola organisasi * [Siapkan pengaturan terkelola](https://code.claude.com/docs/id/admin-setup.md): bagaimana organisasi memutuskan apa yang akan diterapkan * [Terapkan pengaturan terkelola](https://code.claude.com/docs/id/managed-settings.md): mekanisme pengiriman, prioritas dalam tingkat terkelola, dan entri tidak valid dalam pengaturan terkelola * [Debug konfigurasi Anda](https://code.claude.com/docs/id/debug-your-config.md): `claude doctor` dan dialog Kesalahan Pengaturan