SpyBara
Go Premium

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

18 files changed +219 −67. View all changes and history on the product overview
2026
Thu 1 04:01
Details

2885 2885 

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

2887 2887 

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).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 [Time limit for background commands](/docs/id/tools-reference#time-limit-for-background-commands).

2889 2889 

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

2891 2891 

Details

3206};3206};

3207```3207```

3208 3208 

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).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 [Batas waktu untuk perintah latar belakang](/docs/id/tools-reference#time-limit-for-background-commands).

3210 3210 

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

3212 Monitor3212 Monitor


4110 4110 

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

4112 4112 

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.4113Ketika 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 4114 

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

4116 4116 

agent-view.md +2 −2

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: 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="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: 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="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 

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` |


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) |

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 +7 −5

Details

3657 Tidak dapat membuka Claude Desktop3657 Tidak dapat membuka Claude Desktop

3658</h3>3658</h3>

3659 3659 

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.3660Anda 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.

3661 

3662Teks 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 3663 

3662```text theme={null}3664```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.3665Error: 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```3666```

3665 3667 

3666**Yang harus dilakukan:**3668**Yang harus dilakukan:**

3667 3669 

3668* Buka Claude Desktop sendiri, kemudian jalankan `/desktop` lagi3670* 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 debug3671* 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 3672 

3671Sebelum v2.1.275, pesan adalah `Failed to open Claude Desktop. Please try opening it manually.` dan tidak mengatakan apa yang gagal.3673Sebelum 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 3674 

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

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

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`. Untuk mengubah berapa lama perintah berjalan sebelum itu terjadi, 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` ke `1`. Lihat [Variabel lingkungan](/docs/id/env-vars) untuk detail.

367 365 

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>

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

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:

tools-reference.md +43 −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 daftar265* **Bash, PowerShell, dan Monitor**: Claude Code menjaga perintah Bash, PowerShell, dan Monitor tool 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 berubah266* **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.267* **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 268 

253<h2 id="edit-tool-behavior">269<h2 id="edit-tool-behavior">

254 Perilaku alat Edit270 Perilaku alat Edit

vs-code.md +23 −3

Details

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.