SpyBara
Go Premium

Documentation 2026-09-30 23:00 UTC to 2026-10-01 10:57 UTC

48 files changed +726 −290. View all changes and history on the product overview
2026
Thu 1 11:57

admin-setup.md +1 −0

Details

106| [Disable claude.ai sync](/docs/id/settings-reference#syncclaudeaiskills) | Hentikan Claude Code dari memuat [skills](/docs/id/skills#how-synced-skills-behave) dan [plugins](/docs/id/plugins/loading#synced-plugins) yang diaktifkan pengembang Anda di claude.ai. Jika Anda mematikan Skills untuk organisasi Anda di claude.ai, Claude Code berhenti menyinkronkan keduanya, dan pada v2.1.273 atau lebih baru juga menghapus yang sudah disinkronkan. Untuk menghentikan salah satu tanpa mematikan Skills, atur kuncinya ke `false` dalam pengaturan terkelola | `syncClaudeAiSkills`, `syncClaudeAiPlugins` |106| [Disable claude.ai sync](/docs/id/settings-reference#syncclaudeaiskills) | Hentikan Claude Code dari memuat [skills](/docs/id/skills#how-synced-skills-behave) dan [plugins](/docs/id/plugins/loading#synced-plugins) yang diaktifkan pengembang Anda di claude.ai. Jika Anda mematikan Skills untuk organisasi Anda di claude.ai, Claude Code berhenti menyinkronkan keduanya, dan pada v2.1.273 atau lebih baru juga menghapus yang sudah disinkronkan. Untuk menghentikan salah satu tanpa mematikan Skills, atur kuncinya ke `false` dalam pengaturan terkelola | `syncClaudeAiSkills`, `syncClaudeAiPlugins` |

107| [Hook restrictions](/docs/id/settings-reference#allowmanagedhooksonly) | Batasi hook mana yang berjalan dan batasi URL hook HTTP; lihat [apa yang berjalan di bawah `allowManagedHooksOnly`](/docs/id/settings-reference#what-runs-under-allowmanagedhooksonly) untuk daftar efek lengkap | `allowManagedHooksOnly`, `allowedHttpHookUrls` |107| [Hook restrictions](/docs/id/settings-reference#allowmanagedhooksonly) | Batasi hook mana yang berjalan dan batasi URL hook HTTP; lihat [apa yang berjalan di bawah `allowManagedHooksOnly`](/docs/id/settings-reference#what-runs-under-allowmanagedhooksonly) untuk daftar efek lengkap | `allowManagedHooksOnly`, `allowedHttpHookUrls` |

108| [Login enforcement](/docs/id/settings-reference#forceloginmethod) | Batasi login ke metode tertentu atau organisasi Anthropic. Pembatasan metode berlaku di seluruh ekstensi VS Code, Agent SDK, `claude setup-token`, dan `/install-github-app`, dan layar login interaktif terminal, dicapai oleh `/login` atau onboarding first-run, pra-pilih metode tanpa memberlakukannya; Claude Code memverifikasi organisasi untuk login akun claude.ai di terminal, ekstensi VS Code, dan Agent SDK, dan tidak memeriksanya untuk login Claude Console atau untuk sign-in [gateway](/docs/id/claude-apps-gateway). Sebelum v2.1.212, hanya login terminal yang menerapkan salah satu kunci. Ketika diatur, sesi yang diautentikasi oleh `ANTHROPIC_API_KEY`, `ANTHROPIC_AUTH_TOKEN`, atau `apiKeyHelper` diblokir saat startup; sesi penyedia cloud tidak terpengaruh kecuali salah satu dari kredensial tersebut, atau kunci API yang disimpan oleh login Claude Console sebelumnya, juga ada | `forceLoginMethod`, `forceLoginOrgUUID` |108| [Login enforcement](/docs/id/settings-reference#forceloginmethod) | Batasi login ke metode tertentu atau organisasi Anthropic. Pembatasan metode berlaku di seluruh ekstensi VS Code, Agent SDK, `claude setup-token`, dan `/install-github-app`, dan layar login interaktif terminal, dicapai oleh `/login` atau onboarding first-run, pra-pilih metode tanpa memberlakukannya; Claude Code memverifikasi organisasi untuk login akun claude.ai di terminal, ekstensi VS Code, dan Agent SDK, dan tidak memeriksanya untuk login Claude Console atau untuk sign-in [gateway](/docs/id/claude-apps-gateway). Sebelum v2.1.212, hanya login terminal yang menerapkan salah satu kunci. Ketika diatur, sesi yang diautentikasi oleh `ANTHROPIC_API_KEY`, `ANTHROPIC_AUTH_TOKEN`, atau `apiKeyHelper` diblokir saat startup; sesi penyedia cloud tidak terpengaruh kecuali salah satu dari kredensial tersebut, atau kunci API yang disimpan oleh login Claude Console sebelumnya, juga ada | `forceLoginMethod`, `forceLoginOrgUUID` |

109| [Provider restrictions](/docs/id/settings-reference#allowedproviders) | Batasi penyedia API mana yang dapat digunakan mesin. Sesi di penyedia yang tidak terdaftar ditolak saat startup, saat login, dan ketika berikutnya menghubungi API. Memerlukan Claude Code v2.1.285 atau lebih baru | `allowedProviders` |

109| [Disable agent view](/docs/id/agent-view#how-background-sessions-are-hosted) | Matikan `claude agents`, `--bg`, `/background`, dan supervisor on-demand | `disableAgentView` |110| [Disable agent view](/docs/id/agent-view#how-background-sessions-are-hosted) | Matikan `claude agents`, `--bg`, `/background`, dan supervisor on-demand | `disableAgentView` |

110| [Configure the corporate launcher](/docs/id/corporate-launcher) | Awali [background-agent supervisor](/docs/id/agent-view#how-background-sessions-are-hosted), pekerja-pekerja, dan [proses latar belakang tercakup lainnya](/docs/id/corporate-launcher#what-the-launcher-covers) dengan corporate launcher yang diperlukan alih-alih mematikan agent view | `processWrapper` |111| [Configure the corporate launcher](/docs/id/corporate-launcher) | Awali [background-agent supervisor](/docs/id/agent-view#how-background-sessions-are-hosted), pekerja-pekerja, dan [proses latar belakang tercakup lainnya](/docs/id/corporate-launcher#what-the-launcher-covers) dengan corporate launcher yang diperlukan alih-alih mematikan agent view | `processWrapper` |

111| [Model restrictions](/docs/id/model-config#restrict-model-selection) | `availableModels` memfilter model mana yang muncul di pemilih. Menambahkan `enforceAvailableModels` juga membatasi model default yang dipilih secara otomatis. Lihat [surface coverage](/docs/id/model-config#surface-coverage) untuk cara pengaturan ini menjangkau CLI, web, dan IDE | `availableModels`, `enforceAvailableModels` |112| [Model restrictions](/docs/id/model-config#restrict-model-selection) | `availableModels` memfilter model mana yang muncul di pemilih. Menambahkan `enforceAvailableModels` juga membatasi model default yang dipilih secara otomatis. Lihat [surface coverage](/docs/id/model-config#surface-coverage) untuk cara pengaturan ini menjangkau CLI, web, dan IDE | `availableModels`, `enforceAvailableModels` |

Details

418 ```418 ```

419</CodeGroup>419</CodeGroup>

420 420 

421Untuk mengonfirmasi blokir, daftarkan callback di bawah `PreToolUse` dengan matcher `Write|Edit` dan minta agent untuk membuat file di bawah `/etc`: hasil tool Write di message stream berisi `Writing to /etc is not allowed`, dan tidak ada file yang dibuat.

422 

421<h3 id="auto-approve-specific-tools">423<h3 id="auto-approve-specific-tools">

422 Auto-approve tools spesifik424 Auto-approve tools spesifik

423</h3>425</h3>


468 470 

469Ketika event terjadi, semua hooks yang cocok berjalan secara paralel. Untuk keputusan permission, hasil yang paling ketat menang: satu `deny` memblokir pemanggilan tool terlepas dari apa yang dikembalikan hooks lainnya. Karena urutan penyelesaian tidak dapat diprediksi, tulis setiap hook untuk bertindak secara independen daripada mengandalkan hook lain yang telah berjalan terlebih dahulu.471Ketika event terjadi, semua hooks yang cocok berjalan secara paralel. Untuk keputusan permission, hasil yang paling ketat menang: satu `deny` memblokir pemanggilan tool terlepas dari apa yang dikembalikan hooks lainnya. Karena urutan penyelesaian tidak dapat diprediksi, tulis setiap hook untuk bertindak secara independen daripada mengandalkan hook lain yang telah berjalan terlebih dahulu.

470 472 

471Contoh di bawah ini mendaftarkan tiga pemeriksaan independen untuk setiap pemanggilan tool:473Contoh di bawah ini mendaftarkan tiga pemeriksaan independen untuk setiap pemanggilan tool. Nama hook di dalamnya, seperti `audit_logger` di Python atau `auditLogger` di TypeScript, berdiri untuk callbacks yang Anda tentukan:

472 474 

473<CodeGroup>475<CodeGroup>

474 ```python Python theme={null}476 ```python Python theme={null}


500 Filter dengan multi-tool matchers502 Filter dengan multi-tool matchers

501</h3>503</h3>

502 504 

503Gunakan multi-tool matchers untuk berbagi satu callback di seluruh tools terkait. Contoh ini mendaftarkan tiga matchers dengan scope berbeda:505Gunakan multi-tool matchers untuk berbagi satu callback di seluruh tools terkait. Contoh ini mendaftarkan tiga matchers dengan scope berbeda, dan setiap hook yang dinamainya berdiri untuk callback yang Anda tentukan:

504 506 

505* Daftar exact yang dipisahkan pipe (`Write|Edit|NotebookEdit`) memicu `file_security_hook` hanya untuk file modification tools.507* Daftar exact yang dipisahkan pipe (`Write|Edit|NotebookEdit`) memicu `file_security_hook` hanya untuk file modification tools.

506* Regex (`^mcp__`) memicu `mcp_audit_hook` untuk tool MCP apa pun yang namanya dimulai dengan `mcp__`.508* Regex (`^mcp__`) memicu `mcp_audit_hook` untuk tool MCP apa pun yang namanya dimulai dengan `mcp__`.


585 ```587 ```

586</CodeGroup>588</CodeGroup>

587 589 

590Untuk mengonfirmasi hook terjadi, daftarkan callback dan minta agent untuk mendelegasikan tugas kecil ke subagent, seperti membuat daftar file di direktori saat ini: ketika subagent selesai, callback mencetak baris `[SUBAGENT] Completed:` dengan ID subagent dan jalur transcript.

591 

588<h3 id="make-http-requests-from-hooks">592<h3 id="make-http-requests-from-hooks">

589 Buat HTTP requests dari hooks593 Buat HTTP requests dari hooks

590</h3>594</h3>

Details

121 121 

122Mode izin memberikan kontrol global atas cara Claude menggunakan tools. Anda dapat mengatur mode izin saat memanggil `query()` atau mengubahnya secara dinamis selama sesi streaming.122Mode izin memberikan kontrol global atas cara Claude menggunakan tools. Anda dapat mengatur mode izin saat memanggil `query()` atau mengubahnya secara dinamis selama sesi streaming.

123 123 

124Jika Anda tidak mengatur satu, Claude Code memilih mode izin awal berdasarkan aturan dalam [Mode mana sesi dimulai](/docs/id/permission-modes#which-mode-a-session-starts-in):

125 

126* `permissions.defaultMode` dari [file pengaturan](/docs/id/settings#where-settings-live) sesi ketika satu berlaku

127* Jika tidak, default bawaan, yang dapat berupa [mode auto](/docs/id/permission-modes#eliminate-prompts-with-auto-mode)

128 

129Sesi yang dimulai dalam mode auto menghilangkan aturan izin luas seperti entri `Bash` kosong, seperti yang dijelaskan dalam [Bagaimana mode auto mengevaluasi tindakan](/docs/id/permission-modes#how-auto-mode-evaluates-actions). Jika aplikasi Anda mengandalkan mode `default` atau pada aturan seperti itu, lewatkan `default` secara eksplisit.

130 

131Sebelum Agent SDK TypeScript v0.3.286, menghilangkan `permissionMode` sama dengan melewatkan `default`.

132 

124<h3 id="available-modes">133<h3 id="available-modes">

125 Mode yang tersedia134 Mode yang tersedia

126</h3>135</h3>

agent-sdk/python.md +207 −68

Details

616 Contoh - Streaming input dengan ClaudeSDKClient616 Contoh - Streaming input dengan ClaudeSDKClient

617</h4>617</h4>

618 618 

619`query()` juga menerima async iterable dari dict pesan pengguna, sehingga Anda dapat merakit prompt pada waktu pengiriman atau menyertakan blok konten seperti gambar. Claude Code mulai merespons pesan pertama yang dihasilkan segera setelah tiba, tanpa menunggu iterable selesai, dan `receive_response()` berhenti pada `ResultMessage` yang mengakhiri respons tersebut. Masukkan semua yang harus dibaca Claude sebelum menjawab ke dalam satu pesan, seperti yang dilakukan generator ini, dan pasangkan setiap panggilan `query()` dengan loop `receive_response()` miliknya sendiri.

620 

619```python theme={null}621```python theme={null}

620import asyncio622import asyncio

621from claude_agent_sdk import ClaudeSDKClient623from claude_agent_sdk import ClaudeSDKClient

622 624 

623 625 

624async def message_stream():626async def message_stream():

625 """Generate messages dynamically."""627 """Assemble the prompt at send time and yield it as one user message."""

626 yield {628 readings = {"Temperature": "25°C", "Humidity": "60%"}

627 "type": "user",629 data = ", ".join(f"{name}: {value}" for name, value in readings.items())

628 "message": {"role": "user", "content": "Analyze the following data:"},

629 }

630 await asyncio.sleep(0.5)

631 yield {

632 "type": "user",

633 "message": {"role": "user", "content": "Temperature: 25°C, Humidity: 60%"},

634 }

635 await asyncio.sleep(0.5)

636 yield {630 yield {

637 "type": "user",631 "type": "user",

638 "message": {"role": "user", "content": "What patterns do you see?"},632 "message": {

633 "role": "user",

634 "content": f"Analyze the following sensor data and describe any patterns you see: {data}",

635 },

639 }636 }

640 637 

641 638 


2712 2709 

2713Dokumentasi skema input/output untuk semua tools Claude Code bawaan. Meskipun Python SDK tidak mengekspor ini sebagai tipe, mereka mewakili struktur input dan output tool dalam pesan.2710Dokumentasi skema input/output untuk semua tools Claude Code bawaan. Meskipun Python SDK tidak mengekspor ini sebagai tipe, mereka mewakili struktur input dan output tool dalam pesan.

2714 2711 

2712Setiap output yang ditampilkan adalah nilai yang Anda baca dari [`UserMessage.tool_use_result`](#usermessage) untuk tool tersebut. Nama kunci muncul persis seperti yang dikeluarkan Claude Code. Kunci yang dianotasi `| None` dengan komentar "present when" atau "optional" dihilangkan ketika tidak berlaku.

2713 

2715<h3 id="agent">2714<h3 id="agent">

2716 Agent2715 Agent

2717</h3>2716</h3>


2885 2884 

2886**Nama tool:** `Bash`2885**Nama tool:** `Bash`

2887 2886 

2888Untuk apa yang menetapkan batas ceiling foreground, lihat [Timeout and output limits](/docs/id/tools-reference#timeout-and-output-limits). Untuk batas waktu background, lihat [Background commands](/docs/id/tools-reference#background-commands).2887Untuk apa yang menetapkan batas ceiling foreground, lihat [Timeout and output limits](/docs/id/tools-reference#timeout-and-output-limits). Untuk batas waktu background, lihat [Time limit for background commands](/docs/id/tools-reference#time-limit-for-background-commands).

2889 2888 

2890**Input:**2889**Input:**

2891 2890 


2962 2961 

2963```python theme={null}2962```python theme={null}

2964{2963{

2965 "message": str, # Pesan konfirmasi2964 "filePath": str, # File yang diedit

2966 "replacements": int, # Jumlah penggantian yang dilakukan2965 "oldString": str, # Teks yang diganti

2967 "file_path": str, # Jalur file yang diedit2966 "newString": str, # Teks yang menggantinya

2967 "originalFile": str | None, # Isi file sebelum edit

2968 "structuredPatch": [ # Diff hunks untuk perubahan

2969 {

2970 "oldStart": int,

2971 "oldLines": int,

2972 "newStart": int,

2973 "newLines": int,

2974 "lines": list[str],

2975 }

2976 ],

2977 "userModified": bool, # Apakah pengguna mengubah edit yang diusulkan sebelum menerimanya

2978 "replaceAll": bool, # Apakah semua kemunculan diganti

2979 "gitDiff": { # Ringkasan git diff opsional untuk file

2980 "filename": str,

2981 "status": "modified" | "added",

2982 "additions": int,

2983 "deletions": int,

2984 "changes": int,

2985 "patch": str,

2986 "repository": str | None, # GitHub owner/repo ketika tersedia

2987 } | None,

2968}2988}

2969```2989```

2970 2990 


2984}3004}

2985```3005```

2986 3006 

2987**Output (File teks):**3007Output mengambil salah satu bentuk berikut tergantung pada apa yang Claude baca. Periksa kunci `type` untuk membedakannya.

3008 

3009**Output (type: `"text"`):**

2988 3010 

2989```python theme={null}3011```python theme={null}

2990{3012{

2991 "content": str, # Isi file dengan nomor baris3013 "type": "text",

2992 "total_lines": int, # Total jumlah baris dalam file3014 "file": {

2993 "lines_returned": int, # Baris yang benar-benar dikembalikan3015 "filePath": str, # File yang dibaca

3016 "content": str, # Konten yang dikembalikan

3017 "numLines": int, # Jumlah baris dalam konten yang dikembalikan

3018 "startLine": int, # Nomor baris konten dimulai

3019 "totalLines": int, # Total jumlah baris dalam file

3020 "truncatedByTokenCap": bool | None, # Hadir dan True ketika pembacaan seluruh file melebihi batas token dan konten adalah halaman pertama

3021 },

2994}3022}

2995```3023```

2996 3024 

2997**Output (Gambar):**3025**Output (type: `"image"`):**

2998 3026 

2999```python theme={null}3027```python theme={null}

3000{3028{

3001 "image": str, # Data gambar yang dikodekan Base643029 "type": "image",

3002 "mime_type": str, # Tipe MIME gambar3030 "file": {

3003 "file_size": int, # Ukuran file dalam byte3031 "base64": str, # Data gambar yang dikodekan Base64

3032 "type": "image/jpeg" | "image/png" | "image/gif" | "image/webp", # Tipe MIME gambar

3033 "originalSize": int, # Ukuran file asli dalam byte

3034 "dimensions": { # Info ukuran opsional untuk pemetaan koordinat

3035 "originalWidth": int | None, # Opsional; lebar asli dalam piksel

3036 "originalHeight": int | None, # Opsional; tinggi asli dalam piksel

3037 "displayWidth": int | None, # Opsional; lebar setelah mengubah ukuran

3038 "displayHeight": int | None, # Opsional; tinggi setelah mengubah ukuran

3039 } | None,

3040 },

3041}

3042```

3043 

3044**Output (type: `"notebook"`):**

3045 

3046```python theme={null}

3047{

3048 "type": "notebook",

3049 "file": {

3050 "filePath": str, # Notebook yang dibaca

3051 "cells": list, # Sel notebook

3052 },

3053}

3054```

3055 

3056**Output (type: `"pdf"`):**

3057 

3058```python theme={null}

3059{

3060 "type": "pdf",

3061 "file": {

3062 "filePath": str, # PDF yang dibaca

3063 "base64": str, # Data PDF yang dikodekan Base64

3064 "originalSize": int, # Ukuran file dalam byte

3065 },

3066}

3067```

3068 

3069**Output (type: `"parts"`):**

3070 

3071```python theme={null}

3072{

3073 "type": "parts",

3074 "file": {

3075 "filePath": str, # PDF yang dibaca

3076 "originalSize": int, # Ukuran file dalam byte

3077 "count": int, # Jumlah halaman yang diekstrak sebagai gambar

3078 "outputDir": str, # Direktori yang berisi gambar halaman yang diekstrak

3079 },

3080 "firstPage": int | None, # Nomor halaman dokumen opsional dari halaman pertama yang diekstrak

3081}

3082```

3083 

3084**Output (type: `"file_unchanged"`):**

3085 

3086```python theme={null}

3087{

3088 "type": "file_unchanged", # File tidak berubah sejak Claude terakhir membacanya dalam sesi ini, jadi konten tidak diulang

3089 "file": {

3090 "filePath": str,

3091 },

3092 "source": "seeded" | None, # Hadir ketika salinan sebelumnya berasal dari file CLAUDE.md atau memory yang dimuat saat startup daripada panggilan Read

3004}3093}

3005```3094```

3006 3095 


3023 3112 

3024```python theme={null}3113```python theme={null}

3025{3114{

3026 "message": str, # Pesan sukses3115 "type": "create" | "update", # Apakah penulisan membuat file baru atau menimpa yang sudah ada

3027 "bytes_written": int, # Jumlah byte yang ditulis3116 "filePath": str, # File yang ditulis

3028 "file_path": str, # Jalur file yang ditulis3117 "content": str, # Konten yang ditulis

3118 "structuredPatch": [ # Diff hunks; kosong untuk file baru, ketika tidak ada yang berubah, atau ketika Claude Code melewatkan diff

3119 {

3120 "oldStart": int,

3121 "oldLines": int,

3122 "newStart": int,

3123 "newLines": int,

3124 "lines": list[str],

3125 }

3126 ],

3127 "originalFile": str | None, # Konten sebelumnya; None untuk file baru atau ketika konten sebelumnya terlalu besar untuk disertakan

3128 "gitDiff": { # Ringkasan git diff opsional untuk file

3129 "filename": str,

3130 "status": "modified" | "added",

3131 "additions": int,

3132 "deletions": int,

3133 "changes": int,

3134 "patch": str,

3135 "repository": str | None, # GitHub owner/repo ketika tersedia

3136 } | None,

3137 "userModified": bool | None, # Opsional; apakah pengguna mengedit konten yang diusulkan sebelum menerimanya

3029}3138}

3030```3139```

3031 3140 


3048 3157 

3049```python theme={null}3158```python theme={null}

3050{3159{

3051 "matches": list[str], # Array jalur file yang cocok3160 "durationMs": int, # Waktu yang dibutuhkan untuk menjalankan pencarian, dalam milidetik

3052 "count": int, # Jumlah kecocokan yang ditemukan3161 "numFiles": int, # Jumlah jalur yang dikembalikan, setelah pemotongan apa pun

3053 "search_path": str, # Direktori pencarian yang digunakan3162 "filenames": list[str], # Jalur file yang cocok

3163 "truncated": bool, # Apakah hasil dipotong pada batas 100 file

3164 "totalMatches": int | None, # Jumlah total file yang cocok opsional sebelum pemotongan; batas bawah ketika countIsComplete adalah False

3165 "countIsComplete": bool | None, # Opsional; apakah totalMatches tepat

3054}3166}

3055```3167```

3056 3168 

3169`totalMatches` dan `countIsComplete` memerlukan Claude Code v2.1.191 atau lebih baru.

3170 

3057<h3 id="grep">3171<h3 id="grep">

3058 Grep3172 Grep

3059</h3>3173</h3>


3074 "-B": int | None, # Baris untuk ditampilkan sebelum setiap kecocokan3188 "-B": int | None, # Baris untuk ditampilkan sebelum setiap kecocokan

3075 "-A": int | None, # Baris untuk ditampilkan setelah setiap kecocokan3189 "-A": int | None, # Baris untuk ditampilkan setelah setiap kecocokan

3076 "-C": int | None, # Baris untuk ditampilkan sebelum dan sesudah3190 "-C": int | None, # Baris untuk ditampilkan sebelum dan sesudah

3191 "context": int | None, # Baris untuk ditampilkan sebelum dan sesudah; -C adalah alias

3192 "-o": bool | None, # Cetak hanya bagian yang cocok dari setiap baris

3077 "head_limit": int | None, # Batasi output ke N baris/entri pertama3193 "head_limit": int | None, # Batasi output ke N baris/entri pertama

3194 "offset": int | None, # Lewati N baris/entri pertama sebelum menerapkan head_limit

3078 "multiline": bool | None, # Aktifkan mode multiline3195 "multiline": bool | None, # Aktifkan mode multiline

3079}3196}

3080```3197```

3081 3198 

3082**Output (content mode):**3199**Output:**

3083 3200 

3084```python theme={null}3201```python theme={null}

3085{3202{

3086 "matches": [3203 "mode": "content" | "files_with_matches" | "count" | None, # Mode output yang digunakan

3087 {3204 "numFiles": int, # Jumlah file dalam hasil; selalu 0 dalam mode content

3088 "file": str,3205 "filenames": list[str], # File yang cocok dalam mode files_with_matches; kosong dalam mode lain

3089 "line_number": int | None,3206 "content": str | None, # Baris yang cocok dalam mode content, atau hitungan per-file dalam mode count

3090 "line": str,3207 "numLines": int | None, # Jumlah baris dalam konten, hadir dalam mode content

3091 "before_context": list[str] | None,3208 "numMatches": int | None, # Total hitungan kecocokan, hadir dalam mode count

3092 "after_context": list[str] | None,3209 "totalFiles": int | None, # Total opsional sebelum head_limit dan offset, dalam mode files_with_matches

3093 }3210 "totalLines": int | None, # Total opsional sebelum head_limit dan offset, dalam mode content

3094 ],3211 "appliedLimit": int | None, # Hadir ketika head_limit memotong hasil

3095 "total_matches": int,3212 "appliedOffset": int | None, # Hadir ketika offset diterapkan

3096}3213}

3097```3214```

3098 3215 

3099**Output (files\_with\_matches mode):**3216Grep mengembalikan bentuk dict ini dalam setiap mode output. Kunci opsional mana yang ada tergantung pada `output_mode`.

3100 3217 

3101```python theme={null}3218`totalFiles` memerlukan Claude Code v2.1.208 atau lebih baru. `totalLines` memerlukan Claude Code v2.1.210 atau lebih baru.

3102{

3103 "files": list[str], # File yang berisi kecocokan

3104 "count": int, # Jumlah file dengan kecocokan

3105}

3106```

3107 3219 

3108<h3 id="notebookedit">3220<h3 id="notebookedit">

3109 NotebookEdit3221 NotebookEdit


3127 3239 

3128```python theme={null}3240```python theme={null}

3129{3241{

3130 "message": str, # Pesan sukses3242 "new_source": str, # Sumber yang ditulis ke sel

3131 "edit_type": "replaced" | "inserted" | "deleted", # Jenis edit yang dilakukan3243 "old_source": str | None, # Sumber sel sebelumnya, hadir untuk replace dan delete

3132 "cell_id": str | None, # ID sel yang terpengaruh3244 "cell_id": str | None, # ID sel yang diedit, ketika tersedia

3133 "total_cells": int, # Total sel dalam notebook setelah edit3245 "cell_type": "code" | "markdown", # Jenis sel

3246 "language": str, # Bahasa pemrograman notebook

3247 "edit_mode": str, # Mode edit yang digunakan

3248 "error": str | None, # Pesan kesalahan ketika operasi gagal

3249 "notebook_path": str, # File notebook

3250 "original_file": str, # Konten notebook sebelum edit

3251 "updated_file": str, # Konten notebook setelah edit

3134}3252}

3135```3253```

3136 3254 


3228 3346 

3229```python theme={null}3347```python theme={null}

3230{3348{

3231 "message": str, # Pesan sukses3349 "oldTodos": [ # Daftar todo sebelum pembaruan

3232 "stats": {"total": int, "pending": int, "in_progress": int, "completed": int},3350 {

3351 "content": str,

3352 "status": "pending" | "in_progress" | "completed",

3353 "activeForm": str,

3354 }

3355 ],

3356 "newTodos": [ # Daftar todo setelah pembaruan

3357 {

3358 "content": str,

3359 "status": "pending" | "in_progress" | "completed",

3360 "activeForm": str,

3361 }

3362 ],

3233}3363}

3234```3364```

3235 3365 


3401 3531 

3402```python theme={null}3532```python theme={null}

3403{3533{

3404 "message": str, # Pesan konfirmasi3534 "plan": str | None, # Rencana yang disajikan kepada pengguna

3405 "approved": bool | None, # Apakah pengguna menyetujui rencana3535 "isAgent": bool, # True ketika subagen memanggil tool

3536 "filePath": str | None, # Hadir ketika rencana disimpan ke file

3537 "hasTaskTool": bool | None, # Opsional; apakah tool Agent tersedia dalam konteks saat ini

3538 "planWasEdited": bool | None, # Hadir dan True ketika pengguna mengedit rencana sebelum menyetujui

3539 "awaitingLeaderApproval": bool | None, # Hadir dan True ketika rekan tim mengirim rencana ke pemimpin tim untuk persetujuan

3540 "requestId": str | None, # ID opsional dari permintaan persetujuan itu

3406}3541}

3407```3542```

3408 3543 


3420}3555}

3421```3556```

3422 3557 

3558Hasilnya adalah daftar daripada dict, jadi `tool_use_result` menyimpan `list` untuk tool ini.

3559 

3423**Output:**3560**Output:**

3424 3561 

3425```python theme={null}3562```python theme={null}

3426{3563[ # Satu entri per sumber daya

3427 "resources": [

3428 {3564 {

3429 "uri": str,3565 "uri": str, # URI sumber daya

3430 "name": str,3566 "name": str, # Nama sumber daya

3431 "description": str | None,3567 "mimeType": str | None, # Tipe MIME opsional

3432 "mimeType": str | None,3568 "description": str | None, # Deskripsi opsional

3433 "server": str,3569 "server": str, # Server yang menyediakan sumber daya ini

3434 }3570 }

3435 ],3571]

3436 "total": int,

3437}

3438```3572```

3439 3573 

3440<h3 id="readmcpresource">3574<h3 id="readmcpresource">


3457```python theme={null}3591```python theme={null}

3458{3592{

3459 "contents": [3593 "contents": [

3460 {"uri": str, "mimeType": str | None, "text": str | None, "blob": str | None}3594 {

3595 "uri": str, # URI sumber daya

3596 "mimeType": str | None, # Tipe MIME opsional

3597 "text": str | None, # Konten teks, atau catatan tentang konten biner

3598 "blobSavedTo": str | None, # Hadir ketika Claude Code menyimpan konten biner ke disk; jalur file yang disimpan

3599 }

3461 ],3600 ],

3462 "server": str,3601 "error": str | None, # Hadir ketika server tidak dapat membaca sumber daya

3463}3602}

3464```3603```

3465 3604 

Details

716| `reloadOutputStyles()` | Re-reads [output styles](/docs/id/output-styles) dari disk, sehingga style file yang Anda tambahkan atau edit mid-session menjadi tersedia untuk running session. Resolves dengan [`SDKControlReloadOutputStylesResponse`](#sdkcontrolreloadoutputstylesresponse) yang mencantumkan style names yang tersedia setelah reload. Memerlukan Agent SDK v0.3.261 atau lebih baru |716| `reloadOutputStyles()` | Re-reads [output styles](/docs/id/output-styles) dari disk, sehingga style file yang Anda tambahkan atau edit mid-session menjadi tersedia untuk running session. Resolves dengan [`SDKControlReloadOutputStylesResponse`](#sdkcontrolreloadoutputstylesresponse) yang mencantumkan style names yang tersedia setelah reload. Memerlukan Agent SDK v0.3.261 atau lebih baru |

717| `accountInfo()` | Mengembalikan account information |717| `accountInfo()` | Mengembalikan account information |

718| `reconnectMcpServer(serverName)` | Reconnect MCP server berdasarkan nama. Jika nama juga cocok dengan entri dalam settings file seperti `.mcp.json` atau `~/.claude.json`, Claude Code reconnect server yang Anda konfigurasi melalui [`mcpServers`](#options) atau `setMcpServers()`, bukan settings-file entry. Urutan resolusi itu memerlukan Claude Code v2.1.257 atau lebih baru |718| `reconnectMcpServer(serverName)` | Reconnect MCP server berdasarkan nama. Jika nama juga cocok dengan entri dalam settings file seperti `.mcp.json` atau `~/.claude.json`, Claude Code reconnect server yang Anda konfigurasi melalui [`mcpServers`](#options) atau `setMcpServers()`, bukan settings-file entry. Urutan resolusi itu memerlukan Claude Code v2.1.257 atau lebih baru |

719| `toggleMcpServer(serverName, enabled)` | Enable atau disable MCP server berdasarkan nama, dengan name resolution yang sama seperti `reconnectMcpServer()`. Menonaktifkan disconnect server |719| `toggleMcpServer(serverName, enabled)` | Enable atau disable MCP server berdasarkan nama, dengan name resolution yang sama seperti `reconnectMcpServer()`. Menonaktifkan disconnect server stdio, SSE, atau HTTP dan menghapus tools-nya; untuk server yang Anda tambahkan mid-session dengan `setMcpServers()`, tool removal memerlukan Claude Code v2.1.285 atau lebih baru |

720| `setMcpServers(servers)` | Secara dinamis ganti set MCP servers untuk session ini. Resolves dengan [`McpSetServersResult`](#mcpsetserversresult) yang menyebutkan servers mana yang ditambahkan dan dihapus, dan errors apa pun |720| `setMcpServers(servers)` | Secara dinamis ganti set MCP servers untuk session ini. Resolves dengan [`McpSetServersResult`](#mcpsetserversresult) yang menyebutkan servers mana yang ditambahkan dan dihapus, dan errors apa pun |

721| `readMcpResource(serverName, uri)` | *Alpha.* Membaca satu MCP Apps `ui://` resource dari connected MCP server sehingga aplikasi Anda dapat merender widget tool. Resolves dengan [`SDKControlMcpReadResourceResponse`](#sdkcontrolmcpreadresourceresponse). Memerlukan TypeScript Agent SDK v0.3.280 atau lebih baru |721| `readMcpResource(serverName, uri)` | *Alpha.* Membaca satu MCP Apps `ui://` resource dari connected MCP server sehingga aplikasi Anda dapat merender widget tool. Resolves dengan [`SDKControlMcpReadResourceResponse`](#sdkcontrolmcpreadresourceresponse). Memerlukan TypeScript Agent SDK v0.3.280 atau lebih baru |

722| `streamInput(stream)` | Stream input messages ke query untuk multi-turn conversations |722| `streamInput(stream)` | Stream input messages ke query untuk multi-turn conversations |


1275 | "bypassPermissions" // Bypass permission checks; explicit ask rules masih prompt1275 | "bypassPermissions" // Bypass permission checks; explicit ask rules masih prompt

1276 | "plan" // Planning mode - explore tanpa editing1276 | "plan" // Planning mode - explore tanpa editing

1277 | "dontAsk" // Jangan prompt untuk permissions, deny jika tidak pre-approved1277 | "dontAsk" // Jangan prompt untuk permissions, deny jika tidak pre-approved

1278 | "auto"; // Model classifier approves atau denies permission prompts1278 | "auto"; // Model classifier meninjau actions seperti shell commands dan network requests

1279```1279```

1280 1280 

1281<h3 id="canusetool">1281<h3 id="canusetool">


1708* `resume_reason`: mengapa Claude Code menjalankan kembali giliran ini setelah gangguan interupsi. Hadir pada kedua lengan, dan hanya pada re-run seperti itu. Lihat [`resume_reason`](#resume_reason).1708* `resume_reason`: mengapa Claude Code menjalankan kembali giliran ini setelah gangguan interupsi. Hadir pada kedua lengan, dan hanya pada re-run seperti itu. Lihat [`resume_reason`](#resume_reason).

1709* `local_command`: nama perintah yang dijalankan giliran, pada hasil kesuksesan giliran yang perintah selesai tanpa memasuki loop agen, seperti `/compact`. Nama dilipat menjadi huruf kecil dan garis bawah, jadi `/reload-plugins` melaporkan `reload_plugins`. Perintah yang server MCP sediakan, dan `/mcp` bawaan, melaporkan `mcp`. Perintah yang Anda tentukan sendiri melaporkan `custom`. Argumen tidak pernah disertakan. Tidak ada pada setiap giliran yang memasuki loop agen dan pada pengiriman yang tidak menjalankan perintah. Memerlukan Agent SDK v0.3.268 atau lebih baru.1709* `local_command`: nama perintah yang dijalankan giliran, pada hasil kesuksesan giliran yang perintah selesai tanpa memasuki loop agen, seperti `/compact`. Nama dilipat menjadi huruf kecil dan garis bawah, jadi `/reload-plugins` melaporkan `reload_plugins`. Perintah yang server MCP sediakan, dan `/mcp` bawaan, melaporkan `mcp`. Perintah yang Anda tentukan sendiri melaporkan `custom`. Argumen tidak pernah disertakan. Tidak ada pada setiap giliran yang memasuki loop agen dan pada pengiriman yang tidak menjalankan perintah. Memerlukan Agent SDK v0.3.268 atau lebih baru.

1710* `request_sent_wall_ms`: epoch milidetik di mana Claude Code mengirim permintaan API, untuk bergabung dengan stempel waktu sisi server. Hadir hanya bersama dengan [`user_message_uuid`](#user_message_uuid), pada hasil kesuksesan dengan `is_error` false yang gilirannya mengirim permintaan API.1710* `request_sent_wall_ms`: epoch milidetik di mana Claude Code mengirim permintaan API, untuk bergabung dengan stempel waktu sisi server. Hadir hanya bersama dengan [`user_message_uuid`](#user_message_uuid), pada hasil kesuksesan dengan `is_error` false yang gilirannya mengirim permintaan API.

1711* `first_content_frame_ms`: waktu dalam milidetik hingga acara aliran `content_block_start` atau `content_block_delta` pertama, menghitung blok pemikiran sebagai konten. Hadir pada lengan kesuksesan hanya, ketika `is_error` adalah false. Memerlukan Agent SDK v0.3.260 atau lebih baru.1711*

1712* `first_stream_post_ms`, `first_stream_post_ack_ms`, `first_stream_post_wall_ms`: waktu untuk mengunggah acara aliran pertama giliran. Claude Code merekamnya hanya dalam sesi yang dialirkan ke claude.ai, seperti [sesi cloud](/docs/id/claude-code-on-the-web), dan hasil yang `query()` hasilkan tidak membawanya. Memerlukan Agent SDK v0.3.260 atau lebih baru.1712 

1713`first_content_frame_ms`: waktu dalam milidetik hingga acara aliran `content_block_start` atau `content_block_delta` pertama, menghitung blok pemikiran sebagai konten. Hadir pada lengan kesuksesan hanya, ketika `is_error` adalah false. Memerlukan Agent SDK v0.3.260 atau lebih baru.

1714 

1715*

1716 

1717`first_stream_post_ms`, `first_stream_post_ack_ms`, `first_stream_post_wall_ms`: waktu untuk mengunggah acara aliran pertama giliran. Claude Code merekamnya hanya dalam sesi yang dialirkan ke claude.ai, seperti [sesi cloud](/docs/id/claude-code-on-the-web), dan hasil yang `query()` hasilkan tidak membawanya. Memerlukan Agent SDK v0.3.260 atau lebih baru.

1718 

1713* `usage`: loop agen utama saja. Mengecualikan panggilan subagen dan model tambahan, dan per-giliran dalam sesi input streaming. Lebih suka `modelUsage` untuk akuntansi token/biaya.1719* `usage`: loop agen utama saja. Mengecualikan panggilan subagen dan model tambahan, dan per-giliran dalam sesi input streaming. Lebih suka `modelUsage` untuk akuntansi token/biaya.

1714* `modelUsage`: total per-model untuk setiap panggilan model yang dibuat melalui pipeline kueri selama panggilan `query()` ini, termasuk loop utama, subagen, dan panggilan internal seperti pemadatan dan agen Workflow. Panggilan pembantu di luar pipeline itu, seperti pengklasifikasi izin dan permintaan penghitungan token, dikecualikan. Panggilan yang melanjutkan sesi juga menghitung [total per-model yang dipulihkan dari panggilan sebelumnya sesi](/docs/id/agent-sdk/cost-tracking#accumulate-costs-across-multiple-calls). Dalam sesi input streaming total bersifat kumulatif di seluruh giliran, jadi baca hasil terbaru daripada menjumlahkan di seluruh hasil. Lihat [Lacak biaya dalam mode input streaming](/docs/id/agent-sdk/cost-tracking#track-costs-in-streaming-input-mode) untuk pengaturan ulang dan [Pulihkan total setelah kerusakan sesi](/docs/id/agent-sdk/cost-tracking#recover-totals-after-a-session-crash) untuk hasil yang dinolkan.1720* `modelUsage`: total per-model untuk setiap panggilan model yang dibuat melalui pipeline kueri selama panggilan `query()` ini, termasuk loop utama, subagen, dan panggilan internal seperti pemadatan dan agen Workflow. Panggilan pembantu di luar pipeline itu, seperti pengklasifikasi izin dan permintaan penghitungan token, dikecualikan. Panggilan yang melanjutkan sesi juga menghitung [total per-model yang dipulihkan dari panggilan sebelumnya sesi](/docs/id/agent-sdk/cost-tracking#accumulate-costs-across-multiple-calls). Dalam sesi input streaming total bersifat kumulatif di seluruh giliran, jadi baca hasil terbaru daripada menjumlahkan di seluruh hasil. Lihat [Lacak biaya dalam mode input streaming](/docs/id/agent-sdk/cost-tracking#track-costs-in-streaming-input-mode) untuk pengaturan ulang dan [Pulihkan total setelah kerusakan sesi](/docs/id/agent-sdk/cost-tracking#recover-totals-after-a-session-crash) untuk hasil yang dinolkan.

1715* `total_cost_usd`: biaya perkiraan kumulatif dalam USD, mencakup panggilan yang sama dengan `modelUsage` dan pengaturan ulang pada titik yang sama. Panggilan yang melanjutkan sesi juga menghitung [total yang dipulihkan dari panggilan sebelumnya sesi](/docs/id/agent-sdk/cost-tracking#accumulate-costs-across-multiple-calls). Ini adalah perkiraan, bukan pernyataan penagihan. Lihat [Lacak biaya dan penggunaan](/docs/id/agent-sdk/cost-tracking) untuk peringatan akurasi.1721* `total_cost_usd`: biaya perkiraan kumulatif dalam USD, mencakup panggilan yang sama dengan `modelUsage` dan pengaturan ulang pada titik yang sama. Panggilan yang melanjutkan sesi juga menghitung [total yang dipulihkan dari panggilan sebelumnya sesi](/docs/id/agent-sdk/cost-tracking#accumulate-costs-across-multiple-calls). Ini adalah perkiraan, bukan pernyataan penagihan. Lihat [Lacak biaya dan penggunaan](/docs/id/agent-sdk/cost-tracking) untuk peringatan akurasi.

1716* `queued_turn_count`: jumlah pesan yang Anda kirim dengan `origin: { kind: "human" }` yang masih menunggu ketika Claude Code menghasilkan hasil. Lihat [`queued_turn_count`](#queued_turn_count) untuk apa yang `0` dan bidang yang tidak ada katakan.1722* `queued_turn_count`: jumlah pesan yang Anda kirim dengan `origin: { kind: "human" }` yang masih menunggu ketika Claude Code menghasilkan hasil. Lihat [`queued_turn_count`](#queued_turn_count) untuk apa yang `0` dan bidang yang tidak ada katakan.

1717* `result_index`: di mana hasil ini jatuh dalam urutan pengiriman jalankan, menghitung dari 0 di seluruh setiap hasil yang ditulis proses. Hadir pada kedua lengan. Hasil yang penulisannya gagal masih menggunakan nomornya, jadi celah dalam urutan berarti hasil hilang. Memerlukan Agent SDK v0.3.268 atau lebih baru.1723*

1718* `startup_failure_reason`: mengapa Claude Code menolak untuk memulai, pada hasil `error_during_execution` yang ditulis sebelum keluar pada kegagalan startup yang diketahui. Lihat [`startup_failure_reason`](#startup_failure_reason) untuk nilai-nilai dan kegagalan mana yang membawanya. Memerlukan Agent SDK v0.3.274 atau lebih baru.1724 

1725`result_index`: di mana hasil ini jatuh dalam urutan pengiriman jalankan, menghitung dari 0 di seluruh setiap hasil yang ditulis proses. Hadir pada kedua lengan. Hasil yang penulisannya gagal masih menggunakan nomornya, jadi celah dalam urutan berarti hasil hilang. Memerlukan Agent SDK v0.3.268 atau lebih baru.

1726 

1727*

1728 

1729`startup_failure_reason`: mengapa Claude Code menolak untuk memulai, pada hasil `error_during_execution` yang ditulis sebelum keluar pada kegagalan startup yang diketahui. Lihat [`startup_failure_reason`](#startup_failure_reason) untuk nilai-nilai dan kegagalan mana yang membawanya. Memerlukan Agent SDK v0.3.274 atau lebih baru.

1730 

1719* `terminal_reason`: mengapa loop berakhir. Salah satu dari `"completed"`, `"max_turns"`, `"tool_deferred"`, `"aborted_streaming"`, `"aborted_tools"`, `"hook_stopped"`, `"stop_hook_prevented"`, `"background_requested"`, `"blocking_limit"`, `"rapid_refill_breaker"`, `"prompt_too_long"`, `"image_error"`, `"model_error"`, `"api_error"`, `"malformed_tool_use_exhausted"`, `"budget_exhausted"`, `"structured_output_retry_exhausted"`, `"tool_deferred_unavailable"`, atau `"turn_setup_failed"`.1731* `terminal_reason`: mengapa loop berakhir. Salah satu dari `"completed"`, `"max_turns"`, `"tool_deferred"`, `"aborted_streaming"`, `"aborted_tools"`, `"hook_stopped"`, `"stop_hook_prevented"`, `"background_requested"`, `"blocking_limit"`, `"rapid_refill_breaker"`, `"prompt_too_long"`, `"image_error"`, `"model_error"`, `"api_error"`, `"malformed_tool_use_exhausted"`, `"budget_exhausted"`, `"structured_output_retry_exhausted"`, `"tool_deferred_unavailable"`, atau `"turn_setup_failed"`.

1720* `fast_mode_state`: salah satu dari `"on"`, `"off"`, atau `"cooldown"`.1732* `fast_mode_state`: salah satu dari `"on"`, `"off"`, atau `"cooldown"`.

1721* `fast_mode_disabled_reason`: mengapa [fast mode](/docs/id/fast-mode) tidak tersedia sekarang. Tidak ada ketika tidak ada yang memblokir fast mode, meskipun permintaan mungkin masih berjalan dengan kecepatan standar. Selama cooldown setelah batas laju fast mode, Claude Code melaporkan `fast_mode_state: "cooldown"` tanpa kode alasan dan mengaktifkan kembali fast mode ketika cooldown berakhir. Memerlukan Claude Code v2.1.219 atau lebih baru.1733* `fast_mode_disabled_reason`: mengapa [fast mode](/docs/id/fast-mode) tidak tersedia sekarang. Tidak ada ketika tidak ada yang memblokir fast mode, meskipun permintaan mungkin masih berjalan dengan kecepatan standar. Selama cooldown setelah batas laju fast mode, Claude Code melaporkan `fast_mode_state: "cooldown"` tanpa kode alasan dan mengaktifkan kembali fast mode ketika cooldown berakhir. Memerlukan Claude Code v2.1.219 atau lebih baru.


1821```typescript theme={null}1833```typescript theme={null}

1822type SDKStartupFailureReason =1834type SDKStartupFailureReason =

1823 | "org_pin_api_key_conflict"1835 | "org_pin_api_key_conflict"

1836 | "provider_not_allowed"

1824 | "org_verify_failed"1837 | "org_verify_failed"

1825 | "org_pin_mismatch"1838 | "org_pin_mismatch"

1826 | "managed_settings_invalid"1839 | "managed_settings_invalid"


1843| Nilai | Apa yang menghentikan sesi |1856| Nilai | Apa yang menghentikan sesi |

1844| :- | :- |1857| :- | :- |

1845| `org_pin_api_key_conflict` | Pengaturan terkelola [memerlukan masuk gateway first-party atau Cloud](/docs/id/authentication#restrict-login-to-your-organization), dan kunci API Anthropic, token auth, atau `apiKeyHelper` dikonfigurasi sebagai gantinya |1858| `org_pin_api_key_conflict` | Pengaturan terkelola [memerlukan masuk gateway first-party atau Cloud](/docs/id/authentication#restrict-login-to-your-organization), dan kunci API Anthropic, token auth, atau `apiKeyHelper` dikonfigurasi sebagai gantinya |

1859| `provider_not_allowed` | Pengaturan terkelola [mencantumkan penyedia API yang mesin ini boleh gunakan](/docs/id/settings-reference#allowedproviders), dan sesi diatur untuk penyedia yang tidak tercantum, atau untuk endpoint yang pengaturan tidak pin. Memerlukan Claude Code v2.1.285 atau lebih baru |

1846| `org_verify_failed` | Organisasi masuk tidak dapat diverifikasi terhadap pin, misalnya karena kegagalan jaringan atau token yang dicabut |1860| `org_verify_failed` | Organisasi masuk tidak dapat diverifikasi terhadap pin, misalnya karena kegagalan jaringan atau token yang dicabut |

1847| `org_pin_mismatch` | Masuk milik organisasi yang pin tidak izinkan |1861| `org_pin_mismatch` | Masuk milik organisasi yang pin tidak izinkan |

1848| `managed_settings_invalid` | Pengaturan kebijakan terkelola tidak dapat dibaca, pin tidak menamai organisasi, atau [pembatasan model terkelola](/docs/id/errors#managed-settings-block-the-default-model) tidak meninggalkan model yang diizinkan untuk opsi Default |1862| `managed_settings_invalid` | Pengaturan kebijakan terkelola tidak dapat dibaca, pin tidak menamai organisasi, atau [pembatasan model terkelola](/docs/id/errors#managed-settings-block-the-default-model) tidak meninggalkan model yang diizinkan untuk opsi Default |


3206};3220};

3207```3221```

3208 3222 

3209Mengeksekusi perintah Bash dengan timeout opsional dan eksekusi latar belakang. Direktori kerja tetap ada di antara perintah, termasuk perintah yang dijalankan di putaran berikutnya dari sesi multi-putaran; status shell seperti variabel lingkungan yang diekspor tidak. Untuk batas pada perubahan direktori mana yang bertahan, lihat [Apa yang bertahan di antara perintah](/docs/id/tools-reference#what-persists-between-commands). Untuk apa yang menetapkan batas latar depan, lihat [Timeout dan batas output](/docs/id/tools-reference#timeout-and-output-limits). Untuk batas waktu latar belakang, lihat [Perintah latar belakang](/docs/id/tools-reference#background-commands).3223Mengeksekusi perintah Bash dengan timeout opsional dan eksekusi latar belakang. Direktori kerja tetap ada di antara perintah, termasuk perintah yang dijalankan di putaran berikutnya dari sesi multi-putaran; status shell seperti variabel lingkungan yang diekspor tidak. Untuk batas pada perubahan direktori mana yang bertahan, lihat [Apa yang bertahan di antara perintah](/docs/id/tools-reference#what-persists-between-commands). Untuk apa yang menetapkan batas latar depan, lihat [Timeout dan batas output](/docs/id/tools-reference#timeout-and-output-limits). Untuk batas waktu latar belakang, lihat [Batas waktu untuk perintah latar belakang](/docs/id/tools-reference#time-limit-for-background-commands).

3210 3224 

3211<h3 id="monitor">3225<h3 id="monitor">

3212 Monitor3226 Monitor


4110 4124 

4111`timedOutAfterMs` adalah timeout dalam milidetik, diatur ketika perintah mencapai timeout dan berpindah ke latar belakang daripada dimulai di sana secara eksplisit. `backgroundCwdHint` diatur ketika perintah backgrounded berisi builtin perubahan direktori seperti `cd`, `pushd`, `popd`, atau `chdir`, dan mencatat bahwa direktori kerja sesi tidak berubah. Kedua field memerlukan Claude Code v2.1.210 atau lebih baru.4125`timedOutAfterMs` adalah timeout dalam milidetik, diatur ketika perintah mencapai timeout dan berpindah ke latar belakang daripada dimulai di sana secara eksplisit. `backgroundCwdHint` diatur ketika perintah backgrounded berisi builtin perubahan direktori seperti `cd`, `pushd`, `popd`, atau `chdir`, dan mencatat bahwa direktori kerja sesi tidak berubah. Kedua field memerlukan Claude Code v2.1.210 atau lebih baru.

4112 4126 

4113Ketika subagen yang berjalan di foreground memiliki perintah backgrounded, perintah [berakhir ketika run subagen tersebut berakhir](/docs/id/tools-reference#background-commands). Claude Code menetapkan `backgroundEndsWithFinalResponse` ke `true` pada perintah tersebut, dan menghilangkan field ketika perintah bertahan dalam turn, seperti perintah yang dimulai oleh percakapan utama atau oleh subagen latar belakang. Field memerlukan Claude Code v2.1.227 atau lebih baru.4127Ketika subagen yang berjalan di foreground memiliki perintah backgrounded, perintah [berakhir ketika run subagen tersebut berakhir](/docs/id/tools-reference#when-a-background-command-stops). Claude Code menetapkan `backgroundEndsWithFinalResponse` ke `true` pada perintah tersebut, dan menghilangkan field ketika perintah bertahan dalam turn, seperti perintah yang dimulai oleh percakapan utama atau oleh subagen latar belakang. Field memerlukan Claude Code v2.1.227 atau lebih baru.

4114 4128 

4115Claude Code menetapkan `gitOperation.commit.branch` ke cabang yang dinamai dalam baris ringkasan commit git, dan menghilangkannya untuk commit yang dibuat pada HEAD terpisah. Field memerlukan Agent SDK v0.3.227 atau lebih baru. Claude Code melaporkan perintah `gh pr reopen` sebagai aksi PR `reopened`, yang memerlukan Agent SDK v0.3.234 atau lebih baru.4129Claude Code menetapkan `gitOperation.commit.branch` ke cabang yang dinamai dalam baris ringkasan commit git, dan menghilangkannya untuk commit yang dibuat pada HEAD terpisah. Field memerlukan Agent SDK v0.3.227 atau lebih baru. Claude Code melaporkan perintah `gh pr reopen` sebagai aksi PR `reopened`, yang memerlukan Agent SDK v0.3.234 atau lebih baru.

4116 4130 

agent-view.md +3 −21

Details

8 8 

9Tampilan agen, dibuka dengan `claude agents`, adalah satu layar untuk semua sesi latar belakang Anda: apa yang sedang berjalan, apa yang membutuhkan masukan Anda, dan apa yang sudah selesai. Kirim sesi baru, pantau keadaan mereka sekilas alih-alih menggulir transkrip, dan campur tangan hanya ketika ada yang membutuhkan Anda. Setiap sesi latar belakang adalah percakapan Claude Code lengkap yang terus berjalan tanpa terminal yang terpasang, sehingga Anda dapat membukanya, membalas, dan pergi kapan saja.9Tampilan agen, dibuka dengan `claude agents`, adalah satu layar untuk semua sesi latar belakang Anda: apa yang sedang berjalan, apa yang membutuhkan masukan Anda, dan apa yang sudah selesai. Kirim sesi baru, pantau keadaan mereka sekilas alih-alih menggulir transkrip, dan campur tangan hanya ketika ada yang membutuhkan Anda. Setiap sesi latar belakang adalah percakapan Claude Code lengkap yang terus berjalan tanpa terminal yang terpasang, sehingga Anda dapat membukanya, membalas, dan pergi kapan saja.

10 10 

11<img src="https://mintcdn.com/claude-code/1B48Qz2Z9hac4SLG/images/agent-view-light.png?fit=max&auto=format&n=1B48Qz2Z9hac4SLG&q=85&s=7a186c96ed47d6700d084d77e786be65" className="dark:hidden" alt="Tampilan agen di terminal: header menunjukkan Claude Code v2.1.140, model, direktori kerja, dan ringkasan jumlah. Sesi dikelompokkan di bawah Membutuhkan masukan, Bekerja, dan Selesai, dengan input pengiriman di bagian bawah dan footer petunjuk keyboard." width="1772" height="780" data-path="images/agent-view-light.png" />11<img src="https://mintcdn.com/claude-code/HDAmBwgbrZVk0pOt/images/agent-view-light.png?fit=max&auto=format&n=HDAmBwgbrZVk0pOt&q=85&s=d6905012bee31f3e6b3920b09c05dd02" className="dark:hidden" alt="Tampilan agen di terminal. Baris di bagian atas menghitung sesi yang menunggu masukan, bekerja, dan selesai. Empat sesi dikelompokkan di bawah Membutuhkan masukan, Bekerja, dan Selesai. Setiap baris menunjukkan nama sesi, status atau pertanyaan terakhirnya, dan waktu. Di bagian bawah adalah input untuk mendeskripsikan tugas baru dan baris petunjuk keyboard." width="1872" height="680" data-path="images/agent-view-light.png" />

12 12 

13<img src="https://mintcdn.com/claude-code/1B48Qz2Z9hac4SLG/images/agent-view-dark.png?fit=max&auto=format&n=1B48Qz2Z9hac4SLG&q=85&s=a5bed7434bae368faea3a8f023b52aa2" className="hidden dark:block" alt="Tampilan agen di terminal: header menunjukkan Claude Code v2.1.140, model, direktori kerja, dan ringkasan jumlah. Sesi dikelompokkan di bawah Membutuhkan masukan, Bekerja, dan Selesai, dengan input pengiriman di bagian bawah dan footer petunjuk keyboard." width="1772" height="780" data-path="images/agent-view-dark.png" />13<img src="https://mintcdn.com/claude-code/HDAmBwgbrZVk0pOt/images/agent-view-dark.png?fit=max&auto=format&n=HDAmBwgbrZVk0pOt&q=85&s=fc3c195bfc57e313ced1f1beb36cee93" className="hidden dark:block" alt="Tampilan agen di terminal. Baris di bagian atas menghitung sesi yang menunggu masukan, bekerja, dan selesai. Empat sesi dikelompokkan di bawah Membutuhkan masukan, Bekerja, dan Selesai. Setiap baris menunjukkan nama sesi, status atau pertanyaan terakhirnya, dan waktu. Di bagian bawah adalah input untuk mendeskripsikan tugas baru dan baris petunjuk keyboard." width="1872" height="680" data-path="images/agent-view-dark.png" />

14 14 

15Gunakan tampilan agen ketika Anda memiliki beberapa tugas independen yang dapat dikerjakan Claude tanpa Anda menonton setiap langkah. Kirim perbaikan bug, tinjauan permintaan tarik, dan investigasi tes yang tidak stabil sebagai tiga baris, terus bekerja di jendela lain, dan periksa kembali ketika baris menunjukkan bahwa itu membutuhkan Anda atau memiliki hasil.15Gunakan tampilan agen ketika Anda memiliki beberapa tugas independen yang dapat dikerjakan Claude tanpa Anda menonton setiap langkah. Kirim perbaikan bug, tinjauan permintaan tarik, dan investigasi tes yang tidak stabil sebagai tiga baris, terus bekerja di jendela lain, dan periksa kembali ketika baris menunjukkan bahwa itu membutuhkan Anda atau memiliki hasil.

16 16 


966 966 

967Claude Code tidak pernah memulai ulang baris yang menjalankan [perintah shell](#run-a-shell-command), dari `Enter` atau dari `claude attach`, karena itu akan menjalankan perintah lagi; pesan baris dan `claude attach` keduanya mengatakan perintah tidak dijalankan lagi.967Claude Code tidak pernah memulai ulang baris yang menjalankan [perintah shell](#run-a-shell-command), dari `Enter` atau dari `claude attach`, karena itu akan menjalankan perintah lagi; pesan baris dan `claude attach` keduanya mengatakan perintah tidak dijalankan lagi.

968 968 

969<h4 id="terminal-host-died">

970 Host terminal mati

971</h4>

972 

973Di Linux dan WSL, supervisor memeriksa setiap proses host setiap beberapa detik, apakah Anda membuka sesi atau tidak, dan menandai sesi gagal ketika proses telah keluar tetapi koneksinya ke supervisor tidak pernah ditutup.

974 

975* Dalam tampilan agen, baris menampilkan `terminal host process died — press Enter to restart`. Tekan `Enter` padanya dan Claude Code memulai ulang sesi pada proses host yang segar.

976* Dari shell, `claude attach <id>` memulai ulang sesi yang sudah ditandai gagal. Jika tidak, itu melaporkan penyebabnya dan keluar, memberi tahu Anda untuk menjalankan `claude attach <id>` lagi.

977 

978<h4 id="session-isn’t-responding">

979 Sesi tidak merespons

980</h4>

981 

982Ketika supervisor menerima pembukaan tetapi tidak ada output yang tiba selama sekitar sepuluh detik, Claude Code mengakhiri upaya dan menawarkan restart. Sesi yang hanya macet, misalnya di seluruh sleep mesin, tidak mencapai penawaran ini: supervisor [memulai ulangnya saat dibuka](#read-session-state) itu sendiri.

983 

984* Dalam tampilan agen, footer menampilkan `Press enter again to restart this session — it isn't responding (its conversation is saved and resumes).` Tekan `Enter` pada baris yang sama lagi dan Claude Code menghentikan proses yang tidak merespons dan memulai ulang sesi; itu tidak menghentikan apa pun tanpa tekan kedua itu.

985* Dari shell, `claude attach <id>` melaporkan penyebabnya dan keluar, memberi tahu Anda untuk menjalankan `claude stop <id>`, kemudian `claude attach <id>`.

986 

987<h3 id="a-session-fails-before-starting-with-a-possibly-low-memory-note">969<h3 id="a-session-fails-before-starting-with-a-possibly-low-memory-note">

988 Sesi gagal sebelum dimulai dengan catatan `possibly low memory`970 Sesi gagal sebelum dimulai dengan catatan `possibly low memory`

989</h3>971</h3>


1044 Sesi lambat merespons setelah melampirkan1026 Sesi lambat merespons setelah melampirkan

1045</h3>1027</h3>

1046 1028 

1047Setelah sesi selesai dan duduk tanpa lampiran selama sekitar satu jam, supervisor menghentikan prosesnya untuk membebaskan sumber daya. Melampirkan memulai proses segar dari tempat ia berhenti dan beralih ke sesi segera sementara proses dimulai ulang. Sesi yang bekerja, menunggu Anda, atau [disematkan](#organize-the-list) tidak dihentikan dengan cara ini, jadi semat sesi dengan `Ctrl+T` untuk menjaganya tetap responsif.1029Setelah sesi selesai atau menunggu pesan berikutnya Anda tetap tidak terlampir selama sekitar satu jam, supervisor menghentikan prosesnya untuk membebaskan sumber daya. Melampirkan memulai proses segar dari tempat ia berhenti dan beralih ke sesi segera sementara proses dimulai ulang. Sesi yang bekerja, dijeda pada prompt izin atau dialog lainnya, atau [disematkan](#organize-the-list) tidak dihentikan dengan cara ini, jadi semat sesi dengan `Ctrl+T` untuk menjaganya tetap responsif.

1048 1030 

1049Saat proses dimulai, Claude Code menampilkan ekor transkrip sesi yang diformat dengan cara sesi langsung merender, dengan markdown, blok kode yang disorot, dan panggilan alat sebagai baris yang redup, di atas area prompt yang redup dengan catatan `Session is starting`. Sesi langsung menggantikannya segera setelah siap.1031Saat proses dimulai, Claude Code menampilkan ekor transkrip sesi yang diformat dengan cara sesi langsung merender, dengan markdown, blok kode yang disorot, dan panggilan alat sebagai baris yang redup, di atas area prompt yang redup dengan catatan `Session is starting`. Sesi langsung menggantikannya segera setelah siap.

1050 1032 

Details

384 384 

385Alias model seperti `opus` tidak bertindak sebagai pin, begitu juga ID model yang tidak dikenali Claude Code, seperti profil inferensi aplikasi ARN.385Alias model seperti `opus` tidak bertindak sebagai pin, begitu juga ID model yang tidak dikenali Claude Code, seperti profil inferensi aplikasi ARN.

386 386 

387Ketika pemeriksaan ini menemukan model yang akun Anda tidak dapat memanggil, Claude Code mengingat penolakan di mesin ini selama satu hari, dan peluncuran selama waktu itu melewati model yang diingat tanpa bertanya kepada Amazon Bedrock lagi. Claude Code memeriksa penolakan yang diingat dari model default saat ini lagi saat peluncuran setelah sepuluh menit telah berlalu sejak pemeriksaan terakhir, sehingga default yang administrator Anda aktifkan kembali. Untuk mematikan memori, atur [`CLAUDE_CODE_SKIP_MODEL_ACCESS_MEMORY=1`](/docs/id/env-vars).

388 

389<h3 id="when-a-model-is-disabled-mid-session">

390 Ketika model dinonaktifkan di tengah sesi

391</h3>

392 

393Jika akun Anda kehilangan akses ke model yang sesi Anda jalankan, misalnya karena administrator menonaktifkannya di akun Amazon Bedrock Anda, Claude Code beralih sesi ke model lain alih-alih gagal pada setiap permintaan, dan menampilkan `Switched to <fallback> because <model> is not available`. Claude Code mencoba model yang sama seperti fallback startup: versi sebelumnya dari tier yang sama terlebih dahulu dan, untuk sesi Opus tanpa versi Opus yang tersedia, model Sonnet default.

394 

395Pengalihan hanya berlaku untuk tier yang belum Anda sematkan, kondisi yang sama seperti fallback startup. Sesi pada versi spesifik yang Anda pilih, atau pada [profil inferensi aplikasi ARN](#map-each-model-version-to-an-inference-profile), mempertahankan modelnya dan, tanpa rantai fallback model, permintaan gagal sebagai gantinya. Dalam [mode auto](/docs/id/permission-modes#enable-auto-mode-on-bedrock-agent-platform-or-foundry), Claude Code hanya beralih ke model yang didukung mode auto di Amazon Bedrock. Jika tidak ada model tersebut yang tersedia, permintaan gagal dengan [AWS authentication failed](/docs/id/errors#aws-authentication-failed) dan petunjuk untuk mengaktifkan model.

396 

397[Rantai fallback model](/docs/id/model-config#fallback-model-chains) yang Anda konfigurasi menggantikan pengalihan tier: pada penolakan ini Claude Code beralih ke fallback yang Anda konfigurasi sebagai gantinya. Untuk membuat permintaan yang ditolak gagal daripada beralih, atur [`CLAUDE_CODE_DISABLE_MODEL_ACCESS_FALLBACK=1`](/docs/id/env-vars). Rantai fallback yang Anda konfigurasi masih beralih pada penolakan ini; hapus rantai juga jika Anda ingin setiap permintaan yang ditolak gagal.

398 

387<h2 id="cross-region-inference-profile-prefixes">399<h2 id="cross-region-inference-profile-prefixes">

388 Prefiks profil inferensi lintas wilayah400 Prefiks profil inferensi lintas wilayah

389</h2>401</h2>

artifacts.md +1 −1

Details

398| [Variabel lingkungan](/docs/id/env-vars) | Atur `CLAUDE_CODE_DISABLE_ARTIFACT=1` |398| [Variabel lingkungan](/docs/id/env-vars) | Atur `CLAUDE_CODE_DISABLE_ARTIFACT=1` |

399| [Aturan izin](/docs/id/permissions) | Tambahkan `Artifact` ke `permissions.deny` |399| [Aturan izin](/docs/id/permissions) | Tambahkan `Artifact` ke `permissions.deny` |

400 400 

401Setelah Anda mematikan artifacts dalam file [`--settings`](/docs/id/cli-reference#cli-flags) atau dengan `CLAUDE_CODE_DISABLE_ARTIFACT`, atau administrator Anda mematikannya dalam [pengaturan terkelola](/docs/id/server-managed-settings), tidak ada file pengaturan yang menyalakannya kembali. Sebelum v2.1.242, file yang lebih tinggi dalam [tumpukan prioritas](/docs/id/settings#settings-precedence) dapat menyalakan artifacts kembali bahkan ketika file dengan prioritas lebih rendah menetapkan `"enableArtifact": false`.401Setelah Anda mematikan artifacts dalam file [`--settings`](/docs/id/cli-reference#cli-flags) atau dengan `CLAUDE_CODE_DISABLE_ARTIFACT`, atau administrator Anda mematikannya dalam [pengaturan terkelola](/docs/id/server-managed-settings), tidak ada file pengaturan yang menyalakannya kembali.

402 402 

403Anda juga dapat menetapkan `"enableArtifact": false` dalam `.claude/settings.json` atau `.claude/settings.local.json` proyek untuk mematikan artifacts untuk sesi dalam proyek tersebut. `"enableArtifact": true` di salah satu file tidak menyalakannya kembali. Menghormati kunci dalam pengaturan proyek dan lokal memerlukan Claude Code v2.1.242 atau lebih baru.403Anda juga dapat menetapkan `"enableArtifact": false` dalam `.claude/settings.json` atau `.claude/settings.local.json` proyek untuk mematikan artifacts untuk sesi dalam proyek tersebut. `"enableArtifact": true` di salah satu file tidak menyalakannya kembali. Menghormati kunci dalam pengaturan proyek dan lokal memerlukan Claude Code v2.1.242 atau lebih baru.

404 404 

Details

194* **Sesi penyedia cloud seperti Amazon Bedrock**: diblokir hanya saat kredensial `ANTHROPIC_API_KEY`, `ANTHROPIC_AUTH_TOKEN`, atau `apiKeyHelper`, atau kunci API yang disimpan oleh login Claude Console sebelumnya, masih ada di mesin. Hapusnya dan sesi dimulai. Sesi ini mengautentikasi terhadap penyedia cloud Anda, yang kebijakan akses mereka mengaturnya194* **Sesi penyedia cloud seperti Amazon Bedrock**: diblokir hanya saat kredensial `ANTHROPIC_API_KEY`, `ANTHROPIC_AUTH_TOKEN`, atau `apiKeyHelper`, atau kunci API yang disimpan oleh login Claude Console sebelumnya, masih ada di mesin. Hapusnya dan sesi dimulai. Sesi ini mengautentikasi terhadap penyedia cloud Anda, yang kebijakan akses mereka mengaturnya

195* **[Profil Anthropic atau kredensial federasi](#anthropic-profiles-and-federation-credentials)**: tidak diblokir kecuali kredensial `ANTHROPIC_API_KEY`, `ANTHROPIC_AUTH_TOKEN`, atau `apiKeyHelper`, atau kunci API yang disimpan oleh login Claude Console sebelumnya, juga ada di mesin. Kunci tidak memeriksa organisasi mana yang dimiliki profil195* **[Profil Anthropic atau kredensial federasi](#anthropic-profiles-and-federation-credentials)**: tidak diblokir kecuali kredensial `ANTHROPIC_API_KEY`, `ANTHROPIC_AUTH_TOKEN`, atau `apiKeyHelper`, atau kunci API yang disimpan oleh login Claude Console sebelumnya, juga ada di mesin. Kunci tidak memeriksa organisasi mana yang dimiliki profil

196 196 

197<h3 id="restrict-which-api-providers-a-machine-may-use">

198 Batasi penyedia API mana yang dapat digunakan mesin

199</h3>

200 

201[`allowedProviders`](/docs/id/settings-reference#allowedproviders) dalam [pengaturan terkelola](/docs/id/managed-settings) mencantumkan layanan mana yang dapat dijangkau mesin terkelola melalui Claude, seperti API Anthropic, Amazon Bedrock, atau gateway LLM. Ini melengkapi `forceLoginMethod` dan `forceLoginOrgUUID`, yang mengatur akun mana yang digunakan sesi ketika berbicara dengan Anthropic. Memerlukan Claude Code v2.1.285 atau lebih baru.

202 

203```json managed-settings.json theme={null}

204{

205 "forceLoginMethod": "claudeai",

206 "forceLoginOrgUUID": ["xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"],

207 "allowedProviders": ["anthropic", "bedrock"]

208}

209```

210 

211Dengan file ini, pengembang yang masuk ke organisasi claude.ai Anda atau dikonfigurasi untuk Amazon Bedrock dimulai secara normal. Sesi yang disiapkan untuk penyedia lain ditolak saat startup, dan sesi yang berjalan yang beralih ke satu ditolak pada permintaan berikutnya. [Pengaturan terkelola tidak mengizinkan penyedia API ini](/docs/id/errors#managed-settings-dont-allow-this-api-provider) menampilkan setiap pesan.

212 

213* **Izinkan gateway LLM atau proxy**: cantumkan `"customEndpoint"` dan atur URL gateway dalam blok `env` terkelola dari sumber yang sama. [Referensi pengaturan](/docs/id/settings-reference#allowedproviders) mencantumkan setiap nilai dan mengatakan variabel endpoint mana yang memerlukan pin `env` terkelola.

214* **Terapkan pada mesin terkelola**: letakkan daftar dalam sumber terkelola yang membawa sisa kebijakan Anda. [Catatan Scope](/docs/id/settings-reference#allowedproviders) entri mengatakan bagaimana daftar yang dikelola server menggabungkan dengannya.

215* **Hanya pengaturan terkelola server**: daftar yang Anda atur hanya dalam [pengaturan terkelola server](/docs/id/server-managed-settings) hanya menjangkau sesi yang mengambil pengaturan organisasi Anda, jadi perlakukan sebagai kenyamanan untuk mesin yang tidak dapat Anda jangkau dengan manajemen perangkat, bukan sebagai penegakan. [Ketersediaan platform](/docs/id/server-managed-settings#platform-availability) mencantumkan sesi mana yang mengambilnya.

216 

197<h2 id="credential-management">217<h2 id="credential-management">

198 Manajemen kredensial218 Manajemen kredensial

199</h2>219</h2>

Details

285 Edit rules from `/permissions`285 Edit rules from `/permissions`

286</h2>286</h2>

287 287 

288Untuk melihat dan mengedit aturan classifier tanpa membuka file pengaturan, jalankan [`/permissions`](/docs/id/permissions#manage-permissions) dan pilih tab **Auto mode**. Tab tersebut memerlukan Claude Code v2.1.246 atau lebih baru, dan hanya muncul ketika [auto mode tersedia](/docs/id/permission-modes#eliminate-prompts-with-auto-mode) untuk sesi Anda.288Untuk melihat dan mengedit aturan classifier dan entri `environment` tanpa membuka file pengaturan, jalankan [`/permissions`](/docs/id/permissions#manage-permissions) dan pilih tab **Auto mode**. Tab tersebut memerlukan Claude Code v2.1.246 atau lebih baru, dan hanya muncul ketika [auto mode tersedia](/docs/id/permission-modes#eliminate-prompts-with-auto-mode) untuk sesi Anda.

289 289 

290Tab ini mencantumkan entri `allow`, `soft_deny`, `hard_deny`, dan `environment` dari masing-masing [scope yang dibaca classifier](#where-the-classifier-reads-configuration), dan menunjukkan apakah aturan bawaan berlaku untuk setiap bagian. Claude Code menampilkan entri dari [managed settings](/docs/id/server-managed-settings) atau flag `--settings` sebagai read-only, dan menyimpan setiap perubahan yang Anda buat di tab ke `~/.claude/settings.json`. Dari tab ini Anda dapat:290Claude Code menampilkan entri dari [managed settings](/docs/id/server-managed-settings) atau flag `--settings` sebagai read-only, dan menyimpan setiap perubahan yang Anda buat di tab ke `~/.claude/settings.json`.

291 

292* Menambah, mengedit, atau menghapus aturan di bagian `allow`, `soft_deny`, dan `hard_deny`. Ketika Anda menambahkan aturan pertama ke bagian, Claude Code juga menyisipkan `"$defaults"` sehingga [aturan bawaan](#override-the-block-and-allow-rules) tetap berlaku.

293* Mematikan atau menghidupkan kembali aturan bawaan untuk `allow`, `soft_deny`, atau `hard_deny`. Claude Code mencatat pilihan dengan menambahkan atau menghapus `"$defaults"` dalam daftar Anda untuk bagian tersebut, jadi bagian memerlukan setidaknya satu aturan Anda sendiri sebelum Anda dapat mematikan aturan bawaannya.

294* Mengedit entri `environment` sebagai satu dokumen di editor Anda. Jika Anda belum mengonfigurasi entri `environment` apa pun, Claude Code terlebih dahulu menanyakan apakah akan mengganti environment bawaan, kemudian membuka editor pada teks bawaan lengkap. Ketika Anda menyimpan, Claude Code mengganti array `autoMode.environment` Anda dengan dokumen. Sertakan baris `"$defaults"` untuk [menjaga entri bawaan](#define-trusted-infrastructure).

295 291 

296<h2 id="route-all-shell-commands-through-the-classifier">292<h2 id="route-all-shell-commands-through-the-classifier">

297 Arahkan semua perintah shell melalui pengklasifikasi293 Arahkan semua perintah shell melalui pengklasifikasi

Details

1387 1387 

1388`parentSettingsBehavior: "merge"` menjaga pengiriman Claude Desktop dari egress allowlist ke embedded Claude Code sessions-nya tetap berfungsi; [Deliver policy to Claude Desktop sessions](/docs/id/claude-apps-gateway#deliver-policy-to-claude-desktop-sessions) menjelaskan mekanisme dan di mana opt-in harus berada.1388`parentSettingsBehavior: "merge"` menjaga pengiriman Claude Desktop dari egress allowlist ke embedded Claude Code sessions-nya tetap berfungsi; [Deliver policy to Claude Desktop sessions](/docs/id/claude-apps-gateway#deliver-policy-to-claude-desktop-sessions) menjelaskan mekanisme dan di mana opt-in harus berada.

1389 1389 

1390Untuk menghentikan developer dari membypass gateway dengan cloud provider variable atau `ANTHROPIC_BASE_URL` mereka sendiri, tambahkan `"allowedProviders": ["gateway"]` ke file yang sama. Claude Code kemudian menolak setiap session di mesin yang tidak diatur untuk Cloud gateway, dan mengakui gateway hanya ketika itu adalah yang dinamai `forceLoginGatewayUrl` atau yang URL-nya file's `env` block atur sebagai `ANTHROPIC_BASE_URL`. `claude gateway` menolak untuk berjalan di mesin yang mengatur list, jadi jaga key tetap off di gateway host. Lihat entry [`allowedProviders`](/docs/id/settings-reference#allowedproviders) dalam settings reference. Memerlukan Claude Code v2.1.285 atau lebih baru.

1391 

1390Deploy file `managed-settings.json` ke setiap device, biasanya melalui platform MDM Anda. File path berbeda menurut platform. Lihat [di mana setiap mekanisme menyimpan policy](/docs/id/managed-settings#where-each-mechanism-stores-the-policy).1392Deploy file `managed-settings.json` ke setiap device, biasanya melalui platform MDM Anda. File path berbeda menurut platform. Lihat [di mana setiap mekanisme menyimpan policy](/docs/id/managed-settings#where-each-mechanism-stores-the-policy).

1391 1393 

1392Secara default, registry policy di Windows atau managed-preferences plist di macOS menggantikan file `managed-settings.json` daripada menggabungkannya, terlepas dari [exception keys dan cross-source checks di atas](#precedence-with-other-managed-sources). Ketiga keys dalam snippet ini mengikuti highest-priority-source rule, jadi fleets yang mengirimkan policy melalui Group Policy atau configuration profiles harus menempatkan ketiganya dalam mekanisme itu sebagai gantinya.1394Secara default, registry policy di Windows atau managed-preferences plist di macOS menggantikan file `managed-settings.json` daripada menggabungkannya, terlepas dari [exception keys dan cross-source checks di atas](#precedence-with-other-managed-sources). Ketiga keys dalam snippet ini mengikuti highest-priority-source rule, jadi fleets yang mengirimkan policy melalui Group Policy atau configuration profiles harus menempatkan ketiganya dalam mekanisme itu sebagai gantinya.

Details

84| `--dangerously-skip-permissions` | Lewati prompt izin. Setara dengan `--permission-mode bypassPermissions`. Lihat [mode izin](/docs/id/permission-modes#skip-all-checks-with-bypasspermissions-mode) untuk apa yang dilakukan dan tidak dilakukan oleh ini. Untuk sesi yang dimulai dengan `--bg`, mode [bertahan ketika supervisor memulai ulang sesi](/docs/id/agent-view#permission-mode-model-and-effort) | `claude --dangerously-skip-permissions` |84| `--dangerously-skip-permissions` | Lewati prompt izin. Setara dengan `--permission-mode bypassPermissions`. Lihat [mode izin](/docs/id/permission-modes#skip-all-checks-with-bypasspermissions-mode) untuk apa yang dilakukan dan tidak dilakukan oleh ini. Untuk sesi yang dimulai dengan `--bg`, mode [bertahan ketika supervisor memulai ulang sesi](/docs/id/agent-view#permission-mode-model-and-effort) | `claude --dangerously-skip-permissions` |

85| `--debug` | Aktifkan mode debug dengan penyaringan kategori opsional, seperti `--debug='mcp,startup'` atau `--debug='!1p'`. Filter mengikat hanya dalam bentuk `=`; filter yang dipisahkan spasi mengaktifkan mode debug tanpa penyaringan | `claude --debug='mcp,startup'` |85| `--debug` | Aktifkan mode debug dengan penyaringan kategori opsional, seperti `--debug='mcp,startup'` atau `--debug='!1p'`. Filter mengikat hanya dalam bentuk `=`; filter yang dipisahkan spasi mengaktifkan mode debug tanpa penyaringan | `claude --debug='mcp,startup'` |

86| `--debug-file <path>` | Tulis log debug ke jalur file tertentu. Secara implisit mengaktifkan mode debug. Mengambil alih `CLAUDE_CODE_DEBUG_LOGS_DIR` | `claude --debug-file /tmp/claude-debug.log` |86| `--debug-file <path>` | Tulis log debug ke jalur file tertentu. Secara implisit mengaktifkan mode debug. Mengambil alih `CLAUDE_CODE_DEBUG_LOGS_DIR` | `claude --debug-file /tmp/claude-debug.log` |

87| `--desktop` | Buka [aplikasi Claude Desktop](/docs/id/desktop) di direktori saat ini dan keluar tanpa memulai sesi di terminal. Tambahkan `--continue`, atau `--resume` dengan ID sesi, untuk [membuka sesi itu di Desktop](/docs/id/desktop#coming-from-the-cli) sebagai gantinya. `--resume` di sini hanya mengambil ID sesi, bukan nama atau jalur transkrip. Tidak mengambil prompt dan tidak ada bendera lain kecuali `--verbose` dan bendera `--debug`, karena aplikasi memulai sesi itu sendiri. Tersedia di macOS dan Windows x64 ketika Anda masuk dengan langganan Claude. Memerlukan Claude Code v2.1.285 atau lebih baru | `claude --desktop` |

87| `--disable-slash-commands` | Nonaktifkan semua skills dan perintah untuk sesi ini | `claude --disable-slash-commands` |88| `--disable-slash-commands` | Nonaktifkan semua skills dan perintah untuk sesi ini | `claude --disable-slash-commands` |

88| `--disallowedTools`, `--disallowed-tools` | Aturan penolakan. Nama alat telanjang menghapus alat yang cocok dari konteks Claude: `"Edit"` menghapus Edit, `"*"` menghapus setiap alat, dan `"mcp__*"` menghapus setiap alat MCP. Aturan yang dibatasi seperti `Bash(rm *)` membiarkan alat tersedia dan menolak hanya panggilan yang cocok [seperti yang ditulis](/docs/id/permissions#bash-rule-limits). Aturan yang menamai [`EndConversation`](/docs/id/tools-reference#endconversation-tool-behavior) tidak dapat menghapusnya saat alat lain tetap ada | `"Bash(git log *)" "Bash(git diff *)" "Edit"` |89| `--disallowedTools`, `--disallowed-tools` | Aturan penolakan. Nama alat telanjang menghapus alat yang cocok dari konteks Claude: `"Edit"` menghapus Edit, `"*"` menghapus setiap alat, dan `"mcp__*"` menghapus setiap alat MCP. Aturan yang dibatasi seperti `Bash(rm *)` membiarkan alat tersedia dan menolak hanya panggilan yang cocok [seperti yang ditulis](/docs/id/permissions#bash-rule-limits). Aturan yang menamai [`EndConversation`](/docs/id/tools-reference#endconversation-tool-behavior) tidak dapat menghapusnya saat alat lain tetap ada | `"Bash(git log *)" "Bash(git diff *)" "Edit"` |

89| `--effort` | Atur [tingkat upaya](/docs/id/model-config#adjust-effort-level) untuk sesi saat ini. Opsi: `low`, `medium`, `high`, `xhigh`, `max`, atau `ultracode`. Tingkat yang tersedia tergantung pada model. `ultracode` meminta upaya `xhigh` dengan [ultracode](/docs/id/workflows#let-claude-decide-with-ultracode) diaktifkan, dan memerlukan Claude Code v2.1.203 atau lebih baru. Menimpa pengaturan [`modelSettings`](/docs/id/settings-reference#modelsettings) dan [`effortLevel`](/docs/id/settings-reference#effortlevel) untuk sesi ini dan tidak bertahan | `claude --effort high` |90| `--effort` | Atur [tingkat upaya](/docs/id/model-config#adjust-effort-level) untuk sesi saat ini. Opsi: `low`, `medium`, `high`, `xhigh`, `max`, atau `ultracode`. Tingkat yang tersedia tergantung pada model. `ultracode` meminta upaya `xhigh` dengan [ultracode](/docs/id/workflows#let-claude-decide-with-ultracode) diaktifkan, dan memerlukan Claude Code v2.1.203 atau lebih baru. Menimpa pengaturan [`modelSettings`](/docs/id/settings-reference#modelsettings) dan [`effortLevel`](/docs/id/settings-reference#effortlevel) untuk sesi ini dan tidak bertahan | `claude --effort high` |


111| `--no-chrome` | Nonaktifkan [integrasi browser Chrome](/docs/id/chrome) untuk sesi ini | `claude --no-chrome` |112| `--no-chrome` | Nonaktifkan [integrasi browser Chrome](/docs/id/chrome) untuk sesi ini | `claude --no-chrome` |

112| `--no-session-persistence` | Nonaktifkan persistensi sesi sehingga sesi tidak disimpan ke disk dan tidak dapat dilanjutkan. Mode cetak saja. Variabel lingkungan [`CLAUDE_CODE_SKIP_PROMPT_HISTORY`](/docs/id/env-vars) melakukan hal yang sama dalam mode apa pun | `claude -p --no-session-persistence "query"` |113| `--no-session-persistence` | Nonaktifkan persistensi sesi sehingga sesi tidak disimpan ke disk dan tidak dapat dilanjutkan. Mode cetak saja. Variabel lingkungan [`CLAUDE_CODE_SKIP_PROMPT_HISTORY`](/docs/id/env-vars) melakukan hal yang sama dalam mode apa pun | `claude -p --no-session-persistence "query"` |

113| `--output-format` | Tentukan format output untuk mode cetak (opsi: `text`, `json`, `stream-json`) | `claude -p "query" --output-format json` |114| `--output-format` | Tentukan format output untuk mode cetak (opsi: `text`, `json`, `stream-json`) | `claude -p "query" --output-format json` |

114| `--permission-mode` | Mulai dalam [mode izin](/docs/id/permission-modes) yang ditentukan. Menerima `default`, `acceptEdits`, `plan`, `auto`, `dontAsk`, `bypassPermissions`, atau `manual` sebagai alias untuk `default`. Alias `manual` memilih mode izin yang UI label Manual dan memerlukan Claude Code v2.1.200 atau lebih baru; `claude --help` mencantumnya sebagai pengganti `default`, dan kedua nilai berfungsi. Menimpa `defaultMode` dari file pengaturan. Tanpa bendera ini atau `--dangerously-skip-permissions`, sesi baru dimulai dalam mode izin yang dijelaskan dalam [mode izin mana sesi dimulai](/docs/id/permission-modes#which-mode-a-session-starts-in). Untuk `-p`, itu adalah `default` ketika tidak ada yang dikonfigurasi | `claude --permission-mode plan` |115| `--permission-mode` | Mulai dalam [mode izin](/docs/id/permission-modes) yang ditentukan. Menerima `default`, `acceptEdits`, `plan`, `auto`, `dontAsk`, `bypassPermissions`, atau `manual` sebagai alias untuk `default`. Alias `manual` memilih mode izin yang UI label Manual dan memerlukan Claude Code v2.1.200 atau lebih baru; `claude --help` mencantumnya sebagai pengganti `default`, dan kedua nilai berfungsi. Menimpa `defaultMode` dari file pengaturan. Tanpa bendera ini atau `--dangerously-skip-permissions`, sesi baru dimulai dalam mode izin yang dijelaskan dalam [mode izin mana sesi dimulai](/docs/id/permission-modes#which-mode-a-session-starts-in), yang juga mencakup apa yang dimulai oleh jalankan `-p` | `claude --permission-mode plan` |

115| `--permission-prompt-tool` | Tentukan alat MCP untuk menangani prompt izin dalam mode non-interaktif. Claude Code menunggu server MCP alat itu untuk terhubung sebelum menjalankan putaran pertama, hingga waktu tunggu startup [`MCP_TIMEOUT`](/docs/id/env-vars), 30 detik secara default. <br /><br />Alat prompt tidak dapat menyetujui alat MCP yang ditandai sebagai [memerlukan interaksi pengguna](/docs/id/mcp#require-approval-for-a-specific-tool): Claude Code mengonversi hasil `allow` untuk satu ke penolakan. Pembatasan ini memerlukan Claude Code v2.1.199 atau lebih baru | `claude -p --permission-prompt-tool mcp_auth_tool "query"` |116| `--permission-prompt-tool` | Tentukan alat MCP untuk menangani prompt izin dalam mode non-interaktif. Claude Code menunggu server MCP alat itu untuk terhubung sebelum menjalankan putaran pertama, hingga waktu tunggu startup [`MCP_TIMEOUT`](/docs/id/env-vars), 30 detik secara default. <br /><br />Alat prompt tidak dapat menyetujui alat MCP yang ditandai sebagai [memerlukan interaksi pengguna](/docs/id/mcp#require-approval-for-a-specific-tool): Claude Code mengonversi hasil `allow` untuk satu ke penolakan. Pembatasan ini memerlukan Claude Code v2.1.199 atau lebih baru | `claude -p --permission-prompt-tool mcp_auth_tool "query"` |

116| `--permission-prompts` | Atur siapa yang menjawab prompt izin dalam mode cetak. Dengan `host` default, Claude Code mengirimnya ke host Agent SDK atau alat `--permission-prompt-tool`. Lewatkan `none` ketika tidak ada yang dapat menjawab, dan Claude Code menolaknya sebagai gantinya. Lihat [Matikan prompt izin dalam jalankan tanpa pengawasan](/docs/id/headless#turn-off-permission-prompts-in-unattended-runs). Memerlukan Claude Code v2.1.259 atau lebih baru | `claude -p --permission-prompts none "query"` |117| `--permission-prompts` | Atur siapa yang menjawab prompt izin dalam mode cetak. Dengan `host` default, Claude Code mengirimnya ke host Agent SDK atau alat `--permission-prompt-tool`. Lewatkan `none` ketika tidak ada yang dapat menjawab, dan Claude Code menolaknya sebagai gantinya. Lihat [Matikan prompt izin dalam jalankan tanpa pengawasan](/docs/id/headless#turn-off-permission-prompts-in-unattended-runs). Memerlukan Claude Code v2.1.259 atau lebih baru | `claude -p --permission-prompts none "query"` |

117| `--plugin-dir` | Muat plugin dari direktori atau arsip `.zip`, atau beberapa dari [folder plugin](/docs/id/plugins/create#load-a-directory-or-archive-for-one-session), hanya untuk sesi ini. Setiap bendera mengambil satu jalur. Ulangi bendera untuk lebih banyak jalur: `--plugin-dir A --plugin-dir B.zip`. Melewatkan folder plugin memerlukan Claude Code v2.1.265 atau lebih baru | `claude --plugin-dir ./my-plugin` |118| `--plugin-dir` | Muat plugin dari direktori atau arsip `.zip`, atau beberapa dari [folder plugin](/docs/id/plugins/create#load-a-directory-or-archive-for-one-session), hanya untuk sesi ini. Setiap bendera mengambil satu jalur. Ulangi bendera untuk lebih banyak jalur: `--plugin-dir A --plugin-dir B.zip`. Melewatkan folder plugin memerlukan Claude Code v2.1.265 atau lebih baru | `claude --plugin-dir ./my-plugin` |

118| `--plugin-url` | Ambil arsip plugin `.zip` dari URL hanya untuk sesi ini. Ulangi bendera untuk beberapa plugin, atau lewatkan URL yang dipisahkan spasi dalam nilai yang dikutip tunggal | `claude --plugin-url https://example.com/plugin.zip` |119| `--plugin-url` | Ambil arsip plugin `.zip` dari URL hanya untuk sesi ini. Ulangi bendera untuk beberapa plugin, atau lewatkan URL yang dipisahkan spasi dalam nilai yang dikutip tunggal | `claude --plugin-url https://example.com/plugin.zip` |

119| `--print`, `-p` | Cetak respons tanpa mode interaktif (lihat [dokumentasi Agent SDK](/docs/id/agent-sdk/overview) untuk detail penggunaan pemrograman) | `claude -p "query"` |120| `--print`, `-p` | Cetak respons tanpa mode interaktif (lihat [dokumentasi Agent SDK](/docs/id/agent-sdk/overview) untuk detail penggunaan pemrograman). Untuk `--resume` pada sesi latar belakang yang masih berjalan, lihat [Lanjutkan sesi](/docs/id/sessions#resume-a-running-background-session) | `claude -p "query"` |

120| `--prompt-suggestions` | Emit pesan `prompt_suggestion` dengan prompt pengguna berikutnya yang diprediksi setelah setiap putaran yang menghasilkan satu; percakapan yang sangat singkat dapat menghasilkan tidak ada. Memerlukan `--print`, `--output-format stream-json`, dan `--verbose`. Lihat [Saran prompt](/docs/id/interactive-mode#prompt-suggestions) | `claude -p --prompt-suggestions --output-format stream-json --verbose "query"` |121| `--prompt-suggestions` | Emit pesan `prompt_suggestion` dengan prompt pengguna berikutnya yang diprediksi setelah setiap putaran yang menghasilkan satu; percakapan yang sangat singkat dapat menghasilkan tidak ada. Memerlukan `--print`, `--output-format stream-json`, dan `--verbose`. Lihat [Saran prompt](/docs/id/interactive-mode#prompt-suggestions) | `claude -p --prompt-suggestions --output-format stream-json --verbose "query"` |

121| `--ref <branch>` | Dengan `--environment`, dasarkan checkout sesi baru pada ref bernama alih-alih `HEAD` lokal | `claude -p "Run the smoke test" --environment ccpool_abc123 --ref main` |122| `--ref <branch>` | Dengan `--environment`, dasarkan checkout sesi baru pada ref bernama alih-alih `HEAD` lokal | `claude -p "Run the smoke test" --environment ccpool_abc123 --ref main` |

122| `--remote` | Alias yang sudah usang untuk `--cloud`, termasuk bentuk sesi yang ada | `claude --remote "Fix the login bug"` |123| `--remote` | Alias yang sudah usang untuk `--cloud`, termasuk bentuk sesi yang ada | `claude --remote "Fix the login bug"` |


124| `--remote-control-session-name-prefix <prefix>` | Awalan untuk nama [Remote Control](/docs/id/remote-control) yang dibuat secara otomatis ketika tidak ada nama eksplisit yang diatur. Default ke nama host mesin Anda, menghasilkan nama seperti `myhost-graceful-unicorn`. Atur `CLAUDE_REMOTE_CONTROL_SESSION_NAME_PREFIX` untuk efek yang sama | `claude remote-control --remote-control-session-name-prefix dev-box` |125| `--remote-control-session-name-prefix <prefix>` | Awalan untuk nama [Remote Control](/docs/id/remote-control) yang dibuat secara otomatis ketika tidak ada nama eksplisit yang diatur. Default ke nama host mesin Anda, menghasilkan nama seperti `myhost-graceful-unicorn`. Atur `CLAUDE_REMOTE_CONTROL_SESSION_NAME_PREFIX` untuk efek yang sama | `claude remote-control --remote-control-session-name-prefix dev-box` |

125| `--replay-user-messages` | Emit kembali pesan pengguna dari stdin ke stdout untuk pengakuan. Memerlukan `--input-format stream-json` dan `--output-format stream-json` | `claude -p --input-format stream-json --output-format stream-json --verbose --replay-user-messages` |126| `--replay-user-messages` | Emit kembali pesan pengguna dari stdin ke stdout untuk pengakuan. Memerlukan `--input-format stream-json` dan `--output-format stream-json` | `claude -p --input-format stream-json --output-format stream-json --verbose --replay-user-messages` |

126| `--restricted` | Mulai dalam mode terbatas. Gunakan ketika harness evaluasi menjalankan `claude` di mesin bersama dan Claude Code tidak boleh menjalankan perintah atau membaca pengaturan pengguna dan proyek mesin itu. Claude Code menghapus alat bawaan yang menjalankan perintah atau kode, dan WebFetch, kecuali Anda menamai mereka secara individual dalam `--tools`, bukan melalui preset `default`. Ini juga membatasi alat file bawaan ke [direktori kerja](/docs/id/permissions#working-directories), memuat hanya [pengaturan terkelola](/docs/id/managed-settings) dan `--settings`, menolak [`bypassPermissions`](/docs/id/permission-modes#skip-all-checks-with-bypasspermissions-mode), dan [menolak untuk membuat sesi cloud](/docs/id/errors#cloud-sessions-cannot-be-created-from-a-restricted-session). Memerlukan Claude Code v2.1.248 atau lebih baru | `claude --restricted -p "query"` |127| `--restricted` | Mulai dalam mode terbatas. Gunakan ketika harness evaluasi menjalankan `claude` di mesin bersama dan Claude Code tidak boleh menjalankan perintah atau membaca pengaturan pengguna dan proyek mesin itu. Claude Code menghapus alat bawaan yang menjalankan perintah atau kode, dan WebFetch, kecuali Anda menamai mereka secara individual dalam `--tools`, bukan melalui preset `default`. Ini juga membatasi alat file bawaan ke [direktori kerja](/docs/id/permissions#working-directories), memuat hanya [pengaturan terkelola](/docs/id/managed-settings) dan `--settings`, menolak [`bypassPermissions`](/docs/id/permission-modes#skip-all-checks-with-bypasspermissions-mode), dan [menolak untuk membuat sesi cloud](/docs/id/errors#cloud-sessions-cannot-be-created-from-a-restricted-session). Memerlukan Claude Code v2.1.248 atau lebih baru | `claude --restricted -p "query"` |

127| `--resume`, `-r` | Lanjutkan sesi tertentu berdasarkan ID atau nama, atau tampilkan pemilih interaktif untuk memilih sesi. Sebagai pengganti ID, Anda dapat melewatkan jalur absolut ke file [transkrip](/docs/id/sessions#where-transcripts-are-stored) `.jsonl` sesi. Pemilih dan pencarian nama mencakup sesi yang menambahkan direktori ini dengan `/add-dir`. Ketika Anda melewatkan ID sesi, Claude Code mencari direktori proyek saat ini dan git worktrees-nya, kemudian setiap proyek lain di mesin ini. Sebelum v2.1.223, pencarian ID hanya mencakup direktori proyek saat ini dan git worktrees-nya. [Sesi latar belakang](/docs/id/agent-view) muncul di pemilih yang ditandai dengan `bg` | `claude --resume auth-refactor` |128| `--resume`, `-r` | Lanjutkan sesi tertentu berdasarkan ID atau nama, atau tampilkan pemilih interaktif untuk memilih sesi. Sebagai pengganti ID, Anda dapat melewatkan jalur absolut ke file [transkrip](/docs/id/sessions#where-transcripts-are-stored) `.jsonl` sesi. Pemilih dan pencarian nama mencakup sesi yang menambahkan direktori ini dengan `/add-dir`. Ketika Anda melewatkan ID sesi, Claude Code mencari direktori proyek saat ini dan git worktrees-nya, kemudian setiap proyek lain di mesin ini. Sebelum v2.1.223, pencarian ID hanya mencakup direktori proyek saat ini dan git worktrees-nya. [Sesi latar belakang](/docs/id/agent-view) muncul di pemilih yang ditandai dengan `bg`. Melanjutkan sesi yang masih berjalan [membuka sesi itu](/docs/id/sessions#resume-a-running-background-session) di terminal ini melalui `claude attach`, dan prompt yang Anda lewatkan di baris perintah masuk ke dalamnya sebagai putaran berikutnya. Sebelum v2.1.285, Claude Code menolak dan mencetak perintah `claude attach` untuk dijalankan sebagai gantinya | `claude --resume auth-refactor` |

128| `--safe-mode` | Mulai dengan semua kustomisasi dinonaktifkan untuk memecahkan masalah konfigurasi yang rusak: CLAUDE.md, skills, plugins, hooks, server MCP, perintah dan agen khusus, gaya output, alur kerja, tema khusus, pintasan keyboard khusus, perintah baris status dan saran file, server LSP, dan memori otomatis tidak dimuat. Autentikasi, pemilihan model, alat bawaan, dan izin bekerja secara normal, yang berbeda dari [`--bare`](/docs/id/headless#start-faster-with-bare-mode). Kebijakan pengaturan terkelola masih berlaku, termasuk hook yang dikonfigurasi kebijakan, baris status, dan perintah saran file; plugin terkelola, skills terkelola, CLAUDE.md terkelola, dan server MCP yang dikonfigurasi kebijakan tidak. Berguna untuk memeriksa apakah kustomisasi adalah apa yang memicu [fallback model otomatis](/docs/id/model-config#automatic-model-fallback). Menetapkan [`CLAUDE_CODE_SAFE_MODE`](/docs/id/env-vars) | `claude --safe-mode` |129| `--safe-mode` | Mulai dengan semua kustomisasi dinonaktifkan untuk memecahkan masalah konfigurasi yang rusak: CLAUDE.md, skills, plugins, hooks, server MCP, perintah dan agen khusus, gaya output, alur kerja, tema khusus, pintasan keyboard khusus, perintah baris status dan saran file, server LSP, dan memori otomatis tidak dimuat. Autentikasi, pemilihan model, alat bawaan, dan izin bekerja secara normal, yang berbeda dari [`--bare`](/docs/id/headless#start-faster-with-bare-mode). Kebijakan pengaturan terkelola masih berlaku, termasuk hook yang dikonfigurasi kebijakan, baris status, dan perintah saran file; plugin terkelola, skills terkelola, CLAUDE.md terkelola, dan server MCP yang dikonfigurasi kebijakan tidak. Berguna untuk memeriksa apakah kustomisasi adalah apa yang memicu [fallback model otomatis](/docs/id/model-config#automatic-model-fallback). Menetapkan [`CLAUDE_CODE_SAFE_MODE`](/docs/id/env-vars) | `claude --safe-mode` |

129| `--session-id` | Gunakan ID sesi tertentu untuk percakapan (harus UUID yang valid) | `claude --session-id "550e8400-e29b-41d4-a716-446655440000"` |130| `--session-id` | Gunakan ID sesi tertentu untuk percakapan (harus UUID yang valid) | `claude --session-id "550e8400-e29b-41d4-a716-446655440000"` |

130| `--setting-sources` | Daftar sumber pengaturan yang dipisahkan koma untuk dimuat (`user`, `project`, `local`). Lihat [tampilan agen](/docs/id/agent-view#what-carries-over-when-you-background) dan [tim agen](/docs/id/agent-teams#context-and-communication) untuk sesi yang Anda mulai dari sesi ini yang mewarisi daftar | `claude --setting-sources user,project` |131| `--setting-sources` | Daftar sumber pengaturan yang dipisahkan koma untuk dimuat (`user`, `project`, `local`). Lihat [tampilan agen](/docs/id/agent-view#what-carries-over-when-you-background) dan [tim agen](/docs/id/agent-teams#context-and-communication) untuk sesi yang Anda mulai dari sesi ini yang mewarisi daftar | `claude --setting-sources user,project` |

Details

439 439 

440* **Perintah yang dijalankan Claude**: lingkungan cloud tidak menetapkan timeout perintahnya sendiri, jadi default alat Bash berlaku. Claude menunggu 2 menit untuk perintah secara default dan dapat meminta hingga 10 menit.440* **Perintah yang dijalankan Claude**: lingkungan cloud tidak menetapkan timeout perintahnya sendiri, jadi default alat Bash berlaku. Claude menunggu 2 menit untuk perintah secara default dan dapat meminta hingga 10 menit.

441 441 

442 Ketika perintah mencapai [timeout](/docs/id/tools-reference#timeout-and-output-limits)-nya, Claude Code [memindahkannya ke latar belakang](/docs/id/tools-reference#background-commands) alih-alih menghentikannya, kecuali perintah dimulai dengan `sleep`. Perintah yang dipindahkan dengan cara ini dapat terus berjalan selama 30 menit lagi sebelum Claude Code menghentikannya di [batas waktu latar belakangnya](/docs/id/tools-reference#background-commands). Menetapkan `BASH_DEFAULT_TIMEOUT_MS` di atas `1800000` milidetik memanjangkan batas itu serta default latar depan.442 Ketika perintah mencapai [timeout](/docs/id/tools-reference#timeout-and-output-limits)-nya, Claude Code [memindahkannya ke latar belakang](/docs/id/tools-reference#foreground-commands-that-move-to-the-background) alih-alih menghentikannya, kecuali perintah dimulai dengan `sleep`. Perintah yang dipindahkan dengan cara ini dapat terus berjalan selama 30 menit lagi sebelum Claude Code menghentikannya di [batas waktu latar belakangnya](/docs/id/tools-reference#time-limit-for-background-commands). Menetapkan `BASH_DEFAULT_TIMEOUT_MS` di atas `1800000` milidetik memanjangkan batas itu serta default latar depan.

443* **Hook SessionStart**: Claude Code membatalkan hook `command` setelah 600 detik kecuali Anda menetapkan [`timeout`](/docs/id/hooks#common-fields), dalam detik, pada entri hook. Claude Code tidak memberlakukan timeout pada hook yang Anda jalankan dengan [`async: true`](/docs/id/hooks#run-hooks-in-the-background).443* **Hook SessionStart**: Claude Code membatalkan hook `command` setelah 600 detik kecuali Anda menetapkan [`timeout`](/docs/id/hooks#common-fields), dalam detik, pada entri hook. Claude Code tidak memberlakukan timeout pada hook yang Anda jalankan dengan [`async: true`](/docs/id/hooks#run-hooks-in-the-background).

444* **Skrip setup**: skrip yang memakan waktu lebih lama dari kira-kira lima menit tidak di-cache. [Script requirements](#script-requirements) mencakup cara tetap di bawah itu.444* **Skrip setup**: skrip yang memakan waktu lebih lama dari kira-kira lima menit tidak di-cache. [Script requirements](#script-requirements) mencakup cara tetap di bawah itu.

445* **Sesi idle**: setelah beberapa menit tanpa aktivitas, VM sesi sesi dijeda dengan file-filenya disimpan, dan VM yang dijeda dapat kemudian diambil kembali. [Set environment variables](#set-environment-variables) menjelaskan apa yang diambil sesi dalam setiap kasus, dan [Environment expired](/docs/id/claude-code-on-the-web#environment-expired) mencakup cara membuka kembali sesi yang VM-nya diambil kembali.445* **Sesi idle**: setelah beberapa menit tanpa aktivitas, VM sesi sesi dijeda dengan file-filenya disimpan, dan VM yang dijeda dapat kemudian diambil kembali. [Set environment variables](#set-environment-variables) menjelaskan apa yang diambil sesi dalam setiap kasus, dan [Environment expired](/docs/id/claude-code-on-the-web#environment-expired) mencakup cara membuka kembali sesi yang VM-nya diambil kembali.

commands.md +1 −1

Details

132| `/remote-control` | Buat sesi ini tersedia untuk [Remote Control](/docs/id/remote-control) dari claude.ai. Menjalankannya saat keluar mencetak bahwa Remote Control memerlukan langganan claude.ai dan memberi tahu Anda cara masuk; sebelum v2.1.206 melaporkan `Unknown command: /remote-control`. Alias: `/rc` |132| `/remote-control` | Buat sesi ini tersedia untuk [Remote Control](/docs/id/remote-control) dari claude.ai. Menjalankannya saat keluar mencetak bahwa Remote Control memerlukan langganan claude.ai dan memberi tahu Anda cara masuk; sebelum v2.1.206 melaporkan `Unknown command: /remote-control`. Alias: `/rc` |

133| `/remote-env` | Pilih [lingkungan cloud](/docs/id/cloud-environments#select-an-environment-from-the-cli) default untuk sesi cloud yang Anda mulai dari CLI |133| `/remote-env` | Pilih [lingkungan cloud](/docs/id/cloud-environments#select-an-environment-from-the-cli) default untuk sesi cloud yang Anda mulai dari CLI |

134| `/rename [name]` | Ganti nama sesi saat ini dan tampilkan nama di bilah prompt. Tanpa nama, auto-generate dari riwayat percakapan. Juga tersedia dalam mode non-interaktif (`-p`); memerlukan Claude Code v2.1.205 atau lebih baru. Dari setiap permukaan penggantian nama, termasuk claude.ai dan aplikasi desktop, Claude Code mengganti karakter kontrol dan tidak terlihat dalam nama baru dengan spasi dan membatasi nama pada 200 karakter. Jika nama kosong setelah karakter tidak terlihat dihapus, Claude Code menolaknya dan menunjukkan `That name is empty once invisible characters are removed. Usage: /rename <name>`. Penggantian karakter dan batas panjang memerlukan Claude Code v2.1.221 atau lebih baru. Jika sesi langsung lain di mesin ini sudah menggunakan nama yang Anda berikan, Claude Code menerapkan [varian darinya](/docs/id/sessions#name-your-sessions) sebagai gantinya |134| `/rename [name]` | Ganti nama sesi saat ini dan tampilkan nama di bilah prompt. Tanpa nama, auto-generate dari riwayat percakapan. Juga tersedia dalam mode non-interaktif (`-p`); memerlukan Claude Code v2.1.205 atau lebih baru. Dari setiap permukaan penggantian nama, termasuk claude.ai dan aplikasi desktop, Claude Code mengganti karakter kontrol dan tidak terlihat dalam nama baru dengan spasi dan membatasi nama pada 200 karakter. Jika nama kosong setelah karakter tidak terlihat dihapus, Claude Code menolaknya dan menunjukkan `That name is empty once invisible characters are removed. Usage: /rename <name>`. Penggantian karakter dan batas panjang memerlukan Claude Code v2.1.221 atau lebih baru. Jika sesi langsung lain di mesin ini sudah menggunakan nama yang Anda berikan, Claude Code menerapkan [varian darinya](/docs/id/sessions#name-your-sessions) sebagai gantinya |

135| `/resume [session]` | Lanjutkan percakapan berdasarkan ID atau nama, atau buka pemilih sesi. [Sesi latar belakang](/docs/id/agent-view) muncul di pemilih ditandai dengan `bg`; satu yang masih berjalan tidak dapat dilanjutkan di sini, jadi lampirkan dari `claude agents` atau hentikan di sana terlebih dahulu. Alias: `/continue` |135| `/resume [session]` | Lanjutkan percakapan berdasarkan ID atau nama, atau buka pemilih sesi. [Sesi latar belakang](/docs/id/agent-view) muncul di pemilih ditandai dengan `bg`. Melanjutkan satu yang masih berjalan, dari pemilih atau berdasarkan ID atau nama, [membuka sesi itu](/docs/id/sessions#resume-a-running-background-session): percakapan saat ini Anda pindah ke latar belakang dan terminal ini melampirkan ke yang berjalan. Tekan `←` pada prompt kosong untuk kembali ke tampilan agen, yang juga mencantumkan percakapan yang Anda tinggalkan. Sebelum v2.1.285, Claude Code menolak dan memberi tahu Anda untuk membuka sesi dengan `claude attach` atau menghentikannya terlebih dahulu. Alias: `/continue` |

136| `/review [low\|medium\|high\|xhigh\|max\|ultra] [--fix] [--comment] [pr#\|branch\|path]` | Alias dari [`/code-review`](/docs/id/code-review#review-a-diff-locally): meninjau diff saat ini, atau nomor PR, cabang, atau jalur yang Anda berikan, seperti `/review 1234`, dan mengambil tingkat upaya dan bendera yang sama. Tanpa level yang diberikan, tinjauan menggunakan kembali level `low` hingga `max` terakhir yang Anda ketik; lihat [Tinjau diff secara lokal](/docs/id/code-review#review-a-diff-locally) untuk aturan yang tepat. Untuk tinjauan cloud mendalam, gunakan [`/code-review ultra`](/docs/id/ultrareview). Sebelum v2.1.223, `/review` adalah perintah terpisah yang menjalankan tinjauan baca-saja satu lintasan dari permintaan tarik GitHub berdasarkan nomor, mencantumkan PR terbuka untuk dipilih saat dijalankan tanpa argumen; dari v2.1.186 melalui v2.1.201, itu menjalankan mesin multi-agen yang sama seperti `/code-review medium` |136| `/review [low\|medium\|high\|xhigh\|max\|ultra] [--fix] [--comment] [pr#\|branch\|path]` | Alias dari [`/code-review`](/docs/id/code-review#review-a-diff-locally): meninjau diff saat ini, atau nomor PR, cabang, atau jalur yang Anda berikan, seperti `/review 1234`, dan mengambil tingkat upaya dan bendera yang sama. Tanpa level yang diberikan, tinjauan menggunakan kembali level `low` hingga `max` terakhir yang Anda ketik; lihat [Tinjau diff secara lokal](/docs/id/code-review#review-a-diff-locally) untuk aturan yang tepat. Untuk tinjauan cloud mendalam, gunakan [`/code-review ultra`](/docs/id/ultrareview). Sebelum v2.1.223, `/review` adalah perintah terpisah yang menjalankan tinjauan baca-saja satu lintasan dari permintaan tarik GitHub berdasarkan nomor, mencantumkan PR terbuka untuk dipilih saat dijalankan tanpa argumen; dari v2.1.186 melalui v2.1.201, itu menjalankan mesin multi-agen yang sama seperti `/code-review medium` |

137| `/rewind` | Putar ulang percakapan dan/atau kode ke titik sebelumnya, atau ringkas dari pesan yang dipilih. Lihat [checkpointing](/docs/id/checkpointing). Alias: `/checkpoint`, `/undo` |137| `/rewind` | Putar ulang percakapan dan/atau kode ke titik sebelumnya, atau ringkas dari pesan yang dipilih. Lihat [checkpointing](/docs/id/checkpointing). Alias: `/checkpoint`, `/undo` |

138| `/run` | **[Skill](/docs/id/skills#bundled-skills).** Luncurkan dan jalankan aplikasi proyek Anda untuk melihat perubahan bekerja, bukan hanya lulus tes. Lihat [Jalankan dan verifikasi aplikasi Anda](/docs/id/skills#run-and-verify-your-app) |138| `/run` | **[Skill](/docs/id/skills#bundled-skills).** Luncurkan dan jalankan aplikasi proyek Anda untuk melihat perubahan bekerja, bukan hanya lulus tes. Lihat [Jalankan dan verifikasi aplikasi Anda](/docs/id/skills#run-and-verify-your-app) |

Details

1634 1634 

1635Jika Anda membutuhkan jendela yang lebih besar daripada percakapan yang lebih kecil, model Fable, Sonnet 5 dan yang lebih baru, Opus 4.6 dan yang lebih baru, dan Sonnet 4.6 mendukung jendela konteks 1 juta token. Lihat [Extended context](/docs/id/model-config#extended-context) untuk ketersediaan menurut paket dan cara memilih varian model `[1m]`. Pemadatan bekerja dengan cara yang sama pada batas yang lebih besar.1635Jika Anda membutuhkan jendela yang lebih besar daripada percakapan yang lebih kecil, model Fable, Sonnet 5 dan yang lebih baru, Opus 4.6 dan yang lebih baru, dan Sonnet 4.6 mendukung jendela konteks 1 juta token. Lihat [Extended context](/docs/id/model-config#extended-context) untuk ketersediaan menurut paket dan cara memilih varian model `[1m]`. Pemadatan bekerja dengan cara yang sama pada batas yang lebih besar.

1636 1636 

1637Sonnet 5.5 dan Sonnet 5 berjalan dengan jendela konteks 1M dan tidak memiliki varian `[1m]` untuk dipilih. Lihat [Sonnet 5.5 and Sonnet 5 context window](/docs/id/model-config#sonnet-5-5-and-sonnet-5-context-window) untuk ambang batas auto-compaction-nya dan pengecualian gateway LLM.1637Sonnet 5.5 dan Sonnet 5 berjalan dengan jendela konteks 1M dan tidak memiliki varian `[1m]` untuk dipilih. Lihat [Sonnet 5.5 and Sonnet 5 context window](/docs/id/model-config#sonnet-5-5-and-sonnet-5-context-window) untuk ambang batas auto-compaction-nya, dan [the context window behind a gateway](/docs/id/model-config#context-window-behind-a-gateway) untuk cara Claude Code mengukur jendela saat Anda mengatur `ANTHROPIC_BASE_URL` ke [LLM gateway](/docs/id/llm-gateway).

1638 1638 

1639Titik di mana pemadatan otomatis berjalan tergantung pada model dan konfigurasi Anda. Lihat [Default auto-compact thresholds](/docs/id/model-config#default-auto-compact-thresholds) untuk batas per model, dan [Correct the window for a gateway or custom model ID](/docs/id/model-config#correct-the-window-for-a-gateway-or-custom-model-id) jika Claude Code mengasumsikan jendela yang salah untuk ID model Anda, seperti alias [LLM gateway](/docs/id/llm-gateway).1639Titik di mana pemadatan otomatis berjalan tergantung pada model dan konfigurasi Anda. Lihat [Default auto-compact thresholds](/docs/id/model-config#default-auto-compact-thresholds) untuk batas per model, dan [Correct the window for a gateway or custom model ID](/docs/id/model-config#correct-the-window-for-a-gateway-or-custom-model-id) jika Claude Code mengasumsikan jendela yang salah untuk ID model Anda, seperti alias [LLM gateway](/docs/id/llm-gateway).

1640 1640 

costs.md +1 −1

Details

51 51 

52Bagian miss, expected rebuild, dan warm atau cold dari baris berarti hal berikut:52Bagian miss, expected rebuild, dan warm atau cold dari baris berarti hal berikut:

53 53 

54* **Misses**: permintaan yang memproses ulang konten yang sudah dipegang cache, dengan waktu miss terakhir dan berapa banyak token yang ditulis kembali ke cache oleh permintaan tersebut. Claude Code menghitung permintaan sebagai miss ketika permintaan memproses ulang lebih dari 5% dan setidaknya 2.000 token dari apa yang bisa dibaca dari cache. [Tindakan yang membatalkan cache](/docs/id/prompt-caching#actions-that-invalidate-the-cache) mencantumkan penyebab umum. Ketika Claude Code dapat mengidentifikasi kemungkinan penyebab miss terakhir, baris menamakannya juga, misalnya `likely cause: tool definitions changed`. Teks kemungkinan-penyebab memerlukan Claude Code v2.1.260 atau lebih baru.54* **Misses**: permintaan yang memproses ulang konten yang sudah dipegang cache, dengan waktu miss terakhir dan berapa banyak token yang ditulis kembali ke cache oleh permintaan tersebut. [Tindakan yang membatalkan cache](/docs/id/prompt-caching#actions-that-invalidate-the-cache) mencantumkan penyebab umum. Ketika Claude Code dapat mengidentifikasi kemungkinan penyebab miss terakhir, baris menamakannya juga, misalnya `likely cause: tool definitions changed`. Teks kemungkinan-penyebab memerlukan Claude Code v2.1.260 atau lebih baru.

55* **Expected rebuilds**: ketika Claude Code sendiri baru saja menulis ulang percakapan, dengan [compaction](/docs/id/prompt-caching#compacting-the-conversation) atau dengan menghapus hasil tool lama dari konteks, ia menghitung jenis miss yang sama sebagai expected rebuild. Bagian ini muncul hanya setelah setidaknya satu expected rebuild telah terjadi.55* **Expected rebuilds**: ketika Claude Code sendiri baru saja menulis ulang percakapan, dengan [compaction](/docs/id/prompt-caching#compacting-the-conversation) atau dengan menghapus hasil tool lama dari konteks, ia menghitung jenis miss yang sama sebagai expected rebuild. Bagian ini muncul hanya setelah setidaknya satu expected rebuild telah terjadi.

56* **Warm atau cold**: apakah awalan cache masih dalam [cache lifetime](/docs/id/prompt-caching#cache-lifetime), dengan TTL yang berlaku. Ketika cache dingin, baris menunjukkan berapa lama sesi telah idle. Ketika tidak ada respons yang melaporkan token cache, baris berakhir dengan `no prompt caching reported by the API`.56* **Warm atau cold**: apakah awalan cache masih dalam [cache lifetime](/docs/id/prompt-caching#cache-lifetime), dengan TTL yang berlaku. Ketika cache dingin, baris menunjukkan berapa lama sesi telah idle. Ketika tidak ada respons yang melaporkan token cache, baris berakhir dengan `no prompt caching reported by the API`.

57 57 

desktop.md +8 −0

Details

967 967 

968Untuk memindahkan sesi CLI ke Desktop, jalankan `/desktop` di terminal. Claude menyimpan sesi Anda dan membukanya di aplikasi desktop, kemudian keluar dari CLI. Perintah ini tersedia di macOS dan Windows x64 ketika Anda masuk dengan langganan Claude. Perintah ini tidak tersedia dengan autentikasi kunci API atau di Amazon Bedrock, Google Cloud's Agent Platform, atau Microsoft Foundry.968Untuk memindahkan sesi CLI ke Desktop, jalankan `/desktop` di terminal. Claude menyimpan sesi Anda dan membukanya di aplikasi desktop, kemudian keluar dari CLI. Perintah ini tersedia di macOS dan Windows x64 ketika Anda masuk dengan langganan Claude. Perintah ini tidak tersedia dengan autentikasi kunci API atau di Amazon Bedrock, Google Cloud's Agent Platform, atau Microsoft Foundry.

969 969 

970Dari shell Anda, [`claude --desktop`](/docs/id/cli-reference#cli-flags) membuka Desktop secara langsung tanpa memulai sesi terminal. Ini memerlukan Claude Code v2.1.285 atau lebih baru dan memiliki persyaratan platform dan sign-in yang sama dengan `/desktop`. Tanpa argumen lain, ini membuka Desktop di direktori saat ini. Untuk membuka sesi CLI yang ada di Desktop, tambahkan `--continue` untuk percakapan paling baru di direktori ini, atau `--resume` dengan ID sesi yang ditampilkan `/status`:

971 

972```bash theme={null}

973claude --desktop --resume <session-id>

974```

975 

976Claude Code mencetak `Opening session <session-id> in Claude Desktop`, sesi terbuka di aplikasi, dan perintah keluar. Nama sesi tidak berfungsi sebagai pengganti ID. Claude Code tidak memindahkan sesi yang terbuka di terminal lain atau masih berjalan di latar belakang. Jika Claude Desktop tidak terinstal, perintah mencetak tautan unduhan dan keluar.

977 

970Anda juga dapat mengambil sesi CLI dari dalam Desktop dengan `/resume`. Perintah ini tersedia di sesi lokal, bukan di SSH, WSL, atau sesi cloud.978Anda juga dapat mengambil sesi CLI dari dalam Desktop dengan `/resume`. Perintah ini tersedia di sesi lokal, bukan di SSH, WSL, atau sesi cloud.

971 979 

972Untuk melanjutkan sesi terminal di Desktop:980Untuk melanjutkan sesi terminal di Desktop:

errors.md +63 −33

Details

322| `Transcript writes are failing (...)` | [Session saving warnings](#transcript-writes-are-failing) |322| `Transcript writes are failing (...)` | [Session saving warnings](#transcript-writes-are-failing) |

323| `Transcript saving is off — CLAUDE_CODE_SKIP_PROMPT_HISTORY is set` | [Session saving warnings](#transcript-saving-is-off-skip-prompt-history) |323| `Transcript saving is off — CLAUDE_CODE_SKIP_PROMPT_HISTORY is set` | [Session saving warnings](#transcript-saving-is-off-skip-prompt-history) |

324| `Transcript saving is off — inherited CLAUDE_CODE_CHILD_SESSION marker` | [Session saving warnings](#transcript-saving-is-off-child-session-marker) |324| `Transcript saving is off — inherited CLAUDE_CODE_CHILD_SESSION marker` | [Session saving warnings](#transcript-saving-is-off-child-session-marker) |

325| `Claude Code's fullscreen renderer didn't finish starting last time on this machine` / `Claude Code's fullscreen renderer has repeatedly failed to start on this machine` | [Configuration warnings](#fullscreen-failed-start-notice) |325| `Claude Code's fullscreen renderer didn't finish starting last time on this machine` / `Claude Code's fullscreen renderer has repeatedly failed to start on this machine` | [Fullscreen rendering](/docs/id/fullscreen#fullscreen-renderer-didnt-finish-starting) |

326| `Claude Code exited after an unrecoverable interface error (...)` | [Configuration warnings](#exited-after-an-unrecoverable-interface-error) |326| `Claude Code exited after an unrecoverable interface error (...)` | [Configuration warnings](#exited-after-an-unrecoverable-interface-error) |

327| `Agent descriptions are over the 15.0k-token limit` | [Configuration warnings](#agent-descriptions-are-over-the-15000-token-limit) |327| `Agent descriptions are over the 15.0k-token limit` | [Configuration warnings](#agent-descriptions-are-over-the-15000-token-limit) |

328| `Not loaded: rename <path>, then restart — its name uses "<name>", a name reserved for the skills synced from your claude.ai account` | [Configuration warnings](#a-skill-command-or-workflow-wasnt-loaded-because-its-name-is-reserved) |328| `Not loaded: rename <path>, then restart — its name uses "<name>", a name reserved for the skills synced from your claude.ai account` | [Configuration warnings](#a-skill-command-or-workflow-wasnt-loaded-because-its-name-is-reserved) |


331| `Remote managed settings failed to load (<cause>)` | [Configuration warnings](#remote-managed-settings-failed-to-load) |331| `Remote managed settings failed to load (<cause>)` | [Configuration warnings](#remote-managed-settings-failed-to-load) |

332| `Managed settings were not approved; exiting without applying them.` | [Configuration warnings](#managed-settings-were-not-approved) |332| `Managed settings were not approved; exiting without applying them.` | [Configuration warnings](#managed-settings-were-not-approved) |

333| `Claude Code can't start: your organization's managed settings block the default model` / `Claude Code can't start: your organization allows only the models listed in "availableModels"` | [Configuration warnings](#managed-settings-block-the-default-model) |333| `Claude Code can't start: your organization's managed settings block the default model` / `Claude Code can't start: your organization allows only the models listed in "availableModels"` | [Configuration warnings](#managed-settings-block-the-default-model) |

334| `Your organization's managed settings allow Claude Code to use: <providers>` | [Configuration warnings](#managed-settings-dont-allow-this-api-provider) |

335| `Your organization's managed settings allow Claude Code to use no API provider at all` | [Configuration warnings](#managed-settings-dont-allow-this-api-provider) |

334| `MCP server <name> is blocked by enterprise managed policy` | [Configuration warnings](#mcp-server-is-blocked-by-enterprise-managed-policy) |336| `MCP server <name> is blocked by enterprise managed policy` | [Configuration warnings](#mcp-server-is-blocked-by-enterprise-managed-policy) |

335| `Managed settings document could not be parsed as a JSON object; none of its settings are in effect. Fix or remove it.` | [Configuration warnings](#managed-settings-document-could-not-be-parsed) |337| `Managed settings document could not be parsed as a JSON object; none of its settings are in effect. Fix or remove it.` | [Configuration warnings](#managed-settings-document-could-not-be-parsed) |

336| `Managed settings drop-in directory could not be read` | [Configuration warnings](#managed-settings-document-could-not-be-parsed) |338| `Managed settings drop-in directory could not be read` | [Configuration warnings](#managed-settings-document-could-not-be-parsed) |

339| `Unable to read managed policy settings` | [Configuration warnings](#unable-to-read-managed-policy-settings) |

337| `otelHeadersHelper failed; telemetry is not being exported. See /status: ...` | [Configuration warnings](#otelheadershelper-failed) |340| `otelHeadersHelper failed; telemetry is not being exported. See /status: ...` | [Configuration warnings](#otelheadershelper-failed) |

338| `"crossSessionInbound" must be one of "accept", "hold", "refuse"` | [Configuration warnings](#crosssessioninbound-must-be-one-of-accept-hold-refuse) |341| `"crossSessionInbound" must be one of "accept", "hold", "refuse"` | [Configuration warnings](#crosssessioninbound-must-be-one-of-accept-hold-refuse) |

339| `headersHelper not run — this workspace has no persisted trust` | [Configuration warnings](#headershelper-not-run) |342| `headersHelper not run — this workspace has no persisted trust` | [Configuration warnings](#headershelper-not-run) |


3657 Tidak dapat membuka Claude Desktop3660 Tidak dapat membuka Claude Desktop

3658</h3>3661</h3>

3659 3662 

3660Anda menjalankan [`/desktop`](/docs/id/desktop#coming-from-the-cli), atau alias `/app`, dan command sistem yang Claude Code gunakan untuk membuka Claude Desktop gagal. Sesi tetap di terminal.3663Anda menjalankan [`/desktop`](/docs/id/desktop#coming-from-the-cli) atau alias `/app` dalam sesi, atau [`claude --desktop`](/docs/id/cli-reference#cli-flags) di shell Anda, dan command sistem yang Claude Code gunakan untuk membuka Claude Desktop gagal. Setelah `/desktop`, sesi tetap di terminal; `claude --desktop` mencetak pesan tanpa awalan `Error:` dan keluar dengan status 1.

3664 

3665Teks dalam tanda kurung menamai command yang gagal, dengan status keluar dan baris pertama output kesalahannya ketika menghasilkannya. Di macOS command itu adalah `open`, seperti dalam contoh ini; di Windows itu adalah `rundll32`:

3661 3666 

3662```text theme={null}3667```text theme={null}

3663Error: Couldn't open Claude Desktop (`open` exited 1: LSOpenURLsWithRole() failed for the URL claude://resume?session=<session-id> with error -10814). Open Claude Desktop and run /desktop again.3668Error: Couldn't open Claude Desktop (`open` exited 1: LSOpenURLsWithRole() failed for the URL claude://resume?session=<session-id> with error -10814). Open Claude Desktop and try again.

3664```3669```

3665 3670 

3666**Yang harus dilakukan:**3671**Yang harus dilakukan:**

3667 3672 

3668* Buka Claude Desktop sendiri, kemudian jalankan `/desktop` lagi3673* Buka Claude Desktop sendiri, kemudian jalankan `/desktop` atau `claude --desktop` lagi

3669* Untuk membaca output kesalahan lengkap command itu, aktifkan debug logging dengan `/debug`, jalankan `/desktop` lagi, dan periksa log debug3674* Untuk membaca output kesalahan lengkap command itu, aktifkan debug logging dengan `/debug` dan jalankan `/desktop` lagi, atau jalankan `claude --desktop --debug-file <path>`, kemudian periksa log debug

3670 3675 

3671Sebelum v2.1.275, pesan adalah `Failed to open Claude Desktop. Please try opening it manually.` dan tidak mengatakan apa yang gagal.3676Sebelum v2.1.285, pesan berakhir `Open Claude Desktop and run /desktop again.` Sebelum v2.1.275, itu adalah `Failed to open Claude Desktop. Please try opening it manually.` dan tidak mengatakan apa yang gagal.

3672 3677 

3673<h3 id="terminal-setup-left-your-zed-keymap-unchanged">3678<h3 id="terminal-setup-left-your-zed-keymap-unchanged">

3674 /terminal-setup meninggalkan keymap Zed Anda tidak berubah3679 /terminal-setup meninggalkan keymap Zed Anda tidak berubah


3773 Marketplace is registered from an untrusted source3778 Marketplace is registered from an untrusted source

3774</h3>3779</h3>

3775 3780 

3776Marketplace terdaftar dengan nama yang [dicadangkan untuk marketplace Anthropic resmi](/docs/id/plugins/marketplace-reference#marketplace-file), tetapi sumber terdaftarnya bukan repositori GitHub `anthropics`. Claude Code memeriksa ulang nama yang dicadangkan setiap kali memuat atau menyegarkan marketplace, sehingga marketplace dan plugin yang dipasang darinya berhenti memuat. Sebelum v2.1.205, nama hanya diperiksa ketika marketplace ditambahkan, jadi entri yang terdaftar sebelum namanya dicadangkan terus memuat.3781Marketplace terdaftar dengan nama yang [dicadangkan untuk marketplace Anthropic resmi](/docs/id/plugins/marketplace-reference#marketplace-file), tetapi sumber terdaftarnya bukan repositori GitHub `anthropics`. Claude Code memeriksa ulang nama yang dicadangkan setiap kali memuat atau menyegarkan marketplace, sehingga marketplace dan plugin yang dipasang darinya berhenti memuat. Sebelum v2.1.205, entri yang terdaftar sebelum namanya dicadangkan terus memuat.

3777 3782 

3778```text theme={null}3783```text theme={null}

3779Marketplace "claude-community" is registered from an untrusted source: The name 'claude-community' is reserved for official Anthropic marketplaces. Only repositories from 'github.com/anthropics/' can use this name. To fix it, remove the marketplace and re-add it from the official source.3784Marketplace "claude-community" is registered from an untrusted source: The name 'claude-community' is reserved for official Anthropic marketplaces. Only repositories from 'github.com/anthropics/' can use this name. To fix it, remove the marketplace and re-add it from the official source.


3921commands path escapes plugin directory: ./commands\deploy.md — its path contains a backslash, which is not resolved reliably on this platform3926commands path escapes plugin directory: ./commands\deploy.md — its path contains a backslash, which is not resolved reliably on this platform

3922```3927```

3923 3928 

3924Sebelum v2.1.251, Claude Code memuat jalur `commands` yang dideklarasikan dalam entri marketplace bahkan ketika menunjuk di luar direktori plugin. Claude Code sudah menolak jalur yang dideklarasikan dalam `plugin.json` dan jalur komponen lainnya dalam entri marketplace.3929Sebelum v2.1.251, Claude Code memuat jalur `commands` yang dideklarasikan dalam entri marketplace bahkan ketika menunjuk di luar direktori plugin.

3925 3930 

3926Sebelum v2.1.257, pemeriksaan hanya melihat ejaan jalur, bukan di mana symlink mengarah.3931Sebelum v2.1.257, pemeriksaan hanya melihat ejaan jalur, bukan di mana symlink mengarah.

3927 3932 


4001* `Failed to load marketplace configuration`: file bukan JSON yang valid, atau tidak dapat dibaca. File kosong gagal dengan cara ini juga.4006* `Failed to load marketplace configuration`: file bukan JSON yang valid, atau tidak dapat dibaca. File kosong gagal dengan cara ini juga.

4002* `Marketplace configuration file is corrupted`: file adalah JSON yang valid tetapi isinya tidak cocok dengan skema registri.4007* `Marketplace configuration file is corrupted`: file adalah JSON yang valid tetapi isinya tidak cocok dengan skema registri.

4003 4008 

4004File yang hilang bukan kegagalan: Claude Code memperlakukannya sebagai registri tanpa marketplace.

4005 

4006Dengan file kosong, `claude plugin install` melaporkan:4009Dengan file kosong, `claude plugin install` melaporkan:

4007 4010 

4008```text theme={null}4011```text theme={null}


4626terminal host process died — press Enter to restart4629terminal host process died — press Enter to restart

4627```4630```

4628 4631 

4629Jika Anda membuka baris sebelum pemeriksaan berjalan, footer menampilkan `This session's terminal host process died (the conversation is saved) — press Enter to restart it` dan baris berubah menjadi gagal.

4630 

4631Dari shell, `claude attach <id>` memulai ulang sesi yang sudah ditandai gagal untuk host yang mati, dan sebaliknya mencetak penyebab dan keluar:4632Dari shell, `claude attach <id>` memulai ulang sesi yang sudah ditandai gagal untuk host yang mati, dan sebaliknya mencetak penyebab dan keluar:

4632 4633 

4633```text theme={null}4634```text theme={null}


5023 5024 

5024Claude Code menulis sebagian besar pesan ini ke stderr, bukan ke dalam percakapan, dan menulis sebagian besar di saat startup. Sebuah entri mengatakan demikian ketika pesannya muncul di tempat lain, seperti dalam log debug atau sebagai pemberitahuan startup dalam tampilan percakapan, atau pada waktu lain, seperti [baris diagnostik model yang tidak dikenali](#unrecognized-model-id-on-a-request) pada saat permintaan.5025Claude Code menulis sebagian besar pesan ini ke stderr, bukan ke dalam percakapan, dan menulis sebagian besar di saat startup. Sebuah entri mengatakan demikian ketika pesannya muncul di tempat lain, seperti dalam log debug atau sebagai pemberitahuan startup dalam tampilan percakapan, atau pada waktu lain, seperti [baris diagnostik model yang tidak dikenali](#unrecognized-model-id-on-a-request) pada saat permintaan.

5025 5026 

5026<h3 id="fullscreen-failed-start-notice">

5027 Fullscreen renderer tidak selesai memulai

5028</h3>

5029 

5030Sesi [fullscreen](/docs/id/fullscreen) sebelumnya di mesin ini keluar sebelum selesai memulai, jadi Claude Code memulai sesi ini pada renderer klasik dan mencetak salah satu pemberitahuan ini:

5031 

5032```text theme={null}

5033Claude Code's fullscreen renderer didn't finish starting last time on this machine, so this launch is using the classic renderer. It will try fullscreen again next launch; /tui default keeps the classic renderer.

5034 

5035Claude Code's fullscreen renderer has repeatedly failed to start on this machine, so it has been turned off here. Run /tui fullscreen to try it again (this also resets after an update).

5036```

5037 

5038**Yang harus dilakukan:**

5039 

5040* Ikuti [Fullscreen rendering](/docs/id/fullscreen#fullscreen-renderer-didnt-finish-starting). Ini mengatakan pemberitahuan mana yang Anda dapatkan, apa yang Claude Code lakukan di sesi-sesi berikutnya, dan cara mencoba fullscreen lagi atau tetap menggunakan renderer klasik.

5041* Jika sesi yang mati mencetak pesan keluar, lihat [Claude Code keluar setelah kesalahan antarmuka yang tidak dapat dipulihkan](#exited-after-an-unrecoverable-interface-error) untuk mengetahui apa yang dinamainya.

5042 

5043Sebelum v2.1.236, Claude Code tidak mencetak pemberitahuan dan terus memulai sesi dalam fullscreen rendering setelah kegagalan startup.

5044 

5045<h3 id="exited-after-an-unrecoverable-interface-error">5027<h3 id="exited-after-an-unrecoverable-interface-error">

5046 Claude Code keluar setelah kesalahan antarmuka yang tidak dapat dipulihkan5028 Claude Code keluar setelah kesalahan antarmuka yang tidak dapat dipulihkan

5047</h3>5029</h3>


5193* Jika Anda mengelola pengaturan, tambahkan model yang dapat dijalankan pengguna Anda ke `availableModels`, atau persempit entri `deniedModels` yang memblokir setiap fallback. [Block specific models or versions](/docs/id/model-config#block-specific-models-or-versions) menjelaskan bagaimana opsi Default diturunkan5175* Jika Anda mengelola pengaturan, tambahkan model yang dapat dijalankan pengguna Anda ke `availableModels`, atau persempit entri `deniedModels` yang memblokir setiap fallback. [Block specific models or versions](/docs/id/model-config#block-specific-models-or-versions) menjelaskan bagaimana opsi Default diturunkan

5194* Jika Anda tidak mengelolanya, kirim pesan ke administrator Anda. File pengaturan Anda sendiri tidak dapat memperluas daftar `availableModels` atau `deniedModels` yang dikelola5176* Jika Anda tidak mengelolanya, kirim pesan ke administrator Anda. File pengaturan Anda sendiri tidak dapat memperluas daftar `availableModels` atau `deniedModels` yang dikelola

5195 5177 

5178<h3 id="managed-settings-dont-allow-this-api-provider">

5179 Managed settings tidak mengizinkan penyedia API ini

5180</h3>

5181 

5182[Managed settings](/docs/id/managed-settings) organisasi Anda menetapkan daftar [`allowedProviders`](/docs/id/settings-reference#allowedproviders), dan penyedia API sesi tidak ada di dalamnya atau sesi menggunakan endpoint yang tidak disematkan dengan cara yang diperlukan entri itu. Claude Code menolak pada startup, sebelum login, atau ketika sesi berikutnya menghubungi API. Pesan dimulai dengan penyedia yang diizinkan:

5183 

5184```text theme={null}

5185Your organization's managed settings allow Claude Code to use: Anthropic API, Amazon Bedrock.

5186```

5187 

5188Ketika daftar kosong, pesan berbunyi sebagai gantinya:

5189 

5190```text theme={null}

5191Your organization's managed settings allow Claude Code to use no API provider at all (allowedProviders is an empty list), so it cannot start on this machine.

5192```

5193 

5194Ketika setiap entri tidak dikenali, parenthetical berbunyi `(allowedProviders lists only unrecognized entries)` sebagai gantinya.

5195 

5196**Yang harus dilakukan:**

5197 

5198* Ikuti langkah `To continue:` pesan

5199* Jika Anda mengelola pengaturan, baris pesan yang dimulai `Admins:` menyebutkan entri untuk ditambahkan atau nilai untuk disematkan, dan entri [`allowedProviders`](/docs/id/settings-reference#allowedproviders) mengatakan blok `env` sumber mana yang dapat menyematkannya

5200 

5196<h3 id="mcp-server-is-blocked-by-enterprise-managed-policy">5201<h3 id="mcp-server-is-blocked-by-enterprise-managed-policy">

5197 Server MCP diblokir oleh kebijakan yang dikelola perusahaan5202 Server MCP diblokir oleh kebijakan yang dikelola perusahaan

5198</h3>5203</h3>


5246* Jika Anda mengelola mesin, perbaiki dokumen yang dinamai sehingga diuraikan sebagai objek JSON, atau hapus file, profil, atau nilai registry. `managed-settings.json` kosong dihitung sebagai `{}` dan tidak memblokir peluncuran.5251* Jika Anda mengelola mesin, perbaiki dokumen yang dinamai sehingga diuraikan sebagai objek JSON, atau hapus file, profil, atau nilai registry. `managed-settings.json` kosong dihitung sebagai `{}` dan tidak memblokir peluncuran.

5247* Jika tidak, minta administrator Anda untuk memperbaiki dokumen yang diterapkan. Tidak ada dalam file pengaturan Anda sendiri yang menyebabkan atau menghapus kesalahan ini.5252* Jika tidak, minta administrator Anda untuk memperbaiki dokumen yang diterapkan. Tidak ada dalam file pengaturan Anda sendiri yang menyebabkan atau menghapus kesalahan ini.

5248 5253 

5254<h3 id="unable-to-read-managed-policy-settings">

5255 Tidak dapat membaca pengaturan kebijakan yang dikelola

5256</h3>

5257 

5258Organisasi Anda menerapkan [managed settings](/docs/id/managed-settings), dan salah satu sumber yang diterapkan ada tetapi tidak dapat dibaca, karena alasan seperti kesalahan I/O daripada sistem operasi menolak pembacaan. Tanpa sumber admin lain yang menyediakan kebijakan, Claude Code keluar pada startup daripada berjalan tanpa kebijakan yang mungkin dibawa sumber:

5259 

5260```text theme={null}

5261Unable to read managed policy settings.

5262This machine may require organization login enforcement, but the policy file failed to load.

5263Contact your administrator.

5264 

5265Detail: <source>: <reason>

5266```

5267 

5268Dalam keadaan yang sama, alur sign-in, permintaan API dari sesi yang sudah berjalan, dan server [`claude gateway`](/docs/id/claude-apps-gateway) ditolak dengan varian baris pertama yang menyebutkan [`allowedProviders`](/docs/id/settings-reference#allowedproviders).

5269 

5270Pembacaan yang ditolak sistem operasi, seperti pada file root-only, tidak menghasilkan keluar ini: [sesi dimulai tanpa kebijakan sumber itu](/docs/id/managed-settings#find-entries-claude-code-dropped). Untuk sumber yang tidak dapat diuraikan, Claude Code keluar dengan [pesan berbeda yang menyebutkan sumber](#managed-settings-document-could-not-be-parsed).

5271 

5272**Yang harus dilakukan:**

5273 

5274* Jika Anda mengelola mesin, perbaiki masalah yang dinamai baris `Detail:` sehingga sumber yang diterapkan dapat dibaca, atau hapus sumber

5275* Jika tidak, kirim pesan ke administrator Anda. Tidak ada dalam file pengaturan Anda sendiri yang menyebabkan atau menghapus kesalahan ini

5276 

5277Sebelum v2.1.285, hanya sesi yang masuk dengan kredensial claude.ai atau Claude Console yang keluar dengan pesan ini, dan pembacaan yang ditolak sistem operasi juga menghasilkannya.

5278 

5249<h3 id="otelheadershelper-failed">5279<h3 id="otelheadershelper-failed">

5250 otelHeadersHelper gagal5280 otelHeadersHelper gagal

5251</h3>5281</h3>


5458 Respons tampak berkualitas lebih rendah dari biasanya5488 Respons tampak berkualitas lebih rendah dari biasanya

5459</h2>5489</h2>

5460 5490 

5461Jika jawaban Claude tampak kurang mampu dari yang Anda harapkan tetapi tidak ada kesalahan yang ditampilkan, penyebabnya biasanya adalah status percakapan daripada model itu sendiri. Claude Code tidak secara diam-diam mengubah versi model. Ini dapat beralih ke model fallback dalam tiga kasus spesifik:5491Jika jawaban Claude tampak kurang mampu dari yang Anda harapkan tetapi tidak ada kesalahan yang ditampilkan, penyebabnya biasanya adalah status percakapan daripada model itu sendiri. Claude Code tidak secara diam-diam mengubah versi model. Ini dapat beralih ke model fallback dalam kasus-kasus berikut:

5462 5492 

5463* [`--fallback-model`](/docs/id/cli-reference#cli-flags) yang dikonfigurasi mengambil alih setelah kesalahan ketersediaan, hanya untuk giliran itu, dengan pemberitahuan dalam transkrip5493* [`--fallback-model`](/docs/id/cli-reference#cli-flags) yang dikonfigurasi mengambil alih setelah kesalahan ketersediaan, hanya untuk giliran itu, dengan pemberitahuan dalam transkrip

5464* Pemeriksaan startup Amazon Bedrock atau Google Cloud's Agent Platform menemukan model default Anda tidak tersedia5494* Pemeriksaan startup Amazon Bedrock atau Google Cloud's Agent Platform menemukan model default Anda tidak tersedia, atau akun Anda [kehilangan akses ke sana di tengah sesi](/docs/id/amazon-bedrock#when-a-model-is-disabled-mid-session)

5465* [Fallback model otomatis](/docs/id/model-config#automatic-model-fallback) pada Fable 5.1, Fable 5, Opus 5.5, Sonnet 5.5, dan Opus 5 memindahkan sesi ke model fallback kategori yang ditandai, ketika kategori itu memiliki satu, dan menampilkan pemberitahuan dalam transkrip5495* [Fallback model otomatis](/docs/id/model-config#automatic-model-fallback) pada Fable 5.1, Fable 5, Opus 5.5, Sonnet 5.5, dan Opus 5 memindahkan sesi ke model fallback kategori yang ditandai, ketika kategori itu memiliki satu, dan menampilkan pemberitahuan dalam transkrip

5466 5496 

5467Pemeriksaan Model selection di bawah menangkap kasus kedua dan ketiga; yang pertama muncul sebagai pemberitahuan transkrip daripada perubahan `/model`. [Model configuration](/docs/id/model-config) menjelaskan kapan setiap fallback berlaku.5497Pemeriksaan Model selection di bawah menangkap kasus kedua dan ketiga; yang pertama muncul sebagai pemberitahuan transkrip daripada perubahan `/model`. [Model configuration](/docs/id/model-config) menjelaskan kapan setiap fallback berlaku.

Details

293 293 

294Alias model seperti `opus` tidak bertindak sebagai pin, begitu juga dengan ID model yang tidak dikenali Claude Code.294Alias model seperti `opus` tidak bertindak sebagai pin, begitu juga dengan ID model yang tidak dikenali Claude Code.

295 295 

296Ketika pemeriksaan ini menemukan model yang tidak dapat dipanggil proyek Anda, Claude Code mengingat penolakan di mesin ini hingga satu hari, dan peluncuran selama waktu itu melewati model yang diingat tanpa bertanya kepada Agent Platform lagi. Claude Code memeriksa penolakan yang diingat dari model default saat ini lagi saat peluncuran setelah sepuluh menit telah berlalu sejak pemeriksaan terakhir, jadi default yang diaktifkan kembali oleh administrator Anda kembali. Untuk mematikan memori, atur [`CLAUDE_CODE_SKIP_MODEL_ACCESS_MEMORY=1`](/docs/id/env-vars).

297 

298<h3 id="when-a-model-is-disabled-mid-session">

299 Ketika model dinonaktifkan di tengah sesi

300</h3>

301 

302Jika proyek Anda kehilangan akses ke model yang sesi Anda jalankan, misalnya karena administrator menonaktifkannya di [Model Garden](https://console.cloud.google.com/vertex-ai/model-garden), Claude Code beralih sesi ke model lain alih-alih gagal pada setiap permintaan, dan menampilkan `Switched to <fallback> because <model> is not available`. Ia mencoba model yang sama seperti fallback startup: versi sebelumnya dari tier yang sama terlebih dahulu dan, untuk sesi Opus tanpa versi Opus yang tersedia, model Sonnet default.

303 

304Pengalihan hanya berlaku untuk tier yang belum Anda pinkan, kondisi yang sama seperti fallback startup. Sesi pada versi spesifik yang Anda pilih mempertahankan modelnya dan, tanpa rantai model fallback, permintaan gagal sebagai gantinya. Dalam [mode auto](/docs/id/permission-modes#enable-auto-mode-on-bedrock-agent-platform-or-foundry), Claude Code hanya beralih ke model yang didukung mode auto di Agent Platform. Jika tidak ada model tersebut yang tersedia, permintaan gagal.

305 

306[Rantai model fallback](/docs/id/model-config#fallback-model-chains) yang Anda konfigurasi menggantikan pengalihan tier: pada penolakan ini Claude Code beralih ke fallback yang Anda konfigurasi sebagai gantinya. Untuk membuat permintaan yang ditolak gagal daripada beralih, atur [`CLAUDE_CODE_DISABLE_MODEL_ACCESS_FALLBACK=1`](/docs/id/env-vars). Rantai fallback yang Anda konfigurasi masih beralih pada penolakan ini; hapus rantai juga jika Anda ingin setiap permintaan yang ditolak gagal.

307 

296<h2 id="iam-configuration">308<h2 id="iam-configuration">

297 Konfigurasi IAM309 Konfigurasi IAM

298</h2>310</h2>

headless.md +2 −2

Details

296 Persetujuan otomatis alat296 Persetujuan otomatis alat

297</h3>297</h3>

298 298 

299Gunakan `--allowedTools` untuk membiarkan Claude menggunakan alat tertentu tanpa meminta. Contoh ini menjalankan suite pengujian dan memperbaiki kegagalan, memungkinkan Claude untuk menjalankan perintah Bash dan membaca/mengedit file tanpa meminta izin:299Gunakan `--allowedTools` untuk membiarkan Claude menggunakan alat tertentu tanpa meminta. Mencantumkan `Read` dan `Edit` memungkinkan Claude membaca dan mengedit file tanpa meminta izin. Mencantumkan `Bash` melakukan hal yang sama untuk perintah shell, kecuali dalam jalankan yang dimulai dalam [mode auto](/docs/id/permission-modes#how-auto-mode-evaluates-actions), di mana Claude Code menghapus entri `Bash` telanjang sebagai aturan allow yang luas dan mode auto mengevaluasi setiap perintah sebagai gantinya. Contoh ini menjalankan suite pengujian dan memperbaiki kegagalan dengan ketiga alat tersebut tercantum:

300 300 

301```bash theme={null}301```bash theme={null}

302claude -p "Run the test suite and fix any failures" \302claude -p "Run the test suite and fix any failures" \

303 --allowedTools "Bash,Read,Edit"303 --allowedTools "Bash,Read,Edit"

304```304```

305 305 

306Untuk menetapkan baseline untuk seluruh sesi alih-alih mencantumkan alat individual, berikan [mode izin](/docs/id/permission-modes). Untuk `-p`, [mode izin awal bawaan](/docs/id/permission-modes#which-mode-a-session-starts-in) adalah Manual di setiap paket, jadi berikan mode izin yang Anda inginkan:306Untuk menetapkan baseline untuk seluruh sesi alih-alih mencantumkan alat individual, berikan [mode izin](/docs/id/permission-modes). Jalankan di mana tidak ada yang menetapkan mode izin mengambil [mode izin awal bawaan](/docs/id/permission-modes#which-mode-a-session-starts-in), yang dapat berupa `auto`, jadi berikan yang Anda inginkan:

307 307 

308* **`auto`**: berikan `--permission-mode auto` untuk memiliki pengklasifikasi meninjau sebagian besar tindakan alih-alih Anda308* **`auto`**: berikan `--permission-mode auto` untuk memiliki pengklasifikasi meninjau sebagian besar tindakan alih-alih Anda

309* **`dontAsk`**: Claude Code menolak setiap panggilan yang akan meminta sebaliknya, yang berguna untuk CI runs yang terkunci. Tindakan yang tidak memerlukan persetujuan dalam mode Manual masih berjalan, seperti pembacaan file di direktori kerja Anda dan [set perintah read-only](/docs/id/permissions#read-only-commands), dan begitu juga tindakan yang entri `--allowedTools` Anda atau aturan `permissions.allow` cover. `AskUserQuestion`, alat konektor [organisasi Anda atur ke `ask`](/docs/id/mcp#organization-controls-on-connector-tools), dan alat MCP yang ditandai [`requiresUserInteraction`](/docs/id/mcp#require-approval-for-a-specific-tool) ditolak bahkan ketika aturan allow cocok309* **`dontAsk`**: Claude Code menolak setiap panggilan yang akan meminta sebaliknya, yang berguna untuk CI runs yang terkunci. Tindakan yang tidak memerlukan persetujuan dalam mode Manual masih berjalan, seperti pembacaan file di direktori kerja Anda dan [set perintah read-only](/docs/id/permissions#read-only-commands), dan begitu juga tindakan yang entri `--allowedTools` Anda atau aturan `permissions.allow` cover. `AskUserQuestion`, alat konektor [organisasi Anda atur ke `ask`](/docs/id/mcp#organization-controls-on-connector-tools), dan alat MCP yang ditandai [`requiresUserInteraction`](/docs/id/mcp#require-approval-for-a-specific-tool) ditolak bahkan ketika aturan allow cocok

Details

346* Meminta Claude Code untuk menjalankan perintah di latar belakang346* Meminta Claude Code untuk menjalankan perintah di latar belakang

347* Tekan `Ctrl+B` untuk memindahkan invokasi alat Bash biasa ke latar belakang. Pengguna Tmux harus menekan `Ctrl+B` dua kali karena kunci awalan tmux.347* Tekan `Ctrl+B` untuk memindahkan invokasi alat Bash biasa ke latar belakang. Pengguna Tmux harus menekan `Ctrl+B` dua kali karena kunci awalan tmux.

348 348 

349Ketika perintah mencapai batas waktu sebelum selesai, Claude Code secara otomatis [memindahkannya ke latar belakang](/docs/id/tools-reference#background-commands) alih-alih menghentikannya, kecuali perintah dimulai dengan `sleep`. Untuk mengubah berapa lama perintah berjalan sebelum itu terjadi, atur [variabel lingkungan batas waktu Bash](/docs/id/tools-reference#timeout-and-output-limits).349Ketika perintah mencapai batas waktu sebelum selesai, Claude Code secara otomatis [memindahkannya ke latar belakang](/docs/id/tools-reference#foreground-commands-that-move-to-the-background) alih-alih menghentikannya, kecuali perintah dimulai dengan `sleep`. Jika Anda telah mematikan tugas latar belakang dengan [`CLAUDE_CODE_DISABLE_BACKGROUND_TASKS`](/docs/id/env-vars#variables) atau dengan memulai dalam [mode bare](/docs/id/headless#start-faster-with-bare-mode), perintah berhenti pada batas waktu. Untuk mengubah batas waktu, atur [variabel lingkungan batas waktu Bash](/docs/id/tools-reference#timeout-and-output-limits).

350 350 

351**Fitur utama:**351**Fitur utama:**

352 352 


358* Di macOS dan Linux, Claude Code menghentikan tugas latar belakang yang berjalan ketika sistem operasi melaporkan tekanan memori kritis, asalkan sesi telah menganggur selama minimal 30 menit dan tidak ada putaran atau subagen yang berjalan. Memerlukan Claude Code v2.1.193 atau lebih baru358* Di macOS dan Linux, Claude Code menghentikan tugas latar belakang yang berjalan ketika sistem operasi melaporkan tekanan memori kritis, asalkan sesi telah menganggur selama minimal 30 menit dan tidak ada putaran atau subagen yang berjalan. Memerlukan Claude Code v2.1.193 atau lebih baru

359 * [Log debug](/docs/id/debug-your-config) mengatakan mengapa tugas dihentikan, atau mengapa peristiwa tekanan meninggalkan mereka tetap berjalan359 * [Log debug](/docs/id/debug-your-config) mengatakan mengapa tugas dihentikan, atau mengapa peristiwa tekanan meninggalkan mereka tetap berjalan

360 * Atur [`CLAUDE_CODE_DISABLE_BG_SHELL_PRESSURE_REAP`](/docs/id/env-vars) ke `1` untuk mematikan penghentian tekanan memori360 * Atur [`CLAUDE_CODE_DISABLE_BG_SHELL_PRESSURE_REAP`](/docs/id/env-vars) ke `1` untuk mematikan penghentian tekanan memori

361* Perintah Bash dan PowerShell latar belakang memiliki batas waktu, dihitung dari saat perintah memasuki latar belakang: 30 menit, atau `timeout` yang Claude minta ketika memulai perintah di latar belakang, hingga maksimal 2 jam. Perintah yang pindah ke latar belakang saat berjalan, misalnya dengan `Ctrl+B`, mendapat 30 menit dari perpindahan. Ketika perintah mencapai batasnya, Claude Code menghentikannya dan memberi tahu Claude mengapa, dan Claude dapat memulainya lagi dengan `timeout` yang lebih lama jika pekerjaan masih membutuhkannya. Dua variabel lingkungan menaikkan batasnya, dalam milidetik, dan keduanya tidak dapat mempersingkatnya:361* Perintah Bash dan PowerShell latar belakang memiliki batas waktu, dihitung dari saat perintah memasuki latar belakang: 30 menit, atau `timeout` yang Claude minta ketika memulai perintah di latar belakang, hingga maksimal 2 jam. Perintah yang pindah ke latar belakang saat berjalan, misalnya dengan `Ctrl+B`, mendapat 30 menit dari perpindahan. Ketika perintah mencapai batasnya, Claude Code menghentikannya dan memberi tahu Claude mengapa, dan Claude dapat memulainya lagi dengan `timeout` yang lebih lama jika pekerjaan masih membutuhkannya. Untuk memperpanjang batasnya, lihat [Naikkan batas waktu untuk perintah latar belakang](/docs/id/tools-reference#raise-the-time-limit-for-background-commands) dalam referensi alat

362 * Atur [`BASH_DEFAULT_TIMEOUT_MS`](/docs/id/env-vars) di atas `1800000` untuk mengganti default 30 menit dengan nilai tersebut, untuk perintah yang dipindahkan juga362* Perintah latar belakang yang dimulai oleh [subagen](/docs/id/sub-agents#run-subagents-in-foreground-or-background) di latar depan berakhir ketika subagen tersebut selesai, gagal, atau dihentikan; lihat [Ketika perintah latar belakang berhenti](/docs/id/tools-reference#when-a-background-command-stops) dalam referensi alat

363 * Atur [`BASH_MAX_TIMEOUT_MS`](/docs/id/env-vars) di atas `7200000` untuk menaikkan maksimal 2 jam. Mengatur `BASH_DEFAULT_TIMEOUT_MS` di atas `7200000` menaikkannya dengan cara yang sama

364* Perintah latar belakang yang dimulai oleh [subagen](/docs/id/sub-agents#run-subagents-in-foreground-or-background) di latar depan berakhir ketika subagen tersebut selesai, gagal, atau dihentikan; lihat [Perintah latar belakang](/docs/id/tools-reference#background-commands) dalam referensi alat

365 363 

366Untuk menonaktifkan semua fungsi tugas latar belakang, atur variabel lingkungan `CLAUDE_CODE_DISABLE_BACKGROUND_TASKS` ke `1`. Lihat [Variabel lingkungan](/docs/id/env-vars) untuk detail.364Untuk menonaktifkan semua fungsi tugas latar belakang, atur variabel lingkungan [`CLAUDE_CODE_DISABLE_BACKGROUND_TASKS`](/docs/id/env-vars#variables) ke `1`. Memulai dalam [mode bare](/docs/id/headless#start-faster-with-bare-mode) juga mematikannya.

367 365 

368**Perintah yang sering dibuat latar belakang:**366**Perintah yang sering dibuat latar belakang:**

369 367 

keybindings.md +1 −3

Details

545* Di bawah tata letak non-Latin seperti Cyrillic, Claude Code mencocokkan pintasan Ctrl berdasarkan posisi kunci tata letak US ketika terminal menggunakan protokol keyboard Kitty dan melaporkan posisi tersebut. Di terminal seperti itu, dengan tata letak Rusia aktif, menekan Ctrl dan tombol fisik W memicu `ctrl+w`. Di terminal yang tidak melaporkan posisi, Claude Code mencocokkan apa pun yang dikirim terminal untuk penekanan kunci: kode kontrol ASCII memicu pintasan Latin, dan penekanan kunci yang tiba sebagai karakter Cyrillic tidak cocok dengan binding apa pun545* Di bawah tata letak non-Latin seperti Cyrillic, Claude Code mencocokkan pintasan Ctrl berdasarkan posisi kunci tata letak US ketika terminal menggunakan protokol keyboard Kitty dan melaporkan posisi tersebut. Di terminal seperti itu, dengan tata letak Rusia aktif, menekan Ctrl dan tombol fisik W memicu `ctrl+w`. Di terminal yang tidak melaporkan posisi, Claude Code mencocokkan apa pun yang dikirim terminal untuk penekanan kunci: kode kontrol ASCII memicu pintasan Latin, dan penekanan kunci yang tiba sebagai karakter Cyrillic tidak cocok dengan binding apa pun

546* Di bawah tata letak yang mengatur ulang huruf Latin, seperti AZERTY, Claude Code mencocokkan huruf yang diketik kunci, jadi menekan Ctrl dan kunci berlabel A memicu `ctrl+a`546* Di bawah tata letak yang mengatur ulang huruf Latin, seperti AZERTY, Claude Code mencocokkan huruf yang diketik kunci, jadi menekan Ctrl dan kunci berlabel A memicu `ctrl+a`

547 547 

548Sebelum v2.1.247, menekan pintasan Ctrl di bawah tata letak non-Latin tidak memicu binding-nya di terminal yang menggunakan protokol keyboard Kitty, seperti Ghostty, Kitty, WezTerm, dan iTerm2.

549 

550<h3 id="chords">548<h3 id="chords">

551 Chord549 Chord

552</h3>550</h3>


697* Modifier yang salah eja, seperti `ctl+k`. Claude Code menghapus bagian yang tidak dikenalinya dan menerapkan binding ke keystroke yang tersisa, `k` dalam contoh ini.695* Modifier yang salah eja, seperti `ctl+k`. Claude Code menghapus bagian yang tidak dikenalinya dan menerapkan binding ke keystroke yang tersisa, `k` dalam contoh ini.

698* Nama konteks tidak valid696* Nama konteks tidak valid

699* Nilai action tidak valid, seperti action yang bukan string atau `null`697* Nilai action tidak valid, seperti action yang bukan string atau `null`

700* Nama action yang tidak dikenal, seperti typo dari action yang terdaftar. Claude Code melewati binding dan mempertahankan binding default apa pun untuk kunci tersebut. Sebelum v2.1.246, binding dengan nama action yang tidak dikenal secara diam-diam menonaktifkan kunci tersebut698* Nama action yang tidak dikenal, seperti typo dari action yang terdaftar. Claude Code melewati binding dan mempertahankan binding default apa pun untuk kunci tersebut.

701* Konflik pintasan yang dicadangkan699* Konflik pintasan yang dicadangkan

702* Binding duplikat dalam konteks yang sama700* Binding duplikat dalam konteks yang sama

703 701 

llm-gateway.md +2 −0

Details

45 45 

46[Luncurkan gateway LLM untuk organisasi Anda](/docs/id/llm-gateway-rollout) menjelaskan setiap langkah dan menunjukkan file konfigurasi untuk didistribusikan di setiap langkah. Gateway adalah satu bagian dari pengaturan organisasi; untuk penegakan kebijakan, visibilitas penggunaan, dan keputusan penanganan data, lihat [Siapkan Claude Code untuk organisasi Anda](/docs/id/admin-setup).46[Luncurkan gateway LLM untuk organisasi Anda](/docs/id/llm-gateway-rollout) menjelaskan setiap langkah dan menunjukkan file konfigurasi untuk didistribusikan di setiap langkah. Gateway adalah satu bagian dari pengaturan organisasi; untuk penegakan kebijakan, visibilitas penggunaan, dan keputusan penanganan data, lihat [Siapkan Claude Code untuk organisasi Anda](/docs/id/admin-setup).

47 47 

48Untuk membuat gateway yang dicapai melalui `ANTHROPIC_BASE_URL` menjadi satu-satunya tujuan yang dapat digunakan mesin terkelola, atur [`allowedProviders`](/docs/id/settings-reference#allowedproviders) ke `["customEndpoint"]` dalam file pengaturan terkelola yang sama dan masukkan `ANTHROPIC_BASE_URL` gateway dalam blok `env` file tersebut. Claude Code kemudian menolak sesi yang ditunjukkan ke tempat lain, termasuk ke Anthropic secara langsung atau ke proxy pengembang sendiri, dan menerima `ANTHROPIC_BASE_URL` hanya dengan nilai yang Anda tetapkan di sana. Untuk gateway yang dicapai melalui variabel titik akhir khusus penyedia seperti `ANTHROPIC_BEDROCK_BASE_URL`, entri `allowedProviders` mengatakan variabel mana yang akan dikunci. Memerlukan Claude Code v2.1.285 atau lebih baru.

49 

48<h2 id="subscriptions-and-gateways">50<h2 id="subscriptions-and-gateways">

49 Langganan dan gateway51 Langganan dan gateway

50</h2>52</h2>

Details

310 310 

311Claude Code mengirim permintaan penemuan dengan kedua header kredensial di bawah dan menghilangkan header yang nilainya tidak diselesaikan. Mengirim kedua header memerlukan Claude Code v2.1.248 atau lebih baru. Versi sebelumnya mengirim hanya `Authorization` ketika `ANTHROPIC_AUTH_TOKEN` diatur dan hanya `x-api-key` sebaliknya.311Claude Code mengirim permintaan penemuan dengan kedua header kredensial di bawah dan menghilangkan header yang nilainya tidak diselesaikan. Mengirim kedua header memerlukan Claude Code v2.1.248 atau lebih baru. Versi sebelumnya mengirim hanya `Authorization` ketika `ANTHROPIC_AUTH_TOKEN` diatur dan hanya `x-api-key` sebaliknya.

312 312 

313* `Authorization`: `ANTHROPIC_AUTH_TOKEN` sebagai token bearer, jika tidak nilai [`apiKeyHelper`](/docs/id/llm-gateway-connect#rotate-credentials-with-apikeyhelper) sebagai token bearer. Dalam hal ini Claude Code menunggu helper mengembalikan sebelum mengirim permintaan.313* `Authorization`: `ANTHROPIC_AUTH_TOKEN` sebagai token bearer, jika tidak nilai [`apiKeyHelper`](/docs/id/llm-gateway-connect#rotate-credentials-with-apikeyhelper) sebagai token bearer.

314* `x-api-key`: kunci API yang diselesaikan Claude Code, seperti `ANTHROPIC_API_KEY`. Ketika nilai helper adalah satu-satunya kredensial, header ini juga membawanya, sehingga nilai tiba di kedua header.314* `x-api-key`: kunci API yang diselesaikan Claude Code, seperti `ANTHROPIC_API_KEY`. Ketika nilai helper adalah satu-satunya kredensial, header ini juga membawanya, sehingga nilai tiba di kedua header.

315 315 

316Claude Code juga mengirim header apa pun dari `ANTHROPIC_CUSTOM_HEADERS`. Ketika header kustom memiliki nilai non-kosong, Claude Code mengirimnya sebagai pengganti header built-in dengan nama yang sama, mencocokkan nama secara case-insensitive.316Claude Code juga mengirim header apa pun dari `ANTHROPIC_CUSTOM_HEADERS`. Ketika header kustom memiliki nilai non-kosong, Claude Code mengirimnya sebagai pengganti header built-in dengan nama yang sama, mencocokkan nama secara case-insensitive.

Details

199 199 

200Kunci [login gateway](#choose-a-delivery-mechanism) mengikuti aturan terpisah. Claude Code tidak pernah membacanya dari pengaturan yang dikelola server, jadi sementara pengaturan yang dikelola server adalah sumber yang dipilih, sumber admin dengan peringkat tertinggi di mesin yang membawa kunci kebijakan masih menyediakannya. Nilai dalam sumber admin yang diberi peringkat di bawah yang itu, atau dalam registri HKCU, diabaikan.200Kunci [login gateway](#choose-a-delivery-mechanism) mengikuti aturan terpisah. Claude Code tidak pernah membacanya dari pengaturan yang dikelola server, jadi sementara pengaturan yang dikelola server adalah sumber yang dipilih, sumber admin dengan peringkat tertinggi di mesin yang membawa kunci kebijakan masih menyediakannya. Nilai dalam sumber admin yang diberi peringkat di bawah yang itu, atau dalam registri HKCU, diabaikan.

201 201 

202[`allowedProviders`](/docs/id/settings-reference#allowedproviders) memiliki aturannya sendiri: catatan Scope entrinya mengatakan bagaimana daftar yang ditetapkan di mesin menggabungkan dengan yang dikelola server. Memerlukan Claude Code v2.1.285 atau lebih baru.

203 

202Ketika sumber admin menetapkan `allowManagedMcpServersOnly` atau daftar `allowedMcpServers` dan nilai itu bukan yang berlaku, `/status` dan `claude doctor` menamai sumber dan kunci itu.204Ketika sumber admin menetapkan `allowManagedMcpServersOnly` atau daftar `allowedMcpServers` dan nilai itu bukan yang berlaku, `/status` dan `claude doctor` menamai sumber dan kunci itu.

203 205 

204<h3 id="compose-every-managed-source">206<h3 id="compose-every-managed-source">


353* File pengaturan terkelola yang kosong dihitung sebagai `{}`.355* File pengaturan terkelola yang kosong dihitung sebagai `{}`.

354* Nilai yang salah bentuk dalam kunci registri HKCU yang dapat ditulis pengguna tidak pernah memblokir peluncuran. Claude Code melaporkannya sebagai pemberitahuan di `/status` dan `claude doctor` sebagai gantinya.356* Nilai yang salah bentuk dalam kunci registri HKCU yang dapat ditulis pengguna tidak pernah memblokir peluncuran. Claude Code melaporkannya sebagai pemberitahuan di `/status` dan `claude doctor` sebagai gantinya.

355 357 

356Jika file pengaturan terkelola, file drop-in, atau direktori `managed-settings.d/` tidak dapat dibaca dan tidak ada sumber admin yang menyediakan kebijakan, sesi yang masuk dengan kredensial claude.ai atau Claude Console keluar saat startup dengan pesan untuk menghubungi administrator.358Ketika file pengaturan terkelola, file drop-in, direktori `managed-settings.d/`, profil MDM, atau nilai registri HKLM ada tetapi tidak dapat dibaca, dan tidak ada sumber admin yang menyediakan kebijakan, apa yang terjadi tergantung pada alasan pembacaan gagal:

359 

360* Jika sistem operasi menolak pembacaan, misalnya pada file hanya root, setiap sesi dimulai tanpa kebijakan sumber tersebut. `/status` dan `claude doctor` mencatat kegagalan, dan jalankan dengan `-p` juga mencetaknya ke stderr.

361* Untuk kegagalan pembacaan lainnya, seperti kesalahan I/O, setiap sesi keluar saat startup dengan [pesan untuk menghubungi administrator](/docs/id/errors#unable-to-read-managed-policy-settings).

357 362 

358Untuk menemukan entri yang dijatuhkan, lihat di salah satu dari tiga tempat:363Untuk menemukan entri yang dijatuhkan, lihat di salah satu dari tiga tempat:

359 364 


387| Bidang | Perilaku ketika ada tetapi tidak valid |392| Bidang | Perilaku ketika ada tetapi tidak valid |

388| :- | :- |393| :- | :- |

389| `allowedMcpServers` | Diberlakukan sebagai daftar izin kosong sampai nilai diperbaiki, sehingga tidak ada server MCP yang ditambahkan pengguna yang diterima. Server yang organisasi Anda berikan melalui [`managedMcpServers`](/docs/id/settings-reference#managedmcpservers) masih dimuat, dan server `managed-mcp.json` dimuat per [Bagaimana server dievaluasi](/docs/id/managed-mcp#how-a-server-is-evaluated). Entri individual yang tidak valid dilepas dan subset yang valid diberlakukan. |394| `allowedMcpServers` | Diberlakukan sebagai daftar izin kosong sampai nilai diperbaiki, sehingga tidak ada server MCP yang ditambahkan pengguna yang diterima. Server yang organisasi Anda berikan melalui [`managedMcpServers`](/docs/id/settings-reference#managedmcpservers) masih dimuat, dan server `managed-mcp.json` dimuat per [Bagaimana server dievaluasi](/docs/id/managed-mcp#how-a-server-is-evaluated). Entri individual yang tidak valid dilepas dan subset yang valid diberlakukan. |

395| [`allowedProviders`](/docs/id/settings-reference#allowedproviders) | Diberlakukan sebagai daftar izin kosong sampai nilai diperbaiki, sehingga setiap penyedia API ditolak dan Claude Code tidak memulai pada mesin. Jika hanya entri individual yang bukan nama penyedia yang dikenal, Claude Code menjatuhkan dan melaporkan entri tersebut dan memberlakukan sisanya. |

390| `allowedHttpHookUrls` | Claude Code memberlakukan [daftar izin](/docs/id/settings-reference#allowedhttphookurls) terkelola kosong sampai Anda memperbaiki nilai, sehingga hook HTTP berjalan hanya jika file pengaturan lain mencantumkan URL-nya. Jika hanya entri individual yang tidak valid, Claude Code melepas entri tersebut dan memberlakukan sisanya. |396| `allowedHttpHookUrls` | Claude Code memberlakukan [daftar izin](/docs/id/settings-reference#allowedhttphookurls) terkelola kosong sampai Anda memperbaiki nilai, sehingga hook HTTP berjalan hanya jika file pengaturan lain mencantumkan URL-nya. Jika hanya entri individual yang tidak valid, Claude Code melepas entri tersebut dan memberlakukan sisanya. |

391| `httpHookAllowedEnvVars` | Claude Code memberlakukan [daftar izin](/docs/id/settings-reference#httphookallowedenvvars) terkelola kosong sampai Anda memperbaiki nilai, sehingga variabel header diinterpolasi hanya jika file pengaturan lain menamakannya. Jika hanya entri individual yang tidak valid, Claude Code melepas entri tersebut dan memberlakukan sisanya. |397| `httpHookAllowedEnvVars` | Claude Code memberlakukan [daftar izin](/docs/id/settings-reference#httphookallowedenvvars) terkelola kosong sampai Anda memperbaiki nilai, sehingga variabel header diinterpolasi hanya jika file pengaturan lain menamakannya. Jika hanya entri individual yang tidak valid, Claude Code melepas entri tersebut dan memberlakukan sisanya. |

392| `allowedChannelPlugins` | Claude Code memberlakukan daftar izin kosong sampai Anda memperbaiki nilai, sehingga tidak ada plugin saluran yang dilewatkan ke `--channels` yang diterima. Jika hanya entri individual yang tidak valid, Claude Code melepas entri tersebut dan memberlakukan sisanya. |398| `allowedChannelPlugins` | Claude Code memberlakukan daftar izin kosong sampai Anda memperbaiki nilai, sehingga tidak ada plugin saluran yang dilewatkan ke `--channels` yang diterima. Jika hanya entri individual yang tidak valid, Claude Code melepas entri tersebut dan memberlakukan sisanya. |


437 443 

438Sebagian besar adalah kunci: nilai yang dikunci, seperti aturan izin atau `sandbox.network.allowedDomains`, adalah kunci biasa yang dapat diatur tingkat apa pun, dan kunci memberi tahu Claude Code untuk menghormati hanya nilai terkelola.444Sebagian besar adalah kunci: nilai yang dikunci, seperti aturan izin atau `sandbox.network.allowedDomains`, adalah kunci biasa yang dapat diatur tingkat apa pun, dan kunci memberi tahu Claude Code untuk menghormati hanya nilai terkelola.

439 445 

440Tabel mencakup kontrol izin, plugin, dan pengiriman. Untuk kunci apa pun yang tidak tercantum di sini, kolom Scope dari [referensi pengaturan](/docs/id/settings-reference#all-settings) index mengatakan apakah itu terkelola saja; kunci terkelola saja yang tersisa di sana termasuk URL login gateway, versi, browser, mobile-simulator, host SSH, Desktop sesi lokal, jalur biner sandbox, harga model, pembatasan model, dan kontrol CLAUDE.md.446Tabel mencakup kontrol izin, plugin, dan pengiriman. Untuk kunci apa pun yang tidak tercantum di sini, kolom Scope dari indeks [referensi pengaturan](/docs/id/settings-reference#all-settings) mengatakan apakah itu terkelola saja.

441 447 

442| Pengaturan | Deskripsi |448| Pengaturan | Deskripsi |

443| :- | :- |449| :- | :- |


449| [`blockedMarketplaces`](/docs/id/settings-reference#blockedmarketplaces) | Daftar blokir sumber marketplace. Sumber yang diblokir diperiksa sebelum mengunduh, jadi mereka tidak pernah menyentuh filesystem. Lihat [pembatasan marketplace terkelola](/docs/id/plugins/org#restrict-what-users-can-install) |455| [`blockedMarketplaces`](/docs/id/settings-reference#blockedmarketplaces) | Daftar blokir sumber marketplace. Sumber yang diblokir diperiksa sebelum mengunduh, jadi mereka tidak pernah menyentuh filesystem. Lihat [pembatasan marketplace terkelola](/docs/id/plugins/org#restrict-what-users-can-install) |

450| [`channelsEnabled`](/docs/id/settings-reference#channelsenabled) | Izinkan [channels](/docs/id/channels) untuk organisasi. Lihat [kontrol enterprise](/docs/id/channels#enterprise-controls) untuk default di setiap paket |456| [`channelsEnabled`](/docs/id/settings-reference#channelsenabled) | Izinkan [channels](/docs/id/channels) untuk organisasi. Lihat [kontrol enterprise](/docs/id/channels#enterprise-controls) untuk default di setiap paket |

451| [`disableCommandPluginSources`](/docs/id/settings-reference#disablecommandpluginsources) | Ketika `true`, memblokir [sumber plugin `command`](/docs/id/plugins/marketplace-reference#command-plugin-source) sepenuhnya, jadi perintah yang dideklarasikan marketplace tidak pernah berjalan. Juga memblokir perintah [`headersHelper`](/docs/id/plugins/host-marketplace#authenticate-archive-downloads) marketplace, kecuali untuk marketplace yang pengaturan terkelola sendiri deklarasikan. Ketika tidak diatur, mengikuti `allowManagedHooksOnly`. Memerlukan Claude Code v2.1.229 atau lebih baru, dan blok `headersHelper` memerlukan v2.1.238 atau lebih baru |457| [`disableCommandPluginSources`](/docs/id/settings-reference#disablecommandpluginsources) | Ketika `true`, memblokir [sumber plugin `command`](/docs/id/plugins/marketplace-reference#command-plugin-source) sepenuhnya, jadi perintah yang dideklarasikan marketplace tidak pernah berjalan. Juga memblokir perintah [`headersHelper`](/docs/id/plugins/host-marketplace#authenticate-archive-downloads) marketplace, kecuali untuk marketplace yang pengaturan terkelola sendiri deklarasikan. Ketika tidak diatur, mengikuti `allowManagedHooksOnly`. Memerlukan Claude Code v2.1.229 atau lebih baru, dan blok `headersHelper` memerlukan v2.1.238 atau lebih baru |

452| [`disableSideloadFlags`](/docs/id/settings-reference#disablesideloadflags) | Tolak flag `--plugin-dir`, `--plugin-url`, `--agents`, dan `--mcp-config` saat startup. Dalam sesi cloud, Claude Code menghapus server MCP yang server kirimkan melalui `--mcp-config`, selain entri `type: "sdk"` dalam proses, dan memulai sesi. Memerlukan Claude Code v2.1.193 atau lebih baru |458| [`disableSideloadFlags`](/docs/id/settings-reference#disablesideloadflags) | Tolak flag `--plugin-dir`, `--plugin-url`, `--agents`, dan `--mcp-config` saat startup. Dalam sesi cloud, Claude Code malah memulai sesi dan menghapus server yang dikirimkan server `--mcp-config`, selain dari pengecualian yang [entri referensinya](/docs/id/settings-reference#disablesideloadflags) cantumkan. Memerlukan Claude Code v2.1.193 atau lebih baru |

453| [`forceRemoteSettingsRefresh`](/docs/id/settings-reference#forceremotesettingsrefresh) | Ketika `true`, memblokir startup CLI sampai pengaturan terkelola jarak jauh diambil segar dan keluar jika pengambilan gagal. Lihat [penegakan fail-closed](/docs/id/server-managed-settings#enforce-fail-closed-startup) |459| [`forceRemoteSettingsRefresh`](/docs/id/settings-reference#forceremotesettingsrefresh) | Ketika `true`, memblokir startup CLI sampai pengaturan terkelola jarak jauh diambil segar dan keluar jika pengambilan gagal. Lihat [penegakan fail-closed](/docs/id/server-managed-settings#enforce-fail-closed-startup) |

454| [`managedMcpServers`](/docs/id/settings-reference#managedmcpservers) | Server MCP jarak jauh yang disediakan untuk setiap pengguna bersama milik mereka sendiri. Ini menyediakan server daripada mengunci apa pun. Lihat [Sediakan server melalui pengaturan terkelola](/docs/id/managed-mcp#provide-servers-through-managed-settings). Memerlukan Claude Code v2.1.259 atau lebih baru |460| [`managedMcpServers`](/docs/id/settings-reference#managedmcpservers) | Server MCP jarak jauh yang disediakan untuk setiap pengguna bersama milik mereka sendiri. Ini menyediakan server daripada mengunci apa pun. Lihat [Sediakan server melalui pengaturan terkelola](/docs/id/managed-mcp#provide-servers-through-managed-settings). Memerlukan Claude Code v2.1.259 atau lebih baru |

455| [`managedSourcesBehavior`](/docs/id/settings-reference#managedsourcesbehavior) | Apakah Claude Code menerapkan hanya sumber terkelola prioritas tertinggi atau [menyusun setiap satu](#compose-every-managed-source) |461| [`managedSourcesBehavior`](/docs/id/settings-reference#managedsourcesbehavior) | Apakah Claude Code menerapkan hanya sumber terkelola prioritas tertinggi atau [menyusun setiap satu](#compose-every-managed-source) |

mcp.md +5 −5

Details

273 273 

274* ``⏸ Pending approval (run `claude` to approve)``: server yang dibatasi proyek dari `.mcp.json` yang belum Anda setujui. Claude Code menunjukkannya di `claude mcp list` dan `claude mcp get <name>`. Jalankan `claude` secara interaktif untuk meninjau dan menyetujuinya.274* ``⏸ Pending approval (run `claude` to approve)``: server yang dibatasi proyek dari `.mcp.json` yang belum Anda setujui. Claude Code menunjukkannya di `claude mcp list` dan `claude mcp get <name>`. Jalankan `claude` secara interaktif untuk meninjau dan menyetujuinya.

275* `✘ Rejected (see disabledMcpjsonServers in settings)`: server `.mcp.json` yang entri [`disabledMcpjsonServers`](/docs/id/settings-reference#disabledmcpjsonservers) tolak. Claude Code menunjukkannya hanya di `claude mcp get <name>`.275* `✘ Rejected (see disabledMcpjsonServers in settings)`: server `.mcp.json` yang entri [`disabledMcpjsonServers`](/docs/id/settings-reference#disabledmcpjsonservers) tolak. Claude Code menunjukkannya hanya di `claude mcp get <name>`.

276* `⊘ Disabled for this project (re-enable via /mcp)`: server yang daftar [`disabledMcpServers`](#disable-a-server-without-removing-it) proyek namakan. Claude Code menunjukkannya di `claude mcp list` dan `claude mcp get <name>`. Hidupkan server kembali dari panel `/mcp`. Sebelum v2.1.238, kedua perintah terhubung ke server yang dinonaktifkan untuk memeriksa kesehatannya dan melaporkan hasil koneksi.276* `⊘ Disabled for this project (re-enable via /mcp)`: server yang daftar [`disabledMcpServers`](#disable-a-server-without-removing-it) proyek namakan. Claude Code menunjukkannya di `claude mcp list` dan `claude mcp get <name>`. Hidupkan server kembali dari panel `/mcp`.

277 277 

278Server WebSocket tidak muncul dalam output `claude mcp list`. Gunakan `claude mcp get <name>` atau panel `/mcp` untuk memeriksanya.278Server WebSocket tidak muncul dalam output `claude mcp list`. Gunakan `claude mcp get <name>` atau panel `/mcp` untuk memeriksanya.

279 279 


321 321 

322* **Whitespace tersembunyi**: Claude Code memperingatkan ketika nilai konfigurasi MCP membawa whitespace terkemuka atau tertinggal yang tersembunyi, yang sering berasal dari menempel token dengan newline tertinggal. Claude Code memeriksa `command`, `url`, setiap entri `args`, dan nilai dan nama kunci di bawah `env` dan `headers`. Claude Code menunjukkan peringatan dalam output `claude mcp list` dan di `/mcp`, menamai bidang yang terpengaruh tanpa menggema nilainya, misalnya `Leading or trailing whitespace in: headers.Authorization`. Claude Code tidak memangkas whitespace dan menggunakan nilai persis seperti yang ditulis, jadi edit konfigurasi untuk menghapusnya.322* **Whitespace tersembunyi**: Claude Code memperingatkan ketika nilai konfigurasi MCP membawa whitespace terkemuka atau tertinggal yang tersembunyi, yang sering berasal dari menempel token dengan newline tertinggal. Claude Code memeriksa `command`, `url`, setiap entri `args`, dan nilai dan nama kunci di bawah `env` dan `headers`. Claude Code menunjukkan peringatan dalam output `claude mcp list` dan di `/mcp`, menamai bidang yang terpengaruh tanpa menggema nilainya, misalnya `Leading or trailing whitespace in: headers.Authorization`. Claude Code tidak memangkas whitespace dan menggunakan nilai persis seperti yang ditulis, jadi edit konfigurasi untuk menghapusnya.

323* **Nama yang sama di lebih dari satu cakupan**: jika Anda menentukan nama server yang sama di lebih dari satu [scope](#mcp-installation-scopes) dengan endpoint yang berbeda, Claude Code memperingatkan tentang konflik dalam output `claude mcp list` dan di `/mcp`. Claude Code menyimpan login OAuth per endpoint, jadi ketika Anda mengautentikasi definisi yang dimuat dalam satu proyek, Anda masih perlu masuk secara terpisah di proyek tempat definisi berbeda dimuat. Simpan endpoint yang Anda inginkan dan hapus yang lain dengan `claude mcp remove <name> --scope <scope>`. Dalam peringatan, Claude Code mengutip endpoint setiap cakupan seperti yang ditulis dalam konfigurasi Anda, dengan referensi [`${VAR}`](#environment-variable-expansion-in-mcp-json) yang tidak diperluas, jadi tidak pernah menunjukkan nilai yang diselesaikan seperti kunci API.323* **Nama yang sama di lebih dari satu cakupan**: jika Anda menentukan nama server yang sama di lebih dari satu [scope](#mcp-installation-scopes) dengan endpoint yang berbeda, Claude Code memperingatkan tentang konflik dalam output `claude mcp list` dan di `/mcp`. Claude Code menyimpan login OAuth per endpoint, jadi ketika Anda mengautentikasi definisi yang dimuat dalam satu proyek, Anda masih perlu masuk secara terpisah di proyek tempat definisi berbeda dimuat. Simpan endpoint yang Anda inginkan dan hapus yang lain dengan `claude mcp remove <name> --scope <scope>`. Dalam peringatan, Claude Code mengutip endpoint setiap cakupan seperti yang ditulis dalam konfigurasi Anda, dengan referensi [`${VAR}`](#environment-variable-expansion-in-mcp-json) yang tidak diperluas, jadi tidak pernah menunjukkan nilai yang diselesaikan seperti kunci API.

324* **Nama yang dicadangkan**: Claude Code mencadangkan nama server bawaan-nya, termasuk `workspace`, `claude-in-chrome`, `computer-use`, `Claude Preview`, dan `Claude Browser`. Jika konfigurasi Anda menentukan server dengan nama yang dicadangkan, Claude Code melewatinya saat waktu muat dan menunjukkan peringatan meminta Anda untuk mengganti namanya. `claude mcp add` menolak nama yang dicadangkan dengan kesalahan. `Claude Preview` dan `Claude Browser` keduanya menamai server bawaan yang digunakan [panel pratinjau aplikasi desktop Claude Code](/docs/id/desktop#preview-your-app). Sebelum v2.1.205, `Claude Browser` tidak dicadangkan, jadi server yang dikonfigurasi pengguna dapat mendaftar di bawah nama itu.324* **Nama yang dicadangkan**: Claude Code mencadangkan nama server bawaan-nya, termasuk `workspace`, `claude-in-chrome`, `computer-use`, `Claude Preview`, dan `Claude Browser`. Jika konfigurasi Anda menentukan server dengan nama yang dicadangkan, Claude Code melewatinya saat waktu muat dan menunjukkan peringatan meminta Anda untuk mengganti namanya. `claude mcp add` menolak nama yang dicadangkan dengan kesalahan. `Claude Preview` dan `Claude Browser` keduanya menamai server bawaan yang digunakan [panel pratinjau aplikasi desktop Claude Code](/docs/id/desktop#preview-your-app).

325* **Variabel lingkungan yang hilang**: jika referensi [`${VAR}`](#environment-variable-expansion-in-mcp-json) dalam konfigurasi server menamai variabel yang tidak diatur dan tidak memiliki `:-default`, Claude Code memperingatkan dalam output `claude mcp list` dan di `/mcp`, menamai variabel, dan masih memuat server dengan teks `${VAR}` yang tidak diperluas. Atur variabel atau tambahkan fallback `${VAR:-default}`. Di `url` dan `headers` server jarak jauh, beberapa variabel kredensial [dibaca sebagai kosong](#credential-variables-that-read-as-empty) sebagai gantinya, tanpa peringatan.325* **Variabel lingkungan yang hilang**: jika referensi [`${VAR}`](#environment-variable-expansion-in-mcp-json) dalam konfigurasi server menamai variabel yang tidak diatur dan tidak memiliki `:-default`, Claude Code memperingatkan dalam output `claude mcp list` dan di `/mcp`, menamai variabel, dan masih memuat server dengan teks `${VAR}` yang tidak diperluas. Atur variabel atau tambahkan fallback `${VAR:-default}`. Di `url` dan `headers` server jarak jauh, beberapa variabel kredensial [dibaca sebagai kosong](#credential-variables-that-read-as-empty) sebagai gantinya, tanpa peringatan.

326 326 

327<h4 id="tool-availability">327<h4 id="tool-availability">


417 Koneksi pertama yang gagal417 Koneksi pertama yang gagal

418</h4>418</h4>

419 419 

420Ketika koneksi pertama server HTTP atau SSE gagal dengan kesalahan sementara, seperti respons 5xx, koneksi ditolak, atau timeout, Claude Code mencoba ulang hingga tiga kali. Jika koneksi masih gagal, Claude Code menandai server sebagai gagal. Claude Code mencoba ulang dengan cara ini saat startup dan ketika server ditambahkan di tengah sesi. Itu termasuk server yang Claude Code tambahkan ke [sesi cloud](/docs/id/claude-code-on-the-web) dari konfigurasinya dan server yang Anda tambahkan dengan [`setMcpServers()`](/docs/id/agent-sdk/typescript) Agent SDK.420Ketika koneksi pertama server HTTP atau SSE gagal dengan kesalahan sementara, seperti respons 5xx, koneksi ditolak, atau timeout, Claude Code mencoba ulang hingga tiga kali. Jika koneksi masih gagal, Claude Code menandai server sebagai gagal.

421 421 

422Claude Code tidak mencoba ulang dalam kasus ini:422Claude Code tidak mencoba ulang dalam kasus ini:

423 423 


553 553 

554Server plugin muncul di `/mcp` dengan indikator menunjukkan mereka berasal dari plugin.554Server plugin muncul di `/mcp` dengan indikator menunjukkan mereka berasal dari plugin.

555 555 

556Untuk server stdio plugin, `claude mcp get` mencetak `Command: stdio`, baris `Args:` kosong, dan setiap variabel lingkungan sebagai `NAME=[REDACTED]`. Nilai disembunyikan karena dapat membawa kredensial.

557 

556**Nama alat MCP plugin**:558**Nama alat MCP plugin**:

557 559 

558Alat dari server MCP yang digabungkan plugin menyertakan nama plugin dan kunci server dalam nama yang dapat dipanggil mereka. Bentuk lengkapnya adalah `mcp__plugin_<plugin-name>_<server-name>__<tool-name>`, di mana karakter apa pun di luar `A-Z`, `a-z`, `0-9`, `_`, dan `-` diganti dengan `_`. Untuk server `database-tools` yang digabungkan dalam plugin bernama `my-plugin`, alat `query` dapat dipanggil sebagai:560Alat dari server MCP yang digabungkan plugin menyertakan nama plugin dan kunci server dalam nama yang dapat dipanggil mereka. Bentuk lengkapnya adalah `mcp__plugin_<plugin-name>_<server-name>__<tool-name>`, di mana karakter apa pun di luar `A-Z`, `a-z`, `0-9`, `_`, dan `-` diganti dengan `_`. Untuk server `database-tools` yang digabungkan dalam plugin bernama `my-plugin`, alat `query` dapat dipanggil sebagai:


1458* Nama properti tingkat atas harus panjangnya 1 hingga 64 karakter dan hanya menggunakan huruf ASCII dan angka, `_`, `.`, dan `-`1460* Nama properti tingkat atas harus panjangnya 1 hingga 64 karakter dan hanya menggunakan huruf ASCII dan angka, `_`, `.`, dan `-`

1459* Skema harus valid terhadap meta-skema JSON Schema draft 2020-12. Claude Code menerapkan pemeriksaan ini pada skema yang tidak mendeklarasikan `$schema` dan skema yang mendeklarasikan draft 2020-12. Skema yang mendeklarasikan dialek lain melewati pemeriksaan ini, meskipun pemeriksaan nama properti di atas tetap berlaku1461* Skema harus valid terhadap meta-skema JSON Schema draft 2020-12. Claude Code menerapkan pemeriksaan ini pada skema yang tidak mendeklarasikan `$schema` dan skema yang mendeklarasikan draft 2020-12. Skema yang mendeklarasikan dialek lain melewati pemeriksaan ini, meskipun pemeriksaan nama properti di atas tetap berlaku

1460 1462 

1461Claude Code menjalankan pemeriksaan setelah [penulisan ulang combinator tingkat root](#tool-input-schemas-with-a-root-level-combinator), pada skema yang sebenarnya akan dikirimkan.

1462 

1463Ketika Claude Code mengecualikan tool, tool tersebut mencatat alasannya dalam log server dan memberi tahu Claude tools mana yang dikecualikan dan mengapa, sehingga Anda dapat menanyakan kepada Claude mengapa tool hilang. Jika Anda memperbaiki skema di server, tool akan kembali lagi saat Claude Code memuat tools server berikutnya.1463Ketika Claude Code mengecualikan tool, tool tersebut mencatat alasannya dalam log server dan memberi tahu Claude tools mana yang dikecualikan dan mengapa, sehingga Anda dapat menanyakan kepada Claude mengapa tool hilang. Jika Anda memperbaiki skema di server, tool akan kembali lagi saat Claude Code memuat tools server berikutnya.

1464 1464 

1465Claude Code mengaktifkan pengecualian melalui bendera fitur yang diambilnya dari Anthropic. Pada [deployment tempat pengambilan bendera dimatikan](/docs/id/env-vars#features-that-need-feature-flag-fetching), atau pada mesin yang bendanya tidak pernah tiba, seperti mesin yang terisolasi udara, Claude Code tetap menjalankan pemeriksaan dan mencatat dalam log server tool mana yang akan ditolak, tetapi tetap mengirimkan skema tool ke API. API menolak permintaan yang menyertakan skema tersebut dengan [kesalahan 400 yang menamai tool berdasarkan posisinya](/docs/id/errors#tool-input-schema-is-invalid). Sebelum v2.1.216, tidak ada deployment yang menjalankan pemeriksaan ini.1465Claude Code mengaktifkan pengecualian melalui bendera fitur yang diambilnya dari Anthropic. Pada [deployment tempat pengambilan bendera dimatikan](/docs/id/env-vars#features-that-need-feature-flag-fetching), atau pada mesin yang bendanya tidak pernah tiba, seperti mesin yang terisolasi udara, Claude Code tetap menjalankan pemeriksaan dan mencatat dalam log server tool mana yang akan ditolak, tetapi tetap mengirimkan skema tool ke API. API menolak permintaan yang menyertakan skema tersebut dengan [kesalahan 400 yang menamai tool berdasarkan posisinya](/docs/id/errors#tool-input-schema-is-invalid). Sebelum v2.1.216, tidak ada deployment yang menjalankan pemeriksaan ini.

Details

360 360 

361 Apa yang terjadi selanjutnya memberi tahu Anda di mana masalahnya:361 Apa yang terjadi selanjutnya memberi tahu Anda di mana masalahnya:

362 362 

363 * Perintah dimulai dan menunggu input: server itu sendiri berfungsi. Jalankan `claude mcp get <name>` dan konfirmasi perintah yang ditampilkan di sana cocok dengan apa yang baru saja Anda jalankan. Jika perintah yang ditampilkan berbeda dari apa yang Anda ketik, Anda mungkin menghilangkan pemisah `--` sebelum perintah server. Hapus server dan tambahkan kembali dengan `--` di tempat. Jika Anda menulis `.mcp.json` dengan tangan, periksa sintaks dan lokasinya.363 * Perintah dimulai dan menunggu input: server itu sendiri berfungsi.

364 

365 Jalankan `claude mcp get <name>` dan konfirmasi perintah yang ditampilkan di sana cocok dengan apa yang baru saja Anda jalankan. Jika perintah yang ditampilkan berbeda dari apa yang Anda ketik, Anda mungkin menghilangkan pemisah `--` sebelum perintah server. Hapus server dan tambahkan kembali dengan `--` di tempat. Jika Anda menulis `.mcp.json` dengan tangan, periksa sintaks dan lokasinya. Sebelum v2.1.285, `claude mcp get` tidak mencetak baris `Command` untuk entri stdio yang disimpan tanpa bidang `type`, seperti entri `.mcp.json` yang ditulis dengan tangan. Pada versi tersebut, jalankan `claude mcp list` sebagai gantinya, yang mencetak baris perintah baik cara.

364 * Perintah kesalahan: pesan menyebutkan apa yang hilang, seperti Node.js atau browser.366 * Perintah kesalahan: pesan menyebutkan apa yang hilang, seperti Node.js atau browser.

365 </Accordion>367 </Accordion>

366 368 

model-config.md +62 −55

Details

39| **`sonnet`** | Menggunakan model Sonnet terbaru untuk tugas-tugas pengkodean sehari-hari |39| **`sonnet`** | Menggunakan model Sonnet terbaru untuk tugas-tugas pengkodean sehari-hari |

40| **`opus`** | Menggunakan model Opus terbaru untuk tugas-tugas penalaran kompleks |40| **`opus`** | Menggunakan model Opus terbaru untuk tugas-tugas penalaran kompleks |

41| **`haiku`** | Menggunakan model Haiku yang cepat dan efisien untuk tugas-tugas sederhana |41| **`haiku`** | Menggunakan model Haiku yang cepat dan efisien untuk tugas-tugas sederhana |

42| **`sonnet[1m]`** | Menggunakan Sonnet dengan [jendela konteks 1 juta token](https://platform.claude.com/docs/en/build-with-claude/context-windows#context-window-sizes-by-model) untuk sesi panjang. Tidak berpengaruh ketika `sonnet` sudah menyelesaikan ke Sonnet 5.5 atau Sonnet 5 dengan jendela 1M aslinya; di balik [gateway LLM](/docs/id/llm-gateway), memilih jendela 1M untuk model itu |42| **`sonnet[1m]`** | Menggunakan Sonnet dengan [jendela konteks 1 juta token](https://platform.claude.com/docs/en/build-with-claude/context-windows#context-window-sizes-by-model) untuk sesi panjang. Tidak berpengaruh ketika `sonnet` sudah menyelesaikan ke Sonnet 5.5 atau Sonnet 5 dengan jendela 1M aslinya |

43| **`opus[1m]`** | Menggunakan Opus dengan [jendela konteks 1 juta token](https://platform.claude.com/docs/en/build-with-claude/context-windows#context-window-sizes-by-model) untuk sesi panjang |43| **`opus[1m]`** | Menggunakan Opus dengan [jendela konteks 1 juta token](https://platform.claude.com/docs/en/build-with-claude/context-windows#context-window-sizes-by-model) untuk sesi panjang |

44| **`opusplan`** | Mode khusus yang menggunakan `opus` selama plan mode, kemudian beralih ke `sonnet` untuk eksekusi |44| **`opusplan`** | Mode khusus yang menggunakan `opus` selama plan mode, kemudian beralih ke `sonnet` untuk eksekusi |

45 45 


104 104 

105Dalam sesi interaktif, Claude Code menampilkan prompt persetujuan sebelum permintaan Fable menagih kredit penggunaan. Anggota paket Enterprise dengan penagihan organisasi tidak melihat prompt. Anda dapat melanjutkan di Fable menggunakan kredit penggunaan atau beralih ke model default Anda. Anda juga dapat menutup prompt:105Dalam sesi interaktif, Claude Code menampilkan prompt persetujuan sebelum permintaan Fable menagih kredit penggunaan. Anggota paket Enterprise dengan penagihan organisasi tidak melihat prompt. Anda dapat melanjutkan di Fable menggunakan kredit penggunaan atau beralih ke model default Anda. Anda juga dapat menutup prompt:

106 106 

107* Di pemilih `/model`, Anda menyimpan model saat ini.107* Ketika Anda memilih model Fable dengan `/model`, Anda menyimpan model saat ini.

108* Pertengahan sesi, Claude Code melanjutkan giliran di model default Anda.108* Pertengahan sesi, Claude Code melanjutkan giliran di model default Anda.

109 109 

110Setelah Anda memilih untuk melanjutkan di Fable menggunakan kredit penggunaan, Claude Code tidak menampilkan prompt lagi.110Setelah Anda memilih untuk melanjutkan di Fable menggunakan kredit penggunaan, Claude Code tidak menampilkan prompt lagi.


117* Dalam sesi latar belakang, jawab sebelum batas waktu.117* Dalam sesi latar belakang, jawab sebelum batas waktu.

118* Jika Anda mengirim pesan baru dari klien jarak jauh sebelum ada yang mengetik di terminal, Claude Code mengakhiri giliran dengan cara yang sama, dan pesan baru Anda memulai giliran berikutnya. Setelah seseorang mengetik di terminal, Claude Code terus menunggu jawaban dan mengantrekan pesan baru Anda di belakangnya.118* Jika Anda mengirim pesan baru dari klien jarak jauh sebelum ada yang mengetik di terminal, Claude Code mengakhiri giliran dengan cara yang sama, dan pesan baru Anda memulai giliran berikutnya. Setelah seseorang mengetik di terminal, Claude Code terus menunggu jawaban dan mengantrekan pesan baru Anda di belakangnya.

119 119 

120Dalam [mode non-interaktif](/docs/id/headless) dengan flag `-p` dan melalui Agent SDK, Claude Code tidak pernah menampilkan prompt persetujuan. Ketika permintaan Fable di sana akan ditagih ke kredit penggunaan, Claude Code menagihnya tanpa bertanya.120Dalam sesi aplikasi lain yang dihosting melalui [Agent SDK](/docs/id/agent-sdk/overview), apakah prompt muncul tergantung pada aplikasi itu. Jika muncul dan tidak ada yang menjawab sebelum batas waktu [`dialogExpiry`](/docs/id/settings-reference#dialogexpiry) yang sama, Claude Code mengakhiri giliran tanpa mengirim permintaan.

121 

122Dalam [mode non-interaktif](/docs/id/headless) dengan flag `-p`, dan dalam aplikasi Agent SDK yang tidak menampilkan prompt, Claude Code tidak pernah meminta persetujuan. Ketika permintaan Fable di sana akan ditagih ke kredit penggunaan, Claude Code menagihnya tanpa bertanya.

121 123 

122<h3 id="setting-your-model">124<h3 id="setting-your-model">

123 Mengatur model Anda125 Mengatur model Anda


239 Batasi pemilihan model241 Batasi pemilihan model

240</h2>242</h2>

241 243 

242Administrator dapat menggunakan `availableModels` dalam [pengaturan terkelola atau kebijakan](/docs/id/managed-settings) untuk membatasi model mana yang dapat dipilih pengguna. Entri cocok dengan keluarga model seperti `sonnet`, awalan versi seperti `claude-sonnet-4-5`, atau ID model lengkap seperti `claude-sonnet-4-5-20250929`. Awalan versi juga cocok dengan ID model yang lebih baru yang memperpanjangnya dengan segmen lain, jadi `claude-fable-5` memungkinkan Fable 5 dan Fable 5.1, sementara `claude-fable-5-1` memungkinkan Fable 5.1 saja. Untuk memblokir model yang diizinkan daftar, atau untuk membuat setiap entri ID model hanya memungkinkan versi yang dinamainya, lihat [Blokir model atau versi spesifik](#block-specific-models-or-versions).244Administrator dapat menggunakan `availableModels` dalam [pengaturan terkelola atau kebijakan](/docs/id/managed-settings) untuk membatasi model mana yang dapat dipilih pengguna. Entri cocok dengan keluarga model seperti `sonnet`, awalan versi seperti `claude-sonnet-4-5`, atau ID model lengkap seperti `claude-sonnet-4-5-20250929`. Awalan versi juga cocok dengan ID model yang lebih baru yang memperpanjangnya dengan segmen lain, jadi `claude-fable-5` memungkinkan Fable 5 dan Fable 5.1, sementara `claude-fable-5-1` memungkinkan Fable 5.1 saja. Untuk memblokir model yang diizinkan daftar, atau untuk membuat setiap entri ID model hanya memungkinkan versi yang dinamainya, lihat [Blokir model atau versi tertentu](#block-specific-models-or-versions).

243 245 

244Pada platform yang menyematkan Claude Code dan menetapkan [`CLAUDE_CODE_PROVIDER_MANAGED_BY_HOST`](/docs/id/env-vars), konfigurasi model host mengambil alih pengaturan model terkelola, sementara daftar izin `availableModels` terkelola tetap berlaku kecuali host menyediakan miliknya sendiri; [Pengecualian terhadap prioritas pengaturan terkelola](/docs/id/settings#exceptions-to-managed-settings-precedence) mengatakan kunci dan variabel mana yang ditimpa host.246Pada platform yang menyematkan Claude Code dan menetapkan [`CLAUDE_CODE_PROVIDER_MANAGED_BY_HOST`](/docs/id/env-vars), konfigurasi model host mengambil alih pengaturan model terkelola, sementara daftar putih `availableModels` terkelola tetap berlaku kecuali host menyediakan miliknya sendiri; [Pengecualian untuk prioritas pengaturan terkelola](/docs/id/settings#exceptions-to-managed-settings-precedence) mengatakan kunci dan variabel mana yang ditimpa host.

245 247 

246Ketika `availableModels` diatur, daftar izin berlaku di mana pun pengguna dapat menentukan model:248Ketika `availableModels` diatur, daftar putih berlaku di mana pun pengguna dapat menentukan model:

247 249 

248* **Model sesi utama**: `/model`, bendera `--model`, variabel lingkungan `ANTHROPIC_MODEL`, pengaturan `model`, [`ANTHROPIC_DEFAULT_MODEL`](#set-a-default-model-for-new-sessions), dan model yang dipulihkan saat [melanjutkan sesi](#setting-your-model)250* **Model sesi utama**: `/model`, bendera `--model`, variabel lingkungan `ANTHROPIC_MODEL`, pengaturan `model`, [`ANTHROPIC_DEFAULT_MODEL`](#set-a-default-model-for-new-sessions), dan model yang dipulihkan saat [melanjutkan sesi](#setting-your-model)

249* **Resolusi alias**: variabel lingkungan `ANTHROPIC_DEFAULT_OPUS_MODEL`, `ANTHROPIC_DEFAULT_SONNET_MODEL`, `ANTHROPIC_DEFAULT_HAIKU_MODEL`, dan `ANTHROPIC_DEFAULT_FABLE_MODEL` tidak dapat mengarahkan ulang alias yang diizinkan ke model di luar daftar251* **Resolusi alias**: variabel lingkungan `ANTHROPIC_DEFAULT_OPUS_MODEL`, `ANTHROPIC_DEFAULT_SONNET_MODEL`, `ANTHROPIC_DEFAULT_HAIKU_MODEL`, dan `ANTHROPIC_DEFAULT_FABLE_MODEL` tidak dapat mengarahkan ulang alias yang diizinkan ke model di luar daftar


253* **Model advisor**: pengaturan [`advisorModel`](/docs/id/advisor) yang dikonfigurasi dan bendera `--advisor`255* **Model advisor**: pengaturan [`advisorModel`](/docs/id/advisor) yang dikonfigurasi dan bendera `--advisor`

254* **Model agent latar belakang**: model yang dipilih dalam [pemilih dispatch](/docs/id/agent-view)256* **Model agent latar belakang**: model yang dipilih dalam [pemilih dispatch](/docs/id/agent-view)

255 257 

256Pada Anthropic API dan [Claude Platform on AWS](/docs/id/claude-platform-on-aws), alias keluarga model, `opus`, `sonnet`, `haiku`, atau `fable`, diselesaikan ke model biasanya ketika daftar izin memungkinkan model itu. Ketika daftar izin memblokir model itu, Claude Code mengganti versi terbaru keluarga yang diizinkan daftar izin dan menampilkan pemberitahuan yang menyebutkan model yang diminta dan diganti. Dengan `["sonnet", "claude-opus-4-6"]`, misalnya, baik `/model opus` maupun `--model opus` memilih Claude Opus 4.6, Opus terbaru yang diizinkan. Sebelum v2.1.205, alias yang versi rilis terbarunya berada di luar daftar ditolak atau diganti seperti pemilihan terblokir lainnya, bahkan ketika daftar memungkinkan versi yang lebih lama.258Pada API Anthropic dan [Claude Platform on AWS](/docs/id/claude-platform-on-aws), alias keluarga model, `opus`, `sonnet`, `haiku`, atau `fable`, diselesaikan ke model biasanya ketika daftar putih memungkinkan model itu. Ketika daftar putih memblokir model itu, Claude Code mengganti versi terbaru keluarga yang diizinkan daftar putih dan menampilkan pemberitahuan yang menyebutkan model yang diminta dan diganti. Dengan `["sonnet", "claude-opus-4-6"]`, misalnya, baik `/model opus` maupun `--model opus` memilih Claude Opus 4.6, Opus terbaru yang diizinkan. Sebelum v2.1.205, alias yang versi rilis terbarunya berada di luar daftar ditolak atau diganti seperti pemilihan terblokir lainnya, bahkan ketika daftar memungkinkan versi yang lebih lama.

257 259 

258Substitusi memerlukan versi yang diizinkan untuk mendarat: ketika daftar izin tidak memungkinkan versi apa pun dari keluarga alias, alias mengikuti perilaku penolakan dan penggantian di bawah seperti nilai terblokir lainnya.260Substitusi membutuhkan versi yang diizinkan untuk mendarat: ketika daftar putih tidak memungkinkan versi keluarga alias, alias mengikuti perilaku penolakan dan penggantian di bawah seperti nilai terblokir lainnya.

259 261 

260Claude Code menangani pemilihan terblokir lainnya sesuai dengan tempat model diatur:262Claude Code menangani pemilihan terblokir lainnya sesuai dengan tempat model diatur:

261 263 


266 268 

267 Dalam sesi interaktif, Claude Code memperingatkan Anda ketika mengganti model subagent, oleh fallback ini atau oleh substitusi versi-terbaru-yang-diizinkan di atas, menyebutkan model yang diminta dan diganti; itu tidak melaporkan fallback rekan kerja.269 Dalam sesi interaktif, Claude Code memperingatkan Anda ketika mengganti model subagent, oleh fallback ini atau oleh substitusi versi-terbaru-yang-diizinkan di atas, menyebutkan model yang diminta dan diganti; itu tidak melaporkan fallback rekan kerja.

268 270 

269 Di mana substitusi versi-terbaru-yang-diizinkan di atas beroperasi, alias keluarga terblokir mengikutinya. Sebelum v2.1.222, alias jatuh kembali seperti nilai terblokir lainnya pada setiap penyedia271 Di mana substitusi versi-terbaru-yang-diizinkan di atas beroperasi, alias keluarga terblokir mengikutinya sebagai gantinya. Sebelum v2.1.222, alias jatuh kembali seperti nilai terblokir lainnya di setiap penyedia

270* **Penggantian skill atau perintah**: Claude Code mengabaikan penggantian, termasuk alias keluarga terblokir, dan skill atau perintah berjalan pada model sesi. Skill atau perintah yang [berjalan dalam subagent](/docs/id/skills#run-skills-in-a-subagent) mengikuti perilaku subagent di atas272* **Penggantian skill atau perintah**: Claude Code mengabaikan penggantian, termasuk alias keluarga terblokir, dan skill atau perintah berjalan pada model sesi. Skill atau perintah yang [berjalan dalam subagent](/docs/id/skills#run-skills-in-a-subagent) mengikuti perilaku subagent di atas sebagai gantinya

271* **Pengaturan `advisorModel`**: advisor dinonaktifkan untuk sesi273* **Pengaturan `advisorModel`**: advisor dinonaktifkan untuk sesi

272* **Bendera `--advisor`**: Claude Code keluar dengan kesalahan saat peluncuran. Dalam [sesi latar belakang](/docs/id/agent-view), itu memulai sesi tanpa advisor daripada keluar274* **Bendera `--advisor`**: Claude Code keluar dengan kesalahan saat peluncuran. Dalam [sesi latar belakang](/docs/id/agent-view), itu memulai sesi tanpa advisor sebagai gantinya dari keluar

273 275 

274Claude Code menyembunyikan model yang dikecualikan dari pemilih `/model`. ID model lengkap dalam daftar yang tidak memiliki baris pemilih bawaan, seperti versi yang lebih lama yang disematkan daftar, muncul dalam pemilih `/model` sebagai baris berlabel miliknya sendiri, kecuali Claude Code mengganti opsi bawaan dengan lineup [`modelPicker`](/docs/id/settings-reference#modelpicker). Sebelum v2.1.199, ID tersebut hanya dapat dipilih dengan mengetik `/model <id>`.276Claude Code menyembunyikan model yang dikecualikan dari pemilih `/model`. ID model lengkap dalam daftar yang tidak memiliki baris pemilih bawaan, seperti versi yang lebih lama yang disematkan daftar, muncul dalam pemilih `/model` sebagai baris berlabel sendiri, kecuali Claude Code mengganti opsi bawaan dengan lineup [`modelPicker`](/docs/id/settings-reference#modelpicker). Sebelum v2.1.199, ID seperti itu hanya dapat dipilih dengan mengetik `/model <id>`.

275 277 

276Perubahan model yang dilakukan Claude Code atas nama Anda diperiksa dengan cara yang sama:278Perubahan model yang dilakukan Claude Code atas nama Anda diperiksa dengan cara yang sama:

277 279 

278* **[Rantai model fallback](#fallback-model-chains)**: entri di luar daftar izin dijatuhkan280* **[Rantai model fallback](#fallback-model-chains)**: entri di luar daftar putih dijatuhkan

279* **Upgrade mode plan**: pada Anthropic API dan Claude Platform on AWS, upgrade seperti [`opusplan`](#opusplan-model-setting) ke model yang dikecualikan menggunakan versi terbaru keluarga upgrade yang diizinkan. Pada penyedia dengan ID model khusus penyedia, dan ketika tidak ada versi yang diizinkan, upgrade dilewati dan perencanaan berlanjut pada model sesi.281* **Upgrade mode rencana**: pada API Anthropic dan Claude Platform on AWS, upgrade seperti [`opusplan`](#opusplan-model-setting) ke model yang dikecualikan menggunakan versi terbaru keluarga upgrade yang diizinkan. Pada penyedia dengan ID model khusus penyedia, dan ketika tidak ada versi yang diizinkan, upgrade dilewati dan perencanaan berlanjut pada model sesi.

280* **[Fallback model otomatis](#automatic-model-fallback)**: fallback yang targetnya dikecualikan tidak berjalan, jadi permintaan yang ditandai berakhir dengan penolakan282* **[Fallback model otomatis](#automatic-model-fallback)**: fallback yang targetnya dikecualikan tidak berjalan, jadi permintaan yang ditandai berakhir dengan penolakan sebagai gantinya

281* **[Pengklasifikasi mode otomatis](/docs/id/permission-modes#eliminate-prompts-with-auto-mode)**: default Claude Sonnet 5 pengklasifikasi hanya berlaku ketika daftar izin memungkinkan Sonnet 5. Ketika dikecualikan, pengklasifikasi berjalan pada model sesi, yang daftar izin sudah mengatur, atau pada model Opus ketika sesi berjalan pada [model Fable](#work-with-fable). Pada penyedia selain Anthropic API, fallback Opus itu berjalan pada model Opus default penyedia tanpa berkonsultasi dengan daftar izin. Memerlukan Claude Code v2.1.210 atau lebih baru283* **[Pengklasifikasi mode otomatis](/docs/id/permission-modes#eliminate-prompts-with-auto-mode)**: default Claude Sonnet 5 pengklasifikasi hanya berlaku ketika daftar putih memungkinkan Sonnet 5. Ketika dikecualikan, pengklasifikasi berjalan pada model sesi, yang sudah diatur daftar putih, atau pada model Opus ketika sesi berjalan pada [model Fable](#work-with-fable). Pada penyedia selain API Anthropic, fallback Opus itu berjalan pada model Opus default penyedia tanpa berkonsultasi dengan daftar putih. Memerlukan Claude Code v2.1.210 atau lebih baru

282* **[Mode cepat](/docs/id/fast-mode)**: mengaktifkan mode cepat ditolak ketika model yang akan dijalankan sesi setelahnya berada di luar daftar izin284* **[Mode cepat](/docs/id/fast-mode)**: mengaktifkan mode cepat ditolak ketika model yang akan dijalankan sesi setelahnya berada di luar daftar putih

283 285 

284```json theme={null}286```json theme={null}

285{287{


291 Cakupan permukaan293 Cakupan permukaan

292</h3>294</h3>

293 295 

294Setiap permukaan memberlakukan daftar izin yang diterimanya. Mekanisme pengiriman mana yang mencapai setiap permukaan berbeda:296Setiap permukaan memberlakukan daftar putih yang diterimanya. Mekanisme pengiriman mana yang mencapai setiap permukaan berbeda:

295 297 

296| Mekanisme pengiriman | CLI dan IDE | Sesi lokal desktop | Sesi web, mobile, dan cloud | Agent SDK dan non-interaktif | Cowork |298| Mekanisme pengiriman | CLI dan IDE | Sesi lokal desktop | Sesi web, mobile, dan cloud | Agent SDK dan non-interaktif | Cowork |

297| :- | :- | :- | :- | :- | :- |299| :- | :- | :- | :- | :- | :- |

298| [Pengaturan terkelola server](/docs/id/server-managed-settings) dari konsol admin | Diberlakukan | Diberlakukan | Diberlakukan, kecuali dalam sesi [Claude Tag](https://claude.com/docs/claude-tag/overview) | Diberlakukan | Tidak dikirimkan |300| [Pengaturan terkelola server](/docs/id/server-managed-settings) dari konsol admin | Diberlakukan | Diberlakukan | Diberlakukan, kecuali dalam sesi [Claude Tag](https://claude.com/docs/claude-tag/overview) | Diberlakukan | Sesi Cowork jarak jauh: server memeriksa model. Di mesin pengguna: tidak dikirimkan. |

299| [File MDM atau pengaturan terkelola](/docs/id/managed-settings#delivery-mechanisms) | Diberlakukan | Diberlakukan | Tidak dikirimkan di lingkungan yang dihosting Anthropic; di [lingkungan yang dihosting sendiri](/docs/id/self-hosted-environments), diberlakukan dari gambar runner per [bagaimana Claude Code menggabungkan sumber terkelola](/docs/id/managed-settings#how-claude-code-combines-managed-sources) | Diberlakukan | Diberlakukan di mana diterapkan |301| [File MDM atau pengaturan terkelola](/docs/id/managed-settings#delivery-mechanisms) | Diberlakukan | Diberlakukan | Tidak dikirimkan di lingkungan yang dihosting Anthropic; di [lingkungan yang dihosting sendiri](/docs/id/self-hosted-environments), diberlakukan dari gambar runner per [bagaimana Claude Code menggabungkan sumber terkelola](/docs/id/managed-settings#how-claude-code-combines-managed-sources) | Diberlakukan | Diberlakukan di mana diterapkan |

300 302 

301* [Sesi cloud](/docs/id/claude-code-on-the-web), termasuk yang Anda mulai dari aplikasi Desktop, berjalan pada VM yang dikelola Anthropic secara default: pengaturan yang diterapkan ke perangkat Anda tidak mencapainya, jadi kirimkan daftar izin melalui pengaturan terkelola server. Sesi yang organisasi Anda arahkan ke [lingkungan yang dihosting sendiri](/docs/id/self-hosted-environments) berjalan pada komputasi Anda sendiri dan juga membaca file pengaturan terkelola dalam gambar runner. [Bagaimana Claude Code menggabungkan sumber terkelola](/docs/id/managed-settings#how-claude-code-combines-managed-sources) mengatakan kapan file itu berlaku. Perubahan model pertengahan sesi dalam sesi cloud ditolak ketika model yang diminta dikecualikan oleh daftar izin. Ketika daftar `availableModels` dalam pengaturan terkelola server Anda tidak kosong, server menolak permintaan untuk memulai sesi cloud pada model yang daftar kecualikan.303* [Sesi cloud](/docs/id/claude-code-on-the-web), termasuk yang Anda mulai dari aplikasi Desktop, berjalan pada VM yang dikelola Anthropic secara default: pengaturan yang diterapkan ke perangkat Anda tidak mencapainya, jadi kirimkan daftar putih melalui pengaturan terkelola server. Sesi yang organisasi Anda arahkan ke [lingkungan yang dihosting sendiri](/docs/id/self-hosted-environments) berjalan pada komputasi Anda sendiri dan juga membaca file pengaturan terkelola dalam gambar runner. [Bagaimana Claude Code menggabungkan sumber terkelola](/docs/id/managed-settings#how-claude-code-combines-managed-sources) mengatakan kapan file itu berlaku. Perubahan model pertengahan sesi dalam sesi cloud ditolak ketika model yang diminta dikecualikan oleh daftar putih. Ketika daftar `availableModels` dalam pengaturan terkelola server Anda tidak kosong, server menolak permintaan untuk memulai sesi cloud di claude.ai/code atau dari aplikasi Desktop pada model yang daftar kecualikan.

302* [Claude Tag](https://claude.com/docs/claude-tag/overview) sesi berjalan di lingkungan cloud tetapi tidak menerima pengaturan terkelola server; dalam [lingkungan yang dihosting sendiri](/docs/id/self-hosted-environments), mereka masih membaca file pengaturan terkelola dalam gambar runner. Untuk menetapkan model untuk sesi tersebut, lihat [Pilih model untuk cakupan](https://claude.com/docs/claude-tag/admins/customize#choose-the-model-for-a-scope) dalam panduan admin Claude Tag.304* Sesi [Claude Tag](https://claude.com/docs/claude-tag/overview) berjalan di lingkungan cloud tetapi tidak menerima pengaturan terkelola server; dalam [lingkungan yang dihosting sendiri](/docs/id/self-hosted-environments), mereka masih membaca file pengaturan terkelola dalam gambar runner. Untuk menetapkan model untuk sesi tersebut, lihat [Pilih model untuk cakupan](https://claude.com/docs/claude-tag/admins/customize#choose-the-model-for-a-scope) dalam panduan admin Claude Tag.

303* Cowork, tab pekerjaan agentic dalam aplikasi Claude Desktop, menjalankan sesinya pada Claude Code tetapi, dengan desain, tidak menerima pengaturan terkelola server dari konsol admin claude.ai. File pengaturan terkelola berlaku untuk sesi Cowork ketika ada di mana sesi berjalan; sesi Cowork jarak jauh berjalan pada VM yang dikelola Anthropic, di mana file yang diterapkan perangkat tidak ada.305* Cowork, tab pekerjaan agentic dalam aplikasi Claude Desktop, menjalankan sesinya pada Claude Code tetapi, dengan desain, tidak menerima pengaturan terkelola server dari konsol admin claude.ai. Ketika daftar `availableModels` dalam pengaturan terkelola server Anda tidak kosong dan pengguna memilih model di luar itu, server menolak model itu untuk sesi Cowork jarak jauh. File pengaturan terkelola berlaku untuk sesi Cowork ketika ada di mana sesi berjalan; sesi Cowork jarak jauh berjalan pada VM yang dikelola Anthropic, di mana file yang diterapkan perangkat tidak ada.

304* Sesi pada [penyedia pihak ketiga](/docs/id/server-managed-settings#platform-availability) seperti Amazon Bedrock, Agent Platform Google Cloud, Microsoft Foundry, dan [Claude Platform on AWS](/docs/id/claude-platform-on-aws) tidak menerima pengaturan terkelola server, jadi kirimkan daftar izin melalui file MDM atau pengaturan terkelola di sana.306* Sesi pada [penyedia pihak ketiga](/docs/id/server-managed-settings#platform-availability) seperti Amazon Bedrock, Agent Platform Google Cloud, Microsoft Foundry, dan [Claude Platform on AWS](/docs/id/claude-platform-on-aws) tidak menerima pengaturan terkelola server, jadi kirimkan daftar putih melalui file MDM atau pengaturan terkelola di sana.

305* Pengiriman terkelola server juga memerlukan sesi untuk mengautentikasi dengan [login atau kunci yang memenuhi syarat](/docs/id/server-managed-settings#platform-availability). Armada yang menghasilkan kunci hanya melalui skrip [`apiKeyHelper`](/docs/id/settings-reference#apikeyhelper) harus mengirimkan daftar izin melalui file MDM atau pengaturan terkelola.307* Pengiriman terkelola server juga memerlukan sesi untuk mengautentikasi dengan [login atau kunci yang memenuhi syarat](/docs/id/server-managed-settings#platform-availability). Armada yang menghasilkan kunci hanya melalui skrip [`apiKeyHelper`](/docs/id/settings-reference#apikeyhelper) harus mengirimkan daftar putih melalui file MDM atau pengaturan terkelola.

306* Tab Desktop Code juga menghosting [sesi SSH](/docs/id/desktop#ssh-sessions), yang membaca file pengaturan terkelola dari host jarak jauh tempat mereka berjalan. Lihat [Pengaturan terkelola desktop](/docs/id/desktop#managed-settings).308* Tab Code Desktop juga menampilkan [sesi SSH](/docs/id/desktop#ssh-sessions), yang membaca file pengaturan terkelola dari host jarak jauh tempat mereka berjalan. Lihat [Pengaturan terkelola Desktop](/docs/id/desktop#managed-settings).

307* Pemilih model pada claude.ai dan dalam aplikasi Desktop menyembunyikan atau memudarkan model yang dikecualikan oleh daftar izin organisasi Anda. Status pemilih adalah kenyamanan bagi pengguna; itu tidak memberlakukan daftar izin.309* Pemilih model di claude.ai dan dalam aplikasi Desktop menyembunyikan atau memudarkan model yang dikecualikan oleh daftar putih organisasi Anda. Status pemilih adalah kenyamanan bagi pengguna; itu tidak memberlakukan daftar putih.

308 310 

309<h3 id="default-model-behavior">311<h3 id="default-model-behavior">

310 Perilaku model default312 Perilaku model default


315Dengan `availableModels: []`, pemilihan model bernama diblokir dan `enforceAvailableModels` tidak berpengaruh.317Dengan `availableModels: []`, pemilihan model bernama diblokir dan `enforceAvailableModels` tidak berpengaruh.

316 318 

317<h3 id="enforce-the-allowlist-for-the-default-model">319<h3 id="enforce-the-allowlist-for-the-default-model">

318 Berlakukan daftar izin untuk model Default320 Berlakukan daftar putih untuk model Default

319</h3>321</h3>

320 322 

321Atur `enforceAvailableModels: true` bersama dengan `availableModels` yang tidak kosong dalam pengaturan terkelola untuk memperluas daftar izin ke opsi Default. Ini memerlukan Claude Code v2.1.175 atau lebih baru.323Atur `enforceAvailableModels: true` bersama dengan `availableModels` yang tidak kosong dalam pengaturan terkelola untuk memperluas daftar putih ke opsi Default. Ini memerlukan Claude Code v2.1.175 atau lebih baru.

322 324 

323```json theme={null}325```json theme={null}

324{326{


327}329}

328```330```

329 331 

330Untuk anggota tanpa model [tercatat di akun mereka](#setting-your-model), opsi Default diselesaikan ke default tipe akun, atau ke [model default organisasi](#organization-default-model) ketika admin telah menetapkan satu. Ketika model itu tidak dalam daftar izin, opsi Default malah diselesaikan ke entri `availableModels` pertama yang menyebutkan model yang diizinkan dan tersedia, dan baris Default pemilih `/model` menunjukkan model itu. Ini berlaku di mana pun default dicapai: startup sesi, memilih Default dalam `/model`, kata kunci `"default"` dalam [rantai model fallback](#fallback-model-chains), dan fallback yang digunakan ketika pemilihan yang dikecualikan dijatuhkan. Model yang tercatat di akun anggota juga diperiksa terhadap `availableModels`; [Menetapkan model Anda](#setting-your-model) menjelaskan bagaimana opsi Default memperlakukannya.332Untuk anggota tanpa model [tercatat di akun mereka](#setting-your-model), opsi Default diselesaikan ke default tipe akun, atau ke [model default organisasi](#organization-default-model) ketika admin telah menetapkan satu. Ketika model itu tidak dalam daftar putih, opsi Default sebagai gantinya diselesaikan ke entri `availableModels` pertama yang menyebutkan model yang diizinkan dan tersedia, dan baris Default pemilih `/model` menunjukkan model itu. Ini berlaku di mana pun default dicapai: startup sesi, memilih Default dalam `/model`, kata kunci `"default"` dalam [rantai model fallback](#fallback-model-chains), dan fallback yang digunakan ketika pemilihan yang dikecualikan dijatuhkan. Model yang tercatat di akun anggota juga diperiksa terhadap `availableModels`; [Menetapkan model Anda](#setting-your-model) menjelaskan bagaimana opsi Default memperlakukannya.

331 333 

332`enforceAvailableModels` memetakan ulang opsi Default hanya ketika `availableModels` tidak kosong. Ketika `availableModels` tidak kosong tetapi tidak ada entri yang diselesaikan ke model yang diizinkan dan tersedia, penegakan dilewati dengan peringatan yang terlihat hanya di bawah `--debug`. Pertahankan setidaknya satu entri yang dijamin tersedia dalam daftar untuk menghindari ini.334`enforceAvailableModels` memetakan ulang opsi Default hanya ketika `availableModels` tidak kosong. Ketika `availableModels` tidak kosong tetapi tidak ada entri yang diselesaikan ke model yang diizinkan dan tersedia, penegakan dilewati dengan peringatan yang terlihat hanya di bawah `--debug`. Pertahankan setidaknya satu entri yang dijamin tersedia dalam daftar untuk menghindari ini.

333 335 

334Terapkan kedua kunci bersama dalam sumber terkelola peringkat tertinggi yang Anda kirimkan. Secara default Claude Code hanya membaca sumber itu, jadi pasangan yang ditempatkan dalam file pengaturan terkelola diabaikan ketika konsol admin mengirimkan pengaturan apa pun; di bawah penggabungan opt-in dalam [bagaimana Claude Code menggabungkan sumber terkelola](/docs/id/managed-settings#how-claude-code-combines-managed-sources), Claude Code masih mengabaikan peta `modelOverrides` dari sumber yang diperingkat di bawah yang menetapkan `availableModels`.336Terapkan kedua kunci bersama dalam sumber terkelola dengan peringkat tertinggi yang Anda kirimkan. Secara default Claude Code hanya membaca sumber itu, jadi pasangan yang ditempatkan dalam file pengaturan terkelola diabaikan ketika konsol admin mengirimkan pengaturan apa pun; di bawah penggabungan opt-in dalam [bagaimana Claude Code menggabungkan sumber terkelola](/docs/id/managed-settings#how-claude-code-combines-managed-sources), Claude Code masih mengabaikan peta `modelOverrides` dari sumber yang diperingkat di bawah yang menetapkan `availableModels`.

335 337 

336<h3 id="control-the-model-users-run-on">338<h3 id="control-the-model-users-run-on">

337 Kontrol model yang dijalankan pengguna339 Kontrol model yang dijalankan pengguna

338</h3>340</h3>

339 341 

340Pengaturan `model` adalah pemilihan awal, bukan penegakan. Itu menetapkan model mana yang aktif ketika sesi dimulai, tetapi pengguna masih dapat membuka `/model` dan memilih Default, yang diselesaikan ke [default runtime](#default-model-setting) sistem terlepas dari apa yang `model` diatur, kecuali [`enforceAvailableModels`](#enforce-the-allowlist-for-the-default-model) atau [kunci yang memblokir versi spesifik](#block-specific-models-or-versions) berlaku untuk itu.342Pengaturan `model` adalah pemilihan awal, bukan penegakan. Ini menetapkan model mana yang aktif ketika sesi dimulai, tetapi pengguna masih dapat membuka `/model` dan memilih Default, yang diselesaikan ke [default runtime](#default-model-setting) sistem terlepas dari apa yang `model` diatur, kecuali [`enforceAvailableModels`](#enforce-the-allowlist-for-the-default-model) atau [kunci yang memblokir versi tertentu](#block-specific-models-or-versions) berlaku untuk itu.

341 343 

342Untuk sepenuhnya mengontrol pengalaman model, gabungkan pengaturan ini:344Untuk sepenuhnya mengontrol pengalaman model, gabungkan pengaturan ini:

343 345 

344* **`availableModels`**: membatasi model bernama mana yang dapat dialihkan pengguna346* **`availableModels`**: membatasi model bernama mana yang dapat dialihkan pengguna

345* **`enforceAvailableModels`**: memperluas daftar izin `availableModels` ke opsi Default, jadi Default tidak dapat diselesaikan ke model di luar daftar347* **`enforceAvailableModels`**: memperluas daftar putih `availableModels` ke opsi Default, jadi Default tidak dapat diselesaikan ke model di luar daftar

346* **`deniedModels`** dan **`availableModelsMatch`**: [blokir versi spesifik](#block-specific-models-or-versions) yang entri `availableModels` akan memungkinkan348* **`deniedModels`** dan **`availableModelsMatch`**: [blokir versi tertentu](#block-specific-models-or-versions) yang entri `availableModels` akan memungkinkan sebaliknya

347* **`model`**: menetapkan pemilihan model awal ketika sesi dimulai349* **`model`**: menetapkan pemilihan model awal ketika sesi dimulai

348* **`ANTHROPIC_DEFAULT_SONNET_MODEL`** / **`ANTHROPIC_DEFAULT_OPUS_MODEL`** / **`ANTHROPIC_DEFAULT_HAIKU_MODEL`** / **`ANTHROPIC_DEFAULT_FABLE_MODEL`**: mengontrol apa yang diselesaikan alias `sonnet`, `opus`, `haiku`, dan `fable`, dan versi mana yang digunakan [default tipe akun](#default-model-setting)350* **`ANTHROPIC_DEFAULT_SONNET_MODEL`** / **`ANTHROPIC_DEFAULT_OPUS_MODEL`** / **`ANTHROPIC_DEFAULT_HAIKU_MODEL`** / **`ANTHROPIC_DEFAULT_FABLE_MODEL`**: mengontrol apa yang diselesaikan alias `sonnet`, `opus`, `haiku`, dan `fable`, dan versi mana yang digunakan [default tipe akun](#default-model-setting)

349 351 

350Contoh ini memulai pengguna pada Sonnet 4.5, membatasi pemilih ke Sonnet dan Haiku, dan memastikan Default diselesaikan ke model dalam daftar izin daripada default tier:352Contoh ini memulai pengguna pada Sonnet 4.5, membatasi pemilih ke Sonnet dan Haiku, dan memastikan Default diselesaikan ke model dalam daftar putih daripada default tier:

351 353 

352```json theme={null}354```json theme={null}

353{355{


360}362}

361```363```

362 364 

363Tanpa `enforceAvailableModels` atau blok `env`, pengguna yang memilih Default dalam pemilih mendapatkan [default runtime](#default-model-setting) daripada versi yang disematkan dalam `model`. Dua pengaturan mencakup cakupan berbeda: `enforceAvailableModels` membuat Default mematuhi daftar izin, sementara blok `env` menyematkan versi mana yang diselesaikan alias yang diizinkan seperti `sonnet`. Gunakan `enforceAvailableModels` saja ketika membatasi keluarga model cukup; tambahkan blok `env` ketika Anda juga perlu menyematkan versi spesifik.365Tanpa `enforceAvailableModels` atau blok `env`, pengguna yang memilih Default dalam pemilih mendapatkan [default runtime](#default-model-setting) daripada versi yang disematkan dalam `model`. Dua pengaturan mencakup cakupan berbeda: `enforceAvailableModels` membuat Default mematuhi daftar putih, sementara blok `env` menyematkan versi mana yang diselesaikan alias yang diizinkan seperti `sonnet`. Gunakan `enforceAvailableModels` saja ketika membatasi keluarga model cukup; tambahkan blok `env` ketika Anda juga perlu menyematkan versi tertentu.

364 366 

365<h3 id="merge-behavior">367<h3 id="merge-behavior">

366 Perilaku penggabungan368 Perilaku penggabungan

367</h3>369</h3>

368 370 

369Ketika pengaturan terkelola yang diterapkan Claude Code mendefinisikan `availableModels`, daftar itu saja berlaku, terlepas dari [platform host yang menyediakan miliknya sendiri](/docs/id/settings#exceptions-to-managed-settings-precedence): entri dalam pengaturan pengguna, proyek, atau lokal tidak dapat memperpanjangnya, dan Claude Code tidak pernah menggabungkan `availableModels` di seluruh sumber terkelola; [bagaimana Claude Code menggabungkan sumber terkelola](/docs/id/managed-settings#how-claude-code-combines-managed-sources) mengatakan daftar sumber mana yang berlaku. Jika tidak, daftar dari pengaturan pengguna, proyek, dan lokal adalah [digabungkan dan dideduplikasi](/docs/id/settings#settings-precedence) seperti pengaturan array lainnya. Sebelum Claude Code v2.1.175, entri dari cakupan prioritas lebih rendah digabungkan ke dalam daftar terkelola daripada diganti olehnya.371Ketika pengaturan terkelola yang diterapkan Claude Code mendefinisikan `availableModels`, daftar itu saja berlaku, terlepas dari [platform host yang menyediakan miliknya sendiri](/docs/id/settings#exceptions-to-managed-settings-precedence): entri dalam pengaturan pengguna, proyek, atau lokal tidak dapat memperpanjangnya, dan Claude Code tidak pernah menggabungkan `availableModels` di seluruh sumber terkelola baik; [bagaimana Claude Code menggabungkan sumber terkelola](/docs/id/managed-settings#how-claude-code-combines-managed-sources) mengatakan daftar sumber mana yang berlaku. Jika tidak, daftar dari pengaturan pengguna, proyek, dan lokal adalah [digabungkan dan dideduplikasi](/docs/id/settings#settings-precedence) seperti pengaturan array lainnya. Sebelum Claude Code v2.1.175, entri dari cakupan prioritas lebih rendah digabungkan ke dalam daftar terkelola sebagai gantinya dari diganti olehnya.

370 372 

371Dalam daftar efektif, entri yang menyebutkan model spesifik dalam keluarga, baik awalan versi maupun ID model lengkap, menonaktifkan entri wildcard keluarga itu: `["sonnet", "claude-sonnet-4-5"]` memungkinkan hanya versi Sonnet 4.5, bukan setiap model Sonnet.373Dalam daftar efektif, entri yang menyebutkan model tertentu dalam keluarga, baik awalan versi atau ID model lengkap, menonaktifkan entri wildcard keluarga itu: `["sonnet", "claude-sonnet-4-5"]` memungkinkan hanya versi Sonnet 4.5, bukan setiap model Sonnet.

372 374 

373<h3 id="mantle-model-ids">375<h3 id="mantle-model-ids">

374 ID model Mantle376 ID model Mantle

375</h3>377</h3>

376 378 

377Ketika [titik akhir Amazon Bedrock Mantle](/docs/id/amazon-bedrock#use-the-mantle-endpoint) diaktifkan, entri dalam `availableModels` yang dimulai dengan `anthropic.` ditambahkan ke pemilih `/model` sebagai opsi khusus dan dirutekan ke titik akhir Mantle. Ini adalah pengecualian terhadap pencocokan alias yang dijelaskan dalam [Sematkan model untuk penerapan pihak ketiga](#pin-models-for-third-party-deployments). Pengaturan masih membatasi pemilih ke entri yang terdaftar, dan ID Mantle menyematkan nama keluarga, jadi itu dihitung sebagai entri spesifik dan menonaktifkan wildcard keluarga itu: bersama dengan ID Mantle apa pun, daftarkan awalan versi atau ID lengkap yang ingin Anda pertahankan dapat dipilih. Lihat [Perilaku penggabungan](#merge-behavior).379Ketika [titik akhir Amazon Bedrock Mantle](/docs/id/amazon-bedrock#use-the-mantle-endpoint) diaktifkan, entri dalam `availableModels` yang dimulai dengan `anthropic.` ditambahkan ke pemilih `/model` sebagai opsi khusus dan dialihkan ke titik akhir Mantle. Ini adalah pengecualian untuk pencocokan alias yang dijelaskan dalam [Sematkan model untuk penerapan pihak ketiga](#pin-models-for-third-party-deployments). Pengaturan masih membatasi pemilih ke entri yang terdaftar, dan ID Mantle menyematkan nama keluarga, jadi itu dihitung sebagai entri tertentu dan menonaktifkan wildcard keluarga itu: bersama dengan ID Mantle apa pun, daftarkan awalan versi atau ID lengkap yang ingin Anda pertahankan dapat dipilih. Lihat [Perilaku penggabungan](#merge-behavior).

378 380 

379<h3 id="block-specific-models-or-versions">381<h3 id="block-specific-models-or-versions">

380 Blokir model atau versi spesifik382 Blokir model atau versi tertentu

381</h3>383</h3>

382 384 

383Entri `availableModels` seperti `claude-opus-5` juga memungkinkan rilis yang lebih baru yang memperpanjangnya, seperti Opus 5.5, segera setelah Claude Code mendukungnya. Dua pengaturan terkelola memungkinkan Anda menahan rilis, dan keduanya memerlukan Claude Code v2.1.283 atau lebih baru:385Entri `availableModels` seperti `claude-opus-5` juga memungkinkan rilis yang lebih baru yang memperpanjangnya, seperti Opus 5.5, segera setelah Claude Code mendukungnya. Dua pengaturan terkelola memungkinkan Anda menahan rilis, dan keduanya memerlukan Claude Code v2.1.283 atau lebih baru:

384 386 

385* [`deniedModels`](/docs/id/settings-reference#deniedmodels): daftarkan model yang akan diblokir. Model yang terdaftar diblokir bahkan ketika `availableModels` memungkinkannya, dan kunci juga bekerja tanpa daftar izin sama sekali. Rilis yang tidak ada entri blok tetap diizinkan387* [`deniedModels`](/docs/id/settings-reference#deniedmodels): daftarkan model yang akan diblokir. Model yang terdaftar diblokir bahkan ketika `availableModels` memungkinkannya, dan kunci juga bekerja tanpa daftar putih sama sekali. Rilis yang tidak ada entri blok tetap diizinkan

386* [`availableModelsMatch`](/docs/id/settings-reference#availablemodelsmatch): aturnya ke `"exact"` sehingga setiap ID model dalam `availableModels` hanya memungkinkan versi yang dinamainya. Versi yang lebih baru dari ID model yang terdaftar kemudian tetap diblokir sampai Anda menambahkannya ke daftar388* [`availableModelsMatch`](/docs/id/settings-reference#availablemodelsmatch): aturnya ke `"exact"` sehingga setiap ID model dalam `availableModels` hanya memungkinkan versi yang dinamainya. Versi yang lebih baru dari ID model yang terdaftar kemudian tetap diblokir sampai Anda menambahkannya ke daftar

387 389 

388Versi sebelumnya mengabaikan kedua kunci, jadi juga atur [`requiredMinimumVersion`](/docs/id/settings-reference#requiredminimumversion) untuk menjaga versi itu agar tidak dimulai.390Versi sebelumnya mengabaikan kedua kunci, jadi juga atur [`requiredMinimumVersion`](/docs/id/settings-reference#requiredminimumversion) untuk menjaga versi tersebut agar tidak dimulai.

389 391 

390Contoh ini memungkinkan model Opus dan Sonnet dan memblokir Opus 5.5 dalam setiap ejaan, termasuk ID yang tertanggal dan khusus penyedia:392Contoh ini memungkinkan model Opus dan Sonnet dan memblokir Opus 5.5 dalam setiap ejaan, termasuk ID yang tertanggal dan khusus penyedia:

391 393 


396}398}

397```399```

398 400 

399Model yang diblokir, baik `deniedModels` menyebutkannya atau daftar `"exact"` menghilangkannya, diperlakukan sebagai pemilihan terblokir di mana pun [daftar izin berlaku](#restrict-model-selection). Itu disembunyikan dari pemilih `/model`, dan `/model <name>` menolaknya. Jika Anda menyebutkan ID model yang diblokir dengan `--model`, `ANTHROPIC_MODEL`, atau pengaturan `model`, Claude Code menjatuhkannya saat startup dan menyelesaikan opsi Default. Jika [hook](/docs/id/hooks) atau permintaan latar belakang menyebutkan model yang `deniedModels` blokir, seperti bidang `model` hook agent, permintaan itu berjalan pada model sesi.401Model yang diblokir, baik `deniedModels` menyebutkannya atau daftar `"exact"` menghilangkannya, diperlakukan sebagai pemilihan terblokir di mana pun [daftar putih berlaku](#restrict-model-selection). Itu disembunyikan dari pemilih `/model`, dan `/model <name>` menolaknya. Jika Anda menyebutkan ID model yang diblokir dengan `--model`, `ANTHROPIC_MODEL`, atau pengaturan `model`, Claude Code menjatuhkannya saat startup dan menyelesaikan opsi Default sebagai gantinya. Jika [hook](/docs/id/hooks) atau permintaan latar belakang menyebutkan model yang `deniedModels` blokir, seperti bidang `model` hook agent, permintaan itu berjalan pada model sesi sebagai gantinya.

400 402 

401Opsi Default mengikuti kedua kunci juga, apakah atau tidak Anda menetapkan [`enforceAvailableModels`](#enforce-the-allowlist-for-the-default-model). Jika Anda menetapkannya dengan `availableModels` yang tidak kosong, default yang diblokir dihitung sebagai model di luar daftar izin. Jika tidak, opsi Default yang akan diselesaikan ke model yang diblokir turun dalam urutan ini:403Opsi Default mengikuti kedua kunci juga, baik atau tidak Anda atur [`enforceAvailableModels`](#enforce-the-allowlist-for-the-default-model). Jika Anda menetapkannya dengan `availableModels` yang tidak kosong, default yang diblokir dihitung sebagai model di luar daftar putih. Jika tidak, opsi Default yang akan diselesaikan ke model yang diblokir turun dalam urutan ini:

402 404 

4031. Versi terbaru keluarga yang sama yang diizinkan4051. Versi terbaru keluarga yang sama yang diizinkan

4042. Model terakhir yang diizinkan dari setiap keluarga biaya lebih rendah: Sonnet, kemudian Haiku4062. Model yang diizinkan terbaru dari setiap keluarga biaya lebih rendah secara bergiliran: Sonnet, kemudian Haiku

4053. Entri `availableModels` pertama yang menyebutkan model yang diizinkan4073. Entri `availableModels` pertama yang menyebutkan model yang diizinkan

406 408 

407Jika tidak ada yang diizinkan, sesi yang dimulai pada opsi Default [menolak untuk dimulai](/docs/id/errors#managed-settings-block-the-default-model) dengan kesalahan yang menyebutkan kunci untuk diperbaiki. Daftar `"exact"` mempengaruhi opsi Default hanya ketika daftar `availableModels` terkelola menyebutkan setidaknya satu model atau keluarga.409Jika tidak ada yang diizinkan, sesi yang dimulai pada opsi Default [menolak untuk dimulai](/docs/id/errors#managed-settings-block-the-default-model) dengan kesalahan yang menyebutkan kunci untuk diperbaiki. Daftar `"exact"` mempengaruhi opsi Default hanya ketika daftar `availableModels` terkelola menyebutkan setidaknya satu model atau keluarga.


416 418 

417Pembatasan berlaku ketika anggota masuk atau menggunakan kunci API mereka sendiri. Kredensial yang bersifat organisasi, seperti kunci layanan organisasi, tidak terikat pada pengguna, jadi pembatasan tidak berlaku untuk mereka.419Pembatasan berlaku ketika anggota masuk atau menggunakan kunci API mereka sendiri. Kredensial yang bersifat organisasi, seperti kunci layanan organisasi, tidak terikat pada pengguna, jadi pembatasan tidak berlaku untuk mereka.

418 420 

419Claude Console tidak memiliki kontrol pembatasan model. Organisasi tanpa paket Claude Enterprise, termasuk yang anggotanya mengautentikasi melalui Anthropic API, membatasi model dengan [`availableModels`](#restrict-model-selection) dalam [pengaturan terkelola](/docs/id/managed-settings), menambahkan [`enforceAvailableModels`](#enforce-the-allowlist-for-the-default-model) untuk mencakup opsi Default. [Cakupan permukaan](#surface-coverage) mengatakan bagaimana setiap permukaan menerima dan memberlakukan pengaturan ini.421Claude Console tidak memiliki kontrol pembatasan model. Organisasi tanpa paket Claude Enterprise, termasuk yang anggotanya mengautentikasi melalui API Anthropic, membatasi model dengan [`availableModels`](#restrict-model-selection) dalam [pengaturan terkelola](/docs/id/managed-settings) sebagai gantinya, menambahkan [`enforceAvailableModels`](#enforce-the-allowlist-for-the-default-model) untuk mencakup opsi Default. [Cakupan permukaan](#surface-coverage) mengatakan bagaimana setiap permukaan menerima dan memberlakukan pengaturan ini.

420 422 

421Model yang dibatasi disembunyikan dari pemilih `/model`. Memilihnya berdasarkan nama dengan `--model`, variabel lingkungan `ANTHROPIC_MODEL`, atau pengaturan `model` menunjukkan pemberitahuan `Model "<name>" is restricted by your organization's settings. Using <model> instead.` dan sesi dimulai pada model yang diizinkan. Mengetik `/model <name>` untuk model yang dibatasi ditolak dengan `Model '<name>' is restricted by your organization's settings. Run /model to choose a different model.` dan sesi mempertahankan model saat ini.423Model yang dibatasi disembunyikan dari pemilih `/model`. Memilihnya berdasarkan nama dengan `--model`, variabel lingkungan `ANTHROPIC_MODEL`, atau pengaturan `model` menunjukkan pemberitahuan `Model "<name>" is restricted by your organization's settings. Using <model> instead.` dan sesi dimulai pada model yang diizinkan. Mengetik `/model <name>` untuk model yang dibatasi ditolak dengan `Model '<name>' is restricted by your organization's settings. Run /model to choose a different model.` dan sesi menyimpan model saat ini.

422 424 

423Alias keluarga model [](#restrict-model-selection) seperti `opus` diselesaikan ke model biasanya ketika organisasi memungkinkannya. Ketika organisasi membatasi model itu, Claude Code mengganti versi terbaru keluarga yang diizinkan organisasi, dengan pemberitahuan substitusi yang sama. `/model <alias>` ditolak hanya ketika setiap versi keluarganya dibatasi; alias yang diatur dengan `--model`, `ANTHROPIC_MODEL`, atau pengaturan `model` masih diganti saat startup dalam hal itu. Sebelum v2.1.205, alias keluarga diganti atau ditolak berdasarkan versi rilis terbarunya saja, bahkan ketika versi yang lebih lama diizinkan.425Alias keluarga model [](#restrict-model-selection) seperti `opus` diselesaikan ke model biasanya ketika organisasi memungkinkannya. Ketika organisasi membatasi model itu, Claude Code mengganti versi terbaru keluarga yang diizinkan organisasi, dengan pemberitahuan substitusi yang sama. `/model <alias>` ditolak hanya ketika setiap versi keluarganya dibatasi; alias yang diatur dengan `--model`, `ANTHROPIC_MODEL`, atau pengaturan `model` masih diganti saat startup dalam hal itu. Sebelum v2.1.205, alias keluarga diganti atau ditolak berdasarkan versi rilis terbarunya saja, bahkan ketika versi yang lebih lama diizinkan.

424 426 


426 428 

427* Menonaktifkan model di tingkat organisasi menghapusnya untuk setiap anggota.429* Menonaktifkan model di tingkat organisasi menghapusnya untuk setiap anggota.

428* Akses tingkat peran memberikan model berbeda ke peran khusus yang berbeda, dan anggota yang memiliki beberapa peran dapat menggunakan model apa pun yang diizinkan salah satu peran mereka.430* Akses tingkat peran memberikan model berbeda ke peran khusus yang berbeda, dan anggota yang memiliki beberapa peran dapat menggunakan model apa pun yang diizinkan salah satu peran mereka.

429* Model Haiku selalu tersedia dan tidak dapat dinonaktifkan, jadi setiap anggota mempertahankan setidaknya satu model yang dapat digunakan.431* Model Haiku selalu tersedia dan tidak dapat dinonaktifkan, jadi setiap anggota menyimpan setidaknya satu model yang dapat digunakan.

430* Perubahan akses berlaku di seluruh organisasi dalam waktu sekitar satu menit; pemilih `/model` mencerminkannya saat sesi berikutnya dimulai.432* Perubahan akses berlaku di seluruh organisasi dalam waktu sekitar satu menit; pemilih `/model` mencerminkannya saat sesi berikutnya dimulai.

431 433 

432Kedua pembatasan berlaku bersama: model dapat dipilih hanya ketika diizinkan oleh `availableModels` dan tidak dibatasi oleh organisasi. Pembatasan organisasi mencapai sesi pada Anthropic API dan penerapan [LLM gateway](/docs/id/llm-gateway) saja; pada penyedia lain apa pun, gunakan `availableModels`.434Kedua pembatasan berlaku bersama: model dapat dipilih hanya ketika diizinkan oleh `availableModels` dan tidak dibatasi oleh organisasi. Pembatasan organisasi mencapai sesi pada API Anthropic dan penerapan [gateway LLM](/docs/id/llm-gateway) saja; pada penyedia lain apa pun, gunakan `availableModels` sebagai gantinya.

433 435 

434<h2 id="organization-default-model">436<h2 id="organization-default-model">

435 Model default organisasi437 Model default organisasi


519 Rantai model fallback521 Rantai model fallback

520</h3>522</h3>

521 523 

522Ketika model utama kelebihan beban, tidak tersedia, atau mengembalikan kesalahan server non-retryable lainnya, Claude Code dapat beralih ke model fallback alih-alih gagal permintaan. Kesalahan autentikasi, penagihan, rate-limit, ukuran permintaan, dan transportasi, serta [penolakan oleh pemeriksaan kebijakan organisasi Anda](/docs/id/errors#automatic-retries), tidak pernah memicu switch; mereka mengikuti penanganan retry dan error normal mereka.524Ketika model utama kelebihan beban, tidak tersedia, atau mengembalikan kesalahan server non-retryable lainnya, Claude Code dapat beralih ke model fallback alih-alih gagal permintaan. Kesalahan autentikasi, penagihan, rate-limit, ukuran permintaan, dan transportasi, serta [penolakan oleh pemeriksaan kebijakan organisasi Anda](/docs/id/errors#automatic-retries), tidak pernah memicu switch; mereka mengikuti penanganan retry dan error normal mereka. Ini beralih ketika [Amazon Bedrock](/docs/id/amazon-bedrock#when-a-model-is-disabled-mid-session) atau [Google Cloud's Agent Platform](/docs/id/google-vertex-ai#when-a-model-is-disabled-mid-session) menolak model yang akun Anda tidak dapat memanggil, yang Claude Code perlakukan sebagai model tidak tersedia daripada sebagai error autentikasi.

523 525 

524Konfigurasikan satu atau lebih model fallback dan Claude Code mencobanya secara berurutan, menampilkan pemberitahuan saat beralih. Switch berlangsung untuk giliran saat ini saja, jadi pesan berikutnya Anda mencoba model utama terlebih dahulu lagi. Claude Code membatasi rantai pada tiga model setelah penghapusan duplikat dan mengabaikan entri tambahan.526Konfigurasikan satu atau lebih model fallback dan Claude Code mencobanya secara berurutan, menampilkan pemberitahuan saat beralih. Switch berlangsung untuk giliran saat ini saja, jadi pesan berikutnya Anda mencoba model utama terlebih dahulu lagi. Claude Code membatasi rantai pada tiga model setelah penghapusan duplikat dan mengabaikan entri tambahan.

525 527 


773 775 

774Claude Code memeriksa persyaratan paket ini hanya ketika terhubung ke Anthropic API secara langsung. Jika Anda menunjuk `ANTHROPIC_BASE_URL` pada [gateway LLM](/docs/id/llm-gateway#subscriptions-and-gateways) dan login claude.ai tersimpan Anda tetap menjadi kredensial aktif, Claude Code tidak memeriksa kredit penggunaan paket Anda. Opsi `[1m]` tetap tersedia dalam `/model`, dan gateway memutuskan apakah permintaan berhasil. Sebelum v2.1.229, Claude Code menolak `/model sonnet[1m]` dalam konfigurasi itu ketika tidak dapat mengkonfirmasi kredit penggunaan pada akun.776Claude Code memeriksa persyaratan paket ini hanya ketika terhubung ke Anthropic API secara langsung. Jika Anda menunjuk `ANTHROPIC_BASE_URL` pada [gateway LLM](/docs/id/llm-gateway#subscriptions-and-gateways) dan login claude.ai tersimpan Anda tetap menjadi kredensial aktif, Claude Code tidak memeriksa kredit penggunaan paket Anda. Opsi `[1m]` tetap tersedia dalam `/model`, dan gateway memutuskan apakah permintaan berhasil. Sebelum v2.1.229, Claude Code menolak `/model sonnet[1m]` dalam konfigurasi itu ketika tidak dapat mengkonfirmasi kredit penggunaan pada akun.

775 777 

778<span id="context-window-behind-a-gateway" />

779 

780Jika Anda menetapkan `ANTHROPIC_BASE_URL` ke [gateway LLM](/docs/id/llm-gateway) atau proxy lainnya, Claude Code memberikan setiap model yang dikenalinya jendela konteks yang sama dengan model pada Anthropic API. Fable 5.1, Fable 5, Sonnet 5 dan lebih baru, dan Opus 4.7 dan lebih baru mendapatkan jendela 1M tanpa varian `[1m]` untuk dipilih, dan model yang mencapai 1M hanya melalui varian `[1m]` seperti Opus 4.6, berjalan pada 200K tanpanya. Claude Code tidak dapat mendeteksi batas yang lebih rendah yang gateway atau server di belakangnya berlakukan. Jika gateway Anda menolak permintaan di atas 200K token, jalankan [`/autocompact 200k`](#set-the-auto-compact-window) sehingga sesi compact pada batas itu.

781 

776Untuk menonaktifkan konteks 1M, atur `CLAUDE_CODE_DISABLE_1M_CONTEXT=1`. Claude Code menghapus varian model 1M dari pengambil model. Pada model dengan jendela 1M asli, seperti Sonnet 5 dan model Fable, ini juga memperlakukan model sebagai memiliki jendela konteks 200K:782Untuk menonaktifkan konteks 1M, atur `CLAUDE_CODE_DISABLE_1M_CONTEXT=1`. Claude Code menghapus varian model 1M dari pengambil model. Pada model dengan jendela 1M asli, seperti Sonnet 5 dan model Fable, ini juga memperlakukan model sebagai memiliki jendela konteks 200K:

777 783 

778* Dengan auto-compaction aktif, sesi compact pada batas 200K melalui [auto-compaction](#set-the-auto-compact-window). Menetapkan jendela auto-compact di atas 200K tidak mengangkat hold, karena Claude Code membatasi jendela itu pada jendela konteks model.784* Dengan auto-compaction aktif, sesi compact pada batas 200K melalui [auto-compaction](#set-the-auto-compact-window). Menetapkan jendela auto-compact di atas 200K tidak mengangkat hold, karena Claude Code membatasi jendela itu pada jendela konteks model.


801 807 

802Pada Anthropic API, Sonnet 5.5 dan Sonnet 5 selalu berjalan dengan jendela konteks 1M. Tidak ada varian 200K, tidak ada sufiks `[1m]` untuk dipilih, dan tidak ada kredit penggunaan yang diperlukan pada paket apa pun. Sesi auto-compact sebelum jendela penuh, pada sekitar 967K token secara default; atur [`CLAUDE_CODE_AUTO_COMPACT_WINDOW`](/docs/id/env-vars) untuk memilih ambang batas berbeda.808Pada Anthropic API, Sonnet 5.5 dan Sonnet 5 selalu berjalan dengan jendela konteks 1M. Tidak ada varian 200K, tidak ada sufiks `[1m]` untuk dipilih, dan tidak ada kredit penggunaan yang diperlukan pada paket apa pun. Sesi auto-compact sebelum jendela penuh, pada sekitar 967K token secara default; atur [`CLAUDE_CODE_AUTO_COMPACT_WINDOW`](/docs/id/env-vars) untuk memilih ambang batas berbeda.

803 809 

804Dua konfigurasi menganggarkan jendela pada 200K:810Claude Code memberikan Sonnet 5.5 dan Sonnet 5 jendela 1M yang sama di belakang [gateway LLM](/docs/id/llm-gateway) atau `ANTHROPIC_BASE_URL` kustom lainnya. Jika gateway Anda memberlakukan batas yang lebih rendah, lihat [jendela konteks di belakang gateway](#context-window-behind-a-gateway).

811 

812Pengaturan ini menganggarkan jendela pada 200K:

805 813 

806* **Gateway LLM**: ketika `ANTHROPIC_BASE_URL` menunjuk pada [gateway](/docs/id/llm-gateway), Claude Code tidak dapat memverifikasi dukungan 1M. Untuk menggunakan jendela penuh, pilih Sonnet 5.5 (1M context) dalam pengambil model, yang memetakan ke `sonnet[1m]`, atau jalankan `/model claude-sonnet-5[1m]` untuk Sonnet 5.

807* **`CLAUDE_CODE_DISABLE_1M_CONTEXT=1`**: menyimpan sesi pada setiap model dengan jendela 1M asli ke jendela 200K; lihat [Konteks diperpanjang](#extended-context) untuk cara hold ditegakkan. Berguna untuk penerapan yang perlu membatasi konteks.814* **`CLAUDE_CODE_DISABLE_1M_CONTEXT=1`**: menyimpan sesi pada setiap model dengan jendela 1M asli ke jendela 200K; lihat [Konteks diperpanjang](#extended-context) untuk cara hold ditegakkan. Berguna untuk penerapan yang perlu membatasi konteks.

808 815 

809<h2 id="context-window-and-auto-compaction">816<h2 id="context-window-and-auto-compaction">


839* [Sesi cloud](/docs/id/claude-code-on-the-web) melakukan pemadatan saat percakapan mendekati batas model846* [Sesi cloud](/docs/id/claude-code-on-the-web) melakukan pemadatan saat percakapan mendekati batas model

840* Sonnet 4.6 dan Opus 4.6 tanpa [konteks diperluas](#extended-context) melakukan pemadatan pada batas 200K, dan begitu juga Opus 4.8 dan yang lebih baru ketika mereka berjalan dengan jendela konteks 200K, seperti di Amazon Bedrock, Platform Agen Google Cloud, dan Microsoft Foundry847* Sonnet 4.6 dan Opus 4.6 tanpa [konteks diperluas](#extended-context) melakukan pemadatan pada batas 200K, dan begitu juga Opus 4.8 dan yang lebih baru ketika mereka berjalan dengan jendela konteks 200K, seperti di Amazon Bedrock, Platform Agen Google Cloud, dan Microsoft Foundry

841* Ketika Anda mengatur [`CLAUDE_CODE_DISABLE_1M_CONTEXT=1`](/docs/id/env-vars), model dengan jendela asli 1M, seperti Sonnet 5 dan model Fable, melakukan pemadatan pada batas 200K848* Ketika Anda mengatur [`CLAUDE_CODE_DISABLE_1M_CONTEXT=1`](/docs/id/env-vars), model dengan jendela asli 1M, seperti Sonnet 5 dan model Fable, melakukan pemadatan pada batas 200K

842* Model yang berjalan dengan jendela asli 1M, seperti Sonnet 5, model Fable, dan Opus 4.7 dan yang lebih baru di Anthropic API, melakukan pemadatan sebelum jendela penuh, pada sekitar 967K token secara default. Di Amazon Bedrock, Platform Agen Google Cloud, dan Microsoft Foundry, [Pin models for third-party deployments](#pin-models-for-third-party-deployments) mengatakan model mana yang berjalan dengan jendela itu; untuk konfigurasi yang menganggarkan Sonnet 5.5 dan Sonnet 5 pada 200K sebagai gantinya, lihat [Sonnet 5.5 and Sonnet 5 context window](#sonnet-5-5-and-sonnet-5-context-window)849* Model yang berjalan dengan jendela asli 1M melakukan pemadatan sebelum jendela penuh, pada sekitar 967K token secara default. Di Anthropic API, ini termasuk Sonnet 5, model Fable, dan Opus 4.7 dan yang lebih baru. Di Amazon Bedrock, Platform Agen Google Cloud, dan Microsoft Foundry, lihat [Pin models for third-party deployments](#pin-models-for-third-party-deployments) untuk model mana yang berjalan dengan jendela itu. Di balik `ANTHROPIC_BASE_URL` kustom, lihat [the context window behind a gateway](#context-window-behind-a-gateway)

843* Sesi pada ID model yang Claude Code tidak kenali, seperti alias [gateway LLM](/docs/id/llm-gateway), melakukan pemadatan pada jendela konteks yang Claude Code asumsikan untuk ID; lihat [Correct the window for a gateway or custom model ID](#correct-the-window-for-a-gateway-or-custom-model-id)850* Sesi pada ID model yang Claude Code tidak kenali, seperti alias [gateway LLM](/docs/id/llm-gateway), melakukan pemadatan pada jendela konteks yang Claude Code asumsikan untuk ID; lihat [Correct the window for a gateway or custom model ID](#correct-the-window-for-a-gateway-or-custom-model-id)

844 851 

845<h3 id="correct-the-window-for-a-gateway-or-custom-model-id">852<h3 id="correct-the-window-for-a-gateway-or-custom-model-id">


1053| - | - |1060| - | - |

1054| `DISABLE_PROMPT_CACHING` | Atur ke `1` untuk menonaktifkan prompt caching untuk semua model. Mengambil alih pengaturan per-model |1061| `DISABLE_PROMPT_CACHING` | Atur ke `1` untuk menonaktifkan prompt caching untuk semua model. Mengambil alih pengaturan per-model |

1055| `DISABLE_PROMPT_CACHING_HAIKU` | Atur ke `1` untuk menonaktifkan prompt caching untuk [model Haiku default](/docs/id/prompt-caching#disable-prompt-caching) |1062| `DISABLE_PROMPT_CACHING_HAIKU` | Atur ke `1` untuk menonaktifkan prompt caching untuk [model Haiku default](/docs/id/prompt-caching#disable-prompt-caching) |

1056| `DISABLE_PROMPT_CACHING_SONNET` | Atur ke `1` untuk menonaktifkan prompt caching hanya untuk model Sonnet |1063| `DISABLE_PROMPT_CACHING_SONNET` | Atur ke `1` untuk menonaktifkan prompt caching untuk [model Sonnet default](/docs/id/prompt-caching#disable-prompt-caching) |

1057| `DISABLE_PROMPT_CACHING_OPUS` | Atur ke `1` untuk menonaktifkan prompt caching hanya untuk model Opus |1064| `DISABLE_PROMPT_CACHING_OPUS` | Atur ke `1` untuk menonaktifkan prompt caching untuk [model Opus default](/docs/id/prompt-caching#disable-prompt-caching) |

1058| `DISABLE_PROMPT_CACHING_FABLE` | Atur ke `1` untuk menonaktifkan prompt caching hanya untuk model Fable |1065| `DISABLE_PROMPT_CACHING_FABLE` | Atur ke `1` untuk menonaktifkan prompt caching untuk model Fable saja |

1059 1066 

1060Untuk memilih cache TTL untuk percakapan utama dan untuk subagents secara terpisah, lihat [pilih TTL sendiri](/docs/id/prompt-caching#choose-the-ttl-yourself). Untuk apa yang memicu cache miss, lihat [Bagaimana Claude Code menggunakan prompt caching](/docs/id/prompt-caching).1067Untuk memilih cache TTL untuk percakapan utama dan untuk subagents secara terpisah, lihat [pilih TTL sendiri](/docs/id/prompt-caching#choose-the-ttl-yourself). Untuk apa yang memicu cache miss, lihat [Bagaimana Claude Code menggunakan prompt caching](/docs/id/prompt-caching).

1061 1068 

Details

1429* `managed_settings.trigger`: `"startup"` untuk peristiwa awal sesi, `"change"` ketika pengaturan yang dikelola atau keadaan pembantu kebijakan berubah nanti dalam sesi, atau `"refused"` ketika kebijakan pengaturan yang dikelola menghentikan sesi. Claude Code mengirim peristiwa `change` hanya ketika atribut berbeda dari peristiwa terakhir yang dikirimnya, dan nilai pengaturan yang berubah dihitung bahkan ketika `OTEL_LOG_MANAGED_SETTINGS` off1429* `managed_settings.trigger`: `"startup"` untuk peristiwa awal sesi, `"change"` ketika pengaturan yang dikelola atau keadaan pembantu kebijakan berubah nanti dalam sesi, atau `"refused"` ketika kebijakan pengaturan yang dikelola menghentikan sesi. Claude Code mengirim peristiwa `change` hanya ketika atribut berbeda dari peristiwa terakhir yang dikirimnya, dan nilai pengaturan yang berubah dihitung bahkan ketika `OTEL_LOG_MANAGED_SETTINGS` off

1430* `error.type`: mengapa Claude Code menghentikan sesi. Ada hanya pada peristiwa `refused`:1430* `error.type`: mengapa Claude Code menghentikan sesi. Ada hanya pada peristiwa `refused`:

1431 * `"helper_failed"`: [run pembantu kebijakan gagal](/docs/id/settings-reference#helper-failures)1431 * `"helper_failed"`: [run pembantu kebijakan gagal](/docs/id/settings-reference#helper-failures)

1432 * `"policy_invalid"`: pengaturan yang dikelola berisi kesalahan yang menghentikan Claude Code dari memulai, atau sumber admin gagal dimuat, jadi Claude Code tidak dapat memeriksa penegakan login organisasi1432 * `"policy_invalid"`: pengaturan yang dikelola berisi kesalahan yang menghentikan Claude Code dari memulai, atau sumber admin gagal dimuat untuk alasan selain pembacaan yang ditolak, jadi Claude Code tidak dapat memeriksa penegakan login organisasi atau penyedia

1433 * `"provider_not_allowed"`: sesi akan menggunakan penyedia API, atau mengirim lalu lintas penyedia ke host, yang daftar [`allowedProviders`](/docs/id/settings-reference#allowedproviders) yang dikelola tidak izinkan. Memerlukan Claude Code v2.1.285 atau lebih baru

1433 * `"consent_rejected"`: pengguna menolak [dialog persetujuan keamanan](/docs/id/server-managed-settings#security-approval-dialogs) untuk pengaturan yang dikelola server1434 * `"consent_rejected"`: pengguna menolak [dialog persetujuan keamanan](/docs/id/server-managed-settings#security-approval-dialogs) untuk pengaturan yang dikelola server

1434 * `"force_refresh_failed"`: pengambilan pengaturan yang [`forceRemoteSettingsRefresh`](/docs/id/settings-reference#forceremotesettingsrefresh) perlukan gagal1435 * `"force_refresh_failed"`: pengambilan pengaturan yang [`forceRemoteSettingsRefresh`](/docs/id/settings-reference#forceremotesettingsrefresh) perlukan gagal

1435 * `"gateway_rejected"`: [gateway aplikasi Claude](/docs/id/claude-apps-gateway) menjawab beban pengaturan yang dikelola dengan HTTP 4031436 * `"gateway_rejected"`: [gateway aplikasi Claude](/docs/id/claude-apps-gateway) menjawab beban pengaturan yang dikelola dengan HTTP 403

Details

246| `storage.googleapis.com` | Installer asli dan auto-updater asli pada versi sebelum 2.1.116 |246| `storage.googleapis.com` | Installer asli dan auto-updater asli pada versi sebelum 2.1.116 |

247| `registry.npmjs.org` | Instalasi plugin (pengambilan paket plugin bersumber npm dan instalasi dependensi paket Node.js plugin), server MCP yang diluncurkan `npx`, dan registri paket untuk instalasi npm dan bun dari Claude Code itu sendiri |247| `registry.npmjs.org` | Instalasi plugin (pengambilan paket plugin bersumber npm dan instalasi dependensi paket Node.js plugin), server MCP yang diluncurkan `npx`, dan registri paket untuk instalasi npm dan bun dari Claude Code itu sendiri |

248| `bridge.claudeusercontent.com` | [Claude in Chrome](/docs/id/chrome) jembatan WebSocket ekstensi |248| `bridge.claudeusercontent.com` | [Claude in Chrome](/docs/id/chrome) jembatan WebSocket ekstensi |

249| `*.frame.claudeusercontent.com` | Pembacaan konten [Artifact](/docs/id/artifacts). CLI mengambil file artefak dari host ini ketika Claude membuka satu, dan hanya ketika alat Artifact [tersedia](/docs/id/artifacts#availability) untuk akun Anda. Untuk mematikan alat dan menghilangkan persyaratan ini, atur [`"enableArtifact": false`](/docs/id/settings-reference#enableartifact) atau [`CLAUDE_CODE_DISABLE_ARTIFACT=1`](/docs/id/env-vars); Claude Code juga menghormati pengaturan [`disableArtifact`](/docs/id/settings-reference#disableartifact) yang sudah usang. Lihat [Disable artifacts](/docs/id/artifacts#disable-artifacts) untuk cara pengaturan ini berinteraksi |249| `*.frame.claudeusercontent.com` | Pembacaan konten [Artifact](/docs/id/artifacts). CLI mengambil file artefak dari host ini ketika Claude membuka satu, dan hanya ketika alat Artifact [tersedia](/docs/id/artifacts#availability) untuk akun Anda. Untuk mematikan alat dan menghilangkan persyaratan ini, atur [`"enableArtifact": false`](/docs/id/settings-reference#enableartifact) atau [`CLAUDE_CODE_DISABLE_ARTIFACT=1`](/docs/id/env-vars) |

250| `github.com` | Mengkloning [plugin marketplaces](/docs/id/plugins/overview) dan plugin yang dihosting GitHub, termasuk marketplace resmi Anthropic, melalui HTTPS atau SSH. Untuk mengkloning sumber GitHub `owner/repo` hanya melalui HTTPS, atur [`CLAUDE_CODE_PLUGIN_PREFER_HTTPS=1`](/docs/id/env-vars) |250| `github.com` | Mengkloning [plugin marketplaces](/docs/id/plugins/overview) dan plugin yang dihosting GitHub, termasuk marketplace resmi Anthropic, melalui HTTPS atau SSH. Untuk mengkloning sumber GitHub `owner/repo` hanya melalui HTTPS, atur [`CLAUDE_CODE_PLUGIN_PREFER_HTTPS=1`](/docs/id/env-vars) |

251| `raw.githubusercontent.com` | Umpan changelog untuk [`/release-notes`](/docs/id/commands). Dalam sesi interaktif, Claude Code juga mengambilnya di latar belakang saat startup ketika changelog cache-nya belum mencakup versi yang berjalan, seperti awal pertama setelah pembaruan; sesi non-interaktif dan cloud tidak pernah mengambilnya |251| `raw.githubusercontent.com` | Umpan changelog untuk [`/release-notes`](/docs/id/commands). Dalam sesi interaktif, Claude Code juga mengambilnya di latar belakang saat startup ketika changelog cache-nya belum mencakup versi yang berjalan, seperti awal pertama setelah pembaruan; sesi non-interaktif dan cloud tidak pernah mengambilnya |

252| `*-review.googlesource.com` | Pencarian perubahan Gerrit pada checkout `googlesource.com`. Ketika sesi tab Claude Desktop Code dimulai atau dilanjutkan pada checkout [terpercaya](/docs/id/permissions#project-allow-rules-and-workspace-trust) yang `origin`-nya adalah host `googlesource.com`, Claude Code menanyakan server `-review` host itu secara anonim untuk perubahan terbuka yang cocok dengan `Change-Id` HEAD, sekali per awal atau lanjutan. Jenis sesi lain melewati pencarian, dan tidak ada host Gerrit lain yang dihubungi. Opsional: nonaktifkan dengan [`CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC`](/docs/id/env-vars) |252| `*-review.googlesource.com` | Pencarian perubahan Gerrit pada checkout `googlesource.com`. Ketika sesi tab Claude Desktop Code dimulai atau dilanjutkan pada checkout [terpercaya](/docs/id/permissions#project-allow-rules-and-workspace-trust) yang `origin`-nya adalah host `googlesource.com`, Claude Code menanyakan server `-review` host itu secara anonim untuk perubahan terbuka yang cocok dengan `Change-Id` HEAD, sekali per awal atau lanjutan. Jenis sesi lain melewati pencarian, dan tidak ada host Gerrit lain yang dihubungi. Opsional: nonaktifkan dengan [`CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC`](/docs/id/env-vars) |

Details

86| Cara Anda menjalankan Claude Code | Mode izin awal bawaan |86| Cara Anda menjalankan Claude Code | Mode izin awal bawaan |

87| :- | :- |87| :- | :- |

88| File pengaturan apa pun menetapkan `disableAutoMode` ke `"disable"` | `default` |88| File pengaturan apa pun menetapkan `disableAutoMode` ke `"disable"` | `default` |

89| `claude -p` atau [Agent SDK](/docs/id/agent-sdk/permissions) | `default` |89| `claude -p` atau [Agent SDK](/docs/id/agent-sdk/permissions#permission-modes) | `default` dalam sesi yang [mengambil flag fitur](/docs/id/env-vars#features-that-need-feature-flag-fetching). Dalam sesi yang tidak, seperti pada penyedia pihak ketiga atau dengan telemetri mati, `auto` dengan Claude Code v2.1.285 atau lebih baru dan `default` pada versi sebelumnya. Sesi dalam organisasi yang kebijakannya menahan default `auto` dimulai dalam `default` sebagai gantinya |

90| Di terminal atau melalui [ekstensi VS Code](/docs/id/vs-code) | `auto` dengan Claude Code v2.1.283 atau lebih baru; pada versi sebelumnya, `auto` pada paket Pro, Max, atau Team dalam sesi yang [mengambil flag fitur](/docs/id/env-vars#features-that-need-feature-flag-fetching), dan `default` sebaliknya |90| Di terminal atau melalui [ekstensi VS Code](/docs/id/vs-code) | `auto` dengan Claude Code v2.1.283 atau lebih baru; pada versi sebelumnya, `auto` pada paket Pro, Max, atau Team dalam sesi yang [mengambil flag fitur](/docs/id/env-vars#features-that-need-feature-flag-fetching), dan `default` sebaliknya |

91 91 

92Dalam [sesi pertama Anda setelah instalasi atau upgrade](/docs/id/env-vars#first-session-after-an-install-or-upgrade), Claude Code dapat memilih mode izin awal sebelum flag fiturnya tiba. Sesi itu dapat dimulai dalam mode izin yang berbeda dari yang diberikan tabel, dan sesi berikutnya Anda cocok dengan tabel.92Dalam [sesi pertama Anda setelah instalasi atau upgrade](/docs/id/env-vars#first-session-after-an-install-or-upgrade), Claude Code dapat memilih mode izin awal sebelum flag fiturnya tiba. Sesi itu dapat dimulai dalam mode izin yang berbeda dari yang diberikan tabel, dan sesi berikutnya Anda cocok dengan tabel.


98* Di terminal, sekali, di bagian atas sesi98* Di terminal, sekali, di bagian atas sesi

99* Di ekstensi VS Code, sebagai kartu di layar percakapan baru yang tetap sampai Anda menutupnya99* Di ekstensi VS Code, sebagai kartu di layar percakapan baru yang tetap sampai Anda menutupnya

100 100 

101Pada paket Pro, Max, dan Team, jika `~/.claude/settings.json` Anda menetapkan `defaultMode` selain `auto` dan tidak ada file pengaturan lain yang menetapkan satu, sesi Anda terus dimulai dalam mode itu. Claude Code meminta sekali, di terminal atau di ekstensi VS Code, apakah akan mengubah pengaturan ke mode auto. Jika Anda menolak, pengaturan Anda tetap seperti adanya.101Jika `~/.claude/settings.json` Anda menetapkan `defaultMode` selain `auto` dan tidak ada file pengaturan lain yang menetapkan satu, sesi Anda terus dimulai dalam mode itu. Pada paket Pro, Max, dan Team, dan dalam sesi yang [tidak mengambil flag fitur](/docs/id/env-vars#features-that-need-feature-flag-fetching), Claude Code meminta sekali, di terminal atau di ekstensi VS Code, apakah akan mengubah pengaturan ke mode auto. Jika Anda menolak, pengaturan Anda tetap seperti adanya.

102 102 

103<h3 id="start-in-a-different-mode">103<h3 id="start-in-a-different-mode">

104 Mulai dalam mode izin yang berbeda104 Mulai dalam mode izin yang berbeda


322 Mode otomatis di Bedrock, Platform Agen, atau Foundry322 Mode otomatis di Bedrock, Platform Agen, atau Foundry

323</h3>323</h3>

324 324 

325Di [Amazon Bedrock](/docs/id/amazon-bedrock), [Platform Agen Google Cloud](/docs/id/google-vertex-ai), [Microsoft Foundry](/docs/id/microsoft-foundry), dan sesi [gateway aplikasi Claude](/docs/id/claude-apps-gateway) yang masuk, mode otomatis tersedia secara default. Dengan Claude Code v2.1.283 atau lebih baru, ini juga merupakan [mode izin awal bawaan](#which-mode-a-session-starts-in) untuk sesi terminal interaktif dan [VS Code](/docs/id/vs-code). Untuk memilih mode izin awal sendiri, atur `permissions.defaultMode` seperti yang dijelaskan [Mulai dalam mode izin berbeda](#start-in-a-different-mode), atau pilih mode izin dari indikator mode ekstensi VS Code.325Di [Amazon Bedrock](/docs/id/amazon-bedrock), [Platform Agen Google Cloud](/docs/id/google-vertex-ai), [Microsoft Foundry](/docs/id/microsoft-foundry), dan sesi [gateway aplikasi Claude](/docs/id/claude-apps-gateway) yang masuk, mode otomatis tersedia secara default. Ketika tidak ada yang lain menetapkan mode izin, ini juga merupakan [mode izin awal bawaan](#which-mode-a-session-starts-in), pada versi yang bagian itu daftarkan. Untuk memilih mode izin awal sendiri, atur `permissions.defaultMode` seperti yang dijelaskan [Mulai dalam mode izin berbeda](#start-in-a-different-mode), atau pilih mode izin dari indikator mode ekstensi VS Code.

326 326 

327Hanya Claude Sonnet 5 atau lebih baru, Opus 4.7 atau lebih baru, dan model Fable yang didukung di penyedia ini. Pada model lain apa pun, sesi dimulai dalam Manual sebagai gantinya.327Hanya Claude Sonnet 5 atau lebih baru, Opus 4.7 atau lebih baru, dan model Fable yang didukung di penyedia ini. Pada model lain apa pun, sesi dimulai dalam Manual sebagai gantinya.

328 328 


554 <Accordion title="Biaya dan latensi">554 <Accordion title="Biaya dan latensi">

555 Pengklasifikasi berjalan pada Claude Sonnet 5 secara default daripada pada pilihan `/model` Anda. Model pengklasifikasi yang dikonfigurasi Anthropic sisi server mengambil alih default itu. Ketika model sesi Anda adalah Claude Sonnet 4.6, atau ketika [`availableModels`](/docs/id/model-config#restrict-model-selection) mengecualikan Sonnet 5, pengklasifikasi berjalan pada model sesi sebagai gantinya, atau pada model Opus ketika sesi berjalan pada [model Fable](/docs/id/model-config#work-with-fable); di penyedia selain API Anthropic, fallback Opus itu adalah model Opus default penyedia.555 Pengklasifikasi berjalan pada Claude Sonnet 5 secara default daripada pada pilihan `/model` Anda. Model pengklasifikasi yang dikonfigurasi Anthropic sisi server mengambil alih default itu. Ketika model sesi Anda adalah Claude Sonnet 4.6, atau ketika [`availableModels`](/docs/id/model-config#restrict-model-selection) mengecualikan Sonnet 5, pengklasifikasi berjalan pada model sesi sebagai gantinya, atau pada model Opus ketika sesi berjalan pada [model Fable](/docs/id/model-config#work-with-fable); di penyedia selain API Anthropic, fallback Opus itu adalah model Opus default penyedia.

556 556 

557 Permintaan mode otomatis pertama sesi memvalidasi default Sonnet 5: jika permintaan berhasil, Sonnet 5 tetap model pengklasifikasi sesi, dan jika gagal karena model tidak tersedia, sesi menggunakan fallback sebagai gantinya. Setelah validasi itu diselesaikan, model pengklasifikasi tidak berubah untuk sesi.557 Permintaan mode otomatis pertama sesi memvalidasi default Sonnet 5: jika permintaan berhasil, Sonnet 5 tetap model pengklasifikasi sesi, dan jika gagal karena model tidak tersedia, sesi menggunakan fallback sebagai gantinya.

558 558 

559 Pada paket Enterprise dan di akun yang menggunakan Claude API, [Claude Platform di AWS](/docs/id/claude-platform-on-aws), Amazon Bedrock, Platform Agen Google Cloud, atau Microsoft Foundry, panggilan pengklasifikasi dihitung terhadap penggunaan token Anda. Setiap pemeriksaan mengirim sebagian dari transkrip ditambah tindakan yang tertunda, menambahkan putaran perjalanan pulang sebelum eksekusi. Pembacaan dan pengeditan direktori kerja di luar jalur yang dilindungi melewati pengklasifikasi, jadi overhead datang terutama dari perintah shell dan operasi jaringan. Di mana server meninjau tindakan sebagai bagian dari permintaan model sesi, tidak ada panggilan pengklasifikasi terpisah untuk dihitung; lihat [Tinjauan pengklasifikasi sisi server](#server-side-classifier-review).559 Pada paket Enterprise dan di akun yang menggunakan Claude API, [Claude Platform di AWS](/docs/id/claude-platform-on-aws), Amazon Bedrock, Platform Agen Google Cloud, atau Microsoft Foundry, panggilan pengklasifikasi dihitung terhadap penggunaan token Anda. Setiap pemeriksaan mengirim sebagian dari transkrip ditambah tindakan yang tertunda, menambahkan putaran perjalanan pulang sebelum eksekusi. Pembacaan dan pengeditan direktori kerja di luar jalur yang dilindungi melewati pengklasifikasi, jadi overhead datang terutama dari perintah shell dan operasi jaringan. Di mana server meninjau tindakan sebagai bagian dari permintaan model sesi, tidak ada panggilan pengklasifikasi terpisah untuk dihitung; lihat [Tinjauan pengklasifikasi sisi server](#server-side-classifier-review).

560 560 

permissions.md +2 −2

Details

764| [Hooks](/docs/id/hooks) dalam file pengaturan, blok [`env`](/docs/id/settings-reference#env) dan perintah pembantu seperti [`apiKeyHelper`](/docs/id/settings-reference#apikeyhelper), dan [hooks](/docs/id/hooks#hooks-in-skills-and-agents) skill proyek dan [`allowed-tools`](/docs/id/skills#pre-approve-tools-for-a-skill) | Digunakan | Digunakan. Kepercayaan ruang kerja tidak pernah membatasi `allowed-tools` skill dalam sesi apa pun |764| [Hooks](/docs/id/hooks) dalam file pengaturan, blok [`env`](/docs/id/settings-reference#env) dan perintah pembantu seperti [`apiKeyHelper`](/docs/id/settings-reference#apikeyhelper), dan [hooks](/docs/id/hooks#hooks-in-skills-and-agents) skill proyek dan [`allowed-tools`](/docs/id/skills#pre-approve-tools-for-a-skill) | Digunakan | Digunakan. Kepercayaan ruang kerja tidak pernah membatasi `allowed-tools` skill dalam sesi apa pun |

765| Aturan `permissions.allow` dan `additionalDirectories` dalam `.claude/settings.json` | Tidak digunakan sampai Anda menerima dialog kepercayaan, yang muncul lagi mencantumkannya | Tidak digunakan. Claude Code mencetak peringatan [`this workspace has not been trusted`](/docs/id/errors#workspace-has-not-been-trusted) ke stderr |765| Aturan `permissions.allow` dan `additionalDirectories` dalam `.claude/settings.json` | Tidak digunakan sampai Anda menerima dialog kepercayaan, yang muncul lagi mencantumkannya | Tidak digunakan. Claude Code mencetak peringatan [`this workspace has not been trusted`](/docs/id/errors#workspace-has-not-been-trusted) ke stderr |

766| Hooks frontmatter dalam [subagent](/docs/id/sub-agents#hooks-in-subagent-frontmatter) proyek, plugin [`@skills-dir`](/docs/id/plugins/loading#plugins-shared-through-a-repository) proyek, dan entri [`extraKnownMarketplaces`](/docs/id/settings-reference#extraknownmarketplaces) dari repositori atau direktori `--add-dir` | Tidak digunakan, dan tidak ada dialog yang ditawarkan | Tidak digunakan |766| Hooks frontmatter dalam [subagent](/docs/id/sub-agents#hooks-in-subagent-frontmatter) proyek, plugin [`@skills-dir`](/docs/id/plugins/loading#plugins-shared-through-a-repository) proyek, dan entri [`extraKnownMarketplaces`](/docs/id/settings-reference#extraknownmarketplaces) dari repositori atau direktori `--add-dir` | Tidak digunakan, dan tidak ada dialog yang ditawarkan | Tidak digunakan |

767| [`mcpServers`](/docs/id/sub-agents#scope-mcp-servers-to-a-subagent) inline dalam frontmatter subagent dari repositori atau direktori `--add-dir`. Sebelum v2.1.238, Claude Code memuat server ini dalam kedua situasi | Tidak digunakan, dan tidak ada dialog yang ditawarkan | Tidak digunakan |767| Inline [`mcpServers`](/docs/id/sub-agents#scope-mcp-servers-to-a-subagent) dalam frontmatter subagent dari repositori atau direktori `--add-dir` | Tidak digunakan, dan tidak ada dialog yang ditawarkan | Tidak digunakan |

768| Server dalam `.mcp.json`, termasuk yang [disetujui repositori dalam pengaturannya sendiri](/docs/id/mcp#project-server-approvals-and-workspace-trust) | Claude Code menanyakan Anda sebelum menghubungkannya. Persetujuan repositori itu sendiri tidak dihitung | Terhubung tanpa bertanya, disetujui atau tidak. SDK memuat mereka hanya ketika `settingSources` mencakup pengaturan proyek. `claude mcp list` di folder yang sama masih melaporkan server seperti itu sebagai tertunda |768| Server dalam `.mcp.json`, termasuk yang [disetujui repositori dalam pengaturannya sendiri](/docs/id/mcp#project-server-approvals-and-workspace-trust) | Claude Code menanyakan Anda sebelum menghubungkannya. Persetujuan repositori itu sendiri tidak dihitung | Terhubung tanpa bertanya, disetujui atau tidak. SDK memuat mereka hanya ketika `settingSources` mencakup pengaturan proyek. `claude mcp list` di folder yang sama masih melaporkan server seperti itu sebagai tertunda |

769| [`headersHelper`](/docs/id/mcp#trust-a-folder-before-its-headershelper-runs) pada server dalam `.mcp.json`. Sebelum v2.1.238, Claude Code menjalankan pembantu dalam kedua situasi | Tidak dijalankan sampai Anda menerima dialog kepercayaan, yang muncul lagi menamai tempat pembantu dideklarasikan. Claude Code menghubungkan server dengan `headers` statis saja sampai saat itu | Tidak dijalankan. Claude Code menghubungkan server dengan `headers` statis saja dan mencetak baris [`headersHelper not run`](/docs/id/errors#headershelper-not-run) per server ke stderr |769| [`headersHelper`](/docs/id/mcp#trust-a-folder-before-its-headershelper-runs) pada server dalam `.mcp.json` | Tidak dijalankan sampai Anda menerima dialog kepercayaan, yang muncul lagi menamai tempat pembantu dideklarasikan. Claude Code menghubungkan server dengan `headers` statis saja sampai saat itu | Tidak dijalankan. Claude Code menghubungkan server dengan `headers` statis saja dan mencetak baris [`headersHelper not run`](/docs/id/errors#headershelper-not-run) per server ke stderr |

770 770 

771Untuk baris yang memerlukan folder yang tepat ini dipercaya, percayai dengan tangan: atur `projects["<path>"].hasTrustDialogAccepted` ke `true` dalam `~/.claude.json`, di mana `<path>` adalah akar repositori, atau folder itu sendiri di luar repositori. Claude Code mencetak kunci yang tepat dalam baris log debug untuk hook subagent yang dilewati atau server MCP inline, dalam peringatan stderr untuk aturan izin yang dilewati, dan dalam baris `headersHelper not run` untuk pembantu yang dilewati.771Untuk baris yang memerlukan folder yang tepat ini dipercaya, percayai dengan tangan: atur `projects["<path>"].hasTrustDialogAccepted` ke `true` dalam `~/.claude.json`, di mana `<path>` adalah akar repositori, atau folder itu sendiri di luar repositori. Claude Code mencetak kunci yang tepat dalam baris log debug untuk hook subagent yang dilewati atau server MCP inline, dalam peringatan stderr untuk aturan izin yang dilewati, dan dalam baris `headersHelper not run` untuk pembantu yang dilewati.

772 772 

Details

29Setiap subperintah berbagi kode keluar, argumen plugin, dan nilai cakupan ini:29Setiap subperintah berbagi kode keluar, argumen plugin, dan nilai cakupan ini:

30 30 

31* **Kode keluar**: `0` pada kesuksesan dan `1` pada kegagalan. `validate` menambahkan keluar `2` untuk kesalahan yang tidak terduga, dan `eval` menambahkan kode yang tercantum di [bagiannya](#plugin-eval).31* **Kode keluar**: `0` pada kesuksesan dan `1` pada kegagalan. `validate` menambahkan keluar `2` untuk kesalahan yang tidak terduga, dan `eval` menambahkan kode yang tercantum di [bagiannya](#plugin-eval).

32* **Argumen plugin**: argumen `<plugin>` adalah plugin `name` atau `name@marketplace`. Ketika dua marketplace menawarkan nama yang sama, gunakan bentuk yang memenuhi syarat.32* **Argumen plugin**: argumen `<plugin>` adalah plugin `name` atau `name@marketplace`. Ketika dua marketplace menawarkan nama yang sama, gunakan bentuk yang memenuhi syarat. `configure` hanya mengambil bentuk yang memenuhi syarat.

33* **Cakupan**: `--scope` mengambil `user`, `project`, atau `local`, dan menamai file pengaturan yang ditulis perintah. `update` juga mengambil `managed`.33* **Cakupan**: `--scope` mengambil `user`, `project`, atau `local`, dan menamai file pengaturan yang ditulis perintah. `update` juga mengambil `managed`.

34 34 

35<h3 id="plugin-init">35<h3 id="plugin-init">


87| Flag | Deskripsi |87| Flag | Deskripsi |

88| :- | :- |88| :- | :- |

89| `-s, --scope <scope>` | Cakupan instalasi: `user`, `project`, atau `local`. Default ke `user` |89| `-s, --scope <scope>` | Cakupan instalasi: `user`, `project`, atau `local`. Default ke `user` |

90| `--config <key=value>` | Tetapkan opsi [`userConfig`](/docs/id/plugins/manifest-reference) yang dideklarasikan manifest plugin. Ulangi flag untuk setiap opsi. Memerlukan Claude Code v2.1.147 atau lebih baru |90| `--config <key=value>` | Tetapkan opsi [`userConfig`](/docs/id/plugins/manifest-reference) yang dideklarasikan manifest plugin. Ulangi flag untuk setiap opsi. Memerlukan Claude Code v2.1.147 atau lebih baru. Kunci yang ditulis `<server>.<key>` menetapkan pengaturan yang dideklarasikan [server MCP yang dibundel](/docs/id/plugins/components#include-a-packaged-mcpb-server) dalam `user_config`-nya sendiri, untuk file bundle yang dikirim di dalam plugin. Bentuk `<server>.<key>` memerlukan Claude Code v2.1.285 atau lebih baru |

91| `-y, --yes` | Terima perintah instal yang ditampilkan tanpa prompt `Run this command now?`. Diabaikan ketika perintah berjalan di dalam sesi Claude Code, seperti dari alat Bash atau hook. Memerlukan Claude Code v2.1.229 atau lebih baru |91| `-y, --yes` | Terima perintah instal yang ditampilkan tanpa prompt `Run this command now?`. Diabaikan ketika perintah berjalan di dalam sesi Claude Code, seperti dari alat Bash atau hook. Memerlukan Claude Code v2.1.229 atau lebih baru |

92| `--accept-command <sha256>` | Terima perintah instal yang ditampilkan yang `sha256` sebelumnya [`--json` run](#plugin-json-result) dilaporkan dalam `shownCommand`, sebagai pengganti `-y`. Tidak dapat digabungkan dengan `-y`. Lihat [Terima perintah instal yang ditampilkan](#accept-a-displayed-install-command). Memerlukan Claude Code v2.1.271 atau lebih baru |92| `--accept-command <sha256>` | Terima perintah instal yang ditampilkan yang `sha256` sebelumnya [`--json` run](#plugin-json-result) dilaporkan dalam `shownCommand`, sebagai pengganti `-y`. Tidak dapat digabungkan dengan `-y`. Lihat [Terima perintah instal yang ditampilkan](#accept-a-displayed-install-command). Memerlukan Claude Code v2.1.271 atau lebih baru |

93| `--json` | Cetak hasil sebagai satu objek JSON pada baris terakhir stdout alih-alih pesan yang dapat dibaca manusia, untuk digunakan dalam skrip. Lihat [Format hasil JSON](#plugin-json-result). Memerlukan Claude Code v2.1.268 atau lebih baru |93| `--json` | Cetak hasil sebagai satu objek JSON pada baris terakhir stdout alih-alih pesan yang dapat dibaca manusia, untuk digunakan dalam skrip. Lihat [Format hasil JSON](#plugin-json-result). Memerlukan Claude Code v2.1.268 atau lebih baru |


297| :- | :- |297| :- | :- |

298| `--json` | Cetak daftar sebagai JSON |298| `--json` | Cetak daftar sebagai JSON |

299| `--available` | Juga daftar plugin yang ditawarkan marketplace Anda yang belum Anda instal. Tidak berpengaruh tanpa `--json` |299| `--available` | Juga daftar plugin yang ditawarkan marketplace Anda yang belum Anda instal. Tidak berpengaruh tanpa `--json` |

300| `--data-size [plugin]` | Ukur [direktori data yang disimpan](#what-an-uninstall-deletes-and-keeps) setiap plugin yang diinstal, atau hanya plugin yang dinamai, diberikan sebagai `name@marketplace`. Tidak berpengaruh tanpa `--json`. Jika nama tidak memiliki catatan instal, perintah mencetak `--data-size names a plugin that is not installed` dan keluar `1` alih-alih mencetak daftar. Memerlukan Claude Code v2.1.285 atau lebih baru |

300 301 

301Claude Code mengelompokkan output yang dapat dibaca manusia berdasarkan cara setiap plugin dimuat:302Claude Code mengelompokkan output yang dapat dibaca manusia berdasarkan cara setiap plugin dimuat:

302 303 


328| `notes` | array of strings | Peringatan penulisan untuk plugin yang dimuat dan berfungsi |329| `notes` | array of strings | Peringatan penulisan untuk plugin yang dimuat dan berfungsi |

329| `errorDetails` | array of objects | Satu objek per entri `errors`, memberikan `type` diagnostik dan nama yang dirujuknya, seperti plugin, marketplace, server, atau file. Memerlukan Claude Code v2.1.268 atau lebih baru |330| `errorDetails` | array of objects | Satu objek per entri `errors`, memberikan `type` diagnostik dan nama yang dirujuknya, seperti plugin, marketplace, server, atau file. Memerlukan Claude Code v2.1.268 atau lebih baru |

330| `noteDetails` | array of objects | Objek detail yang sama untuk setiap entri `notes`. Memerlukan Claude Code v2.1.268 atau lebih baru |331| `noteDetails` | array of objects | Objek detail yang sama untuk setiap entri `notes`. Memerlukan Claude Code v2.1.268 atau lebih baru |

332| `hasUserConfig` | boolean | Hadir dan `true` ketika plugin dimuat dan manifestnya mendeklarasikan opsi [`userConfig`](/docs/id/plugins/manifest-reference#user-configuration). Tidak ada untuk plugin yang gagal dimuat, apa pun yang dideklarasikan manifestnya. Nilai yang disimpan tidak pernah disertakan. Memerlukan Claude Code v2.1.285 atau lebih baru |

333| `projectEnabled` | boolean | Apakah `.claude/settings.json` proyek yang dibagikan menghidupkan plugin. Hanya instal marketplace. Memerlukan Claude Code v2.1.285 atau lebih baru |

334| `dataDirSize` | object | Dengan `--data-size`, ukuran [direktori data yang disimpan](#what-an-uninstall-deletes-and-keeps) plugin sebagai `bytes` dan `human`; tidak ada ketika direktori hilang atau kosong. Hanya instal marketplace. Memerlukan Claude Code v2.1.285 atau lebih baru |

335| `dataDirUnreadable` | boolean | Dengan `--data-size`, `true` ketika direktori data yang disimpan ada tetapi tidak dapat diukur. Hanya instal marketplace. Memerlukan Claude Code v2.1.285 atau lebih baru |

331 336 

332Dengan `--json --available`, Claude Code mencetak satu objek alih-alih array. Field `installed`-nya memegang array objek plugin yang diinstal, dan field `available`-nya memegang satu objek per plugin marketplace yang tidak diinstal dengan field di bawah.337Dengan `--json --available`, Claude Code mencetak satu objek alih-alih array. Field `installed`-nya memegang array objek plugin yang diinstal, dan field `available`-nya memegang satu objek per plugin marketplace yang tidak diinstal dengan field di bawah.

333 338 


371 376 

372Untuk plugin yang tidak dimuat, Claude Code mencetak ``Plugin "formatter" not found. Run `claude plugin list` to see installed plugins, or pass --plugin-dir <path> to load one from disk.`` dan keluar `1`.377Untuk plugin yang tidak dimuat, Claude Code mencetak ``Plugin "formatter" not found. Run `claude plugin list` to see installed plugins, or pass --plugin-dir <path> to load one from disk.`` dan keluar `1`.

373 378 

379<h3 id="plugin-configure">

380 plugin configure

381</h3>

382 

383Tampilkan opsi [`userConfig`](/docs/id/plugins/manifest-reference#user-configuration) plugin yang diinstal dan mana yang diatur, atau simpan nilai yang disalurkan di stdin. Memerlukan Claude Code v2.1.285 atau lebih baru.

384 

385```bash theme={null}

386claude plugin configure <plugin>

387```

388 

389| Flag | Deskripsi |

390| :- | :- |

391| `--values-stdin` | Baca nilai opsi dari stdin sebagai objek JSON string satu baris dan simpan. Opsi yang Anda tinggalkan menyimpan nilai yang disimpan |

392| `--json` | Cetak hasil sebagai satu objek JSON ke stdout. Tanpa `--values-stdin`, objek membawa `schema` dan `choices` opsi, `inputs` awal mereka, dan nama opsi `configured` dan `unconfigured`. Dengan `--values-stdin`, membawa nama opsi `saved` dan, ketika dapat dibaca kembali, nama `unconfigured` |

393 

394Tanpa flag, perintah mencantumkan setiap opsi dengan hingga tiga label: `required` atau `optional`, kemudian `sensitive` untuk opsi yang dideklarasikan manifest sensitif, kemudian `set` atau `not set`. Tidak mencetak nilai yang disimpan. Dengan `--json`, output mencakup nilai yang disimpan dari opsi yang bukan sensitif, dan tidak pernah teks dari yang sensitif.

395 

396Untuk menyimpan nilai, tulis ke file sebagai objek JSON yang memetakan kunci opsi ke nilai string, kemudian lewatkan file di stdin. Ganti `formatter@my-marketplace` dengan id plugin Anda sendiri seperti yang ditunjukkan `claude plugin list`. Contoh ini menetapkan satu opsi bernama `api_url` dari file `values.json` yang berisi `{"api_url": "https://example.com"}`:

397 

398```bash theme={null}

399claude plugin configure formatter@my-marketplace --values-stdin < values.json

400```

401 

402Claude Code memvalidasi setiap nilai terhadap tipe yang dideklarasikan opsi dan mencetak `Configuration saved. Restart Claude Code to apply it.` Jika Anda melewatkan kunci yang tidak dideklarasikan manifest, atau nilai yang gagal validasi, perintah tidak menyimpan apa pun, mencetak `Failed to save configuration:` dengan alasan, dan keluar `1`. Dengan `--json`, nilai yang ditolak juga mencetak objek di stdout yang field `refused`-nya membawa `message` dan, ketika satu opsi salah, kunci `option`-nya.

403 

404Lewatkan id `name@marketplace` plugin yang lengkap, seperti yang ditunjukkan `claude plugin list`. `configure` tidak menerima `name` telanjang. Ketika tidak ada plugin yang dimuat memiliki id itu, perintah mencetak `No installed plugin has the id "<plugin>".` dan keluar `1`.

405 

406Untuk pengaturan server MCP yang dibundel, lihat [`plugin install --config`](#plugin-install) atau item **Configure** di `/plugin`.

407 

374<h3 id="plugin-prune">408<h3 id="plugin-prune">

375 plugin prune409 plugin prune

376</h3>410</h3>

Details

868 868 

869Server mengambil namanya dari `name` dalam manifest bundle.869Server mengambil namanya dari `name` dalam manifest bundle.

870 870 

871Bundle manifest sendiri dapat mendeklarasikan pengaturan yang dibutuhkan server dari pengguna dalam blok `user_config`. Server bundled dengan pengaturan yang diperlukan yang tidak memiliki nilai yang disimpan tidak dimulai. Tab **Errors** `/plugin` menunjukkan `Bundled MCP server "<name>" was not started: it needs configuration`.

872 

873Pengguna menyediakan nilai dengan salah satu dari dua cara:

874 

875* **Di `/plugin`**: pilih plugin di tab **Installed** dan pilih **Configure**

876* **Saat instalasi, dari shell**: lewatkan [`--config <server>.<key>=<value>`](/docs/id/plugins/cli-reference#plugin-install) ke `claude plugin install`. Memerlukan Claude Code v2.1.285 atau lebih baru, dan hanya berfungsi untuk bundle yang dikemas di dalam plugin.

877 

871Untuk transport dan autentikasi, lihat [MCP](/docs/id/mcp#plugin-provided-mcp-servers).878Untuk transport dan autentikasi, lihat [MCP](/docs/id/mcp#plugin-provided-mcp-servers).

872 879 

873<h3 id="lsp-servers">880<h3 id="lsp-servers">


1071 Kapan dialog konfigurasi muncul1078 Kapan dialog konfigurasi muncul

1072</h3>1079</h3>

1073 1080 

1074Dialog muncul hanya dalam antarmuka `/plugin` interaktif. Itu terbuka untuk opsi apa pun yang belum ditetapkan ketika pengguna melakukan salah satu dari berikut:1081Dialog adalah bagian dari antarmuka `/plugin` interaktif. Ketika pengguna melakukan salah satu dari berikut, dialog terbuka untuk opsi apa pun yang belum ditetapkan:

1075 1082 

1076* Memasang plugin di `/plugin`1083* Memasang plugin di `/plugin`

1077* Menjalankan `/plugin install <plugin>@<marketplace>` di dalam sesi1084* Menjalankan `/plugin install <plugin>@<marketplace>` di dalam sesi


1079 1086 

1080Untuk membuka dialog yang sama kapan saja, pengguna menjalankan `/plugin configure <plugin>@<marketplace>`.1087Untuk membuka dialog yang sama kapan saja, pengguna menjalankan `/plugin configure <plugin>@<marketplace>`.

1081 1088 

1082Perintah shell `claude plugin install` tidak pernah meminta nilai `userConfig`. Untuk menetapkan nilai dari shell, lewatkan masing-masing sebagai `--config KEY=VALUE`. Ketika opsi tetap tidak ditetapkan, perintah mencetak baris `userConfig options not yet set` yang menamai kedua cara untuk menetapkannya. [Dialog `userConfig` tidak pernah muncul](/docs/id/plugins/troubleshooting#the-userconfig-dialog-never-appears) mengutip baris.1089Dialog Manage plugins di ekstensi VS Code [Manage plugins dialog](/docs/id/vs-code#install-plugins) meminta opsi yang tidak ditetapkan sebagai formulir setelah instalasi, dan ikon gear pada baris plugin membuka formulir lagi dengan setiap opsi.

1090 

1091Perintah shell `claude plugin install` tidak pernah meminta nilai `userConfig`. Untuk menetapkan nilai dari shell, lewatkan masing-masing sebagai `--config KEY=VALUE` saat Anda memasang, atau pipa objek JSON ke [`claude plugin configure --values-stdin`](/docs/id/plugins/cli-reference#plugin-configure) setelahnya.

1092 

1093Ketika opsi tetap tidak ditetapkan, `claude plugin install` mencetak baris `userConfig options not yet set`. Untuk teks pasti baris tersebut, lihat [The `userConfig` dialog never appears](/docs/id/plugins/troubleshooting#the-userconfig-dialog-never-appears).

1083 1094 

1084Untuk field opsi, di mana setiap nilai disimpan, bagaimana komponen mereferensikan nilai yang disimpan, dan field mana yang menolak `${user_config.*}`, lihat [User configuration](/docs/id/plugins/manifest-reference#user-configuration).1095Untuk field opsi, di mana setiap nilai disimpan, bagaimana komponen mereferensikan nilai yang disimpan, dan field mana yang menolak `${user_config.*}`, lihat [User configuration](/docs/id/plugins/manifest-reference#user-configuration).

1085 1096 

Details

72 Kalimat terakhir ringkasan memberi tahu Anda apakah plugin dapat digunakan dalam sesi ini:72 Kalimat terakhir ringkasan memberi tahu Anda apakah plugin dapat digunakan dalam sesi ini:

73 73 

74 * **Active now**: `Plugin is now active.` Tidak perlu reload.74 * **Active now**: `Plugin is now active.` Tidak perlu reload.

75 * **Active, but a server needs setup**: `Plugin is now active.` diikuti oleh `Its bundled MCP server needs configuration before it can start`. [Bundled MCP server](/docs/id/plugins/components#include-a-packaged-mcpb-server) plugin tidak dapat dimulai sampai Anda mengatur opsinya. Pilih plugin di tab **Installed** di `/plugin` dan pilih **Configure** untuk mengatur opsi server.

75 * **Reload needed**: `Run /reload-plugins to activate.` Panel ditutup dan Claude Code menjalankan reload itu untuk Anda. Jika reload akan [membatalkan prompt cache](/docs/id/prompt-caching#enabling-or-disabling-a-plugin), itu memperingatkan dan meninggalkan plugin tertunda sebagai gantinya. Jalankan `/reload-plugins --force` untuk mengaktifkannya bagaimanapun, yang biaya satu permintaan uncached.76 * **Reload needed**: `Run /reload-plugins to activate.` Panel ditutup dan Claude Code menjalankan reload itu untuk Anda. Jika reload akan [membatalkan prompt cache](/docs/id/prompt-caching#enabling-or-disabling-a-plugin), itu memperingatkan dan meninggalkan plugin tertunda sebagai gantinya. Jalankan `/reload-plugins --force` untuk mengaktifkannya bagaimanapun, yang biaya satu permintaan uncached.

76 * **Load failed**: `The plugin couldn't be loaded`. Buka tab **Errors** di `/plugin` untuk alasannya, kemudian lihat [After install: plugin not working](/docs/id/plugins/troubleshooting#plugin-installed-but-not-working).77 * **Load failed**: `The plugin couldn't be loaded`. Buka tab **Errors** di `/plugin` untuk alasannya, kemudian lihat [After install: plugin not working](/docs/id/plugins/troubleshooting#plugin-installed-but-not-working).

77 </Step>78 </Step>


248Marketplace pribadi adalah satu di repository yang Anda butuhkan kredensial untuk clone, di GitHub atau host git apa pun. Anda menambahkannya dengan perintah `/plugin marketplace add` atau `claude plugin marketplace add` yang sama seperti yang publik. Claude Code mengklonnya dengan kredensial git yang sudah ada di mesin Anda dan tidak pernah meminta, jadi setiap cara koneksi memiliki persyaratan:249Marketplace pribadi adalah satu di repository yang Anda butuhkan kredensial untuk clone, di GitHub atau host git apa pun. Anda menambahkannya dengan perintah `/plugin marketplace add` atau `claude plugin marketplace add` yang sama seperti yang publik. Claude Code mengklonnya dengan kredensial git yang sudah ada di mesin Anda dan tidak pernah meminta, jadi setiap cara koneksi memiliki persyaratan:

249 250 

250* **HTTPS**: pembantu kredensial git Anda berlaku, jadi akses yang Anda atur dengan `gh auth login`, Keychain macOS, atau `git-credential-store` berfungsi. Prompt interaktif ditekan, jadi host yang belum pernah Anda autentikasi gagal alih-alih meminta kata sandi.251* **HTTPS**: pembantu kredensial git Anda berlaku, jadi akses yang Anda atur dengan `gh auth login`, Keychain macOS, atau `git-credential-store` berfungsi. Prompt interaktif ditekan, jadi host yang belum pernah Anda autentikasi gagal alih-alih meminta kata sandi.

251* **SSH**: host harus sudah ada di file `known_hosts` Anda dan kunci harus berfungsi tanpa prompt passphrase, karena prompt host-fingerprint dan passphrase juga ditekan.252* **SSH**: host harus sudah ada di file `known_hosts` Anda dan kunci harus berfungsi tanpa prompt passphrase. Jika setup git Anda menamai program SSH di `GIT_SSH_COMMAND`, `GIT_SSH`, atau `core.sshCommand` config git Anda, Claude Code menjalankan program itu.

252* **GitHub `owner/repo` shorthand**: Claude Code memeriksa apakah kunci SSH Anda mengautentikasi ke `github.com`, kemudian mengklonnya melalui SSH jika ya dan melalui HTTPS jika tidak. Atur [`CLAUDE_CODE_PLUGIN_PREFER_HTTPS=1`](/docs/id/env-vars#variables) untuk melewati pemeriksaan itu dan selalu mengklonnya melalui HTTPS.253* **GitHub `owner/repo` shorthand**: Claude Code memeriksa apakah kunci SSH Anda mengautentikasi ke `github.com`, kemudian mengklonnya melalui SSH jika ya dan melalui HTTPS jika tidak. Atur [`CLAUDE_CODE_PLUGIN_PREFER_HTTPS=1`](/docs/id/env-vars#variables) untuk melewati pemeriksaan itu dan selalu mengklonnya melalui HTTPS.

253 254 

254Kredensial yang sama berlaku ketika Anda menjalankan `/plugin install`, `/plugin marketplace update`, dan `claude plugin update`.255Kredensial yang sama berlaku ketika Anda menjalankan `/plugin install`, `/plugin marketplace update`, dan `claude plugin update`.


288 289 

289* Ketik untuk memfilter berdasarkan nama atau deskripsi.290* Ketik untuk memfilter berdasarkan nama atau deskripsi.

290* Tekan **Space** untuk mengaktifkan atau menonaktifkan plugin yang dipilih, dan **f** untuk menyukainya.291* Tekan **Space** untuk mengaktifkan atau menonaktifkan plugin yang dipilih, dan **f** untuk menyukainya.

291* Tekan **Enter** untuk membuka detail plugin. Menu di sana menawarkan **Disable plugin** atau **Enable plugin**, **Update now**, dan **Uninstall**. Plugin yang mengambil pengaturan juga menawarkan **Configure options**.292* Tekan **Enter** untuk membuka detail plugin.

293 

294Menu detail plugin menawarkan **Disable plugin** atau **Enable plugin**, **Update now**, dan **Uninstall**. Dua item lagi muncul untuk plugin yang mengambil pengaturan, dan plugin dapat menampilkan keduanya:

295 

296* **Configure options**: ditampilkan ketika manifest plugin mendeklarasikan opsi [`userConfig`](/docs/id/plugins/manifest-reference#user-configuration). Membuka dialog untuk opsi tersebut

297* **Configure**: ditampilkan ketika plugin menyertakan [server MCP yang dikemas](/docs/id/plugins/components#include-a-packaged-mcpb-server). Menetapkan pengaturan `user_config` server itu sendiri

292 298 

293Tab juga dapat menunjukkan plugin di cakupan **Managed**. Organisasi Anda menginstal mereka melalui [pengaturan terkelola](/docs/id/settings#settings-files), dan Anda tidak dapat mengaktifkan, menonaktifkan, atau mencopot mereka di sini.299Tab juga dapat menunjukkan plugin di cakupan **Managed**. Organisasi Anda menginstal mereka melalui [pengaturan terkelola](/docs/id/settings#settings-files), dan Anda tidak dapat mengaktifkan, menonaktifkan, atau mencopot mereka di sini.

294 300 

Details

201 201 

202Penambahan yang berhasil mencetak `Successfully added marketplace: <name>`.202Penambahan yang berhasil mencetak `Successfully added marketplace: <name>`.

203 203 

204<h3 id="invalid-git-url">

205 `Invalid git URL`

206</h3>

207 

208Anda menambahkan marketplace, menginstal plugin, atau menjalankan pembaruan dari alamat git, dan perintah gagal dengan `Invalid git URL` dalam pesannya.

209 

210Claude Code memeriksa setiap alamat git sebelum menjalankan git. Itu menolak alamat yang protokolnya tidak didukung. Itu juga menolak alamat yang git dapat baca sebagai penamaan server atau folder yang berbeda dari yang ditunjukkan alamat.

211 

212Teks setelah alamat menyebutkan apa yang harus diubah. Tulis ulang alamat seperti yang dikatakan pesan dan jalankan perintah lagi.

213 

214Penolakan yang malah mengatakan `is blocked by enterprise policy` berasal dari pengaturan organisasi Anda. Lihat [Sumber marketplace diblokir oleh kebijakan perusahaan](#marketplace-source-is-blocked-by-enterprise-policy).

215 

204<h3 id="path-does-not-exist">216<h3 id="path-does-not-exist">

205 `Path does not exist: <path>`217 `Path does not exist: <path>`

206</h3>218</h3>


410 422 

411`claude plugin install` di shell Anda mencetak pesan yang berbeda. Untuk plugin yang sudah diinstal di scope target, itu mencetak `Plugin "<name>@<marketplace>" is already installed (scope: user)` dan keluar 0. Jika direktori cache-nya hilang, command yang sama mengunduh ulang-nya.423`claude plugin install` di shell Anda mencetak pesan yang berbeda. Untuk plugin yang sudah diinstal di scope target, itu mencetak `Plugin "<name>@<marketplace>" is already installed (scope: user)` dan keluar 0. Jika direktori cache-nya hilang, command yang sama mengunduh ulang-nya.

412 424 

425<h3 id="plugin-would-share-its-folder">

426 `"<plugin>" was not installed: it would share its folder with "<other>"`

427</h3>

428 

429Anda menginstal plugin melalui `claude plugin install`, `/plugin`, atau saran instalasi dalam sesi, dan Claude Code menolaknya dengan baris ini, atau dengan `would share its saved data with`.

430 

431ID plugin yang ditolak dan ID plugin yang diinstal memetakan ke folder yang sama di disk: mereka sama sekali `.` dan `@` ditulis sebagai `-`. Di macOS dan Windows, id yang berbeda hanya dalam huruf besar memetakan ke folder yang sama juga. Menginstal keduanya akan menempatkan file satu plugin di folder plugin lain, jadi Claude Code menolak dan plugin yang diinstal menyimpan file-nya.

432 

433Pesan menyebutkan jalan keluar:

434 

435* **Plugin lain diinstal**: pesan mengatakan `Only one of the two can be installed.` dan menyebutkan command `claude plugin uninstall`, atau langkah uninstall di `/plugin`, yang menghapus plugin lain. Jalankan, lalu instal lagi. Untuk apa yang uninstall hapus, lihat [What an uninstall deletes and keeps](/docs/id/plugins/cli-reference#what-an-uninstall-deletes-and-keeps).

436* **Kedua id tiba dalam satu instalasi**, seperti plugin dan dependensi yang dibutuhkannya: tidak ada urutan instalasi yang membantu. Hanya maintainer marketplace yang mencantumkan dua plugin dapat memperbaikinya, dengan mengganti nama salah satu. Ketika keduanya berasal dari marketplace berbeda, maintainer salah satu dapat.

437 

413<h3 id="this-plugin-uses-a-source-type-your-claude-code-version-does-not-suppo">438<h3 id="this-plugin-uses-a-source-type-your-claude-code-version-does-not-suppo">

414 `This plugin uses a source type your Claude Code version does not support`439 `This plugin uses a source type your Claude Code version does not support`

415</h3>440</h3>


790* **`URL is unset or invalid`**: opsi `${user_config.*}` yang URL gunakan tidak diatur. Jalankan `/plugin configure <plugin>` untuk mengaturnya815* **`URL is unset or invalid`**: opsi `${user_config.*}` yang URL gunakan tidak diatur. Jalankan `/plugin configure <plugin>` untuk mengaturnya

791* **`has an invalid MCP url`** atau **`headersHelper for MCP server '<server>' references ${user_config.*}`**: konfigurasi plugin itu sendiri yang salah. Perbaiki `url` atau `headersHelper` dalam konfigurasi MCP plugin Anda, atau laporkan ke penulis plugin jika plugin bukan milik Anda. Kasus `headersHelper` memiliki entri sendiri di bawah [plugin command references user\_config](/docs/id/errors#plugin-command-references-user-config)816* **`has an invalid MCP url`** atau **`headersHelper for MCP server '<server>' references ${user_config.*}`**: konfigurasi plugin itu sendiri yang salah. Perbaiki `url` atau `headersHelper` dalam konfigurasi MCP plugin Anda, atau laporkan ke penulis plugin jika plugin bukan milik Anda. Kasus `headersHelper` memiliki entri sendiri di bawah [plugin command references user\_config](/docs/id/errors#plugin-command-references-user-config)

792 817 

818<h4 id="bundled-mcp-server-name-was-not-started-it-needs-configuration">

819 `Bundled MCP server "<name>" was not started: it needs configuration`

820</h4>

821 

822Plugin menyertakan server sebagai [MCPB bundle](/docs/id/plugins/components#include-a-packaged-mcpb-server) yang mendeklarasikan `user_config`, dan pengaturan yang diperlukan tidak memiliki nilai yang disimpan atau nilai yang disimpan gagal validasi bundle itu sendiri, jadi Claude Code melewati memulai server. Sisa plugin berfungsi.

823 

824Pilih plugin di tab **Installed** `/plugin` dan pilih **Configure** untuk memberikan nilai. Setelah Anda menyimpan, `/plugin` menunjukkan `Configuration saved.` dan ditutup, dan Claude Code memuat ulang plugin seperti yang dijelaskan di bawah [Manage installed plugins](/docs/id/plugins/install#manage-installed-plugins). Server dimulai setelah reload itu diterapkan. Sebelum v2.1.285, Claude Code melewati server tanpa menunjukkan baris ini.

825 

793<h4 id="server-is-configured-but-never-connects">826<h4 id="server-is-configured-but-never-connects">

794 Server is configured but never connects827 Server is configured but never connects

795</h4>828</h4>


934 967 

935Plugin Anda mendeklarasikan opsi `userConfig`, tetapi tidak ada dialog konfigurasi yang muncul ketika Anda menginstalnya.968Plugin Anda mendeklarasikan opsi `userConfig`, tetapi tidak ada dialog konfigurasi yang muncul ketika Anda menginstalnya.

936 969 

937Instalasi interaktif menunjukkan dialog, dan command shell mengambil nilai sebagai flag:970Apakah instalasi meminta nilai tergantung pada di mana Anda menjalankannya:

938 971 

939* **`/plugin install` dalam sesi, atau tab Discover di `/plugin`**: dialog adalah bagian dari instalasi interaktif ini972* **`/plugin install` dalam sesi, atau tab Discover di `/plugin`**: dialog adalah bagian dari instalasi interaktif ini

973* **Dialog Manage plugins ekstensi VS Code**: meminta opsi yang tidak diatur sebagai formulir setelah instalasi. Sebelum v2.1.285, menginstal di sana tidak menunjukkan formulir opsi, jadi atur nilai dari sesi terminal dengan `/plugin configure <plugin>@<marketplace>`

940* **`claude plugin install` di shell Anda**: tidak pernah meminta nilai `userConfig`. Itu menyimpan nilai `--config KEY=VALUE` apa pun yang Anda lewatkan, dan ketika opsi tetap tidak diatur itu mencetak `N userConfig options not yet set — run /plugin configure <plugin>@<marketplace> in Claude Code, or pass --config KEY=VALUE.` Ketika salah satu opsi yang tidak diatur diperlukan, `(M required)` mengikuti `not yet set`.974* **`claude plugin install` di shell Anda**: tidak pernah meminta nilai `userConfig`. Itu menyimpan nilai `--config KEY=VALUE` apa pun yang Anda lewatkan, dan ketika opsi tetap tidak diatur itu mencetak `N userConfig options not yet set — run /plugin configure <plugin>@<marketplace> in Claude Code, or pass --config KEY=VALUE.` Ketika salah satu opsi yang tidak diatur diperlukan, `(M required)` mengikuti `not yet set`.

941 975 

942Jika Anda menginstal dari shell, lewatkan nilai dengan `--config`, satu flag per opsi:976Jika Anda menginstal dari shell, lewatkan nilai dengan `--config`, satu flag per opsi:


945claude plugin install my-plugin@my-marketplace --config api_url=https://example.com979claude plugin install my-plugin@my-marketplace --config api_url=https://example.com

946```980```

947 981 

948Ketika setiap opsi diatur, output instalasi tidak membawa baris `not yet set`. Untuk membuka dialog setelahnya, jalankan `/plugin configure my-plugin@my-marketplace` dalam sesi.982Ketika setiap opsi diatur, output instalasi tidak membawa baris `not yet set`.

983 

984Untuk membuka dialog setelahnya, jalankan `/plugin configure my-plugin@my-marketplace` dalam sesi. Dari shell, [`claude plugin configure`](/docs/id/plugins/cli-reference#plugin-configure) menunjukkan opsi mana yang masih tidak diatur dan menyimpan nilai yang disalurkan di stdin. Itu memerlukan Claude Code v2.1.285 atau lebih baru.

949 985 

950Jika Anda melewatkan kunci `--config` yang manifest tidak deklarasikan, plugin masih diinstal, dan command mencetak `⚠ Installed, but --config not applied: --config key "<key>" isn't declared in this plugin's userConfig.` diikuti oleh kunci yang plugin deklarasikan.986Jika Anda melewatkan kunci `--config` yang manifest tidak deklarasikan, plugin masih diinstal, dan command mencetak `⚠ Installed, but --config not applied: --config key "<key>" isn't declared in this plugin's userConfig.` diikuti oleh kunci yang plugin deklarasikan.

951 987 

988Untuk plugin yang mengirimkan [file bundle MCPB](/docs/id/plugins/components#include-a-packaged-mcpb-server) yang mendeklarasikan `user_config` miliknya sendiri, pesan berbunyi `isn't declared in this plugin's userConfig or by its bundled MCP servers.` sebagai gantinya, dan kunci yang dikenal mencakup kunci server itu, ditulis `<server>.<key>`. Bundle yang manifest referensikan dengan URL tidak dibaca pada waktu instalasi, jadi kunci-nya tidak tercantum dan pesan mengatakan untuk mengonfigurasinya di `/plugin`. Mengatur kunci `<server>.<key>` memerlukan Claude Code v2.1.285 atau lebih baru.

989 

952<h3 id="claude-plugin-validate-reports-errors">990<h3 id="claude-plugin-validate-reports-errors">

953 `claude plugin validate` reports errors991 `claude plugin validate` reports errors

954</h3>992</h3>

Details

84<span id="loop-provider-differences" />84<span id="loop-provider-differences" />

85 85 

86<Note>86<Note>

87 Interval yang dipilih secara dinamis dan [prompt pemeliharaan bawaan](#run-the-built-in-maintenance-prompt) bekerja di setiap provider, dan dengan [feature-flag fetching](/docs/id/env-vars#features-that-need-feature-flag-fetching) dimatikan. Di Amazon Bedrock, Claude Platform on AWS, Google Cloud's Agent Platform, dan Microsoft Foundry, atau dengan fetching dimatikan, keduanya memerlukan Claude Code v2.1.248 atau lebih baru. Dalam kasus tersebut, pada versi sebelumnya, prompt tanpa interval berjalan pada jadwal tetap 10 menit, dan `/loop` tanpa prompt mencetak pesan penggunaan.87 Interval yang dipilih secara dinamis dan [prompt pemeliharaan bawaan](#run-the-built-in-maintenance-prompt) bekerja di setiap provider, dan dengan [feature-flag fetching](/docs/id/env-vars#features-that-need-feature-flag-fetching) dimatikan. Di Amazon Bedrock, Claude Platform on AWS, Google Cloud's Agent Platform, dan Microsoft Foundry, atau dengan fetching dimatikan, keduanya memerlukan Claude Code v2.1.248 atau lebih baru.

88</Note>88</Note>

89 89 

90<h3 id="run-the-built-in-maintenance-prompt">90<h3 id="run-the-built-in-maintenance-prompt">

Details

87Runner melayani satu owner pada satu waktu. Sesi pertama yang diambil runner mengunci runner ke owner sesi itu, dan runner kemudian menjalankan sesi hanya untuk owner itu, hingga kapasitas yang dikonfigurasi. Siapa owner tergantung pada bagaimana sesi dimulai:87Runner melayani satu owner pada satu waktu. Sesi pertama yang diambil runner mengunci runner ke owner sesi itu, dan runner kemudian menjalankan sesi hanya untuk owner itu, hingga kapasitas yang dikonfigurasi. Siapa owner tergantung pada bagaimana sesi dimulai:

88 88 

89* **Sesi yang dimulai pengguna**: owner adalah akun pengguna itu.89* **Sesi yang dimulai pengguna**: owner adalah akun pengguna itu.

90* **Sesi saluran Claude Tag**: Claude menjalankannya tanpa akun pengguna yang terlampir, jadi owner adalah [agen Claude Tag](https://claude.com/docs/claude-tag/concepts/glossary#agent-identity) yang memulai sesi. Setiap sesi saluran yang dimulai agen itu memiliki owner yang sama, siapa pun yang mengirim pesan Slack, jadi runner yang terkunci ke itu melayani sesi yang dimulai orang berbeda ketika Anda menjalankannya pada `--capacity` di atas satu atau dengan `--drain-grace-sec` positif. Runner yang terkunci ke pengguna tidak pernah mengambil ini, dan runner yang terkunci ke agen Claude Tag tidak pernah mengambil sesi pengguna.90* **Sesi saluran Claude Tag**: Claude menjalankannya tanpa akun pengguna yang terlampir, jadi owner adalah [agen Claude Tag](https://claude.com/docs/claude-tag/concepts/glossary#agent-identity) yang memulai sesi. Setiap sesi saluran yang dimulai agen itu memiliki owner yang sama, siapa pun yang mengirim pesan Slack, jadi runner yang terkunci ke itu melayani sesi yang dimulai orang berbeda ketika Anda menjalankannya pada `--capacity` di atas satu atau dengan `--drain-grace-sec` positif.

91 91 

92Ukuran fleet minimum adalah oleh karena itu jumlah owner yang Anda harapkan aktif sekaligus, menghitung pengguna dan agen Claude Tag.92Ukuran fleet minimum adalah oleh karena itu jumlah owner yang Anda harapkan aktif sekaligus, menghitung pengguna dan agen Claude Tag.

93 93 

Details

163 Pengecualian per-kunci di seluruh sumber terkelola163 Pengecualian per-kunci di seluruh sumber terkelola

164</h3>164</h3>

165 165 

166Tiga jenis kunci adalah pengecualian terhadap aturan tanpa penggabungan:166Kunci-kunci ini adalah pengecualian terhadap aturan tanpa penggabungan:

167 167 

168* **Kunci kunci lintas sumber**: serangkaian kecil kunci, seperti kunci daftar pasir sandbox, [tercantum di halaman pengaturan terkelola](/docs/id/managed-settings#precedence-within-the-managed-tier). Claude Code menghormatinya ketika sumber terkelola yang dikendalikan admin apa pun menetapkannya; tingkat registri HKCU yang dapat ditulis pengguna dikecualikan.168* **Kunci kunci lintas sumber**: serangkaian kecil kunci, seperti kunci daftar pasir sandbox, [tercantum di halaman pengaturan terkelola](/docs/id/managed-settings#precedence-within-the-managed-tier). Claude Code menghormatinya ketika sumber terkelola yang dikendalikan admin apa pun menetapkannya; tingkat registri HKCU yang dapat ditulis pengguna dikecualikan.

169 169 


171* **Blok `env`**: terlepas dari unit telemetri dan variabel routing yang dipasangkan dengan kunci kredensial, keduanya dibahas di bawah, blok ini menggabungkan per kunci di seluruh sumber yang dikendalikan admin. Untuk setiap variabel lingkungan, sumber dengan prioritas tertinggi yang mendefinisikannya menang, dan sumber admin yang lebih rendah mengisi variabel yang sumber yang lebih tinggi biarkan tidak diatur. Entri `env` yang dikelola endpoint oleh karena itu berlaku kapan pun konfigurasi yang dikelola server meninggalkan variabel tersebut tidak diatur, atau saat nilai server yang di-cache untuk itu [ditahan menunggu konfirmasi server](#fetch-and-caching-behavior). Memerlukan Claude Code v2.1.223 atau lebih baru. Sebelum v2.1.223, Claude Code menerapkan blok `env` sumber yang dipilih secara keseluruhan saja.171* **Blok `env`**: terlepas dari unit telemetri dan variabel routing yang dipasangkan dengan kunci kredensial, keduanya dibahas di bawah, blok ini menggabungkan per kunci di seluruh sumber yang dikendalikan admin. Untuk setiap variabel lingkungan, sumber dengan prioritas tertinggi yang mendefinisikannya menang, dan sumber admin yang lebih rendah mengisi variabel yang sumber yang lebih tinggi biarkan tidak diatur. Entri `env` yang dikelola endpoint oleh karena itu berlaku kapan pun konfigurasi yang dikelola server meninggalkan variabel tersebut tidak diatur, atau saat nilai server yang di-cache untuk itu [ditahan menunggu konfirmasi server](#fetch-and-caching-behavior). Memerlukan Claude Code v2.1.223 atau lebih baru. Sebelum v2.1.223, Claude Code menerapkan blok `env` sumber yang dipilih secara keseluruhan saja.

172 * **Unit telemetri**: kunci exporter `OTEL_EXPORTER_OTLP_*`, toggle penangkapan konten `OTEL_LOG_*`, `OTEL_LOGS_EXPORTER`, dan variabel tracing beta `ENABLE_BETA_TRACING_DETAILED` dan `BETA_TRACING_ENDPOINT` mengikuti sumber tertinggi yang menetapkan salah satu dari mereka sebagai unit. Sumber yang mengirimkan kunci kredensial `otelHeadersHelper` juga mengklaim unit, tetapi mendarat variabel ini hanya ketika itu adalah sumber yang dipilih: sumber yang tidak dipilih tetapi mengirimkan kunci tidak berkontribusi pada salah satu dari mereka dan masih memblokir sumber yang lebih rendah dari mengisinya. Bagaimanapun, endpoint exporter dari satu sumber tidak pernah dapat dipasangkan dengan kredensial dari sumber lain.172 * **Unit telemetri**: kunci exporter `OTEL_EXPORTER_OTLP_*`, toggle penangkapan konten `OTEL_LOG_*`, `OTEL_LOGS_EXPORTER`, dan variabel tracing beta `ENABLE_BETA_TRACING_DETAILED` dan `BETA_TRACING_ENDPOINT` mengikuti sumber tertinggi yang menetapkan salah satu dari mereka sebagai unit. Sumber yang mengirimkan kunci kredensial `otelHeadersHelper` juga mengklaim unit, tetapi mendarat variabel ini hanya ketika itu adalah sumber yang dipilih: sumber yang tidak dipilih tetapi mengirimkan kunci tidak berkontribusi pada salah satu dari mereka dan masih memblokir sumber yang lebih rendah dari mengisinya. Bagaimanapun, endpoint exporter dari satu sumber tidak pernah dapat dipasangkan dengan kredensial dari sumber lain.

173 * **Routing yang dipasangkan kredensial**: sumber yang memasangkan variabel routing dengan kunci kredensial yang hanya dipilih-sumber, seperti `apiKeyHelper` atau `otelHeadersHelper`, berkontribusi pada variabel routing tersebut hanya ketika itu memenangkan slot.173 * **Routing yang dipasangkan kredensial**: sumber yang memasangkan variabel routing dengan kunci kredensial yang hanya dipilih-sumber, seperti `apiKeyHelper` atau `otelHeadersHelper`, berkontribusi pada variabel routing tersebut hanya ketika itu memenangkan slot.

174* **`allowedProviders`**: daftar yang diatur pada mesin dan daftar yang dikelola server menggabungkan seperti [catatan Scope entri tersebut](/docs/id/settings-reference#allowedproviders) menyatakan. Memerlukan Claude Code v2.1.285 atau lebih baru

174* **Kunci masuk gateway**: Claude Code tidak pernah membaca [`forceLoginGatewayUrl`](/docs/id/settings-reference#forcelogingatewayurl), [`gatewayInternalNetworks`](/docs/id/settings-reference#gatewayinternalnetworks), atau nilai `"gateway"` dari [`forceLoginMethod`](/docs/id/settings-reference#forceloginmethod) dari pengaturan yang dikelola server, jadi nilai di sana tidak berlaku atau menyembunyikan yang diatur dalam kebijakan MDM atau file pengaturan terkelola. Entri [`managedSourcesBehavior`](/docs/id/settings-reference#managedsourcesbehavior) mengatakan sumber admin mana di mesin yang menyediakannya.175* **Kunci masuk gateway**: Claude Code tidak pernah membaca [`forceLoginGatewayUrl`](/docs/id/settings-reference#forcelogingatewayurl), [`gatewayInternalNetworks`](/docs/id/settings-reference#gatewayinternalnetworks), atau nilai `"gateway"` dari [`forceLoginMethod`](/docs/id/settings-reference#forceloginmethod) dari pengaturan yang dikelola server, jadi nilai di sana tidak berlaku atau menyembunyikan yang diatur dalam kebijakan MDM atau file pengaturan terkelola. Entri [`managedSourcesBehavior`](/docs/id/settings-reference#managedsourcesbehavior) mengatakan sumber admin mana di mesin yang menyediakannya.

175 176 

176<h3 id="fetch-and-caching-behavior">177<h3 id="fetch-and-caching-behavior">

sessions.md +20 −2

Details

29 29 

30`claude --continue` membuka [sesi latar belakang](/docs/id/agent-view) yang telah selesai, tetapi bukan yang masih berjalan; membuka sesi latar belakang yang selesai memerlukan Claude Code v2.1.257 atau lebih baru. Jika percakapan terbaru Anda adalah sesi yang [Anda pindahkan ke latar belakang](/docs/id/agent-view#send-the-session-to-the-background) dan masih berjalan di sana, Claude Code keluar dengan `Your most recent conversation is running in the background` dan ID sesi tersebut. Lampirkan ke sesi dari [`claude agents`](/docs/id/agent-view#attach-to-a-session), atau jalankan `claude --resume` untuk memilih yang lain.30`claude --continue` membuka [sesi latar belakang](/docs/id/agent-view) yang telah selesai, tetapi bukan yang masih berjalan; membuka sesi latar belakang yang selesai memerlukan Claude Code v2.1.257 atau lebih baru. Jika percakapan terbaru Anda adalah sesi yang [Anda pindahkan ke latar belakang](/docs/id/agent-view#send-the-session-to-the-background) dan masih berjalan di sana, Claude Code keluar dengan `Your most recent conversation is running in the background` dan ID sesi tersebut. Lampirkan ke sesi dari [`claude agents`](/docs/id/agent-view#attach-to-a-session), atau jalankan `claude --resume` untuk memilih yang lain.

31 31 

32<span id="resume-a-running-background-session" />

33 

34Ketika percakapan yang Anda lanjutkan dengan `claude --resume` atau `/resume` termasuk dalam [sesi latar belakang](/docs/id/agent-view) yang masih berjalan, Claude Code membuka sesi yang berjalan itu sendiri. Dengan `--bg` pada baris perintah, lanjutan adalah [pengiriman latar belakang](/docs/id/agent-view#from-your-shell) sebagai gantinya. Sebelum v2.1.285, Claude Code menolak dan memberi tahu Anda untuk membuka sesi dengan `claude attach <id>`, atau untuk menghentikannya dengan `claude stop <id>` terlebih dahulu.

35 

36* **Dari shell Anda**: `claude --resume <session>` menjalankan [`claude attach`](/docs/id/agent-view#attach-to-a-session) pada sesi tersebut di terminal yang sama daripada memuat transkrip itu sendiri. Prompt yang Anda teruskan pada baris perintah, seperti dalam `claude --resume <session> "check the tests too"`, masuk ke sesi sebagai giliran berikutnya terlebih dahulu, dan Claude Code mencetak `Sent your prompt to the background session (<id>); opening it…` sebelum melampirkan. `claude -p --resume <session> "prompt"` yang diketik di terminal melakukan hal yang sama, jadi `-p` tidak membuat jalankan tersebut non-interaktif.

37 

38 Claude Code tidak membuka sesi ketika baris perintah memiliki salah satu dari ini:

39 

40 * Input atau output yang disalurkan atau dialihkan

41 * Bendera yang mengonfigurasi sesi, seperti `--permission-mode`, `--model`, atau `--settings`

42 * Bendera yang membaca output, seperti `--output-format json` atau `--json-schema`

43 * Bendera yang membatasi atau memundurkan jalankan, seperti `--max-turns` atau `--max-budget-usd`

44 

45 Dengan salah satu dari ini, atau ketika [tampilan agen dimatikan](/docs/id/agent-view#turn-off-agent-view), Claude Code tidak mengirim apa pun dan keluar dengan status 1, mencetak bahwa sesi berjalan di latar belakang bersama dengan perintah `claude attach <id>` yang membukanya, atau memberi tahu Anda untuk menemukannya dalam `claude agents` ketika tidak dapat menentukan ID. Tambahkan `--fork-session` untuk melanjutkan salinan percakapan sebagai gantinya. Untuk melanjutkan percakapan itu sendiri dalam sesi Anda sendiri, dengan bendera Anda diterapkan, jalankan `claude stop <id>` dan kemudian ulangi perintah.

46 

47 Prompt yang dimulai dengan `/` atau `!` tidak dikirim, begitu juga dengan prompt apa pun sementara sesi menunggu jawaban Anda atas pertanyaan. Dalam kedua kasus Claude Code tidak membuka sesi, dan pesan tersebut menyertakan `Your prompt was not sent to it` dengan alasan.

48* **Dari dalam sesi**: `/resume` memindahkan percakapan saat ini Anda ke latar belakang dan melampirkan terminal ini ke sesi yang berjalan, mencetak `Opening "<title>", running in the background (<id>)`. Tekan `←` pada prompt kosong untuk kembali ke tampilan agen, yang juga mencantumkan percakapan yang Anda tinggalkan. Ketika percakapan saat ini tidak dapat pindah ke latar belakang, misalnya karena Anda sudah dilampirkan ke sesi latar belakang atau persistensi sesi dimatikan, `/resume` mencetak perintah `claude attach` untuk dijalankan sebagai gantinya.

49 

32Anda dapat menjalankan `claude --resume <session-id>` dari direktori mana pun: Claude Code mencari ID di direktori proyek saat ini dan git worktrees-nya terlebih dahulu, kemudian di setiap proyek lain di mesin ini, sehingga menemukan sesi yang dimulai di tempat lain atau dipindahkan dengan [`/cd`](/docs/id/commands). Pencarian lintas proyek menyelesaikan ID hanya ketika tepat satu proyek lain menyimpan transkrip dengan pesan untuknya, sehingga duplikat yang disalin tangan membuat Claude Code melaporkan tidak ditemukan daripada melanjutkan salinan arbitrer. Jika tidak ada sesi yang disimpan cocok dengan ID, Claude Code melaporkan `No conversation found with session ID: <session-id>`. Sebelum v2.1.223, pencarian berhenti di direktori proyek saat ini dan git worktrees-nya, jadi Anda harus melanjutkan dari direktori tempat sesi terakhir bekerja.50Anda dapat menjalankan `claude --resume <session-id>` dari direktori mana pun: Claude Code mencari ID di direktori proyek saat ini dan git worktrees-nya terlebih dahulu, kemudian di setiap proyek lain di mesin ini, sehingga menemukan sesi yang dimulai di tempat lain atau dipindahkan dengan [`/cd`](/docs/id/commands). Pencarian lintas proyek menyelesaikan ID hanya ketika tepat satu proyek lain menyimpan transkrip dengan pesan untuknya, sehingga duplikat yang disalin tangan membuat Claude Code melaporkan tidak ditemukan daripada melanjutkan salinan arbitrer. Jika tidak ada sesi yang disimpan cocok dengan ID, Claude Code melaporkan `No conversation found with session ID: <session-id>`. Sebelum v2.1.223, pencarian berhenti di direktori proyek saat ini dan git worktrees-nya, jadi Anda harus melanjutkan dari direktori tempat sesi terakhir bekerja.

33 51 

34<h3 id="what-a-resumed-session-restores">52<h3 id="what-a-resumed-session-restores">

35 Apa yang dipulihkan sesi yang dilanjutkan53 Apa yang dipulihkan sesi yang dilanjutkan

36</h3>54</h3>

37 55 

38Sesi yang dilanjutkan memulihkan percakapan bersama dengan status yang disimpan di dalamnya:56Ketika Claude Code memuat percakapan dari transkrip-nya, sesi yang dilanjutkan memulihkan percakapan bersama dengan status yang disimpan di dalamnya:

39 57 

40* Riwayat percakapan: riwayat lengkap, termasuk panggilan alat dan hasil. Alat yang masih berjalan ketika proses sebelumnya berakhir, misalnya dalam kerusakan, tidak selesai atau berjalan lagi ketika Anda melanjutkan. Claude melihat panggilan yang ditandai sebagai terputus sebelum hasilnya dicatat dan diberitahu untuk memeriksa apakah itu berlaku sebelum menjalankannya lagi, kecuali [`CLAUDE_CODE_RESUME_INTERRUPTED_TURN`](/docs/id/env-vars#variables) diatur. Sebelum v2.1.281, Claude Code menghapus panggilan yang terputus dari percakapan atau menampilkannya kepada Claude sebagai yang Anda interupsi.58* Riwayat percakapan: riwayat lengkap, termasuk panggilan alat dan hasil. Alat yang masih berjalan ketika proses sebelumnya berakhir, misalnya dalam kerusakan, tidak selesai atau berjalan lagi ketika Anda melanjutkan. Claude melihat panggilan yang ditandai sebagai terputus sebelum hasilnya dicatat dan diberitahu untuk memeriksa apakah itu berlaku sebelum menjalankannya lagi, kecuali [`CLAUDE_CODE_RESUME_INTERRUPTED_TURN`](/docs/id/env-vars#variables) diatur. Sebelum v2.1.281, Claude Code menghapus panggilan yang terputus dari percakapan atau menampilkannya kepada Claude sebagai yang Anda interupsi.

41* Model: sesi berlanjut pada model yang digunakannya. Model tidak dipulihkan ketika telah pensiun atau tidak diizinkan oleh `availableModels`, ketika bendera `--model` atau variabel lingkungan keluarga `ANTHROPIC_MODEL` memilih satu saat peluncuran, atau pada penyedia yang menggunakan ID penerapan khusus penyedia, seperti [Amazon Bedrock, Google Cloud's Agent Platform, dan Microsoft Foundry](/docs/id/third-party-integrations); lihat [konfigurasi model](/docs/id/model-config#setting-your-model) untuk urutan resolusi.59* Model: sesi berlanjut pada model yang digunakannya. Model tidak dipulihkan ketika telah pensiun atau tidak diizinkan oleh `availableModels`, ketika bendera `--model` atau variabel lingkungan keluarga `ANTHROPIC_MODEL` memilih satu saat peluncuran, atau pada penyedia yang menggunakan ID penerapan khusus penyedia, seperti [Amazon Bedrock, Google Cloud's Agent Platform, dan Microsoft Foundry](/docs/id/third-party-integrations); lihat [konfigurasi model](/docs/id/model-config#setting-your-model) untuk urutan resolusi.


51 Mode izin saat melanjutkan69 Mode izin saat melanjutkan

52</h4>70</h4>

53 71 

54Mode izin mana yang dimulai Claude Code dalam sesi yang dilanjutkan tergantung pada cara Anda melanjutkan:72Kasus-kasus di bawah berlaku ketika Claude Code memuat percakapan dari transkrip-nya; ketika Anda [membuka sesi latar belakang yang masih berjalan](#resume-a-running-background-session) sebagai gantinya, sesi tersebut mempertahankan mode izin yang ada di dalamnya.

55 73 

56* Terminal: `claude --continue`, `claude --resume <session-id>`, atau `claude --resume <name>` ketika nama cocok dengan satu sesi, tanpa `-p`. Claude Code memulihkan mode izin yang ada di sesi, kecuali dalam kasus di tabel. Teruskan `--permission-mode` atau `--dangerously-skip-permissions` untuk mengganti mode yang dipulihkan.74* Terminal: `claude --continue`, `claude --resume <session-id>`, atau `claude --resume <name>` ketika nama cocok dengan satu sesi, tanpa `-p`. Claude Code memulihkan mode izin yang ada di sesi, kecuali dalam kasus di tabel. Teruskan `--permission-mode` atau `--dangerously-skip-permissions` untuk mengganti mode yang dipulihkan.

57* Non-interaktif: `claude -p --resume` atau `claude -p --continue`. Claude Code memulai jalankan dalam mode izin yang akan dimulai oleh jalankan `claude -p` baru, kecuali sesi yang berakhir dalam mode rencana dilanjutkan dalam mode rencana di bawah [kondisi di bawah](#resume-in-plan-mode-with-p).75* Non-interaktif: `claude -p --resume` atau `claude -p --continue`. Claude Code memulai jalankan dalam mode izin yang akan dimulai oleh jalankan `claude -p` baru, kecuali sesi yang berakhir dalam mode rencana dilanjutkan dalam mode rencana di bawah [kondisi di bawah](#resume-in-plan-mode-with-p).

Details

599| [`allowedChannelPlugins`](#allowedchannelplugins) | Ganti daftar izin default [plugin channel](/docs/id/channels#restrict-which-channel-plugins-can-run) yang dapat mendorong pesan | Plugins and skills | Managed |599| [`allowedChannelPlugins`](#allowedchannelplugins) | Ganti daftar izin default [plugin channel](/docs/id/channels#restrict-which-channel-plugins-can-run) yang dapat mendorong pesan | Plugins and skills | Managed |

600| [`allowedHttpHookUrls`](#allowedhttphookurls) | Batasi URL mana yang dapat ditargetkan oleh [HTTP hooks](/docs/id/hooks) | Hooks and automation | Any file |600| [`allowedHttpHookUrls`](#allowedhttphookurls) | Batasi URL mana yang dapat ditargetkan oleh [HTTP hooks](/docs/id/hooks) | Hooks and automation | Any file |

601| [`allowedMcpServers`](#allowedmcpservers) | Daftar izin server [MCP](/docs/id/mcp) mana yang dapat ditambahkan pengguna | MCP | Any file |601| [`allowedMcpServers`](#allowedmcpservers) | Daftar izin server [MCP](/docs/id/mcp) mana yang dapat ditambahkan pengguna | MCP | Any file |

602| [`allowedProviders`](#allowedproviders) | Batasi [penyedia API](/docs/id/third-party-integrations) mana yang dapat digunakan mesin | Authentication and providers | Managed |

602| [`allowManagedHooksOnly`](#allowmanagedhooksonly) | Jalankan hanya [hooks](/docs/id/hooks) yang organisasi Anda terapkan | Hooks and automation | Managed |603| [`allowManagedHooksOnly`](#allowmanagedhooksonly) | Jalankan hanya [hooks](/docs/id/hooks) yang organisasi Anda terapkan | Hooks and automation | Managed |

603| [`allowManagedMcpServersOnly`](#allowmanagedmcpserversonly) | Buat daftar izin [MCP](/docs/id/mcp) yang dikelola menjadi satu-satunya yang berlaku | MCP | Managed |604| [`allowManagedMcpServersOnly`](#allowmanagedmcpserversonly) | Buat daftar izin [MCP](/docs/id/mcp) yang dikelola menjadi satu-satunya yang berlaku | MCP | Managed |

604| [`allowManagedPermissionRulesOnly`](#allowmanagedpermissionrulesonly) | Buat [pengaturan yang dikelola](/docs/id/managed-settings) menjadi satu-satunya sumber pengaturan [aturan izin](/docs/id/permissions#managed-settings) | Permission settings | Managed |605| [`allowManagedPermissionRulesOnly`](#allowmanagedpermissionrulesonly) | Buat [pengaturan yang dikelola](/docs/id/managed-settings) menjadi satu-satunya sumber pengaturan [aturan izin](/docs/id/permissions#managed-settings) | Permission settings | Managed |


3675 `spinnerTipsOverride`3676 `spinnerTipsOverride`

3676</h3>3677</h3>

3677 3678 

3678Tambahkan 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: ia memilih tip yang belum ditampilkan paling lama, melewati tips masih dalam cooldown mereka, dan memecahkan seri berdasarkan prioritas.3679Tambahkan 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.

3679 3680 

3680Jika Anda mengatur [`spinnerTipsEnabled`](#spinnertipsenabled) ke `false`, Claude Code menyembunyikan semua tips, milik Anda termasuk.3681Jika Anda mengatur [`spinnerTipsEnabled`](#spinnertipsenabled) ke `false`, Claude Code menyembunyikan semua tips, milik Anda termasuk.

3681 3682 


3683* **Type**: object dengan field `tips`, `tipsFile`, `label`, dan `excludeDefault`, masing-masing opsional3684* **Type**: object dengan field `tips`, `tipsFile`, `label`, dan `excludeDefault`, masing-masing opsional

3684* **Default**: unset, jadi Claude Code hanya menampilkan tips bawaan3685* **Default**: unset, jadi Claude Code hanya menampilkan tips bawaan

3685 3686 

3686Objek 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. Pada versi sebelumnya, `excludeDefault` file proyek atau lokal juga berlaku.3687Objek 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.

3687 3688 

3688Setiap entri `tips` adalah string biasa atau objek dengan field ini:3689Setiap entri `tips` adalah string biasa atau objek dengan field ini:

3689 3690 


5653 5654 

5654* **Scope**: [`Any file`](#scopes)5655* **Scope**: [`Any file`](#scopes)

5655* **Type**: Boolean5656* **Type**: Boolean

5656 * `true`: Claude Code mematikan alat Artifact untuk setiap sesi yang berlaku file, dan tidak ada file lain yang menghidupkannya kembali. Sebelum v2.1.242, file dengan prioritas lebih tinggi dapat mengganti `true` file yang lebih rendah daripada kunci bertindak sebagai kunci5657 * `true`: Claude Code mematikan alat Artifact untuk setiap sesi yang berlaku file, dan tidak ada file lain yang menghidupkannya kembali

5657 * `false`: diabaikan; untuk membiarkan alat tetap aktif, hapus kunci5658 * `false`: diabaikan; untuk membiarkan alat tetap aktif, hapus kunci

5658* **Default**: unset, jadi alat mengikuti [availability](/docs/id/artifacts#availability) akun Anda5659* **Default**: unset, jadi alat mengikuti [availability](/docs/id/artifacts#availability) akun Anda

5659* **Per-session overrides**: [`CLAUDE_CODE_DISABLE_ARTIFACT`](/docs/id/env-vars) diatur ke `1` mematikan alat untuk satu sesi5660* **Per-session overrides**: [`CLAUDE_CODE_DISABLE_ARTIFACT`](/docs/id/env-vars) diatur ke `1` mematikan alat untuk satu sesi


5740}5741}

5741```5742```

5742 5743 

5743Sementara 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](/docs/id/artifacts#disable-artifacts) mencantumkan setiap cara untuk mematikan alat. Sebelum v2.1.242, Claude Code mengabaikan kunci ini dalam pengaturan proyek dan lokal, dan file yang lebih tinggi dalam [stack prioritas](/docs/id/settings#settings-precedence) dapat menghidupkan alat kembali atas file yang lebih rendah.5744Sementara 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](/docs/id/artifacts#disable-artifacts) mencantumkan setiap cara untuk mematikan alat.

5744 5745 

5745<h3 id="inputneedednotifenabled">5746<h3 id="inputneedednotifenabled">

5746 `inputNeededNotifEnabled`5747 `inputNeededNotifEnabled`


5879 5880 

5880Berikan kredensial melalui skrip pembantu dan, untuk organisasi, paksa metode login atau organisasi. Lihat [Autentikasi](/docs/id/authentication).5881Berikan kredensial melalui skrip pembantu dan, untuk organisasi, paksa metode login atau organisasi. Lihat [Autentikasi](/docs/id/authentication).

5881 5882 

5883<h3 id="allowedproviders">

5884 `allowedProviders`

5885</h3>

5886 

5887Daftarkan 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](/docs/id/errors#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.

5888 

5889* **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](/docs/id/managed-settings#how-claude-code-combines-managed-sources). Daftar yang disampaikan melalui pengaturan terkelola server saja mencapai hanya sesi yang [mengambil pengaturan terkelola server](/docs/id/server-managed-settings#platform-availability).

5890* **Type**: array string, masing-masing satu dari:

5891 * `"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

5892 * `"bedrock"`: [Amazon Bedrock](/docs/id/amazon-bedrock)

5893 * `"vertex"`: [Agent Platform Google Cloud](/docs/id/google-vertex-ai), sebelumnya Vertex AI

5894 * `"foundry"`: [Microsoft Foundry](/docs/id/microsoft-foundry)

5895 * `"anthropicAws"`: [Claude Platform di AWS](/docs/id/claude-platform-on-aws)

5896 * `"mantle"`: endpoint [Mantle](/docs/id/amazon-bedrock#use-the-mantle-endpoint) Amazon Bedrock. Sesi yang [menjalankan Mantle bersama Invoke API](/docs/id/amazon-bedrock#run-mantle-alongside-the-invoke-api) menggunakan kedua penyedia, jadi daftarkan `"bedrock"` dan `"mantle"` bersama untuk itu

5897 * `"customEndpoint"`: API Anthropic atau API penyedia cloud yang dikirim ke host lain, seperti [gateway LLM](/docs/id/llm-gateway) yang dinamai oleh `ANTHROPIC_BASE_URL`, variabel `ANTHROPIC_*_BASE_URL` penyedia, atau nilai `ANTHROPIC_FOUNDRY_RESOURCE` yang bukan nama sumber daya bare. Claude Code mengakuinya hanya untuk nilai yang tepat yang blok [`env`](#env) terkelola pin

5898 * `"gateway"`: sign-in [Cloud gateway](/docs/id/claude-apps-gateway)

5899* **Default**: tidak diatur, jadi penyedia apa pun dapat digunakan

5900 

5901```json managed-settings.json theme={null}

5902{

5903 "allowedProviders": ["anthropic", "bedrock"]

5904}

5905```

5906 

5907Entri setiap penyedia cloud berarti layanan penyedia itu sendiri, termasuk endpoint regional, FIPS, dan privatnya.

5908 

5909Entri 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.

5910 

5911<h4 id="endpoints-that-need-a-pin-in-managed-env">

5912 Endpoint yang memerlukan pin dalam `env` terkelola

5913</h4>

5914 

5915Pin 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:

5916 

5917* **Sesi `"customEndpoint"`**: variabel yang menyebutkan host, seperti `ANTHROPIC_BASE_URL`

5918* **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"`

5919* **URL sign-in gateway**: sesi tetap di bawah `"gateway"`, dan [`forceLoginGatewayUrl`](#forcelogingatewayurl) juga dihitung sebagai pin

5920 

5921Blok `env` mana yang dihitung sebagai pin tergantung pada tempat daftar diatur:

5922 

5923* **Sumber administrator di mesin mengatur daftar**: hanya blok `env` dari sumber administrator mesin sendiri yang dihitung

5924* **Hanya pengaturan terkelola server yang mengatur daftar**: nilai `env` dalam pengaturan terkelola server itu juga dihitung

5925 

5926Daftar 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.

5927 

5882<h3 id="apikeyhelper">5928<h3 id="apikeyhelper">

5883 `apiKeyHelper`5929 `apiKeyHelper`

5884</h3>5930</h3>


6401| :- | :- | :- |6447| :- | :- | :- |

6402| Lists | Menggabungkan entri dari setiap sumber | [`permissions.allow`](#permissions-allow), [`sandbox.network.allowedDomains`](#sandbox-network-alloweddomains), dan kunci daftar lainnya |6448| Lists | Menggabungkan entri dari setiap sumber | [`permissions.allow`](#permissions-allow), [`sandbox.network.allowedDomains`](#sandbox-network-alloweddomains), dan kunci daftar lainnya |

6403| 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 |6449| 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 |

6404| 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), [`strictKnownMarketplaces`](#strictknownmarketplaces), [`allowedChannelPlugins`](#allowedchannelplugins), dan rantai [`fallbackModel`](#fallbackmodel) |6450| 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) |

6405| 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) |6451| 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) |

6406| 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) |6452| 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) |

6407| 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) |6453| 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) |


6415* **[`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.6461* **[`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.

6416* **[`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.6462* **[`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.

6417* **[`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.6463* **[`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.

6464* **[`allowedProviders`](#allowedproviders)**: setelah aturan tabel, daftar mesin itu sendiri masih membatasi hasilnya, seperti yang dinyatakan catatan Scope entrinya.

6418 6465 

6419Untuk mengonfirmasi sumber mana yang digabungkan di mesin, jalankan `/status` dan [baca baris `Setting sources`](/docs/id/managed-settings#read-the-source-in-/status).6466Untuk mengonfirmasi sumber mana yang digabungkan di mesin, jalankan `/status` dan [baca baris `Setting sources`](/docs/id/managed-settings#read-the-source-in-/status).

6420 6467 

skills.md +1 −1

Details

740 740 

741* **Direktori kerja**: Claude Code menjalankan setiap perintah di direktori kerja shell sesi saat ini. Direktori itu bergerak ketika Claude menjalankan `cd`. Gunakan [`${CLAUDE_SKILL_DIR}` atau `${CLAUDE_PROJECT_DIR}`](#available-string-substitutions) dalam path yang harus diselesaikan dengan cara yang sama setiap kali.741* **Direktori kerja**: Claude Code menjalankan setiap perintah di direktori kerja shell sesi saat ini. Direktori itu bergerak ketika Claude menjalankan `cd`. Gunakan [`${CLAUDE_SKILL_DIR}` atau `${CLAUDE_PROJECT_DIR}`](#available-string-substitutions) dalam path yang harus diselesaikan dengan cara yang sama setiap kali.

742* **stderr**: dengan shell `bash` default, Claude Code menggabungkan stderr ke stdout. Apa pun yang ditulis perintah ke stderr muncul dalam teks yang diinjeksi.742* **stderr**: dengan shell `bash` default, Claude Code menggabungkan stderr ke stdout. Apa pun yang ditulis perintah ke stderr muncul dalam teks yang diinjeksi.

743* **Timeout**: setiap perintah berjalan di bawah [timeout](/docs/id/tools-reference#timeout-and-output-limits) default 2 menit alat Bash. Ketika alat Bash [memindahkan perintah yang kedaluwarsa ke latar belakang](/docs/id/tools-reference#background-commands), skill masih dirender. Teks yang diinjeksi melaporkan perpindahan dan menamai tugas latar belakang dan file yang mengumpulkan output perintah. Ketika perintah adalah salah satu yang tidak pernah dilatarbelakangkan oleh alat Bash, Claude Code membunuhnya pada timeout. Kegagalan itu [membatalkan invokasi](#when-an-injected-command-fails).743* **Timeout**: setiap perintah berjalan di bawah [timeout](/docs/id/tools-reference#timeout-and-output-limits) default 2 menit alat Bash. Ketika alat Bash [memindahkan perintah yang kedaluwarsa ke latar belakang](/docs/id/tools-reference#foreground-commands-that-move-to-the-background), skill masih dirender. Teks yang diinjeksi melaporkan perpindahan dan menamai tugas latar belakang dan file yang mengumpulkan output perintah. Ketika perintah adalah salah satu yang tidak pernah dilatarbelakangkan oleh alat Bash, Claude Code membunuhnya pada timeout. Kegagalan itu [membatalkan invokasi](#when-an-injected-command-fails).

744* **Ukuran output**: output melampaui batas inline alat Bash tiba sebagai jalur file plus pratinjau singkat, bukan teks terpotong. [Output limits](/docs/id/tools-reference#output-limits) mencakup batas dan cara menyesuaikan setiap batas.744* **Ukuran output**: output melampaui batas inline alat Bash tiba sebagai jalur file plus pratinjau singkat, bukan teks terpotong. [Output limits](/docs/id/tools-reference#output-limits) mencakup batas dan cara menyesuaikan setiap batas.

745 745 

746Alat PowerShell menerapkan perilaku timeout, backgrounding, dan output-ceiling yang sama pada perintah yang dijalankannya. Lihat bagian [alat PowerShell](/docs/id/tools-reference#powershell-tool) untuk spesifikasinya.746Alat PowerShell menerapkan perilaku timeout, backgrounding, dan output-ceiling yang sama pada perintah yang dijalankannya. Lihat bagian [alat PowerShell](/docs/id/tools-reference#powershell-tool) untuk spesifikasinya.

statusline.md +7 −7

Details

20Berikut adalah contoh [baris status multi-baris](#display-multiple-lines) yang menampilkan informasi git di baris pertama dan bilah konteks berkode warna di baris kedua.20Berikut adalah contoh [baris status multi-baris](#display-multiple-lines) yang menampilkan informasi git di baris pertama dan bilah konteks berkode warna di baris kedua.

21 21 

22<Frame>22<Frame>

23 <img src="https://mintcdn.com/claude-code/nibzesLaJVh4ydOq/images/statusline-multiline.png?fit=max&auto=format&n=nibzesLaJVh4ydOq&q=85&s=60f11387658acc9ff75158ae85f2ac87" alt="Baris status multi-baris yang menampilkan nama model, direktori, cabang git di baris pertama, dan bilah kemajuan penggunaan konteks dengan biaya dan durasi di baris kedua" width="776" height="212" data-path="images/statusline-multiline.png" />23 <img src="https://mintcdn.com/claude-code/HDAmBwgbrZVk0pOt/images/statusline-multiline.png?fit=max&auto=format&n=HDAmBwgbrZVk0pOt&q=85&s=a9d0a2fe8e446d80b1abc46da3f93270" alt="Baris status multi-baris yang menampilkan nama model, direktori, cabang git di baris pertama, dan bilah kemajuan penggunaan konteks dengan biaya dan durasi di baris kedua" width="1224" height="262" data-path="images/statusline-multiline.png" />

24</Frame>24</Frame>

25 25 

26Halaman ini memandu Anda melalui [pengaturan baris status dasar](#set-up-a-status-line), menjelaskan [bagaimana aliran data](#how-status-lines-work) dari Claude Code ke skrip Anda, mencantumkan [semua bidang yang dapat Anda tampilkan](#available-data), dan menyediakan [contoh siap pakai](#examples) untuk pola umum seperti status git, pelacakan biaya, dan bilah kemajuan.26Halaman ini memandu Anda melalui [pengaturan baris status dasar](#set-up-a-status-line), menjelaskan [bagaimana aliran data](#how-status-lines-work) dari Claude Code ke skrip Anda, mencantumkan [semua bidang yang dapat Anda tampilkan](#available-data), dan menyediakan [contoh siap pakai](#examples) untuk pola umum seperti status git, pelacakan biaya, dan bilah kemajuan.


93Contoh-contoh ini menggunakan skrip Bash, yang berfungsi di macOS dan Linux. Di Windows, lihat [Konfigurasi Windows](#windows-configuration) untuk contoh PowerShell dan Git Bash.93Contoh-contoh ini menggunakan skrip Bash, yang berfungsi di macOS dan Linux. Di Windows, lihat [Konfigurasi Windows](#windows-configuration) untuk contoh PowerShell dan Git Bash.

94 94 

95<Frame>95<Frame>

96 <img src="https://mintcdn.com/claude-code/nibzesLaJVh4ydOq/images/statusline-quickstart.png?fit=max&auto=format&n=nibzesLaJVh4ydOq&q=85&s=696445e59ca0059213250651ad23db6b" alt="Baris status yang menampilkan nama model, direktori, dan persentase konteks" width="726" height="164" data-path="images/statusline-quickstart.png" />96 <img src="https://mintcdn.com/claude-code/HDAmBwgbrZVk0pOt/images/statusline-quickstart.png?fit=max&auto=format&n=HDAmBwgbrZVk0pOt&q=85&s=88a7eab9c1038dd098ee8e284d96b7e6" alt="Baris status yang menampilkan nama model, direktori, dan persentase konteks" width="1224" height="224" data-path="images/statusline-quickstart.png" />

97</Frame>97</Frame>

98 98 

99<Steps>99<Steps>


444Tampilkan model saat ini dan penggunaan jendela konteks dengan bilah kemajuan visual. Setiap skrip membaca JSON dari stdin, mengekstrak bidang `used_percentage`, dan membangun bilah 10 karakter di mana blok yang diisi (▓) mewakili penggunaan:444Tampilkan model saat ini dan penggunaan jendela konteks dengan bilah kemajuan visual. Setiap skrip membaca JSON dari stdin, mengekstrak bidang `used_percentage`, dan membangun bilah 10 karakter di mana blok yang diisi (▓) mewakili penggunaan:

445 445 

446<Frame>446<Frame>

447 <img src="https://mintcdn.com/claude-code/nibzesLaJVh4ydOq/images/statusline-context-window-usage.png?fit=max&auto=format&n=nibzesLaJVh4ydOq&q=85&s=15b58ab3602f036939145dde3165c6f7" alt="Baris status yang menampilkan nama model dan bilah kemajuan dengan persentase" width="448" height="152" data-path="images/statusline-context-window-usage.png" />447 <img src="https://mintcdn.com/claude-code/HDAmBwgbrZVk0pOt/images/statusline-context-window-usage.png?fit=max&auto=format&n=HDAmBwgbrZVk0pOt&q=85&s=f3918a549912dc47e90f2b69e68bc847" alt="Baris status yang menampilkan nama model dan bilah kemajuan dengan persentase" width="1224" height="224" data-path="images/statusline-context-window-usage.png" />

448</Frame>448</Frame>

449 449 

450<CodeGroup>450<CodeGroup>


513Tampilkan cabang git dengan indikator berkode warna untuk file yang dipentingkan dan dimodifikasi. Skrip ini menggunakan [kode escape ANSI](https://en.wikipedia.org/wiki/ANSI_escape_code#Colors) untuk warna terminal: `\033[32m` adalah hijau, `\033[33m` adalah kuning, dan `\033[0m` mengatur ulang ke default.513Tampilkan cabang git dengan indikator berkode warna untuk file yang dipentingkan dan dimodifikasi. Skrip ini menggunakan [kode escape ANSI](https://en.wikipedia.org/wiki/ANSI_escape_code#Colors) untuk warna terminal: `\033[32m` adalah hijau, `\033[33m` adalah kuning, dan `\033[0m` mengatur ulang ke default.

514 514 

515<Frame>515<Frame>

516 <img src="https://mintcdn.com/claude-code/nibzesLaJVh4ydOq/images/statusline-git-context.png?fit=max&auto=format&n=nibzesLaJVh4ydOq&q=85&s=e656f34f90d1d9a1d0e220988914345f" alt="Baris status yang menampilkan model, direktori, cabang git, dan indikator berkode warna untuk file yang dipentingkan dan dimodifikasi" width="742" height="178" data-path="images/statusline-git-context.png" />516 <img src="https://mintcdn.com/claude-code/HDAmBwgbrZVk0pOt/images/statusline-git-context.png?fit=max&auto=format&n=HDAmBwgbrZVk0pOt&q=85&s=f13c190724d9ec7188c17cd2f98b7bf4" alt="Baris status yang menampilkan model, direktori, cabang git, dan indikator berkode warna untuk file yang dipentingkan dan dimodifikasi" width="1224" height="224" data-path="images/statusline-git-context.png" />

517</Frame>517</Frame>

518 518 

519Setiap skrip memeriksa apakah direktori saat ini adalah repositori git, menghitung file yang dipentingkan dan dimodifikasi, dan menampilkan indikator berkode warna:519Setiap skrip memeriksa apakah direktori saat ini adalah repositori git, menghitung file yang dipentingkan dan dimodifikasi, dan menampilkan indikator berkode warna:


611Setiap skrip memformat biaya sebagai mata uang dan mengonversi milidetik ke menit dan detik:611Setiap skrip memformat biaya sebagai mata uang dan mengonversi milidetik ke menit dan detik:

612 612 

613<Frame>613<Frame>

614 <img src="https://mintcdn.com/claude-code/nibzesLaJVh4ydOq/images/statusline-cost-tracking.png?fit=max&auto=format&n=nibzesLaJVh4ydOq&q=85&s=e3444a51fe6f3440c134bd5f1f08ad29" alt="Baris status yang menampilkan nama model, biaya sesi, dan durasi" width="588" height="180" data-path="images/statusline-cost-tracking.png" />614 <img src="https://mintcdn.com/claude-code/HDAmBwgbrZVk0pOt/images/statusline-cost-tracking.png?fit=max&auto=format&n=HDAmBwgbrZVk0pOt&q=85&s=925f7024c3b38be0f0eca63564bfb52f" alt="Baris status yang menampilkan nama model, biaya sesi, dan durasi" width="1224" height="224" data-path="images/statusline-cost-tracking.png" />

615</Frame>615</Frame>

616 616 

617<CodeGroup>617<CodeGroup>


672Skrip Anda dapat menampilkan beberapa baris untuk membuat tampilan yang lebih kaya.672Skrip Anda dapat menampilkan beberapa baris untuk membuat tampilan yang lebih kaya.

673 673 

674<Frame>674<Frame>

675 <img src="https://mintcdn.com/claude-code/nibzesLaJVh4ydOq/images/statusline-multiline.png?fit=max&auto=format&n=nibzesLaJVh4ydOq&q=85&s=60f11387658acc9ff75158ae85f2ac87" alt="Baris status multi-baris yang menampilkan nama model, direktori, cabang git di baris pertama, dan bilah kemajuan penggunaan konteks dengan biaya dan durasi di baris kedua" width="776" height="212" data-path="images/statusline-multiline.png" />675 <img src="https://mintcdn.com/claude-code/HDAmBwgbrZVk0pOt/images/statusline-multiline.png?fit=max&auto=format&n=HDAmBwgbrZVk0pOt&q=85&s=a9d0a2fe8e446d80b1abc46da3f93270" alt="Baris status multi-baris yang menampilkan nama model, direktori, cabang git di baris pertama, dan bilah kemajuan penggunaan konteks dengan biaya dan durasi di baris kedua" width="1224" height="262" data-path="images/statusline-multiline.png" />

676</Frame>676</Frame>

677 677 

678Contoh ini menggabungkan beberapa teknik: warna berbasis ambang batas (hijau di bawah 70%, kuning 70-89%, merah 90%+), bilah kemajuan, dan informasi cabang git. Setiap pernyataan `print` atau `echo` membuat baris terpisah:678Contoh ini menggabungkan beberapa teknik: warna berbasis ambang batas (hijau di bawah 70%, kuning 70-89%, merah 90%+), bilah kemajuan, dan informasi cabang git. Setiap pernyataan `print` atau `echo` membuat baris terpisah:


781Contoh ini membuat tautan yang dapat diklik ke repositori GitHub Anda. Tahan Cmd (macOS) atau Ctrl (Windows/Linux) dan klik untuk membuka tautan di browser Anda.781Contoh ini membuat tautan yang dapat diklik ke repositori GitHub Anda. Tahan Cmd (macOS) atau Ctrl (Windows/Linux) dan klik untuk membuka tautan di browser Anda.

782 782 

783<Frame>783<Frame>

784 <img src="https://mintcdn.com/claude-code/nibzesLaJVh4ydOq/images/statusline-links.png?fit=max&auto=format&n=nibzesLaJVh4ydOq&q=85&s=4bcc6e7deb7cf52f41ab85a219b52661" alt="Baris status yang menampilkan tautan yang dapat diklik ke repositori GitHub" width="726" height="198" data-path="images/statusline-links.png" />784 <img src="https://mintcdn.com/claude-code/HDAmBwgbrZVk0pOt/images/statusline-links.png?fit=max&auto=format&n=HDAmBwgbrZVk0pOt&q=85&s=4778a144a28cb498c99d5fa018bb374a" alt="Baris status yang menampilkan tautan yang dapat diklik ke repositori GitHub" width="1224" height="224" data-path="images/statusline-links.png" />

785</Frame>785</Frame>

786 786 

787Setiap skrip mendapatkan URL remote git, mengonversi format SSH ke HTTPS, dan membungkus nama repo dalam kode escape OSC 8. Versi Bash menggunakan `printf '%b'` yang menginterpretasikan escape backslash lebih andal daripada `echo -e` di berbagai shell:787Setiap skrip mendapatkan URL remote git, mengonversi format SSH ke HTTPS, dan membungkus nama repo dalam kode escape OSC 8. Versi Bash menggunakan `printf '%b'` yang menginterpretasikan escape backslash lebih andal daripada `echo -e` di berbagai shell:

Details

253 253 

254Tim keamanan dapat mengonfigurasi izin terkelola untuk apa yang Claude Code diizinkan dan tidak diizinkan untuk lakukan, yang tidak dapat ditimpa oleh konfigurasi lokal. [Pelajari lebih lanjut](/docs/id/security).254Tim keamanan dapat mengonfigurasi izin terkelola untuk apa yang Claude Code diizinkan dan tidak diizinkan untuk lakukan, yang tidak dapat ditimpa oleh konfigurasi lokal. [Pelajari lebih lanjut](/docs/id/security).

255 255 

256Untuk membatasi opsi penyebaran mana yang dapat digunakan mesin terkelola, atur [`allowedProviders`](/docs/id/settings-reference#allowedproviders) dalam pengaturan terkelola. Misalnya, `["bedrock"]` memungkinkan Amazon Bedrock dan tidak ada yang lain; armada Bedrock yang juga mengaktifkan titik akhir Mantle mencantumkan `"mantle"` juga. Entri mengatakan variabel titik akhir mana yang juga memerlukan pin `env` terkelola. Memerlukan Claude Code v2.1.285 atau lebih baru.

257 

256<h3 id="leverage-mcp-for-integrations">258<h3 id="leverage-mcp-for-integrations">

257 Manfaatkan MCP untuk integrasi259 Manfaatkan MCP untuk integrasi

258</h3>260</h3>

tools-reference.md +42 −27

Details

164Aktifkan virtualenv atau lingkungan conda Anda sebelum meluncurkan Claude Code. Untuk membuat variabel lingkungan bertahan di seluruh perintah Bash, atur [`CLAUDE_ENV_FILE`](/docs/id/env-vars) ke skrip shell sebelum meluncurkan Claude Code, atau gunakan [hook SessionStart](/docs/id/hooks#persist-environment-variables) untuk mengisinya secara dinamis.164Aktifkan virtualenv atau lingkungan conda Anda sebelum meluncurkan Claude Code. Untuk membuat variabel lingkungan bertahan di seluruh perintah Bash, atur [`CLAUDE_ENV_FILE`](/docs/id/env-vars) ke skrip shell sebelum meluncurkan Claude Code, atau gunakan [hook SessionStart](/docs/id/hooks#persist-environment-variables) untuk mengisinya secara dinamis.

165 165 

166<h3 id="timeout-and-output-limits">166<h3 id="timeout-and-output-limits">

167 Batas waktu dan output167 Batas waktu dan batas keluaran

168</h3>168</h3>

169 169 

170Setiap perintah berjalan di bawah batas waktu, dan Claude mengelolanya: ketika menginginkan lebih lama dari default untuk perintah, ia melewatkan parameter `timeout` dengan panggilan itu. Anda tidak pernah menetapkan batas waktu per perintah.170Setiap perintah berjalan di bawah batas waktu, dan Claude mengelolanya: ketika menginginkan lebih lama dari default untuk perintah, ia melewatkan parameter `timeout` dengan panggilan itu. Anda tidak pernah menetapkan batas waktu per perintah.

171 171 

172Dua [variabel lingkungan](/docs/id/env-vars) mengontrol apa yang Claude dapatkan untuk perintah yang berjalan di foreground:172Dua [variabel lingkungan](/docs/id/env-vars) mengontrol apa yang Claude dapatkan untuk perintah yang berjalan di latar depan:

173 173 

174* `BASH_DEFAULT_TIMEOUT_MS` — default ketika Claude tidak melewatkan batas waktu; dua menit di luar kotak174* `BASH_DEFAULT_TIMEOUT_MS` — default ketika Claude tidak melewatkan timeout; dua menit di luar kotak

175* `BASH_MAX_TIMEOUT_MS` — dengan default, menetapkan batas yang membatasi apa pun yang Claude minta: batas efektif adalah yang lebih besar dari keduanya, sepuluh menit di luar kotak175* `BASH_MAX_TIMEOUT_MS` — dengan default, menetapkan batas yang membatasi apa pun yang Claude minta: batas efektif adalah yang lebih besar dari keduanya, sepuluh menit di luar kotak

176 176 

177Untuk perintah yang Claude mulai di background, `timeout` malah menetapkan berapa lama perintah dapat berjalan di sana, dengan default dan maksimum terpisah yang dijelaskan di bawah [Perintah background](#background-commands). Alat [PowerShell](#powershell-tool) mengikuti aturan timeout yang sama dan membaca dua variabel yang sama.177Untuk perintah yang Claude mulai di latar belakang, `timeout` malah menetapkan berapa lama perintah dapat berjalan di sana, dengan default dan maksimum terpisah yang dijelaskan di bawah [Batas waktu untuk perintah latar belakang](#time-limit-for-background-commands). [Alat PowerShell](#powershell-tool) mengikuti aturan timeout yang sama dan membaca dua variabel yang sama.

178 178 

179<h4 id="output-limits">179<h4 id="output-limits">

180 Batas output180 Batas keluaran

181</h4>181</h4>

182 182 

183Claude Code mengalirkan output perintah ke file kerja saat perintah berjalan; perintah yang outputnya melampaui 5 GB dibunuh. Ketika perintah selesai, Claude Code membaca output kembali dari file itu, hingga jendela read-back yang dijelaskan di bawah. Berapa banyak output yang mencapai Claude secara inline tergantung pada apakah Claude Code memperlakukan hasil sebagai kegagalan:183Claude Code mengalirkan keluaran perintah ke file kerja saat perintah berjalan; perintah yang keluarannya melampaui 5 GB dibunuh. Ketika perintah selesai, Claude Code membaca keluaran kembali dari file itu, hingga jendela read-back yang dijelaskan di bawah. Berapa banyak keluaran yang mencapai Claude secara inline tergantung pada apakah Claude Code memperlakukan hasil sebagai kegagalan:

184 184 

185| Hasil | Apa yang Claude dapatkan |185| Hasil | Apa yang Claude dapatkan |

186| :- | :- |186| :- | :- |

187| Valid | Inline hingga kira-kira 30.000 karakter secara default; melampaui itu, jalur file yang disimpan ke direktori sesi dan dipotong melampaui 64 MiB, ditambah pratinjau hingga 2.000 karakter pertama, dan Claude membaca atau mencari file ketika membutuhkan sisanya |187| Valid | Inline hingga kira-kira 30.000 karakter secara default; melampaui itu, jalur file yang disimpan ke direktori sesi dan dipotong melampaui 64 MiB, ditambah pratinjau hingga 2.000 karakter pertama, dan Claude membaca atau mencari file ketika membutuhkan sisanya |

188| Kegagalan | Inline hingga kira-kira 10.000 karakter; melampaui itu, kutipan kepala-dan-ekor ukuran itu dipotong dari jendela read-back, tanpa jalur file |188| Kegagalan | Inline hingga kira-kira 10.000 karakter; melampaui itu, kutipan kepala-dan-ekor dari ukuran itu dipotong dari jendela read-back, tanpa jalur file |

189 189 

190Perintah yang keluar 1 dihitung sebagai hasil valid untuk alat Bash hanya ketika Claude Code mengenali kode keluar 1 sebagai hasil yang jinak untuk perintah itu: `grep`, `rg`, `egrep`, `fgrep`, `find`, `diff`, `test`, dan `[`, ditambah `git diff` dan `git grep`. Setiap perintah lain yang keluar 1 dihitung sebagai kegagalan, bahkan ketika keluar 1 adalah hasil informasional yang jinak: tidak ada kecocokan untuk `pgrep` dan `jq -e`, file yang berbeda untuk `cmp`.190Perintah yang keluar 1 dihitung sebagai hasil valid untuk alat Bash hanya ketika Claude Code mengenali kode keluar 1 sebagai hasil yang baik untuk perintah itu: `grep`, `rg`, `egrep`, `fgrep`, `find`, `diff`, `test`, dan `[`, ditambah `git diff` dan `git grep`. Setiap perintah lain yang keluar 1 dihitung sebagai kegagalan, bahkan ketika keluar 1 adalah hasil informasional yang baik: tidak ada kecocokan untuk `pgrep` dan `jq -e`, file yang berbeda untuk `cmp`.

191 191 

192[`BASH_MAX_OUTPUT_LENGTH`](/docs/id/env-vars) menetapkan berapa banyak karakter output yang Claude Code baca kembali dari file kerja ke hasil perintah: 30.000 secara default, hingga batas keras 150.000. Naikkan ketika perintah Anda secara rutin melampaui jendela itu, seperti build verbose atau log test-suite lengkap. Menaikkannya memperbesar jendela read-back, yang juga merupakan jendela kutipan perintah yang gagal dipotong. Itu tidak menaikkan batas inline: hasil valid di atas batas inline tiba sebagai jalur file ditambah pratinjau terlepas dari variabel ini.192[`BASH_MAX_OUTPUT_LENGTH`](/docs/id/env-vars) menetapkan berapa banyak karakter keluaran yang Claude Code baca kembali dari file kerja ke hasil perintah: 30.000 secara default, hingga batas keras 150.000. Naikkan ketika perintah Anda secara rutin melampaui jendela itu, seperti build verbose atau log test-suite lengkap. Menaikkannya memperbesar jendela read-back, yang juga merupakan jendela kutipan perintah yang gagal dipotong. Ini tidak menaikkan batas inline: hasil valid di atas batas inline tiba sebagai jalur file ditambah pratinjau terlepas dari variabel ini.

193 193 

194Untuk mengubah berapa banyak hasil valid yang Claude terima secara inline, atur pengaturan [`bashOutputMaxChars`](/docs/id/settings-reference#bashoutputmaxchars) sebagai gantinya, hingga 128.000 karakter. Ini mengukur batas inline dan jendela read-back bersama-sama, dan Claude Code kemudian mengabaikan `BASH_MAX_OUTPUT_LENGTH`. Memerlukan Claude Code v2.1.261 atau lebih baru.194Untuk mengubah berapa banyak hasil valid yang Claude terima secara inline, atur pengaturan [`bashOutputMaxChars`](/docs/id/settings-reference#bashoutputmaxchars) sebagai gantinya, hingga 128.000 karakter. Ini mengukur batas inline dan jendela read-back bersama-sama, dan Claude Code kemudian mengabaikan `BASH_MAX_OUTPUT_LENGTH`. Memerlukan Claude Code v2.1.261 atau lebih baru.

195 195 


197 Perintah latar belakang197 Perintah latar belakang

198</h3>198</h3>

199 199 

200Untuk proses yang berjalan lama seperti server dev atau build watch, Claude dapat mengatur `run_in_background: true` untuk memulai perintah sebagai tugas latar belakang dan terus bekerja saat berjalan. Daftar dan hentikan tugas latar belakang dengan `/tasks`. Setelah Anda menghentikan satu di sana, atau dari klien yang terhubung seperti aplikasi desktop, Claude melanjutkan alih-alih menunggu. Jika subagent memulai perintah, itu adalah subagent itu yang melanjutkan.200Untuk proses yang berjalan lama seperti server dev atau watch builds, Claude dapat menetapkan `run_in_background: true` untuk memulai perintah sebagai tugas latar belakang dan terus bekerja saat berjalan. Daftar dan hentikan tugas latar belakang dengan `/tasks`. Setelah Anda menghentikan salah satu di sana, atau dari klien yang terhubung seperti aplikasi desktop, Claude melanjutkan alih-alih menunggu. Jika subagent memulai perintah, itu adalah subagent itu yang melanjutkan.

201 201 

202Perintah yang dimulai oleh [subagent foreground](/docs/id/sub-agents#run-subagents-in-foreground-or-background) berhenti ketika subagent itu menjalankan akhirnya, baik itu selesai, gagal, atau terganggu. Perintah yang dimulai oleh percakapan utama atau subagent background terus berjalan setelah respons final, hingga keluar, dihentikan, atau mencapai batas waktunya. Dalam mode non-interaktif dengan flag `-p`, [perintah background berakhir segera setelah hasil final run](/docs/id/headless#background-tasks-at-exit).202<h4 id="when-a-background-command-stops">

203 Ketika perintah latar belakang berhenti

204</h4>

205 

206Perintah yang dimulai oleh [subagent latar depan](/docs/id/sub-agents#run-subagents-in-foreground-or-background) berhenti ketika run subagent itu berakhir, apakah selesai, gagal, atau terputus. Perintah yang dimulai oleh percakapan utama atau subagent latar belakang terus berjalan setelah respons final, hingga keluar, dihentikan, atau mencapai [batas waktunya](#time-limit-for-background-commands). Dalam mode non-interaktif dengan flag `-p`, [perintah latar belakang berakhir segera setelah hasil final run](/docs/id/headless#background-tasks-at-exit).

207 

208<h4 id="time-limit-for-background-commands">

209 Batas waktu untuk perintah latar belakang

210</h4>

203 211 

204Perintah Bash dan PowerShell background memiliki batas waktu, dihitung dari saat perintah memasuki background:212Perintah Bash dan PowerShell latar belakang memiliki batas waktu, dihitung dari saat perintah memasuki latar belakang:

205 213 

206* Perintah yang Claude mulai di background mendapat 30 menit, atau `timeout` yang Claude lewatkan dengan `run_in_background`, hingga maksimum 2 jam214* Perintah yang Claude mulai di latar belakang mendapat 30 menit, atau `timeout` yang Claude lewatkan dengan `run_in_background`, hingga maksimum 2 jam

207* Perintah yang dimulai di foreground dan kemudian pindah ke background, misalnya dengan `Ctrl+B` atau pada timeoutnya, mendapat 30 menit dari perpindahan215* Perintah yang dimulai di latar depan dan kemudian pindah ke latar belakang, misalnya dengan `Ctrl+B` atau pada timeoutnya, mendapat 30 menit dari perpindahan

208 216 

209Dua [variabel lingkungan](/docs/id/env-vars) menaikkan batas ini, untuk perintah Bash dan PowerShell sama-sama. Keduanya mengambil milidetik, dan tidak satupun dapat mempersingkat batas: nilai yang lebih rendah membiarkan default 30 menit dan maksimum 2 jam tetap berlaku.217Ketika perintah latar belakang mencapai batas waktunya, Claude Code menghentikannya dan memberi tahu Claude mengapa, dan Claude dapat memulai perintah lagi dengan `timeout` yang lebih lama jika pekerjaan masih membutuhkannya. Pemberitahuan penghentian berbunyi `Background command "<description>" was stopped after reaching its background time limit`.

218 

219<h4 id="raise-the-time-limit-for-background-commands">

220 Naikkan batas waktu untuk perintah latar belakang

221</h4>

222 

223Dua [variabel lingkungan](/docs/id/env-vars) menaikkan batas ini, untuk perintah Bash dan PowerShell sama-sama. Keduanya mengambil milidetik, dan tidak satupun dapat mempersingkat batas: nilai yang lebih rendah meninggalkan default 30 menit dan maksimum 2 jam.

210 224 

211* Atur `BASH_DEFAULT_TIMEOUT_MS` di atas `1800000` untuk mengganti default 30 menit dengan nilai itu, baik untuk perintah yang Claude mulai tanpa `timeout` maupun untuk perintah yang dipindahkan225* Atur `BASH_DEFAULT_TIMEOUT_MS` di atas `1800000` untuk mengganti default 30 menit dengan nilai itu, baik untuk perintah yang Claude mulai tanpa `timeout` maupun untuk perintah yang dipindahkan

212* Atur `BASH_MAX_TIMEOUT_MS` di atas `7200000` untuk menaikkan maksimum 2 jam ke nilai itu. Mengatur `BASH_DEFAULT_TIMEOUT_MS` di atas `7200000` menaikkan maksimum dengan cara yang sama226* Atur `BASH_MAX_TIMEOUT_MS` di atas `7200000` untuk menaikkan maksimum 2 jam ke nilai itu. Mengatur `BASH_DEFAULT_TIMEOUT_MS` di atas `7200000` menaikkan maksimum dengan cara yang sama

213 227 

214Ketika perintah background mencapai batas waktunya, Claude Code menghentikannya dan memberi tahu Claude mengapa, dan Claude dapat memulai perintah lagi dengan `timeout` yang lebih lama jika pekerjaan masih membutuhkannya. Pemberitahuan penghentian berbunyi `Background command "<description>" was stopped after reaching its background time limit`.228<h4 id="foreground-commands-that-move-to-the-background">

229 Perintah latar depan yang pindah ke latar belakang

230</h4>

215 231 

216Ketika perintah foreground mencapai timeoutnya tanpa selesai, Claude Code memindahkannya ke background alih-alih menghentikannya, kecuali perintah dimulai dengan `sleep`. Batas waktu perintah yang dipindahkan dihitung dari perpindahan, dan perintah yang dipindahkan dari subagent foreground masih berhenti ketika subagent itu menjalankan akhirnya.232Ketika perintah latar depan mencapai timeoutnya tanpa selesai, Claude Code memindahkannya ke latar belakang alih-alih menghentikannya, kecuali perintah dimulai dengan `sleep`. [Batas waktu](#time-limit-for-background-commands) perintah yang dipindahkan dihitung dari perpindahan, dan perintah subagent latar depan yang dipindahkan masih berhenti ketika run subagent itu berakhir.

217 233 

218Mengatur [`CLAUDE_CODE_DISABLE_BACKGROUND_TASKS=1`](/docs/id/env-vars#variables) menonaktifkan auto-backgrounding bersama dengan sisa fungsionalitas tugas background.234Mengatur [`CLAUDE_CODE_DISABLE_BACKGROUND_TASKS=1`](/docs/id/env-vars#variables) menonaktifkan auto-backgrounding bersama dengan sisa fungsionalitas tugas latar belakang.

219 235 

220Hasil perintah yang dipindahkan ke latar belakang menyatakan apa yang terjadi:236Hasil perintah yang dipindahkan ke latar belakang menyatakan apa yang terjadi:

221 237 

222* Ketika batas waktu memicu perpindahan, hasil melaporkannya secara eksplisit: `Command did not complete within its 120s timeout and was moved to the background`, dengan detik sesuai dengan batas waktu yang berlaku, diikuti oleh ID tugas dan jalur file tempat output ditulis.238* Ketika timeout memicu perpindahan, hasil melaporkannya secara eksplisit: `Command did not complete within its 120s timeout and was moved to the background`, dengan detik yang cocok dengan timeout yang diterapkan, diikuti oleh ID tugas dan jalur file yang keluarannya ditulis.

223* Sebuah `cd`, `pushd`, `popd`, atau `chdir` di dalam perintah yang dipindahkan ke latar belakang tidak pernah terbawa: hasil menyatakan `Session cwd remains <dir>; directory changes made by the backgrounded command do not apply to subsequent commands.`, jadi Claude tidak bertindak atas perubahan direktori yang tidak terjadi.239* Sebuah `cd`, `pushd`, `popd`, atau `chdir` di dalam perintah yang dipindahkan ke latar belakang tidak pernah terbawa: hasil menyatakan `Session cwd remains <dir>; directory changes made by the backgrounded command do not apply to subsequent commands.`, jadi Claude tidak bertindak atas perubahan direktori yang tidak terjadi.

224 240 

225<h3 id="memory-limit-on-linux-and-wsl">241<h3 id="memory-limit-on-linux-and-wsl">

226 Batas memori di Linux dan WSL242 Batas memori di Linux dan WSL

227</h3>243</h3>

228 244 

229Di Linux dan WSL, atur [`CLAUDE_CODE_TOOL_MEMORY_LIMIT`](/docs/id/env-vars#variables) ke ukuran seperti `4G` untuk membatasi memori yang perintah Bash, PowerShell, dan alat [Monitor](#monitor-tool) dapat gunakan, sehingga satu build yang lari tidak dapat mengambil memori yang sesi lainnya butuhkan. Memerlukan Claude Code v2.1.233 atau lebih baru. Sebelum v2.1.246, perintah alat Monitor berjalan di luar batas.245Di Linux dan WSL, atur [`CLAUDE_CODE_TOOL_MEMORY_LIMIT`](/docs/id/env-vars#variables) ke ukuran seperti `4G` untuk membatasi memori yang perintah Bash, PowerShell, dan [Monitor](#monitor-tool) dapat gunakan, sehingga satu build yang lari tidak dapat mengambil memori yang sesi lainnya butuhkan. Memerlukan Claude Code v2.1.233 atau lebih baru. Sebelum v2.1.246, perintah alat Monitor berjalan di luar batas.

230 246 

231* Tulis ukuran sebagai jumlah byte atau dengan akhiran `K`, `M`, `G`, atau `T`. Atur `0`, `off`, `false`, `no`, atau `none` untuk mematikan batas. Claude Code mengabaikan nilai apa pun yang tidak dapat dibacanya sebagai ukuran, seperti `4e9`.247* Tulis ukuran sebagai jumlah byte atau dengan akhiran `K`, `M`, `G`, atau `T`. Atur `0`, `off`, `false`, `no`, atau `none` untuk mematikan batas. Claude Code mengabaikan nilai lain apa pun yang tidak dapat dibacanya sebagai ukuran, seperti `4e9`.

232* Claude Code menghitung semua perintah Bash, PowerShell, dan Monitor sesi terhadap satu batas, bukan setiap perintah pada dirinya sendiri.248* Claude Code menghitung semua perintah Bash, PowerShell, dan Monitor sesi terhadap satu batas, bukan setiap perintah sendiri.

233* Claude Code menerapkan batas dengan cgroup memori. Ketika tidak dapat mengatur cgroup, perintah berjalan tanpa batas, dan log debug dari `claude --debug` mengatakan mengapa.249* Claude Code menerapkan batas dengan cgroup memori. Ketika tidak dapat mengatur cgroup, perintah berjalan tanpa batas, dan log debug dari `claude --debug` mengatakan mengapa.

234* Setelah proses pertama yang Claude Code mulai telah menghidupkan batas, atau telah mematikannya karena nilai off atau setup cgroup yang gagal, Claude Code menahan hasil itu sampai Anda meluncurkan kembali. Untuk menerapkan nilai yang diubah atau dihapus, atau setup yang diperbaiki, luncurkan `claude` lagi.250* Setelah proses pertama yang Claude Code mulai telah menyalakan batas, atau telah mematikannya karena nilai off atau setup cgroup yang gagal, Claude Code menahan hasil itu hingga Anda meluncurkan ulang. Untuk menerapkan nilai yang diubah atau dihapus, atau setup yang diperbaiki, luncurkan `claude` lagi.

235* Ketika perintah tidak dapat tetap di bawah batas, kernel membunuh perintah, dan tidak ada dalam hasilnya yang menyebutkan batas.251* Ketika perintah tidak dapat tetap di bawah batas, kernel membunuh perintah, dan tidak ada dalam hasilnya yang menyebutkan batas.

236 252 

237Claude Code juga dapat menghitung jenis proses lain yang dimulainya terhadap batas yang sama. Atur [`CLAUDE_CODE_TOOL_MEMORY_CGROUP_EXCLUDE`](/docs/id/env-vars#variables) ke daftar yang dipisahkan koma dari jenis yang dikecualikan dari batas; Claude Code menerapkan batas ke setiap jenis yang tidak ada di daftar Anda. Atur ke `none` untuk membatasi setiap jenis, atau ke `all-new` untuk membatasi hanya perintah alat Bash, PowerShell, dan Monitor. Memerlukan Claude Code v2.1.246 atau lebih baru. Jenis yang dapat Anda namai:253Claude Code juga dapat menghitung jenis proses lain yang dimulainya terhadap batas yang sama. Atur [`CLAUDE_CODE_TOOL_MEMORY_CGROUP_EXCLUDE`](/docs/id/env-vars#variables) ke daftar yang dipisahkan koma dari jenis yang dikecualikan dari batas; Claude Code menerapkan batas ke setiap jenis yang tidak ada di daftar Anda. Atur ke `none` untuk membatasi setiap jenis, atau ke `all-new` untuk membatasi hanya perintah Bash, PowerShell, dan Monitor tool. Memerlukan Claude Code v2.1.246 atau lebih baru. Jenis yang dapat Anda namai:

238 254 

239* `mcp`: server [MCP](/docs/id/mcp) lokal255* `mcp`: server [MCP](/docs/id/mcp) lokal

240* `lsp`: [server bahasa](#lsp-tool-behavior)256* `lsp`: [server bahasa](#lsp-tool-behavior)

241* `hooks`: perintah [hook](/docs/id/hooks)257* `hooks`: perintah [hook](/docs/id/hooks)

242* `plugin`: perintah yang [plugin](/docs/id/plugins/overview) jalankan258* `plugin`: perintah yang [plugin](/docs/id/plugins/overview) jalankan

243* `helper`: perintah helper Claude Code sendiri, seperti `git`259* `helper`: perintah helper Claude Code sendiri, seperti `git`

244* `agent`: proses Claude Code anak, seperti [rekan tim agen](/docs/id/agent-teams)260* `agent`: proses Claude Code anak, seperti [rekan tim agent](/docs/id/agent-teams)

245 261 

246Apa pun yang Anda daftar, aturan ini berlaku:262Apa pun yang Anda daftar, aturan ini berlaku:

247 263 

248* **Nama tidak dikenal**: Claude Code mengabaikan nama yang tidak dikenalinya264* **Nama tidak dikenal**: Claude Code mengabaikan nama yang tidak dikenalinya

249* **Bash, PowerShell, dan Monitor**: Claude Code menjaga perintah alat Bash, PowerShell, dan Monitor di bawah batas apa pun yang Anda daftar

250* **Variabel tidak diatur**: Claude Code mengambil set jenis yang dibatasi lainnya dari konfigurasi yang Anthropic berikan dari server, dan set itu dapat berubah seiring waktu, jadi atur variabel ketika Anda membutuhkan set yang tidak berubah265* **Variabel tidak diatur**: Claude Code mengambil set jenis yang dibatasi lainnya dari konfigurasi yang Anthropic berikan dari server, dan set itu dapat berubah seiring waktu, jadi atur variabel ketika Anda membutuhkan set yang tidak berubah

251* **Hook gating izin**: bahkan dengan setiap jenis dibatasi, Claude Code mengecualikan dari batas hook yang dapat memblokir atau mengubah hasil tindakan, dan server MCP apa pun yang hook tersebut panggil, sehingga kernel membunuh hook gating izin tidak dapat memungkinkan tindakan yang sedang diblokir.266* **Hook gating izin**: bahkan dengan setiap jenis dibatasi, Claude Code mengecualikan dari batas hook yang dapat memblokir atau mengubah hasil tindakan, dan server MCP apa pun yang hook itu panggil, sehingga kernel membunuh hook gating izin tidak dapat memungkinkan tindakan yang diblokir

252 267 

253<h2 id="edit-tool-behavior">268<h2 id="edit-tool-behavior">

254 Perilaku alat Edit269 Perilaku alat Edit

ultrareview.md +1 −1

Details

66 66 

67Dalam mode PR, sandbox jarak jauh mengkloning pull request langsung dari host daripada membundel pohon kerja lokal Anda. Mode PR bekerja dengan repositori di `github.com` dan pada instans [GitHub Enterprise Server](/docs/id/github-enterprise-server) yang telah dihubungkan oleh Owner ke Claude Code.67Dalam mode PR, sandbox jarak jauh mengkloning pull request langsung dari host daripada membundel pohon kerja lokal Anda. Mode PR bekerja dengan repositori di `github.com` dan pada instans [GitHub Enterprise Server](/docs/id/github-enterprise-server) yang telah dihubungkan oleh Owner ke Claude Code.

68 68 

69Untuk repositori di `github.com`, sandbox mengkloning dengan akun GitHub yang terhubung ke akun Claude Anda, jadi akun harus dapat membaca repositori PR. Claude Code memeriksa ini sebelum membuat sesi cloud, kecuali Anda telah menetapkan [`CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC`](/docs/id/env-vars#variables), dan menolak peluncuran ketika [tidak ada akun yang terhubung](/docs/id/errors#no-github-account-is-connected-to-your-claude-account) atau [akun tidak dapat melihat repositori](/docs/id/errors#your-connected-github-account-cant-see-the-repository); penolakan menyebutkan perbaikannya. Sebelum v2.1.248, Claude Code tidak memeriksa ini sebelum peluncuran.69Untuk repositori di `github.com`, sandbox mengkloning dengan akun GitHub yang terhubung ke akun Claude Anda, jadi akun harus dapat membaca repositori PR.

70 70 

71Jalankan [`/web-setup`](/docs/id/web-quickstart#connect-from-your-terminal) untuk menghubungkan login GitHub CLI Anda ke akun Claude Anda.71Jalankan [`/web-setup`](/docs/id/web-quickstart#connect-from-your-terminal) untuk menghubungkan login GitHub CLI Anda ke akun Claude Anda.

72 72 

vs-code.md +25 −5

Details

58 58 

59 * **Activity Bar**: klik ikon Spark di sidebar kiri untuk membuka daftar sesi. Klik sesi apa pun untuk membukanya di [lokasi pilihan Anda](#extension-settings), atau mulai yang baru. Ikon ini selalu terlihat di Activity Bar.59 * **Activity Bar**: klik ikon Spark di sidebar kiri untuk membuka daftar sesi. Klik sesi apa pun untuk membukanya di [lokasi pilihan Anda](#extension-settings), atau mulai yang baru. Ikon ini selalu terlihat di Activity Bar.

60 * **Command Palette**: `Cmd+Shift+P` (Mac) atau `Ctrl+Shift+P` (Windows/Linux), ketik "Claude Code", dan pilih opsi seperti "Open in New Tab"60 * **Command Palette**: `Cmd+Shift+P` (Mac) atau `Ctrl+Shift+P` (Windows/Linux), ketik "Claude Code", dan pilih opsi seperti "Open in New Tab"

61 * **Status Bar**: jika Anda telah menetapkan [`preferredLocation`](#extension-settings) ke `sidebar`, atau membuka Claude dengan **Claude Code: Open in Side Bar**, klik **✻ Claude Code** di sudut kanan bawah jendela. Ini berfungsi bahkan ketika tidak ada file yang terbuka.61 * **Status Bar**: klik **✻ Claude Code** di sudut kanan bawah jendela. Ini berfungsi bahkan ketika tidak ada file yang terbuka.

62 62 

63 Anda dapat menyeret panel Claude untuk memposisikannya kembali di mana saja di VS Code. Lihat [Sesuaikan alur kerja Anda](#customize-your-workflow) untuk detail.63 Anda dapat menyeret panel Claude untuk memposisikannya kembali di mana saja di VS Code. Lihat [Sesuaikan alur kerja Anda](#customize-your-workflow) untuk detail.

64 </Step>64 </Step>


362 362 

363Di tab Plugin:363Di tab Plugin:

364 364 

365* **Plugin yang terinstal** muncul di bagian atas dengan tombol toggle untuk mengaktifkan atau menonaktifkan365* **Plugin yang terinstal** muncul di bagian atas dengan tombol toggle untuk mengaktifkan atau menonaktifkan.

366 * Jika Anda mematikan plugin yang `.claude/settings.json` bersama proyek Anda aktifkan, ekstensi bertanya terlebih dahulu: **Disable for me** mematikannya hanya untuk Anda, sementara **Disable for everyone** mengubah file bersama.

366* **Plugin yang tersedia** dari marketplace yang dikonfigurasi muncul di bawah367* **Plugin yang tersedia** dari marketplace yang dikonfigurasi muncul di bawah

367* Cari untuk memfilter plugin berdasarkan nama atau deskripsi368* Cari untuk memfilter plugin berdasarkan nama atau deskripsi

368* Klik **Instal** pada plugin yang tersedia369* Klik **Instal** pada plugin yang tersedia


373* **Instal untuk proyek ini**: dibagikan dengan kolaborator proyek (cakupan proyek)374* **Instal untuk proyek ini**: dibagikan dengan kolaborator proyek (cakupan proyek)

374* **Instal secara lokal**: hanya untuk Anda, hanya di repositori ini (cakupan lokal)375* **Instal secara lokal**: hanya untuk Anda, hanya di repositori ini (cakupan lokal)

375 376 

377Setelah instalasi selesai, formulir meminta [opsi konfigurasi](/docs/id/plugins/components#user-configuration) plugin apa pun yang belum diatur. Untuk meninjau atau mengubah opsi nanti, klik ikon gear pada baris plugin.

378 

379Bidang teks sensitif disembunyikan, dan rahasia yang Anda simpan sebelumnya menampilkan **(unchanged)**. Biarkan bidang kosong untuk mempertahankan nilai yang disimpan.

380 

381Setelah Anda menyimpan perubahan, sesi terbuka memuat ulang plugin mereka dan dialog menampilkan **Restart Claude to apply plugin changes**.

382 

383<h3 id="uninstall-plugins">

384 Copot plugin

385</h3>

386 

387Setiap baris yang terinstal menamai [cakupan](/docs/id/plugins/install#choose-an-install-scope) tempat plugin diinstal. Untuk mencopot instalasi tersebut, klik ikon sampah baris. Ikon sampah yang redup menandai baris yang tidak dapat Anda copot dari workspace ini, seperti plugin yang organisasi Anda kelola atau yang diinstal untuk proyek lain.

388 

389Ekstensi bertanya terlebih dahulu dalam dua kasus:

390 

391* **Plugin yang `.claude/settings.json` bersama proyek Anda aktifkan**: pilih **Disable for me**, yang membuat plugin tetap terinstal untuk kolaborator Anda, atau **Uninstall for everyone**, yang menghapus instalasi proyek dengan [`--keep-data`](/docs/id/plugins/cli-reference#what-an-uninstall-deletes-and-keeps), sehingga direktori data yang disimpan plugin tetap ada. Jika Anda sudah mematikan plugin untuk diri sendiri, ikon sampah menghapus instalasi Anda sendiri tanpa pertanyaan.

392* **Jika tidak, instalasi terakhir plugin dengan data yang disimpan**: pilih apakah akan menyimpan atau menghapus data; **Keep** adalah default

393 

376<h3 id="share-a-plugin-install-link">394<h3 id="share-a-plugin-install-link">

377 Bagikan tautan instalasi plugin395 Bagikan tautan instalasi plugin

378</h3>396</h3>


407 425 

408* Masukkan repo GitHub, URL, atau jalur lokal untuk menambahkan marketplace baru426* Masukkan repo GitHub, URL, atau jalur lokal untuk menambahkan marketplace baru

409* Klik ikon refresh untuk memperbarui daftar plugin marketplace427* Klik ikon refresh untuk memperbarui daftar plugin marketplace

410* Klik ikon sampah untuk menghapus marketplace428* Klik ikon sampah untuk menghapus marketplace. Menghapusnya [mencopot setiap plugin yang Anda instal darinya](/docs/id/plugins/install#manage-marketplaces), jadi konfirmasi menamai plugin tersebut terlebih dahulu

429 

430Perubahan plugin yang Anda buat dalam dialog diterapkan segera ke sesi Claude Code yang terbuka di jendela VS Code tersebut.

411 431 

412Perubahan plugin yang Anda buat dalam dialog diterapkan segera ke sesi Claude Code yang terbuka di jendela VS Code tersebut. Jika sesi tempat Anda membuka dialog tidak dapat memuat ulang pluginnya, dialog menawarkan untuk mencoba lagi atau memulai ulang Claude di sesi tersebut.432Jika sesi tempat Anda membuka dialog tidak dapat memuat ulang pluginnya, dialog menawarkan untuk mencoba lagi atau memulai ulang Claude di sesi tersebut.

413 433 

414<Note>434<Note>

415 Manajemen plugin di VS Code menggunakan perintah CLI yang sama di balik layar. Plugin dan marketplace yang Anda konfigurasi di ekstensi juga tersedia di CLI, dan sebaliknya.435 Manajemen plugin di VS Code menggunakan perintah CLI yang sama di balik layar. Plugin dan marketplace yang Anda konfigurasi di ekstensi juga tersedia di CLI, dan sebaliknya.


7904. **Nonaktifkan ekstensi yang bertentangan**: Nonaktifkan sementara ekstensi AI lainnya (Cline, Continue, dll.)8104. **Nonaktifkan ekstensi yang bertentangan**: Nonaktifkan sementara ekstensi AI lainnya (Cline, Continue, dll.)

7915. **Periksa kepercayaan workspace**: Ekstensi tidak berfungsi dalam Mode Terbatas8115. **Periksa kepercayaan workspace**: Ekstensi tidak berfungsi dalam Mode Terbatas

792 812 

793Alternatifnya, jika Anda telah menetapkan [`preferredLocation`](#extension-settings) ke `sidebar`, atau membuka Claude dengan **Claude Code: Open in Side Bar**, klik "✻ Claude Code" di **Status Bar** (sudut kanan bawah). Ini berfungsi bahkan tanpa file yang terbuka. Anda juga dapat menggunakan **Command Palette** (`Cmd+Shift+P` / `Ctrl+Shift+P`) dan ketik "Claude Code".813Alternatifnya, klik **✻ Claude Code** di **Status Bar** di sudut kanan bawah jendela. Ini berfungsi bahkan tanpa file yang terbuka. Anda juga dapat menggunakan **Command Palette** (`Cmd+Shift+P` / `Ctrl+Shift+P`) dan ketik "Claude Code".

794 814 

795<h3 id="cmd-esc-does-nothing-on-macos">815<h3 id="cmd-esc-does-nothing-on-macos">

796 Cmd+Esc tidak melakukan apa pun di macOS816 Cmd+Esc tidak melakukan apa pun di macOS

worktrees.md +1 −1

Details

145* Worktree milik sesi `--worktree` yang belum Anda kirim ke latar belakang, apa pun usianya.145* Worktree milik sesi `--worktree` yang belum Anda kirim ke latar belakang, apa pun usianya.

146* Anda membuat worktree sendiri dengan `git worktree add`, bahkan jika Anda kemudian menjalankan sesi `--worktree <name>` di dalamnya dan mengirimnya ke latar belakang.146* Anda membuat worktree sendiri dengan `git worktree add`, bahkan jika Anda kemudian menjalankan sesi `--worktree <name>` di dalamnya dan mengirimnya ke latar belakang.

147 147 

148Claude Code menulis penanda ke metadata git setiap worktree yang dibuat dengan git, dan sapuan menyimpan worktree apa pun tanpa satu, termasuk worktree yang dibuat hook [`WorktreeCreate`](#non-git-version-control). Sebelum v2.1.246, sapuan tidak memeriksa penanda, dan dapat menghapus worktree yang Anda buat sendiri saat catatan sesi latar belakang lama menunjuk padanya.148Claude Code menulis penanda ke metadata git setiap worktree yang dibuat dengan git, dan sapuan menyimpan worktree apa pun tanpa satu, termasuk worktree yang dibuat hook [`WorktreeCreate`](#non-git-version-control).

149 149 

150Saat agen berjalan, Claude Code menyimpan `git worktree lock` pada worktree-nya sehingga pembersihan bersamaan tidak dapat menghapusnya, dan melepaskan kunci saat agen selesai. Claude Code menyimpan kunci yang sama pada worktree yang dibuat untuk sesi yang dikirim ke latar belakang saat sesi berjalan, jadi sapuan meninggalkan worktree di tempat dan `git worktree remove` menolak untuk menghapusnya.150Saat agen berjalan, Claude Code menyimpan `git worktree lock` pada worktree-nya sehingga pembersihan bersamaan tidak dapat menghapusnya, dan melepaskan kunci saat agen selesai. Claude Code menyimpan kunci yang sama pada worktree yang dibuat untuk sesi yang dikirim ke latar belakang saat sesi berjalan, jadi sapuan meninggalkan worktree di tempat dan `git worktree remove` menolak untuk menghapusnya.

151 151