Documentation 2026-09-23 23:57 UTC to 2026-09-24 22:57 UTC

403 403 

404Proses latar belakang ini mengonsumsi sejumlah kecil token (biasanya di bawah \$0,04 per sesi) bahkan tanpa interaksi aktif.404Proses latar belakang ini mengonsumsi sejumlah kecil token (biasanya di bawah \$0,04 per sesi) bahkan tanpa interaksi aktif.

405 405 

406Ketika saran prompt aktif, Claude Code juga mengirimkan permintaan singkat ke model yang digunakan sesi Anda setelah Claude merespons, untuk [menyarankan prompt berikutnya Anda](/docs/id/interactive-mode#prompt-suggestions). Permintaan tersebut menggunakan kembali prompt cache percakapan, sehingga sebagian besar merupakan pembacaan cache ditambah beberapa token output. Claude Code [melewatkannya saat akun Anda mendekati atau mencapai batas penggunaan](/docs/id/interactive-mode#when-claude-code-skips-suggestions). Untuk menghentikan permintaan ini, [matikan saran prompt](/docs/id/interactive-mode#turn-prompt-suggestions-off).

407 

406<h2 id="why-usage-climbs-in-a-long-session">408<h2 id="why-usage-climbs-in-a-long-session">

407 Mengapa penggunaan meningkat dalam sesi yang panjang409 Mengapa penggunaan meningkat dalam sesi yang panjang

408</h2>410</h2>

272| `CLAUDE_CODE_DISABLE_PERMISSION_PROMPT_NOTIFY_HOOKS` | Atur ke `1` untuk menghentikan Claude Code dari menjalankan [hook `Notification` Anda untuk permintaan izin yang belum dijawab](/docs/id/hooks#notification) di sesi di mana Claude Code mengirimnya ke callback `canUseTool` Agent SDK, yang merupakan cara Claude Desktop dan ekstensi VS Code menampilkan Claude Code. Tidak berpengaruh di sesi terminal. Memerlukan Claude Code v2.1.233 atau lebih baru |272| `CLAUDE_CODE_DISABLE_PERMISSION_PROMPT_NOTIFY_HOOKS` | Atur ke `1` untuk menghentikan Claude Code dari menjalankan [hook `Notification` Anda untuk permintaan izin yang belum dijawab](/docs/id/hooks#notification) di sesi di mana Claude Code mengirimnya ke callback `canUseTool` Agent SDK, yang merupakan cara Claude Desktop dan ekstensi VS Code menampilkan Claude Code. Tidak berpengaruh di sesi terminal. Memerlukan Claude Code v2.1.233 atau lebih baru |

273| `CLAUDE_CODE_DISABLE_POLICY_SKILLS` | Atur ke `1` untuk melewati pemuatan skills dari direktori skills yang dikelola di seluruh sistem. Berguna untuk sesi container atau CI yang tidak boleh memuat skills yang disediakan operator |273| `CLAUDE_CODE_DISABLE_POLICY_SKILLS` | Atur ke `1` untuk melewati pemuatan skills dari direktori skills yang dikelola di seluruh sistem. Berguna untuk sesi container atau CI yang tidak boleh memuat skills yang disediakan operator |

274| `CLAUDE_CODE_DISABLE_TERMINAL_TITLE` | Atur ke `1` untuk menonaktifkan pembaruan judul terminal otomatis berdasarkan konteks percakapan. Ini juga melewati permintaan model kecil/cepat latar belakang yang [menghasilkan judul sesi](/docs/id/sessions#name-your-sessions) |274| `CLAUDE_CODE_DISABLE_TERMINAL_TITLE` | Atur ke `1` untuk menonaktifkan pembaruan judul terminal otomatis berdasarkan konteks percakapan. Ini juga melewati permintaan model kecil/cepat latar belakang yang [menghasilkan judul sesi](/docs/id/sessions#name-your-sessions) |

275| `CLAUDE_CODE_DISABLE_THINKING` | Atur ke `1` untuk menghilangkan parameter `thinking` dari permintaan API sepenuhnya. Ini adalah opsi kompatibilitas untuk proxy dan gateway yang menolak parameter. Di model yang berpikir secara default, menghilangkan parameter berarti model mungkin masih berpikir. Untuk secara eksplisit menonaktifkan [pemikiran yang diperpanjang](https://platform.claude.com/docs/en/build-with-claude/extended-thinking) di API Anthropic, gunakan `MAX_THINKING_TOKENS=0` sebagai gantinya. Tidak ada variabel yang menonaktifkan pemikiran di model Fable, yang tidak dapat memiliki pemikiran dinonaktifkan. Di [penyedia pihak ketiga](/docs/id/third-party-integrations), `MAX_THINKING_TOKENS=0` demikian pula menghilangkan parameter, jadi kedua variabel berperilaku sama di sana |275| `CLAUDE_CODE_DISABLE_THINKING` | Atur ke `1` untuk menghilangkan parameter `thinking` dari permintaan API sepenuhnya. Ini adalah opsi kompatibilitas untuk proxy dan gateway yang menolak parameter. Di model yang berpikir secara default, menghilangkan parameter berarti model mungkin masih berpikir. Untuk secara eksplisit menonaktifkan [pemikiran yang diperpanjang](https://platform.claude.com/docs/en/build-with-claude/extended-thinking) di API Anthropic, gunakan `MAX_THINKING_TOKENS=0` sebagai gantinya. Tidak ada variabel yang menonaktifkan pemikiran di Opus 5.5 atau model Fable, yang tidak dapat memiliki pemikiran dinonaktifkan. Di [penyedia pihak ketiga](/docs/id/third-party-integrations), `MAX_THINKING_TOKENS=0` demikian pula menghilangkan parameter, jadi kedua variabel berperilaku sama di sana |

276| `CLAUDE_CODE_DISABLE_UNKNOWN_MODEL_WINDOW_ENFORCEMENT` | Atur ke `1` untuk melewati [auto-compaction](/docs/id/costs#reduce-token-usage) proaktif ketika Claude Code tidak mengenali ID model, seperti alias [gateway LLM](/docs/id/llm-gateway). Tanpa variabel ini, Claude Code compact pada jendela konteks yang diasumsikan untuk ID. `CLAUDE_CODE_MAX_CONTEXT_TOKENS` dapat mengoreksi jendela yang diasumsikan sebagai gantinya; lihat [Koreksi jendela untuk ID model gateway atau khusus](/docs/id/model-config#correct-the-window-for-a-gateway-or-custom-model-id) untuk kapan setiap variabel berlaku. Memerlukan Claude Code v2.1.223 atau lebih baru |276| `CLAUDE_CODE_DISABLE_UNKNOWN_MODEL_WINDOW_ENFORCEMENT` | Atur ke `1` untuk melewati [auto-compaction](/docs/id/costs#reduce-token-usage) proaktif ketika Claude Code tidak mengenali ID model, seperti alias [gateway LLM](/docs/id/llm-gateway). Tanpa variabel ini, Claude Code compact pada jendela konteks yang diasumsikan untuk ID. `CLAUDE_CODE_MAX_CONTEXT_TOKENS` dapat mengoreksi jendela yang diasumsikan sebagai gantinya; lihat [Koreksi jendela untuk ID model gateway atau khusus](/docs/id/model-config#correct-the-window-for-a-gateway-or-custom-model-id) untuk kapan setiap variabel berlaku. Memerlukan Claude Code v2.1.223 atau lebih baru |

277| `CLAUDE_CODE_DISABLE_VIRTUAL_SCROLL` | Atur ke `1` untuk menonaktifkan pengguliran virtual dalam [rendering fullscreen](/docs/id/fullscreen) dan merender setiap pesan dalam transkrip. Gunakan ini jika pengguliran dalam mode fullscreen menampilkan wilayah kosong di mana pesan harus muncul |277| `CLAUDE_CODE_DISABLE_VIRTUAL_SCROLL` | Atur ke `1` untuk menonaktifkan pengguliran virtual dalam [rendering fullscreen](/docs/id/fullscreen) dan merender setiap pesan dalam transkrip. Gunakan ini jika pengguliran dalam mode fullscreen menampilkan wilayah kosong di mana pesan harus muncul |

278| `CLAUDE_CODE_DISABLE_WINDOWS_SHELL_LAUNCHER` | Atur ke `1` untuk memulai perintah [alat PowerShell](/docs/id/tools-reference#powershell-tool) di Windows secara langsung daripada melalui peluncur `cmd.exe`. Secara default, peluncur memungkinkan perintah PowerShell [berjalan di latar belakang](/docs/id/tools-reference#background-commands) [membawa ke proses sesi berikutnya](/docs/id/agent-view#the-supervisor-process), seperti ketika Anda [menempatkan sesi di latar belakang](/docs/id/agent-view#from-inside-a-session). Jika Anda menetapkan variabel, perintah PowerShell yang dilatarbelakangkan berhenti ketika proses sesi keluar. Perintah Bash tidak terpengaruh. Memerlukan Claude Code v2.1.269 atau lebih baru |278| `CLAUDE_CODE_DISABLE_WINDOWS_SHELL_LAUNCHER` | Atur ke `1` untuk memulai perintah [alat PowerShell](/docs/id/tools-reference#powershell-tool) di Windows secara langsung daripada melalui peluncur `cmd.exe`. Secara default, peluncur memungkinkan perintah PowerShell [berjalan di latar belakang](/docs/id/tools-reference#background-commands) [membawa ke proses sesi berikutnya](/docs/id/agent-view#the-supervisor-process), seperti ketika Anda [menempatkan sesi di latar belakang](/docs/id/agent-view#from-inside-a-session). Jika Anda menetapkan variabel, perintah PowerShell yang dilatarbelakangkan berhenti ketika proses sesi keluar. Perintah Bash tidak terpengaruh. Memerlukan Claude Code v2.1.269 atau lebih baru |

461| `IS_DEMO` | Atur ke nilai apa pun yang tidak kosong, seperti `1`, untuk mengaktifkan mode demo: menyembunyikan email dan nama organisasi Anda dari header dan output `/status`, dan melewati onboarding. **Menetapkannya ke `0` atau `false` masih mengaktifkan mode demo**, tidak seperti sebagian besar variabel aktif/mati; batalkan penetapan variabel untuk menonaktifkannya. Berguna saat streaming atau merekam sesi |461| `IS_DEMO` | Atur ke nilai apa pun yang tidak kosong, seperti `1`, untuk mengaktifkan mode demo: menyembunyikan email dan nama organisasi Anda dari header dan output `/status`, dan melewati onboarding. **Menetapkannya ke `0` atau `false` masih mengaktifkan mode demo**, tidak seperti sebagian besar variabel aktif/mati; batalkan penetapan variabel untuk menonaktifkannya. Berguna saat streaming atau merekam sesi |

462| `MAX_MCP_OUTPUT_TOKENS` | Jumlah maksimum token yang diizinkan dalam respons alat MCP. Claude Code menampilkan peringatan ketika output melebihi 10.000 token. Alat yang mendeklarasikan [`anthropic/maxResultSizeChars`](/docs/id/mcp#raise-the-limit-for-a-specific-tool) menggunakan batas karakter itu untuk konten teks sebagai gantinya, tetapi konten gambar dari alat itu masih tunduk pada variabel ini (default: 25000) |462| `MAX_MCP_OUTPUT_TOKENS` | Jumlah maksimum token yang diizinkan dalam respons alat MCP. Claude Code menampilkan peringatan ketika output melebihi 10.000 token. Alat yang mendeklarasikan [`anthropic/maxResultSizeChars`](/docs/id/mcp#raise-the-limit-for-a-specific-tool) menggunakan batas karakter itu untuk konten teks sebagai gantinya, tetapi konten gambar dari alat itu masih tunduk pada variabel ini (default: 25000) |

463| `MAX_STRUCTURED_OUTPUT_RETRIES` | Jumlah upaya yang Claude Code izinkan ketika respons model gagal validasi terhadap [`--json-schema`](/docs/id/cli-reference#cli-flags) dalam mode non-interaktif dengan flag `-p`; setelah banyak upaya gagal tanpa output yang valid, jalankan gagal. Batas yang sama berlaku ketika output terstruktur subagent [alur kerja](/docs/id/workflows) gagal validasi. Default ke 5, upaya pertama ditambah empat percobaan ulang |463| `MAX_STRUCTURED_OUTPUT_RETRIES` | Jumlah upaya yang Claude Code izinkan ketika respons model gagal validasi terhadap [`--json-schema`](/docs/id/cli-reference#cli-flags) dalam mode non-interaktif dengan flag `-p`; setelah banyak upaya gagal tanpa output yang valid, jalankan gagal. Batas yang sama berlaku ketika output terstruktur subagent [alur kerja](/docs/id/workflows) gagal validasi. Default ke 5, upaya pertama ditambah empat percobaan ulang |

464| `MAX_THINKING_TOKENS` | Anggaran token tetap untuk [pemikiran yang diperpanjang](https://platform.claude.com/docs/en/build-with-claude/extended-thinking). Claude Code membatasinya pada satu token di bawah token output maksimum permintaan dan tidak pernah di bawah 1.024. Lihat `CLAUDE_CODE_MAX_OUTPUT_TOKENS` untuk cara batas itu ditetapkan. Ketika tidak diatur dan pemikiran diaktifkan, model dengan [penalaran adaptif](/docs/id/model-config#adjust-effort-level) memilih kedalaman pemikiran mereka sendiri, dan model lain menggunakan batas. Atur ke `0` untuk menonaktifkan pemikiran di API Anthropic, kecuali di model Fable, yang tidak dapat memiliki pemikiran dinonaktifkan. Di [penyedia pihak ketiga](/docs/id/third-party-integrations), `0` menghilangkan parameter `thinking` sebagai gantinya. Dengan pemikiran dinonaktifkan di API Anthropic, Claude Code mengirim effort `high` daripada level yang lebih tinggi ke model yang diketahuinya [tidak menerima kombinasi itu](/docs/id/errors#effort-isnt-available-with-thinking-turned-off), seperti Opus 5. Claude Code mengabaikan nilai nonzero di model penalaran adaptif, kecuali di model di mana `CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING` menonaktifkan penalaran adaptif |464| `MAX_THINKING_TOKENS` | Anggaran token tetap untuk [pemikiran yang diperpanjang](https://platform.claude.com/docs/en/build-with-claude/extended-thinking). Claude Code membatasinya pada satu token di bawah token output maksimum permintaan dan tidak pernah di bawah 1.024. Lihat `CLAUDE_CODE_MAX_OUTPUT_TOKENS` untuk cara batas itu ditetapkan. Ketika tidak diatur dan pemikiran diaktifkan, model dengan [penalaran adaptif](/docs/id/model-config#adjust-effort-level) memilih kedalaman pemikiran mereka sendiri, dan model lain menggunakan batas. Atur ke `0` untuk menonaktifkan pemikiran di API Anthropic, kecuali di Opus 5.5 dan model Fable, yang tidak dapat memiliki pemikiran dinonaktifkan. Di [penyedia pihak ketiga](/docs/id/third-party-integrations), `0` menghilangkan parameter `thinking` sebagai gantinya. Dengan pemikiran dinonaktifkan di API Anthropic, Claude Code mengirim effort `high` daripada level yang lebih tinggi ke model yang diketahuinya [tidak menerima kombinasi itu](/docs/id/errors#effort-isnt-available-with-thinking-turned-off), seperti Opus 5. Claude Code mengabaikan nilai nonzero di model penalaran adaptif, kecuali di model di mana `CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING` menonaktifkan penalaran adaptif |

465| `MCP_CLIENT_SECRET` | Rahasia klien OAuth untuk server MCP yang memerlukan [kredensial yang dikonfigurasi sebelumnya](/docs/id/mcp#use-pre-configured-oauth-credentials). Menghindari prompt interaktif saat menambahkan server dengan `--client-secret` |465| `MCP_CLIENT_SECRET` | Rahasia klien OAuth untuk server MCP yang memerlukan [kredensial yang dikonfigurasi sebelumnya](/docs/id/mcp#use-pre-configured-oauth-credentials). Menghindari prompt interaktif saat menambahkan server dengan `--client-secret` |

466| `MCP_CONNECTION_NONBLOCKING` | Mengontrol apakah startup menunggu server MCP terhubung sebelum kueri pertama. Startup MCP non-blocking secara default: server terhubung di latar belakang dan alat mereka menjadi tersedia saat mereka selesai. Atur ke `0` untuk membuat Claude Code menunggu server terhubung sebelum kueri pertama. Server yang dikonfigurasi dengan [`alwaysLoad: true`](/docs/id/mcp#exempt-a-server-from-deferral) masih membuat startup menunggu terlepas dari itu, kecuali ketika dilayani dari [cache penemuan](/docs/id/mcp#server-status-detail), karena alat mereka harus ada ketika prompt pertama dibangun. Dalam mode non-interaktif (`-p`) tanpa `--input-format stream-json`, Claude Code juga menunggu server yang masih tertunda sebelum giliran pertama terlepas dari variabel ini. Ketika Anda meneruskan [`--mcp-config`](/docs/id/cli-reference#cli-flags) secara eksplisit, tunggu memiliki tenggat waktu yang lebih lama; lihat entri flag itu untuk pengecualian server yang di-cache |466| `MCP_CONNECTION_NONBLOCKING` | Mengontrol apakah startup menunggu server MCP terhubung sebelum kueri pertama. Startup MCP non-blocking secara default: server terhubung di latar belakang dan alat mereka menjadi tersedia saat mereka selesai. Atur ke `0` untuk membuat Claude Code menunggu server terhubung sebelum kueri pertama. Server yang dikonfigurasi dengan [`alwaysLoad: true`](/docs/id/mcp#exempt-a-server-from-deferral) masih membuat startup menunggu terlepas dari itu, kecuali ketika dilayani dari [cache penemuan](/docs/id/mcp#server-status-detail), karena alat mereka harus ada ketika prompt pertama dibangun. Dalam mode non-interaktif (`-p`) tanpa `--input-format stream-json`, Claude Code juga menunggu server yang masih tertunda sebelum giliran pertama terlepas dari variabel ini. Ketika Anda meneruskan [`--mcp-config`](/docs/id/cli-reference#cli-flags) secara eksplisit, tunggu memiliki tenggat waktu yang lebih lama; lihat entri flag itu untuk pengecualian server yang di-cache |

467| `MCP_CONNECT_TIMEOUT_MS` | Berapa lama startup MCP yang memblokir menunggu, dalam milidetik, untuk batch koneksi sebelum mengambil snapshot daftar alat (default: 5000). Berlaku ketika `MCP_CONNECTION_NONBLOCKING=0` atau untuk server yang ditandai [`alwaysLoad: true`](/docs/id/mcp#exempt-a-server-from-deferral). Server yang masih tertunda pada tenggat waktu terus terhubung di latar belakang. Berbeda dari `MCP_TIMEOUT`, yang mengikat upaya koneksi server individual |467| `MCP_CONNECT_TIMEOUT_MS` | Berapa lama startup MCP yang memblokir menunggu, dalam milidetik, untuk batch koneksi sebelum mengambil snapshot daftar alat (default: 5000). Berlaku ketika `MCP_CONNECTION_NONBLOCKING=0` atau untuk server yang ditandai [`alwaysLoad: true`](/docs/id/mcp#exempt-a-server-from-deferral). Server yang masih tertunda pada tenggat waktu terus terhubung di latar belakang. Berbeda dari `MCP_TIMEOUT`, yang mengikat upaya koneksi server individual |

2711* **Kode keluar 2**: tugas tidak ditandai sebagai selesai dan pesan stderr diumpankan kembali ke model sebagai umpan balik.2711* **Kode keluar 2**: tugas tidak ditandai sebagai selesai dan pesan stderr diumpankan kembali ke model sebagai umpan balik.

2712* **JSON `{"continue": false, "stopReason": "..."}`**: ketika teammate yang menyelesaikan gilirannya memicu event, menghentikan teammate sepenuhnya, mencocokkan perilaku hook `Stop`. `stopReason` ditampilkan ke pengguna. Ketika tool `TaskUpdate` memicu event, Claude Code mengabaikan `continue: false`; kode keluar 2 masih memblokir penyelesaian.2712* **JSON `{"continue": false, "stopReason": "..."}`**: ketika teammate yang menyelesaikan gilirannya memicu event, menghentikan teammate sepenuhnya, mencocokkan perilaku hook `Stop`. `stopReason` ditampilkan ke pengguna. Ketika tool `TaskUpdate` memicu event, Claude Code mengabaikan `continue: false`; kode keluar 2 masih memblokir penyelesaian.

2713 2713 

2714Contoh ini menjalankan tests dan memblokir penyelesa ian tugas jika gagal:2714Contoh ini menjalankan tests dan memblokir penyelesaian tugas jika gagal:

2715 2715 

2716```bash theme={null}2716```bash theme={null}

2717#!/bin/bash2717#!/bin/bash

439* Tekan `Tab` atau `Right arrow` untuk menempatkan saran dalam input prompt, kemudian `Enter` untuk mengirimkan439* Tekan `Tab` atau `Right arrow` untuk menempatkan saran dalam input prompt, kemudian `Enter` untuk mengirimkan

440* Mulai mengetik untuk menolak saran440* Mulai mengetik untuk menolak saran

441 441 

442Claude Code menghasilkan setiap saran prompt berikutnya dengan permintaan latar belakang yang menggunakan kembali prompt cache percakapan, sehingga biaya tambahan minimal.442Claude Code menghasilkan setiap saran prompt berikutnya dengan permintaan latar belakang ke model yang sama yang digunakan sesi Anda. Permintaan dihitung terhadap batas penggunaan rencana Anda atau biaya API Anda. Karena menggunakan kembali prompt cache percakapan, sebagian besar adalah pembacaan cache ditambah beberapa token output, jadi biaya tambahan minimal.

443 443 

444<h3 id="when-claude-code-skips-suggestions">444<h3 id="when-claude-code-skips-suggestions">

445 Ketika Claude Code melewatkan saran445 Ketika Claude Code melewatkan saran

95 * **Di sandbox VM penuh**: ketika konfigurasi terkelola Claude Desktop Anda menetapkan [`requireCoworkFullVmSandbox`](https://claude.com/docs/third-party/claude-desktop/configuration#requirecoworkfullvmsandbox), Claude Code berjalan di dalam mesin virtual di mana kebijakan MDM perangkat dan file pengaturan terkelola tidak ada.95 * **Di sandbox VM penuh**: ketika konfigurasi terkelola Claude Desktop Anda menetapkan [`requireCoworkFullVmSandbox`](https://claude.com/docs/third-party/claude-desktop/configuration#requirecoworkfullvmsandbox), Claude Code berjalan di dalam mesin virtual di mana kebijakan MDM perangkat dan file pengaturan terkelola tidak ada.

96 * **Sesi Cowork jarak jauh**: ini berjalan di VM yang dikelola Anthropic, di mana Claude Code tidak memiliki kebijakan perangkat untuk dibaca.96 * **Sesi Cowork jarak jauh**: ini berjalan di VM yang dikelola Anthropic, di mana Claude Code tidak memiliki kebijakan perangkat untuk dibaca.

97 97 

98 Tabel [cakupan permukaan](/docs/id/model-config#surface-coverage) membandingkan Cowork dengan permukaan lainnya.98 Di mana pun sesi berjalan, claude.ai menerapkan daftar [`strictKnownMarketplaces`](/docs/id/settings-reference#strictknownmarketplaces) dan [`blockedMarketplaces`](/docs/id/settings-reference#blockedmarketplaces) konsol admin itu sendiri ketika siapa pun menambahkan marketplace dari repositori git di claude.ai atau dari **Customize** di tab Cowork. [Bagaimana pembatasan bekerja](/docs/id/plugin-marketplaces#how-restrictions-work) menjelaskan pemeriksaan itu. Tabel [cakupan permukaan](/docs/id/model-config#surface-coverage) membandingkan Cowork dengan permukaan lainnya.

99* **Sesi yang berjalan**: sebagian besar perubahan mencapai sesi yang berjalan sesuai jadwal dalam [tabel mekanisme pengiriman](#choose-a-delivery-mechanism), tanpa restart.99* **Sesi yang berjalan**: sebagian besar perubahan mencapai sesi yang berjalan sesuai jadwal dalam [tabel mekanisme pengiriman](#choose-a-delivery-mechanism), tanpa restart.

100 * Perubahan pada [`forceRemoteSettingsRefresh`](/docs/id/settings-reference#forceremotesettingsrefresh), [`requiredMinimumVersion`](/docs/id/settings-reference#requiredminimumversion), dan [beberapa kunci yang dapat diedit pengguna](/docs/id/settings#when-edits-take-effect) berlaku pada startup sesi berikutnya.100 * Perubahan pada [`forceRemoteSettingsRefresh`](/docs/id/settings-reference#forceremotesettingsrefresh), [`requiredMinimumVersion`](/docs/id/settings-reference#requiredminimumversion), dan [beberapa kunci yang dapat diedit pengguna](/docs/id/settings#when-edits-take-effect) berlaku pada startup sesi berikutnya.

101 * Entri [`policyHelper`](/docs/id/settings-reference#policyhelper) yang baru atau berubah berlaku pada peluncuran berikutnya. Jika pengaturan terkelola server menaungi helper pada peluncuran itu, helper berjalan segera setelah pengambilan melaporkan pengaturan tersebut dihapus.101 * Entri [`policyHelper`](/docs/id/settings-reference#policyhelper) yang baru atau berubah berlaku pada peluncuran berikutnya. Jika pengaturan terkelola server menaungi helper pada peluncuran itu, helper berjalan segera setelah pengambilan melaporkan pengaturan tersebut dihapus.

1382 * `"gateway_rejected"`: [gateway aplikasi Claude](/docs/id/claude-apps-gateway) menjawab beban pengaturan terkelola dengan HTTP 4031382 * `"gateway_rejected"`: [gateway aplikasi Claude](/docs/id/claude-apps-gateway) menjawab beban pengaturan terkelola dengan HTTP 403

1383 * `"version_below_minimum"`: versi Claude Code ini di bawah [`requiredMinimumVersion`](/docs/id/settings-reference#requiredminimumversion) atau di atas [`requiredMaximumVersion`](/docs/id/settings-reference#requiredmaximumversion)1383 * `"version_below_minimum"`: versi Claude Code ini di bawah [`requiredMinimumVersion`](/docs/id/settings-reference#requiredminimumversion) atau di atas [`requiredMaximumVersion`](/docs/id/settings-reference#requiredmaximumversion)

1384 * `"_OTHER"`: beban pengaturan terkelola gateway aplikasi Claude gagal karena alasan lain1384 * `"_OTHER"`: beban pengaturan terkelola gateway aplikasi Claude gagal karena alasan lain

1385* `managed_settings.sources`: setiap sumber terkelola yang memberikan setidaknya satu [kunci kebijakan](/docs/id/server-managed-settings#how-claude-code-combines-managed-sources), prioritas tertinggi terlebih dahulu, termasuk sumber yang kuncinya tidak berlaku di bawah `first-wins`. Nilai adalah `"remote"`, `"plist"` atau `"hklm"` untuk kebijakan MDM atau tingkat OS, `"file"` untuk file pengaturan terkelola dan drop-in, `"parent"` saat [host embedding](/docs/id/server-managed-settings#let-an-embedding-host-add-policy) memasok pengaturan, dan `"hkcu"` untuk [nilai registri Windows HKCU](/docs/id/server-managed-settings#where-each-mechanism-stores-the-policy) saat Claude Code [membacanya](/docs/id/server-managed-settings#how-claude-code-combines-managed-sources). Sumber yang hanya membawa kunci kontrol, atau yang Claude Code tidak dapat dibaca, tidak tercantum. Dipancarkan sebagai array string, kosong saat tidak ada sumber terkelola yang memberikan kunci kebijakan1385* `managed_settings.sources`: setiap sumber terkelola yang memberikan setidaknya satu [kunci kebijakan](/docs/id/managed-settings#how-claude-code-combines-managed-sources), prioritas tertinggi terlebih dahulu, termasuk sumber yang kuncinya tidak berlaku di bawah `first-wins`. Nilai adalah `"remote"`, `"plist"` atau `"hklm"` untuk kebijakan MDM atau tingkat OS, `"file"` untuk file pengaturan terkelola dan drop-in, `"parent"` saat [host embedding](/docs/id/managed-settings#let-an-embedding-host-add-policy) memasok pengaturan, dan `"hkcu"` untuk [nilai registri Windows HKCU](/docs/id/managed-settings#where-each-mechanism-stores-the-policy) saat Claude Code [membacanya](/docs/id/managed-settings#how-claude-code-combines-managed-sources). Sumber yang hanya membawa kunci kontrol, atau yang Claude Code tidak dapat dibaca, tidak tercantum. Dipancarkan sebagai array string, kosong saat tidak ada sumber terkelola yang memberikan kunci kebijakan

1386* `managed_settings.source_behavior`: nilai [`managedSourcesBehavior`](/docs/id/settings-reference#managedsourcesbehavior) yang dibaca Claude Code, `"first-wins"` atau `"merge"`. `"first-wins"` saat tidak ada sumber yang menetapkan kunci1386* `managed_settings.source_behavior`: nilai [`managedSourcesBehavior`](/docs/id/settings-reference#managedsourcesbehavior) yang dibaca Claude Code, `"first-wins"` atau `"merge"`. `"first-wins"` saat tidak ada sumber yang menetapkan kunci

1387* `managed_settings.helper.state`: status helper kebijakan yang dikonfigurasi sumber MDM atau file yang dipilih:1387* `managed_settings.helper.state`: status helper kebijakan yang dikonfigurasi sumber MDM atau file yang dipilih:

1388 * `"ok"`: output helper melayani sebagai pengaturan terkelola1388 * `"ok"`: output helper melayani sebagai pengaturan terkelola

461 Apa yang dapat diakses run461 Apa yang dapat diakses run

462</h2>462</h2>

463 463 

464`claude plugin eval` memuat skill dan hook plugin target dan menjalankan suite evalnya di mesin Anda, sebagai Anda. Menunjuknya ke plugin adalah keputusan kepercayaan yang sama dengan `claude --plugin-dir`, jadi hanya evaluasi plugin yang Anda percayai. Isolasi yang dijelaskan di bagian ini membatasi apa yang dapat dijangkau agen yang diuji; itu bukan batas terhadap kode plugin itu sendiri, dan suite yang lulus tidak mengatakan apa pun tentang apakah plugin aman.464`claude plugin eval` memuat skill, hook, dan agent plugin target dan menjalankan suite evalnya di mesin Anda, sebagai Anda. Menunjuknya ke plugin adalah keputusan kepercayaan yang sama dengan `claude --plugin-dir`, jadi hanya evaluasi plugin yang Anda percayai. Isolasi yang dijelaskan di bagian ini membatasi apa yang dapat dijangkau agen yang diuji; itu bukan batas terhadap kode plugin itu sendiri, dan suite yang lulus tidak mengatakan apa pun tentang apakah plugin aman.

465 465 

466<h3 id="trust-the-plugin-directory">466<h3 id="trust-the-plugin-directory">

467 Percayai direktori plugin467 Percayai direktori plugin

648 648 

649Jika plugin memang dimuat dan `Δ` masih mendekati nol dengan grader `tool_used: Skill` Anda gagal, itu biasanya temuan nyata, berarti `description` skill tidak memicu pada frasa prompt. Sesuaikan deskripsi dan jalankan ulang suite yang sama.649Jika plugin memang dimuat dan `Δ` masih mendekati nol dengan grader `tool_used: Skill` Anda gagal, itu biasanya temuan nyata, berarti `description` skill tidak memicu pada frasa prompt. Sesuaikan deskripsi dan jalankan ulang suite yang sama.

650 650 

651<h3 id="agent-type-’-’-not-found-for-one-of-your-plugin’s-agents">

652 "Agent type '...' not found" untuk salah satu agen plugin Anda

653</h3>

654 

655Secara default setiap kasus berjalan baik dengan plugin Anda maupun tanpanya, dan run tanpanya adalah [baseline tanpa plugin](#the-no-plugin-baseline). Ketika Claude mengirimkan salah satu agen plugin Anda dalam run baseline, panggilan alat Agent gagal dengan `Agent type '<plugin>:<agent-name>' not found. Available agents: ...`. Daftar hanya menamai agen yang ada tanpa plugin, seperti [subagen bawaan](/docs/id/sub-agents#built-in-subagents).

656 

657Kesalahan diharapkan, karena `Δ` membandingkan run plugin Anda terhadap baseline. Dalam hasil JSON, run baseline berada di bawah `cases[].arms.without`.

658 

659Dalam run dengan plugin Anda dimuat, kasus yang mencantumkan `Agent` dalam `allowed_tools` dapat mengirimkan salah satu agen plugin Anda dengan nama yang diberi namespace, seperti `my-plugin:code-reviewer` untuk agen `code-reviewer` dalam plugin bernama `my-plugin`. Untuk melewati run baseline, lewati `--ablation none`.

660 

651<h3 id="everything-scores-zero-although-the-right-files-were-produced">661<h3 id="everything-scores-zero-although-the-right-files-were-produced">

652 Semuanya mencetak nol meskipun file yang benar diproduksi662 Semuanya mencetak nol meskipun file yang benar diproduksi

653</h3>663</h3>

1128 1128 

1129Pembatasan diperiksa sebelum operasi jaringan atau filesystem apa pun. Pemeriksaan berjalan pada marketplace add dan pada plugin install, update, refresh, dan auto-update. Jika marketplace ditambahkan sebelum kebijakan dikonfigurasi dan sumbernya tidak lagi cocok dengan daftar izin, Claude Code menolak untuk memasang atau memperbarui plugin darinya. Penegakan yang sama berlaku untuk `blockedMarketplaces`.1129Pembatasan diperiksa sebelum operasi jaringan atau filesystem apa pun. Pemeriksaan berjalan pada marketplace add dan pada plugin install, update, refresh, dan auto-update. Jika marketplace ditambahkan sebelum kebijakan dikonfigurasi dan sumbernya tidak lagi cocok dengan daftar izin, Claude Code menolak untuk memasang atau memperbarui plugin darinya. Penegakan yang sama berlaku untuk `blockedMarketplaces`.

1130 1130 

1131Tempat kedua daftar diterapkan tergantung pada tempat Anda menetapkannya:

1132 

1133* **Konsol admin claude.ai**: Claude Code menerapkan kedua daftar dalam sesi yang [membaca pengaturan yang dikelola server](/docs/id/managed-settings#where-and-when-a-policy-applies). claude.ai juga memeriksanya ketika siapa pun dalam organisasi Anda menambahkan marketplace baru dari repositori git di claude.ai, atau dari **Customize** di aplikasi Claude Desktop di luar tab Code-nya. Itu mencakup marketplace yang ditambahkan anggota untuk akun mereka sendiri dan yang ditambahkan untuk seluruh organisasi di bawah [**Organization settings > Plugins**](https://claude.ai/admin-settings/plugins). claude.ai menolak repositori yang tidak diakui allowlist atau yang dinamai blocklist. Itu tidak memeriksa ulang marketplace yang ditambahkan di salah satu tempat sebelum Anda menetapkan daftar, dan itu tidak memeriksa plugin yang diunggah.

1134* **File pengaturan yang dikelola, kebijakan tingkat OS, atau sumber yang dikelola lainnya**: Claude Code menerapkan kedua daftar tempat itu membaca sumber itu. claude.ai tidak membacanya.

1135 

1131Untuk memblokir setiap repositori marketplace di bawah pemilik GitHub, gunakan bentuk owner-wildcard dalam entri `blockedMarketplaces`: `{ "source": "github", "repo": "untrusted-org/*" }`. Memerlukan Claude Code v2.1.223 atau lebih baru. Untuk aturan pencocokan, yang berbeda antara blocklist dan allowlist, lihat [Owner wildcards](/docs/id/settings-reference#owner-wildcards).1136Untuk memblokir setiap repositori marketplace di bawah pemilik GitHub, gunakan bentuk owner-wildcard dalam entri `blockedMarketplaces`: `{ "source": "github", "repo": "untrusted-org/*" }`. Memerlukan Claude Code v2.1.223 atau lebih baru. Untuk aturan pencocokan, yang berbeda antara blocklist dan allowlist, lihat [Owner wildcards](/docs/id/settings-reference#owner-wildcards).

1132 1137 

1133Ketika pengguna menambahkan URL repositori `https://` yang Claude Code [klon daripada ambil](/docs/id/discover-plugins#add-from-other-git-hosts), seperti URL repositori `github.com` atau `gitlab.com` kosong, Claude Code juga memeriksanya terhadap entri `url` dalam `blockedMarketplaces`. Claude Code memblokir penambahan jika entri menamai URL yang sama. Dalam perbandingan itu, Claude Code mengabaikan akhiran `.git` dan ref apa pun yang ditambahkan pengguna setelah `#`. Memerlukan Claude Code v2.1.232 atau lebih baru. Sebelum v2.1.232, Claude Code mencocokkan entri `url` hanya terhadap URL yang diambil sebagai file `marketplace.json` yang dihosting.1138Ketika pengguna menambahkan URL repositori `https://` yang Claude Code [klon daripada ambil](/docs/id/discover-plugins#add-from-other-git-hosts), seperti URL repositori `github.com` atau `gitlab.com` kosong, Claude Code juga memeriksanya terhadap entri `url` dalam `blockedMarketplaces`. Claude Code memblokir penambahan jika entri menamai URL yang sama. Dalam perbandingan itu, Claude Code mengabaikan akhiran `.git` dan ref apa pun yang ditambahkan pengguna setelah `#`. Memerlukan Claude Code v2.1.232 atau lebih baru. Sebelum v2.1.232, Claude Code mencocokkan entri `url` hanya terhadap URL yang diambil sebagai file `marketplace.json` yang dihosting.

338 338 

339Kunci yang dikembalikan oleh skrip [`apiKeyHelper`](/docs/id/settings-reference#apikeyhelper) maupun kredensial [Workload Identity Federation](https://platform.claude.com/docs/en/manage-claude/workload-identity-federation) tidak memicu pengambilan pengaturan.339Kunci yang dikembalikan oleh skrip [`apiKeyHelper`](/docs/id/settings-reference#apikeyhelper) maupun kredensial [Workload Identity Federation](https://platform.claude.com/docs/en/manage-claude/workload-identity-federation) tidak memicu pengambilan pengaturan.

340 340 

341Dalam sesi [Cowork](https://claude.com/docs/cowork/overview) di aplikasi Claude Desktop, Claude Code tidak mengambil pengaturan yang dikelola server dari konsol admin claude.ai, bahkan ketika pengguna masuk dengan akun Organisasi atau Perusahaan. [Di mana dan kapan kebijakan berlaku](/docs/id/managed-settings#where-and-when-a-policy-applies) mencakup kebijakan mana yang mencapai sesi Cowork di mesin pengguna dan sesi Cowork jarak jauh.341Dalam sesi [Cowork](https://claude.com/docs/cowork/overview) di aplikasi Claude Desktop, Claude Code tidak mengambil pengaturan yang dikelola server dari konsol admin claude.ai, bahkan ketika pengguna masuk dengan akun Tim atau Perusahaan. [Di mana dan kapan kebijakan berlaku](/docs/id/managed-settings#where-and-when-a-policy-applies) mencakup kebijakan mana yang mencapai sesi Cowork di mesin pengguna dan sesi Cowork jarak jauh. claude.ai masih menerapkan daftar [`strictKnownMarketplaces`](/docs/id/settings-reference#strictknownmarketplaces) dan [`blockedMarketplaces`](/docs/id/settings-reference#blockedmarketplaces) Anda sendiri ketika pengguna Cowork menambahkan marketplace dari repositori git di claude.ai atau dari **Customize** di tab Cowork. [Bagaimana pembatasan bekerja](/docs/id/plugin-marketplaces#how-restrictions-work) menjelaskan pemeriksaan tersebut.

342 342 

343Jika Anda mengekspor variabel penyedia `CLAUDE_CODE_USE_*` atau `ANTHROPIC_BASE_URL` non-default di shell Anda, Claude Code melewati pengambilan pengaturan untuk sesi Anda. [`claude doctor` dan `/status` melaporkan pengambilan yang dilewati dan penyebabnya](#verify-settings-delivery).343Jika Anda mengekspor variabel penyedia `CLAUDE_CODE_USE_*` atau `ANTHROPIC_BASE_URL` non-default di shell Anda, Claude Code melewati pengambilan pengaturan untuk sesi Anda. [`claude doctor` dan `/status` melaporkan pengambilan yang dilewati dan penyebabnya](#verify-settings-delivery).

344 344 

4514 4514 

4515Blokir 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.4515Blokir 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.

4516 4516 

4517Jika Anda menetapkan kunci ini dalam [konsol admin claude.ai](/docs/id/server-managed-settings), claude.ai juga menerapkannya ketika siapa pun di organisasi Anda menambahkan marketplace dari repositori git di claude.ai, seperti yang dijelaskan [Bagaimana pembatasan bekerja](/docs/id/plugin-marketplaces#how-restrictions-work).

4518 

4517* **Scope**: [`Managed`](#scopes)4519* **Scope**: [`Managed`](#scopes)

4518* **Type**: array objek sumber marketplace, dalam bentuk yang sama seperti [`strictKnownMarketplaces`](#allowed-source-types)4520* **Type**: array objek sumber marketplace, dalam bentuk yang sama seperti [`strictKnownMarketplaces`](#allowed-source-types)

4519* **Default**: unset, jadi tidak ada marketplace yang diblokir4521* **Default**: unset, jadi tidak ada marketplace yang diblokir

4610 4612 

4611Batasi 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.4613Batasi 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.

4612 4614 

4615Jika Anda menetapkan kunci ini dalam [konsol admin claude.ai](/docs/id/server-managed-settings), claude.ai juga menerapkannya ketika siapa pun di organisasi Anda menambahkan marketplace dari repositori git di claude.ai, seperti yang dijelaskan [Bagaimana pembatasan bekerja](/docs/id/plugin-marketplaces#how-restrictions-work).

4616 

4613* **Scope**: [`Managed`](#scopes)4617* **Scope**: [`Managed`](#scopes)

4614* **Type**: array objek sumber marketplace; lihat [Tipe sumber yang diizinkan](#allowed-source-types)4618* **Type**: array objek sumber marketplace; lihat [Tipe sumber yang diizinkan](#allowed-source-types)

4615* **Default**: unset, jadi pengguna dapat menambahkan marketplace apa pun. Array kosong adalah lockdown lengkap yang memblokir setiap sumber marketplace, termasuk marketplace resmi Anthropic4619* **Default**: unset, jadi pengguna dapat menambahkan marketplace apa pun. Array kosong adalah lockdown lengkap yang memblokir setiap sumber marketplace, termasuk marketplace resmi Anthropic