8 8
9Halaman ini mencantumkan kesalahan runtime yang ditampilkan Claude Code dan cara memulihkan dari masing-masing, ditambah apa yang harus diperiksa ketika respons tampak tidak normal tanpa kesalahan. Untuk kesalahan instalasi seperti `command not found` atau kegagalan TLS selama penyiapan, lihat [Troubleshoot installation and login](/docs/id/troubleshoot-install).9Halaman ini mencantumkan kesalahan runtime yang ditampilkan Claude Code dan cara memulihkan dari masing-masing, ditambah apa yang harus diperiksa ketika respons tampak tidak normal tanpa kesalahan. Untuk kesalahan instalasi seperti `command not found` atau kegagalan TLS selama penyiapan, lihat [Troubleshoot installation and login](/docs/id/troubleshoot-install).
10 10
11Kecuali untuk [Wrapper and IDE errors](#wrapper-and-ide-errors), yang dicetak oleh program peluncur daripada Claude Code itu sendiri, kesalahan dan perintah pemulihan ini berlaku di seluruh CLI, [Desktop app](/docs/id/desktop), dan [cloud sessions](/docs/id/claude-code-on-the-web), karena ketiganya membungkus CLI Claude Code yang sama. Untuk masalah spesifik permukaan lainnya, lihat bagian pemecahan masalah di halaman permukaan tersebut.11Kecuali untuk [Wrapper and IDE errors](#wrapper-and-ide-errors), yang dicetak oleh program peluncur daripada Claude Code itu sendiri, kesalahan dan perintah pemulihan ini berlaku di seluruh CLI, [Desktop app](/docs/id/desktop), dan [cloud sessions](/docs/id/claude-code-on-the-web), karena ketiganya membungkus CLI Claude Code yang sama. Untuk masalah spesifik surface lainnya, lihat bagian pemecahan masalah di halaman surface tersebut.
12 12
13<Note>13<Note>
14 Claude Code memanggil Claude API untuk respons model, jadi sebagian besar kesalahan runtime memetakan ke kode kesalahan API yang mendasar. Halaman ini mencakup apa arti setiap kesalahan di dalam Claude Code dan cara memulihkan. Untuk definisi kode status HTTP mentah, lihat [Claude Platform error reference](https://platform.claude.com/docs/en/api/errors).14 Claude Code memanggil Claude API untuk respons model, jadi sebagian besar kesalahan runtime memetakan ke kode kesalahan API yang mendasar. Halaman ini mencakup apa arti setiap kesalahan di dalam Claude Code dan cara memulihkan. Untuk definisi kode status HTTP mentah, lihat [Claude Platform error reference](https://platform.claude.com/docs/en/api/errors).
176| `role 'system' must precede an 'assistant' message` | [Request errors](#role-system-must-precede-an-assistant-message) |176| `role 'system' must precede an 'assistant' message` | [Request errors](#role-system-must-precede-an-assistant-message) |
177| `Invalid encrypted_content in search_result block` / `Invalid encrypted_index in text block` / `Failed to decrypt web search result content` | [Request errors](#invalid-encrypted-content-in-search-result-block) |177| `Invalid encrypted_content in search_result block` / `Invalid encrypted_index in text block` / `Failed to decrypt web search result content` | [Request errors](#invalid-encrypted-content-in-search-result-block) |
178| `Invalid encrypted_stdout in encrypted_code_execution_result block` | [Request errors](#invalid-encrypted-content-in-search-result-block) |178| `Invalid encrypted_stdout in encrypted_code_execution_result block` | [Request errors](#invalid-encrypted-content-in-search-result-block) |
179| `server_tool_use.name: Input should be` pada setiap putaran sesi yang dilanjutkan | [Request errors](#unsupported-tool-content-removed) |179| `server_tool_use.name: Input should be` pada setiap giliran sesi yang dilanjutkan | [Request errors](#unsupported-tool-content-removed) |
180| `<model> can't help with this. Start a new session to continue` | [Request errors](#usage-policy-refusal) |180| `<model> can't help with this. Start a new session to continue` | [Request errors](#usage-policy-refusal) |
181| `Claude Code is unable to respond to this request, which appears to violate our Usage Policy` | [Request errors](#usage-policy-refusal) |181| `Claude Code is unable to respond to this request, which appears to violate our Usage Policy` | [Request errors](#usage-policy-refusal) |
182| `<model>'s safeguards flagged this message` | [Request errors](#safety-measures-flagged-a-cybersecurity-topic) |182| `<model>'s safeguards flagged this message` | [Request errors](#safety-measures-flagged-a-cybersecurity-topic) |
186| `The connection dropped while downloading the update` | [Installation errors](#the-connection-dropped-while-downloading-the-update) |186| `The connection dropped while downloading the update` | [Installation errors](#the-connection-dropped-while-downloading-the-update) |
187| `Download timed out: exceeded the total deadline` | [Installation errors](#the-connection-dropped-while-downloading-the-update) |187| `Download timed out: exceeded the total deadline` | [Installation errors](#the-connection-dropped-while-downloading-the-update) |
188| `--bg and --print conflict` | [Command-line errors](#conflict-between-bg-and-print) |188| `--bg and --print conflict` | [Command-line errors](#conflict-between-bg-and-print) |
189| `Error: Cannot use both --append-subagent-system-prompt and --append-subagent-system-prompt-file. Please use only one.` | [Command-line errors](#conflict-between-a-system-prompt-flag-and-its-file-form) |
189| `Cloud sessions cannot be created from a --restricted session` | [Command-line errors](#cloud-sessions-cannot-be-created-from-a-restricted-session) |190| `Cloud sessions cannot be created from a --restricted session` | [Command-line errors](#cloud-sessions-cannot-be-created-from-a-restricted-session) |
190| `Cloud sessions are disabled by your organization's policy` | [Command-line errors](#cloud-sessions-are-disabled-by-your-organizations-policy) |191| `Cloud sessions are disabled by your organization's policy` | [Command-line errors](#cloud-sessions-are-disabled-by-your-organizations-policy) |
191| `Couldn't verify your organization's policy for cloud sessions` | [Command-line errors](#cloud-sessions-are-disabled-by-your-organizations-policy) |192| `Couldn't verify your organization's policy for cloud sessions` | [Command-line errors](#cloud-sessions-are-disabled-by-your-organizations-policy) |
250| `Monitor "<name>" from plugin <plugin> references ${user_config.*} in its command` | [Plugin errors](#plugin-command-references-user-config) |251| `Monitor "<name>" from plugin <plugin> references ${user_config.*} in its command` | [Plugin errors](#plugin-command-references-user-config) |
251| `headersHelper for MCP server '<name>' references ${user_config.*}` | [Plugin errors](#plugin-command-references-user-config) |252| `headersHelper for MCP server '<name>' references ${user_config.*}` | [Plugin errors](#plugin-command-references-user-config) |
252| `Plugin archive integrity check failed` | [Plugin errors](#plugin-archive-integrity-check-failed) |253| `Plugin archive integrity check failed` | [Plugin errors](#plugin-archive-integrity-check-failed) |
254| `An npm plugin source must name a registry package` | [Plugin troubleshooting](/docs/id/plugins/troubleshooting#an-npm-plugin-source-must-name-a-registry-package) |
253| `path escapes plugin directory` | [Plugin errors](#path-escapes-plugin-directory) |255| `path escapes plugin directory` | [Plugin errors](#path-escapes-plugin-directory) |
254| `path could not be checked` | [Plugin errors](#path-could-not-be-checked) |256| `path could not be checked` | [Plugin errors](#path-could-not-be-checked) |
255| `its marketplace entry path does not stay inside the marketplace directory` | [Plugin errors](#marketplace-entry-path-does-not-stay-inside-the-marketplace-directory) |257| `its marketplace entry path does not stay inside the marketplace directory` | [Plugin errors](#marketplace-entry-path-does-not-stay-inside-the-marketplace-directory) |
418 Kesalahan server420 Kesalahan server
419</h2>421</h2>
420 422
421Sebagian besar kesalahan ini berasal dari penyedia inferensi: layanan Anthropic di Anthropic API, dan layanan di balik titik akhir penyedia tersebut di Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry, atau gateway khusus. [Auto mode tidak dapat menentukan keamanan suatu tindakan](#auto-mode-cannot-determine-the-safety-of-an-action) dan [Agent dihentikan lebih awal karena kesalahan API](#agent-terminated-early-due-to-an-api-error) juga mencakup penyebab di sisi Anda, seperti akun Amazon Bedrock yang tidak dapat memanggil model pengklasifikasi atau subagent yang mencapai batas penggunaan.423Sebagian besar kesalahan ini berasal dari penyedia inferensi: layanan Anthropic di Anthropic API, dan layanan di balik endpoint penyedia tersebut di Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry, atau gateway khusus. [Auto mode tidak dapat menentukan keamanan suatu tindakan](#auto-mode-cannot-determine-the-safety-of-an-action) dan [Agent dihentikan lebih awal karena kesalahan API](#agent-terminated-early-due-to-an-api-error) juga mencakup penyebab di sisi Anda, seperti akun Amazon Bedrock yang tidak dapat memanggil model pengklasifikasi atau subagent yang mencapai batas penggunaan.
422 424
423<h3 id="api-error-500-internal-server-error">425<h3 id="api-error-500-internal-server-error">
424 API Error: 500 Internal server error426 API Error: 500 Internal server error
432 434
433Kalimat terakhir menyebutkan tempat untuk memeriksa kesehatan layanan dan bervariasi menurut penyedia. Konfigurasi Amazon Bedrock, Google Cloud's Agent Platform, dan Microsoft Foundry menyebutkan status layanan penyedia tersebut. `ANTHROPIC_BASE_URL` khusus menyebutkan host gateway.435Kalimat terakhir menyebutkan tempat untuk memeriksa kesehatan layanan dan bervariasi menurut penyedia. Konfigurasi Amazon Bedrock, Google Cloud's Agent Platform, dan Microsoft Foundry menyebutkan status layanan penyedia tersebut. `ANTHROPIC_BASE_URL` khusus menyebutkan host gateway.
434 436
435Ini menunjukkan kegagalan yang tidak terduga di dalam API. Ini tidak disebabkan oleh prompt, pengaturan, atau akun Anda.437Respons 5xx dari API itu sendiri menunjukkan kegagalan yang tidak terduga di dalam API. Ini tidak disebabkan oleh prompt, pengaturan, atau akun Anda.
436 438
437Ketika proxy, load balancer, atau gateway menjawab dengan halaman kesalahan HTML, pesan menampilkan kode status dan judul halaman, seperti `API Error: 502 Bad Gateway`. Untuk halaman tanpa judul, pesan menampilkan kode status dan nama standarnya. Sebelum v2.1.281, kode status dijatuhkan ketika halaman memiliki judul, dan markup mentah halaman dicetak ketika tidak ada.439Ketika proxy, load balancer, atau gateway menjawab dengan halaman kesalahan HTML, pesan menampilkan kode status dan judul halaman, seperti `API Error: 502 Bad Gateway`. Untuk halaman tanpa judul, pesan menampilkan kode status dan nama standarnya. Sebelum v2.1.281, kode status dijatuhkan ketika halaman memiliki judul, dan markup mentah halaman dicetak ketika tidak ada.
438 440
446 API Error: Repeated 529 Overloaded errors448 API Error: Repeated 529 Overloaded errors
447</h3>449</h3>
448 450
449API sementara pada kapasitas di semua pengguna. Claude Code telah mencoba kembali beberapa kali sebelum menampilkan pesan ini:451API sementara pada kapasitas di semua pengguna. Claude Code telah mencoba ulang beberapa kali sebelum menampilkan pesan ini:
450 452
451```text theme={null}453```text theme={null}
452API Error: Repeated 529 Overloaded errors. The API is at capacity — this is usually temporary. Try again in a moment. If it persists, check https://status.claude.com.454API Error: Repeated 529 Overloaded errors. The API is at capacity — this is usually temporary. Try again in a moment. If it persists, check https://status.claude.com.
474Request timed out476Request timed out
475```477```
476 478
477Ini dapat terjadi selama periode beban tinggi atau ketika model menghasilkan respons yang sangat besar. Waktu tunggu permintaan default adalah 10 menit.479Ini dapat terjadi selama periode beban tinggi atau ketika model menghasilkan respons yang sangat besar. Timeout permintaan default adalah 10 menit.
478 480
479**Yang harus dilakukan:**481**Yang harus dilakukan:**
480 482
481* Coba lagi permintaan483* Coba lagi permintaan
482* Jika penyebabnya adalah jaringan lambat atau proxy, naikkan `API_TIMEOUT_MS` seperti yang dijelaskan dalam [Automatic retries](#automatic-retries)484* Jika penyebabnya adalah jaringan lambat atau proxy, naikkan `API_TIMEOUT_MS` seperti yang dijelaskan dalam [Automatic retries](#automatic-retries)
483* Jika waktu tunggu sering terjadi dan jaringan Anda sehat, lihat [Network and connection errors](#network-and-connection-errors) di bawah485* Jika timeout sering terjadi dan jaringan Anda sehat, lihat [Network and connection errors](#network-and-connection-errors) di bawah
484 486
485<h3 id="no-response-from-api">487<h3 id="no-response-from-api">
486 No response from API488 No response from API
487</h3>489</h3>
488 490
489Claude Code mengirim permintaan streaming dan API tidak mengembalikan header respons dalam batas waktu untuk byte pertama, jadi Claude Code membatalkan permintaan alih-alih menunggu waktu tunggu permintaan `API_TIMEOUT_MS` penuh, 10 menit secara default. Claude Code mengirim permintaan lagi paling banyak sekali, jika [retry budget](#tune-retry-behavior) memungkinkan. Ketika percobaan ulang juga tidak dijawab, giliran berakhir dengan pesan ini, yang menunjukkan berapa lama setiap upaya menunggu. Ketika Anda menetapkan [`CLAUDE_CODE_RETRY_WATCHDOG`](/docs/id/env-vars), batas satu percobaan ulang tidak berlaku dan Claude Code mencoba ulang di bawah anggaran yang dijelaskan dalam [Tune retry behavior](#tune-retry-behavior).491Claude Code mengirim permintaan streaming dan API tidak mengembalikan header respons dalam batas waktu untuk byte pertama, jadi Claude Code membatalkan permintaan alih-alih menunggu timeout permintaan `API_TIMEOUT_MS` penuh, 10 menit secara default. Claude Code mengirim permintaan lagi paling banyak sekali, jika [retry budget](#tune-retry-behavior) memungkinkan. Ketika retry juga tidak dijawab, giliran berakhir dengan pesan ini, yang menunjukkan berapa lama setiap upaya menunggu. Ketika Anda menetapkan [`CLAUDE_CODE_RETRY_WATCHDOG`](/docs/id/env-vars), batas satu retry tidak berlaku dan Claude Code mencoba ulang di bawah anggaran yang dijelaskan dalam [Tune retry behavior](#tune-retry-behavior).
490 492
491```text theme={null}493```text theme={null}
492API Error: No response from API (waited 3m, then 10m on the retry). If a proxy or gateway on your network holds responses until they complete, raise API_TIMEOUT_MS or CLAUDE_STREAM_FIRST_BYTE_TIMEOUT_MS to wait longer.494API Error: No response from API (waited 3m, then 10m on the retry). If a proxy or gateway on your network holds responses until they complete, raise API_TIMEOUT_MS or CLAUDE_STREAM_FIRST_BYTE_TIMEOUT_MS to wait longer.
493```495```
494 496
495Claude Code menetapkan tunggu header respons upaya pertama dan tunggu percobaan ulang secara terpisah:497Claude Code menetapkan tunggu header respons upaya pertama dan tunggu retry secara terpisah:
496 498
497* **Upaya pertama**: [`CLAUDE_STREAM_FIRST_BYTE_TIMEOUT_MS`](/docs/id/env-vars) ketika Anda menetapkannya ke 1 atau lebih, diklem antara 10 detik dan 30 menit. Jika tidak, Claude Code menggunakan waktu tunggu watchdog tingkat byte yang tercantum dalam [Streaming idle watchdogs](/docs/id/network-config#streaming-idle-watchdogs), jadi variabel yang mengubah waktu tunggu itu mengubah tunggu ini juga. Bagaimanapun, Claude Code menambahkan satu detik untuk setiap 32KB badan permintaan.499* **Upaya pertama**: [`CLAUDE_STREAM_FIRST_BYTE_TIMEOUT_MS`](/docs/id/env-vars) ketika Anda menetapkannya ke 1 atau lebih, diklem antara 10 detik dan 30 menit. Jika tidak, Claude Code menggunakan timeout watchdog tingkat byte yang tercantum dalam [Streaming idle watchdogs](/docs/id/network-config#streaming-idle-watchdogs), jadi variabel yang mengubah timeout itu mengubah tunggu ini juga. Bagaimanapun, Claude Code menambahkan satu detik untuk setiap 32KB badan permintaan.
498* **Percobaan ulang**: satu detik kurang dari `API_TIMEOUT_MS`, hanya di bawah 10 menit secara default, sehingga percobaan ulang dapat melampaui proxy atau gateway yang menahan respons hingga generasi selesai. Di Amazon Bedrock, percobaan ulang menggunakan batas waktu yang sama dengan upaya pertama, dan pesan menunjukkan satu durasi alih-alih dua.500* **Retry**: satu detik kurang dari `API_TIMEOUT_MS`, hanya di bawah 10 menit secara default, sehingga retry dapat melampaui proxy atau gateway yang menahan respons hingga generasi selesai. Di Amazon Bedrock, retry menggunakan batas waktu yang sama dengan upaya pertama, dan pesan menunjukkan satu durasi alih-alih dua.
499 501
500Tidak ada tunggu yang melebihi satu detik kurang dari `API_TIMEOUT_MS` positif, dan `API_TIMEOUT_MS` positif di bawah 11 detik mematikan batas waktu. Watchdog tingkat byte dimulai hanya setelah header respons tiba, jadi respons yang berhenti mengirim byte setelah itu mengikuti [stalled-stream rules](#automatic-retries) alih-alih batas waktu ini.502Tidak ada tunggu yang melebihi satu detik kurang dari `API_TIMEOUT_MS` positif, dan `API_TIMEOUT_MS` positif di bawah 11 detik mematikan batas waktu. Watchdog tingkat byte dimulai hanya setelah header respons tiba, jadi respons yang berhenti mengirim byte setelah itu mengikuti [stalled-stream rules](#automatic-retries) alih-alih batas waktu ini.
501 503
503 505
504* Kirim pesan Anda lagi. Pesan asli Anda masih ada dalam percakapan, jadi untuk prompt yang panjang Anda dapat mengetik `try again` alih-alih menempel seluruh hal.506* Kirim pesan Anda lagi. Pesan asli Anda masih ada dalam percakapan, jadi untuk prompt yang panjang Anda dapat mengetik `try again` alih-alih menempel seluruh hal.
505* Jika terulang, perlakukan sebagai [network or proxy problem](#unable-to-connect-to-api).507* Jika terulang, perlakukan sebagai [network or proxy problem](#unable-to-connect-to-api).
506* Jika proxy atau gateway di jaringan Anda menahan respons hingga selesai, naikkan `API_TIMEOUT_MS` sehingga percobaan ulang menunggu lebih lama. Di Amazon Bedrock, naikkan `CLAUDE_STREAM_FIRST_BYTE_TIMEOUT_MS` juga.508* Jika proxy atau gateway di jaringan Anda menahan respons hingga selesai, naikkan `API_TIMEOUT_MS` sehingga retry menunggu lebih lama. Di Amazon Bedrock, naikkan `CLAUDE_STREAM_FIRST_BYTE_TIMEOUT_MS` juga.
507* Jika upaya pertama terus habis waktu dan percobaan ulang kemudian berhasil, naikkan `CLAUDE_STREAM_FIRST_BYTE_TIMEOUT_MS` sehingga upaya pertama juga menunggu cukup lama.509* Jika upaya pertama terus habis waktu dan retry kemudian berhasil, naikkan `CLAUDE_STREAM_FIRST_BYTE_TIMEOUT_MS` sehingga upaya pertama juga menunggu cukup lama.
508 510
509Sebelum v2.1.242, Claude Code menunggu waktu tunggu permintaan `API_TIMEOUT_MS` penuh, 10 menit secara default, sebelum gagal permintaan streaming yang tidak dijawab. Sebelum v2.1.261, percobaan ulang menunggu batas waktu yang sama dengan upaya pertama dan pesan tidak menunjukkan durasi.511Sebelum v2.1.242, Claude Code menunggu timeout permintaan `API_TIMEOUT_MS` penuh, 10 menit secara default, sebelum menggagalkan permintaan streaming yang tidak dijawab. Sebelum v2.1.261, retry menunggu batas waktu yang sama dengan upaya pertama dan pesan tidak menunjukkan durasi.
510 512
511<h3 id="the-response-above-may-be-incomplete">513<h3 id="the-response-above-may-be-incomplete">
512 The response above may be incomplete514 The response above may be incomplete
513</h3>515</h3>
514 516
515Permintaan streaming gagal sementara respons masih berlangsung, setelah Claude menyelesaikan blok teks atau panggilan alat, atau telah memulai satu setelah menyelesaikan pemikirannya. Mengirim ulang permintaan dapat menjalankan panggilan alat yang sama dua kali, jadi Claude Code menyimpan output yang Claude selesaikan dan menambahkan pemberitahuan ini alih-alih membuang giliran. Varian mana yang Anda lihat menyebutkan penyebabnya:517Permintaan streaming gagal sementara respons masih berlangsung, setelah Claude menyelesaikan blok teks atau panggilan tool, atau telah memulai satu setelah menyelesaikan pemikirannya. Mengirim ulang permintaan dapat menjalankan panggilan tool yang sama dua kali, jadi Claude Code menyimpan output yang Claude selesaikan dan menambahkan pemberitahuan ini alih-alih membuang giliran. Varian mana yang Anda lihat menyebutkan penyebabnya:
516 518
517```text theme={null}519```text theme={null}
518API Error: Server error mid-response. The response above may be incomplete.520API Error: Server error mid-response. The response above may be incomplete.
526* `Server error mid-response`: kesalahan server overloaded atau 5xx mid-stream. Varian ini memerlukan Claude Code v2.1.199 atau lebih baru; sebelumnya kasus itu membuang output parsial dan melaporkan seluruh giliran sebagai kesalahan.528* `Server error mid-response`: kesalahan server overloaded atau 5xx mid-stream. Varian ini memerlukan Claude Code v2.1.199 atau lebih baru; sebelumnya kasus itu membuang output parsial dan melaporkan seluruh giliran sebagai kesalahan.
527* `Connection lost mid-response`: koneksi putus. Anda juga melihat varian ini ketika proxy atau gateway mengakhiri badan respons dengan bersih sebelum respons selesai.529* `Connection lost mid-response`: koneksi putus. Anda juga melihat varian ini ketika proxy atau gateway mengakhiri badan respons dengan bersih sebelum respons selesai.
528* `Your computer went to sleep mid-response`: Claude Code mendeteksi bahwa komputer Anda tertidur saat respons streaming. Setelah komputer Anda bangun, Claude Code memperlakukan koneksi sebagai rusak dan berhenti membacanya.530* `Your computer went to sleep mid-response`: Claude Code mendeteksi bahwa komputer Anda tertidur saat respons streaming. Setelah komputer Anda bangun, Claude Code memperlakukan koneksi sebagai rusak dan berhenti membacanya.
529* `Part of the response never arrived`: peristiwa aliran dijatuhkan antara API dan Claude Code, jadi peristiwa yang lebih baru mereferensikan konten yang tidak pernah tiba. Sebelum v2.1.281, kasus ini mengakhiri giliran dengan `API Error: Content block not found`.531* `Part of the response never arrived`: peristiwa stream dijatuhkan antara API dan Claude Code, jadi peristiwa yang lebih baru mereferensikan konten yang tidak pernah tiba. Sebelum v2.1.281, kasus ini mengakhiri giliran dengan `API Error: Content block not found`.
530* `The response stream was malformed`: peristiwa tiba untuk blok konten yang sudah selesai, atau peristiwa tiba rusak. Peristiwa yang rusak adalah peristiwa yang datanya bukan JSON yang valid, yang kontennya hilang, atau yang kontennya tidak cocok dengan jenis peristiwa. Sebelum v2.1.284, kesalahan parser mentah, seperti yang dimulai dengan `API Error: JSON Parse error`, muncul sebagai gantinya ketika peristiwa dengan JSON yang tidak valid tiba setelah Claude menyelesaikan pemikirannya, blok teks, atau panggilan alat.532* `The response stream was malformed`: peristiwa tiba untuk blok konten yang sudah selesai, atau peristiwa tiba rusak. Peristiwa yang rusak adalah peristiwa yang datanya bukan JSON yang valid, yang kontennya hilang, atau yang kontennya tidak cocok dengan jenis peristiwa. Sebelum v2.1.284, kesalahan parser mentah, seperti yang dimulai dengan `API Error: JSON Parse error`, muncul sebagai gantinya ketika peristiwa dengan JSON yang tidak valid tiba setelah Claude menyelesaikan pemikirannya, blok teks, atau panggilan tool. Sebelum v2.1.287, ketika [guardrail Amazon Bedrock](/docs/id/amazon-bedrock#aws-guardrails) memblokir respons yang sudah melakukan streaming thinking dan sebagian teks, varian ini muncul menggantikan pesan guardrail tersebut.
531* `The response stopped arriving`: koneksi tetap terbuka tetapi berhenti mengirimkan data, jadi watchdog streaming idle membatalkannya. Sebelum v2.1.222, Claude Code juga dapat melaporkan kegagalan ini pada koneksi [gateway](/docs/id/gateways) yang dicapai melalui `ANTHROPIC_BASE_URL` atau `ANTHROPIC_AWS_BASE_URL` sementara ping keep-alive server masih tiba, karena hanya menghitung peristiwa respons yang diurai di sana; upgrade menghentikan waktu tunggu palsu itu di rute tersebut. Gateway yang dicapai melalui URL dasar penyedia seperti `ANTHROPIC_BEDROCK_BASE_URL` tidak dibungkus oleh watchdog byte; lihat [Streaming idle watchdogs](/docs/id/network-config#streaming-idle-watchdogs).533* `The response stopped arriving`: koneksi tetap terbuka tetapi berhenti mengirimkan data, jadi watchdog streaming idle membatalkannya. Sebelum v2.1.222, Claude Code juga dapat melaporkan kegagalan ini pada koneksi [gateway](/docs/id/gateways) yang dicapai melalui `ANTHROPIC_BASE_URL` atau `ANTHROPIC_AWS_BASE_URL` sementara ping keep-alive server masih tiba, karena hanya menghitung peristiwa respons yang diurai di sana; upgrade menghentikan timeout palsu itu di rute tersebut. Gateway yang dicapai melalui URL dasar penyedia seperti `ANTHROPIC_BEDROCK_BASE_URL` tidak dibungkus oleh watchdog byte; lihat [Streaming idle watchdogs](/docs/id/network-config#streaming-idle-watchdogs).
532 534
533Sebelum v2.1.227, `Connection lost mid-response` membaca `Connection closed mid-response` dan `The response stopped arriving` membaca `Response stalled mid-stream`.535Sebelum v2.1.227, `Connection lost mid-response` berbunyi `Connection closed mid-response` dan `The response stopped arriving` berbunyi `Response stalled mid-stream`.
534 536
535Ketika peristiwa aliran yang dijatuhkan, diduplikasi, atau rusak tiba sebelum Claude memulai teks atau panggilan alat apa pun, Anda tidak melihat pemberitahuan ini:537Ketika peristiwa stream yang dijatuhkan, diduplikasi, atau rusak tiba sebelum Claude memulai teks atau panggilan tool apa pun, Anda tidak melihat pemberitahuan ini:
536 538
537* Jika Claude hanya menyelesaikan pemikirannya, Claude Code mengeluarkan kembali permintaan. Ketika aliran yang diterbitkan kembali putus dengan cara yang sama, giliran berakhir dengan `Part of the response never arrived and no response was produced. Try again.` atau `The response stream was malformed and no response was produced. Try again.`539* Jika Claude hanya menyelesaikan pemikirannya, Claude Code mengeluarkan kembali permintaan. Ketika stream yang diterbitkan kembali putus dengan cara yang sama, giliran berakhir dengan `Part of the response never arrived and no response was produced. Try again.` atau `The response stream was malformed and no response was produced. Try again.`
538* Jika tidak ada yang selesai, Claude Code mengirim ulang permintaan tanpa streaming. Jika Anda mematikan fallback itu dengan [`CLAUDE_CODE_DISABLE_NONSTREAMING_FALLBACK`](/docs/id/env-vars), giliran berakhir dengan `API Error: Content block not found` untuk peristiwa yang dijatuhkan atau `API Error: Content block already closed` untuk peristiwa yang diduplikasi. Untuk peristiwa yang rusak dengan fallback dimatikan, giliran berakhir dengan `API Error: Stream event unreadable` atau kesalahan parser mentah.540* Jika tidak ada yang selesai, Claude Code mengirim ulang permintaan tanpa streaming. Jika Anda mematikan fallback itu dengan [`CLAUDE_CODE_DISABLE_NONSTREAMING_FALLBACK`](/docs/id/env-vars), giliran berakhir dengan `API Error: Content block not found` untuk peristiwa yang dijatuhkan atau `API Error: Content block already closed` untuk peristiwa yang diduplikasi. Untuk peristiwa yang rusak dengan fallback dimatikan, giliran berakhir dengan `API Error: Stream event unreadable` atau kesalahan parser mentah.
539 541
540Dalam empat kasus, Claude Code menangani kegagalan tanpa menampilkan pemberitahuan ini segera:542Dalam empat kasus, Claude Code menangani kegagalan tanpa menampilkan pemberitahuan ini segera:
541 543
542* Sebelumnya dalam respons, Claude Code baik mencoba ulang kegagalan atau mengakhiri giliran dengan kesalahan yang berbeda. Lihat [Automatic retries](#automatic-retries).544* Sebelumnya dalam respons, Claude Code baik mencoba ulang kegagalan atau mengakhiri giliran dengan kesalahan yang berbeda. Lihat [Automatic retries](#automatic-retries).
543* Ketika salah satu kegagalan ini tiba setelah Claude menyelesaikan respons, Claude Code menyimpan respons lengkap dan mengakhiri giliran secara normal, tanpa pemberitahuan ini. Sebelum v2.1.222, Claude Code menampilkan pemberitahuan ini ketika koneksi putus atau macet setelah respons selesai, dan melaporkan giliran sebagai kesalahan meskipun respons lengkap.545* Ketika salah satu kegagalan ini tiba setelah Claude menyelesaikan respons, Claude Code menyimpan respons lengkap dan mengakhiri giliran secara normal, tanpa pemberitahuan ini. Sebelum v2.1.222, Claude Code menampilkan pemberitahuan ini ketika koneksi putus atau macet setelah respons selesai, dan melaporkan giliran sebagai kesalahan meskipun respons lengkap.
544* Dalam [non-interactive session](/docs/id/headless), seperti run `-p`, run [Agent SDK](/docs/id/agent-sdk/overview), atau [cloud session](/docs/id/claude-code-on-the-web), Anda tidak harus mengirim `continue` sendiri ketika respons cut-off berada dalam percakapan utama dan berisi teks tetapi tidak ada panggilan alat: Claude Code menyimpan output parsial dan meminta Claude untuk melanjutkan dari tempat ia berhenti, hingga tiga kali berturut-turut. Anda melihat pemberitahuan ini untuk respons seperti itu hanya setelah Claude Code menggunakan kelanjutan itu. Sebelum v2.1.246, Claude Code mengakhiri giliran non-interaktif dengan pemberitahuan ini pada cut-off pertama.546* Dalam [non-interactive session](/docs/id/headless), seperti run `-p`, run [Agent SDK](/docs/id/agent-sdk/overview), atau [cloud session](/docs/id/claude-code-on-the-web), Anda tidak harus mengirim `continue` sendiri ketika respons cut-off berada dalam percakapan utama dan berisi teks tetapi tidak ada panggilan tool: Claude Code menyimpan output parsial dan meminta Claude untuk melanjutkan dari tempat ia berhenti, hingga tiga kali berturut-turut. Anda melihat pemberitahuan ini untuk respons seperti itu hanya setelah Claude Code menggunakan kelanjutan itu. Sebelum v2.1.246, Claude Code mengakhiri giliran non-interaktif dengan pemberitahuan ini pada cut-off pertama.
545* Dalam [subagent](/docs/id/sub-agents#api-errors-in-subagents), apakah sesi interaktif atau tidak: ketika respons cut-off-nya berisi teks tetapi tidak ada panggilan alat, Claude Code meminta subagent untuk melanjutkan. Pemberitahuan menjadi pesan terakhir subagent hanya setelah kelanjutan itu digunakan. Sebelum v2.1.257, subagent menampilkan pemberitahuan ini pada cut-off pertama.547* Dalam [subagent](/docs/id/sub-agents#api-errors-in-subagents), apakah sesi interaktif atau tidak: ketika respons cut-off-nya berisi teks tetapi tidak ada panggilan tool, Claude Code meminta subagent untuk melanjutkan. Pemberitahuan menjadi pesan terakhir subagent hanya setelah kelanjutan itu digunakan. Sebelum v2.1.257, subagent menampilkan pemberitahuan ini pada cut-off pertama.
546 548
547**Yang harus dilakukan:**549**Yang harus dilakukan:**
548 550
549* Dalam sesi interaktif, baca respons yang tetap di layar: Claude Code menyimpan setiap blok yang Claude selesaikan sebelum kesalahan, tetapi membuang blok akhir yang terputus ketika giliran berakhir, jadi kalimat atau panggilan alat terakhir mungkin hilang. Balas dengan `continue` untuk membuat Claude melanjutkan dari blok terakhir yang diselesaikannya.551* Dalam sesi interaktif, baca respons yang tetap di layar: Claude Code menyimpan setiap blok yang Claude selesaikan sebelum kesalahan, tetapi membuang blok akhir yang terputus ketika giliran berakhir, jadi kalimat atau panggilan tool terakhir mungkin hilang. Balas dengan `continue` untuk membuat Claude melanjutkan dari blok terakhir yang diselesaikannya.
550* Dalam [non-interactive mode](/docs/id/headless) (`-p`):552* Dalam [non-interactive mode](/docs/id/headless) (`-p`):
551 * Dengan output teks default, Claude Code mencetak blok teks terakhir yang diselesaikan yang masih dipegang dari sebelumnya dalam giliran, diikuti oleh pesan ini. Ketika tidak memegang apa pun, Claude Code mencetak pesan ini saja, misalnya karena Claude Code memadatkan percakapan di tengah-giliran dan menghapus teks itu. Sebelum v2.1.219, Claude Code hanya mencetak pesan ini dalam output teks `-p` dan menjatuhkan respons yang sudah dihasilkan.553 * Dengan output teks default, Claude Code mencetak blok teks terakhir yang diselesaikan yang masih dipegang dari sebelumnya dalam giliran, diikuti oleh pesan ini. Ketika tidak memegang apa pun, Claude Code mencetak pesan ini saja, misalnya karena Claude Code memadatkan percakapan di tengah-giliran dan menghapus teks itu. Sebelum v2.1.219, Claude Code hanya mencetak pesan ini dalam output teks `-p` dan menjatuhkan respons yang sudah dihasilkan.
552 * Dengan `--output-format json` atau `stream-json`, Claude Code melaporkan pesan ini di bidang `result`.554 * Dengan `--output-format json` atau `stream-json`, Claude Code melaporkan pesan ini di bidang `result`.
566<model> is temporarily unavailable, so auto mode cannot determine the safety of <tool> right now. Wait a moment and then try this action again.568<model> is temporarily unavailable, so auto mode cannot determine the safety of <tool> right now. Wait a moment and then try this action again.
567```569```
568 570
569Ketika Claude Code dapat menentukan kategori kegagalan, ia menyebutkan kategori dalam tanda kurung setelah `temporarily unavailable`, misalnya `<model> is temporarily unavailable (rate-limited), so auto mode cannot determine the safety of <tool> right now`. Kategorinya adalah `(rate-limited)`, `(overloaded)`, `(server error)`, `(timed out)`, dan `(connection failed)`. Jika `(timed out)` atau `(connection failed)` terulang, periksa koneksi Anda; lihat [Unable to connect to API](#unable-to-connect-to-api). Sebelum v2.1.229, pesan tidak pernah menyebutkan kategori dan membaca `Wait briefly and then try this action again`.571Ketika Claude Code dapat menentukan kategori kegagalan, ia menyebutkan kategori dalam tanda kurung setelah `temporarily unavailable`, misalnya `<model> is temporarily unavailable (rate-limited), so auto mode cannot determine the safety of <tool> right now`. Kategorinya adalah `(rate-limited)`, `(overloaded)`, `(server error)`, `(timed out)`, dan `(connection failed)`. Jika `(timed out)` atau `(connection failed)` terulang, periksa koneksi Anda; lihat [Unable to connect to API](#unable-to-connect-to-api). Sebelum v2.1.229, pesan tidak pernah menyebutkan kategori dan berbunyi `Wait briefly and then try this action again`.
570 572
571Ketika tidak ada kategori yang cocok, pesan muncul tanpa kategori dalam tanda kurung; lebih dari satu kegagalan menghasilkan bentuk itu. Di [Amazon Bedrock](/docs/id/amazon-bedrock), termasuk [Mantle endpoint](/docs/id/amazon-bedrock#use-the-mantle-endpoint), itu juga muncul ketika akun AWS Anda tidak dapat memanggil model yang disebutkan dalam pesan, dan kegagalan itu terulang pada setiap percobaan ulang sampai akun Anda diberi akses ke model.573Ketika tidak ada kategori yang cocok, pesan muncul tanpa kategori dalam tanda kurung; lebih dari satu kegagalan menghasilkan bentuk itu. Di [Amazon Bedrock](/docs/id/amazon-bedrock), termasuk [Mantle endpoint](/docs/id/amazon-bedrock#use-the-mantle-endpoint), itu juga muncul ketika akun AWS Anda tidak dapat memanggil model yang disebutkan dalam pesan, dan kegagalan itu terulang pada setiap retry sampai akun Anda diberi akses ke model.
572 574
573**Yang harus dilakukan:**575**Yang harus dilakukan:**
574 576
575* Coba lagi setelah beberapa detik; Claude melihat pesan yang sama dan biasanya mencoba ulang sendiri. Kegagalan sementara tidak terkait dengan [auto mode eligibility](/docs/id/permission-modes#eliminate-prompts-with-auto-mode); Anda tidak perlu mengubah pengaturan577* Coba lagi setelah beberapa detik; Claude melihat pesan yang sama dan biasanya mencoba ulang sendiri. Kegagalan sementara tidak terkait dengan [auto mode eligibility](/docs/id/permission-modes#eliminate-prompts-with-auto-mode); Anda tidak perlu mengubah pengaturan
576* Jika percobaan ulang terus gagal, lanjutkan dengan tugas read-only dan kembali ke tindakan yang diblokir nanti578* Jika retry terus gagal, lanjutkan dengan tugas read-only dan kembali ke tindakan yang diblokir nanti
577* Di Amazon Bedrock, jika pesan kembali pada setiap percobaan ulang, periksa bahwa akun Anda dapat memanggil model yang disebutkan: untuk model Amazon Bedrock standar, konfirmasi [IAM policy](/docs/id/amazon-bedrock#iam-configuration) Anda memungkinkan memanggilnya; untuk ID model Mantle, [hubungi tim akun AWS Anda](/docs/id/amazon-bedrock#mantle-endpoint-errors)579* Di Amazon Bedrock, jika pesan kembali pada setiap retry, periksa bahwa akun Anda dapat memanggil model yang disebutkan: untuk model Amazon Bedrock standar, konfirmasi [IAM policy](/docs/id/amazon-bedrock#iam-configuration) Anda memungkinkan memanggilnya; untuk ID model Mantle, [hubungi tim akun AWS Anda](/docs/id/amazon-bedrock#mantle-endpoint-errors)
578 580
579Ketika permintaan pengklasifikasi gagal karena token OAuth Anda kedaluwarsa atau diputar oleh sesi lain, Claude Code menyegarkan token dan mencoba ulang permintaan sekali, jadi kedaluwarsa token rutin tidak muncul sebagai pesan ini. Sebelum v2.1.216, token yang kedaluwarsa atau diputar gagal setiap permintaan pengklasifikasi, dan auto mode menolak setiap tindakan yang diperiksa dengan pesan ini sampai token disegarkan.581Ketika permintaan pengklasifikasi gagal karena token OAuth Anda kedaluwarsa atau diputar oleh sesi lain, Claude Code menyegarkan token dan mencoba ulang permintaan sekali, jadi kedaluwarsa token biasa tidak muncul sebagai pesan ini. Sebelum v2.1.216, token yang kedaluwarsa atau diputar menggagalkan setiap permintaan pengklasifikasi, dan auto mode menolak setiap tindakan yang diperiksa dengan pesan ini sampai token disegarkan.
580 582
581Ketika pengklasifikasi mengembalikan respons yang tidak dapat diurai:583Ketika pengklasifikasi mengembalikan respons yang tidak dapat diurai:
582 584
609* Dalam sesi interaktif, beralih ke [permission mode](/docs/id/permission-modes) yang berbeda sehingga Anda dapat menyetujui tindakan ketika diminta611* Dalam sesi interaktif, beralih ke [permission mode](/docs/id/permission-modes) yang berbeda sehingga Anda dapat menyetujui tindakan ketika diminta
610* Mulai percakapan segar tanpa konten pemicu612* Mulai percakapan segar tanpa konten pemicu
611 613
612Ketika percakapan telah tumbuh lebih besar dari jendela konteks pengklasifikasi:614Ketika percakapan telah tumbuh lebih besar dari context window pengklasifikasi:
613 615
614```text theme={null}616```text theme={null}
615Auto mode classifier transcript exceeded context window — falling back to manual approval (try /compact to reduce conversation size)617Auto mode classifier transcript exceeded context window — falling back to manual approval (try /compact to reduce conversation size)
617 619
618Apa yang terjadi pada tindakan tergantung pada tempat Claude memintanya:620Apa yang terjadi pada tindakan tergantung pada tempat Claude memintanya:
619 621
620* Dalam sesi interaktif, auto mode kembali ke prompt izin normal untuk tindakan itu sehingga Anda dapat menyetujui atau menolaknya secara manual622* Dalam sesi interaktif, auto mode melakukan fallback ke dialog izin normal untuk tindakan itu sehingga Anda dapat menyetujui atau menolaknya secara manual
621* Ke [background subagent](/docs/id/sub-agents#run-subagents-in-foreground-or-background) dalam run `-p` [non-interactive](/docs/id/headless) tanpa `--input-format stream-json`, Claude Code mengembalikan hasil kesalahan yang berisi `Agent aborted: auto mode classifier transcript exceeded context window in headless mode`, dan run berlanjut623* Ke [background subagent](/docs/id/sub-agents#run-subagents-in-foreground-or-background) dalam run `-p` [non-interactive](/docs/id/headless) tanpa `--input-format stream-json`, Claude Code mengembalikan hasil kesalahan yang berisi `Agent aborted: auto mode classifier transcript exceeded context window in headless mode`, dan run berlanjut
622* Di tempat lain dalam run `-p` tanpa [`--permission-prompt-tool`](/docs/id/cli-reference#cli-flags), tidak ada prompt untuk kembali, jadi tindakan tidak berjalan dan run berlanjut624* Di tempat lain dalam run `-p` tanpa [`--permission-prompt-tool`](/docs/id/cli-reference#cli-flags), tidak ada dialog izin untuk fallback, jadi tindakan tidak berjalan dan run berlanjut
623 625
624**Yang harus dilakukan:**626**Yang harus dilakukan:**
625 627
626* Dalam sesi interaktif, setujui atau tolak tindakan dalam prompt yang muncul628* Dalam sesi interaktif, setujui atau tolak tindakan dalam dialog izin yang muncul
627* Dalam sesi interaktif, jalankan `/compact` untuk mengurangi ukuran percakapan sehingga tindakan berikutnya cocok dalam jendela pengklasifikasi lagi629* Dalam sesi interaktif, jalankan `/compact` untuk mengurangi ukuran percakapan sehingga tindakan berikutnya cocok dalam jendela pengklasifikasi lagi
628 630
629<h3 id="the-server-returned-no-safety-verdict">631<h3 id="the-server-returned-no-safety-verdict">
636The server-side auto mode classifier gave no verdict (timed out), so auto mode cannot determine the safety of <tool>.638The server-side auto mode classifier gave no verdict (timed out), so auto mode cannot determine the safety of <tool>.
637```639```
638 640
639Sisa pesan memberi tahu Claude apakah satu percobaan ulang dapat membantu. Sebelum beberapa penolakan ini, Claude Code menunggu sehingga upaya Claude berikutnya tidak mengikuti sekaligus. Selama tunggu dalam sesi interaktif, spinner menunjukkan `Auto mode check unavailable` dengan hitungan mundur, dan menekan `Esc` mengganggu giliran.641Sisa pesan memberi tahu Claude apakah satu retry dapat membantu. Sebelum beberapa penolakan ini, Claude Code menunggu sehingga upaya Claude berikutnya tidak mengikuti sekaligus. Selama tunggu dalam sesi interaktif, spinner menunjukkan `Auto mode check unavailable` dengan hitungan mundur, dan menekan `Esc` mengganggu giliran.
640 642
641Setelah sepuluh respons berturut-turut tanpa putusan, auto mode menghentikan giliran:643Setelah sepuluh respons berturut-turut tanpa putusan, auto mode menghentikan giliran:
642 644
647Pesan berhenti muncul di tempat yang berbeda dalam setiap jenis sesi:649Pesan berhenti muncul di tempat yang berbeda dalam setiap jenis sesi:
648 650
649* Dalam sesi interaktif, pesan muncul sebagai peringatan dalam transkrip dan giliran berakhir651* Dalam sesi interaktif, pesan muncul sebagai peringatan dalam transkrip dan giliran berakhir
650* Dalam run `-p` [non-interactive](/docs/id/headless), run berakhir dan melaporkan kesalahan eksekusi. Dengan output teks default, pesan mencetak di stderr.652* Dalam run `-p` [non-interactive](/docs/id/headless), run berakhir dan melaporkan kesalahan eksekusi. Dengan output teks default, pesan dicetak di stderr.
651* Ketika [subagent](/docs/id/sub-agents) mencapai batas, subagent berhenti sebelum selesai, dan Claude menerima apa pun yang dihasilkan dengan catatan bahwa auto mode menghentikannya653* Ketika [subagent](/docs/id/sub-agents) mencapai batas, subagent berhenti sebelum selesai, dan Claude menerima apa pun yang dihasilkan dengan catatan bahwa auto mode menghentikannya
652 654
653**Yang harus dilakukan:**655**Yang harus dilakukan:**
663 Agent terminated early due to an API error665 Agent terminated early due to an API error
664</h3>666</h3>
665 667
666Permintaan API [subagent](/docs/id/sub-agents) gagal secara terminal, misalnya karena batas penggunaan tercapai atau percobaan ulang untuk kesalahan server habis, jadi subagent berhenti sebelum menyelesaikan tugasnya. Pesan ini memerlukan Claude Code v2.1.199 atau lebih baru; sebelumnya teks kesalahan API dikembalikan ke Claude seolah-olah itu adalah hasil subagent.668Permintaan API [subagent](/docs/id/sub-agents) gagal secara terminal, misalnya karena batas penggunaan tercapai atau retry untuk kesalahan server habis, jadi subagent berhenti sebelum menyelesaikan tugasnya. Pesan ini memerlukan Claude Code v2.1.199 atau lebih baru; sebelumnya teks kesalahan API dikembalikan ke Claude seolah-olah itu adalah hasil subagent.
667 669
668```text theme={null}670```text theme={null}
669Agent terminated early due to an API error: <error detail>671Agent terminated early due to an API error: <error detail>
674* Cocokkan detail kesalahan setelah titik dua dengan bagiannya sendiri di halaman ini, seperti [Usage limits](#usage-limits) atau [Server errors](#server-errors), dan ikuti langkah bagian itu676* Cocokkan detail kesalahan setelah titik dua dengan bagiannya sendiri di halaman ini, seperti [Usage limits](#usage-limits) atau [Server errors](#server-errors), dan ikuti langkah bagian itu
675* Setelah kesalahan yang mendasar hilang, minta Claude untuk mencoba ulang tugas atau [resume the subagent](/docs/id/sub-agents#resume-subagents)677* Setelah kesalahan yang mendasar hilang, minta Claude untuk mencoba ulang tugas atau [resume the subagent](/docs/id/sub-agents#resume-subagents)
676 678
677Ketika batas laju, overload, atau kesalahan server mengganggu subagent foreground yang sudah menghasilkan output teks, Claude menerima output parsial itu ditandai sebagai tidak lengkap alih-alih kesalahan ini. Subagent yang satu-satunya output adalah panggilan alat mendapat kesalahan ini juga; dalam v2.1.199 bentuk itu mengembalikan hasil parsial kosong. Lihat [API errors in subagents](/docs/id/sub-agents#api-errors-in-subagents).679Ketika rate limit, overload, atau kesalahan server mengganggu subagent foreground yang sudah menghasilkan output teks, Claude menerima output parsial itu ditandai sebagai tidak lengkap alih-alih kesalahan ini. Subagent yang satu-satunya output adalah panggilan tool mendapat kesalahan ini juga; dalam v2.1.199 bentuk itu mengembalikan hasil parsial kosong. Lihat [API errors in subagents](/docs/id/sub-agents#api-errors-in-subagents).
678 680
679<h2 id="usage-limits">681<h2 id="usage-limits">
680 Batas penggunaan682 Batas penggunaan
885 Kesalahan autentikasi887 Kesalahan autentikasi
886</h2>888</h2>
887 889
888Kesalahan ini berarti Claude Code tidak dapat membuktikan identitas Anda kepada API. Jalankan `/status` kapan saja untuk melihat kredensial mana yang saat ini aktif.890Kesalahan-kesalahan ini berarti Claude Code tidak dapat membuktikan identitas Anda kepada API. Jalankan `/status` kapan saja untuk melihat kredensial mana yang sedang aktif.
889 891
890<h3 id="not-logged-in">892<h3 id="not-logged-in">
891 Belum masuk893 Belum masuk
892</h3>894</h3>
893 895
894Tidak ada kredensial yang valid tersedia untuk sesi ini.896Tidak ada kredensial valid yang tersedia untuk sesi ini.
895 897
896```text theme={null}898```text theme={null}
897Not logged in · Please run /login899Not logged in · Please run /login
898```900```
899 901
900Dalam sesi yang dijalankan aplikasi Claude Desktop, seperti tab Code atau Cowork, pesan berbunyi `Authentication required · Sign in again to continue`, dan Anda masuk lagi dari aplikasi.902Dalam sesi yang dijalankan oleh aplikasi Claude Desktop, seperti tab Code atau Cowork, pesannya berbunyi `Authentication required · Sign in again to continue`, dan Anda masuk kembali dari aplikasi tersebut.
903
904Jika Anda masuk dengan akun claude.ai Anda di jendela Claude Code lain yang menggunakan [direktori konfigurasi](/docs/id/claude-directory) yang sama, sesi interaktif yang menampilkan pesan ini akan mulai menggunakan login tersebut dengan sendirinya. Anda tidak perlu memulai ulang sesi tersebut.
905
906Sebelum v2.1.286 di macOS, sesi dapat terus menampilkan pesan tersebut setelah Anda masuk dari jendela lain. Pada versi-versi tersebut, mulai ulang sesi yang menampilkan pesan tersebut.
901 907
902**Yang harus dilakukan:**908**Yang harus dilakukan:**
903 909
904* Jalankan `/login` untuk autentikasi dengan langganan Claude atau akun Console Anda910* Jalankan `/login` untuk melakukan autentikasi dengan langganan Claude atau akun Console Anda
905* Jika Anda mengharapkan variabel lingkungan untuk mengautentikasi Anda, konfirmasi bahwa `ANTHROPIC_API_KEY` diatur dan diekspor di shell tempat Anda meluncurkan `claude`911* Jika Anda mengharapkan environment variable mengautentikasi Anda, pastikan `ANTHROPIC_API_KEY` telah diatur dan diekspor di shell tempat Anda menjalankan `claude`
906* Untuk CI atau otomasi di mana login interaktif tidak mungkin, konfigurasikan skrip [`apiKeyHelper`](/docs/id/settings-reference#apikeyhelper) yang mengambil kunci saat startup912* Untuk CI atau otomatisasi yang tidak memungkinkan login interaktif, konfigurasikan skrip [`apiKeyHelper`](/docs/id/settings-reference#apikeyhelper) yang mengambil kunci saat startup
907* Lihat [Urutan prioritas autentikasi](/docs/id/authentication#authentication-precedence) untuk memahami kredensial mana yang digunakan Claude Code ketika beberapa tersedia913* Lihat [Prioritas autentikasi](/docs/id/authentication#authentication-precedence) untuk memahami kredensial mana yang digunakan Claude Code ketika terdapat beberapa kredensial
908 914
909Jika Anda diminta untuk masuk berulang kali, lihat [Belum masuk atau token kedaluwarsa](/docs/id/troubleshoot-install#not-logged-in-or-token-expired) untuk pemeriksaan jam sistem dan langkah pemulihan penyimpanan kredensial macOS.915Jika Anda berulang kali diminta untuk masuk, lihat [Belum masuk atau token kedaluwarsa](/docs/id/troubleshoot-install#not-logged-in-or-token-expired) untuk pemeriksaan jam sistem dan langkah pemulihan penyimpanan kredensial macOS.
910 916
911<h3 id="could-not-resolve-authentication-method">917<h3 id="could-not-resolve-authentication-method">
912 Tidak dapat menyelesaikan metode autentikasi918 Tidak dapat menentukan metode autentikasi
913</h3>919</h3>
914 920
915Sesi mencapai klien API tanpa kredensial apa pun. [Sesi latar belakang](/docs/id/agent-view) dan sesi cloud menampilkan pesan ini ketika worker dimulai tanpa kredensial. Jalankan interaktif, `-p`, dan Agent SDK melaporkan kondisi yang sama seperti [Belum masuk](#not-logged-in) dan menulis string ini hanya ke log debug mereka, jadi jika Anda menemukannya di sana, ikuti entri itu sebagai gantinya.921Sesi mencapai klien API tanpa kredensial apa pun. [Sesi latar belakang](/docs/id/agent-view) dan sesi cloud menampilkan pesan ini ketika worker dimulai tanpa kredensial. Proses interaktif, `-p`, dan Agent SDK melaporkan kondisi yang sama sebagai [Belum masuk](#not-logged-in) dan hanya menulis string ini ke log debug mereka, jadi jika Anda menemukannya di sana, ikuti entri tersebut.
916 922
917```text theme={null}923```text theme={null}
918Could not resolve authentication method. Expected one of apiKey, authToken, credentials, config, or profile to be set. Or for one of the "X-Api-Key" or "Authorization" headers to be explicitly omitted924Could not resolve authentication method. Expected one of apiKey, authToken, credentials, config, or profile to be set. Or for one of the "X-Api-Key" or "Authorization" headers to be explicitly omitted
919```925```
920 926
921Pada versi saat ini, kesalahan berarti tidak ada kredensial yang tersedia untuk proses worker. Sebelum v2.1.174, sesi latar belakang yang ditugaskan ke worker yang sudah diinisialisasi dan menganggur dapat gagal dengan cara ini bahkan ketika kredensial yang valid dikonfigurasi. Sebelum v2.1.176, sesi cloud yang menganggur sebelum diklaim juga dapat. Tingkatkan untuk memulihkan.927Pada versi saat ini, kesalahan ini berarti tidak ada kredensial yang tersedia untuk proses worker. Sebelum v2.1.174, sesi latar belakang yang ditugaskan ke worker pra-inisialisasi yang menganggur dapat gagal dengan cara ini bahkan ketika kredensial yang valid telah dikonfigurasi. Sebelum v2.1.176, sesi cloud yang menganggur sebelum diklaim juga dapat gagal dengan cara ini. Lakukan upgrade untuk memulihkannya.
922 928
923**Yang harus dilakukan:**929**Yang harus dilakukan:**
924 930
925* Tingkatkan ke v2.1.176 atau lebih baru jika ini muncul dalam sesi latar belakang atau cloud dan kredensial Anda sudah dikonfigurasi931* Upgrade ke v2.1.176 atau yang lebih baru jika pesan ini muncul di sesi latar belakang atau sesi cloud dan kredensial Anda sudah dikonfigurasi
926* Konfirmasi bahwa `ANTHROPIC_API_KEY`, `CLAUDE_CODE_OAUTH_TOKEN`, atau kredensial penyedia cloud Anda diatur di lingkungan yang meluncurkan worker, bukan hanya di shell interaktif Anda932* Pastikan `ANTHROPIC_API_KEY`, `CLAUDE_CODE_OAUTH_TOKEN`, atau kredensial penyedia cloud Anda diatur di lingkungan yang menjalankan worker, bukan hanya di shell interaktif Anda
927* Untuk Agent SDK, lihat [pengaturan autentikasi dalam quickstart](/docs/id/agent-sdk/quickstart#setup)933* Untuk Agent SDK, lihat [penyiapan autentikasi di mulai cepat](/docs/id/agent-sdk/quickstart#setup)
928* Jalankan `/status` dalam sesi interaktif di lingkungan yang sama untuk mengonfirmasi sumber kredensial mana yang diselesaikan934* Jalankan `/status` dalam sesi interaktif di lingkungan yang sama untuk memastikan sumber kredensial mana yang digunakan
929 935
930<h3 id="invalid-api-key">936<h3 id="invalid-api-key">
931 Kunci API tidak valid937 Kunci API tidak valid
932</h3>938</h3>
933 939
934Variabel lingkungan `ANTHROPIC_API_KEY` atau skrip `apiKeyHelper` mengembalikan kunci yang ditolak API, atau Claude Code memblokir kunci dari `ANTHROPIC_API_KEY` sebelum mengirimnya.940Environment variable `ANTHROPIC_API_KEY` atau skrip `apiKeyHelper` mengembalikan kunci yang ditolak oleh API, atau Claude Code memblokir kunci dari `ANTHROPIC_API_KEY` sebelum mengirimkannya.
935 941
936```text theme={null}942```text theme={null}
937Invalid API key · Fix external API key943Invalid API key · Fix external API key
938```944```
939 945
940Ketika pesan berlanjut melampaui `Fix external API key` dengan deskripsi seperti `Invalid X-Api-Key header value from ANTHROPIC_API_KEY: it contains a line break at character 41 (120 characters on 2 lines).`, API tidak pernah melihat kunci. Claude Code menemukan karakter yang tidak dapat dibawa header HTTP dan menghentikan permintaan sebelum mengirimnya. Lihat [Nilai header permintaan tidak valid](#invalid-request-header-value) untuk cara membaca deskripsi dan memperbaiki nilai.946Ketika pesan berlanjut setelah `Fix external API key` dengan deskripsi seperti `Invalid X-Api-Key header value from ANTHROPIC_API_KEY: it contains a line break at character 41 (120 characters on 2 lines).`, API tidak pernah melihat kunci tersebut. Claude Code menemukan karakter yang tidak dapat dibawa oleh header HTTP dan menghentikan permintaan sebelum mengirimkannya. Lihat [Nilai header permintaan tidak valid](#invalid-request-header-value) untuk cara membaca deskripsi dan memperbaiki nilainya.
941 947
942**Yang harus dilakukan:**948**Yang harus dilakukan:**
943 949
944* Periksa kesalahan ketik dan konfirmasi bahwa kunci belum dicabut di [Console](https://platform.claude.com/settings/keys)950* Periksa kesalahan ketik dan pastikan kunci belum dicabut di [Console](https://platform.claude.com/settings/keys)
945* Di shell yang sama, jalankan `env | grep ANTHROPIC`, atau di PowerShell `Get-ChildItem Env:ANTHROPIC*`. Alat seperti direnv, plugin shell dotenv, dan terminal IDE dapat memuat kunci lama dari file `.env` di proyek Anda tanpa Anda mengaturnya secara eksplisit.951* Di shell yang sama, jalankan `env | grep ANTHROPIC`, atau di PowerShell `Get-ChildItem Env:ANTHROPIC*`. Alat seperti direnv, plugin shell dotenv, dan terminal IDE dapat memuat kunci usang dari file `.env` di proyek Anda tanpa Anda mengaturnya secara eksplisit.
946* Batalkan pengaturan `ANTHROPIC_API_KEY` dan jalankan `/login` untuk menggunakan autentikasi langganan sebagai gantinya952* Hapus pengaturan `ANTHROPIC_API_KEY` dan jalankan `/login` untuk menggunakan autentikasi langganan sebagai gantinya
947* Jika kunci berasal dari skrip [`apiKeyHelper`](/docs/id/settings-reference#apikeyhelper), jalankan skrip secara langsung untuk mengonfirmasi bahwa skrip mencetak kunci yang valid ke stdout953* Jika kunci berasal dari skrip [`apiKeyHelper`](/docs/id/settings-reference#apikeyhelper), jalankan skrip tersebut secara langsung untuk memastikan skrip mencetak kunci yang valid ke stdout
948* Jalankan `/status` untuk mengonfirmasi sumber kredensial mana yang sebenarnya digunakan Claude Code954* Jalankan `/status` untuk memastikan sumber kredensial mana yang sebenarnya digunakan Claude Code
949 955
950<h3 id="your-apikeyhelper-script-is-failing">956<h3 id="your-apikeyhelper-script-is-failing">
951 Skrip apiKeyHelper Anda gagal957 Skrip apiKeyHelper Anda gagal
952</h3>958</h3>
953 959
954Claude Code menjalankan perintah dalam pengaturan [`apiKeyHelper`](/docs/id/settings-reference#apikeyhelper) Anda dan tidak mendapatkan kunci kembali. Tanpa satu, permintaan mencapai API dengan kredensial placeholder, dan API menolaknya dengan `401`. Panel `Authentication` di terminal menunjukkan mana dari ini yang terjadi:960Claude Code menjalankan perintah di pengaturan [`apiKeyHelper`](/docs/id/settings-reference#apikeyhelper) Anda dan tidak mendapatkan kunci kembali. Tanpa kunci, permintaan mencapai API dengan kredensial placeholder, dan API menolaknya dengan `401`. Panel `Authentication` di terminal menunjukkan mana yang terjadi di antara berikut ini:
955 961
956* Perintah keluar dengan kesalahan atau habis waktu962* Perintah keluar dengan kesalahan atau mengalami timeout
957* Perintah tidak mencetak apa pun ke stdout963* Perintah tidak mencetak apa pun ke stdout
958* Perintah mencetak sesuatu selain kunci, seperti banner login atau baris log. Panel menampilkan `returned output that cannot be used as an API key` dan mengatakan apa yang salah, tanpa mengulangi output. Sebelum v2.1.227, Claude Code mengirim apa pun yang dicetak perintah, setelah memangkas spasi putih di sekitarnya.964* Perintah mencetak sesuatu selain kunci, seperti banner login atau baris log. Panel menampilkan `returned output that cannot be used as an API key` dan menyebutkan apa yang salah, tanpa mengulang output tersebut. Sebelum v2.1.227, Claude Code mengirimkan apa pun yang dicetak perintah, setelah memangkas spasi di sekitarnya.
959 965
960```text theme={null}966```text theme={null}
961Your apiKeyHelper script is failing · This usually means you need to re-authenticate with your provider · Run /status to see the script's error output967Your apiKeyHelper script is failing · This usually means you need to re-authenticate with your provider · Run /status to see the script's error output
962```968```
963 969
964Dalam [mode non-interaktif](/docs/id/headless), stderr juga membawa alasan spesifik, diawali dengan `apiKeyHelper failed:`.970Dalam [mode non-interaktif](/docs/id/headless), stderr juga memuat alasan spesifiknya, dengan awalan `apiKeyHelper failed:`.
965 971
966Claude Code menjalankan kembali skrip dan mencoba kembali permintaan hingga dua kali lagi sebelum menampilkan pesan ini, jadi kegagalan muncul dalam tiga upaya. Sebelum v2.1.208, Claude Code menghabiskan [anggaran percobaan ulang](#automatic-retries) penuh mengirim ulang permintaan dengan kredensial placeholder dan kemudian melaporkan kesalahan autentikasi `401` generik sebagai gantinya dari kegagalan skrip.972Claude Code menjalankan ulang skrip dan mencoba ulang permintaan hingga dua kali lagi sebelum menampilkan pesan ini, sehingga kegagalan muncul dalam tiga percobaan. Sebelum v2.1.208, Claude Code menghabiskan seluruh [anggaran retry](#automatic-retries) untuk mengirim ulang permintaan dengan kredensial placeholder, lalu melaporkan kesalahan autentikasi `401` generik alih-alih kegagalan skrip.
967 973
968Menjalankan `/login` tidak membantu di sini: output helper [mengambil prioritas](/docs/id/authentication#authentication-precedence) atas login yang disimpan selama pengaturan ada.974Menjalankan `/login` tidak membantu di sini: output helper [diutamakan](/docs/id/authentication#authentication-precedence) daripada login tersimpan selama pengaturan tersebut ada.
969 975
970**Yang harus dilakukan:**976**Yang harus dilakukan:**
971 977
972* Jalankan perintah yang dikonfigurasi dalam `apiKeyHelper` secara langsung di shell Anda untuk mereproduksi kegagalan978* Jalankan perintah yang dikonfigurasi di `apiKeyHelper` secara langsung di shell Anda untuk mereproduksi kegagalan
973* Jika perintah melaporkan sesi yang kedaluwarsa, autentikasi ulang dengan penyedia kredensial Anda, misalnya dengan masuk kembali ke SSO atau vault rahasia Anda979* Jika perintah melaporkan sesi yang kedaluwarsa, lakukan autentikasi ulang dengan penyedia kredensial Anda, misalnya dengan masuk kembali ke SSO atau vault rahasia Anda
974* Perbaiki perintah sehingga hanya mencetak kunci ke stdout, sebagai token tunggal ASCII yang dapat dicetak hingga 16.384 karakter, dan keluar dengan kode 0. Lihat [putar kredensial dengan apiKeyHelper](/docs/id/llm-gateway-connect#rotate-credentials-with-apikeyhelper) untuk pengaturan yang berfungsi.980* Perbaiki perintah agar hanya mencetak kunci ke stdout, sebagai satu token ASCII yang dapat dicetak hingga 16.384 karakter, dan keluar dengan kode 0. Lihat [merotasi kredensial dengan apiKeyHelper](/docs/id/llm-gateway-connect#rotate-credentials-with-apikeyhelper) untuk penyiapan yang berfungsi.
975* Jalankan `/status` untuk melihat kegagalan dan konfirmasi bahwa `apiKeyHelper` adalah sumber kredensial aktif. Baris `apiKeyHelper` menampilkan `Failing` dengan detail kegagalan terakhir, seperti kode keluar dan output kesalahan perintah, dan hilang setelah jalankan berhasil berikutnya. Sebelum v2.1.274, `/status` hanya menampilkan sumber kredensial, bukan kegagalan.981* Jalankan `/status` untuk melihat kegagalan dan memastikan `apiKeyHelper` adalah sumber kredensial yang aktif. Baris `apiKeyHelper` menampilkan `Failing` dengan detail kegagalan terakhir, seperti exit code dan output kesalahan perintah, dan menghilang setelah eksekusi berhasil berikutnya. Sebelum v2.1.274, `/status` hanya menampilkan sumber kredensial, bukan kegagalannya.
976* Setiap kali perintah gagal, kode keluar dan output kesalahannya juga muncul dalam panel `Authentication` di terminal. Sebelum v2.1.212, panel berjudul `Cloud authentication`.982* Setiap kali perintah gagal, exit code dan output kesalahannya juga muncul di panel `Authentication` di terminal. Sebelum v2.1.212, panel tersebut berjudul `Cloud authentication`.
977 983
978<h3 id="invalid-request-header-value">984<h3 id="invalid-request-header-value">
979 Nilai header permintaan tidak valid985 Nilai header permintaan tidak valid
980</h3>986</h3>
981 987
982Nilai yang akan dikirim Claude Code sebagai header permintaan berisi karakter yang tidak dapat dibawa header HTTP: jeda baris, byte NUL, atau karakter di atas `U+00FF`, seperti tanda kutip melengkung atau spasi lebar nol. Claude Code menghentikan permintaan sebelum apa pun dikirim dan menamai variabel atau pengaturan untuk diperbaiki. Penyebab biasanya adalah kredensial yang ditempel dari dokumen atau obrolan yang membawa karakter tak terlihat atau jeda baris yang tersesat.988Nilai yang hendak dikirim Claude Code sebagai header permintaan mengandung karakter yang tidak dapat dibawa oleh header HTTP: jeda baris, byte NUL, atau karakter di atas `U+00FF`, seperti tanda kutip melengkung atau spasi lebar-nol. Claude Code menghentikan permintaan sebelum apa pun dikirim dan menyebutkan variabel atau pengaturan yang perlu diperbaiki. Penyebab umumnya adalah kredensial yang ditempel dari dokumen atau obrolan yang membawa karakter tak terlihat atau jeda baris yang tidak disengaja.
983 989
984Claude Code menjalankan pemeriksaan ini ketika mengirim permintaan ke Claude API secara langsung atau melalui [gateway LLM](/docs/id/llm-gateway). Pada penyedia cloud pihak ketiga seperti [Amazon Bedrock](/docs/id/amazon-bedrock), Claude Code tidak menjalankannya sebelum mengirim.990Claude Code menjalankan pemeriksaan ini ketika mengirim permintaan ke Claude API secara langsung atau melalui [LLM gateway](/docs/id/llm-gateway). Pada penyedia cloud pihak ketiga seperti [Amazon Bedrock](/docs/id/amazon-bedrock), Claude Code tidak menjalankannya sebelum mengirim.
985 991
986```text theme={null}992```text theme={null}
987Invalid auth token · Fix external auth token993Invalid auth token · Fix external auth token
989Invalid request header from the environment · Fix the environment variable995Invalid request header from the environment · Fix the environment variable
990```996```
991 997
992Bagian pertama pesan tergantung pada tempat nilai buruk berasal:998Bagian pertama pesan bergantung pada asal nilai yang salah:
993 999
994* `Invalid auth token`: token pembawa dari [`ANTHROPIC_AUTH_TOKEN`](/docs/id/env-vars) atau [`CLAUDE_CODE_OAUTH_TOKEN`](/docs/id/env-vars)1000* `Invalid auth token`: bearer token dari [`ANTHROPIC_AUTH_TOKEN`](/docs/id/env-vars) atau [`CLAUDE_CODE_OAUTH_TOKEN`](/docs/id/env-vars)
995* `Invalid ANTHROPIC_CUSTOM_HEADERS`: nama header atau nilai yang Anda atur dalam [`ANTHROPIC_CUSTOM_HEADERS`](/docs/id/env-vars). Deskripsi menghitung pasangan `Name: Value` mana yang bersalah, seperti `distinct header 2 of 3 parsed from ANTHROPIC_CUSTOM_HEADERS`, tanpa mengulangi nama atau nilai, karena Anda memilih keduanya.1001* `Invalid ANTHROPIC_CUSTOM_HEADERS`: nama atau nilai header yang Anda atur di [`ANTHROPIC_CUSTOM_HEADERS`](/docs/id/env-vars). Deskripsi menghitung pasangan `Name: Value` mana yang bermasalah, seperti `distinct header 2 of 3 parsed from ANTHROPIC_CUSTOM_HEADERS`, tanpa mengulang nama atau nilainya, karena Anda yang memilih keduanya.
996* `Invalid request header from the environment`: nilai yang Claude Code salin ke header permintaan dari variabel lingkungan lain, seperti `CLAUDE_AGENT_SDK_CLIENT_APP`. Deskripsi menamai variabel untuk diperbaiki.1002* `Invalid request header from the environment`: nilai yang disalin Claude Code ke header permintaan dari environment variable lain, seperti `CLAUDE_AGENT_SDK_CLIENT_APP`. Deskripsi menyebutkan variabel yang perlu diperbaiki.
997 1003
998Claude Code melaporkan `ANTHROPIC_API_KEY` buruk yang ditangkap oleh pemeriksaan ini sebagai [Kunci API tidak valid](#invalid-api-key), dengan deskripsi trailing yang sama. Ini melaporkan kredensial `/login` yang disimpan buruk sebagai [Belum masuk](#not-logged-in) sebagai gantinya; jalankan `/login` untuk menyimpan yang baru. Output skrip [`apiKeyHelper`](/docs/id/settings-reference#apikeyhelper) tidak pernah mencapai pemeriksaan ini: Claude Code memvalidasinya ketika skrip berjalan, dan output yang tidak dapat dibawa header HTTP gagal dengan [Skrip apiKeyHelper Anda gagal](#your-apikeyhelper-script-is-failing).1004Claude Code melaporkan `ANTHROPIC_API_KEY` yang salah yang tertangkap oleh pemeriksaan ini sebagai [Kunci API tidak valid](#invalid-api-key), dengan deskripsi penutup yang sama. Claude Code melaporkan kredensial `/login` tersimpan yang salah sebagai [Belum masuk](#not-logged-in); jalankan `/login` untuk menyimpan kredensial baru. Output skrip [`apiKeyHelper`](/docs/id/settings-reference#apikeyhelper) tidak pernah mencapai pemeriksaan ini: Claude Code memvalidasinya saat skrip dijalankan, dan output yang tidak dapat dibawa oleh header HTTP akan gagal dengan [Skrip apiKeyHelper Anda gagal](#your-apikeyhelper-script-is-failing).
999 1005
1000Setelah `·` kedua, pesan menjelaskan masalahnya, seperti dalam contoh lengkap ini:1006Setelah `·` kedua, pesan menjelaskan masalahnya, seperti pada contoh lengkap berikut:
1001 1007
1002```text theme={null}1008```text theme={null}
1003Invalid auth token · Fix external auth token · Invalid Authorization header value from ANTHROPIC_AUTH_TOKEN: it contains a line break at character 41 (120 characters on 2 lines).1009Invalid auth token · Fix external auth token · Invalid Authorization header value from ANTHROPIC_AUTH_TOKEN: it contains a line break at character 41 (120 characters on 2 lines).
1004```1010```
1005 1011
1006Posisi menghitung karakter mulai dari satu. Deskripsi dibangun dari frasa tetap dan penghitungan karakter, jadi tidak pernah menyertakan nilai itu sendiri. Ini menamai karakter yang menyinggung hanya ketika itu adalah karakter tak terlihat atau tipografi yang terkenal, seperti tanda urutan byte, spasi lebar nol, atau tanda kutip melengkung, dan melaporkan apa pun yang lain sebagai `a non-ASCII character`.1012Posisi menghitung karakter mulai dari satu. Deskripsi dibangun dari frasa tetap dan jumlah karakter, sehingga tidak pernah menyertakan nilai itu sendiri. Deskripsi menyebutkan karakter yang bermasalah hanya jika karakter tersebut adalah karakter tak terlihat atau tipografis yang dikenal luas, seperti byte-order mark, spasi lebar-nol, atau tanda kutip melengkung, dan melaporkan karakter lainnya sebagai `a non-ASCII character`.
1007 1013
1008**Yang harus dilakukan:**1014**Yang harus dilakukan:**
1009 1015
1010* Atur ulang variabel atau pengaturan yang dinamai pesan, mengetik ulang karakter di sekitar posisi yang dilaporkan daripada menempel dari sumber yang sama lagi1016* Atur ulang variabel atau pengaturan yang disebutkan pesan, dengan mengetik ulang karakter di sekitar posisi yang dilaporkan alih-alih menempel lagi dari sumber yang sama
1011* Untuk `ANTHROPIC_CUSTOM_HEADERS`, simpan satu pasangan `Name: Value` per baris dan tulis ulang pasangan yang dihitung pesan1017* Untuk `ANTHROPIC_CUSTOM_HEADERS`, pertahankan satu pasangan `Name: Value` per baris dan tulis ulang pasangan yang dihitung oleh pesan
1012* Jalankan `/status` untuk mengonfirmasi sumber kredensial mana yang aktif1018* Jalankan `/status` untuk memastikan sumber kredensial mana yang aktif
1013 1019
1014<h3 id="this-organization-has-been-disabled">1020<h3 id="this-organization-has-been-disabled">
1015 Organisasi ini telah dinonaktifkan1021 Organisasi ini telah dinonaktifkan
1016</h3>1022</h3>
1017 1023
1018Claude Code menggunakan `ANTHROPIC_API_KEY` lama dari organisasi Console yang dinonaktifkan. Ketika Anda memiliki login langganan yang disimpan, kunci menimpanya.1024Claude Code menggunakan `ANTHROPIC_API_KEY` usang dari organisasi Console yang dinonaktifkan. Ketika Anda memiliki login langganan yang tersimpan, kunci tersebut menimpanya.
1019 1025
1020```text theme={null}1026```text theme={null}
1021Your ANTHROPIC_API_KEY belongs to a disabled organization · Unset the environment variable to use your subscription instead1027Your ANTHROPIC_API_KEY belongs to a disabled organization · Unset the environment variable to use your subscription instead
1023API Error: 400 ... This organization has been disabled.1029API Error: 400 ... This organization has been disabled.
1024```1030```
1025 1031
1026Petunjuk setelah `·` tergantung pada kredensial yang disimpan Anda: bentuk pertama muncul ketika `/login` yang disimpan dapat mengambil alih setelah Anda membatalkan pengaturan kunci, dan yang kedua ketika kunci adalah satu-satunya kredensial Anda.1032Petunjuk setelah `·` bergantung pada kredensial tersimpan Anda: bentuk pertama muncul ketika `/login` yang tersimpan dapat menggantikannya setelah Anda menghapus pengaturan kunci, dan bentuk kedua ketika kunci tersebut adalah satu-satunya kredensial Anda.
1027 1033
1028Variabel lingkungan mengambil prioritas atas `/login`, jadi kunci yang diekspor dalam profil shell Anda atau dimuat dari file `.env` digunakan bahkan ketika Anda memiliki langganan Pro atau Max yang berfungsi. Dalam mode non-interaktif (`-p`), kunci selalu digunakan saat ada.1034Environment variable diutamakan daripada `/login`, sehingga kunci yang diekspor di profil shell Anda atau dimuat dari file `.env` tetap digunakan bahkan ketika Anda memiliki langganan Pro atau Max yang berfungsi. Dalam mode non-interaktif (`-p`), kunci selalu digunakan jika ada.
1029 1035
1030**Yang harus dilakukan:**1036**Yang harus dilakukan:**
1031 1037
1032* Batalkan pengaturan `ANTHROPIC_API_KEY` di shell saat ini dan hapus dari profil shell Anda, kemudian luncurkan ulang `claude`1038* Hapus pengaturan `ANTHROPIC_API_KEY` di shell saat ini dan hapus dari profil shell Anda, lalu jalankan ulang `claude`
1033* Jika pesan mengatakan `Update or unset`, Anda tidak memiliki login yang disimpan untuk kembali. Batalkan pengaturan kunci dan jalankan `/login`, atau ganti kunci dengan yang dari organisasi Console aktif.1039* Jika pesan menyebutkan `Update or unset`, Anda tidak memiliki login tersimpan untuk dijadikan cadangan. Hapus pengaturan kunci dan jalankan `/login`, atau ganti kunci dengan kunci dari organisasi Console yang aktif.
1034* Jalankan `/status` setelahnya untuk mengonfirmasi kredensial aktif adalah langganan Anda1040* Jalankan `/status` setelahnya untuk memastikan kredensial yang aktif adalah langganan Anda
1035* Jika tidak ada variabel lingkungan yang diatur dan kesalahan berlanjut, hubungi dukungan atau masuk dengan akun berbeda.1041* Jika tidak ada environment variable yang diatur dan kesalahan tetap terjadi, hubungi dukungan atau masuk dengan akun lain.
1036 1042
1037<h3 id="your-organization-has-disabled-api-key-authentication">1043<h3 id="your-organization-has-disabled-api-key-authentication">
1038 Organisasi Anda telah menonaktifkan autentikasi kunci API1044 Organisasi Anda telah menonaktifkan autentikasi kunci API
1039</h3>1045</h3>
1040 1046
1041Pesan ini memerlukan Claude Code v2.1.169 atau lebih baru. Admin organisasi Console Anda telah mematikan autentikasi kunci API, jadi API menolak kunci yang dikirim Claude Code. Petunjuk pemulihan setelah `·` bervariasi tergantung pada tempat kunci berasal:1047Pesan ini memerlukan Claude Code v2.1.169 atau yang lebih baru. Admin organisasi Console Anda telah mematikan autentikasi kunci API, sehingga API menolak kunci yang dikirim Claude Code. Petunjuk pemulihan setelah `·` bervariasi tergantung dari mana kunci berasal:
1042 1048
1043```text theme={null}1049```text theme={null}
1044Your organization has disabled API key authentication · Run /login to sign in with your claude.ai account1050Your organization has disabled API key authentication · Run /login to sign in with your claude.ai account
1048Your organization has disabled API key authentication · Sign in again with your claude.ai account1054Your organization has disabled API key authentication · Sign in again with your claude.ai account
1049```1055```
1050 1056
1051Bentuk terakhir muncul dalam sesi yang dijalankan aplikasi Claude Desktop, seperti tab Code atau Cowork, di mana Anda masuk lagi dari aplikasi.1057Bentuk terakhir muncul dalam sesi yang dijalankan oleh aplikasi Claude Desktop, seperti tab Code atau Cowork, tempat Anda masuk kembali dari aplikasi tersebut.
1052 1058
1053Variabel lingkungan dan `apiKeyHelper` mengambil prioritas atas `/login`, jadi menjalankan `/login` saja tidak membantu sementara salah satu masih memasok kunci. Lihat [Urutan prioritas autentikasi](/docs/id/authentication#authentication-precedence).1059Environment variable dan `apiKeyHelper` diutamakan daripada `/login`, sehingga menjalankan `/login` saja tidak membantu selama salah satunya masih menyediakan kunci. Lihat [Prioritas autentikasi](/docs/id/authentication#authentication-precedence).
1054 1060
1055**Yang harus dilakukan:**1061**Yang harus dilakukan:**
1056 1062
1057* Jika pesan menamai `ANTHROPIC_API_KEY`, batalkan pengaturannya di shell saat ini dan hapus dari profil shell atau file `.env` Anda, kemudian luncurkan ulang `claude`1063* Jika pesan menyebutkan `ANTHROPIC_API_KEY`, hapus pengaturannya di shell saat ini dan hapus dari profil shell atau file `.env` Anda, lalu jalankan ulang `claude`
1058* Jika pesan menamai `apiKeyHelper`, hapus pengaturan [`apiKeyHelper`](/docs/id/settings-reference#apikeyhelper) dari `settings.json` Anda1064* Jika pesan menyebutkan `apiKeyHelper`, hapus pengaturan [`apiKeyHelper`](/docs/id/settings-reference#apikeyhelper) dari `settings.json` Anda
1059* Jalankan `/login` untuk masuk dengan akun claude.ai Anda1065* Jalankan `/login` untuk masuk dengan akun claude.ai Anda
1060* Jalankan `/status` setelahnya untuk mengonfirmasi kredensial aktif adalah langganan Anda daripada kunci API1066* Jalankan `/status` setelahnya untuk memastikan kredensial yang aktif adalah langganan Anda, bukan kunci API
1061* Jika Anda memerlukan autentikasi kunci API untuk otomasi, minta admin organisasi Anda untuk mengaktifkannya kembali di Console1067* Jika Anda memerlukan autentikasi kunci API untuk otomatisasi, minta admin organisasi Anda untuk mengaktifkannya kembali di Console
1062 1068
1063<h3 id="your-organization-has-disabled-claude-subscription-access">1069<h3 id="your-organization-has-disabled-claude-subscription-access">
1064 Organisasi Anda telah menonaktifkan akses langganan Claude1070 Organisasi Anda telah menonaktifkan akses langganan Claude
1065</h3>1071</h3>
1066 1072
1067Organisasi Claude Anda tidak memungkinkan masuk ke Claude Code dengan login langganan. Menjalankan `/login` lagi dengan akun yang sama mengembalikan kesalahan yang sama.1073Organisasi Claude Anda tidak mengizinkan masuk ke Claude Code dengan login langganan. Menjalankan `/login` lagi dengan akun yang sama akan menghasilkan kesalahan yang sama.
1068 1074
1069```text theme={null}1075```text theme={null}
1070Your organization has disabled Claude subscription access for Claude Code · Use an Anthropic API key instead, or ask your admin to enable access1076Your organization has disabled Claude subscription access for Claude Code · Use an Anthropic API key instead, or ask your admin to enable access
1071```1077```
1072 1078
1073Ini adalah pengaturan organisasi sisi server, jadi tidak dapat ditimpa dari pengaturan lokal, variabel lingkungan, atau flag CLI.1079Ini adalah pengaturan organisasi di sisi server, sehingga tidak dapat ditimpa dari pengaturan lokal, environment variable, atau flag CLI.
1074 1080
1075Agent SDK dan mode non-interaktif `-p` menampilkan ini sebagai kode kesalahan `oauth_org_not_allowed`.1081Agent SDK dan mode non-interaktif `-p` menampilkan ini sebagai kode kesalahan `oauth_org_not_allowed`.
1076 1082
1077**Yang harus dilakukan:**1083**Yang harus dilakukan:**
1078 1084
1079* Minta admin Anda untuk mengaktifkan akses Claude Code untuk organisasi Anda1085* Minta admin Anda untuk mengaktifkan akses Claude Code bagi organisasi Anda
1080* Autentikasi dengan kunci API Console sebagai gantinya dari langganan Anda. Lihat [Autentikasi Claude Console](/docs/id/authentication#claude-console-authentication) untuk pengaturan.1086* Lakukan autentikasi dengan kunci API Console alih-alih langganan Anda. Lihat [Autentikasi Claude Console](/docs/id/authentication#claude-console-authentication) untuk penyiapan.
1081* Jika Anda adalah admin dan tidak melihat opsi untuk mengaktifkan akses, hubungi [dukungan Anthropic](https://support.claude.com)1087* Jika Anda adalah admin dan tidak melihat opsi untuk mengaktifkan akses, hubungi [dukungan Anthropic](https://support.claude.com)
1082 1088
1083<h3 id="routines-are-disabled-by-your-organizations-policy">1089<h3 id="routines-are-disabled-by-your-organizations-policy">
1084 Rutinitas dinonaktifkan oleh kebijakan organisasi Anda1090 Routines dinonaktifkan oleh kebijakan organisasi Anda
1085</h3>1091</h3>
1086 1092
1087An Owner dalam organisasi Tim atau Enterprise Anda telah mematikan rutinitas di tingkat organisasi. Kesalahan muncul ketika Anda mencoba membuat atau menjalankan rutinitas, misalnya dari UI [Rutinitas](/docs/id/routines) di claude.ai/code. Pada Claude Code v2.1.227 atau lebih baru, pengaturan yang sama juga [menyembunyikan `/schedule`](/docs/id/routines#troubleshooting) di CLI.1093Seorang Owner di organisasi Team atau Enterprise Anda telah mematikan routine di tingkat organisasi. Kesalahan muncul ketika Anda mencoba membuat atau menjalankan routine, misalnya dari UI [Routines](/docs/id/routines) di claude.ai/code. Pada Claude Code v2.1.227 atau yang lebih baru, pengaturan yang sama juga [menyembunyikan `/schedule`](/docs/id/routines#troubleshooting) di CLI.
1088 1094
1089```text theme={null}1095```text theme={null}
1090Routines are disabled by your organization's policy.1096Routines are disabled by your organization's policy.
1091```1097```
1092 1098
1093Ini adalah pengaturan sisi server, jadi tidak dapat ditimpa dari pengaturan lokal, variabel lingkungan, atau flag CLI.1099Ini adalah pengaturan di sisi server, sehingga tidak dapat ditimpa dari pengaturan lokal, environment variable, atau flag CLI.
1094 1100
1095**Yang harus dilakukan:**1101**Yang harus dilakukan:**
1096 1102
1097* Minta Pemilik dalam organisasi Anda untuk mengaktifkan toggle **Routines** di [claude.ai/admin-settings/claude-code](https://claude.ai/admin-settings/claude-code)1103* Minta seorang Owner di organisasi Anda untuk mengaktifkan toggle **Routines** di [claude.ai/admin-settings/claude-code](https://claude.ai/admin-settings/claude-code)
1098* Untuk pekerjaan terjadwal satu kali yang tidak memerlukan rutinitas tingkat organisasi, lihat [tugas terjadwal](/docs/id/scheduled-tasks)1104* Untuk pekerjaan terjadwal satu kali yang tidak memerlukan routine tingkat organisasi, lihat [tugas terjadwal](/docs/id/scheduled-tasks)
1099 1105
1100<h3 id="remote-control-requires-the-anthropic-api">1106<h3 id="remote-control-requires-the-anthropic-api">
1101 Remote Control memerlukan Anthropic API1107 Remote Control memerlukan Anthropic API
1102</h3>1108</h3>
1103 1109
1104Sesi tidak berbicara langsung ke Anthropic API, yang [Remote Control](/docs/id/remote-control) memerlukan.1110Sesi tidak berkomunikasi langsung dengan Anthropic API, yang diperlukan oleh [Remote Control](/docs/id/remote-control).
1105 1111
1106```text theme={null}1112```text theme={null}
1107Remote Control is only available when using Claude via api.anthropic.com. CLAUDE_CODE_USE_BEDROCK is set, so this session is using Amazon Bedrock — unset it (or run in a shell without it) to use Remote Control.1113Remote Control is only available when using Claude via api.anthropic.com. CLAUDE_CODE_USE_BEDROCK is set, so this session is using Amazon Bedrock — unset it (or run in a shell without it) to use Remote Control.
1108```1114```
1109 1115
1110Kalimat kedua menjelaskan apa yang mengarahkan sesi menjauh dari Anthropic API; sebelum v2.1.219, pesan hanya kalimat pertama. Tergantung pada penyebabnya, pesan menamai:1116Kalimat kedua menjelaskan apa yang mengalihkan sesi dari Anthropic API; sebelum v2.1.219, pesan hanya berisi kalimat pertama. Bergantung pada penyebabnya, pesan menyebutkan:
1111 1117
1112* Variabel penyedia `CLAUDE_CODE_USE_*`, seperti `CLAUDE_CODE_USE_BEDROCK` untuk [Amazon Bedrock](/docs/id/amazon-bedrock) atau `CLAUDE_CODE_USE_VERTEX` untuk [Platform Agen Google Cloud](/docs/id/google-vertex-ai)1118* Variabel penyedia `CLAUDE_CODE_USE_*`, seperti `CLAUDE_CODE_USE_BEDROCK` untuk [Amazon Bedrock](/docs/id/amazon-bedrock) atau `CLAUDE_CODE_USE_VERTEX` untuk [Agent Platform milik Google Cloud](/docs/id/google-vertex-ai)
1113* [`ANTHROPIC_BASE_URL`](/docs/id/env-vars) menunjuk ke host selain `api.anthropic.com`, seperti [gateway LLM](/docs/id/llm-gateway) atau proxy, bahkan ketika Anda masuk dengan claude.ai; sebelum v2.1.196, URL dasar khusus tidak memblokir Remote Control1119* [`ANTHROPIC_BASE_URL`](/docs/id/env-vars) yang mengarah ke host selain `api.anthropic.com`, seperti [LLM gateway](/docs/id/llm-gateway) atau proxy, bahkan ketika Anda masuk dengan claude.ai; sebelum v2.1.196, base URL kustom tidak memblokir Remote Control
1114* `ANTHROPIC_UNIX_SOCKET` diatur, jadi sesi mengirim permintaannya melalui soket lokal daripada ke `api.anthropic.com`1120* `ANTHROPIC_UNIX_SOCKET` diatur, sehingga sesi mengirim permintaannya melalui socket lokal alih-alih ke `api.anthropic.com`
1115* Masuk [gateway cloud](/docs/id/claude-apps-gateway) perusahaan yang dibuat melalui `/login`, yang tidak mendukung Remote Control dan tidak memiliki variabel untuk dibatalkan pengaturannya1121* Login [cloud gateway](/docs/id/claude-apps-gateway) enterprise yang dilakukan melalui `/login`, yang tidak mendukung Remote Control dan tidak memiliki variabel untuk dihapus pengaturannya
1116 1122
1117**Yang harus dilakukan:**1123**Yang harus dilakukan:**
1118 1124
1119* Batalkan pengaturan variabel yang dinamai pesan, seperti `CLAUDE_CODE_USE_BEDROCK` atau `ANTHROPIC_BASE_URL`, dan mulai ulang sesi, atau mulai Remote Control dari sesi yang berbicara langsung ke Anthropic API1125* Hapus pengaturan variabel yang disebutkan pesan, seperti `CLAUDE_CODE_USE_BEDROCK` atau `ANTHROPIC_BASE_URL`, dan mulai ulang sesi, atau mulai Remote Control dari sesi yang berkomunikasi langsung dengan Anthropic API
1120* Jika variabel tidak diatur di shell Anda, periksa kunci `env` dalam [file pengaturan](/docs/id/settings#where-settings-live) Anda, yang menerapkan variabel lingkungan ke setiap sesi1126* Jika variabel tidak diatur di shell Anda, periksa kunci `env` di [file pengaturan](/docs/id/settings#where-settings-live) Anda, yang menerapkan environment variable ke setiap sesi
1121* Untuk pesan startup Remote Control ini dan lainnya, lihat [Troubleshoot Remote Control](/docs/id/remote-control#troubleshooting)1127* Untuk pesan ini dan pesan startup Remote Control lainnya, lihat [Pemecahan masalah Remote Control](/docs/id/remote-control#troubleshooting)
1122 1128
1123<h3 id="remote-control-couldnt-refresh-your-login">1129<h3 id="remote-control-couldnt-refresh-your-login">
1124 Remote Control tidak dapat menyegarkan login Anda1130 Remote Control tidak dapat memperbarui login Anda
1125</h3>1131</h3>
1126 1132
1127Claude Code menjalankan koneksi [Remote Control](/docs/id/remote-control) langsung pada kredensial berumur pendek yang diperoleh dan diperbarui menggunakan login claude.ai yang disimpan. Ketika claude.ai berhenti menerima login itu, atau Claude Code tidak memiliki login yang disimpan lagi, Claude Code menghentikan Remote Control dan memerlukan Anda untuk masuk lagi. Kedua kegagalan dapat terjadi saat Claude Code masih terhubung atau nanti, ketika memperbaharui kredensial.1133Claude Code menjalankan koneksi [Remote Control](/docs/id/remote-control) aktif dengan kredensial berumur pendek yang diperoleh dan diperbaruinya menggunakan login claude.ai tersimpan Anda. Ketika claude.ai berhenti menerima login tersebut, atau Claude Code tidak lagi memiliki login tersimpan, Claude Code menghentikan Remote Control dan mengharuskan Anda masuk kembali. Kedua kegagalan ini dapat terjadi saat Claude Code masih menyambungkan atau nanti, saat memperbarui kredensial.
1128 1134
1129Ketika Claude Code meminta layanan login untuk menyegarkan login yang disimpan dan tidak mendapat jawaban, itu membuat Remote Control tetap berjalan dan mencoba penyegaran lagi saat kredensial koneksi masih berlaku. Penyegaran tidak mendapat jawaban ketika Claude Code tidak dapat menjangkau layanan login, permintaan habis waktu, atau layanan gagal tanpa menolak login Anda. Jika layanan login masih tidak menjawab ketika kredensial itu kedaluwarsa, Claude Code menghentikan Remote Control dan melaporkan `OAuth token refresh failed`.1135Ketika Claude Code meminta layanan login untuk memperbarui login tersimpan Anda dan tidak mendapat jawaban, Claude Code tetap menjalankan Remote Control dan mencoba pembaruan lagi selama kredensial koneksi saat ini masih valid. Pembaruan tidak mendapat jawaban ketika Claude Code tidak dapat menjangkau layanan login, permintaan mengalami timeout, atau layanan gagal tanpa menolak login Anda. Jika layanan login masih belum menjawab saat kredensial tersebut kedaluwarsa, Claude Code menghentikan Remote Control dan melaporkan `OAuth token refresh failed`.
1130 1136
1131Ketika Claude Code menghentikan Remote Control, itu menunjukkan alasannya dalam peringatan dan dalam baris transkrip yang dimulai dengan `Remote Control disconnected`. Sesi lokal Anda terus berjalan tanpa Remote Control. Bagian ini mencakup baris-baris ini:1137Ketika Claude Code menghentikan Remote Control, Claude Code menampilkan alasannya dalam peringatan dan dalam baris transkrip yang diawali dengan `Remote Control disconnected`. Sesi lokal Anda tetap berjalan tanpa Remote Control. Bagian ini membahas baris-baris berikut:
1132 1138
1133```text theme={null}1139```text theme={null}
1134Remote Control disconnected — Claude.ai login expired — run /login to restore Remote Control1140Remote Control disconnected — Claude.ai login expired — run /login to restore Remote Control
1140Remote Control disconnected — Signed out of Claude — run /login, then /remote-control1146Remote Control disconnected — Signed out of Claude — run /login, then /remote-control
1141```1147```
1142 1148
1143Claude Code menamai penyebabnya di tengah pesan:1149Claude Code menyebutkan penyebabnya di bagian tengah pesan:
1144 1150
1145* ` Claude.ai login expired` dan `Claude.ai login was rejected`: claude.ai tidak lagi menerima token login yang disimpan Anda, karena kedaluwarsa atau dicabut1151* `Claude.ai login expired` dan `Claude.ai login was rejected`: claude.ai tidak lagi menerima token login tersimpan Anda, karena token tersebut kedaluwarsa atau dicabut
1146* ` OAuth token unavailable`: Claude Code tidak memiliki token login yang disimpan ketika kredensial koneksi jatuh tempo untuk pembaruan1152* `OAuth token unavailable`: Claude Code tidak memiliki token login tersimpan ketika kredensial koneksi jatuh tempo untuk diperbarui
1147* `OAuth token refresh failed`: claude.ai menolak token login yang disimpan Anda saat Claude Code terhubung kembali, dan menyegarkan token tidak menghasilkan yang baru1153* `OAuth token refresh failed`: claude.ai menolak token login tersimpan Anda saat Claude Code sedang menyambung ulang, dan pembaruan token tidak menghasilkan token baru
1148* `JWT refresh failed: no OAuth token`: Claude Code tidak menemukan token login yang disimpan untuk diperbarui1154* `JWT refresh failed: no OAuth token`: Claude Code tidak menemukan token login tersimpan untuk melakukan pembaruan
1149* ` Signed out of Claude`: Anda keluar di mesin ini, misalnya dengan menjalankan `/logout` di terminal lain, jadi Claude Code tidak memiliki login yang disimpan lagi untuk memperbarui koneksi1155* `Signed out of Claude`: Anda keluar di mesin ini, misalnya dengan menjalankan `/logout` di terminal lain, sehingga Claude Code tidak lagi memiliki login tersimpan untuk memperbarui koneksi
1150 1156
1151**Yang harus dilakukan:**1157**Yang harus dilakukan:**
1152 1158
1153* Jalankan `/login` untuk masuk lagi1159* Jalankan `/login` untuk masuk kembali
1154* Jalankan `/remote-control` untuk menghubungkan kembali sesi. Pesan yang berakhir `run /login to restore Remote Control` tidak memerlukan langkah ini: Claude Code terhubung kembali dengan sendirinya setelah Anda masuk.1160* Jalankan `/remote-control` untuk menyambungkan ulang sesi. Pesan yang diakhiri dengan `run /login to restore Remote Control` tidak memerlukan langkah ini: Claude Code menyambung ulang dengan sendirinya setelah Anda masuk.
1155 1161
1156Sebelum v2.1.224, `OAuth token refresh failed — run /login to re-authenticate` berbunyi `OAuth token refresh failed — re-authenticate, then re-enable Remote Control`, dan `JWT refresh failed: no OAuth token — run /login` berbunyi `no OAuth token available for recovery (code <N>)`. Pesan `Claude.ai login expired`, `Claude.ai login was rejected`, dan `OAuth token unavailable` ditambahkan dalam v2.1.225.1162Sebelum v2.1.224, `OAuth token refresh failed — run /login to re-authenticate` berbunyi `OAuth token refresh failed — re-authenticate, then re-enable Remote Control`, dan `JWT refresh failed: no OAuth token — run /login` berbunyi `no OAuth token available for recovery (code <N>)`. Pesan `Claude.ai login expired`, `Claude.ai login was rejected`, dan `OAuth token unavailable` ditambahkan di v2.1.225.
1157 1163
1158Sebelum v2.1.238, Claude Code melaporkan kasus yang sekarang mengatakan `Signed out of Claude` sebagai `JWT refresh failed: no OAuth token — run /login`, dan menghentikan Remote Control dengan `Claude.ai login expired — run /login to restore Remote Control` segera setelah satu penyegaran login tidak mendapat jawaban.1164Sebelum v2.1.238, Claude Code melaporkan kasus-kasus yang kini berbunyi `Signed out of Claude` sebagai `JWT refresh failed: no OAuth token — run /login`, dan menghentikan Remote Control dengan `Claude.ai login expired — run /login to restore Remote Control` segera setelah satu pembaruan login tidak mendapat jawaban.
1159 1165
1160<h3 id="remote-control-stopped-because-the-signed-in-account-changed">1166<h3 id="remote-control-stopped-because-the-signed-in-account-changed">
1161 Remote Control berhenti karena akun yang masuk berubah1167 Remote Control berhenti karena akun yang masuk berubah
1162</h3>1168</h3>
1163 1169
1164Claude Code menampilkan baris ini selama sesi [Remote Control](/docs/id/remote-control) ketika Anda masuk ke akun claude.ai atau organisasi berbeda di mesin ini. Anda membuat switch di luar sesi Claude Code, misalnya dengan menjalankan `/login` di terminal lain.1170Claude Code menampilkan baris ini selama sesi [Remote Control](/docs/id/remote-control) ketika Anda masuk ke akun atau organisasi claude.ai yang berbeda di mesin ini. Anda melakukan peralihan di luar sesi Claude Code, misalnya dengan menjalankan `/login` di terminal lain.
1165 1171
1166Sesi Remote Control yang Anda mulai saat masuk melalui `/login` milik akun claude.ai dan organisasi yang masuk pada saat itu.1172Sesi Remote Control yang Anda mulai saat masuk melalui `/login` dimiliki oleh akun dan organisasi claude.ai yang sedang masuk pada saat itu.
1167 1173
1168```text theme={null}1174```text theme={null}
1169Remote Control disconnected — signed-in claude.ai account or organization changed on this machine — run /remote-control to start a session for the current account, or /login to switch back, then /remote-control1175Remote Control disconnected — signed-in claude.ai account or organization changed on this machine — run /remote-control to start a session for the current account, or /login to switch back, then /remote-control
1170```1176```
1171 1177
1172Claude Code menghentikan sesi Remote Control segera setelah claude.ai mengonfirmasi bahwa akun atau organisasi berubah. Sesi lokal Anda terus berjalan tanpa Remote Control.1178Claude Code menghentikan sesi Remote Control segera setelah claude.ai mengonfirmasi bahwa akun atau organisasi telah berubah. Sesi lokal Anda tetap berjalan tanpa Remote Control.
1173 1179
1174**Yang harus dilakukan:**1180**Yang harus dilakukan:**
1175 1181
1176* Jalankan `/remote-control` untuk memulai sesi Remote Control baru di bawah akun atau organisasi saat ini1182* Jalankan `/remote-control` untuk memulai sesi Remote Control baru di bawah akun atau organisasi saat ini
1177* Untuk beralih kembali, jalankan `/login` dan masuk ke akun atau organisasi sebelumnya lagi. Kemudian jalankan `/remote-control`.1183* Untuk beralih kembali, jalankan `/login` dan masuk lagi ke akun atau organisasi sebelumnya. Lalu jalankan `/remote-control`.
1178 1184
1179Sebelum v2.1.234, Claude Code tidak memperhatikan ketika Anda beralih ke akun atau organisasi berbeda di luar sesi Claude Code. Claude Code membuat sesi Remote Control tetap terhubung sampai permintaan nanti ke server Remote Control gagal dengan `Remote Control server rejected the request (HTTP 404)`. Kegagalan itu bisa datang berjam-jam setelah switch.1185Sebelum v2.1.234, Claude Code tidak menyadari ketika Anda beralih ke akun atau organisasi lain di luar sesi Claude Code. Claude Code tetap menyambungkan sesi Remote Control hingga permintaan berikutnya ke server Remote Control gagal dengan `Remote Control server rejected the request (HTTP 404)`. Kegagalan tersebut dapat terjadi berjam-jam setelah peralihan.
1180 1186
1181<h3 id="remote-control-stopped-because-the-app-running-the-session-signed-out-or-switched-accounts">1187<h3 id="remote-control-stopped-because-the-app-running-the-session-signed-out-or-switched-accounts">
1182 Remote Control berhenti karena aplikasi yang menjalankan sesi keluar atau beralih akun1188 Remote Control berhenti karena aplikasi yang menjalankan sesi keluar atau beralih akun
1183</h3>1189</h3>
1184 1190
1185Ketika aplikasi desktop Claude atau IDE menghosting sesi Anda, Claude Code mendapatkan token login dari aplikasi itu daripada dari `/login`. Ketika claude.ai menolak token itu, Claude Code meminta aplikasi untuk yang baru. Jika aplikasi menjawab bahwa itu keluar, atau bahwa itu sekarang masuk ke akun Claude berbeda, Claude Code mengakhiri sesi [Remote Control](/docs/id/remote-control) dan mengirim aplikasi salah satu baris ini:1191Ketika aplikasi desktop Claude atau IDE menjadi host sesi Anda, Claude Code mendapatkan token login dari aplikasi tersebut, bukan dari `/login`. Ketika claude.ai menolak token tersebut, Claude Code meminta token baru dari aplikasi. Jika aplikasi menjawab bahwa aplikasi sudah keluar, atau bahwa aplikasi kini masuk ke akun Claude yang berbeda, Claude Code mengakhiri sesi [Remote Control](/docs/id/remote-control) dan mengirimkan salah satu baris berikut ke aplikasi:
1186 1192
1187```text theme={null}1193```text theme={null}
1188Remote Control stopped — the app running this session is now signed in to a different Claude account1194Remote Control stopped — the app running this session is now signed in to a different Claude account
1189Remote Control stopped — the app running this session is signed out of Claude. Sign in there, then turn Remote Control back on1195Remote Control stopped — the app running this session is signed out of Claude. Sign in there, then turn Remote Control back on
1190```1196```
1191 1197
1192Sesi lokal Anda terus berjalan tanpa Remote Control.1198Sesi lokal Anda tetap berjalan tanpa Remote Control.
1193 1199
1194**Yang harus dilakukan:**1200**Yang harus dilakukan:**
1195 1201
1196* Jika aplikasi keluar, masuk lagi, kemudian aktifkan Remote Control kembali di aplikasi1202* Jika aplikasi sudah keluar, masuk kembali ke aplikasi tersebut, lalu aktifkan kembali Remote Control di aplikasi
1197* Jika aplikasi beralih akun, Claude Code tidak dapat melanjutkan sesi yang berakhir di bawah akun baru. Mulai sesi Remote Control baru di bawah akun itu.1203* Jika aplikasi beralih akun, Claude Code tidak dapat melanjutkan sesi yang telah berakhir di bawah akun baru. Mulai sesi Remote Control baru di bawah akun tersebut.
1198 1204
1199Sebelum v2.1.238, Claude Code mengirim aplikasi pesan `run /login` yang tercantum di bawah [Remote Control tidak dapat menyegarkan login Anda](#remote-control-couldnt-refresh-your-login) dalam kedua kasus.1205Sebelum v2.1.238, Claude Code mengirimkan pesan `run /login` yang tercantum di bawah [Remote Control tidak dapat memperbarui login Anda](#remote-control-couldnt-refresh-your-login) ke aplikasi dalam kedua kasus.
1200 1206
1201<h3 id="oauth-token-revoked-or-expired">1207<h3 id="oauth-token-revoked-or-expired">
1202 Token OAuth dicabut atau kedaluwarsa1208 Token OAuth dicabut atau kedaluwarsa
1203</h3>1209</h3>
1204 1210
1205Login yang disimpan tidak lagi valid. Token yang dicabut berarti Anda keluar di mana-mana atau admin menghapus akses; token yang kedaluwarsa berarti penyegaran otomatis gagal di tengah sesi.1211Login tersimpan Anda tidak lagi valid. Token yang dicabut berarti Anda keluar di semua tempat atau admin menghapus akses; token yang kedaluwarsa berarti pembaruan otomatis gagal di tengah sesi.
1206 1212
1207Kedua pesan melaporkan penolakan yang dikembalikan API untuk permintaan yang dikirim Claude Code. Ketika login yang disimpan sudah dihapus setelah penyegaran yang gagal, Anda melihat [Login kedaluwarsa](#login-expired) sebagai gantinya. Jika Anda autentikasi dengan token berumur panjang dalam [`CLAUDE_CODE_OAUTH_TOKEN`](/docs/id/env-vars), Anda melihat pesan yang sama ketika token itu kedaluwarsa atau dicabut.1213Kedua pesan melaporkan penolakan yang dikembalikan API untuk permintaan yang dikirim Claude Code. Ketika login tersimpan sudah dihapus setelah pembaruan yang gagal, Anda akan melihat [Login kedaluwarsa](#login-expired). Jika Anda melakukan autentikasi dengan token berumur panjang di [`CLAUDE_CODE_OAUTH_TOKEN`](/docs/id/env-vars), Anda akan melihat pesan yang sama ketika token tersebut kedaluwarsa atau dicabut.
1208 1214
1209```text theme={null}1215```text theme={null}
1210OAuth token revoked · Please run /login1216OAuth token revoked · Please run /login
1213 1219
1214**Yang harus dilakukan:**1220**Yang harus dilakukan:**
1215 1221
1216* Jalankan `/login` untuk masuk lagi1222* Jalankan `/login` untuk masuk kembali
1217* Jika Anda autentikasi dengan variabel lingkungan `CLAUDE_CODE_OAUTH_TOKEN`, Claude Code terus mengirim nilai yang Anda atur setelah permintaan gagal dengan 401, daripada beralih ke token login yang disimpan. [`/status`](/docs/id/commands) menampilkan kredensial ini sebagai baris `Auth token` membaca `CLAUDE_CODE_OAUTH_TOKEN`. Hasilkan token baru dengan [`claude setup-token`](/docs/id/authentication#generate-a-long-lived-token) dan mulai ulang dengannya, atau batalkan pengaturan variabel dan jalankan `/login`. Sebelum v2.1.225, Claude Code dapat mengganti nilai variabel di tengah sesi dengan token akses berumur pendek dari login yang disimpan, dan sesi gagal dengan kesalahan 401 lagi setelah token itu kedaluwarsa.1223* Jika Anda melakukan autentikasi dengan environment variable `CLAUDE_CODE_OAUTH_TOKEN`, Claude Code tetap mengirimkan nilai yang Anda atur setelah permintaan gagal dengan 401, alih-alih beralih ke token login tersimpan. [`/status`](/docs/id/commands) menampilkan kredensial ini sebagai baris `Auth token` yang berbunyi `CLAUDE_CODE_OAUTH_TOKEN`. Buat token baru dengan [`claude setup-token`](/docs/id/authentication#generate-a-long-lived-token) dan mulai ulang dengan token tersebut, atau hapus pengaturan variabel dan jalankan `/login`. Sebelum v2.1.225, Claude Code dapat mengganti nilai variabel di tengah sesi dengan access token berumur pendek dari login tersimpan, dan sesi kembali gagal dengan kesalahan 401 setelah token tersebut kedaluwarsa.
1218* Untuk prompt berulang untuk masuk di seluruh peluncuran, lihat pemeriksaan jam sistem dan langkah pemulihan penyimpanan kredensial macOS dalam [Troubleshooting](/docs/id/troubleshoot-install#not-logged-in-or-token-expired)1224* Untuk permintaan masuk yang berulang di setiap peluncuran, lihat pemeriksaan jam sistem dan langkah pemulihan penyimpanan kredensial macOS di [Pemecahan masalah](/docs/id/troubleshoot-install#not-logged-in-or-token-expired)
1219* Untuk kegagalan lainnya termasuk `403 Forbidden` dan masalah browser OAuth, lihat [Login dan autentikasi](/docs/id/troubleshoot-install#login-and-authentication)1225* Untuk kegagalan lain termasuk `403 Forbidden` dan masalah browser OAuth, lihat [Login dan autentikasi](/docs/id/troubleshoot-install#login-and-authentication)
1220 1226
1221<h3 id="api-error-401-invalid-authentication-credentials">1227<h3 id="api-error-401-invalid-authentication-credentials">
1222 API Error: 401 Kredensial autentikasi tidak valid1228 API Error: 401 Invalid authentication credentials
1223</h3>1229</h3>
1224 1230
1225API mengenali format kredensial Anda tetapi menolak akun atau organisasi di baliknya. Anthropic mengembalikan pesan ini ketika kredensial baru saja dicabut, ketika organisasi dinonaktifkan atau menghapus akses Anda, atau ketika akun itu sendiri dinonaktifkan, jadi token yang kedaluwarsa bukan penyebabnya. Kredensial dapat berupa login yang disimpan atau `ANTHROPIC_API_KEY` yang disetujui, dan perbaikannya berbeda, jadi mulai dengan menjalankan `/status` untuk melihat mana yang aktif.1231API mengenali format kredensial Anda tetapi menolak akun atau organisasi di baliknya. Anthropic mengembalikan pesan ini ketika kredensial baru saja dicabut, ketika organisasi dinonaktifkan atau menghapus akses Anda, atau ketika akun itu sendiri dinonaktifkan, sehingga token yang kedaluwarsa bukanlah penyebabnya. Kredensial tersebut dapat berupa login tersimpan Anda atau `ANTHROPIC_API_KEY` yang disetujui, dan perbaikannya berbeda, jadi mulailah dengan menjalankan `/status` untuk melihat mana yang aktif.
1226 1232
1227```text theme={null}1233```text theme={null}
1228Please run /login · API Error: 401 Invalid authentication credentials1234Please run /login · API Error: 401 Invalid authentication credentials
1230 1236
1231**Yang harus dilakukan:**1237**Yang harus dilakukan:**
1232 1238
1233* Jika `/status` menampilkan baris `API key` yang tidak ditandai sebagai tidak digunakan, `ANTHROPIC_API_KEY` yang disetujui]\(/id/authentication#authentication-precedence) adalah kredensial aktif dan mengambil prioritas atas login Anda, jadi `/login` tidak menggantinya. Putar kunci di Claude Console, atau kembali ke langganan Anda dengan menjalankan `unset ANTHROPIC_API_KEY`, atau di PowerShell `Remove-Item Env:ANTHROPIC_API_KEY`.1239* Jika `/status` menampilkan baris `API key` yang tidak ditandai sebagai tidak digunakan, [`ANTHROPIC_API_KEY`](/docs/id/authentication#authentication-precedence) yang disetujui adalah kredensial aktif dan diutamakan daripada login Anda, sehingga `/login` tidak menggantikannya. Rotasi kunci di Claude Console, atau kembali ke langganan Anda dengan menjalankan `unset ANTHROPIC_API_KEY`, atau di PowerShell `Remove-Item Env:ANTHROPIC_API_KEY`.
1234* Jika `/status` hanya menampilkan login Anda, jalankan `/login` sekali. Jika kredensial dicabut, login baru menggantinya.1240* Jika `/status` hanya menampilkan login Anda, jalankan `/login` sekali. Jika kredensial telah dicabut, login baru akan menggantikannya.
1235* Jika pesan yang sama kembali untuk akun login yang sama, akun atau organisasi tidak lagi aktif. Periksa akun dan organisasi yang dilaporkan `/status`, dan minta admin organisasi Anda untuk memulihkan akses.1241* Jika pesan yang sama muncul kembali untuk akun login yang sama, akun atau organisasi tersebut tidak lagi aktif. Periksa akun dan organisasi yang dilaporkan `/status`, dan minta admin organisasi Anda untuk memulihkan akses.
1236* Jika [`ANTHROPIC_BASE_URL`](/docs/id/env-vars) menunjuk ke [gateway LLM](/docs/id/llm-gateway), teks setelah `401` adalah pesan gateway Anda daripada Anthropic, dan `/login` tidak mengubahnya. Perbaiki kredensial yang diharapkan gateway Anda sebagai gantinya.1242* Jika [`ANTHROPIC_BASE_URL`](/docs/id/env-vars) mengarah ke [LLM gateway](/docs/id/llm-gateway), teks setelah `401` adalah pesan dari gateway Anda, bukan dari Anthropic, dan `/login` tidak mengubahnya. Perbaiki kredensial yang diharapkan gateway Anda.
1237 1243
1238<h3 id="login-expired">1244<h3 id="login-expired">
1239 Login kedaluwarsa1245 Login kedaluwarsa
1240</h3>1246</h3>
1241 1247
1242Claude Code mencoba memperbarui login claude.ai atau Claude Console yang disimpan dan layanan OAuth menolak token penyegaran yang disimpan, jadi Claude Code menghapus kredensial yang disimpan. Setelah itu, setiap permintaan model berhenti secara lokal dengan pesan ini sebelum mencapai API, karena hanya `/login` yang dapat membuat kredensial baru.1248Claude Code mencoba memperbarui login claude.ai tersimpan Anda dan layanan OAuth menolak refresh token yang tersimpan, sehingga Claude Code menghapus kredensial tersimpan. Setelah itu, setiap permintaan model berhenti secara lokal dengan pesan ini sebelum mencapai API, karena hanya `/login` yang dapat membuat kredensial baru.
1243 1249
1244Sebelum v2.1.206, Claude Code mengirim permintaan model bagaimanapun dengan kredensial apa pun yang tersisa di lingkungan, dan setiap model kemudian gagal dengan [Ada masalah dengan model yang dipilih](#theres-an-issue-with-the-selected-model) atau 401 sebagai gantinya dari prompt untuk masuk.1250Sebelum v2.1.206, Claude Code tetap mengirimkan permintaan model dengan kredensial apa pun yang tersisa di lingkungan, dan setiap model kemudian gagal dengan [Ada masalah dengan model yang dipilih](#theres-an-issue-with-the-selected-model) atau 401 alih-alih permintaan untuk masuk.
1245 1251
1246```text theme={null}1252```text theme={null}
1247Login expired · Please run /login1253Login expired · Please run /login
1248```1254```
1249 1255
1250Dalam [mode non-interaktif](/docs/id/headless) (`-p`) dan [Agent SDK](/docs/id/agent-sdk/overview), pesan berbunyi sebagai berikut, dan kode kesalahan terstruktur adalah `authentication_failed`:1256Dalam [mode non-interaktif](/docs/id/headless) (`-p`) dan [Agent SDK](/docs/id/agent-sdk/overview), pesannya berbunyi sebagai berikut, dan kode kesalahan terstrukturnya adalah `authentication_failed`:
1251 1257
1252```text theme={null}1258```text theme={null}
1253Failed to authenticate: OAuth session expired and could not be refreshed1259Failed to authenticate: OAuth session expired and could not be refreshed
1254```1260```
1255 1261
1256Ini bukan keadaan yang sama seperti [Token OAuth dicabut atau kedaluwarsa](#oauth-token-revoked-or-expired). Pesan-pesan itu melaporkan penolakan yang dikembalikan API. Claude Code itu sendiri menghasilkan `Login expired` untuk login yang sudah gagal diperbarui, jadi tidak mengirim permintaan. Ketika pembaruan gagal karena akun itu sendiri ditangguhkan daripada login yang sudah lama, Claude Code menampilkan [Akun Anda ditahan](#your-account-is-on-hold) sebagai gantinya.1262Ini bukan kondisi yang sama dengan [Token OAuth dicabut atau kedaluwarsa](#oauth-token-revoked-or-expired). Pesan-pesan tersebut melaporkan penolakan yang dikembalikan API. Claude Code sendiri yang menghasilkan `Login expired` untuk login yang sudah gagal diperbaruinya, sehingga tidak mengirim permintaan. Ketika pembaruan gagal karena akun itu sendiri ditangguhkan, bukan karena login yang usang, Claude Code menampilkan [Akun Anda ditangguhkan](#your-account-is-on-hold).
1257 1263
1258Sesi yang diautentikasi dengan kunci API, [`CLAUDE_CODE_OAUTH_TOKEN`](/docs/id/env-vars), atau penyedia pihak ketiga tidak menggunakan login yang disimpan dan tidak pernah melihat pesan ini.1264Sesi yang diautentikasi dengan kunci API, [`CLAUDE_CODE_OAUTH_TOKEN`](/docs/id/env-vars), atau penyedia pihak ketiga tidak menggunakan login tersimpan dan tidak pernah melihat pesan ini.
1259 1265
1260Anda dapat memeriksa keadaan ini sebelum permintaan gagal: [`/status`](/docs/id/commands) menampilkan baris `Login` membaca `Expired — log in again`, ditambah organisasi dan email yang disimpannya untuk login yang kedaluwarsa. Baris muncul hanya ketika login yang disimpan adalah kredensial aktif Anda dan tidak dapat lagi disegarkan. Sesi yang diautentikasi dengan cara lain tidak menampilkan baris, bahkan jika login yang kedaluwarsa tetap disimpan. Sebelum v2.1.210, `/status` tidak memberikan indikasi dalam keadaan ini bahwa login pernah ada, karena kredensial yang dihapus meninggalkannya tidak ada untuk dilaporkan.1266Anda dapat memeriksa kondisi ini sebelum permintaan gagal: [`/status`](/docs/id/commands) menampilkan baris `Login` yang berbunyi `Expired — log in again`, ditambah organisasi dan email yang tersimpan untuk login yang kedaluwarsa. Baris ini hanya muncul ketika login tersimpan adalah kredensial aktif Anda dan tidak dapat diperbarui lagi. Sesi yang diautentikasi dengan cara lain tidak menampilkan baris ini, meskipun login yang kedaluwarsa masih tersimpan. Sebelum v2.1.210, `/status` tidak memberikan indikasi apa pun dalam kondisi ini bahwa pernah ada login, karena kredensial yang dihapus tidak menyisakan apa pun untuk dilaporkan.
1261 1267
1262**Yang harus dilakukan:**1268**Yang harus dilakukan:**
1263 1269
1264* Jalankan `/login` untuk masuk lagi. Mencoba lagi tanpa masuk menampilkan pesan yang sama pada setiap permintaan.1270* Jalankan `/login` untuk masuk kembali. Mencoba ulang tanpa masuk akan menampilkan pesan yang sama pada setiap permintaan.
1265* Dalam mode non-interaktif, jalankan `claude` di lingkungan yang sama, selesaikan `/login`, kemudian jalankan kembali perintah Anda. Untuk otomasi yang tidak dapat masuk secara interaktif, autentikasi dengan `ANTHROPIC_API_KEY` atau [hasilkan token berumur panjang dengan `claude setup-token`](/docs/id/authentication#generate-a-long-lived-token).1271* Jika Anda masuk dengan akun claude.ai Anda di jendela Claude Code lain, lihat [Belum masuk](#not-logged-in) untuk mengetahui kapan sesi ini mulai menggunakan login tersebut dengan sendirinya.
1272* Dalam mode non-interaktif, jalankan `claude` di lingkungan yang sama, selesaikan `/login`, lalu jalankan ulang perintah Anda. Untuk otomatisasi yang tidak dapat masuk secara interaktif, lakukan autentikasi dengan `ANTHROPIC_API_KEY` atau [buat token berumur panjang dengan `claude setup-token`](/docs/id/authentication#generate-a-long-lived-token).
1266* Jika masuk terus gagal, lihat [Login dan autentikasi](/docs/id/troubleshoot-install#login-and-authentication)1273* Jika masuk terus gagal, lihat [Login dan autentikasi](/docs/id/troubleshoot-install#login-and-authentication)
1267 1274
1268<h3 id="could-not-refresh-your-login">1275<h3 id="could-not-refresh-your-login">
1269 Tidak dapat menyegarkan login Anda karena proses Claude Code lain menyegarkannya1276 Tidak dapat memperbarui login Anda karena proses Claude Code lain sedang memperbaruinya
1270</h3>1277</h3>
1271 1278
1272Pesan ini tidak berarti login Anda ditolak. Login claude.ai yang disimpan kedaluwarsa dan perlu diperbarui. Proses Claude Code lain di mesin yang sama menahan kunci penyegaran bersama, atau keluar dan meninggalkannya, dan penyegaran tidak membuat kemajuan saat sesi ini menunggu. Claude Code menghentikan permintaan sebelum mengirimnya:1279Pesan ini tidak berarti login Anda ditolak. Login claude.ai tersimpan Anda telah kedaluwarsa dan perlu diperbarui. Proses Claude Code lain di mesin yang sama memegang kunci pembaruan bersama, atau keluar dan meninggalkannya, dan pembaruan tidak mengalami kemajuan selama sesi ini menunggu. Claude Code menghentikan permintaan sebelum mengirimkannya:
1273 1280
1274```text theme={null}1281```text theme={null}
1275Could not refresh your login because another Claude Code process is refreshing it (or exited mid-refresh) · Try again in a minute; if it keeps happening, close other Claude Code windows or sign in again with /login1282Could not refresh your login because another Claude Code process is refreshing it (or exited mid-refresh) · Try again in a minute; if it keeps happening, close other Claude Code windows or sign in again with /login
1276```1283```
1277 1284
1278Dalam [mode non-interaktif](/docs/id/headless) (`-p`) dan [Agent SDK](/docs/id/agent-sdk/overview), pesan berbunyi sebagai berikut, dan kode kesalahan terstruktur adalah `server_error`:1285Dalam [mode non-interaktif](/docs/id/headless) (`-p`) dan [Agent SDK](/docs/id/agent-sdk/overview), pesannya berbunyi sebagai berikut, dan kode kesalahan terstrukturnya adalah `server_error`:
1279 1286
1280```text theme={null}1287```text theme={null}
1281Failed to refresh OAuth token: another Claude Code process is refreshing it or exited mid-refresh. This is usually transient; retry in a minute, and if it persists close other Claude Code processes or sign in again1288Failed to refresh OAuth token: another Claude Code process is refreshing it or exited mid-refresh. This is usually transient; retry in a minute, and if it persists close other Claude Code processes or sign in again
1282```1289```
1283 1290
1284Sesi yang diautentikasi dengan kunci API, [`CLAUDE_CODE_OAUTH_TOKEN`](/docs/id/env-vars), atau penyedia pihak ketiga tidak menggunakan login yang disimpan dan tidak pernah melihat pesan ini.1291Sesi yang diautentikasi dengan kunci API, [`CLAUDE_CODE_OAUTH_TOKEN`](/docs/id/env-vars), atau penyedia pihak ketiga tidak menggunakan login tersimpan dan tidak pernah melihat pesan ini.
1285 1292
1286**Yang harus dilakukan:**1293**Yang harus dilakukan:**
1287 1294
1288* Coba lagi dalam satu menit. Jika proses lain menyelesaikan penyegaran terlebih dahulu, sesi ini menggunakan login yang diperbarui.1295* Coba lagi dalam satu menit. Jika proses lain menyelesaikan pembaruan terlebih dahulu, sesi ini menggunakan login yang telah diperbarui.
1289* Jika pesan terus kembali, tutup jendela dan proses Claude Code lainnya, kemudian coba lagi.1296* Jika pesan terus muncul, tutup jendela dan proses Claude Code lainnya, lalu coba lagi.
1290* Jika kembali tanpa proses Claude Code lain yang berjalan, jalankan `/login`. Masuk lagi tidak menunggu kunci penyegaran.1297* Jika pesan muncul tanpa ada proses Claude Code lain yang berjalan, jalankan `/login`. Masuk kembali tidak menunggu kunci pembaruan.
1291 1298
1292<h3 id="couldnt-save-your-login">1299<h3 id="couldnt-save-your-login">
1293 Tidak dapat menyimpan login Anda1300 Tidak dapat menyimpan login Anda
1294</h3>1301</h3>
1295 1302
1296Anda masuk dengan claude.ai, tetapi Claude Code tidak dapat menyimpan login ke penyimpanan kredensialnya, jadi login tidak selesai. Di macOS ini dapat terjadi ketika keychain login terkunci, misalnya saat tidur atau menganggur, setelah Claude Code sudah membaca atau menyimpan kredensial di dalamnya selama sesi yang sama.1303Anda masuk dengan claude.ai, tetapi Claude Code tidak dapat menyimpan login ke penyimpanan kredensialnya, sehingga login tidak selesai. Di macOS, hal ini dapat terjadi ketika keychain login terkunci, misalnya saat sleep atau idle, setelah Claude Code sudah membaca atau menyimpan kredensial di dalamnya selama sesi yang sama.
1297 1304
1298```text theme={null}1305```text theme={null}
1299Couldn't save your login. If your Mac's keychain is locked, unlock it and log in again.1306Couldn't save your login. If your Mac's keychain is locked, unlock it and log in again.
1300Couldn't save your login. Try logging in again.1307Couldn't save your login. Try logging in again.
1301```1308```
1302 1309
1303Bentuk pertama muncul di macOS dan yang kedua di mana-mana. Kegagalan penyimpanan kredensial sementara, seperti timeout atau penyimpanan yang tidak dapat dibaca, menghasilkan pesan yang sama.1310Bentuk pertama muncul di macOS dan bentuk kedua di platform lainnya. Kegagalan penyimpanan kredensial yang bersifat sementara, seperti timeout atau penyimpanan yang tidak dapat dibaca, menghasilkan pesan yang sama.
1304 1311
1305**Yang harus dilakukan:**1312**Yang harus dilakukan:**
1306 1313
1307* Di macOS, buka kunci keychain login, kemudian jalankan `/login` lagi1314* Di macOS, buka kunci keychain login, lalu jalankan `/login` lagi
1308* Di platform lain, jalankan `/login` lagi1315* Di platform lain, jalankan `/login` lagi
1309* Jika login masih tidak menyimpan, lihat [Belum masuk atau token kedaluwarsa](/docs/id/troubleshoot-install#not-logged-in-or-token-expired) untuk perintah buka kunci keychain dan langkah pemulihan penyimpanan kredensial lainnya1316* Jika login masih tidak tersimpan, lihat [Belum masuk atau token kedaluwarsa](/docs/id/troubleshoot-install#not-logged-in-or-token-expired) untuk perintah membuka kunci keychain dan langkah pemulihan penyimpanan kredensial lainnya
1310 1317
1311<h3 id="failed-to-start-oauth-callback-server">1318<h3 id="failed-to-start-oauth-callback-server">
1312 Gagal memulai server callback OAuth1319 Gagal memulai server callback OAuth
1313</h3>1320</h3>
1314 1321
1315Ketika `/login`, `claude auth login`, atau `claude setup-token` menandatangani Anda melalui browser, Claude Code membuka port mendengarkan pada `127.0.0.1` sehingga browser Anda dapat mengembalikan hasil masuk ke sana. Pesan ini berarti Claude Code tidak dapat membuka port itu, dan masuk berhenti sebelum jendela browser atau URL login muncul:1322Ketika `/login`, `claude auth login`, atau `claude setup-token` memasukkan Anda melalui browser, Claude Code membuka port yang mendengarkan di `127.0.0.1` agar browser Anda dapat mengembalikan hasil login kepadanya. Pesan ini berarti Claude Code tidak dapat membuka port tersebut, dan proses masuk berhenti sebelum jendela browser atau URL login muncul:
1316 1323
1317```text theme={null}1324```text theme={null}
1318Failed to start OAuth callback server: Failed to start server. Is port 0 in use?1325Failed to start OAuth callback server: Failed to start server. Is port 0 in use?
1319```1326```
1320 1327
1321Jika pesan Anda berakhir dengan `Is port 0 in use?`, upaya untuk mendengarkan pada alamat loopback IPv4 `127.0.0.1` gagal total. Karena kegagalan terjadi sebelum URL login ada, alur `Paste code here if prompted` tidak tersedia sebagai solusi.1328Jika pesan Anda diakhiri dengan `Is port 0 in use?`, upaya untuk mendengarkan di alamat loopback IPv4 `127.0.0.1` gagal sepenuhnya. Karena kegagalan terjadi sebelum URL login ada, alur `Paste code here if prompted` tidak tersedia sebagai solusi alternatif.
1322 1329
1323**Yang harus dilakukan:**1330**Yang harus dilakukan:**
1324 1331
1325* Untuk masuk sekarang tanpa pendengar lokal: jika Anda menggunakan langganan claude.ai, jalankan [`claude setup-token`](/docs/id/authentication#generate-a-long-lived-token) di mesin tempat masuk berfungsi dan atur token yang dicetak sebagai `CLAUDE_CODE_OAUTH_TOKEN` di mesin ini. Jika tidak, atur `ANTHROPIC_API_KEY` ke kunci dari [Claude Console](https://platform.claude.com/settings/keys). [Urutan prioritas autentikasi](/docs/id/authentication#authentication-precedence) menjelaskan bagaimana Claude Code memilih antara kredensial.1332* Untuk langsung masuk tanpa listener lokal: jika Anda menggunakan langganan claude.ai, jalankan [`claude setup-token`](/docs/id/authentication#generate-a-long-lived-token) di mesin tempat proses masuk berfungsi dan atur token yang dicetaknya sebagai `CLAUDE_CODE_OAUTH_TOKEN` di mesin ini. Jika tidak, atur `ANTHROPIC_API_KEY` ke kunci dari [Claude Console](https://platform.claude.com/settings/keys). [Prioritas autentikasi](/docs/id/authentication#authentication-precedence) menjelaskan cara Claude Code memilih di antara kredensial.
1326* Untuk menggunakan masuk browser di mesin ini sebagai gantinya, Claude Code harus dapat mendengarkan pada `127.0.0.1`. Jika berjalan di dalam sandbox, periksa bahwa kebijakan sandbox memungkinkan mendengarkan pada port lokal, kemudian jalankan `/login` lagi. Jika seharusnya dapat dan masih gagal, jalankan `/feedback` sehingga laporan mencakup detail lingkungan Anda.1333* Untuk menggunakan login browser di mesin ini, Claude Code harus dapat mendengarkan di `127.0.0.1`. Jika Claude Code berjalan di dalam sandbox, periksa apakah kebijakan sandbox mengizinkan mendengarkan di port lokal, lalu jalankan `/login` lagi. Jika seharusnya bisa dan masih gagal, jalankan `/feedback` agar laporan menyertakan detail lingkungan Anda.
1327 1334
1328<h3 id="claude-login-not-accepted">1335<h3 id="claude-login-not-accepted">
1329 Login Claude tidak diterima1336 Login Claude tidak diterima
1330</h3>1337</h3>
1331 1338
1332Anda mencoba memulai [sesi cloud](/docs/id/claude-code-on-the-web), dan server menolak untuk membuatnya dengan 401: itu tidak menerima login Claude yang dikirim mesin ini, biasanya karena login kedaluwarsa atau dicabut.1339Anda mencoba memulai [sesi cloud](/docs/id/claude-code-on-the-web), dan server menolak membuatnya dengan 401: server tidak menerima login Claude yang dikirim mesin ini, biasanya karena login telah kedaluwarsa atau dicabut.
1333 1340
1334Bagian pertama dari baris adalah alasan server sendiri ketika memberikan satu. Jika tidak, baris berbunyi:1341Bagian pertama baris adalah alasan dari server itu sendiri jika server memberikannya. Jika tidak, barisnya berbunyi:
1335 1342
1336```text theme={null}1343```text theme={null}
1337Claude login not accepted · Run /login, then try again1344Claude login not accepted · Run /login, then try again
1339 1346
1340**Yang harus dilakukan:**1347**Yang harus dilakukan:**
1341 1348
1342* Jalankan `/login`, selesaikan masuk, kemudian mulai sesi lagi1349* Jalankan `/login`, selesaikan proses masuk, lalu mulai sesi lagi
1343 1350
1344<h3 id="artifacts-need-a-claude-ai-login">1351<h3 id="artifacts-need-a-claude-ai-login">
1345 Artefak memerlukan login claude.ai1352 Artifact memerlukan login claude.ai
1346</h3>1353</h3>
1347 1354
1348Claude Code menolak publikasi atau pembacaan [artefak](/docs/id/artifacts) karena sesi tidak memiliki login claude.ai yang dapat digunakan untuk artefak.1355Claude Code menolak publikasi atau pembacaan [artifact](/docs/id/artifacts) karena sesi tidak memiliki login claude.ai yang dapat digunakan untuk artifact.
1349 1356
1350Setiap bentuk pesan dimulai dengan kata-kata yang sama, diikuti dengan solusi yang tergantung pada cara sesi Anda autentikasi. Tanpa kredensial yang bersaing, itu berbunyi:1357Setiap bentuk pesan diawali dengan kata-kata yang sama, diikuti dengan solusi yang bergantung pada cara sesi Anda diautentikasi. Tanpa kredensial yang bersaing, pesannya berbunyi:
1351 1358
1352```text theme={null}1359```text theme={null}
1353Artifacts need a claude.ai login. Run /login and select "Claude account with subscription", then retry — the "Anthropic Console account" option does not provide claude.ai credentials.1360Artifacts need a claude.ai login. Run /login and select "Claude account with subscription", then retry — the "Anthropic Console account" option does not provide claude.ai credentials.
1356**Yang harus dilakukan:**1363**Yang harus dilakukan:**
1357 1364
1358* Jalankan `/login` dan pilih **Claude account with subscription**. Opsi **Anthropic Console account** tidak menyediakan kredensial claude.ai.1365* Jalankan `/login` dan pilih **Claude account with subscription**. Opsi **Anthropic Console account** tidak menyediakan kredensial claude.ai.
1359* Ketika pesan menamai kredensial yang mengambil prioritas, seperti `ANTHROPIC_API_KEY`, pengaturan `apiKeyHelper`, atau kunci Console yang disimpan oleh `/login` sebelumnya, hapus dengan cara yang dikatakan pesan, kemudian jalankan `/login`1366* Ketika pesan menyebutkan kredensial yang diutamakan, seperti `ANTHROPIC_API_KEY`, pengaturan `apiKeyHelper`, atau kunci Console yang disimpan oleh `/login` sebelumnya, hapus kredensial tersebut sesuai petunjuk pesan, lalu jalankan `/login`
1360* Ketika pesan mengatakan sesi jarak jauh ini autentikasi melalui mesin yang meluncurkannya, masuk ke claude.ai di mesin itu, kemudian hubungkan kembali sesi1367* Ketika pesan menyebutkan bahwa sesi jarak jauh ini diautentikasi melalui mesin yang meluncurkannya, masuk ke claude.ai di mesin tersebut, lalu sambungkan ulang sesi
1361* Ketika pesan mengatakan kredensial disuntikkan oleh lingkungan host sesi, Anda tidak dapat mengubahnya dalam sesi itu; mulai sesi yang masuk ke claude.ai1368* Ketika pesan menyebutkan bahwa kredensial disuntikkan oleh lingkungan host sesi, Anda tidak dapat mengubahnya di sesi tersebut; mulai sesi yang telah masuk ke claude.ai
1362* Lihat [Ketersediaan](/docs/id/artifacts#availability) untuk persyaratan lain yang dimiliki artefak, seperti rencana, penyedia model, dan kebijakan organisasi1369* Lihat [Ketersediaan](/docs/id/artifacts#availability) untuk persyaratan lain yang dimiliki artifact, seperti paket, penyedia model, dan kebijakan organisasi
1363 1370
1364<h3 id="administrator-policy-requires-a-cloud-gateway-sign-in">1371<h3 id="administrator-policy-requires-a-cloud-gateway-sign-in">
1365 Kebijakan administrator memerlukan masuk Cloud gateway1372 Kebijakan administrator mengharuskan login Cloud gateway
1366</h3>1373</h3>
1367 1374
1368Pengaturan [managed settings](/docs/id/managed-settings) administrator di mesin ini menetapkan [`forceLoginMethod`](/docs/id/settings-reference#forceloginmethod) ke `"gateway"` atau menetapkan [`forceLoginGatewayUrl`](/docs/id/settings-reference#forcelogingatewayurl). Kecuali Anda memilih penyedia cloud melalui variabel seperti `CLAUDE_CODE_USE_BEDROCK`, Claude Code kemudian hanya menerima masuk [gateway aplikasi Claude](/docs/id/claude-apps-gateway). Anda melihat salah satu dari dua pesan:1375[Pengaturan terkelola](/docs/id/managed-settings) administrator di mesin ini mengatur [`forceLoginMethod`](/docs/id/settings-reference#forceloginmethod) ke `"gateway"` atau mengatur [`forceLoginGatewayUrl`](/docs/id/settings-reference#forcelogingatewayurl). Kecuali Anda memilih penyedia cloud melalui variabel seperti `CLAUDE_CODE_USE_BEDROCK`, Claude Code kemudian hanya menerima login [Claude apps gateway](/docs/id/claude-apps-gateway). Anda akan melihat salah satu dari dua pesan:
1369 1376
1370```text theme={null}1377```text theme={null}
1371Not signed in to the Cloud gateway — run /login.1378Not signed in to the Cloud gateway — run /login.
1372```1379```
1373 1380
1374Permintaan model gagal dengan pesan ini ketika sesi tidak memiliki masuk gateway, misalnya karena Anda belum menjalankan `/login` sejak kebijakan mencapai mesin.1381Permintaan model gagal dengan pesan ini ketika sesi tidak memiliki login gateway, misalnya karena Anda belum menjalankan `/login` sejak kebijakan tersebut mencapai mesin.
1375 1382
1376Jika mesin juga menyimpan kredensial yang diterbitkan Anthropic dan pengaturan yang dikelola menetapkan `forceLoginMethod` atau `forceLoginOrgUUID`, Claude Code keluar saat startup sebagai gantinya. Kredensial itu dapat berupa variabel `ANTHROPIC_API_KEY` atau `ANTHROPIC_AUTH_TOKEN`, pengaturan `apiKeyHelper`, atau kunci API yang disimpan oleh login Claude Console sebelumnya. Pesan dimulai:1383Jika mesin juga menyimpan kredensial yang diterbitkan Anthropic dan pengaturan terkelola mengatur `forceLoginMethod` atau `forceLoginOrgUUID`, Claude Code keluar saat startup. Kredensial tersebut dapat berupa variabel `ANTHROPIC_API_KEY` atau `ANTHROPIC_AUTH_TOKEN`, pengaturan `apiKeyHelper`, atau kunci API yang disimpan oleh login Claude Console sebelumnya. Pesannya diawali dengan:
1377 1384
1378```text theme={null}1385```text theme={null}
1379Administrator policy requires a Cloud gateway sign-in on this machine; the1386Administrator policy requires a Cloud gateway sign-in on this machine; the
1383 1390
1384**Yang harus dilakukan:**1391**Yang harus dilakukan:**
1385 1392
1386* Jalankan `/login` dan selesaikan masuk di layar **Cloud gateway**1393* Jalankan `/login` dan selesaikan proses masuk di layar **Cloud gateway**
1387* Untuk pesan startup, hapus `ANTHROPIC_API_KEY`, `ANTHROPIC_AUTH_TOKEN`, atau pengaturan `apiKeyHelper` yang Anda konfigurasikan. Untuk menghapus kunci API Console yang disimpan, jalankan `claude auth logout`, yang juga menghapus login claude.ai yang disimpan. Jika Anda memilih penyedia cloud dengan `CLAUDE_CODE_USE_*`, sesi kemudian dimulai tanpa masuk. Jika tidak, mulai `claude` dan jalankan `/login`1394* Untuk pesan startup, hapus pengaturan `ANTHROPIC_API_KEY`, `ANTHROPIC_AUTH_TOKEN`, atau `apiKeyHelper` yang Anda konfigurasikan. Untuk menghapus kunci API Console yang tersimpan, jalankan `claude auth logout`, yang juga menghapus login claude.ai yang tersimpan. Jika Anda memilih penyedia cloud dengan `CLAUDE_CODE_USE_*`, sesi kemudian dimulai tanpa login. Jika tidak, mulai `claude` dan jalankan `/login`
1388* Jika Anda percaya mesin tidak boleh memerlukan gateway, minta administrator yang mengelolanya untuk menghapus `forceLoginMethod` dan `forceLoginGatewayUrl` dari pengaturan yang dikelolanya1395* Jika Anda yakin mesin tersebut seharusnya tidak mengharuskan gateway, minta administrator yang mengelolanya untuk menghapus `forceLoginMethod` dan `forceLoginGatewayUrl` dari pengaturan terkelolanya
1389 1396
1390Pada v2.1.265, regresi juga menampilkan pesan pertama dalam beberapa konfigurasi gateway LLM dan proxy yang autentikasi dengan kunci API, `apiKeyHelper`, atau header khusus, bahkan tanpa persyaratan administrator di mesin. Perbarui ke v2.1.266 atau lebih baru. Anda tidak perlu mengubah konfigurasi Anda.1397Pada v2.1.265, sebuah regresi juga menampilkan pesan pertama di beberapa konfigurasi LLM gateway dan proxy yang melakukan autentikasi dengan kunci API, `apiKeyHelper`, atau header kustom, bahkan tanpa persyaratan administrator di mesin tersebut. Perbarui ke v2.1.266 atau yang lebih baru. Anda tidak perlu mengubah konfigurasi Anda.
1391 1398
1392Sebelum v2.1.261, pada mesin yang menetapkan `forceLoginMethod` ke `"gateway"`, Claude Code menggunakan login yang disimpan sisa daripada gagal permintaan model, dan melaporkan kredensial lingkungan yang dikonfigurasi dengan `This machine's managed settings require a first-party login` daripada pesan startup. Sebelum v2.1.265, mesin yang pengaturan yang dikelolanya hanya menetapkan `forceLoginGatewayUrl` tidak memerlukan masuk gateway, dan Claude Code menggunakan kredensial sisa di sana.1399Sebelum v2.1.261, pada mesin yang mengatur `forceLoginMethod` ke `"gateway"`, Claude Code menggunakan login tersimpan yang tersisa alih-alih menggagalkan permintaan model, dan melaporkan kredensial lingkungan yang dikonfigurasi dengan `This machine's managed settings require a first-party login` alih-alih pesan startup. Sebelum v2.1.265, mesin yang pengaturan terkelolanya hanya mengatur `forceLoginGatewayUrl` tidak mengharuskan login gateway, dan Claude Code menggunakan kredensial yang tersisa di sana.
1393 1400
1394<h3 id="your-account-is-on-hold">1401<h3 id="your-account-is-on-hold">
1395 Akun Anda ditahan1402 Akun Anda ditangguhkan
1396</h3>1403</h3>
1397 1404
1398Akun Claude di balik login Anda telah ditangguhkan. Claude Code menampilkan pesan pertama ketika mencoba memperbarui login yang disimpan dan mempelajari tentang penahan, dan yang kedua ketika masuk yang Anda selesaikan di browser melaporkannya:1405Akun Claude di balik login Anda telah ditangguhkan. Claude Code menampilkan pesan pertama ketika mencoba memperbarui login tersimpan Anda dan mengetahui adanya penangguhan, dan pesan kedua ketika proses masuk yang Anda selesaikan di browser melaporkannya:
1399 1406
1400```text theme={null}1407```text theme={null}
1401Your account is on hold and can't use Claude Code. View details or appeal: https://claude.ai/restricted1408Your account is on hold and can't use Claude Code. View details or appeal: https://claude.ai/restricted
1402Your account is on hold and can't sign in to Claude Code. View details or appeal: https://claude.ai/restricted1409Your account is on hold and can't sign in to Claude Code. View details or appeal: https://claude.ai/restricted
1403```1410```
1404 1411
1405Masuk lagi dengan akun yang sama tidak menghapus pesan, karena penahan ada di akun daripada login. Dalam [mode non-interaktif](/docs/id/headless) (`-p`) dan [Agent SDK](/docs/id/agent-sdk/overview), kode kesalahan terstruktur adalah `account_on_hold`. Sebelum v2.1.235, Claude Code melaporkan akun yang ditahan sebagai [Login kedaluwarsa · Jalankan /login](#login-expired), yang langkah pemulihannya tidak dapat menghapus penahan.1412Masuk kembali dengan akun yang sama tidak menghilangkan pesan ini, karena penangguhan berlaku pada akun, bukan pada login. Dalam [mode non-interaktif](/docs/id/headless) (`-p`) dan [Agent SDK](/docs/id/agent-sdk/overview), kode kesalahan terstrukturnya adalah `account_on_hold`. Sebelum v2.1.235, Claude Code melaporkan akun yang ditangguhkan sebagai [Login expired · Please run /login](#login-expired), yang langkah pemulihannya tidak dapat menghapus penangguhan.
1406 1413
1407**Yang harus dilakukan:**1414**Yang harus dilakukan:**
1408 1415
1409* Buka tautan dalam pesan untuk melihat detail penahan atau mengajukan banding1416* Buka tautan di pesan untuk melihat detail penangguhan atau mengajukan banding
1410* Jika Anda memiliki akun Claude lain atau kunci API yang tidak terpengaruh oleh penahan, Anda dapat terus bekerja saat penahan diselesaikan: jalankan `/login` dengan akun itu, atau atur kunci dengan `ANTHROPIC_API_KEY`1417* Jika Anda memiliki akun Claude lain atau kunci API yang tidak terpengaruh oleh penangguhan, Anda dapat terus bekerja selama penangguhan diselesaikan: jalankan `/login` dengan akun tersebut, atau atur kunci dengan `ANTHROPIC_API_KEY`
1411 1418
1412<h3 id="anthropic-profile-login-expired">1419<h3 id="anthropic-profile-login-expired">
1413 Login profil Anthropic kedaluwarsa1420 Login profil Anthropic kedaluwarsa
1414</h3>1421</h3>
1415 1422
1416Claude Code autentikasi melalui profil kredensial Anthropic yang kredensial login yang disimpannya kedaluwarsa, dan profil tidak menyimpan kredensial penyegaran yang dapat digunakan Claude Code untuk memperbarui. Claude Code menghentikan setiap permintaan secara lokal tanpa mencoba ulang, karena percobaan ulang akan membaca kredensial yang sama yang kedaluwarsa.1423Claude Code melakukan autentikasi melalui profil kredensial Anthropic yang kredensial login tersimpannya telah kedaluwarsa, dan profil tersebut tidak menyimpan kredensial pembaruan yang dapat digunakan Claude Code untuk memperbaruinya. Claude Code menghentikan setiap permintaan secara lokal tanpa mencoba ulang, karena retry akan membaca kredensial kedaluwarsa yang sama.
1417 1424
1418```text theme={null}1425```text theme={null}
1419Anthropic profile login expired · Re-authenticate your Anthropic profile1426Anthropic profile login expired · Re-authenticate your Anthropic profile
1420Anthropic profile login expired · Run /login to use your claude.ai account instead, or re-authenticate the profile1427Anthropic profile login expired · Run /login to use your claude.ai account instead, or re-authenticate the profile
1421```1428```
1422 1429
1423Ini muncul hanya ketika kredensial aktif berasal dari profil kredensial Anthropic, yang Anda pilih dengan variabel lingkungan `ANTHROPIC_PROFILE`, yang Claude Code temukan sebagai profil aktif di direktori konfigurasi Anthropic Anda, atau yang Claude Code tulis ketika Anda [masuk tanpa kunci API](/docs/id/authentication#sign-in-without-an-api-key). Sesi yang autentikasi dengan opsi claude.ai `/login`, kunci API, token pembawa seperti `ANTHROPIC_AUTH_TOKEN`, atau penyedia pihak ketiga tidak pernah melihat pesan ini.1430Pesan ini hanya muncul ketika kredensial aktif berasal dari profil kredensial Anthropic, yaitu profil yang Anda pilih dengan environment variable `ANTHROPIC_PROFILE`, yang ditemukan Claude Code sebagai profil aktif di direktori konfigurasi Anthropic Anda, atau yang ditulis Claude Code ketika Anda [masuk tanpa kunci API](/docs/id/authentication#sign-in-without-an-api-key). Sesi yang diautentikasi dengan kunci API, bearer token seperti `ANTHROPIC_AUTH_TOKEN`, atau penyedia pihak ketiga tidak pernah melihat pesan ini.
1424 1431
1425Di mesin yang [menawarkan masuk tanpa kunci](/docs/id/authentication#sign-in-without-an-api-key), jalankan `/login`, pilih akun Anthropic Console, dan masuk lagi untuk memperbarui profil yang ditulis oleh masuk Console tanpa kunci atau CLI Platform Claude `ant auth login`. Claude Code mengganti kredensial yang kedaluwarsa dalam profil itu. Untuk profil federasi atau yang dibuat alat lain, `/login` tidak memperbarui kredensial. Bentuk mana yang Anda lihat tergantung pada apakah Anda memilih profil atau Claude Code menemukannya:1432Pada mesin yang [menawarkan login tanpa kunci](/docs/id/authentication#sign-in-without-an-api-key), jalankan `/login`, pilih akun Anthropic Console, dan masuk kembali untuk memperbarui profil yang ditulis oleh login Console tanpa kunci atau oleh `ant auth login` dari Claude Platform CLI. Claude Code mengganti kredensial yang kedaluwarsa di profil tersebut. Untuk profil federasi atau profil yang dibuat oleh alat lain, `/login` tidak memperbarui kredensial. Bentuk yang Anda lihat bergantung pada apakah Anda memilih profil tersebut atau Claude Code menemukannya:
1426 1433
1427* Ketika Anda menetapkan `ANTHROPIC_PROFILE` secara eksplisit, pesan berakhir dengan `Re-authenticate your Anthropic profile`.1434* Ketika Anda mengatur `ANTHROPIC_PROFILE` secara eksplisit, pesan diakhiri dengan `Re-authenticate your Anthropic profile`.
1428* Ketika Claude Code menemukan profil dari direktori konfigurasi Anda, pesan menawarkan `/login`, karena Claude Code memberikan prioritas `/login` yang berfungsi atas profil yang ditemukan dan kemudian autentikasi dengan akun claude.ai atau Console Anda sebagai gantinya. Sebelum v2.1.234, Claude Code menampilkan bentuk `Re-authenticate your Anthropic profile` dalam kasus ini juga.1435* Ketika Claude Code menemukan profil dari direktori konfigurasi Anda, pesan menawarkan `/login`, karena Claude Code mengutamakan `/login` yang berfungsi daripada profil yang ditemukan, lalu melakukan autentikasi dengan akun claude.ai atau Console Anda. Sebelum v2.1.234, Claude Code menampilkan bentuk `Re-authenticate your Anthropic profile` dalam kasus ini juga.
1429 1436
1430**Yang harus dilakukan:**1437**Yang harus dilakukan:**
1431 1438
1432* Masuk ke profil lagi, kemudian coba ulang: di mesin yang [menawarkan masuk tanpa kunci](/docs/id/authentication#sign-in-without-an-api-key), jalankan `/login` dan pilih akun Anthropic Console untuk profil yang ditulis oleh masuk Console tanpa kunci atau CLI Platform Claude `ant auth login`; untuk profil lain, gunakan alat yang membuatnya1439* Masuk kembali ke profil, lalu coba lagi: pada mesin yang [menawarkan login tanpa kunci](/docs/id/authentication#sign-in-without-an-api-key), jalankan `/login` dan pilih akun Anthropic Console untuk profil yang ditulis oleh login Console tanpa kunci atau oleh `ant auth login` dari Claude Platform CLI; untuk profil lain, gunakan alat yang membuatnya
1433* Jika administrator memprovisikan kredensial profil, minta mereka untuk mengeluarkan yang baru1440* Jika administrator menyediakan kredensial profil tersebut, minta mereka untuk menerbitkan yang baru
1434* Jalankan `/status` untuk mengonfirmasi sumber kredensial aktif dan nama profil1441* Jalankan `/status` untuk memastikan sumber kredensial aktif dan nama profil
1435* Untuk berhenti menggunakan profil, batalkan pengaturan `ANTHROPIC_PROFILE` jika Anda menetapkannya, kemudian autentikasi dengan cara lain, seperti `/login` atau `ANTHROPIC_API_KEY`1442* Untuk berhenti menggunakan profil, hapus pengaturan `ANTHROPIC_PROFILE` jika Anda mengaturnya, lalu lakukan autentikasi dengan cara lain, seperti `/login` atau `ANTHROPIC_API_KEY`
1436 1443
1437<h3 id="oauth-scope-requirement">1444<h3 id="oauth-scope-requirement">
1438 Persyaratan cakupan OAuth1445 Persyaratan scope OAuth
1439</h3>1446</h3>
1440 1447
1441Token yang disimpan mendahului cakupan izin yang diperlukan fitur yang lebih baru:1448Token tersimpan dibuat sebelum adanya scope izin yang dibutuhkan oleh fitur yang lebih baru:
1442 1449
1443```text theme={null}1450```text theme={null}
1444OAuth token does not meet scope requirement: user:profile1451OAuth token does not meet scope requirement: user:profile
1446 1453
1447**Yang harus dilakukan:**1454**Yang harus dilakukan:**
1448 1455
1449* Jalankan `/login` untuk mendapatkan token baru dengan cakupan saat ini. Anda tidak perlu keluar terlebih dahulu.1456* Jalankan `/login` untuk mendapatkan token baru dengan scope saat ini. Anda tidak perlu keluar terlebih dahulu.
1450 1457
1451<h3 id="claude-ai-rejected-the-session-token">1458<h3 id="claude-ai-rejected-the-session-token">
1452 claude.ai menolak token sesi1459 claude.ai menolak token sesi
1453</h3>1460</h3>
1454 1461
1455Permintaan [konektor claude.ai](/docs/id/mcp#use-mcp-servers-from-claude-ai) gagal karena claude.ai menolak token dari login Claude Code Anda. Token yang ditolak adalah login Anda, bukan otorisasi konektor sendiri di claude.ai, jadi mengotorisasi konektor lagi tidak menyelesaikannya. Dalam `/mcp`, konektor menampilkan sebagai `session token rejected` dan tampilan detailnya berbunyi:1462Permintaan [konektor claude.ai](/docs/id/mcp#use-mcp-servers-from-claude-ai) gagal karena claude.ai menolak token dari login Claude Code Anda. Token yang ditolak adalah login Anda, bukan otorisasi konektor itu sendiri di claude.ai, sehingga mengotorisasi ulang konektor tidak menyelesaikannya. Di `/mcp`, konektor ditampilkan sebagai `session token rejected` dan tampilan detailnya berbunyi:
1456 1463
1457```text theme={null}1464```text theme={null}
1458claude.ai rejected the session token. Run /login, then reconnect.1465claude.ai rejected the session token. Run /login, then reconnect.
1460 1467
1461**Yang harus dilakukan:**1468**Yang harus dilakukan:**
1462 1469
1463* Jalankan `/login` untuk masuk lagi1470* Jalankan `/login` untuk masuk kembali
1464* Hubungkan kembali konektor dari `/mcp`, atau jalankan `/mcp reconnect <server>`. Menghubungkan kembali sebelum Anda masuk lagi meninggalkan konektor dalam keadaan yang sama. Opsi **Reconnect** panel `/mcp` melaporkan `your claude.ai session token was rejected`; bentuk `/mcp reconnect <server>` yang diketik melaporkan reconnect yang berhasil meskipun token masih ditolak.1471* Sambungkan ulang konektor dari `/mcp`, atau jalankan `/mcp reconnect <server>`. Menyambung ulang sebelum Anda masuk kembali akan membiarkan konektor dalam kondisi yang sama. Opsi **Reconnect** di panel `/mcp` melaporkan `your claude.ai session token was rejected`; bentuk `/mcp reconnect <server>` yang diketik melaporkan penyambungan ulang yang berhasil meskipun token masih ditolak.
1465 1472
1466Sebelum v2.1.222, Claude Code menandai konektor sebagai memerlukan autentikasi sebagai gantinya, yang menunjukkan Anda pada alur otorisasi konektor meskipun menyelesaikannya tidak menyelesaikan keadaan.1473Sebelum v2.1.222, Claude Code menandai konektor sebagai memerlukan autentikasi, yang mengarahkan Anda ke alur otorisasi konektor meskipun menyelesaikannya tidak menyelesaikan kondisi tersebut.
1467 1474
1468<h3 id="mcp-server-needs-you-to-sign-in-again">1475<h3 id="mcp-server-needs-you-to-sign-in-again">
1469 Server MCP memerlukan Anda untuk masuk lagi1476 Server MCP mengharuskan Anda masuk kembali
1470</h3>1477</h3>
1471 1478
1472Server [MCP](/docs/id/mcp) jarak jauh menolak kredensial pada panggilan alat di tengah sesi, biasanya karena masuk atau token kedaluwarsa atau karena token kekurangan izin yang diperlukan alat. Panggilan alat gagal, dan `/mcp` menandai server sebagai [memerlukan autentikasi](/docs/id/mcp#authenticate-with-remote-mcp-servers).1479[Server MCP](/docs/id/mcp) jarak jauh menolak kredensial pada panggilan tool di tengah sesi, biasanya karena login atau token telah kedaluwarsa atau karena token tidak memiliki izin yang dibutuhkan tool tersebut. Panggilan tool gagal, dan `/mcp` menandai server sebagai [memerlukan autentikasi](/docs/id/mcp#authenticate-with-remote-mcp-servers).
1473 1480
1474Untuk server yang Anda masuki dari Claude Code, termasuk konektor claude.ai, masuk kedaluwarsa atau dicabut:1481Untuk server yang Anda masuki dari Claude Code, termasuk konektor claude.ai, login telah kedaluwarsa atau dicabut:
1475 1482
1476```text theme={null}1483```text theme={null}
1477MCP server "<name>" needs you to sign in again (run /mcp to re-authenticate)1484MCP server "<name>" needs you to sign in again (run /mcp to re-authenticate)
1478```1485```
1479 1486
1480Jalankan `/mcp`, pilih server, dan masuk lagi dari menunya.1487Jalankan `/mcp`, pilih server, dan masuk kembali dari menunya.
1481 1488
1482Untuk server yang dikonfigurasi dengan skrip [`headersHelper`](/docs/id/mcp#use-dynamic-headers-for-custom-authentication), Claude Code sudah menjalankan kembali helper dan mencoba ulang panggilan sekali sebelum menampilkan ini:1489Untuk server yang dikonfigurasi dengan skrip [`headersHelper`](/docs/id/mcp#use-dynamic-headers-for-custom-authentication), Claude Code telah menjalankan ulang helper dan mencoba ulang panggilan sekali sebelum menampilkan ini:
1483 1490
1484```text theme={null}1491```text theme={null}
1485MCP server "<name>" rejected the credential from its headersHelper (check the helper and run /mcp to reconnect, or to authenticate if the server also uses OAuth)1492MCP server "<name>" rejected the credential from its headersHelper (check the helper and run /mcp to reconnect, or to authenticate if the server also uses OAuth)
1486```1493```
1487 1494
1488Periksa bahwa helper mengembalikan kredensial yang diterima server, kemudian hubungkan kembali dari `/mcp`, yang menjalankan helper lagi.1495Periksa apakah helper mengembalikan kredensial yang diterima server, lalu sambungkan ulang dari `/mcp`, yang menjalankan helper lagi.
1489 1496
1490Untuk server dengan header `Authorization` statis dalam konfigurasinya:1497Untuk server dengan header `Authorization` statis dalam konfigurasinya:
1491 1498
1493MCP server "<name>" rejected the Authorization header in its config (update it, then run /mcp to reconnect)1500MCP server "<name>" rejected the Authorization header in its config (update it, then run /mcp to reconnect)
1494```1501```
1495 1502
1496Perbarui nilai header tempat server dikonfigurasi, kemudian hubungkan kembali dari `/mcp`.1503Perbarui nilai header di tempat server dikonfigurasi, lalu sambungkan ulang dari `/mcp`.
1497 1504
1498Sebelum v2.1.273, kasus masuk yang kedaluwarsa, `headersHelper`, dan header `Authorization` semuanya menampilkan `MCP server "<name>" requires re-authorization (token expired)`.1505Sebelum v2.1.273, kasus login kedaluwarsa, `headersHelper`, dan header `Authorization` semuanya menampilkan `MCP server "<name>" requires re-authorization (token expired)`.
1499 1506
1500Server juga dapat menolak panggilan alat dengan HTTP 403 `insufficient_scope` untuk meminta Anda mengotorisasi cakupan, kadang-kadang yang sudah tercantum dalam token Anda. Pesan menamai cakupan itu:1507Server juga dapat menolak panggilan tool dengan HTTP 403 `insufficient_scope` untuk meminta Anda mengotorisasi suatu scope, terkadang scope yang sudah tercantum dalam token Anda. Pesan menyebutkan scope tersebut:
1501 1508
1502```text theme={null}1509```text theme={null}
1503MCP server "<name>" needs additional permissions (scope: "<scope>") — run /mcp to re-authenticate1510MCP server "<name>" needs additional permissions (scope: "<scope>") — run /mcp to re-authenticate
1504```1511```
1505 1512
1506Jalankan `/mcp`, pilih server, dan autentikasi lagi dari menunya.1513Jalankan `/mcp`, pilih server, dan lakukan autentikasi ulang dari menunya.
1507 1514
1508Ketika konfigurasi server tidak menetapkan [`oauth.scopes`](/docs/id/mcp#restrict-oauth-scopes) atau [`authServerMetadataUrl`](/docs/id/mcp#override-oauth-metadata-discovery), Claude Code meminta cakupan yang dinamai server. Dengan pengaturan apa pun, Claude Code meminta cakupan pengaturan itu sebagai gantinya. Jika Anda menyematkan `oauth.scopes`, tambahkan cakupan yang hilang ke daftar itu sebelum Anda autentikasi lagi.1515Ketika konfigurasi server tidak mengatur [`oauth.scopes`](/docs/id/mcp#restrict-oauth-scopes) maupun [`authServerMetadataUrl`](/docs/id/mcp#override-oauth-metadata-discovery), Claude Code meminta scope yang disebutkan server. Dengan salah satu pengaturan tersebut, Claude Code meminta scope dari pengaturan tersebut. Jika Anda menetapkan `oauth.scopes`, tambahkan scope yang kurang ke daftar tersebut sebelum Anda melakukan autentikasi ulang.
1509 1516
1510Sebelum v2.1.274, kasus ini menampilkan pesan `needs you to sign in again`, dan sebelum v2.1.273 itu menampilkan `requires re-authorization (token expired)` seperti kasus lainnya.1517Sebelum v2.1.274, kasus ini menampilkan pesan `needs you to sign in again`, dan sebelum v2.1.273 kasus ini menampilkan `requires re-authorization (token expired)` seperti kasus lainnya.
1511 1518
1512<h3 id="mcp-server-url-is-missing-or-not-a-valid-url">1519<h3 id="mcp-server-url-is-missing-or-not-a-valid-url">
1513 URL server MCP hilang atau bukan URL yang valid1520 URL server MCP tidak ada atau bukan URL yang valid
1514</h3>1521</h3>
1515 1522
1516Claude Code menolak untuk memulai masuk OAuth untuk server MCP jarak jauh karena `url` server yang dikonfigurasi tidak diuraikan sebagai URL. Kecuali Claude Code memiliki masalah konfigurasi yang lebih spesifik untuk dilaporkan untuk server, menjalankan [`claude mcp login <name>`](/docs/id/mcp#authenticate-from-the-command-line) di shell Anda mencetak penolakan sebagai:1523Claude Code menolak memulai login OAuth untuk server MCP jarak jauh karena `url` yang dikonfigurasi untuk server tersebut tidak dapat diurai sebagai URL. Kecuali Claude Code memiliki masalah konfigurasi yang lebih spesifik untuk dilaporkan bagi server tersebut, menjalankan [`claude mcp login <name>`](/docs/id/mcp#authenticate-from-the-command-line) di shell Anda mencetak penolakan tersebut sebagai:
1517 1524
1518```text theme={null}1525```text theme={null}
1519Couldn't complete authentication for "<name>": This server's URL is missing or not a valid URL, so sign-in can't start. Fix the URL in its MCP config (or set the environment variable it uses) and try again.1526Couldn't complete authentication for "<name>": This server's URL is missing or not a valid URL, so sign-in can't start. Fix the URL in its MCP config (or set the environment variable it uses) and try again.
1521 1528
1522**Yang harus dilakukan:**1529**Yang harus dilakukan:**
1523 1530
1524* Atur entri `url` ke titik akhir server yang sebenarnya tempat server dikonfigurasi, atau atur variabel lingkungan yang dirujuk [`${VAR}`](/docs/id/mcp#environment-variable-expansion-in-mcp-json)-nya, kemudian jalankan masuk lagi.1531* Atur `url` entri ke endpoint server yang sebenarnya di tempat server dikonfigurasi, atau atur environment variable yang disebutkan oleh [referensi `${VAR}`](/docs/id/mcp#environment-variable-expansion-in-mcp-json)-nya, lalu jalankan proses masuk lagi.
1525 1532
1526<h3 id="issuer-mismatch-in-authorization-response">1533<h3 id="issuer-mismatch-in-authorization-response">
1527 Ketidaksesuaian penerbit dalam respons otorisasi1534 Ketidakcocokan issuer dalam respons otorisasi
1528</h3>1535</h3>
1529 1536
1530Selama [masuk OAuth MCP](/docs/id/mcp#authenticate-with-remote-mcp-servers), server otorisasi dialihkan kembali ke Claude Code dengan parameter `iss` yang tidak menamai penerbit yang diharapkan Claude Code dari metadata OAuth server. Penerbit yang salah pada langkah ini adalah bagaimana serangan pencampuran server otorisasi terlihat, jadi Claude Code gagal masuk daripada menukar kode otorisasi. Claude Code menampilkan kesalahan dalam menu server `/mcp` setelah masuk browser:1537Selama [login OAuth MCP](/docs/id/mcp#authenticate-with-remote-mcp-servers), server otorisasi mengalihkan kembali ke Claude Code dengan parameter `iss` yang tidak menyebutkan issuer yang diharapkan Claude Code dari metadata OAuth server. Issuer yang salah pada langkah ini adalah tanda serangan mix-up server otorisasi, sehingga Claude Code menggagalkan proses masuk alih-alih menukarkan kode otorisasi. Claude Code menampilkan kesalahan di menu server `/mcp` setelah proses masuk di browser:
1531 1538
1532```text theme={null}1539```text theme={null}
1533Issuer mismatch in authorization response (RFC 9207): expected "https://auth.example.com", received "https://other.example.com"1540Issuer mismatch in authorization response (RFC 9207): expected "https://auth.example.com", received "https://other.example.com"
1534```1541```
1535 1542
1536`expected` adalah penerbit dari metadata OAuth server, dan `received` adalah nilai `iss` yang dibawa pengalihan. Masuk yang pengalihannya tidak membawa parameter `iss` melewati pemeriksaan, kecuali metadata server menetapkan `authorization_response_iss_parameter_supported`, dalam hal ini Claude Code gagal masuk.1543`expected` adalah issuer dari metadata OAuth server, dan `received` adalah nilai `iss` yang dibawa oleh pengalihan. Proses masuk yang pengalihannya tidak membawa parameter `iss` lolos pemeriksaan, kecuali metadata server mengatur `authorization_response_iss_parameter_supported`, yang dalam hal ini Claude Code menggagalkan proses masuk.
1537 1544
1538**Yang harus dilakukan:**1545**Yang harus dilakukan:**
1539 1546
1540* Coba masuk lagi dari `/mcp`1547* Coba proses masuk lagi dari `/mcp`
1541* Jika kesalahan berulang, laporkan ke operator server. Perbaikannya adalah sisi server: server otorisasi harus mengembalikan penerbit yang sama dalam parameter `iss` yang diiklankan dalam metadata-nya1548* Jika kesalahan berulang, laporkan ke operator server. Perbaikannya ada di sisi server: server otorisasi harus mengembalikan issuer yang sama di parameter `iss` dengan yang diiklankannya di metadata
1542* Untuk terhubung saat server sedang diperbaiki, mulai Claude Code dengan [`MCP_SDK_GENERATION=v1`](/docs/id/env-vars), yang [runtime](/docs/id/mcp#mcp-client-runtimes)-nya tidak menjalankan pemeriksaan ini. Ini menghapus perlindungan terhadap serangan pencampuran, jadi lebih suka perbaikan sisi server1549* Untuk terhubung selagi server diperbaiki, mulai Claude Code dengan [`MCP_SDK_GENERATION=v1`](/docs/id/env-vars), yang [runtime](/docs/id/mcp#mcp-client-runtimes)-nya tidak menjalankan pemeriksaan ini. Ini menghilangkan perlindungan terhadap serangan mix-up, jadi utamakan perbaikan di sisi server
1543 1550
1544Sebelum v2.1.232, Claude Code menggunakan runtime v2 hanya dalam peluncuran bertahap atau ketika Anda menetapkan `MCP_SDK_GENERATION=v2`.1551Sebelum v2.1.232, Claude Code hanya menggunakan runtime v2 dalam peluncuran bertahap atau ketika Anda mengatur `MCP_SDK_GENERATION=v2`.
1545 1552
1546<h3 id="refusing-to-send-credentials-to-non-https-token-endpoint">1553<h3 id="refusing-to-send-credentials-to-non-https-token-endpoint">
1547 Menolak mengirim kredensial ke titik akhir token non-https1554 Menolak mengirim kredensial ke token endpoint non-https
1548</h3>1555</h3>
1549 1556
1550Pada [runtime v2](/docs/id/mcp#mcp-client-runtimes), Claude Code mengirim permintaan token [OAuth MCP](/docs/id/mcp#authenticate-with-remote-mcp-servers) hanya ke titik akhir token yang disajikan melalui HTTPS atau di `localhost`, `127.0.0.1`, atau `::1`. Pesan ini berarti titik akhir token server bukan keduanya, jadi Claude Code berhenti sebelum mengirim permintaan. Itu terjadi setelah masuk browser, jadi langkah browser berhasil terlebih dahulu, dan lagi setiap kali Claude Code menyegarkan token server.1557Pada [runtime v2](/docs/id/mcp#mcp-client-runtimes), Claude Code mengirim permintaan token [OAuth MCP](/docs/id/mcp#authenticate-with-remote-mcp-servers) hanya ke token endpoint yang dilayani melalui HTTPS atau di `localhost`, `127.0.0.1`, atau `::1`. Pesan ini berarti token endpoint server bukan salah satunya, sehingga Claude Code berhenti sebelum mengirim permintaan. Hal itu terjadi setelah proses masuk di browser, sehingga langkah browser berhasil terlebih dahulu, dan terjadi lagi setiap kali Claude Code memperbarui token server.
1551 1558
1552Dalam bentuk lengkapnya, pesan berasal dari MCP SDK dan mengutip titik akhir token yang ditolaknya. Dalam log debug, itu mengikuti `Error during auth completion:` untuk masuk atau `Token refresh failed:` untuk penyegaran. Di shell Anda, `claude mcp login <name>` mencetaknya setelah `Couldn't complete authentication for "<name>":`, dan dalam sesi, `/mcp` menampilkannya di bawah menu server:1559Dalam bentuk lengkapnya, pesan ini berasal dari MCP SDK dan mengutip token endpoint yang ditolaknya. Di log debug, pesan ini mengikuti `Error during auth completion:` untuk proses masuk atau `Token refresh failed:` untuk pembaruan. Di shell Anda, `claude mcp login <name>` mencetaknya setelah `Couldn't complete authentication for "<name>":`, dan dalam sesi, `/mcp` menampilkannya di bawah menu server:
1553 1560
1554```text theme={null}1561```text theme={null}
1555Refusing to send credentials to non-https token endpoint 'http://192.168.1.50:8123/oauth/token'. OAuth token requests MUST use TLS (localhost / 127.0.0.1 / ::1 are exempt).1562Refusing to send credentials to non-https token endpoint 'http://192.168.1.50:8123/oauth/token'. OAuth token requests MUST use TLS (localhost / 127.0.0.1 / ::1 are exempt).
1556```1563```
1557 1564
1558Claude Code memperlakukan URL server yang memiliki string kueri atau segmen jalur panjang yang terlihat acak sebagai kemungkinan rahasia. Untuk server seperti itu, itu menyunting kesalahan masuk yang dimunculkan MCP SDK sebelum ditampilkan atau dicatat. Kesalahan ini kemudian berbunyi sebagai nama pendek yang dapat berubah antar rilis, seperti `io`, diikuti oleh `from the MCP SDK for` dan URL server yang disunting. Kesalahan lain dari MCP SDK mengambil bentuk yang sama di sana. Pesan yang disunting hanya dapat menjadi kesalahan ini ketika titik akhir token server adalah `http://` biasa di alamat selain `localhost`, `127.0.0.1`, atau `::1`.1565Claude Code memperlakukan URL server yang memiliki query string atau segmen path panjang yang tampak acak sebagai kemungkinan rahasia. Untuk server semacam itu, Claude Code menyamarkan kesalahan login yang dimunculkan MCP SDK sebelum menampilkan atau mencatatnya ke log. Kesalahan ini kemudian terbaca sebagai nama pendek yang dapat berubah antar rilis, seperti `io`, diikuti dengan `from the MCP SDK for` dan URL server yang disamarkan. Kesalahan lain dari MCP SDK memiliki bentuk yang sama di sana. Pesan yang disamarkan dapat berupa kesalahan ini hanya jika token endpoint server adalah `http://` biasa di alamat selain `localhost`, `127.0.0.1`, atau `::1`.
1559 1566
1560**Yang harus dilakukan:**1567**Yang harus dilakukan:**
1561 1568
1562* Sajikan titik akhir token itu melalui HTTPS, misalnya dengan menempatkan server di belakang proxy terbalik atau terowongan yang menghentikan TLS dan mengonfigurasi server untuk mengiklankan alamat `https://`1569* Layani token endpoint tersebut melalui HTTPS, misalnya dengan menempatkan server di belakang reverse proxy atau tunnel yang menangani TLS dan mengonfigurasi server untuk mengiklankan alamat `https://`
1563* Untuk terhubung tanpa mengubah server, mulai Claude Code dengan [`MCP_SDK_GENERATION=v1`](/docs/id/env-vars), yang [runtime](/docs/id/mcp#mcp-client-runtimes)-nya tidak menerapkan aturan ini dan mengirim permintaan token melalui HTTP biasa. Pilihan itu berlangsung sampai Anda keluar dan berlaku untuk setiap server. Runtime v1 juga melewati [pemeriksaan penerbit](#issuer-mismatch-in-authorization-response), jadi lebih suka menyajikan titik akhir melalui HTTPS1570* Untuk terhubung tanpa mengubah server, mulai Claude Code dengan [`MCP_SDK_GENERATION=v1`](/docs/id/env-vars), yang [runtime](/docs/id/mcp#mcp-client-runtimes)-nya tidak menerapkan aturan ini dan mengirim permintaan token melalui HTTP biasa. Pilihan tersebut berlaku hingga Anda keluar dan berlaku untuk setiap server. Runtime v1 juga melewati [pemeriksaan issuer](#issuer-mismatch-in-authorization-response), jadi utamakan melayani endpoint melalui HTTPS
1564 1571
1565<h3 id="aws-credentials-expired-or-invalid">1572<h3 id="aws-credentials-expired-or-invalid">
1566 Kredensial AWS kedaluwarsa atau tidak valid1573 Kredensial AWS kedaluwarsa atau tidak valid
1567</h3>1574</h3>
1568 1575
1569Token sesi AWS Anda kedaluwarsa atau ditolak. Pesan ini muncul pada 401 dari [Claude Platform di AWS](/docs/id/claude-platform-on-aws) atau [titik akhir Mantle](/docs/id/amazon-bedrock#use-the-mantle-endpoint), yang merupakan cara penyedia itu melaporkan token keamanan yang kedaluwarsa.1576Token sesi AWS Anda telah kedaluwarsa atau ditolak. Pesan ini muncul pada 401 dari [Claude Platform on AWS](/docs/id/claude-platform-on-aws) atau [endpoint Mantle](/docs/id/amazon-bedrock#use-the-mantle-endpoint), yang merupakan cara penyedia tersebut melaporkan token keamanan yang kedaluwarsa.
1570 1577
1571Petunjuk tindakan di tengah bervariasi dengan pengaturan Anda. Bagian yang stabil adalah `AWS credentials expired or invalid` terkemuka:1578Petunjuk tindakan di bagian tengah bervariasi sesuai penyiapan Anda. Bagian yang tetap adalah `AWS credentials expired or invalid` di awal:
1572 1579
1573```text theme={null}1580```text theme={null}
1574AWS credentials expired or invalid · run /login and select "Claude Platform on AWS · refresh credentials", or run `aws sso login --profile myprofile` in another terminal · API Error: 401 ...1581AWS credentials expired or invalid · run /login and select "Claude Platform on AWS · refresh credentials", or run `aws sso login --profile myprofile` in another terminal · API Error: 401 ...
1575```1582```
1576 1583
1577Sebelum v2.1.273, pesan ini muncul hanya ketika `awsAuthRefresh` dikonfigurasi.1584Sebelum v2.1.273, pesan ini hanya muncul ketika `awsAuthRefresh` dikonfigurasi.
1578 1585
1579**Yang harus dilakukan:**1586**Yang harus dilakukan:**
1580 1587
1581* Jika petunjuk mengatakan kredensial dikelola oleh lingkungan ini, aplikasi yang meluncurkan Claude Code memiliki kredensial dan langkah lain di sini tidak berlaku: coba ulang, atau hubungi administrator Anda1588* Jika petunjuk menyebutkan bahwa kredensial dikelola oleh lingkungan ini, aplikasi yang meluncurkan Claude Code memiliki kredensial tersebut dan langkah-langkah lain di sini tidak berlaku: coba lagi, atau hubungi administrator Anda
1582* Jika [`awsAuthRefresh`](/docs/id/amazon-bedrock#advanced-credential-configuration) diatur, jalankan perintah yang dinamai dalam pesan, seperti `aws sso login --profile myprofile`, di terminal lain dan selesaikan masuk browser, kemudian coba ulang. Jika tidak, segarkan kredensial AWS yang Anda gunakan sendiri: masuk SSO, kunci akses, kunci API, atau token proxy Anda1589* Jika [`awsAuthRefresh`](/docs/id/amazon-bedrock#advanced-credential-configuration) diatur, jalankan perintah yang disebutkan dalam pesan, seperti `aws sso login --profile myprofile`, di terminal lain dan selesaikan proses masuk di browser, lalu coba lagi. Jika tidak, perbarui sendiri kredensial AWS yang Anda gunakan: login SSO, access key, kunci API, atau token proxy Anda
1583* Dengan `awsAuthRefresh` diatur dalam sesi interaktif, Anda dapat menjalankan `/login`, pilih **3rd-party platform**, kemudian pilih **Claude Platform on AWS · refresh credentials** di bawah **Using 3rd-party platforms** untuk menjalankan perintah yang sama tanpa memulai ulang Claude Code. Lihat [Konfigurasi kredensial AWS](/docs/id/claude-platform-on-aws#1-configure-aws-credentials)1590* Dengan `awsAuthRefresh` diatur dalam sesi interaktif, Anda dapat menjalankan `/login`, memilih **3rd-party platform**, lalu memilih **Claude Platform on AWS · refresh credentials** di bawah **Using 3rd-party platforms** untuk menjalankan perintah yang sama tanpa memulai ulang Claude Code. Lihat [Mengonfigurasi kredensial AWS](/docs/id/claude-platform-on-aws#1-configure-aws-credentials)
1584* Jika kesalahan berulang setelah perintah penyegaran berhasil, konfirmasi identitas valid di luar Claude Code dengan `aws sts get-caller-identity` di shell dan profil yang sama1591* Jika kesalahan berulang setelah perintah pembaruan berhasil, pastikan identitas valid di luar Claude Code dengan `aws sts get-caller-identity` di shell dan profil yang sama
1585 1592
1586<h3 id="aws-authentication-failed">1593<h3 id="aws-authentication-failed">
1587 Autentikasi AWS gagal1594 Autentikasi AWS gagal
1589 1596
1590Penyedia AWS Anda mengembalikan 403, atau [Amazon Bedrock](/docs/id/amazon-bedrock) mengembalikan 401.1597Penyedia AWS Anda mengembalikan 403, atau [Amazon Bedrock](/docs/id/amazon-bedrock) mengembalikan 401.
1591 1598
1592Amazon Bedrock melaporkan token keamanan yang kedaluwarsa sebagai 403, tetapi 403 juga merupakan cara itu melaporkan penolakan otorisasi, seperti `AccessDeniedException` dari izin IAM yang hilang. Claude Code tidak dapat membedakan kedua penyebab itu.1599Amazon Bedrock melaporkan token keamanan yang kedaluwarsa sebagai 403, tetapi 403 juga merupakan cara Amazon Bedrock melaporkan penolakan otorisasi, seperti `AccessDeniedException` karena izin IAM yang tidak ada. Claude Code tidak dapat membedakan kedua penyebab tersebut.
1593 1600
1594401 dari Amazon Bedrock juga mendarat di sini daripada di bawah [Kredensial AWS kedaluwarsa atau tidak valid](#aws-credentials-expired-or-invalid), karena Amazon Bedrock tidak melaporkan token yang kedaluwarsa sebagai 401. 401 dari titik akhir itu biasanya berasal dari sesuatu yang lain dalam jalur permintaan, seperti proxy perusahaan.1601401 dari Amazon Bedrock juga masuk ke sini alih-alih ke [Kredensial AWS kedaluwarsa atau tidak valid](#aws-credentials-expired-or-invalid), karena Amazon Bedrock tidak melaporkan token yang kedaluwarsa sebagai 401. 401 dari endpoint tersebut biasanya berasal dari hal lain di jalur permintaan, seperti proxy perusahaan.
1595 1602
1596Penyegaran kredensial memperbaiki token yang kedaluwarsa dan tidak dapat memperbaiki penyebab lainnya, jadi pesan menawarkan keduanya:1603Pembaruan kredensial memperbaiki token yang kedaluwarsa dan tidak dapat memperbaiki penyebab lainnya, sehingga pesan menawarkan keduanya:
1597 1604
1598```text theme={null}1605```text theme={null}
1599AWS authentication failed · run /login and select "Claude Platform on AWS · refresh credentials", or run `aws sso login --profile myprofile` in another terminal · if credentials are current, check AWS permissions and model access · API Error: 403 ...1606AWS authentication failed · run /login and select "Claude Platform on AWS · refresh credentials", or run `aws sso login --profile myprofile` in another terminal · if credentials are current, check AWS permissions and model access · API Error: 403 ...
1600```1607```
1601 1608
1602Petunjuk tindakan di tengah bervariasi dengan pengaturan Anda. Bagian yang stabil adalah `AWS authentication failed` terkemuka.1609Petunjuk tindakan di bagian tengah bervariasi sesuai penyiapan Anda. Bagian yang tetap adalah `AWS authentication failed` di awal.
1603 1610
1604Ketika 403 adalah jawaban Amazon Bedrock bahwa Anda tidak memiliki akses ke model dengan ID model yang ditentukan, petunjuk sebagai gantinya memberi tahu Anda untuk mengaktifkan model untuk akun dan wilayah Anda di konsol Amazon Bedrock.1611Ketika 403 tersebut adalah jawaban Amazon Bedrock bahwa Anda tidak memiliki akses ke model dengan ID model yang ditentukan, petunjuknya justru meminta Anda untuk mengaktifkan model untuk akun dan region Anda di konsol Amazon Bedrock.
1605 1612
1606Sebelum v2.1.273, pesan ini muncul hanya ketika `awsAuthRefresh` dikonfigurasi.1613Sebelum v2.1.273, pesan ini hanya muncul ketika `awsAuthRefresh` dikonfigurasi.
1607 1614
1608**Yang harus dilakukan:**1615**Yang harus dilakukan:**
1609 1616
1610* Jika petunjuk mengatakan kredensial dikelola oleh lingkungan ini, aplikasi yang meluncurkan Claude Code memiliki kredensial dan langkah lain di sini tidak berlaku: coba ulang, atau hubungi administrator Anda1617* Jika petunjuk menyebutkan bahwa kredensial dikelola oleh lingkungan ini, aplikasi yang meluncurkan Claude Code memiliki kredensial tersebut dan langkah-langkah lain di sini tidak berlaku: coba lagi, atau hubungi administrator Anda
1611* Segarkan kredensial AWS Anda jika kredensial yang kedaluwarsa mungkin menjadi penyebabnya: jalankan perintah [`awsAuthRefresh`](/docs/id/amazon-bedrock#advanced-credential-configuration) yang dinamai dalam pesan ketika satu diatur, atau segarkan masuk SSO, kunci akses, kunci API, atau token proxy Anda sendiri1618* Perbarui kredensial AWS Anda untuk berjaga-jaga jika kredensial yang kedaluwarsa adalah penyebabnya: jalankan perintah [`awsAuthRefresh`](/docs/id/amazon-bedrock#advanced-credential-configuration) yang disebutkan dalam pesan jika ada, atau perbarui sendiri login SSO, access key, kunci API, atau token proxy Anda
1612* Jika kredensial Anda saat ini, konfirmkan izin IAM dalam [Konfigurasi IAM](/docs/id/amazon-bedrock#iam-configuration) dilampirkan ke identitas yang Anda gunakan dan model yang dipilih diaktifkan untuk akun dan wilayah Anda1619* Jika kredensial Anda masih berlaku, pastikan izin IAM di [Konfigurasi IAM](/docs/id/amazon-bedrock#iam-configuration) terpasang pada identitas yang Anda gunakan dan bahwa model yang dipilih diaktifkan untuk akun dan region Anda
1613* Jalankan `aws sts get-caller-identity` untuk mengonfirmasi identitas mana yang digunakan permintaan Anda1620* Jalankan `aws sts get-caller-identity` untuk memastikan identitas mana yang digunakan permintaan Anda
1614 1621
1615<h3 id="google-cloud-credentials-expired-or-invalid">1622<h3 id="google-cloud-credentials-expired-or-invalid">
1616 Kredensial Google Cloud kedaluwarsa atau tidak valid1623 Kredensial Google Cloud kedaluwarsa atau tidak valid
1617</h3>1624</h3>
1618 1625
1619Kredensial Google Cloud Anda untuk [Platform Agen Google Cloud](/docs/id/google-vertex-ai) kedaluwarsa atau ditolak: permintaan mengembalikan 401, yang merupakan cara Platform Agen melaporkan kedaluwarsa kredensial.1626Kredensial Google Cloud Anda untuk [Agent Platform milik Google Cloud](/docs/id/google-vertex-ai) telah kedaluwarsa atau ditolak: permintaan mengembalikan 401, yang merupakan cara Agent Platform melaporkan kedaluwarsanya kredensial.
1620 1627
1621Petunjuk tindakan di tengah bervariasi dengan pengaturan Anda. Bagian yang stabil adalah `Google Cloud credentials expired or invalid` terkemuka:1628Petunjuk tindakan di bagian tengah bervariasi sesuai penyiapan Anda. Bagian yang tetap adalah `Google Cloud credentials expired or invalid` di awal:
1622 1629
1623```text theme={null}1630```text theme={null}
1624Google Cloud credentials expired or invalid · refresh your Google Cloud credentials (application default sign-in, or the key file in GOOGLE_APPLICATION_CREDENTIALS) and retry · API Error: 401 ...1631Google Cloud credentials expired or invalid · refresh your Google Cloud credentials (application default sign-in, or the key file in GOOGLE_APPLICATION_CREDENTIALS) and retry · API Error: 401 ...
1626 1633
1627**Yang harus dilakukan:**1634**Yang harus dilakukan:**
1628 1635
1629* Jika petunjuk mengatakan kredensial dikelola oleh lingkungan ini, aplikasi yang meluncurkan Claude Code memiliki kredensial dan langkah lain di sini tidak berlaku: coba ulang, atau hubungi administrator Anda1636* Jika petunjuk menyebutkan bahwa kredensial dikelola oleh lingkungan ini, aplikasi yang meluncurkan Claude Code memiliki kredensial tersebut dan langkah-langkah lain di sini tidak berlaku: coba lagi, atau hubungi administrator Anda
1630* Jika Anda autentikasi dengan kredensial default aplikasi, jalankan perintah [`gcpAuthRefresh`](/docs/id/google-vertex-ai#advanced-credential-configuration) yang dinamai dalam pesan, atau `gcloud auth application-default login`, dan selesaikan masuk, kemudian coba ulang1637* Jika Anda melakukan autentikasi dengan application default credentials, jalankan perintah [`gcpAuthRefresh`](/docs/id/google-vertex-ai#advanced-credential-configuration) yang disebutkan dalam pesan, atau `gcloud auth application-default login`, dan selesaikan proses masuk, lalu coba lagi
1631* Jika Anda merutekan melalui [gateway LLM](/docs/id/llm-gateway) dengan `CLAUDE_CODE_SKIP_VERTEX_AUTH` diatur, segarkan token gateway dalam `ANTHROPIC_AUTH_TOKEN` atau `ANTHROPIC_CUSTOM_HEADERS`, kemudian coba ulang1638* Jika Anda merutekan melalui [LLM gateway](/docs/id/llm-gateway) dengan `CLAUDE_CODE_SKIP_VERTEX_AUTH` diatur, perbarui token gateway di `ANTHROPIC_AUTH_TOKEN` atau `ANTHROPIC_CUSTOM_HEADERS`, lalu coba lagi
1632* Jika Anda autentikasi dengan file kunci akun layanan, konfirmkan `GOOGLE_APPLICATION_CREDENTIALS` menunjuk ke kunci yang valid. Lihat [Konfigurasi kredensial GCP](/docs/id/google-vertex-ai#3-configure-gcp-credentials)1639* Jika Anda melakukan autentikasi dengan file kunci service account, pastikan `GOOGLE_APPLICATION_CREDENTIALS` mengarah ke kunci yang valid. Lihat [Mengonfigurasi kredensial GCP](/docs/id/google-vertex-ai#3-configure-gcp-credentials)
1633* Jika kesalahan berulang setelah penyegaran, konfirmkan identitas bekerja di luar Claude Code dengan `gcloud auth application-default print-access-token` di shell yang sama1640* Jika kesalahan berulang setelah pembaruan, pastikan identitas berfungsi di luar Claude Code dengan `gcloud auth application-default print-access-token` di shell yang sama
1634 1641
1635Sebelum v2.1.273, 401 dari Platform Agen menampilkan pesan `Please run /login` atau `Failed to authenticate` generik sebagai gantinya, yang tidak dapat menyegarkan kredensial Google Cloud.1642Sebelum v2.1.273, 401 dari Agent Platform menampilkan pesan generik `Please run /login` atau `Failed to authenticate`, yang tidak dapat memperbarui kredensial Google Cloud.
1636 1643
1637<h3 id="google-cloud-authentication-failed">1644<h3 id="google-cloud-authentication-failed">
1638 Autentikasi Google Cloud gagal1645 Autentikasi Google Cloud gagal
1639</h3>1646</h3>
1640 1647
1641[Platform Agen Google Cloud](/docs/id/google-vertex-ai) mengembalikan 403, yang digunakan untuk penolakan otorisasi daripada kredensial yang kedaluwarsa. Biasanya identitas yang Anda autentikasi dengan hilang izin IAM, atau model tidak diaktifkan untuk proyek Anda.1648[Agent Platform milik Google Cloud](/docs/id/google-vertex-ai) mengembalikan 403, yang digunakannya untuk penolakan otorisasi, bukan untuk kredensial yang kedaluwarsa. Biasanya identitas yang Anda gunakan untuk autentikasi tidak memiliki izin IAM, atau model tidak diaktifkan untuk proyek Anda.
1642 1649
1643Petunjuk tindakan di tengah bervariasi dengan pengaturan Anda. Bagian yang stabil adalah `Google Cloud authentication failed` terkemuka:1650Petunjuk tindakan di bagian tengah bervariasi sesuai penyiapan Anda. Bagian yang tetap adalah `Google Cloud authentication failed` di awal:
1644 1651
1645```text theme={null}1652```text theme={null}
1646Google Cloud authentication failed · refresh your Google Cloud credentials (application default sign-in, or the key file in GOOGLE_APPLICATION_CREDENTIALS) and retry · if credentials are current, check GCP IAM permissions and Vertex AI model access · API Error: 403 ...1653Google Cloud authentication failed · refresh your Google Cloud credentials (application default sign-in, or the key file in GOOGLE_APPLICATION_CREDENTIALS) and retry · if credentials are current, check GCP IAM permissions and Vertex AI model access · API Error: 403 ...
1648 1655
1649**Yang harus dilakukan:**1656**Yang harus dilakukan:**
1650 1657
1651* Jika petunjuk mengatakan kredensial dikelola oleh lingkungan ini, aplikasi yang meluncurkan Claude Code memiliki kredensial dan langkah lain di sini tidak berlaku: coba ulang, atau hubungi administrator Anda1658* Jika petunjuk menyebutkan bahwa kredensial dikelola oleh lingkungan ini, aplikasi yang meluncurkan Claude Code memiliki kredensial tersebut dan langkah-langkah lain di sini tidak berlaku: coba lagi, atau hubungi administrator Anda
1652* Konfirmkan peran dalam [Konfigurasi IAM](/docs/id/google-vertex-ai#iam-configuration) diberikan kepada identitas yang Anda autentikasi dengan1659* Pastikan peran di [Konfigurasi IAM](/docs/id/google-vertex-ai#iam-configuration) diberikan kepada identitas yang Anda gunakan untuk autentikasi
1653* Konfirmkan model diaktifkan untuk proyek Anda. Lihat [Minta akses model](/docs/id/google-vertex-ai#2-request-model-access)1660* Pastikan model diaktifkan untuk proyek Anda. Lihat [Meminta akses model](/docs/id/google-vertex-ai#2-request-model-access)
1654 1661
1655Sebelum v2.1.273, 403 dari Platform Agen menampilkan pesan `Please run /login` atau `Failed to authenticate` generik sebagai gantinya, yang tidak dapat menyegarkan kredensial Google Cloud.1662Sebelum v2.1.273, 403 dari Agent Platform menampilkan pesan generik `Please run /login` atau `Failed to authenticate`, yang tidak dapat memperbarui kredensial Google Cloud.
1656 1663
1657<h3 id="microsoft-foundry-authentication-failed">1664<h3 id="microsoft-foundry-authentication-failed">
1658 Autentikasi Microsoft Foundry gagal1665 Autentikasi Microsoft Foundry gagal
1659</h3>1666</h3>
1660 1667
1661[Microsoft Foundry](/docs/id/microsoft-foundry) mengembalikan 401 atau 403: kredensial Azure pada permintaan ditolak, atau identitas di baliknya tidak memiliki akses ke sumber daya Foundry. `/login` tidak dapat mencetak kredensial Azure. Petunjuk tindakan di tengah bervariasi dengan pengaturan Anda. Bagian yang stabil adalah `Microsoft Foundry authentication failed` terkemuka:1668[Microsoft Foundry](/docs/id/microsoft-foundry) mengembalikan 401 atau 403: kredensial Azure pada permintaan ditolak, atau identitas di baliknya tidak memiliki akses ke sumber daya Foundry. `/login` tidak dapat membuat kredensial Azure. Petunjuk tindakan di bagian tengah bervariasi sesuai pengaturan Anda. Bagian yang tetap adalah awalan `Microsoft Foundry authentication failed`:
1662 1669
1663```text theme={null}1670```text theme={null}
1664Microsoft Foundry authentication failed · refresh your Foundry credential (ANTHROPIC_FOUNDRY_AUTH_TOKEN, ANTHROPIC_FOUNDRY_API_KEY, Azure sign-in for Entra, or your proxy token) and retry · if credentials are current, check access to the Foundry resource · API Error: 401 ...1671Microsoft Foundry authentication failed · refresh your Foundry credential (ANTHROPIC_FOUNDRY_AUTH_TOKEN, ANTHROPIC_FOUNDRY_API_KEY, Azure sign-in for Entra, or your proxy token) and retry · if credentials are current, check access to the Foundry resource · API Error: 401 ...
1666 1673
1667**Yang harus dilakukan:**1674**Yang harus dilakukan:**
1668 1675
1669* Jika petunjuk mengatakan kredensial dikelola oleh lingkungan ini, aplikasi yang meluncurkan Claude Code memiliki kredensial dan langkah lain di sini tidak berlaku: coba ulang, atau hubungi administrator Anda1676* Jika petunjuk menyatakan bahwa kredensial dikelola oleh lingkungan ini, aplikasi yang meluncurkan Claude Code memiliki kredensial tersebut dan langkah-langkah lain di sini tidak berlaku: coba lagi, atau hubungi administrator Anda
1670* Segarkan kredensial yang Anda konfigurasikan dalam [Konfigurasi kredensial Azure](/docs/id/microsoft-foundry#2-configure-azure-credentials): putar `ANTHROPIC_FOUNDRY_API_KEY`, cetak `ANTHROPIC_FOUNDRY_AUTH_TOKEN` baru, atau jalankan `az login` sehingga rantai kredensial Microsoft Entra default dapat masuk lagi1677* Perbarui kredensial yang Anda konfigurasikan di [Konfigurasikan kredensial Azure](/docs/id/microsoft-foundry#2-configure-azure-credentials): rotasi `ANTHROPIC_FOUNDRY_API_KEY`, buat `ANTHROPIC_FOUNDRY_AUTH_TOKEN` yang baru, atau jalankan `az login` agar rantai kredensial Microsoft Entra default dapat masuk kembali
1671* Jika kredensial saat ini, konfirmkan identitas memiliki akses ke sumber daya Foundry. Lihat [Konfigurasi Azure RBAC](/docs/id/microsoft-foundry#azure-rbac-configuration)1678* Jika kredensial masih berlaku, pastikan identitas tersebut memiliki akses ke sumber daya Foundry. Lihat [Konfigurasi Azure RBAC](/docs/id/microsoft-foundry#azure-rbac-configuration)
1672 1679
1673Sebelum v2.1.273, 401 atau 403 dari Microsoft Foundry menampilkan pesan `Please run /login` atau `Failed to authenticate` generik sebagai gantinya, yang tidak dapat menyegarkan kredensial Azure.1680Sebelum v2.1.273, 401 atau 403 dari Microsoft Foundry menampilkan pesan generik `Please run /login` atau `Failed to authenticate`, yang tidak dapat memperbarui kredensial Azure.
1674 1681
1675<h3 id="could-not-load-aws-or-google-cloud-credentials">1682<h3 id="could-not-load-aws-or-google-cloud-credentials">
1676 Tidak dapat memuat kredensial AWS atau Google Cloud1683 Tidak dapat memuat kredensial AWS atau Google Cloud
1677</h3>1684</h3>
1678 1685
1679Claude Code tidak dapat memperoleh kredensial yang dapat digunakan dari rantai penyedia kredensial AWS atau dari kredensial default aplikasi Google Anda di mesin tempat itu berjalan, jadi tidak ada permintaan yang mencapai penyedia cloud Anda. Claude Code menghapus kredensial yang disimpan dalam cache dan mencoba ulang dua kali sebelum menampilkan pesan ini. Detail setelah `·` menamai penyebab spesifik, seperti sesi SSO yang kedaluwarsa, kredensial default aplikasi yang hilang dilaporkan sebagai `Could not load the default credentials`, atau masuk yang dicabut dilaporkan sebagai `invalid_grant`:1686Claude Code tidak dapat memperoleh kredensial yang dapat digunakan dari rantai penyedia kredensial AWS atau dari kredensial default aplikasi Google Anda di mesin tempat Claude Code berjalan, sehingga tidak ada permintaan yang mencapai penyedia cloud Anda. Claude Code menghapus kredensial yang di-cache dan mencoba ulang dua kali sebelum menampilkan pesan ini. Detail setelah `·` menyebutkan penyebab spesifiknya, seperti sesi SSO yang kedaluwarsa, kredensial default aplikasi yang tidak ada yang dilaporkan sebagai `Could not load the default credentials`, atau proses masuk yang dicabut yang dilaporkan sebagai `invalid_grant`:
1680 1687
1681```text theme={null}1688```text theme={null}
1682API Error: Could not load AWS credentials · Could not load credentials from any providers. Check or refresh your AWS credentials and try again.1689API Error: Could not load AWS credentials · Could not load credentials from any providers. Check or refresh your AWS credentials and try again.
1683API Error: Could not load Google Cloud credentials · invalid_grant. Check or refresh your Google Cloud credentials and try again.1690API Error: Could not load Google Cloud credentials · invalid_grant. Check or refresh your Google Cloud credentials and try again.
1684```1691```
1685 1692
1686Dalam [mode non-interaktif](/docs/id/headless) dengan `-p` dan dalam [Agent SDK](/docs/id/agent-sdk/overview), kode kesalahan terstruktur adalah `cloud_credential_error`. Sebelum v2.1.267, pesan hanya menampilkan teks detail setelah `API Error:`, dan kode terstruktur adalah `server_error` atau `unknown`.1693Dalam [mode non-interaktif](/docs/id/headless) dengan `-p` dan di [Agent SDK](/docs/id/agent-sdk/overview), kode kesalahan terstrukturnya adalah `cloud_credential_error`. Sebelum v2.1.267, pesan hanya menampilkan teks detail setelah `API Error:`, dan kode terstrukturnya adalah `server_error` atau `unknown`.
1687 1694
1688**Yang harus dilakukan:**1695**Yang harus dilakukan:**
1689 1696
1690* Jalankan perintah masuk penyedia Anda, seperti `aws sso login --profile myprofile` atau `gcloud auth application-default login`, kemudian coba ulang. [Kredensial Bedrock, Platform Agen, atau Foundry tidak memuat](/docs/id/troubleshoot-install#bedrock-agent-platform-or-foundry-credentials-not-loading) menunjukkan cara mengonfirmasi kredensial di luar Claude Code1697* Jalankan perintah masuk penyedia Anda, seperti `aws sso login --profile myprofile` atau `gcloud auth application-default login`, lalu coba lagi. [Kredensial Bedrock, Agent Platform, atau Foundry tidak termuat](/docs/id/troubleshoot-install#bedrock-agent-platform-or-foundry-credentials-not-loading) menunjukkan cara memverifikasi kredensial di luar Claude Code
1691* Jika detail membaca `AWS default-chain credential resolve timed out`, rantai tergantung daripada gagal, jadi ikuti [Resolusi kredensial rantai default AWS habis waktu](#aws-default-chain-credential-resolve-timed-out) sebagai gantinya1698* Jika detailnya berbunyi `AWS default-chain credential resolve timed out`, rantai tersebut macet alih-alih gagal, jadi ikuti [Resolusi kredensial rantai default AWS mengalami timeout](#aws-default-chain-credential-resolve-timed-out) sebagai gantinya
1692 1699
1693<h3 id="aws-default-chain-credential-resolve-timed-out">1700<h3 id="aws-default-chain-credential-resolve-timed-out">
1694 Resolusi kredensial rantai default AWS habis waktu1701 Resolusi kredensial rantai default AWS mengalami timeout
1695</h3>1702</h3>
1696 1703
1697Rantai penyedia kredensial default AWS tidak menghasilkan kredensial dalam 60 detik, jadi Claude Code menghentikan resolusi dan gagal permintaan. Timeout ini adalah satu penyebab [Tidak dapat memuat kredensial AWS atau Google Cloud](#could-not-load-aws-or-google-cloud-credentials). Kegagalan adalah resolusi kredensial lokal: permintaan tidak pernah mencapai [Amazon Bedrock](/docs/id/amazon-bedrock), [Claude Platform di AWS](/docs/id/claude-platform-on-aws), atau [titik akhir Mantle](/docs/id/amazon-bedrock#use-the-mantle-endpoint). Claude Code menghapus [cache kredensial](/docs/id/amazon-bedrock#credential-caching-and-resolution-timeout) dan mencoba ulang sebelum kesalahan ini muncul, jadi pada saat Anda melihatnya rantai telah macet pada upaya berulang.1704Rantai penyedia kredensial default AWS tidak menghasilkan kredensial dalam 60 detik, sehingga Claude Code menghentikan resolusi dan menggagalkan permintaan. Timeout ini adalah salah satu penyebab [Tidak dapat memuat kredensial AWS atau Google Cloud](#could-not-load-aws-or-google-cloud-credentials). Kegagalan ini terjadi pada resolusi kredensial lokal: permintaan tidak pernah mencapai [Amazon Bedrock](/docs/id/amazon-bedrock), [Claude Platform on AWS](/docs/id/claude-platform-on-aws), atau [endpoint Mantle](/docs/id/amazon-bedrock#use-the-mantle-endpoint). Claude Code menghapus [cache kredensial](/docs/id/amazon-bedrock#credential-caching-and-resolution-timeout) dan mencoba ulang sebelum kesalahan ini muncul, sehingga saat Anda melihatnya, rantai tersebut telah macet pada beberapa percobaan berulang.
1698 1705
1699```text theme={null}1706```text theme={null}
1700API Error: Could not load AWS credentials · AWS default-chain credential resolve timed out. Check or refresh your AWS credentials and try again.1707API Error: Could not load AWS credentials · AWS default-chain credential resolve timed out. Check or refresh your AWS credentials and try again.
1701```1708```
1702 1709
1703Penyebab umum adalah perintah `credential_process` dalam profil AWS Anda yang menunggu input yang tidak dapat diterima, dan kontainer atau VM yang instance metadata service (IMDS)-nya tidak pernah menjawab probe rantai.1710Penyebab umumnya adalah perintah `credential_process` di profil AWS Anda yang menunggu input yang tidak dapat diterimanya, serta container atau VM yang layanan metadata instance-nya (IMDS) tidak pernah menjawab probe dari rantai tersebut.
1704 1711
1705Sebelum v2.1.267, pesan berbunyi `API Error: AWS default-chain credential resolve timed out`.1712Sebelum v2.1.267, pesannya berbunyi `API Error: AWS default-chain credential resolve timed out`.
1706Sebelum v2.1.207, rantai yang macet meninggalkan permintaan menunggu tanpa batas waktu daripada gagal.1713Sebelum v2.1.207, rantai yang macet membuat permintaan menunggu tanpa batas alih-alih gagal.
1707 1714
1708**Yang harus dilakukan:**1715**Yang harus dilakukan:**
1709 1716
1710* Jalankan `aws sts get-caller-identity` di shell yang sama dengan `AWS_PROFILE` yang sama. Jika juga tergantung, perbaiki profil; perintah `credential_process` yang meminta secara interaktif adalah penyebab umum.1717* Jalankan `aws sts get-caller-identity` di shell yang sama dengan `AWS_PROFILE` yang sama. Jika perintah itu juga macet, perbaiki profilnya; perintah `credential_process` yang meminta input secara interaktif adalah penyebab umum.
1711* Selesaikan langkah masuk sebelum memulai Claude Code, misalnya `aws sso login --profile myprofile`, sehingga rantai diselesaikan dari cache SSO lokal daripada menunggu alur browser1718* Selesaikan langkah masuk sebelum memulai Claude Code, misalnya `aws sso login --profile myprofile`
1712* Jika rantai Anda menjalankan masuk interaktif yang secara sah memerlukan lebih dari 60 detik, seperti SSO dengan MFA melalui pembungkus seperti `aws-vault`, naikkan batas dalam milidetik dengan [`CLAUDE_CODE_AWS_CHAIN_RESOLVE_TIMEOUT_MS`](/docs/id/env-vars)1719* Jika rantai Anda menjalankan proses masuk interaktif yang memang membutuhkan lebih dari 60 detik, seperti SSO dengan MFA melalui wrapper seperti `aws-vault`, naikkan batasnya dalam milidetik dengan [`CLAUDE_CODE_AWS_CHAIN_RESOLVE_TIMEOUT_MS`](/docs/id/env-vars)
1713 1720
1714<h3 id="bedrock-setup-verification-timed-out-waiting-for-aws">1721<h3 id="bedrock-setup-verification-timed-out-waiting-for-aws">
1715 Verifikasi pengaturan Bedrock habis waktu menunggu AWS1722 Verifikasi penyiapan Bedrock mengalami timeout saat menunggu AWS
1716</h3>1723</h3>
1717 1724
1718Panggilan ke AWS selama [wizard pengaturan Bedrock](/docs/id/amazon-bedrock#sign-in-with-bedrock), seperti pencarian kredensial atau pemeriksaan identitas, tidak selesai dalam batas 60 detik. Wizard berhenti menunggu dan gagal langkah verifikasi:1725Panggilan ke AWS selama verifikasi kredensial di [wizard penyiapan Bedrock](/docs/id/amazon-bedrock#sign-in-with-bedrock), seperti pencarian kredensial atau pemeriksaan identitas, tidak selesai dalam batas 60 detik. Wizard berhenti menunggu dan menggagalkan langkah verifikasi:
1719 1726
1720```text theme={null}1727```text theme={null}
1721Timed out after 60s waiting for AWS. Check your network and proxy settings; if a credential helper needs longer to prompt you, raise CLAUDE_CODE_AWS_CHAIN_RESOLVE_TIMEOUT_MS.1728Timed out after 60s waiting for AWS. Check your network and proxy settings; if a credential helper needs longer to prompt you, raise CLAUDE_CODE_AWS_CHAIN_RESOLVE_TIMEOUT_MS.
1722```1729```
1723 1730
1724Angka mencerminkan batas Anda: 60 detik secara default, atau nilai yang Anda atur dalam [`CLAUDE_CODE_AWS_CHAIN_RESOLVE_TIMEOUT_MS`](/docs/id/env-vars).1731Angka tersebut mencerminkan batas Anda: 60 detik secara default, atau nilai yang Anda tetapkan di [`CLAUDE_CODE_AWS_CHAIN_RESOLVE_TIMEOUT_MS`](/docs/id/env-vars).
1725 1732
1726Penyebab umum adalah jaringan atau proxy yang macet permintaan ke AWS, termasuk penyegaran token SSO, dan helper kredensial masih menunggu input yang tidak dapat Anda lihat. Naikkan batas hanya ketika helper secara sah memerlukan lebih banyak waktu.1733Penyebab umumnya adalah jaringan atau proxy yang menahan permintaan ke AWS, termasuk pembaruan token SSO, serta credential helper yang masih menunggu input yang tidak dapat Anda lihat. Naikkan batas hanya jika helper tersebut memang membutuhkan waktu lebih lama.
1727 1734
1728Permintaan tunggal yang macet ke AWS juga dapat gagal pada timeout per-permintaan-nya sendiri, yang menampilkan pesan yang lebih pendek pada langkah yang sama:1735Satu permintaan ke AWS yang macet juga dapat gagal karena timeout per permintaannya sendiri, yang menampilkan pesan lebih singkat pada langkah yang sama:
1729 1736
1730```text theme={null}1737```text theme={null}
1731A request to AWS timed out. Check your network and proxy settings, then try again.1738A request to AWS timed out. Check your network and proxy settings, then try again.
1732```1739```
1733 1740
1734Ketika timeout yang sama terjadi pada langkah pin model, wizard menandai model sebagai `unreachable` daripada menampilkan pesan apa pun.1741Ketika timeout yang sama terjadi pada langkah penyematan model, wizard menandai model sebagai `unreachable` alih-alih menampilkan salah satu pesan tersebut.
1735 1742
1736**Yang harus dilakukan:**1743**Yang harus dilakukan:**
1737 1744
1738* Jalankan `aws sts get-caller-identity` di shell yang sama. Jika juga tergantung, macet ada di luar Claude Code, di jaringan Anda, proxy Anda, atau helper kredensial dalam profil AWS Anda; perbaiki itu terlebih dahulu.1745* Jalankan `aws sts get-caller-identity` di shell yang sama. Jika perintah itu juga macet, kemacetan berada di luar Claude Code, yaitu di jaringan Anda, proxy Anda, atau credential helper di profil AWS Anda; perbaiki itu terlebih dahulu.
1739* Selesaikan masuk interaktif apa pun sebelum membuka wizard, misalnya `aws sso login --profile myprofile`1746* Selesaikan proses masuk interaktif apa pun sebelum membuka wizard, misalnya `aws sso login --profile myprofile`
1740* Jika helper kredensial dalam profil AWS Anda secara sah memerlukan lebih lama dari 60 detik untuk meminta Anda, naikkan batas dalam milidetik dengan [`CLAUDE_CODE_AWS_CHAIN_RESOLVE_TIMEOUT_MS`](/docs/id/env-vars)1747* Jika credential helper di profil AWS Anda memang membutuhkan lebih dari 60 detik untuk meminta input Anda, naikkan batasnya dalam milidetik dengan [`CLAUDE_CODE_AWS_CHAIN_RESOLVE_TIMEOUT_MS`](/docs/id/env-vars)
1741 1748
1742<h3 id="cloud-gateway-session-expired">1749<h3 id="cloud-gateway-session-expired">
1743 Sesi gateway cloud kedaluwarsa1750 Sesi cloud gateway kedaluwarsa
1744</h3>1751</h3>
1745 1752
1746Anda masuk melalui [gateway aplikasi Claude](/docs/id/claude-apps-gateway), dan sesi gateway yang disimpan di mesin ini kedaluwarsa dan tidak dapat diperbarui, atau gateway tidak lagi menerimanya, misalnya setelah [rahasia JWT gateway diganti](/docs/id/claude-apps-gateway-deploy#jwt-secret-rotation). Jika Anda melihat baris ini ketika memulai `claude` secara interaktif, sesi telah dibuka tanpa masuk ke gateway:1753Anda masuk melalui [Claude apps gateway](/docs/id/claude-apps-gateway), dan sesi gateway yang tersimpan di mesin ini telah kedaluwarsa dan tidak dapat diperbarui, atau gateway tidak lagi menerimanya, misalnya setelah [JWT secret gateway diganti](/docs/id/claude-apps-gateway-deploy#jwt-secret-rotation). Jika Anda melihat baris ini saat memulai `claude` secara interaktif, sesi telah dibuka dalam keadaan keluar dari gateway:
1747 1754
1748```text theme={null}1755```text theme={null}
1749Cloud gateway session expired — run /login to reconnect.1756Cloud gateway session expired — run /login to reconnect.
1750```1757```
1751 1758
1752Baris yang sama dapat muncul di tengah sesi ketika kredensial gateway kedaluwarsa dan Claude Code tidak dapat memperbarui.1759Baris yang sama dapat muncul di tengah sesi ketika kredensial gateway kedaluwarsa dan Claude Code tidak dapat memperbaruinya.
1753 1760
1754Dalam jalankan [non-interaktif](/docs/id/headless), sesi latar belakang atau sesi lain yang tidak diawasi, atau subperintah `claude` selain `claude auth`, Claude Code keluar dengan pesan ini sebagai gantinya ketika gateway tidak lagi menerima sesi:1761Dalam eksekusi [non-interaktif](/docs/id/headless), sesi latar belakang atau sesi tanpa pengawasan lainnya, atau subperintah `claude` selain `claude auth`, Claude Code keluar dengan pesan ini sebagai gantinya ketika gateway tidak lagi menerima sesi tersebut:
1755 1762
1756```text theme={null}1763```text theme={null}
1757Cloud gateway <url> no longer accepts this session. Start `claude` and sign in again with /login.1764Cloud gateway <url> no longer accepts this session. Start `claude` and sign in again with /login.
1759 1766
1760**Yang harus dilakukan:**1767**Yang harus dilakukan:**
1761 1768
1762* Jalankan `/login` dalam sesi dan selesaikan masuk browser1769* Jalankan `/login` di sesi tersebut dan selesaikan proses masuk melalui browser
1763* Untuk peluncuran non-interaktif, mulai `claude` di lingkungan yang sama, jalankan `/login`, kemudian jalankan kembali perintah Anda1770* Untuk peluncuran non-interaktif, mulai `claude` di lingkungan yang sama, jalankan `/login`, lalu jalankan ulang perintah Anda
1764 1771
1765<h3 id="sign-in-timed-out-while-waiting-for-you-to-continue">1772<h3 id="sign-in-timed-out-while-waiting-for-you-to-continue">
1766 Masuk habis waktu saat menunggu Anda untuk melanjutkan1773 Proses masuk mengalami timeout saat menunggu Anda melanjutkan
1767</h3>1774</h3>
1768 1775
1769Selama masuk [gateway aplikasi Claude](/docs/id/claude-apps-gateway), gateway menamai akun yang masuk, dan Claude Code meminta Anda untuk mengonfirmasinya sebelum menyimpan kredensial. Anda meninggalkan konfirmasi terbuka melampaui kedaluwarsa masuk itu sendiri, dan gateway tidak mengeluarkan token penyegaran yang dapat memperbarui, jadi Claude Code tidak menyimpan apa pun ketika Anda melanjutkan:1776Selama proses masuk [Claude apps gateway](/docs/id/claude-apps-gateway), gateway menyebutkan akun yang masuk, dan Claude Code meminta Anda mengonfirmasinya sebelum menyimpan kredensial. Anda membiarkan konfirmasi terbuka melewati masa berlaku proses masuk itu sendiri, dan gateway tidak menerbitkan refresh token yang dapat memperbaruinya, sehingga Claude Code tidak menyimpan apa pun saat Anda melanjutkan:
1770 1777
1771```text theme={null}1778```text theme={null}
1772Sign-in timed out while waiting for you to continue. Try again.1779Sign-in timed out while waiting for you to continue. Try again.
1774 1781
1775**Yang harus dilakukan:**1782**Yang harus dilakukan:**
1776 1783
1777* Jalankan `/login` lagi dan konfirmkan akun sebelum masuk kedaluwarsa1784* Jalankan `/login` lagi dan konfirmasikan akun sebelum proses masuk kedaluwarsa
1778 1785
1779<h3 id="gateway-refused-the-request">1786<h3 id="gateway-refused-the-request">
1780 Gateway menolak permintaan1787 Gateway menolak permintaan
1781</h3>1788</h3>
1782 1789
1783Anda masuk melalui [gateway aplikasi Claude](/docs/id/claude-apps-gateway), dan permintaan mengembalikan 403: gateway, atau upstream di baliknya, menolaknya. Masuk lagi tidak mengubah penolakan, jadi pesan menunjuk ke administrator gateway Anda:1790Anda masuk melalui [Claude apps gateway](/docs/id/claude-apps-gateway), dan sebuah permintaan mengembalikan 403: gateway, atau upstream di belakangnya, menolaknya. Masuk kembali tidak mengubah penolakan, sehingga pesan tersebut mengarahkan Anda ke administrator gateway Anda:
1784 1791
1785```text theme={null}1792```text theme={null}
1786Gateway refused the request · signing in again won't change this — check with your gateway administrator · API Error: 403 ...1793Gateway refused the request · signing in again won't change this — check with your gateway administrator · API Error: 403 ...
1788 1795
1789**Yang harus dilakukan:**1796**Yang harus dilakukan:**
1790 1797
1791* Minta administrator gateway Anda untuk mencari permintaan. Ekor `API Error:` membawa penolakan yang dikembalikan gateway1798* Minta administrator gateway Anda untuk menelusuri permintaan tersebut. Bagian akhir `API Error:` memuat penolakan yang dikembalikan gateway
1792* Untuk administrator: aturan [kontrol akses](/docs/id/claude-apps-gateway-config#http-tuning) pada gateway mengembalikan 403 yang dicatat [log audit](/docs/id/claude-apps-gateway-deploy#logs) dengan alasannya, dan penolakan otorisasi upstream melewati per [Pesan kesalahan Upstream](/docs/id/claude-apps-gateway-config#upstream-error-messages)1799* Untuk administrator: [aturan kontrol akses](/docs/id/claude-apps-gateway-config#http-tuning) pada gateway mengembalikan 403 yang dicatat oleh [log audit](/docs/id/claude-apps-gateway-deploy#logs) beserta alasannya, dan penolakan otorisasi dari upstream diteruskan sesuai [Pesan kesalahan upstream](/docs/id/claude-apps-gateway-config#upstream-error-messages)
1793 1800
1794Sebelum v2.1.273, 403 pada sesi gateway menampilkan pesan `Please run /login` atau `Failed to authenticate` generik sebagai gantinya, dan masuk lagi tidak menghapus penolakan.1801Sebelum v2.1.273, 403 pada sesi gateway menampilkan pesan generik `Please run /login` atau `Failed to authenticate`, dan masuk kembali tidak menghilangkan penolakan tersebut.
1795 1802
1796<h2 id="network-and-connection-errors">1803<h2 id="network-and-connection-errors">
1797 Kesalahan jaringan dan koneksi1804 Kesalahan jaringan dan koneksi
2849* Jalankan `claude doctor` dari shell Anda untuk diagnostik instalasi2856* Jalankan `claude doctor` dari shell Anda untuk diagnostik instalasi
2850 2857
2851<h2 id="command-line-errors">2858<h2 id="command-line-errors">
2852 Kesalahan command-line2859 Error baris perintah
2853</h2>2860</h2>
2854 2861
2855Kesalahan ini berasal dari command line `claude` dan subcommand-nya, dari nama command yang Anda kirimkan di prompt, dan dari command seperti `/security-review` yang mengumpulkan konteks dengan menjalankan shell command sebelum prompt mereka berjalan. Mereka juga berasal dari `/tui`, yang meluncurkan kembali CLI.2862Error ini berasal dari baris perintah `claude` dan subperintahnya, dari nama perintah yang Anda kirimkan di prompt, dan dari perintah seperti `/security-review` yang mengumpulkan konteks dengan menjalankan perintah shell sebelum prompt-nya berjalan. Error ini juga berasal dari `/tui`, yang meluncurkan ulang CLI.
2856 2863
2857<h3 id="conflict-between-bg-and-print">2864<h3 id="conflict-between-bg-and-print">
2858 Konflik antara `--bg` dan `--print`2865 Konflik antara `--bg` dan `--print`
2859</h3>2866</h3>
2860 2867
2861Pesan ini memerlukan Claude Code v2.1.198 atau lebih baru. Anda menggabungkan `--bg` dengan `-p` atau `--print` dalam invokasi `claude` yang sama. `--bg` memulai [sesi background](/docs/id/agent-view#from-your-shell) yang kemudian Anda lampirkan dengan `claude agents`, sementara `--print` berjalan [non-interaktif](/docs/id/headless) dan tidak pernah memulai sesi interaktif yang `claude agents` lampirkan. Sebelum v2.1.198, kombinasi ini secara diam-diam membuat pekerjaan background yang tidak pernah bisa dilampirkan.2868Pesan ini memerlukan Claude Code v2.1.198 atau yang lebih baru. Anda menggabungkan `--bg` dengan `-p` atau `--print` dalam pemanggilan `claude` yang sama. `--bg` memulai [sesi latar belakang](/docs/id/agent-view#from-your-shell) yang nantinya Anda sambungkan dengan `claude agents`, sedangkan `--print` berjalan secara [non-interaktif](/docs/id/headless) dan tidak pernah memulai sesi interaktif yang disambungkan oleh `claude agents`. Sebelum v2.1.198, kombinasi ini secara diam-diam membuat pekerjaan latar belakang yang tidak pernah dapat disambungkan.
2869
2870```text theme={null}
2871--bg and --print conflict: --print never starts the interactive session that `claude agents` attaches to, so the job would be unattachable. The prompt is the positional — drop --print: `claude --bg '<task>'`.
2872```
2873
2874**Yang harus dilakukan:**
2875
2876* Hapus `-p` atau `--print`. `--bg` menerima prompt sebagai argumen posisionalnya, sehingga `claude --bg "<task>"` adalah perintah yang lengkap. Lihat [Mengirim agent baru dari shell Anda](/docs/id/agent-view#from-your-shell).
2877* Untuk menjalankan prompt secara non-interaktif dan mencetak hasilnya alih-alih membuat sesi latar belakang, hapus `--bg` dan jalankan `claude -p "<task>"`
2878
2879<h3 id="conflict-between-a-system-prompt-flag-and-its-file-form">
2880 Konflik antara flag system prompt dan bentuk file-nya
2881</h3>
2882
2883Anda meneruskan [`--append-subagent-system-prompt`](/docs/id/cli-reference#cli-flags) bersama dengan `--append-subagent-system-prompt-file` dalam satu pemanggilan `claude`, sehingga `claude` keluar dengan kode 1 alih-alih memulai sesi:
2862 2884
2863```text theme={null}2885```text theme={null}
2886Error: Cannot use both --append-subagent-system-prompt and --append-subagent-system-prompt-file. Please use only one.
2864```2887```
2865 2888
2889Sebelum v2.1.283, `claude` keluar dengan cara yang sama ketika Anda meneruskan `--system-prompt` dengan `--system-prompt-file`, atau `--append-system-prompt` dengan `--append-system-prompt-file`, karena pasangan tersebut berkonflik alih-alih [digabungkan](/docs/id/cli-reference#system-prompt-flags). Pada versi tersebut, pesan menyebutkan pasangan yang Anda gabungkan.
2890
2866**Yang harus dilakukan:**2891**Yang harus dilakukan:**
2867 2892
2868* Hilangkan `-p` atau `--print`. `--bg` mengambil prompt sebagai argumen positional-nya, jadi `claude --bg "<task>"` adalah command lengkapnya. Lihat [Dispatch new agents from your shell](/docs/id/agent-view#from-your-shell).2893* Pertahankan satu bentuk flag dan hapus yang lainnya. Untuk menggabungkan file prompt tetap dengan teks per-run, gabungkan teks tersebut ke dalam file sebelum meluncurkan alih-alih meneruskan kedua flag
2869* Untuk menjalankan prompt non-interaktif dan mencetak hasilnya alih-alih membuat sesi background, hilangkan `--bg` dan jalankan `claude -p "<task>"`
2870 2894
2871<h3 id="invalid-agents-configuration">2895<h3 id="invalid-agents-configuration">
2872 Konfigurasi `--agents` tidak valid2896 Konfigurasi `--agents` tidak valid
2873</h3>2897</h3>
2874 2898
2875Nilai yang Anda berikan ke `--agents` tidak valid, jadi `claude` keluar dengan kode 1 alih-alih memulai sesi. Ketika Anda memberikan `--safe-mode` atau mengatur [`CLAUDE_CODE_SAFE_MODE`](/docs/id/env-vars#variables), Claude Code mengabaikan `--agents` sepenuhnya. Dengan `--resume` atau `--continue`, nilai JSON inline tidak diperiksa dan sesi dimulai; nilai yang dibaca dari file diperiksa pada setiap peluncuran. Sebelum v2.1.242, Claude Code memulai sesi bagaimanapun.2899Nilai yang Anda teruskan ke `--agents` tidak valid, sehingga `claude` keluar dengan kode 1 alih-alih memulai sesi. Ketika Anda meneruskan `--safe-mode` atau mengatur [`CLAUDE_CODE_SAFE_MODE`](/docs/id/env-vars#variables), Claude Code mengabaikan `--agents` sepenuhnya. Dengan `--resume` atau `--continue`, nilai JSON inline tidak diperiksa dan sesi dimulai; nilai yang dibaca dari file diperiksa pada setiap peluncuran. Sebelum v2.1.242, Claude Code tetap memulai sesi.
2876 2900
2877```text theme={null}2901```text theme={null}
2878Error: Invalid --agents configuration:2902Error: Invalid --agents configuration:
2879<what failed>2903<what failed>
2880```2904```
2881 2905
2882Apa yang mengikuti baris pertama tergantung pada bagaimana nilai gagal. Claude Code menjalankan pemeriksaan ini secara berurutan dan berhenti di yang pertama gagal. Jika nilai Anda memiliki dua jenis masalah, Anda hanya melihat yang kedua setelah Anda memperbaiki yang pertama:2906Apa yang mengikuti baris pertama bergantung pada bagaimana nilai tersebut gagal. Claude Code menjalankan pemeriksaan ini secara berurutan dan berhenti pada pemeriksaan pertama yang gagal. Jika nilai Anda memiliki dua jenis masalah, Anda baru melihat yang kedua setelah memperbaiki yang pertama:
2883 2907
28841. Ketika nilai dimulai dengan `{` tetapi tidak diuraikan sebagai JSON, atau isi file `--agents` tidak diuraikan, Claude Code mencetak satu baris `invalid JSON:` yang membawa pesan parser JSON sendiri29081. Ketika nilai diawali dengan `{` tetapi tidak dapat di-parse sebagai JSON, atau isi file `--agents` tidak dapat di-parse, Claude Code mencetak satu baris `invalid JSON:` yang memuat pesan dari parser JSON itu sendiri
28852. Ketika diuraikan tetapi definisi agent tidak cocok dengan skema untuk [subagent yang ditentukan CLI](/docs/id/sub-agents#choose-the-subagent-scope), Claude Code mencetak satu baris per masalah29092. Ketika nilai dapat di-parse tetapi definisi agent tidak cocok dengan skema untuk [subagent yang didefinisikan melalui CLI](/docs/id/sub-agents#choose-the-subagent-scope), Claude Code mencetak satu baris per masalah
28863. Ketika nama agent dimulai dengan `-`, Claude Code mencetak `<name>: agent names must not start with '-'`29103. Ketika nama agent diawali dengan `-`, Claude Code mencetak `<name>: agent names must not start with '-'`
2887 2911
2888Ketika ada lebih dari 20 baris masalah, Claude Code mencetak 20 yang pertama dan mengganti sisanya dengan `…and N more`.2912Ketika ada lebih dari 20 baris masalah, Claude Code mencetak 20 baris pertama dan mengganti sisanya dengan `…and N more`.
2889 2913
2890Dengan `--print`, `--agents` juga menerima [path ke file JSON](/docs/id/sub-agents#choose-the-subagent-scope) sebagai pengganti objek inline. Sebelum v2.1.281, `--agents` hanya menerima JSON inline dan memperlakukan path file sebagai JSON tidak valid. Bentuk file memiliki penolakan sendiri, dicetak sebagai pengganti pesan ini, termasuk yang berikut:2914Dengan `--print`, `--agents` juga menerima [path ke file JSON](/docs/id/sub-agents#choose-the-subagent-scope) sebagai pengganti objek inline. Sebelum v2.1.281, `--agents` hanya menerima JSON inline dan memperlakukan path file sebagai JSON yang tidak valid. Bentuk file memiliki penolakannya sendiri, yang dicetak sebagai pengganti pesan ini, termasuk yang berikut:
2891 2915
2892* **`Error: --agents takes a JSON object, or a file path only with --print (-p)`**: Claude Code membaca nilai sebagai path file dalam sesi interaktif. Berikan definisi sebagai JSON inline, atau tambahkan `-p` untuk membacanya dari file.2916* **`Error: --agents takes a JSON object, or a file path only with --print (-p)`**: Claude Code membaca nilai tersebut sebagai path file dalam sesi interaktif. Teruskan definisi sebagai JSON inline, atau tambahkan `-p` untuk membacanya dari file.
2893* **`Error: --agents file not found: <path>`**: tidak ada file yang ada di path tersebut. Nilai yang tidak dimulai dengan `{` dan bukan JSON valid dibaca sebagai path, jadi JSON inline yang shell Anda rusak dapat gagal dengan cara ini juga. Periksa path atau kutipan dan jalankan command lagi.2917* **`Error: --agents file not found: <path>`**: tidak ada file di path tersebut. Nilai yang tidak diawali dengan `{` dan bukan JSON yang valid dibaca sebagai path, sehingga JSON inline yang dirusak oleh shell Anda juga dapat gagal dengan cara ini. Periksa path atau tanda kutipnya dan jalankan perintah lagi.
2894 2918
2895**Yang harus dilakukan:**2919**Yang harus dilakukan:**
2896 2920
2897* Perbaiki setiap masalah yang pesan daftarkan, kemudian jalankan command lagi. Lihat [field yang diambil subagent yang ditentukan CLI](/docs/id/sub-agents#choose-the-subagent-scope).2921* Perbaiki setiap masalah yang dicantumkan dalam pesan, lalu jalankan perintah lagi. Lihat [field yang diterima oleh subagent yang didefinisikan melalui CLI](/docs/id/sub-agents#choose-the-subagent-scope).
2898 2922
2899<h3 id="cloud-sessions-cannot-be-created-from-a-restricted-session">2923<h3 id="cloud-sessions-cannot-be-created-from-a-restricted-session">
2900 Sesi cloud tidak dapat dibuat dari sesi `--restricted`2924 Sesi cloud tidak dapat dibuat dari sesi `--restricted`
2901</h3>2925</h3>
2902 2926
2903Ketika Anda memulai sesi dengan [`--restricted`](/docs/id/cli-reference#cli-flags), Claude Code menolak untuk membuat [sesi cloud](/docs/id/claude-code-on-the-web#from-terminal-to-cloud) darinya, karena sesi baru akan berjalan di luar proses terbatas dan tidak akan memberlakukan mode terbatas. Claude Code menolak di klien, sebelum menghubungi server, jadi tidak ada sesi cloud yang dibuat:2927Ketika Anda memulai sesi dengan [`--restricted`](/docs/id/cli-reference#cli-flags), Claude Code menolak membuat [sesi cloud](/docs/id/claude-code-on-the-web#from-terminal-to-cloud) dari sesi tersebut, karena sesi baru akan berjalan di luar proses yang dibatasi dan tidak akan menerapkan mode terbatas. Claude Code menolak di sisi klien, sebelum menghubungi server, sehingga tidak ada sesi cloud yang dibuat:
2904 2928
2905```text theme={null}2929```text theme={null}
2906Cloud sessions cannot be created from a --restricted session: they would not enforce it.2930Cloud sessions cannot be created from a --restricted session: they would not enforce it.
2909 2932
2910**Yang harus dilakukan:**2933**Yang harus dilakukan:**
2911 2934
2912* Jalankan tugas secara lokal dalam sesi terbatas2935* Jalankan tugas secara lokal di sesi yang dibatasi
2913* Jika Anda mengontrol bagaimana sesi diluncurkan, mulai sesi `claude` baru tanpa `--restricted` dan buat sesi cloud dari sana2936* Jika Anda mengontrol cara sesi diluncurkan, mulai sesi `claude` baru tanpa `--restricted` dan buat sesi cloud dari sana
2914 2937
2915Sebelum v2.1.248, Claude Code tidak memiliki flag `--restricted`; versi sebelumnya menolak flag itu sendiri dengan kesalahan unknown-option.2938Sebelum v2.1.248, Claude Code tidak memiliki flag `--restricted`; versi sebelumnya menolak flag itu sendiri dengan error opsi tidak dikenal.
2916 2939
2917<h3 id="cloud-sessions-are-disabled-by-your-organizations-policy">2940<h3 id="cloud-sessions-are-disabled-by-your-organizations-policy">
2918 Sesi cloud dinonaktifkan oleh kebijakan organisasi Anda2941 Sesi cloud dinonaktifkan oleh kebijakan organisasi Anda
2919</h3>2942</h3>
2920 2943
2921Kebijakan `allow_remote_sessions` organisasi Anda mati, jadi [sesi cloud](/docs/id/claude-code-on-the-web) dan command yang menggunakannya tidak tersedia:2944Kebijakan `allow_remote_sessions` organisasi Anda dinonaktifkan, sehingga [sesi cloud](/docs/id/claude-code-on-the-web) dan perintah yang menggunakannya tidak tersedia:
2922 2945
2923```text theme={null}2946```text theme={null}
2924Cloud sessions are disabled by your organization's policy. Contact your organization admin to enable them.2947Cloud sessions are disabled by your organization's policy. Contact your organization admin to enable them.
2925```2948```
2926 2949
2927Pesan muncul ketika Anda [membuat sesi cloud dari terminal](/docs/id/claude-code-on-the-web#from-terminal-to-cloud) dan ketika Anda mengirimkan command yang memerlukan sesi cloud, seperti `/teleport`, `/remote-env`, atau `/web-setup`. Sebelum v2.1.268, mengirimkan salah satu command tersebut mengembalikan [`Unknown command`](#unknown-command) sebagai gantinya.2950Pesan ini muncul ketika Anda [membuat sesi cloud dari terminal](/docs/id/claude-code-on-the-web#from-terminal-to-cloud) dan ketika Anda mengirimkan perintah yang memerlukan sesi cloud, seperti `/teleport`, `/remote-env`, atau `/web-setup`. Sebelum v2.1.268, mengirimkan salah satu perintah tersebut menghasilkan [`Unknown command`](#unknown-command) sebagai gantinya.
2928 2951
2929Ini adalah kebijakan organisasi sisi server, jadi tidak dapat ditimpa dari pengaturan lokal, variabel lingkungan, atau flag CLI.2952Ini adalah kebijakan organisasi di sisi server, sehingga tidak dapat ditimpa dari pengaturan lokal, environment variable, atau flag CLI.
2930 2953
2931Jika Claude Code belum memuat kebijakan organisasi Anda atau tidak dapat mengambilnya, command tersebut menjawab `Couldn't verify your organization's policy for cloud sessions. Check your network connection, then restart Claude Code and try again.` sebagai gantinya.2954Jika Claude Code belum memuat kebijakan organisasi Anda atau tidak dapat mengambilnya, perintah tersebut menjawab `Couldn't verify your organization's policy for cloud sessions. Check your network connection, then restart Claude Code and try again.` sebagai gantinya.
2932 2955
2933**Yang harus dilakukan:**2956**Yang harus dilakukan:**
2934 2957
2935* Minta [Owner](/docs/id/server-managed-settings#access-control) di organisasi Anda untuk mengaktifkan sesi cloud dalam pengaturan admin Claude Code di [claude.ai/admin-settings/claude-code](https://claude.ai/admin-settings/claude-code)2958* Minta [Owner](/docs/id/server-managed-settings#access-control) di organisasi Anda untuk mengaktifkan sesi cloud di pengaturan admin Claude Code di [claude.ai/admin-settings/claude-code](https://claude.ai/admin-settings/claude-code)
2936* Jika pesan mengatakan tidak dapat memverifikasi kebijakan, periksa koneksi jaringan Anda, kemudian restart Claude Code dan coba lagi2959* Jika pesan menyatakan bahwa kebijakan tidak dapat diverifikasi, periksa koneksi jaringan Anda, lalu mulai ulang Claude Code dan coba lagi
2937 2960
2938<h3 id="the-json-schema-value-is-not-a-valid-json-schema">2961<h3 id="the-json-schema-value-is-not-a-valid-json-schema">
2939 Nilai `--json-schema` bukan JSON Schema yang valid2962 Nilai `--json-schema` bukan JSON Schema yang valid
2940</h3>2963</h3>
2941 2964
2942Skema yang Anda berikan ke [`--json-schema`](/docs/id/cli-reference#cli-flags) dalam [mode non-interaktif](/docs/id/headless#get-structured-output) gagal kompilasi JSON Schema, jadi `claude` keluar dengan kode 1 alih-alih menjalankan prompt. Sebelum v2.1.205, skema tidak valid menghasilkan output tidak terstruktur tanpa kesalahan, dan skema apa pun yang menggunakan keyword `format` diperlakukan sebagai tidak valid.2965Skema yang Anda teruskan ke [`--json-schema`](/docs/id/cli-reference#cli-flags) dalam [mode non-interaktif](/docs/id/headless#get-structured-output) gagal dalam kompilasi JSON Schema, sehingga `claude` keluar dengan kode 1 alih-alih menjalankan prompt. Sebelum v2.1.205, skema yang tidak valid menghasilkan output tidak terstruktur tanpa error, dan skema apa pun yang menggunakan kata kunci `format` diperlakukan sebagai tidak valid.
2943 2966
2944```text theme={null}2967```text theme={null}
2945Error: --json-schema is not a valid JSON Schema: data/type must be equal to one of the allowed values2968Error: --json-schema is not a valid JSON Schema: data/type must be equal to one of the allowed values
2946```2969```
2947 2970
2948Teks setelah titik dua kedua adalah diagnostik validator dan menamai keyword atau lokasi yang gagal. Skema yang menggunakan keyword `format`, seperti `"format": "email"`, valid: Claude Code menerima `format` sebagai anotasi dan tidak memberlakukannya.2971Teks setelah titik dua kedua adalah diagnostik dari validator dan menyebutkan kata kunci atau lokasi yang gagal. Skema yang menggunakan kata kunci `format`, seperti `"format": "email"`, adalah valid: Claude Code menerima `format` sebagai anotasi dan tidak menerapkannya.
2949 2972
2950Claude Code menjalankan dua pemeriksaan sebelum kompilasi skema: menolak nilai yang tidak dapat diuraikan JSON dengan `Error: --json-schema is not valid JSON`, dan JSON valid yang bukan objek dengan `Error: --json-schema must be a JSON object`.2973Claude Code menjalankan dua pemeriksaan sebelum kompilasi skema: Claude Code menolak nilai yang bukan JSON yang dapat di-parse dengan `Error: --json-schema is not valid JSON`, dan JSON valid yang bukan objek dengan `Error: --json-schema must be a JSON object`.
2951 2974
2952**Yang harus dilakukan:**2975**Yang harus dilakukan:**
2953 2976
2954* Perbaiki bagian skema yang diagnostik namakan, kemudian jalankan kembali command2977* Perbaiki bagian skema yang disebutkan oleh diagnostik, lalu jalankan ulang perintah
2955* Lihat [Get structured output](/docs/id/headless#get-structured-output) untuk skema kerja dan command2978* Lihat [Mendapatkan output terstruktur](/docs/id/headless#get-structured-output) untuk skema dan perintah yang berfungsi
2956 2979
2957<h3 id="settings-file-exceeds-the-2mib-limit">2980<h3 id="settings-file-exceeds-the-2mib-limit">
2958 File pengaturan melebihi batas 2MiB2981 File pengaturan melebihi batas 2MiB
2959</h3>2982</h3>
2960 2983
2961File yang Anda berikan ke [`--settings`](/docs/id/cli-reference#cli-flags) lebih besar dari 2 MiB, jadi `claude` keluar dengan kode 1 saat startup alih-alih memuatnya. Sebelum v2.1.214, Claude Code membaca file tanpa pemeriksaan ukuran, dan file multi-gigabyte atau file perangkat seperti `/dev/zero` menumbuhkan memori tanpa batas.2984File yang Anda teruskan ke [`--settings`](/docs/id/cli-reference#cli-flags) lebih besar dari 2 MiB, sehingga `claude` keluar dengan kode 1 saat startup alih-alih memuatnya. Sebelum v2.1.214, Claude Code membaca file tanpa pemeriksaan ukuran, dan file berukuran beberapa gigabyte atau file perangkat seperti `/dev/zero` membuat memori bertambah tanpa batas.
2962 2985
2963```text theme={null}2986```text theme={null}
2964Error: Settings file exceeds the 2MiB limit: /path/to/settings.json2987Error: Settings file exceeds the 2MiB limit: /path/to/settings.json
2965```2988```
2966 2989
2967Claude Code menolak path `--settings` yang bukan file reguler dengan cara yang sama: perangkat, FIFO, atau socket melaporkan `Error: Cannot use settings file (Not a regular file (device, FIFO, or socket))` diikuti oleh path, dan direktori melaporkan alasan `EISDIR`.2990Claude Code menolak path `--settings` yang bukan file biasa dengan cara yang sama: perangkat, FIFO, atau socket melaporkan `Error: Cannot use settings file (Not a regular file (device, FIFO, or socket))` diikuti oleh path-nya, dan direktori melaporkan alasan `EISDIR`.
2968 2991
2969**Yang harus dilakukan:**2992**Yang harus dilakukan:**
2970 2993
2971* Arahkan `--settings` ke file pengaturan JSON reguler di bawah 2 MiB. Lihat [Settings](/docs/id/settings) untuk formatnya.2994* Arahkan `--settings` ke file pengaturan JSON biasa yang berukuran di bawah 2 MiB. Lihat [Pengaturan](/docs/id/settings) untuk formatnya.
2972 2995
2973<h3 id="the-current-directory-no-longer-exists">2996<h3 id="the-current-directory-no-longer-exists">
2974 Direktori saat ini tidak lagi ada2997 Direktori saat ini sudah tidak ada
2975</h3>2998</h3>
2976 2999
2977Anda memulai `claude` dari direktori yang dihapus atau dipindahkan setelah shell Anda memasukkannya, misalnya worktree atau direktori temp yang shell lain hapus. Claude Code tidak dapat membaca direktori kerjanya, jadi keluar dengan kode 1 sebelum memulai sesi, dalam mode interaktif dan [non-interaktif](/docs/id/headless) sama-sama. Sebelum v2.1.239, Claude Code mogok dengan sumber bundle minified dan `ENOENT ... uv_cwd` stack mentah di stderr alih-alih pesan ini.3000Anda memulai `claude` dari direktori yang dihapus atau dipindahkan setelah shell Anda memasukinya, misalnya worktree atau direktori sementara yang dihapus oleh shell lain. Claude Code tidak dapat membaca direktori kerjanya, sehingga keluar dengan kode 1 sebelum memulai sesi, baik dalam mode interaktif maupun [non-interaktif](/docs/id/headless). Sebelum v2.1.239, Claude Code crash dengan sumber bundle yang di-minify dan stack `ENOENT ... uv_cwd` mentah di stderr alih-alih pesan ini.
2978 3001
2979```text theme={null}3002```text theme={null}
2980The current directory no longer exists (it was deleted or moved). Start Claude Code from an existing directory.3003The current directory no longer exists (it was deleted or moved). Start Claude Code from an existing directory.
2983 3006
2984Penyebab dan perbaikannya sama untuk kedua bentuk.3007Penyebab dan perbaikannya sama untuk kedua bentuk.
2985 3008
2986Ketika Claude Code tidak dapat membaca direktori kerja karena alasan berbeda, seperti perubahan izin, pesan menamai kode kesalahan sebagai gantinya: `Can't read the current directory (EACCES). Start Claude Code from a different directory.`3009Ketika Claude Code tidak dapat membaca direktori kerja karena alasan lain, seperti perubahan permission, pesan menyebutkan kode error sebagai gantinya: `Can't read the current directory (EACCES). Start Claude Code from a different directory.`
2987 3010
2988Di macOS, `EPERM` untuk direktori di `~/Desktop`, `~/Documents`, `~/Downloads`, atau iCloud Drive biasanya berarti macOS memblokir aplikasi terminal Anda dari folder tersebut. Command lain yang membaca folder itu gagal dengan cara yang sama: `ls` di sana melaporkan `Operation not permitted`, bahkan dengan `sudo`.3011Di macOS, `EPERM` untuk direktori di `~/Desktop`, `~/Documents`, `~/Downloads`, atau iCloud Drive biasanya berarti macOS memblokir aplikasi terminal Anda dari folder tersebut. Perintah lain yang membaca folder tersebut gagal dengan cara yang sama: `ls` di sana melaporkan `Operation not permitted`, bahkan dengan `sudo`.
2989 3012
2990**Yang harus dilakukan:**3013**Yang harus dilakukan:**
2991 3014
2992* Ubah ke direktori yang ada, seperti direktori home atau project Anda, kemudian jalankan `claude` lagi3015* Pindah ke direktori yang ada, seperti direktori home atau direktori proyek Anda, lalu jalankan `claude` lagi
2993* Jika direktori dibuat kembali di path yang sama, shell Anda masih memegang yang dihapus. Jalankan `cd "$PWD"` atau tinggalkan dan masuki kembali direktori, kemudian jalankan `claude` lagi3016* Jika direktori dibuat ulang di path yang sama, shell Anda masih memegang direktori yang telah dihapus. Jalankan `cd "$PWD"` atau keluar lalu masuk kembali ke direktori tersebut, lalu jalankan `claude` lagi
2994* Untuk `EPERM` di macOS, keluar dari aplikasi terminal Anda dengan Cmd+Q, buka lagi, kembali ke folder itu, dan jalankan `claude`. Jika `ls` di folder itu masih gagal, buka **System Settings > Privacy & Security > Files and Folders**, aktifkan folder untuk aplikasi terminal Anda, kemudian buka kembali terminal3017* Untuk `EPERM` di macOS, tutup aplikasi terminal Anda dengan Cmd+Q, buka kembali, kembali ke folder tersebut, dan jalankan `claude`. Jika `ls` di folder tersebut masih gagal, buka **System Settings > Privacy & Security > Files and Folders**, aktifkan folder tersebut untuk aplikasi terminal Anda, lalu buka kembali terminal
2995 3018
2996<h3 id="temp-directory-refused-or-cannot-be-created">3019<h3 id="temp-directory-refused-or-cannot-be-created">
2997 Direktori temp ditolak atau tidak dapat dibuat3020 Direktori sementara ditolak atau tidak dapat dibuat
2998</h3>3021</h3>
2999 3022
3000Di macOS dan Linux, Claude Code membuat direktori temp pribadi saat startup, `claude-<uid>` di bawah direktori temp sistem atau override [`CLAUDE_CODE_TMPDIR`](/docs/id/env-vars). Ketika direktori tidak dapat dibuat, atau entri yang sudah ada di path itu gagal pemeriksaan keamanan, Claude Code mencetak kegagalan ke stderr dan keluar dengan kode 1 alih-alih memulai sesi:3023Di macOS dan Linux, Claude Code membuat direktori sementara pribadi saat startup, yaitu `claude-<uid>` di bawah direktori sementara sistem atau override [`CLAUDE_CODE_TMPDIR`](/docs/id/env-vars). Ketika direktori tidak dapat dibuat, atau entri yang sudah ada di path tersebut gagal dalam pemeriksaan keamanan, Claude Code mencetak kegagalan tersebut ke stderr dan keluar dengan kode 1 alih-alih memulai sesi:
3001 3024
3002```text wrap theme={null}3025```text wrap theme={null}
3003ENOSPC: no space left on device, mkdir '/tmp/claude-501'3026ENOSPC: no space left on device, mkdir '/tmp/claude-501'
3011 3034
3012**Yang harus dilakukan:**3035**Yang harus dilakukan:**
3013 3036
3014* Untuk `ENOSPC`, bebaskan ruang disk di volume yang menyimpan direktori temp3037* Untuk `ENOSPC`, kosongkan ruang disk pada volume yang menampung direktori sementara
3015* Untuk bentuk `Refusing to use it`, hapus entri bernama itu sendiri, bukan apa yang link tunjuk, dan mulai Claude Code lagi; untuk bentuk `owned by uid`, hanya administrator atau pengguna itu yang dapat menghapusnya3038* Untuk bentuk `Refusing to use it`, hapus entri yang disebutkan itu sendiri, bukan apa yang ditunjuk oleh link, lalu mulai Claude Code lagi; untuk bentuk `owned by uid`, hanya administrator atau pengguna tersebut yang dapat menghapusnya
3016* Untuk `is not readable`, jalankan `chmod 0700` di direktori bernama, atau hapus dan mulai lagi3039* Untuk `is not readable`, jalankan `chmod 0700` pada direktori yang disebutkan, atau hapus direktori tersebut dan mulai lagi
3017* Dalam kasus apa pun, atur [`CLAUDE_CODE_TMPDIR`](/docs/id/env-vars) ke direktori yang Anda kontrol dan mulai Claude Code lagi, meninggalkan path yang ditolak sendirian3040* Dalam kasus mana pun, atur [`CLAUDE_CODE_TMPDIR`](/docs/id/env-vars) ke direktori yang Anda kendalikan dan mulai Claude Code lagi, dengan membiarkan path yang ditolak apa adanya
3018 3041
3019<h3 id="directory-couldnt-be-resolved-to-a-real-location">3042<h3 id="directory-couldnt-be-resolved-to-a-real-location">
3020 Direktori tidak dapat diselesaikan ke lokasi nyata3043 Direktori tidak dapat di-resolve ke lokasi sebenarnya
3021</h3>3044</h3>
3022 3045
3023Anda menjalankan `/add-dir` untuk subdirektori dari direktori kerja Anda, dan Claude Code tidak dapat menyelesaikan direktori ke lokasi nyatanya.3046Anda menjalankan `/add-dir` untuk subdirektori dari direktori kerja Anda, dan Claude Code tidak dapat me-resolve direktori tersebut ke lokasi sebenarnya.
3024 3047
3025Anda sudah memiliki akses file ke subdirektori dari direktori kerja, jadi `/add-dir` hanya memuat skill, command, dan agent-nya. Sebelum memuatnya, Claude Code memeriksa bahwa lokasi nyata direktori, dengan symlink apa pun diselesaikan, berada di dalam direktori kerja. Ketika Claude Code tidak dapat menyelesaikan lokasi itu, tidak memuat apa pun dan menampilkan pesan ini:3048Anda sudah memiliki akses file ke subdirektori dari direktori kerja, sehingga `/add-dir` hanya memuat skill, perintah, dan agent-nya. Sebelum memuatnya, Claude Code memeriksa bahwa lokasi sebenarnya dari direktori tersebut, dengan semua symlink telah di-resolve, berada di dalam direktori kerja. Ketika Claude Code tidak dapat me-resolve lokasi tersebut, Claude Code tidak memuat apa pun dan menampilkan pesan ini:
3026 3049
3027```text theme={null}3050```text theme={null}
3028packages/app couldn't be resolved to a real location, so its skills, commands, and agents weren't loaded. Check that it is a directory inside the working directory and try again.3051packages/app couldn't be resolved to a real location, so its skills, commands, and agents weren't loaded. Check that it is a directory inside the working directory and try again.
3030 3053
3031**Yang harus dilakukan:**3054**Yang harus dilakukan:**
3032 3055
3033* Periksa bahwa path menamai direktori nyata di dalam direktori kerja, kemudian jalankan `/add-dir` lagi3056* Periksa bahwa path tersebut menunjuk ke direktori nyata di dalam direktori kerja, lalu jalankan `/add-dir` lagi
3034* Pesan tidak mengubah akses file Anda; hanya melaporkan bahwa konten `.claude/` direktori tidak dimuat3057* Pesan ini tidak mengubah akses file Anda; pesan ini hanya melaporkan bahwa konten `.claude/` dari direktori tersebut tidak dimuat
3035 3058
3036Sebelum v2.1.261, pesan ini juga muncul untuk setiap `/add-dir <subdirectory>` ketika direktori kerja berada di automount `/net/<host>`, di mana Claude Code menolak untuk menyelesaikan path dengan desain; direktori baik-baik saja dan mencoba lagi tidak bisa membantu.3059Sebelum v2.1.261, pesan ini juga muncul untuk setiap `/add-dir <subdirectory>` ketika direktori kerja berada di automount `/net/<host>`, di mana Claude Code memang dirancang untuk tidak me-resolve path; direktorinya baik-baik saja dan mencoba ulang tidak membantu.
3037 3060
3038<h3 id="workspace-not-trusted-when-starting-remote-control">3061<h3 id="workspace-not-trusted-when-starting-remote-control">
3039 Workspace tidak dipercaya saat memulai Remote Control3062 Workspace tidak dipercaya saat memulai Remote Control
3040</h3>3063</h3>
3041 3064
3042Anda memulai mode server [Remote Control](/docs/id/remote-control) dengan `claude remote-control` atau alias `claude rc` di direktori yang belum Anda percayai, dan command tidak dapat menanyakan apakah akan mempercayainya. Misalnya, input atau output standar command bukan terminal karena salah satunya dialihkan atau dipipa. Command keluar dengan kode 1:3065Anda memulai mode server [Remote Control](/docs/id/remote-control) dengan `claude remote-control` atau alias `claude rc` di direktori yang belum Anda percayai, dan perintah tersebut tidak dapat menanyakan apakah Anda ingin memercayainya. Misalnya, input standar atau output standar perintah bukan terminal karena salah satunya dialihkan atau di-pipe. Perintah keluar dengan kode 1:
3043 3066
3044```text theme={null}3067```text theme={null}
3045Error: Workspace not trusted. Please run `claude` in /Users/you/project first to review and accept the workspace trust dialog.3068Error: Workspace not trusted. Please run `claude` in /Users/you/project first to review and accept the workspace trust dialog.
3046```3069```
3047 3070
3048Dua varian yang juga dimulai dengan `Error: Workspace not trusted.` muncul di terminal juga terlalu kecil untuk menunjukkan apa yang mempercayai direktori aktifkan, atau yang tidak melaporkan ukurannya. Perbesar jendela atau beralih ke jendela terminal normal, kemudian jalankan `claude rc` lagi.3071Dua varian yang juga diawali dengan `Error: Workspace not trusted.` muncul di terminal yang terlalu kecil untuk menampilkan apa yang diaktifkan dengan memercayai direktori tersebut, atau terminal yang tidak melaporkan ukurannya. Perbesar jendela atau beralih ke jendela terminal normal, lalu jalankan `claude rc` lagi.
3049 3072
3050Di direktori home Anda pesan berbeda, karena dialog kepercayaan workspace tidak pernah menyimpan kepercayaan untuk direktori home, jadi menerimanya di sana tidak dapat memenuhi pemeriksaan ini. Sebelum v2.1.214, direktori home menunjukkan pesan di atas, yang sarannya tidak dapat berhasil di sana.3073Di direktori home Anda, pesannya berbeda, karena dialog kepercayaan workspace tidak pernah menyimpan kepercayaan untuk direktori home, sehingga menerimanya di sana tidak dapat memenuhi pemeriksaan ini. Sebelum v2.1.214, direktori home menampilkan pesan di atas, yang sarannya tidak dapat berhasil di sana.
3051 3074
3052```text theme={null}3075```text theme={null}
3053Error: Workspace not trusted. /Users/you is your home directory, and for security home-directory trust is never saved, so running `claude` here first won't help. Run `claude rc` from a project directory instead (run `claude` there once to accept the trust dialog).3076Error: Workspace not trusted. /Users/you is your home directory, and for security home-directory trust is never saved, so running `claude` here first won't help. Run `claude rc` from a project directory instead (run `claude` there once to accept the trust dialog).
3054```3077```
3055 3078
3056Jika Anda menjawab `n` atau tekan Enter di pertanyaan [`Trust <directory>?`](/docs/id/remote-control#requirements), command mencetak pesan `Remote Control did not start` yang menamai direktori dan keluar dengan kode 1. Jalankan `claude rc` lagi untuk menjawab `y`.3079Jika Anda menjawab `n` atau menekan Enter pada [pertanyaan `Trust <directory>?`](/docs/id/remote-control#requirements), perintah mencetak pesan `Remote Control did not start` yang menyebutkan direktori tersebut dan keluar dengan kode 1. Jalankan `claude rc` lagi untuk menjawab `y`.
3057 3080
3058**Yang harus dilakukan:**3081**Yang harus dilakukan:**
3059 3082
3060* Percayai direktori dari terminal terlebih dahulu: jalankan `claude rc` di sana dan jawab `y`, atau jalankan `claude` di sana dan terima [dialog kepercayaan workspace](/docs/id/permissions#project-allow-rules-and-workspace-trust), kemudian jalankan command asli Anda lagi3083* Percayai direktori dari terminal terlebih dahulu: jalankan `claude rc` di sana dan jawab `y`, atau jalankan `claude` di sana dan terima [dialog kepercayaan workspace](/docs/id/permissions#project-allow-rules-and-workspace-trust), lalu jalankan perintah asli Anda lagi
3061* Di direktori home Anda, ubah ke direktori project dan mulai Remote Control di sana3084* Di direktori home Anda, pindah ke direktori proyek dan mulai Remote Control di sana
3062 3085
3063Sebelum v2.1.284, command tidak pernah menanyakan, bahkan di terminal.3086Sebelum v2.1.284, perintah tersebut tidak pernah bertanya, bahkan di terminal.
3064 3087
3065<h3 id="not-carried-over-to-the-sessions-remote-control-starts">3088<h3 id="not-carried-over-to-the-sessions-remote-control-starts">
3066 Tidak dibawa ke sesi yang Remote Control mulai3089 Tidak diteruskan ke sesi yang dimulai Remote Control
3067</h3>3090</h3>
3068 3091
3069Anda memulai [Remote Control](/docs/id/remote-control) dengan flag `claude` global sebelum verb `remote-control`, yang akan membatasi atau mengonfigurasi sesi yang Remote Control mulai, seperti `--settings`, `--setting-sources`, `--permission-mode`, `--disallowed-tools`, atau `--mcp-config`. Flag yang ditempatkan sebelum verb tidak pernah mencapai sesi tersebut. Claude Code menolak untuk memulai sebagai gantinya, menamai flag:3092Anda memulai [Remote Control](/docs/id/remote-control) dengan flag `claude` global sebelum verb `remote-control`, yaitu flag yang akan membatasi atau mengonfigurasi sesi yang dimulai Remote Control, seperti `--settings`, `--setting-sources`, `--permission-mode`, `--disallowed-tools`, atau `--mcp-config`. Flag yang ditempatkan sebelum verb tidak pernah mencapai sesi tersebut. Claude Code menolak untuk memulai, dengan menyebutkan flag tersebut:
3070 3093
3071```text theme={null}3094```text theme={null}
3072Error: `--settings` before `remote-control` is not carried over to the sessions Remote Control starts, so Remote Control refuses to start rather than drop it — remove it, and give Remote Control's own options after the verb (see `claude remote-control --help`).3095Error: `--settings` before `remote-control` is not carried over to the sessions Remote Control starts, so Remote Control refuses to start rather than drop it — remove it, and give Remote Control's own options after the verb (see `claude remote-control --help`).
3073```3096```
3074 3097
3075Claude Code tidak menolak flag global yang tidak berbahaya untuk dijatuhkan, seperti `--verbose`, `--model`, atau wrapper-injected `--session-id` atau `--plugin-dir`: mengabaikannya dan Remote Control dimulai.3098Claude Code tidak menolak flag global yang aman untuk diabaikan, seperti `--verbose`, `--model`, atau `--session-id` maupun `--plugin-dir` yang disisipkan oleh wrapper: Claude Code mengabaikannya dan Remote Control dimulai.
3076 3099
3077Claude Code juga menolak untuk memulai untuk flag global yang belum dikenalinya sebagai tidak berbahaya, jadi flag yang ditambahkan dalam rilis lebih baru dapat muncul dalam pesan ini sampai rilis kemudian menandainya tidak berbahaya.3100Claude Code juga menolak untuk memulai untuk flag global yang belum dikenalinya sebagai aman, sehingga flag yang ditambahkan dalam rilis yang lebih baru dapat muncul dalam pesan ini sampai rilis berikutnya menandainya sebagai aman.
3078 3101
3079**Yang harus dilakukan:**3102**Yang harus dilakukan:**
3080 3103
3081* Hapus flag dari sebelum verb dan berikan [opsi Remote Control sendiri](/docs/id/remote-control#start-a-remote-control-session) setelahnya; `claude remote-control --help` mencantumnya3104* Hapus flag dari posisi sebelum verb dan teruskan [opsi Remote Control sendiri](/docs/id/remote-control#start-a-remote-control-session) setelahnya; `claude remote-control --help` mencantumkan opsi-opsi tersebut
3082* Ketika flag yang ditolak adalah `--permission-mode`, jalankan `claude remote-control --permission-mode <mode>` untuk mengatur mode izin untuk sesi yang Remote Control mulai3105* Ketika flag yang ditolak adalah `--permission-mode`, jalankan `claude remote-control --permission-mode <mode>` untuk mengatur mode izin bagi sesi yang dimulai Remote Control
3083 3106
3084Sebelum v2.1.248, `claude remote-control` tidak menerima flag-nya sendiri ketika flag global datang terlebih dahulu, dan command gagal dengan kesalahan unknown option.3107Sebelum v2.1.248, `claude remote-control` tidak menerima flag-nya sendiri ketika flag global diletakkan lebih dulu, dan perintah gagal dengan error `unknown option`.
3085 3108
3086<h3 id="claude-import-is-not-yet-available-in-this-build">3109<h3 id="claude-import-is-not-yet-available-in-this-build">
3087 claude import belum tersedia dalam build ini3110 claude import belum tersedia dalam build ini
3088</h3>3111</h3>
3089 3112
3090Anda menjalankan [`claude import`](/docs/id/cli-reference#cli-commands), dan Claude Code menemukan alur impor dimatikan, jadi command keluar dengan kode 1 alih-alih memulai impor. Sebelum v2.1.222, build dengan alur impor mati memperlakukan `import` sebagai prompt dan memulai sesi interaktif alih-alih mencetak pesan ini.3113Anda menjalankan [`claude import`](/docs/id/cli-reference#cli-commands), dan Claude Code mendapati alur impor dalam keadaan nonaktif, sehingga perintah keluar dengan kode 1 alih-alih memulai impor. Sebelum v2.1.222, build dengan alur impor nonaktif memperlakukan `import` sebagai prompt dan memulai sesi interaktif alih-alih mencetak pesan ini.
3091 3114
3092```text theme={null}3115```text theme={null}
3093`claude import` is not yet available in this build. Run `claude` and use /mcp or edit ~/.claude/settings.json directly.3116`claude import` is not yet available in this build. Run `claude` and use /mcp or edit ~/.claude/settings.json directly.
3094```3117```
3095 3118
3096Claude Code mengaktifkan `claude import` melalui feature flag yang diambilnya dari Anthropic dan disimpan di disk. Pesan ini berarti nilai yang disimpan mati. Penyebabnya biasanya salah satu dari berikut:3119Claude Code mengaktifkan `claude import` melalui feature flag yang diambilnya dari Anthropic dan disimpan dalam cache di disk. Pesan ini berarti nilai yang tersimpan dalam cache dinonaktifkan. Penyebabnya biasanya salah satu dari berikut ini:
3097 3120
3098* Anda belum memulai sesi sejak instalasi, jadi Claude Code belum mengambil flag. `claude import` pertama dapat mencetak ini bahkan ketika fitur tersedia untuk Anda.3121* Anda belum memulai sesi sejak instalasi, sehingga Claude Code belum mengambil flag tersebut. `claude import` yang pertama dapat mencetak pesan ini meskipun fitur tersebut tersedia untuk Anda.
3099* Anda menggunakan Claude Code melalui Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry, atau Claude Platform di AWS, atau melalui [Claude apps gateway](/docs/id/claude-apps-gateway#availability-and-limitations). Claude Code tidak mengambil feature flag dalam sesi ini, jadi `claude import` tetap tidak tersedia.3122* Anda menggunakan Claude Code melalui Amazon Bedrock, Agent Platform dari Google Cloud, Microsoft Foundry, atau Claude Platform di AWS, atau melalui [Claude apps gateway](/docs/id/claude-apps-gateway#availability-and-limitations). Claude Code tidak mengambil feature flag dalam sesi ini, sehingga `claude import` tetap tidak tersedia.
3100* Anda mengatur `DISABLE_TELEMETRY`, `DO_NOT_TRACK`, `DISABLE_GROWTHBOOK`, atau [`CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC`](/docs/id/env-vars), yang mematikan pengambilan feature flag, jadi `claude import` tetap tidak tersedia.3123* Anda mengatur `DISABLE_TELEMETRY`, `DO_NOT_TRACK`, `DISABLE_GROWTHBOOK`, atau [`CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC`](/docs/id/env-vars), yang menonaktifkan pengambilan feature flag, sehingga `claude import` tetap tidak tersedia.
3101 3124
3102**Yang harus dilakukan:**3125**Yang harus dilakukan:**
3103 3126
3104* Pada instalasi segar, mulai `claude`, tunggu sesi dimuat, keluar, dan jalankan `claude import` lagi3127* Pada instalasi baru, mulai `claude`, tunggu hingga sesi dimuat, keluar, lalu jalankan `claude import` lagi
3105* Di mana pengambilan feature flag tetap mati, atur konfigurasi sendiri: tambahkan server MCP dengan [`claude mcp add`](/docs/id/mcp#installing-mcp-servers), dan buat file [`CLAUDE.md`](/docs/id/memory#how-claude-md-files-load), [skill dan command](/docs/id/skills#where-skills-live), dan [subagent](/docs/id/sub-agents#choose-the-subagent-scope) yang ingin Anda bawa. Pesan juga menamai `~/.claude/settings.json`. Dari konfigurasi yang `claude import` bawa, file itu hanya menyimpan [mode izin](/docs/id/settings-reference#permission-settings); Claude Code tidak membaca server MCP darinya.3128* Jika pengambilan feature flag tetap nonaktif, siapkan konfigurasi sendiri: tambahkan server MCP dengan [`claude mcp add`](/docs/id/mcp#installing-mcp-servers), dan buat [file `CLAUDE.md`](/docs/id/memory#how-claude-md-files-load), [skill dan perintah](/docs/id/skills#where-skills-live), serta [subagent](/docs/id/sub-agents#choose-the-subagent-scope) yang ingin Anda bawa. Pesan tersebut juga menyebutkan `~/.claude/settings.json`. Dari konfigurasi yang dibawa oleh `claude import`, file tersebut hanya menyimpan [mode izin](/docs/id/settings-reference#permission-settings); Claude Code tidak membaca server MCP dari file tersebut.
3106 3129
3107<h3 id="could-not-read-claude-code-config">3130<h3 id="could-not-read-claude-code-config">
3108 Tidak dapat membaca konfigurasi Claude Code3131 Tidak dapat membaca konfigurasi Claude Code
3109</h3>3132</h3>
3110 3133
3111Anda menjalankan [`claude import`](/docs/id/cli-reference#cli-commands) sementara Claude Code tidak dapat menguraikan `~/.claude.json`, file tempat menyimpan login dan status per-project Anda. Subcommand membaca file itu untuk memeriksa ketersediaan tetapi tidak menampilkan dialog pemulihan yang sesi interaktif tampilkan, jadi keluar dengan kode 1. Sebelum v2.1.222, `claude import` dengan file konfigurasi yang tidak dapat dibaca memulai sesi interaktif, yang dialog pemulihannya menangani file.3134Anda menjalankan [`claude import`](/docs/id/cli-reference#cli-commands) ketika Claude Code tidak dapat mem-parse `~/.claude.json`, file tempat Claude Code menyimpan login dan status per proyek Anda. Subperintah tersebut membaca file itu untuk memeriksa ketersediaan tetapi tidak menampilkan dialog pemulihan yang ditampilkan sesi interaktif, sehingga keluar dengan kode 1. Sebelum v2.1.222, `claude import` dengan file konfigurasi yang tidak dapat dibaca memulai sesi interaktif, yang dialog pemulihannya menangani file tersebut.
3112 3135
3113```text theme={null}3136```text theme={null}
3114Could not read Claude Code config — run `claude` with no arguments to recover it.3137Could not read Claude Code config — run `claude` with no arguments to recover it.
3116 3139
3117**Yang harus dilakukan:**3140**Yang harus dilakukan:**
3118 3141
3119* Jalankan `claude` tanpa argumen. Claude Code mendeteksi file tidak valid dan menawarkan untuk mengatur ulangnya. Kemudian jalankan `claude import` lagi.3142* Jalankan `claude` tanpa argumen. Claude Code mendeteksi file yang tidak valid dan menawarkan untuk mengatur ulangnya. Kemudian jalankan `claude import` lagi.
3120* Untuk menyimpan edit manual yang telah Anda buat, perbaiki sintaks JSON di `~/.claude.json` di editor sebagai gantinya, kemudian jalankan kembali `claude import`3143* Untuk mempertahankan pengeditan manual yang telah Anda buat, perbaiki sintaks JSON di `~/.claude.json` dalam editor, lalu jalankan ulang `claude import`
3121 3144
3122<h3 id="could-not-import-a-server-from-claude-desktop">3145<h3 id="could-not-import-a-server-from-claude-desktop">
3123 Tidak dapat mengimpor server dari Claude Desktop3146 Tidak dapat mengimpor server dari Claude Desktop
3124</h3>3147</h3>
3125 3148
3126Claude Code tidak dapat menambahkan salah satu server yang Anda pilih di `claude mcp add-from-claude-desktop`. Command masih mengimpor server yang dipilih lainnya dan mencetak satu baris per server yang tidak dapat ditambahkan. Sebelum v2.1.205, server pertama yang gagal menghentikan impor.3149Claude Code tidak dapat menambahkan salah satu server yang Anda pilih dalam `claude mcp add-from-claude-desktop`. Perintah tersebut tetap mengimpor server lain yang dipilih dan mencetak satu baris per server yang tidak dapat ditambahkan. Sebelum v2.1.205, server pertama yang gagal menghentikan impor.
3127 3150
3128```text theme={null}3151```text theme={null}
3129Could not import my server: Invalid name my server. Names can only contain letters, numbers, hyphens, and underscores.3152Could not import my server: Invalid name my server. Names can only contain letters, numbers, hyphens, and underscores.
3130```3153```
3131 3154
3132Teks setelah nama server adalah alasannya. Yang paling umum adalah pemeriksaan nama: Claude Desktop memungkinkan karakter dalam nama server, seperti spasi dan titik, yang `claude mcp` batasi ke huruf, angka, tanda hubung, dan garis bawah. Alasan lain termasuk konfigurasi server yang gagal validasi dan server yang diblokir oleh [kebijakan MCP](/docs/id/managed-mcp) organisasi Anda.3155Teks setelah nama server adalah alasannya. Yang paling umum adalah pemeriksaan nama: Claude Desktop mengizinkan karakter dalam nama server, seperti spasi dan titik, yang dibatasi oleh `claude mcp` hanya pada huruf, angka, tanda hubung, dan garis bawah. Alasan lainnya termasuk konfigurasi server yang gagal validasi dan server yang diblokir oleh [kebijakan MCP](/docs/id/managed-mcp) organisasi Anda.
3133 3156
3134**Yang harus dilakukan:**3157**Yang harus dilakukan:**
3135 3158
3136* Ubah nama server di `claude_desktop_config.json` untuk hanya menggunakan huruf, angka, tanda hubung, dan garis bawah, kemudian jalankan `claude mcp add-from-claude-desktop` lagi3159* Ganti nama server di `claude_desktop_config.json` agar hanya menggunakan huruf, angka, tanda hubung, dan garis bawah, lalu jalankan `claude mcp add-from-claude-desktop` lagi
3137* Tambahkan server itu langsung dengan `claude mcp add` atau `claude mcp add-json` di bawah nama yang valid. Lihat [Import MCP servers from Claude Desktop](/docs/id/mcp#import-mcp-servers-from-claude-desktop).3160* Tambahkan server tersebut secara langsung dengan `claude mcp add` atau `claude mcp add-json` dengan nama yang valid. Lihat [Mengimpor server MCP dari Claude Desktop](/docs/id/mcp#import-mcp-servers-from-claude-desktop).
3138 3161
3139<h3 id="cannot-add-mcp-server-to-the-managed-scope">3162<h3 id="cannot-add-mcp-server-to-the-managed-scope">
3140 Tidak dapat menambahkan server MCP ke scope yang dikelola3163 Tidak dapat menambahkan server MCP ke cakupan managed
3141</h3>3164</h3>
3142 3165
3143Anda menjalankan `claude mcp add` atau `claude mcp add-json` dengan `--scope managed`. Scope itu menyimpan server yang organisasi Anda sediakan melalui pengaturan yang dikelola [`managedMcpServers`](/docs/id/settings-reference#managedmcpservers). Claude Code membacanya dari pengaturan yang dikelola saja, jadi command tidak dapat menulis server ke scope itu.3166Anda menjalankan `claude mcp add` atau `claude mcp add-json` dengan `--scope managed`. Cakupan tersebut menampung server yang disediakan organisasi Anda melalui pengaturan terkelola [`managedMcpServers`](/docs/id/settings-reference#managedmcpservers). Claude Code hanya membacanya dari pengaturan terkelola, sehingga perintah tersebut tidak dapat menulis server ke cakupan tersebut.
3144 3167
3145```text theme={null}3168```text theme={null}
3146Cannot add MCP server to scope: managed3169Cannot add MCP server to scope: managed
3148 3171
3149**Yang harus dilakukan:**3172**Yang harus dilakukan:**
3150 3173
3151* Tambahkan server ke scope yang dapat Anda tulis: `local`, `user`, atau `project`. Tanpa `--scope`, command menggunakan `local`. Lihat [MCP installation scopes](/docs/id/mcp#mcp-installation-scopes)3174* Tambahkan server ke cakupan yang dapat Anda tulis: `local`, `user`, atau `project`. Tanpa `--scope`, perintah menggunakan `local`. Lihat [Cakupan instalasi MCP](/docs/id/mcp#mcp-installation-scopes)
3152* Untuk menyediakan server ke setiap pengguna di organisasi Anda, tambahkan ke [`managedMcpServers`](/docs/id/settings-reference#managedmcpservers) dalam pengaturan yang dikelola yang Anda deploy3175* Untuk menyediakan server bagi setiap pengguna di organisasi Anda, tambahkan ke [`managedMcpServers`](/docs/id/settings-reference#managedmcpservers) dalam pengaturan terkelola yang Anda deploy
3153 3176
3154<h3 id="cant-read-mcp-json">3177<h3 id="cant-read-mcp-json">
3155 Tidak dapat membaca .mcp.json3178 Tidak dapat membaca .mcp.json
3156</h3>3179</h3>
3157 3180
3158Command yang membaca [`.mcp.json`](/docs/id/mcp#project-scope) project, seperti `claude mcp add` atau `claude mcp add-json` dengan `--scope project`, atau `claude mcp remove`, menemukan bahwa file di direktori saat ini bukan file reguler atau lebih besar dari 2 MiB, jadi keluar dengan kesalahan ini alih-alih membaca file.3181Perintah yang membaca [`.mcp.json`](/docs/id/mcp#project-scope) proyek, seperti `claude mcp add` atau `claude mcp add-json` dengan `--scope project`, atau `claude mcp remove`, mendapati bahwa file di direktori Anda saat ini bukan file biasa atau lebih besar dari 2 MiB, sehingga perintah keluar dengan error ini alih-alih membaca file tersebut.
3159 3182
3160```text theme={null}3183```text theme={null}
3161Can't read .mcp.json: it isn't a regular file or is larger than 2097152 bytes. Fix or remove it, then run the command again.3184Can't read .mcp.json: it isn't a regular file or is larger than 2097152 bytes. Fix or remove it, then run the command again.
3162```3185```
3163 3186
3164Sebelum v2.1.257, FIFO di `.mcp.json` membiarkan command menunggu selamanya tanpa output, dan symlink ke file perangkat seperti `/dev/zero` menumbuhkan memori sampai proses dibunuh.3187Sebelum v2.1.257, FIFO di `.mcp.json` membuat perintah menunggu selamanya tanpa output, dan symlink ke file perangkat seperti `/dev/zero` membuat memori bertambah hingga proses dihentikan.
3165 3188
3166**Yang harus dilakukan:**3189**Yang harus dilakukan:**
3167 3190
3168* Periksa apa yang duduk di `.mcp.json` di direktori saat ini. Ganti dengan file JSON biasa dalam [format project-scope](/docs/id/mcp#project-scope), atau hapus, kemudian jalankan command lagi.3191* Periksa apa yang ada di `.mcp.json` di direktori Anda saat ini. Ganti dengan file JSON biasa dalam [format cakupan proyek](/docs/id/mcp#project-scope), atau hapus, lalu jalankan perintah lagi.
3169 3192
3170<h3 id="mcp-server-was-not-saved-or-removed">3193<h3 id="mcp-server-was-not-saved-or-removed">
3171 Server MCP tidak disimpan atau dihapus3194 Server MCP tidak disimpan atau dihapus
3172</h3>3195</h3>
3173 3196
3174Anda menjalankan `claude mcp add`, `claude mcp add-json`, atau `claude mcp remove` untuk server dalam scope `user` atau `local` [scope](/docs/id/mcp#mcp-installation-scopes). Kedua scope disimpan di `~/.claude.json`, dan perubahan tidak ada dalam file itu ketika Claude Code membacanya kembali setelah menulis. Command keluar dengan kesalahan ini alih-alih baris suksesnya.3197Anda menjalankan `claude mcp add`, `claude mcp add-json`, atau `claude mcp remove` untuk server dalam [cakupan](/docs/id/mcp#mcp-installation-scopes) `user` atau `local`. Kedua cakupan disimpan di `~/.claude.json`, dan perubahan tersebut tidak ada di file itu ketika Claude Code membacanya kembali setelah menulis. Perintah keluar dengan error ini alih-alih baris keberhasilannya.
3175 3198
3176```text theme={null}3199```text theme={null}
3177MCP server "example" was not saved to /home/user/.claude.json. If that file is read-only or protected by a sandbox, make it writable or run the command outside the sandbox, then add the server again.3200MCP server "example" was not saved to /home/user/.claude.json. If that file is read-only or protected by a sandbox, make it writable or run the command outside the sandbox, then add the server again.
3178```3201```
3179 3202
3180Setelah remove, pesan membaca `was not removed from` dan berakhir dengan `then remove the server again`. Untuk server scope `local`, path diikuti oleh direktori project yang entri milik, sebagai `(local scope for /path/to/project)`.3203Setelah penghapusan, pesan berbunyi `was not removed from` dan diakhiri dengan `then remove the server again`. Untuk server dengan cakupan `local`, path diikuti oleh direktori proyek tempat entri tersebut berada, sebagai `(local scope for /path/to/project)`.
3181 3204
3182Sebelum v2.1.283, `claude mcp add`, `claude mcp add-json`, dan `claude mcp remove` melaporkan kesuksesan bahkan ketika perubahan tidak mencapai file.3205Sebelum v2.1.283, `claude mcp add`, `claude mcp add-json`, dan `claude mcp remove` melaporkan keberhasilan bahkan ketika perubahan tidak mencapai file.
3183 3206
3184**Yang harus dilakukan:**3207**Yang harus dilakukan:**
3185 3208
3186* Buat file yang pesan namakan dapat ditulis, atau jalankan command di luar sandbox, kemudian jalankan command add atau remove yang sama lagi.3209* Jadikan file yang disebutkan dalam pesan dapat ditulis, atau jalankan perintah di luar sandbox, lalu jalankan perintah add atau remove yang sama lagi.
3187 3210
3188<h3 id="mcp-server-may-not-have-been-saved-or-removed">3211<h3 id="mcp-server-may-not-have-been-saved-or-removed">
3189 Server MCP mungkin tidak disimpan atau dihapus3212 Server MCP mungkin tidak disimpan atau dihapus
3190</h3>3213</h3>
3191 3214
3192Anda menjalankan `claude mcp add`, `claude mcp add-json`, atau `claude mcp remove` untuk server dalam scope `user` atau `local` [scope](/docs/id/mcp#mcp-installation-scopes), dan Claude Code tidak dapat membaca `~/.claude.json` kembali untuk mengkonfirmasi perubahan. Perubahan mungkin atau mungkin tidak ada di disk. Teks dalam tanda kurung adalah kesalahan dari pembacaan itu.3215Anda menjalankan `claude mcp add`, `claude mcp add-json`, atau `claude mcp remove` untuk server dalam [cakupan](/docs/id/mcp#mcp-installation-scopes) `user` atau `local`, dan Claude Code tidak dapat membaca kembali `~/.claude.json` untuk mengonfirmasi perubahan. Perubahan tersebut mungkin ada atau mungkin tidak ada di disk. Teks dalam tanda kurung adalah error dari pembacaan tersebut.
3193 3216
3194```text theme={null}3217```text theme={null}
3195MCP server "example" may not have been saved: /home/user/.claude.json could not be read to confirm the change (EACCES: permission denied, open '/home/user/.claude.json'). Run `claude mcp get example` to check, then add the server again if it is missing.3218MCP server "example" may not have been saved: /home/user/.claude.json could not be read to confirm the change (EACCES: permission denied, open '/home/user/.claude.json'). Run `claude mcp get example` to check, then add the server again if it is missing.
3196```3219```
3197 3220
3198Setelah remove, pesan membaca `may not have been removed` dan berakhir dengan `then remove the server again if it is still listed`.3221Setelah penghapusan, pesan berbunyi `may not have been removed` dan diakhiri dengan `then remove the server again if it is still listed`.
3199 3222
3200Sebelum v2.1.283, command melaporkan kesuksesan bahkan ketika perubahan tidak dapat dikonfirmasi.3223Sebelum v2.1.283, perintah-perintah tersebut melaporkan keberhasilan bahkan ketika perubahan tidak dapat dikonfirmasi.
3201 3224
3202**Yang harus dilakukan:**3225**Yang harus dilakukan:**
3203 3226
3204* Jalankan `claude mcp get <name>` untuk memeriksa apakah perubahan ada di disk. Untuk server scope `local`, jalankan dari direktori project yang server milik, karena scope lokal per project.3227* Jalankan `claude mcp get <name>` untuk memeriksa apakah perubahan ada di disk. Untuk server dengan cakupan `local`, jalankan dari direktori proyek tempat server tersebut berada, karena cakupan local bersifat per proyek.
3205* Jika server hilang setelah add, atau masih terdaftar setelah remove, jalankan command add atau remove yang sama lagi.3228* Jika server tidak ada setelah penambahan, atau masih tercantum setelah penghapusan, jalankan perintah add atau remove yang sama lagi.
3206 3229
3207<h3 id="anthropic-hosted-and-doesnt-support-local-oauth">3230<h3 id="anthropic-hosted-and-doesnt-support-local-oauth">
3208 Server adalah Anthropic-hosted dan tidak mendukung OAuth lokal3231 Server di-host oleh Anthropic dan tidak mendukung OAuth lokal
3209</h3>3232</h3>
3210 3233
3211Anda memulai sign-in untuk server MCP yang URL-nya menunjuk ke host connector yang dihosting Anthropic yang mengautentikasi melalui penyedia identitas pihak ketiga. Host ini termasuk `microsoft365.mcp.claude.com`, `gmail.mcp.claude.com`, dan `gcal.mcp.claude.com`. Claude Code menolak untuk memulai alur OAuth lokal untuk host ini dari panel `/mcp` dan `claude mcp login`, karena [sign-in mereka hanya bekerja melalui claude.ai](/docs/id/mcp#use-mcp-servers-from-claude-ai).3234Anda memulai proses masuk untuk server MCP yang URL-nya mengarah ke host konektor yang di-host oleh Anthropic yang melakukan autentikasi melalui penyedia identitas pihak ketiga. Host ini termasuk `microsoft365.mcp.claude.com`, `gmail.mcp.claude.com`, dan `gcal.mcp.claude.com`. Claude Code menolak memulai alur OAuth lokalnya untuk host ini, baik dari panel `/mcp` maupun `claude mcp login`, karena [proses masuknya hanya berfungsi melalui claude.ai](/docs/id/mcp#use-mcp-servers-from-claude-ai).
3212 3235
3213```text theme={null}3236```text theme={null}
3214"gmail" is Anthropic-hosted and doesn't support local OAuth. Connect it via Settings → Connectors on claude.ai (requires `claude login`), then it'll be available here automatically.3237"gmail" is Anthropic-hosted and doesn't support local OAuth. Connect it via Settings → Connectors on claude.ai (requires `claude login`), then it'll be available here automatically.
3215```3238```
3216 3239
3217Claude Code mencocokkan host ini dengan URL, jadi pesan muncul ketika server yang Anda tambahkan dengan `claude mcp add` atau di `.mcp.json` menunjuk ke salah satunya.
3218
3219**Yang harus dilakukan:**3240**Yang harus dilakukan:**
3220 3241
3221* Hapus entri Anda dengan `claude mcp remove <name>`, jadi tidak dapat menyembunyikan connector claude.ai di URL yang sama3242* Hapus entri Anda dengan `claude mcp remove <name>`, agar entri tersebut tidak menyembunyikan konektor claude.ai di URL yang sama
3222* Setelah menghapusnya, hubungkan layanan di [claude.ai/customize/connectors](https://claude.ai/customize/connectors), saat masuk ke akun yang Anda gunakan di Claude Code. Setelah terhubung, [connector muncul di Claude Code secara otomatis](/docs/id/mcp#use-mcp-servers-from-claude-ai) jika metode autentikasi aktif Anda adalah login langganan claude.ai3243* Setelah menghapusnya, hubungkan layanan di [claude.ai/customize/connectors](https://claude.ai/customize/connectors), dalam keadaan masuk ke akun yang Anda gunakan di Claude Code. Setelah terhubung, [konektor muncul di Claude Code secara otomatis](/docs/id/mcp#use-mcp-servers-from-claude-ai) jika metode autentikasi aktif Anda adalah login langganan claude.ai
3223 3244
3224<h3 id="server-rejected-the-authorization-header-minted-by-the-configured-headershelper">3245<h3 id="server-rejected-the-authorization-header-minted-by-the-configured-headershelper">
3225 Server menolak header Authorization yang dicetak oleh headersHelper yang dikonfigurasi3246 Server menolak header Authorization yang dibuat oleh headersHelper yang dikonfigurasi
3226</h3>3247</h3>
3227 3248
3228Server MCP yang [`headersHelper`](/docs/id/mcp#use-dynamic-headers-for-custom-authentication)-nya memasok header `Authorization` menjawab koneksi dengan HTTP 401 atau 403, jadi Claude Code melaporkan koneksi sebagai gagal. Karena helper memasok header `Authorization`, Claude Code [tidak jatuh kembali ke OAuth](/docs/id/mcp#authenticate-with-remote-mcp-servers) untuk server:3249Server MCP yang header `Authorization`-nya disediakan oleh [`headersHelper`](/docs/id/mcp#use-dynamic-headers-for-custom-authentication) menjawab koneksi dengan HTTP 401 atau 403, sehingga Claude Code melaporkan koneksi sebagai gagal. Karena helper menyediakan header `Authorization`, Claude Code [tidak melakukan fallback ke OAuth](/docs/id/mcp#authenticate-with-remote-mcp-servers) untuk server tersebut:
3229 3250
3230```text theme={null}3251```text theme={null}
3231Server rejected the Authorization header minted by the configured headersHelper (HTTP 401). Check that the helper command returns a valid credential for this MCP endpoint — OAuth fallback is disabled when the helper supplies Authorization.3252Server rejected the Authorization header minted by the configured headersHelper (HTTP 401). Check that the helper command returns a valid credential for this MCP endpoint — OAuth fallback is disabled when the helper supplies Authorization.
3232```3253```
3233 3254
3234Claude Code menjalankan kembali helper pada setiap upaya koneksi, jadi retry setelah penolakan sementara, seperti race rotasi token, dapat berhasil dengan kredensial segar.3255Claude Code menjalankan ulang helper pada setiap upaya koneksi, sehingga retry setelah penolakan sementara, seperti race rotasi token, dapat berhasil dengan kredensial baru.
3235 3256
3236**Yang harus dilakukan:**3257**Yang harus dilakukan:**
3237 3258
3238* Jalankan command `headersHelper` sendiri dengan cara Claude Code menjalankannya: dari [direktori Claude Code menjalankannya](/docs/id/mcp#where-the-helper-runs), dengan [variabel lingkungan Claude Code menetapkannya](/docs/id/mcp#use-dynamic-headers-for-custom-authentication), dan tanpa [variabel kredensial Claude Code menghapusnya](/docs/id/mcp#which-variables-a-helper-can-read) untuk server dari `.mcp.json` project, plugin, atau file agent project. Periksa bahwa mencetak nilai `Authorization` yang endpoint server terima3259* Jalankan perintah `headersHelper` sendiri dengan cara yang sama seperti Claude Code menjalankannya: dari [direktori tempat Claude Code menjalankannya](/docs/id/mcp#where-the-helper-runs), dengan [environment variable yang diatur Claude Code untuknya](/docs/id/mcp#use-dynamic-headers-for-custom-authentication), dan tanpa [variabel kredensial yang dihapus Claude Code](/docs/id/mcp#which-variables-a-helper-can-read) untuk server dari `.mcp.json` proyek, plugin, atau file agent proyek. Periksa bahwa perintah tersebut mencetak nilai `Authorization` yang diterima oleh endpoint server
3239* Setelah memperbaiki helper atau sumber kredensialnya, pilih server di `/mcp` dan pilih **Reconnect**3260* Setelah memperbaiki helper atau sumber kredensialnya, pilih server di `/mcp` dan pilih **Reconnect**
3240 3261
3241Sebelum v2.1.248, Claude Code menjalankan penemuan OAuth untuk server yang helper-nya memasok header `Authorization`. Penemuan itu dapat gagal dengan `Incompatible auth server: does not support dynamic client registration` alih-alih melaporkan kredensial yang ditolak.3262Sebelum v2.1.248, Claude Code menjalankan discovery OAuth untuk server yang helper-nya menyediakan header `Authorization`. Discovery tersebut dapat gagal dengan `Incompatible auth server: does not support dynamic client registration` alih-alih melaporkan kredensial yang ditolak.
3242 3263
3243<h3 id="mcp-permission-prompt-tool-not-found">3264<h3 id="mcp-permission-prompt-tool-not-found">
3244 Tool prompt izin MCP tidak ditemukan3265 Tool permintaan izin MCP tidak ditemukan
3245</h3>3266</h3>
3246 3267
3247Tool yang Anda berikan ke [`--permission-prompt-tool`](/docs/id/cli-reference#cli-flags) tidak ada di antara tool MCP yang terhubung ketika run pertama kali memerlukan keputusan izin, baik karena server-nya tidak pernah terhubung atau karena tidak ada server yang terhubung yang mengekspos tool dengan nama itu. Claude Code masih mengirim prompt Anda: run [non-interaktif](/docs/id/headless) keluar dengan kesalahan ini, dan kode keluar 1, pada panggilan tool pertama, jadi menghasilkan tidak ada jawaban meskipun permintaan dibuat. Sebelum prompt pertama, Claude Code menunggu hingga timeout koneksi per-server 30 detik yang ditetapkan oleh [`MCP_TIMEOUT`](/docs/id/env-vars) untuk server itu terhubung. Sebelum v2.1.206, startup tidak menunggu server selesai terhubung, jadi server yang lambat dimulai tetapi sehat menghasilkan kesalahan ini juga.3268Tool yang Anda teruskan ke [`--permission-prompt-tool`](/docs/id/cli-reference#cli-flags) tidak termasuk di antara tool MCP yang terhubung ketika run pertama kali memerlukan keputusan izin, baik karena server-nya tidak pernah terhubung maupun karena tidak ada server terhubung yang mengekspos tool dengan nama tersebut. Claude Code tetap mengirimkan prompt Anda: run [non-interaktif](/docs/id/headless) keluar dengan error ini, dan exit code 1, pada panggilan tool pertama, sehingga tidak menghasilkan jawaban meskipun permintaan telah dibuat. Sebelum prompt pertama, Claude Code menunggu hingga timeout koneksi per server selama 30 detik yang diatur oleh [`MCP_TIMEOUT`](/docs/id/env-vars) agar server tersebut terhubung. Sebelum v2.1.206, startup tidak menunggu server selesai terhubung, sehingga server yang lambat dimulai tetapi sehat juga menghasilkan error ini.
3248 3269
3249```text theme={null}3270```text theme={null}
3250Error: MCP tool mcp__permissions__approve (passed via --permission-prompt-tool) not found. Available MCP tools: none3271Error: MCP tool mcp__permissions__approve (passed via --permission-prompt-tool) not found. Available MCP tools: none
3251```3272```
3252 3273
3253Daftar setelah `Available MCP tools:` menamai tool MCP yang terhubung.3274Daftar setelah `Available MCP tools:` menyebutkan tool MCP yang terhubung.
3254 3275
3255**Yang harus dilakukan:**3276**Yang harus dilakukan:**
3256 3277
3257* Periksa bahwa server dimulai dan tetap terhubung: jalankan `claude mcp list` di direktori yang sama dan konfirmasi server terdaftar sebagai terhubung3278* Periksa bahwa server dimulai dan tetap terhubung: jalankan `claude mcp list` di direktori yang sama dan pastikan server tercantum sebagai terhubung
3258* Konfirmkan nama tool cocok dengan nama `mcp__<server>__<tool>` yang server ekspos3279* Pastikan nama tool cocok dengan nama `mcp__<server>__<tool>` yang diekspos server
3259* Jika server memerlukan lebih lama dari 30 detik untuk dimulai, naikkan [`MCP_TIMEOUT`](/docs/id/env-vars)3280* Jika server membutuhkan lebih dari 30 detik untuk dimulai, naikkan [`MCP_TIMEOUT`](/docs/id/env-vars)
3260 3281
3261<h3 id="oauth-callback-port-is-already-in-use">3282<h3 id="oauth-callback-port-is-already-in-use">
3262 Port callback OAuth sudah digunakan3283 Port callback OAuth sudah digunakan
3263</h3>3284</h3>
3264 3285
3265Ketika Anda masuk ke server MCP jarak jauh dengan OAuth, Claude Code memulai pendengar lokal untuk menerima callback sign-in. Jika port yang pendengar itu butuhkan dipegang oleh proses lain, sign-in gagal dengan pesan ini. Ini sebagian besar terjadi dengan [port callback tetap](/docs/id/mcp#use-a-fixed-oauth-callback-port) yang ditetapkan melalui variabel [`MCP_OAUTH_CALLBACK_PORT`](/docs/id/env-vars) atau `--callback-port`, karena tanpa satu Claude Code memilih port yang tersedia.3286Ketika Anda masuk ke server MCP jarak jauh dengan OAuth, Claude Code memulai listener lokal untuk menerima callback masuk. Jika port yang dibutuhkan listener tersebut dipegang oleh proses lain, proses masuk gagal dengan pesan ini. Hal ini sebagian besar terjadi dengan [port callback tetap](/docs/id/mcp#use-a-fixed-oauth-callback-port) yang diatur melalui variabel [`MCP_OAUTH_CALLBACK_PORT`](/docs/id/env-vars) atau `--callback-port`, karena tanpanya Claude Code memilih port yang tersedia.
3266 3287
3267```text theme={null}3288```text theme={null}
3268OAuth callback port <port> is already in use — another process may be holding it. Run `lsof -ti:<port> -sTCP:LISTEN` to find it.3289OAuth callback port <port> is already in use — another process may be holding it. Run `lsof -ti:<port> -sTCP:LISTEN` to find it.
3269```3290```
3270 3291
3271Di Windows, command yang disarankan adalah `netstat -ano | findstr :<port>` sebagai gantinya.3292Di Windows, perintah yang disarankan adalah `netstat -ano | findstr :<port>` sebagai gantinya.
3272 3293
3273**Yang harus dilakukan:**3294**Yang harus dilakukan:**
3274 3295
3275* Jalankan command dari pesan untuk menemukan proses yang memegang port, dan hentikan atau tunggu selesai3296* Jalankan perintah dari pesan untuk menemukan proses yang memegang port, lalu hentikan proses tersebut atau tunggu hingga selesai
3276* Jika program lain memerlukan port itu secara permanen, daftarkan URI redirect berbeda dengan server dan atur port-nya dengan `MCP_OAUTH_CALLBACK_PORT` atau `--callback-port`, mana pun yang Anda gunakan3297* Jika program lain membutuhkan port tersebut secara permanen, daftarkan redirect URI yang berbeda pada server dan atur port-nya dengan `MCP_OAUTH_CALLBACK_PORT` atau `--callback-port`, mana pun yang Anda gunakan
3277* Kemudian mulai sign-in lagi, misalnya dengan memilih server di `/mcp`3298* Kemudian mulai proses masuk lagi, misalnya dengan memilih server di `/mcp`
3278 3299
3279<h3 id="no-available-ports-for-oauth-redirect">3300<h3 id="no-available-ports-for-oauth-redirect">
3280 Tidak ada port yang tersedia untuk redirect OAuth3301 Tidak ada port yang tersedia untuk redirect OAuth
3281</h3>3302</h3>
3282 3303
3283Ketika Anda masuk ke server MCP jarak jauh dengan [OAuth](/docs/id/mcp#authenticate-with-remote-mcp-servers), Claude Code memulai pendengar lokal untuk menerima callback sign-in. Sign-in gagal dengan pesan ini ketika Claude Code tidak dapat mengikat port lokal untuk itu. Sesuatu di mesin mencegah mendengarkan di `127.0.0.1`, misalnya software keamanan atau kebijakan sandbox yang menolak pendengar lokal.3304Ketika Anda masuk ke server MCP jarak jauh dengan [OAuth](/docs/id/mcp#authenticate-with-remote-mcp-servers), Claude Code memulai listener lokal untuk menerima callback masuk. Proses masuk gagal dengan pesan ini ketika Claude Code tidak dapat mengikat port lokal untuknya. Sesuatu di mesin mencegahnya mendengarkan di `127.0.0.1`, misalnya perangkat lunak keamanan atau kebijakan sandbox yang menolak listener lokal.
3284 3305
3285```text theme={null}3306```text theme={null}
3286No available ports for OAuth redirect3307No available ports for OAuth redirect
3287```3308```
3288 3309
3289Sebelum v2.1.268, Claude Code tidak jatuh kembali ke port yang ditugaskan sistem operasi, jadi pesan juga muncul ketika hanya port yang dipilih sendiri tidak dapat diikat. Itu dapat terjadi pada host Windows di mana Hyper-V memesan rentang port yang mencakup port yang Claude Code pilih dari.3310Sebelum v2.1.268, Claude Code tidak melakukan fallback ke port yang ditetapkan oleh sistem operasi, sehingga pesan ini juga muncul ketika hanya port yang dipilihnya sendiri yang tidak dapat diikat. Hal itu dapat terjadi pada host Windows di mana Hyper-V mencadangkan rentang port yang mencakup port yang dipilih oleh Claude Code.
3290 3311
3291**Yang harus dilakukan:**3312**Yang harus dilakukan:**
3292 3313
3293* Periksa apakah software keamanan atau kebijakan sandbox memblokir proses dari mendengarkan di `127.0.0.1`, dan izinkan Claude Code mengikat port lokal3314* Periksa apakah perangkat lunak keamanan atau kebijakan sandbox memblokir proses agar tidak mendengarkan di `127.0.0.1`, dan izinkan Claude Code untuk mengikat port lokal
3294* Kemudian mulai sign-in lagi, misalnya dengan memilih server di `/mcp`3315* Kemudian mulai proses masuk lagi, misalnya dengan memilih server di `/mcp`
3295 3316
3296<h3 id="security-review-fails-without-origin-head">3317<h3 id="security-review-fails-without-origin-head">
3297 /security-review gagal tanpa origin/HEAD3318 /security-review gagal tanpa origin/HEAD
3298</h3>3319</h3>
3299 3320
3300[`/security-review`](/docs/id/commands#all-commands) membangun konteks review dengan membedakan branch Anda terhadap `origin/HEAD`, ref lokal yang mencatat branch mana yang default di remote `origin` Anda. Ketika ref itu tidak ada, command git yang mengumpulkan diff gagal dan review berhenti sebelum dimulai.3321[`/security-review`](/docs/id/commands#all-commands) membangun konteks tinjauannya dengan membuat diff branch Anda terhadap `origin/HEAD`, ref lokal yang mencatat branch mana yang menjadi default pada remote `origin` Anda. Ketika ref tersebut tidak ada, perintah git yang mengumpulkan diff gagal dan tinjauan berhenti sebelum dimulai.
3301 3322
3302```text theme={null}3323```text theme={null}
3303Error: Shell command failed for pattern "!`git diff --name-only origin/HEAD...`": [stderr]3324Error: Shell command failed for pattern "!`git diff --name-only origin/HEAD...`": [stderr]
3306'git <command> [<revision>...] -- [<file>...]'3327'git <command> [<revision>...] -- [<file>...]'
3307```3328```
3308 3329
3309Pesan dapat mengutip `git log` atau `git diff` berbeda sebagai gantinya. Git membuat `origin/HEAD` hanya ketika remote mengiklankan branch default dan refspec fetch Anda mencakupnya, yang full `git clone` dari remote dengan commit lakukan. Ref hilang dalam setup ini:3330Pesan tersebut mungkin mengutip `git log` atau `git diff` yang berbeda. Git membuat `origin/HEAD` hanya ketika remote mengiklankan branch default dan refspec fetch Anda mencakupnya, yang dilakukan oleh `git clone` penuh dari remote yang memiliki commit. Ref tersebut tidak ada dalam penyiapan berikut:
3310 3331
3311* Single-branch atau CI checkout, yang mengambil refspec terlalu sempit3332* Checkout single-branch atau CI, yang mengambil refspec terlalu sempit
3312* Remote yang server-side HEAD menunjuk ke branch yang tidak ada yang dorong3333* Remote yang HEAD sisi servernya menunjuk ke branch yang tidak pernah di-push siapa pun
3313* Repository tanpa remote `origin`, atau yang tidak pernah Anda ambil3334* Repositori tanpa remote `origin`, atau yang tidak pernah Anda fetch
3314 3335
3315Claude Code menunjukkan kesalahan yang sama untuk skill apa pun yang [menyuntikkan konteks dinamis](/docs/id/skills#when-an-injected-command-fails), dan command yang disuntikkan gagal menghentikan invokasi skill itu. Dua string sibling api sebelum command berjalan sama sekali:3336Claude Code menampilkan error yang sama untuk skill apa pun yang [menyisipkan konteks dinamis](/docs/id/skills#when-an-injected-command-fails), dan perintah sisipan yang gagal membatalkan pemanggilan skill tersebut. Dua string serupa muncul sebelum perintah dijalankan sama sekali:
3316 3337
3317* `Shell command permission check failed for pattern "..."`: pemeriksaan izin command tidak mengizinkannya. [Permission checks on injected commands](/docs/id/skills#permission-checks-on-injected-commands) mencakup hasil mana yang menghentikan dalam setiap mode izin dan cara pre-approve command dengan `allowed-tools`3338* `Shell command permission check failed for pattern "..."`: pemeriksaan izin perintah tidak mengizinkannya. [Pemeriksaan izin pada perintah sisipan](/docs/id/skills#permission-checks-on-injected-commands) membahas hasil mana yang membatalkan di setiap mode izin dan cara menyetujui perintah sebelumnya dengan `allowed-tools`
3318* ``Skill <name> requires bash (`shell: bash` in frontmatter) but Git Bash was not found``: frontmatter skill menuntut bash di mesin tanpanya. Instal Git untuk Windows atau ubah frontmatter ke `shell: powershell`. Lihat [How injected commands run](/docs/id/skills#how-injected-commands-run)3339* ``Skill <name> requires bash (`shell: bash` in frontmatter) but Git Bash was not found``: frontmatter skill menuntut bash pada mesin yang tidak memilikinya. Instal Git for Windows atau ubah frontmatter menjadi `shell: powershell`. Lihat [Cara perintah sisipan dijalankan](/docs/id/skills#how-injected-commands-run)
3319 3340
3320**Yang harus dilakukan:**3341**Yang harus dilakukan:**
3321 3342
3322* Buat ref dengan menamai branch default remote Anda: `git remote set-head origin <default-branch>`. Ini bekerja kapan pun ref tracking lokal `origin/<default-branch>` ada. Jika tidak, seperti dalam clone single-branch, ambil branch terlebih dahulu: jalankan `git remote set-branches --add origin <branch>`, kemudian `git fetch origin`, kemudian jalankan kembali command set-head. Jalankan kembali `/security-review`.3343* Buat ref dengan menyebutkan branch default remote Anda: `git remote set-head origin <default-branch>`. Ini berfungsi setiap kali ref pelacakan lokal `origin/<default-branch>` ada. Jika tidak ada, seperti pada clone single-branch, fetch branch tersebut terlebih dahulu: jalankan `git remote set-branches --add origin <branch>`, lalu `git fetch origin`, lalu jalankan ulang perintah set-head. Jalankan ulang `/security-review`.
3323* Jika Anda lebih suka tidak menamai branch, jalankan `git fetch origin` dan kemudian `git remote set-head origin --auto`, yang menanyakan remote branch mana yang default-nya. Gagal dengan `error: Cannot determine remote HEAD` ketika remote tidak mengiklankan branch default, karena kosong atau HEAD-nya menunjuk ke branch yang tidak ada yang dorong; namai branch secara eksplisit sebagai gantinya. Gagal dengan `error: Not a valid ref` ketika clone Anda tidak mengambil branch itu; perluas refspec seperti di atas terlebih dahulu.3344* Jika Anda lebih suka tidak menyebutkan branch, jalankan `git fetch origin` lalu `git remote set-head origin --auto`, yang menanyakan kepada remote branch mana yang menjadi default-nya. Perintah ini gagal dengan `error: Cannot determine remote HEAD` ketika remote tidak mengiklankan branch default, karena remote kosong atau HEAD-nya menunjuk ke branch yang tidak pernah di-push siapa pun; sebutkan branch secara eksplisit sebagai gantinya. Perintah ini gagal dengan `error: Not a valid ref` ketika clone Anda tidak mengambil branch tersebut; perluas refspec seperti di atas terlebih dahulu.
3324* Jika repository tidak memiliki remote, tambahkan dengan `git remote add origin <url>` dan ambil sebelum membuat ref. Jika remote kosong, dorong branch Anda terlebih dahulu dengan `git push -u origin HEAD` dan namai branch itu dalam command set-head; `origin/HEAD` kemudian menunjuk ke branch yang baru saja Anda dorong, jadi `/security-review` melihat diff kosong sampai branch menyimpang darinya.3345* Jika repositori tidak memiliki remote, tambahkan dengan `git remote add origin <url>` dan lakukan fetch sebelum membuat ref. Jika remote kosong, push branch Anda terlebih dahulu dengan `git push -u origin HEAD` dan sebutkan branch tersebut dalam perintah set-head; `origin/HEAD` kemudian menunjuk ke branch yang baru saja Anda push, sehingga `/security-review` melihat diff kosong sampai branch menyimpang darinya.
3325 3346
3326<h3 id="input-must-be-provided-when-using-print">3347<h3 id="input-must-be-provided-when-using-print">
3327 Input harus disediakan saat menggunakan `--print`3348 Input harus diberikan saat menggunakan `--print`
3328</h3>3349</h3>
3329 3350
3330Bare `claude` memerlukan stdout menjadi terminal untuk memulai UI interaktif. Ketika stdout dialihkan, atau konsol bukan terminal nyata, seperti PowerShell ISE dan beberapa pane output IDE, `claude` berjalan [non-interaktif](/docs/id/headless) sebagai gantinya. Itu adalah mode yang sama dengan `claude -p`, yang memerlukan prompt, jadi pesan menamai `--print` bahkan ketika Anda tidak melewatkan flag. Melewatkan `-p`/`--print` tanpa prompt dan tidak ada yang dipipa di stdin menghasilkan kesalahan yang sama di mana pun.3351`claude` tanpa argumen memerlukan stdout berupa terminal untuk memulai UI interaktif. Ketika stdout dialihkan, atau konsol bukan terminal sungguhan, seperti PowerShell ISE dan beberapa panel output IDE, `claude` berjalan secara [non-interaktif](/docs/id/headless) sebagai gantinya. Itu adalah mode yang sama dengan `claude -p`, yang memerlukan prompt, sehingga pesan menyebutkan `--print` meskipun Anda tidak meneruskan flag tersebut. Meneruskan `-p`/`--print` tanpa prompt dan tanpa apa pun yang di-pipe ke stdin menghasilkan error yang sama di mana saja.
3331 3352
3332```text theme={null}3353```text theme={null}
3333Error: Input must be provided either through stdin or as a prompt argument when using --print3354Error: Input must be provided either through stdin or as a prompt argument when using --print
3335 3356
3336**Yang harus dilakukan:**3357**Yang harus dilakukan:**
3337 3358
3338* Untuk penggunaan interaktif, jalankan `claude` di terminal nyata: Windows Terminal atau konsol PowerShell daripada ISE, dan terminal terintegrasi IDE Anda daripada pane output3359* Untuk penggunaan interaktif, jalankan `claude` di terminal sungguhan: Windows Terminal atau konsol PowerShell alih-alih ISE, dan terminal terintegrasi IDE Anda alih-alih panel output
3339* Untuk penggunaan satu kali, berikan prompt: `claude -p "your question"`, atau pipanya dengan `echo "your question" | claude -p`3360* Untuk penggunaan sekali jalan, teruskan prompt: `claude -p "your question"`, atau pipe dengan `echo "your question" | claude -p`
3340 3361
3341<h3 id="input-contained-only-whitespace">3362<h3 id="input-contained-only-whitespace">
3342 Input hanya berisi whitespace3363 Input hanya berisi spasi kosong
3343</h3>3364</h3>
3344 3365
3345Dalam [mode non-interaktif](/docs/id/headless), Claude Code menolak prompt yang terdiri sepenuhnya dari spasi, tab, atau newline alih-alih mengirimnya, karena API menolak pesan tanpa teks terlihat. Pesan mana yang Anda lihat tergantung di mana prompt kosong berasal:3366Dalam [mode non-interaktif](/docs/id/headless), Claude Code menolak prompt yang seluruhnya terdiri dari spasi, tab, atau baris baru alih-alih mengirimkannya, karena API menolak pesan tanpa teks yang terlihat. Pesan yang Anda lihat bergantung pada dari mana prompt kosong tersebut berasal:
3346 3367
3347* **Argumen prompt atau stdin yang dipipa untuk `claude -p`**: `claude` keluar dengan `Error: Input contained only whitespace. Provide a prompt with text through stdin or as a prompt argument when using --print`3368* **Argumen prompt atau stdin yang di-pipe untuk `claude -p`**: `claude` keluar dengan `Error: Input contained only whitespace. Provide a prompt with text through stdin or as a prompt argument when using --print`
3348* **Pesan yang dikirimkan ke sesi `--input-format stream-json` atau [Agent SDK](/docs/id/agent-sdk/overview) yang berjalan**: Claude Code mengakhiri giliran tanpa memanggil model dan sesi tetap dapat digunakan. Penolakan tiba sebagai pesan informatif dan sebagai teks hasil giliran: `Blank prompt — the message was only whitespace, so nothing was sent to the model.`3369* **Pesan yang dikirimkan ke sesi `--input-format stream-json` atau [Agent SDK](/docs/id/agent-sdk/overview) yang sedang berjalan**: Claude Code mengakhiri giliran tanpa memanggil model dan sesi tetap dapat digunakan. Penolakan tiba sebagai pesan informasi dan sebagai teks hasil giliran: `Blank prompt — the message was only whitespace, so nothing was sent to the model.`
3349 3370
3350Sebelum v2.1.229, Claude Code mengirim pesan whitespace-only ke API, yang menolak permintaan dengan kesalahan 400.3371Sebelum v2.1.229, Claude Code mengirimkan pesan yang hanya berisi spasi kosong ke API, yang menolak permintaan dengan error 400.
3351 3372
3352**Yang harus dilakukan:**3373**Yang harus dilakukan:**
3353 3374
3354* Sertakan teks terlihat dalam prompt. Jika script membangun prompt dari variabel atau file, periksa bahwa sumber tidak kosong sebelum memanggil Claude Code.3375* Sertakan teks yang terlihat dalam prompt. Jika skrip membangun prompt dari variabel atau file, periksa bahwa sumbernya tidak kosong sebelum memanggil Claude Code.
3355 3376
3356<h3 id="stream-json-input-carried-over-256m-characters-with-no-newline">3377<h3 id="stream-json-input-carried-over-256m-characters-with-no-newline">
3357 stream-json input membawa lebih dari 256M karakter tanpa newline3378 Input stream-json membawa lebih dari 256M karakter tanpa baris baru
3358</h3>3379</h3>
3359 3380
3360Program Anda mengirim lebih dari 268.435.456 karakter di stdin tanpa newline ke run `claude -p --input-format stream-json`, jadi Claude Code mencetak kesalahan ini ke stderr dan keluar dengan kode 1 alih-alih membuffer lebih banyak input. Pesan menyatakan anggaran itu sebagai `256M`. Sebelum v2.1.257, Claude Code membuffer input seperti itu tanpa batas, menumbuhkan memori sampai proses mogok atau dibunuh.3381Program Anda mengirimkan lebih dari 268.435.456 karakter di stdin tanpa baris baru ke run `claude -p --input-format stream-json`, sehingga Claude Code mencetak error ini ke stderr dan keluar dengan kode 1 alih-alih mem-buffer lebih banyak input. Pesan menyatakan batas tersebut sebagai `256M`. Sebelum v2.1.257, Claude Code mem-buffer input seperti itu tanpa batas, menambah memori hingga proses crash atau dihentikan.
3361 3382
3362```text theme={null}3383```text theme={null}
3363Error: stream-json input carried over 256M characters with no newline. Each stream-json message must be a single newline-terminated JSON line: either the producer is not newline-terminating its messages, or one message exceeded this budget.3384Error: stream-json input carried over 256M characters with no newline. Each stream-json message must be a single newline-terminated JSON line: either the producer is not newline-terminating its messages, or one message exceeded this budget.
3364```3385```
3365 3386
3366Input sepanjang ini tanpa newline biasanya berarti producer bukan producer stream-json sama sekali, seperti file biner atau output log biasa yang dipipa secara tidak sengaja. Pesan tunggal di atas anggaran gagal pemeriksaan yang sama.3387Input sepanjang ini tanpa baris baru biasanya berarti produsennya sama sekali bukan produsen stream-json, seperti file biner atau output log biasa yang tidak sengaja di-pipe. Satu pesan yang melebihi batas gagal dalam pemeriksaan yang sama.
3367 3388
3368**Yang harus dilakukan:**3389**Yang harus dilakukan:**
3369 3390
3370* Periksa apa yang dipipa ke stdin. Dengan [`--input-format stream-json`](/docs/id/cli-reference#cli-flags), setiap pesan harus satu baris JSON yang diakhiri newline3391* Periksa apa yang di-pipe ke stdin. Dengan [`--input-format stream-json`](/docs/id/cli-reference#cli-flags), setiap pesan harus berupa satu baris JSON yang diakhiri baris baru
3371* Untuk mengirim teks biasa sebagai gantinya, hilangkan `--input-format stream-json`; `claude -p` membaca prompt teks biasa dari stdin secara default3392* Untuk mengirim teks biasa, hapus `--input-format stream-json`; `claude -p` membaca prompt teks biasa dari stdin secara default
3372 3393
3373<h3 id="unknown-command">3394<h3 id="unknown-command">
3374 Perintah tidak dikenal3395 Perintah tidak dikenal
3375</h3>3396</h3>
3376 3397
3377Dalam sesi terminal interaktif, Anda mengirimkan nama `/` yang tidak cocok dengan command apa pun dalam sesi ini, jadi Claude Code melaporkan nama alih-alih menjalankan apa pun:3398Dalam sesi terminal interaktif, Anda mengirimkan nama `/` yang tidak cocok dengan perintah apa pun dalam sesi ini, sehingga Claude Code melaporkan nama tersebut alih-alih menjalankan apa pun:
3378 3399
3379```text theme={null}3400```text theme={null}
3380Unknown command: /hepl. Did you mean /help?3401Unknown command: /hepl. Did you mean /help?
3381```3402```
3382 3403
3383Claude Code menyarankan nama command atau alias terdekat yang menu daftarkan dalam sesi ini. Ketika tidak ada yang dekat, pesan berakhir setelah nama. Penyebabnya biasanya salah satu dari berikut:3404Claude Code menyarankan nama perintah atau alias terdekat yang dicantumkan menu dalam sesi ini. Ketika tidak ada yang mendekati, pesan berakhir setelah nama tersebut. Penyebabnya biasanya salah satu dari berikut ini:
3384 3405
3385* Typo, seperti `/hepl` untuk `/help`. [How the command menu matches what you type](/docs/id/commands#how-the-command-menu-matches-what-you-type) mencakup memilih kecocokan dekat sebelum Anda kirimkan3406* Salah ketik, seperti `/hepl` untuk `/help`. [Cara menu perintah mencocokkan apa yang Anda ketik](/docs/id/commands#how-the-command-menu-matches-what-you-type) membahas cara memilih kecocokan terdekat sebelum Anda mengirimkan
3386* Command yang ada tetapi tidak tersedia dalam sesi ini karena persyaratan tidak terpenuhi, seperti platform, plan, atau metode autentikasi Anda. Entri troubleshooting untuk [`/web-setup`](/docs/id/web-quickstart#web-setup-shows-no-commands-match-or-unknown-command) dan [`/schedule`](/docs/id/routines#schedule-returns-unknown-command) berjalan melalui dua kasus umum. Beberapa command menjawab dengan pesan mereka sendiri ketika kebijakan organisasi Anda menonaktifkannya, seperti [`Cloud sessions are disabled by your organization's policy`](#cloud-sessions-are-disabled-by-your-organizations-policy)3407* Perintah yang ada tetapi tidak tersedia dalam sesi ini karena suatu persyaratan tidak terpenuhi, seperti platform, paket, atau metode autentikasi Anda. Entri pemecahan masalah untuk [`/web-setup`](/docs/id/web-quickstart#web-setup-shows-no-commands-match-or-unknown-command) dan [`/schedule`](/docs/id/routines#schedule-returns-unknown-command) menjelaskan dua kasus umum. Beberapa perintah menjawab dengan pesannya sendiri ketika kebijakan organisasi Anda menonaktifkannya, seperti [`Cloud sessions are disabled by your organization's policy`](#cloud-sessions-are-disabled-by-your-organizations-policy)
3387* Command dari [plugin](/docs/id/plugins/overview) atau [server MCP](/docs/id/mcp#use-mcp-prompts-as-commands) yang tidak diinstal atau terhubung dalam sesi ini3408* Perintah dari [plugin](/docs/id/plugins/overview) atau [server MCP](/docs/id/mcp#use-mcp-prompts-as-commands) yang tidak diinstal atau tidak terhubung dalam sesi ini
3388 3409
3389Claude Code menjawab nama `/` yang tidak cocok dengan cara ini hanya dalam sesi terminal interaktif. Dalam setiap sesi lain, mengirim prompt ke Claude sebagai pesan normal sebagai gantinya, dengan catatan bahwa command tidak berjalan dan daftar command yang Claude dapat jalankan dalam sesi. Sesi tersebut termasuk:3410Claude Code menjawab nama `/` yang tidak cocok dengan cara ini hanya dalam sesi terminal interaktif. Di setiap sesi lain, Claude Code mengirimkan prompt ke Claude sebagai pesan biasa, dengan catatan bahwa perintah tidak dijalankan dan daftar perintah yang dapat dijalankan Claude dalam sesi tersebut. Sesi tersebut meliputi:
3390 3411
3391* Run `-p`3412* Run `-p`
3392* Aplikasi [Agent SDK](/docs/id/agent-sdk/overview)3413* Aplikasi [Agent SDK](/docs/id/agent-sdk/overview)
3393* Tab Code dari [Desktop app](/docs/id/desktop)3414* Tab Code di [aplikasi Desktop](/docs/id/desktop)
3394* Panel chat dari [VS Code extension](/docs/id/vs-code)3415* Panel obrolan [ekstensi VS Code](/docs/id/vs-code)
3395* [Sesi cloud](/docs/id/claude-code-on-the-web) dan [routine](/docs/id/routines)3416* [Sesi cloud](/docs/id/claude-code-on-the-web) dan [routine](/docs/id/routines)
3396 3417
3397Untuk command built-in yang tidak dapat berjalan dalam salah satu sesi itu, Claude Code masih menjawab bahwa command tidak tersedia alih-alih mengirimnya ke Claude. Sebelum v2.1.274, hanya sesi cloud dan routine yang mengirim nama yang tidak cocok ke Claude. Sebelum v2.1.273, mereka menjawab `Unknown command` juga.3418Untuk perintah bawaan yang tidak dapat berjalan di salah satu sesi tersebut, Claude Code tetap menjawab bahwa perintah tidak tersedia alih-alih mengirimkannya ke Claude. Sebelum v2.1.274, hanya sesi cloud dan routine yang mengirimkan nama yang tidak cocok ke Claude. Sebelum v2.1.273, sesi tersebut juga menjawab `Unknown command`.
3398 3419
3399Claude Code tidak memperlakukan setiap prompt yang dimulai dengan `/` sebagai command. Mengirim prompt ke Claude sebagai pesan normal ketika kata pertama setelah `/` dimulai dengan tanda baca, seperti `/--` yang membuka komentar doc Lean, atau adalah path seperti `/var/log/syslog`.3420Claude Code tidak memperlakukan setiap prompt yang diawali dengan `/` sebagai perintah. Claude Code mengirimkan prompt ke Claude sebagai pesan biasa ketika kata pertama setelah `/` diawali dengan tanda baca, seperti `/--` yang membuka komentar dokumentasi Lean, atau berupa path seperti `/var/log/syslog`.
3400 3421
3401Sebelum v2.1.236, jika Anda menekan `Enter` sementara menu command mencantumkan kecocokan dekat untuk nama yang Anda ketik, Claude Code menjalankan kecocokan itu, jadi typo seperti `/hepl` menjalankan `/help` alih-alih menghasilkan pesan ini.3422Sebelum v2.1.236, jika Anda menekan `Enter` saat menu perintah mencantumkan kecocokan terdekat untuk nama yang Anda ketik, Claude Code menjalankan kecocokan tersebut, sehingga salah ketik seperti `/hepl` menjalankan `/help` alih-alih menghasilkan pesan ini.
3402 3423
3403**Yang harus dilakukan:**3424**Yang harus dilakukan:**
3404 3425
3405* Jalankan nama yang disarankan, atau ketik `/` diikuti bagian dari nama untuk melihat apa yang tersedia dalam sesi ini3426* Jalankan nama yang disarankan, atau ketik `/` diikuti sebagian nama untuk melihat apa yang tersedia dalam sesi ini
3406* Jika Claude Code melaporkan command yang didokumentasikan sebagai tidak dikenal, periksa barisnya dalam [referensi command](/docs/id/commands) untuk persyaratan yang dinamainya3427* Jika Claude Code melaporkan perintah yang terdokumentasi sebagai tidak dikenal, periksa barisnya di [referensi perintah](/docs/id/commands) untuk persyaratan yang disebutkannya
3407 3428
3408<h3 id="diff-is-too-large-for-ultrareview">3429<h3 id="diff-is-too-large-for-ultrareview">
3409 Diff terlalu besar untuk ultrareview3430 Diff terlalu besar untuk ultrareview
3410</h3>3431</h3>
3411 3432
3412Diff antara branch Anda dan branch base, termasuk perubahan yang tidak berkomit dan staged, melebihi batas ukuran untuk [ultrareview](/docs/id/ultrareview), jadi `/code-review ultra` dan subcommand `claude ultrareview` menolak review sebelum sesi cloud dimulai. Review yang ditolak tidak menggunakan run gratis dan tidak menagih kredit penggunaan. Pesan menamai batas yang berlaku, ukuran diff Anda, dan file yang berkontribusi paling banyak baris yang berubah. Sebelum v2.1.216, pesan menunjukkan hanya statistik diff mentah.3433Diff antara branch Anda dan branch dasar, termasuk perubahan yang belum di-commit dan yang sudah di-stage, melebihi batas ukuran untuk [ultrareview](/docs/id/ultrareview), sehingga `/code-review ultra` dan subperintah `claude ultrareview` menolak tinjauan sebelum sesi cloud dimulai. Tinjauan yang ditolak tidak menggunakan run gratis dan tidak menagih kredit penggunaan. Pesan menyebutkan batas yang berlaku, ukuran diff Anda, dan file yang menyumbang baris perubahan terbanyak. Sebelum v2.1.216, pesan hanya menampilkan statistik diff mentah.
3413 3434
3414```text theme={null}3435```text theme={null}
3415Diff is too large for ultrareview: 812 files, 96,410 lines changed (limits: 500 files, 8,000 lines). Largest files: package-lock.json (41,904 lines), dist/bundle.js (18,210 lines), src/generated/api.ts (9,876 lines). Pass a closer base branch (`/code-review ultra <branch>`) to narrow the scope, or split the change.3436Diff is too large for ultrareview: 812 files, 96,410 lines changed (limits: 500 files, 8,000 lines). Largest files: package-lock.json (41,904 lines), dist/bundle.js (18,210 lines), src/generated/api.ts (9,876 lines). Pass a closer base branch (`/code-review ultra <branch>`) to narrow the scope, or split the change.
3416```3437```
3417 3438
3418Meninjau pull request menerapkan batas yang sama; bentuk pesan itu dimulai `PR #<N> is too large for ultrareview` dan menamai file dan jumlah baris PR.3439Meninjau pull request menerapkan batas yang sama; bentuk pesan tersebut diawali dengan `PR #<N> is too large for ultrareview` dan menyebutkan jumlah file dan baris PR tersebut.
3419 3440
3420**Yang harus dilakukan:**3441**Yang harus dilakukan:**
3421 3442
3422* Berikan branch base yang lebih dekat ke pekerjaan Anda, seperti `/code-review ultra develop`, jadi review mencakup hanya diff terhadap branch itu3443* Teruskan branch dasar yang lebih dekat dengan pekerjaan Anda, seperti `/code-review ultra develop`, sehingga tinjauan hanya mencakup diff terhadap branch tersebut
3423* Pisahkan perubahan menjadi branch yang lebih kecil dan tinjau masing-masing. File yang pesan namakan berkontribusi paling banyak baris yang berubah, jadi mulai dengan memindahkan yang ke branch mereka sendiri.3444* Pecah perubahan menjadi branch yang lebih kecil dan tinjau masing-masing. File yang disebutkan dalam pesan menyumbang baris perubahan terbanyak, jadi mulailah dengan memindahkan file-file tersebut ke branch-nya sendiri.
3424 3445
3425<h3 id="could-not-find-merge-base-with-the-base-branch">3446<h3 id="could-not-find-merge-base-with-the-base-branch">
3426 Tidak dapat menemukan merge-base dengan branch base3447 Tidak dapat menemukan merge-base dengan branch dasar
3427</h3>3448</h3>
3428 3449
3429`/code-review ultra` dan subcommand `claude ultrareview` meninjau diff antara branch Anda dan branch base, yang memerlukan commit yang keduanya bagikan. Ketika `git merge-base` tidak menemukan satu pun, Claude Code menolak review sebelum sesi cloud dimulai. Pada clone yang Claude Code dapat verifikasi lengkap, dengan setidaknya satu branch, jatuh kembali ke [meninjau setiap file yang dilacak](/docs/id/ultrareview#diff-limits-and-fallbacks) alih-alih menolak. Anda melihat penolakan ini ketika branch base tidak dapat ditemukan sama sekali, ketika Claude Code tidak dapat memverifikasi bahwa clone Anda lengkap, atau di repository langka di mana diff seluruh pohon tidak mungkin, seperti format objek SHA-256.3450`/code-review ultra` dan subperintah `claude ultrareview` meninjau diff antara branch Anda dan branch dasar, yang memerlukan commit yang dimiliki bersama oleh keduanya. Ketika `git merge-base` tidak menemukannya, Claude Code menolak tinjauan sebelum sesi cloud dimulai. Pada clone yang dapat diverifikasi Claude Code sebagai lengkap, dengan setidaknya satu branch, Claude Code melakukan fallback ke [meninjau setiap file yang dilacak](/docs/id/ultrareview#diff-limits-and-fallbacks) alih-alih menolak. Anda melihat penolakan ini ketika branch dasar sama sekali tidak dapat ditemukan, ketika Claude Code tidak dapat memverifikasi bahwa clone Anda lengkap, atau pada repositori langka di mana diff seluruh pohon tidak memungkinkan, seperti format objek SHA-256.
3430 3451
3431```text theme={null}3452```text theme={null}
3432Could not find merge-base with main. Pass the base branch explicitly (e.g. `/code-review ultra develop`) or make sure you're in a git repo with a main branch.3453Could not find merge-base with main. Pass the base branch explicitly (e.g. `/code-review ultra develop`) or make sure you're in a git repo with a main branch.
3433```3454```
3434 3455
3435Petunjuk setelah kalimat pertama tergantung pada apa yang Claude Code amati:3456Petunjuk setelah kalimat pertama bergantung pada apa yang diamati Claude Code:
3436 3457
3437* **Anda tidak melewatkan branch base**: Claude Code dibandingkan terhadap branch default repository dan menyarankan melewatkan base Anda secara eksplisit, seperti dalam contoh di atas3458* **Anda tidak meneruskan branch dasar**: Claude Code membandingkan dengan branch default repositori dan menyarankan untuk meneruskan branch dasar Anda secara eksplisit, seperti pada contoh di atas
3438* **Anda melewatkan branch base yang sudah ada di clone Anda**: petunjuk membaca ``Make sure <branch> exists locally or on origin (try `git fetch origin <branch>`)``3459* **Anda meneruskan branch dasar yang sudah ada di clone Anda**: petunjuk berbunyi ``Make sure <branch> exists locally or on origin (try `git fetch origin <branch>`)``
3439* **Anda melewatkan branch base yang tidak ada di clone Anda**: Claude Code mengambilnya dari origin sebelum membandingkan. Petunjuk membaca ``<branch> was fetched from origin but shares no history with HEAD. If another branch is your real base, pass it explicitly (`/code-review ultra <branch>`)``; ketika Claude Code tidak dapat mengatakan apakah clone Anda dangkal, menyarankan `git fetch --unshallow origin` sebagai gantinya. Sebelum v2.1.221, petunjuk menyarankan `git fetch --unshallow origin` untuk setiap branch base yang diambil, dan pada clone lengkap command itu gagal dengan `fatal: --unshallow on a complete repository does not make sense`.3460* **Anda meneruskan branch dasar yang tidak ada di clone Anda**: Claude Code mengambilnya dari origin sebelum membandingkan. Petunjuk berbunyi ``<branch> was fetched from origin but shares no history with HEAD. If another branch is your real base, pass it explicitly (`/code-review ultra <branch>`)``; ketika Claude Code tidak dapat mengetahui apakah clone Anda dangkal, Claude Code menyarankan `git fetch --unshallow origin` sebagai gantinya. Sebelum v2.1.221, petunjuk menyarankan `git fetch --unshallow origin` untuk setiap branch dasar yang diambil, dan pada clone yang lengkap perintah tersebut gagal dengan `fatal: --unshallow on a complete repository does not make sense`.
3440 3461
3441**Yang harus dilakukan:**3462**Yang harus dilakukan:**
3442 3463
3443* Jika branch lain adalah base nyata Anda, lewatkan secara eksplisit: `/code-review ultra <branch>`3464* Jika branch lain adalah branch dasar Anda yang sebenarnya, teruskan secara eksplisit: `/code-review ultra <branch>`
3444* Jika clone Anda mungkin tidak memiliki riwayat lengkap, jalankan `git fetch --unshallow origin` dan jalankan kembali review3465* Jika clone Anda mungkin tidak memiliki riwayat lengkap, jalankan `git fetch --unshallow origin` dan jalankan ulang tinjauan
3445 3466
3446<h3 id="your-checkout-has-no-branches">3467<h3 id="your-checkout-has-no-branches">
3447 Checkout Anda tidak memiliki branch3468 Checkout Anda tidak memiliki branch
3448</h3>3469</h3>
3449 3470
3450Checkout dapat memiliki commit tetapi tidak ada branch: jika Anda menjalankan `git init` diikuti `git fetch <url>` dan `git checkout FETCH_HEAD`, Anda mendapatkan HEAD terlepas dengan tidak ada ref. Claude Code mengemas repository Anda sebagai git bundle untuk mengunggahnya untuk [ultrareview](/docs/id/ultrareview), dan tidak dapat membundle repository yang tidak memiliki branch atau ref lain, jadi `/code-review ultra` dan subcommand `claude ultrareview` menolak review sebelum sesi cloud dimulai.3471Checkout dapat memiliki commit tetapi tidak memiliki branch: jika Anda menjalankan `git init` diikuti dengan `git fetch <url>` dan `git checkout FETCH_HEAD`, Anda mendapatkan HEAD terlepas (detached) tanpa ref. Claude Code mengemas repositori Anda sebagai git bundle untuk mengunggahnya bagi [ultrareview](/docs/id/ultrareview), dan Claude Code tidak dapat membuat bundle dari repositori yang tidak memiliki branch atau ref lain, sehingga `/code-review ultra` dan subperintah `claude ultrareview` menolak tinjauan sebelum sesi cloud dimulai.
3451 3472
3452```text theme={null}3473```text theme={null}
3453Your checkout has no branches (detached HEAD only), which cloud review can't bundle. Create one first — `git checkout -b <name>` — then rerun /code-review ultra.3474Your checkout has no branches (detached HEAD only), which cloud review can't bundle. Create one first — `git checkout -b <name>` — then rerun /code-review ultra.
3457 3478
3458**Yang harus dilakukan:**3479**Yang harus dilakukan:**
3459 3480
3460* Buat branch di commit saat ini dengan `git checkout -b <name>`, kemudian jalankan kembali review3481* Buat branch pada commit Anda saat ini dengan `git checkout -b <name>`, lalu jalankan ulang tinjauan
3461 3482
3462<h3 id="no-github-account-is-connected-to-your-claude-account">3483<h3 id="no-github-account-is-connected-to-your-claude-account">
3463 Tidak ada akun GitHub yang terhubung ke akun Claude Anda3484 Tidak ada akun GitHub yang terhubung ke akun Claude Anda
3464</h3>3485</h3>
3465 3486
3466Anda menjalankan `/code-review ultra <PR#>` atau `claude ultrareview <PR#>`, dan sebelum membuat sesi cloud Claude Code menanyakan server apakah [akun GitHub yang terhubung ke akun Claude Anda](/docs/id/ultrareview#review-a-pull-request) dapat mencapai repository PR. Tidak ada akun yang terhubung, atau koneksi kedaluwarsa, jadi clone cloud akan gagal dan Claude Code menolak peluncuran. Claude Code tidak menghabiskan run gratis atau menagih kredit penggunaan untuk peluncuran yang ditolak.3487Anda menjalankan `/code-review ultra <PR#>` atau `claude ultrareview <PR#>`, dan sebelum membuat sesi cloud, Claude Code menanyakan kepada server apakah [akun GitHub yang terhubung ke akun Claude Anda](/docs/id/ultrareview#review-a-pull-request) dapat menjangkau repositori PR tersebut. Tidak ada akun yang terhubung, atau koneksinya kedaluwarsa, sehingga clone di cloud akan gagal dan Claude Code menolak peluncuran. Claude Code tidak menggunakan run gratis atau menagih kredit penggunaan untuk peluncuran yang ditolak.
3467 3488
3468```text theme={null}3489```text theme={null}
3469Ultrareview clones <owner>/<repo> in the cloud with the GitHub account connected to your Claude account, and none is connected (or the connection expired). To fix: run /web-setup to reuse your GitHub CLI login, or connect an account at https://claude.ai/connect-github — then re-run /code-review ultra 1234 (allow a minute after connecting).3490Ultrareview clones <owner>/<repo> in the cloud with the GitHub account connected to your Claude account, and none is connected (or the connection expired). To fix: run /web-setup to reuse your GitHub CLI login, or connect an account at https://claude.ai/connect-github — then re-run /code-review ultra 1234 (allow a minute after connecting).
3470```3491```
3471 3492
3472Ketika [`/web-setup`](/docs/id/web-quickstart#connect-from-your-terminal) tidak tersedia dalam sesi Anda, pesan hanya menamai link claude.ai.3493Ketika [`/web-setup`](/docs/id/web-quickstart#connect-from-your-terminal) tidak tersedia dalam sesi Anda, pesan hanya menyebutkan link claude.ai.
3473 3494
3474**Yang harus dilakukan:**3495**Yang harus dilakukan:**
3475 3496
3476* Jalankan `/web-setup` untuk menghubungkan login GitHub CLI Anda ke akun Claude Anda, atau hubungkan akun di [claude.ai/connect-github](https://claude.ai/connect-github)3497* Jalankan `/web-setup` untuk menghubungkan login GitHub CLI Anda ke akun Claude Anda, atau hubungkan akun di [claude.ai/connect-github](https://claude.ai/connect-github)
3477* Jalankan kembali review semenit setelah terhubung3498* Jalankan ulang tinjauan satu menit setelah terhubung
3478 3499
3479Sebelum v2.1.248, Claude Code tidak memeriksa ini sebelum peluncuran.3500Sebelum v2.1.248, Claude Code tidak memeriksa hal ini sebelum peluncuran.
3480 3501
3481<h3 id="your-connected-github-account-cant-see-the-repository">3502<h3 id="your-connected-github-account-cant-see-the-repository">
3482 Akun GitHub yang terhubung Anda tidak dapat melihat repository3503 Akun GitHub yang terhubung tidak dapat melihat repositori
3483</h3>3504</h3>
3484 3505
3485Anda menjalankan `/code-review ultra <PR#>` atau `claude ultrareview <PR#>`, dan [akun GitHub yang terhubung ke akun Claude Anda](/docs/id/ultrareview#review-a-pull-request) tidak dapat membaca repository PR, jadi clone cloud akan gagal dan Claude Code menolak peluncuran. Claude Code tidak menghabiskan run gratis atau menagih kredit penggunaan untuk peluncuran yang ditolak.3506Anda menjalankan `/code-review ultra <PR#>` atau `claude ultrareview <PR#>`, dan [akun GitHub yang terhubung ke akun Claude Anda](/docs/id/ultrareview#review-a-pull-request) tidak dapat membaca repositori PR tersebut, sehingga clone di cloud akan gagal dan Claude Code menolak peluncuran. Claude Code tidak menggunakan run gratis atau menagih kredit penggunaan untuk peluncuran yang ditolak.
3486 3507
3487```text theme={null}3508```text theme={null}
3488Your connected GitHub account can't see <owner>/<repo> — usually the Claude GitHub app isn't installed on <owner> or wasn't granted this repo (web-connected accounts need it for private repos), or a different GitHub account is connected. To fix: run /web-setup to reuse your GitHub CLI login, or install the app at https://github.com/apps/claude/installations/new — then re-run /code-review ultra 1234.3509Your connected GitHub account can't see <owner>/<repo> — usually the Claude GitHub app isn't installed on <owner> or wasn't granted this repo (web-connected accounts need it for private repos), or a different GitHub account is connected. To fix: run /web-setup to reuse your GitHub CLI login, or install the app at https://github.com/apps/claude/installations/new — then re-run /code-review ultra 1234.
3489```3510```
3490 3511
3491Ketika [`/web-setup`](/docs/id/web-quickstart#connect-from-your-terminal) tidak tersedia dalam sesi Anda, pesan hanya menamai instalasi aplikasi.3512Ketika [`/web-setup`](/docs/id/web-quickstart#connect-from-your-terminal) tidak tersedia dalam sesi Anda, pesan hanya menyebutkan instalasi aplikasi.
3492 3513
3493**Yang harus dilakukan:**3514**Yang harus dilakukan:**
3494 3515
3495* Jika CLI `gh` lokal Anda dapat membaca repository, jalankan `/web-setup` untuk menghubungkan login itu ke akun Claude Anda3516* Jika CLI `gh` lokal Anda dapat membaca repositori, jalankan `/web-setup` untuk menghubungkan login tersebut ke akun Claude Anda
3496* Jalankan kembali review setelah perubahan3517* Jalankan ulang tinjauan setelah perubahan
3497 3518
3498Sebelum v2.1.248, Claude Code tidak memeriksa ini sebelum peluncuran.3519Sebelum v2.1.248, Claude Code tidak memeriksa hal ini sebelum peluncuran.
3499 3520
3500<h3 id="the-github-app-preflight-failed-transiently">3521<h3 id="the-github-app-preflight-failed-transiently">
3501 Preflight GitHub App gagal secara sementara3522 Preflight GitHub App gagal secara sementara
3502</h3>3523</h3>
3503 3524
3504Anda memulai [sesi cloud](/docs/id/claude-code-on-the-web) dari repository lokal, dan dua langkah gagal bersama-sama. Claude Code tidak dapat membangun atau mengunggah bundle repository Anda. Sebelum unggahan, memeriksa apakah layanan cloud dapat mengkloning repository dari GitHub, dan daripada jawaban pasti, pemeriksaan itu berakhir dalam kesalahan yang retry dapat menghapus, seperti kesalahan jaringan, timeout, atau kesalahan server sementara. Pesan lengkap dimulai dengan apa yang menghentikan bundle, misalnya `Could not upload repo bundle (<error>)`, dan berakhir dengan kalimat preflight:3525Anda memulai [sesi cloud](/docs/id/claude-code-on-the-web) dari repositori lokal, dan dua langkah gagal bersamaan. Claude Code tidak dapat membuat atau mengunggah bundle repositori Anda. Sebelum unggahan, Claude Code memeriksa apakah layanan cloud dapat meng-clone repositori dari GitHub, dan alih-alih jawaban pasti, pemeriksaan tersebut berakhir dengan error yang dapat diatasi dengan retry, seperti error jaringan, timeout, atau error server sementara. Pesan lengkap diawali dengan apa yang menghentikan bundle, misalnya `Could not upload repo bundle (<error>)`, dan diakhiri dengan kalimat preflight:
3505 3526
3506```text theme={null}3527```text theme={null}
3507Could not upload repo bundle (<error>). The GitHub App preflight failed transiently (network or service hiccup) — retry in a moment to start from GitHub instead3528Could not upload repo bundle (<error>). The GitHub App preflight failed transiently (network or service hiccup) — retry in a moment to start from GitHub instead
3509 3530
3510**Yang harus dilakukan:**3531**Yang harus dilakukan:**
3511 3532
3512* Jalankan kembali command setelah sebentar. Ketika pemeriksaan GitHub lulus, Claude Code dapat memulai sesi dari clone GitHub, jadi unggahan yang gagal tidak lagi memblokir peluncuran3533* Jalankan ulang perintah setelah beberapa saat. Ketika pemeriksaan GitHub berhasil, Claude Code dapat memulai sesi dari clone GitHub, sehingga unggahan yang gagal tidak lagi memblokir peluncuran
3513* Jika retry terus gagal, awal pesan menamai apa yang menghentikan unggahan. Ketika penyebab itu sesuatu yang dapat Anda perbaiki, perbaiki sehingga sesi dapat dimulai dari repository lokal Anda sebagai gantinya3534* Jika retry terus gagal, bagian awal pesan menyebutkan apa yang menghentikan unggahan. Jika penyebab tersebut adalah sesuatu yang dapat Anda perbaiki, perbaikilah agar sesi dapat dimulai dari repositori lokal Anda
3514 3535
3515Sebelum v2.1.251, Claude Code mengakhiri pesan dengan `Please set up GitHub on https://claude.ai/code` bahkan ketika pemeriksaan GitHub hanya gagal secara sementara, dan saran setup tidak dapat menghapus kegagalan sementara.3536Sebelum v2.1.251, Claude Code mengakhiri pesan dengan `Please set up GitHub on https://claude.ai/code` bahkan ketika pemeriksaan GitHub hanya gagal secara sementara, dan saran penyiapan tidak dapat mengatasi kegagalan sementara.
3516 3537
3517<h3 id="the-repository-upload-cant-follow-a-git-setting">3538<h3 id="the-repository-upload-cant-follow-a-git-setting">
3518 Repository upload tidak dapat mengikuti pengaturan git3539 Unggahan repositori tidak dapat mengikuti pengaturan git
3519</h3>3540</h3>
3520 3541
3521Anda memulai [sesi cloud yang mengunggah repository lokal Anda](/docs/id/claude-code-on-the-web#send-local-repositories-without-github), atau [ultrareview](/docs/id/ultrareview) dari branch, dan unggahan tidak dapat mengikuti salah satu pengaturan git yang memutuskan aturan atribut mana yang berlaku untuk file Anda. Jika unggahan berlanjut dan melewatkan aturan, file yang git ubah sebelum menyimpannya, seperti yang filter bersih enkripsi, dapat mencapai cloud seperti di disk. Claude Code menolak unggahan sebagai gantinya, dan tidak ada yang diunggah:3542Anda memulai [sesi cloud yang mengunggah repositori lokal Anda](/docs/id/claude-code-on-the-web#send-local-repositories-without-github), atau [ultrareview](/docs/id/ultrareview) dari sebuah branch, dan unggahan tidak dapat mengikuti salah satu pengaturan git yang menentukan aturan atribut mana yang berlaku untuk file Anda. Jika unggahan dilanjutkan dan melewatkan suatu aturan, file yang diubah git sebelum menyimpannya, seperti file yang dienkripsi oleh clean filter, dapat sampai ke cloud dalam keadaan seperti di disk. Claude Code menolak unggahan sebagai gantinya, dan tidak ada yang diunggah:
3522 3543
3523```text theme={null}3544```text theme={null}
3524Not uploading this working tree: core.ignoreCase (which decides whether .gitattributes patterns match file names regardless of letter case) is set in <file>, and the upload cannot follow that setting, so a file git would change before storing it (to encrypt it, for example) could be uploaded as it is on disk. Move the core.ignoreCase line into this repository's .git/config or directly into your ~/.gitconfig, then retry.3545Not uploading this working tree: core.ignoreCase (which decides whether .gitattributes patterns match file names regardless of letter case) is set in <file>, and the upload cannot follow that setting, so a file git would change before storing it (to encrypt it, for example) could be uploaded as it is on disk. Move the core.ignoreCase line into this repository’s .git/config or directly into your ~/.gitconfig, then retry.
3525```3546```
3526 3547
3527Pesan menamai pengaturan dan di mana diatur, dan berakhir dengan perbaikan untuk kasus yang Anda tekan. Penolakan yang sama muncul untuk `core.attributesFile` dan `attr.tree`, masing-masing dengan perbaikannya sendiri.3548Pesan menyebutkan pengaturan dan tempat pengaturan tersebut diatur, dan diakhiri dengan perbaikan untuk kasus yang Anda alami. Penolakan yang sama muncul untuk `core.attributesFile` dan `attr.tree`, masing-masing dengan perbaikannya sendiri.
3528 3549
3529Pesan dapat menamai file konfigurasi yang konfigurasi git Anda tarik melalui direktif `include` atau `includeIf`, bahkan ketika kondisi direktif itu tidak berlaku untuk repository ini.3550Pesan dapat menyebutkan file konfigurasi yang ditarik oleh konfigurasi git Anda melalui direktif `include` atau `includeIf`, bahkan ketika kondisi direktif tersebut tidak berlaku untuk repositori ini.
3530 3551
3531**Yang harus dilakukan:**3552**Yang harus dilakukan:**
3532 3553
3533* Terapkan perbaikan dalam kalimat terakhir pesan3554* Terapkan perbaikan yang ada di kalimat terakhir pesan
3534 3555
3535<h3 id="github-isnt-connected-to-your-claude-account">3556<h3 id="github-isnt-connected-to-your-claude-account">
3536 GitHub tidak terhubung ke akun Claude Anda3557 GitHub tidak terhubung ke akun Claude Anda
3537</h3>3558</h3>
3538 3559
3539Anda memulai [sesi cloud](/docs/id/claude-code-on-the-web) dari repository lokal Anda, misalnya dengan `/autofix-pr`. Tidak ada akun GitHub yang terhubung ke akun Claude Anda, atau koneksi kedaluwarsa, jadi Claude Code menolak peluncuran:3560Anda memulai [sesi cloud](/docs/id/claude-code-on-the-web) dari repositori lokal Anda, misalnya dengan `/autofix-pr`. Tidak ada akun GitHub yang terhubung ke akun Claude Anda, atau koneksinya kedaluwarsa, sehingga Claude Code menolak peluncuran:
3540 3561
3541```text theme={null}3562```text theme={null}
3542GitHub isn't connected to your Claude account, so this repository can't be cloned in the cloud. Run /web-setup to connect with your GitHub CLI login, or connect on the web at https://claude.ai/connect-github3563GitHub isn't connected to your Claude account, so this repository can't be cloned in the cloud. Run /web-setup to connect with your GitHub CLI login, or connect on the web at https://claude.ai/connect-github
3543```3564```
3544 3565
3545Ketika Anda membuat routine dengan [`/schedule`](/docs/id/routines), pesan yang sama muncul sebagai catatan setup yang menamai repository; catatan tidak memblokir pembuatan routine.3566Ketika Anda membuat routine dengan [`/schedule`](/docs/id/routines), pesan yang sama muncul sebagai catatan penyiapan yang menyebutkan repositori; catatan tersebut tidak memblokir pembuatan routine.
3546 3567
3547**Yang harus dilakukan:**3568**Yang harus dilakukan:**
3548 3569
3549* Jalankan `/web-setup` untuk menghubungkan login GitHub CLI Anda ke akun Claude Anda, atau hubungkan akun di [claude.ai/connect-github](https://claude.ai/connect-github). Lihat [GitHub authentication options](/docs/id/claude-code-on-the-web#github-authentication-options) untuk bagaimana keduanya berbeda.3570* Jalankan `/web-setup` untuk menghubungkan login GitHub CLI Anda ke akun Claude Anda, atau hubungkan akun di [claude.ai/connect-github](https://claude.ai/connect-github). Lihat [Opsi autentikasi GitHub](/docs/id/claude-code-on-the-web#github-authentication-options) untuk perbedaan keduanya.
3550* Jalankan kembali command semenit setelah terhubung3571* Jalankan ulang perintah satu menit setelah terhubung
3551 3572
3552Sebelum v2.1.268, Claude Code melaporkan ini sebagai kegagalan sementara pemeriksaan Claude GitHub App dan menyarankan retry atau menginstal aplikasi; tidak satupun menghubungkan akun GitHub.3573Sebelum v2.1.268, Claude Code melaporkan hal ini sebagai kegagalan sementara pemeriksaan Claude GitHub App dan menyarankan untuk mencoba ulang atau menginstal aplikasi; tidak satu pun yang menghubungkan akun GitHub.
3553 3574
3554<h3 id="single-sign-on-authorization-needed">3575<h3 id="single-sign-on-authorization-needed">
3555 Otorisasi single sign-on diperlukan3576 Otorisasi single sign-on diperlukan
3556</h3>3577</h3>
3557 3578
3558Anda menjalankan [`/install-github-app`](/docs/id/github-actions#quick-setup) dan memilih repository yang organisasinya memberlakukan SAML single sign-on. Sebelum setup, Claude Code memeriksa akses Anda ke repository dengan CLI GitHub, dan GitHub menolak pemeriksaan itu karena token `gh` Anda belum diotorisasi untuk organisasi itu. Wizard menampilkan peringatan dengan langkah-langkah untuk mengotorisasi:3579Anda menjalankan [`/install-github-app`](/docs/id/github-actions#quick-setup) dan memilih repositori yang organisasinya menerapkan SAML single sign-on. Sebelum penyiapan, Claude Code memeriksa akses Anda ke repositori dengan GitHub CLI, dan GitHub menolak pemeriksaan tersebut karena token `gh` Anda belum diotorisasi untuk organisasi tersebut. Wizard menampilkan peringatan beserta langkah-langkah untuk melakukan otorisasi:
3559 3580
3560```text theme={null}3581```text theme={null}
3561Single sign-on authorization needed3582Single sign-on authorization needed
3564 3585
3565**Yang harus dilakukan:**3586**Yang harus dilakukan:**
3566 3587
3567* Otorisasi kembali login GitHub CLI Anda dengan scope `repo` dan `workflow` dengan menjalankan `gh auth refresh -h github.com -s repo,workflow`, dan otorisasi organisasi ketika GitHub meminta single sign-on3588* Otorisasi ulang login GitHub CLI Anda dengan scope `repo` dan `workflow` dengan menjalankan `gh auth refresh -h github.com -s repo,workflow`, dan otorisasi organisasi ketika GitHub meminta single sign-on
3568* Jika Anda mengautentikasi dengan personal access token di `GH_TOKEN`, buka [github.com/settings/tokens](https://github.com/settings/tokens), pilih **Configure SSO** pada token, dan otorisasi organisasi3589* Jika Anda melakukan autentikasi dengan personal access token di `GH_TOKEN`, buka [github.com/settings/tokens](https://github.com/settings/tokens), pilih **Configure SSO** pada token tersebut, dan otorisasi organisasi
3569* Jalankan `/install-github-app` lagi3590* Jalankan `/install-github-app` lagi
3570 3591
3571Sebelum v2.1.273, Claude Code menampilkan peringatan `Admin permissions required` untuk kondisi ini sebagai gantinya.3592Sebelum v2.1.273, Claude Code menampilkan peringatan `Admin permissions required` untuk kondisi ini sebagai gantinya.
3574 Gagal melanjutkan percakapan3595 Gagal melanjutkan percakapan
3575</h3>3596</h3>
3576 3597
3577Claude Code tidak dapat membaca atau memproses transkrip yang disimpan untuk sesi yang Anda pilih dari [picker `claude --resume`](/docs/id/sessions#use-the-session-picker), jadi mengakhiri proses daripada melanjutkan dalam keadaan sebagian dimuat. Pesan mencakup command untuk retry:3598Claude Code tidak dapat membaca atau memproses transkrip tersimpan untuk sesi yang Anda pilih dari [pemilih `claude --resume`](/docs/id/sessions#use-the-session-picker), sehingga Claude Code mengakhiri proses alih-alih melanjutkan dalam keadaan termuat sebagian. Pesan menyertakan perintah untuk mencoba ulang:
3578 3599
3579```text theme={null}3600```text theme={null}
3580Failed to resume the conversation.3601Failed to resume the conversation.
3581Run claude --resume <session-id> to retry, or claude to start a new session.3602Run claude --resume <session-id> to retry, or claude to start a new session.
3582```3603```
3583 3604
3584Claude Code keluar dengan kode 1 setelah menampilkan pesan. Picker `/resume` di dalam sesi yang berjalan melaporkan `Failed to resume conversation` dalam percakapan sebagai gantinya, dan sesi saat ini Anda tetap berjalan. Sebelum v2.1.216, resume yang gagal dari picker `claude --resume` tetap di spinner `Resuming conversation…` tanpa batas waktu alih-alih menampilkan pesan ini.3605Claude Code keluar dengan kode 1 setelah menampilkan pesan. Pemilih `/resume` di dalam sesi yang sedang berjalan melaporkan `Failed to resume conversation` dalam percakapan sebagai gantinya, dan sesi Anda saat ini tetap berjalan. Sebelum v2.1.216, resume yang gagal dari pemilih `claude --resume` tetap berada pada spinner `Resuming conversation…` tanpa batas waktu alih-alih menampilkan pesan ini.
3585 3606
3586**Yang harus dilakukan:**3607**Yang harus dilakukan:**
3587 3608
3588* Jalankan `claude --resume <session-id>` dengan ID sesi dari pesan untuk retry3609* Jalankan `claude --resume <session-id>` dengan ID sesi dari pesan untuk mencoba ulang
3589* Jika setiap retry gagal dengan cara yang sama, jalankan `claude update` dan resume lagi. Versi sebelum v2.1.275 gagal resume ketika transkrip yang disimpan berisi entri yang tidak dapat dibaca.3610* Jika setiap retry gagal dengan cara yang sama, jalankan `claude update` dan lanjutkan lagi. Versi sebelum v2.1.275 menggagalkan resume ketika transkrip tersimpan berisi entri yang tidak dapat dibacanya.
3590* Jika retry gagal lagi, jalankan `claude` untuk memulai sesi baru3611* Jika retry gagal lagi, jalankan `claude` untuk memulai sesi baru
3591 3612
3592<h3 id="no-conversation-found-with-the-session-id">3613<h3 id="no-conversation-found-with-the-session-id">
3593 Tidak ada percakapan yang ditemukan dengan ID sesi3614 Tidak ditemukan percakapan dengan ID sesi tersebut
3594</h3>3615</h3>
3595 3616
3596Anda melewatkan ID sesi ke `claude --resume <session-id>` dan tidak ada transkrip yang disimpan cocok:3617Anda meneruskan ID sesi ke `claude --resume <session-id>` dan tidak ada transkrip tersimpan yang cocok dengannya:
3597 3618
3598```text theme={null}3619```text theme={null}
3599No conversation found with session ID: <session-id>3620No conversation found with session ID: <session-id>
3600```3621```
3601 3622
3602Claude Code keluar dengan kode 1 setelah menampilkan pesan. Claude Code [mencari project saat ini terlebih dahulu, kemudian setiap project lain di mesin ini](/docs/id/sessions#resume-a-session) untuk ID. Sebelum v2.1.223, pencarian berhenti di direktori project saat ini dan git worktree-nya, jadi resume dari direktori tempat sesi terakhir bekerja.3623Claude Code keluar dengan kode 1 setelah menampilkan pesan. Claude Code [mencari di proyek saat ini terlebih dahulu, lalu di setiap proyek lain di mesin ini](/docs/id/sessions#resume-a-session) untuk ID tersebut. Sebelum v2.1.223, pencarian berhenti di direktori proyek saat ini dan git worktree-nya, jadi lanjutkan dari direktori tempat sesi terakhir bekerja.
3603 3624
3604Penyebab umum:3625Penyebab umum:
3605 3626
3606* **ID yang salah ketik**: untuk run non-interaktif, ID adalah field `session_id` dari output [`--output-format json`](/docs/id/headless#get-structured-output)3627* **ID salah ketik**: untuk run non-interaktif, ID adalah field `session_id` dari [output `--output-format json`](/docs/id/headless#get-structured-output)
3607* **Transkrip yang dihapus**: Claude Code menghapus transkrip setelah [periode retensi](/docs/id/sessions#where-transcripts-are-stored), 30 hari secara default, mengikuti [aturan sweep retensi](/docs/id/claude-directory#cleaned-up-automatically)3628* **Transkrip terhapus**: Claude Code menghapus transkrip setelah [periode retensi](/docs/id/sessions#where-transcripts-are-stored), 30 hari secara default, mengikuti [aturan pembersihan retensi](/docs/id/claude-directory#cleaned-up-automatically)
3608* **Mesin berbeda**: Claude Code menyimpan transkrip secara lokal, jadi resume sesi di mesin tempat dijalankan3629* **Mesin berbeda**: Claude Code menyimpan transkrip secara lokal, jadi lanjutkan sesi di mesin tempat sesi tersebut dijalankan
3609* **Duplikat salinan**: jika Anda menyalin direktori project di bawah `~/.claude/projects` jadi dua transkrip membawa ID yang sama, Claude Code melaporkan pesan ini daripada resume satu salinan secara sewenang-wenang3630* **Salinan duplikat**: jika Anda menyalin direktori proyek di bawah `~/.claude/projects` sehingga dua transkrip membawa ID yang sama, Claude Code melaporkan pesan ini alih-alih melanjutkan salah satu salinan secara acak
3610 3631
3611**Yang harus dilakukan:**3632**Yang harus dilakukan:**
3612 3633
3613* Untuk sesi interaktif, buka [session picker](/docs/id/sessions#use-the-session-picker) dengan `claude --resume` dan tekan `Ctrl+A` untuk memperluas ke setiap project di mesin ini, kemudian pilih sesi3634* Untuk sesi interaktif, buka [pemilih sesi](/docs/id/sessions#use-the-session-picker) dengan `claude --resume` dan tekan `Ctrl+A` untuk memperluasnya ke setiap proyek di mesin ini, lalu pilih sesi
3614* Sesi yang dibuat dengan `claude -p` atau [Agent SDK](/docs/id/agent-sdk/overview) tidak muncul di picker, jadi periksa kembali ID terhadap `session_id` yang run asli Anda cetak3635* Sesi yang dibuat dengan `claude -p` atau [Agent SDK](/docs/id/agent-sdk/overview) tidak muncul di pemilih, jadi periksa ulang ID terhadap `session_id` yang dicetak oleh run asli Anda
3615 3636
3616<h3 id="windows-reported-an-error-ebadf">3637<h3 id="windows-reported-an-error-ebadf">
3617 Windows melaporkan kesalahan (EBADF) ketika Claude Code membaca file transkrip sesi ini3638 Windows melaporkan kesalahan (EBADF) saat Claude Code membaca file transkrip sesi ini
3618</h3>3639</h3>
3619 3640
3620Anda melanjutkan sesi di Windows, file [transkrip](/docs/id/sessions#where-transcripts-are-stored) yang disimpan dibuka secara normal, dan membacanya kemudian gagal dengan kesalahan sistem EBADF. Kesalahan sistem tidak mengatakan mengapa pembacaan gagal, jadi pesan menyarankan penyebab kemungkinan dan apa yang dicoba:3641Anda melanjutkan sesi di Windows, [file transkrip](/docs/id/sessions#where-transcripts-are-stored) yang tersimpan untuk sesi tersebut terbuka dengan normal, lalu pembacaannya gagal dengan kesalahan sistem EBADF. Kesalahan sistem tidak menyebutkan mengapa pembacaan gagal, sehingga pesan tersebut menyarankan kemungkinan penyebab dan hal yang dapat dicoba:
3621 3642
3622```text theme={null}3643```text theme={null}
3623Windows reported an error (EBADF) when Claude Code read this session's transcript file, although the file had opened normally. This can happen when other software intercepts file reads — security, encryption or endpoint-management tools, for example. If it keeps happening for this conversation, try excluding the folder that holds Claude Code's session transcripts from such software (the .claude folder in your user profile, unless the app or CLAUDE_CONFIG_DIR points Claude Code elsewhere), or adding Claude Code to its allowed applications, then resume again.3644Windows reported an error (EBADF) when Claude Code read this session's transcript file, although the file had opened normally. This can happen when other software intercepts file reads — security, encryption or endpoint-management tools, for example. If it keeps happening for this conversation, try excluding the folder that holds Claude Code's session transcripts from such software (the .claude folder in your user profile, unless the app or CLAUDE_CONFIG_DIR points Claude Code elsewhere), or adding Claude Code to its allowed applications, then resume again.
3624```3645```
3625 3646
3626Pesan mengikuti baris kegagalan command sendiri, seperti `Failed to resume session <session-id>`. Command `claude --resume` atau [`claude -p`](/docs/id/headless) keluar dengan kode 1 setelah menampilkannya. Setelah `/resume` di dalam sesi, sesi saat ini Anda tetap berjalan.3647Pesan tersebut muncul setelah baris kegagalan perintah itu sendiri, seperti `Failed to resume session <session-id>`. Perintah `claude --resume` atau [`claude -p`](/docs/id/headless) keluar dengan kode 1 setelah menampilkannya. Setelah `/resume` di dalam sesi, sesi Anda saat ini tetap berjalan.
3627 3648
3628**Yang harus dilakukan:**3649**Yang harus dilakukan:**
3629 3650
3630* Kecualikan folder yang menyimpan transkrip sesi Anda dari software yang memindai atau mengintersepsi pembacaan file, seperti keamanan, enkripsi, atau alat manajemen endpoint. Transkrip tinggal di bawah `%USERPROFILE%\.claude\projects` secara default, atau di bawah direktori yang [`CLAUDE_CONFIG_DIR`](/docs/id/env-vars) namakan3651* Kecualikan folder yang menyimpan transkrip sesi Anda dari perangkat lunak yang memindai atau mencegat pembacaan file, seperti alat keamanan, enkripsi, atau manajemen endpoint. Secara default, transkrip berada di bawah `%USERPROFILE%\.claude\projects`, atau di bawah direktori yang ditunjuk oleh [`CLAUDE_CONFIG_DIR`](/docs/id/env-vars)
3631* Jika Anda tidak dapat menambahkan pengecualian, tambahkan Claude Code ke aplikasi yang diizinkan software itu sebagai gantinya3652* Jika Anda tidak dapat menambahkan pengecualian, tambahkan Claude Code ke daftar aplikasi yang diizinkan oleh perangkat lunak tersebut
3632* Resume sesi lagi3653* Lanjutkan sesi kembali
3633 3654
3634Sebelum v2.1.282, kegagalan datang tanpa penjelasan: `claude --resume <session-id>` berakhir di `Failed to resume session <session-id>`, dan run `-p` mencetak hanya teks kesalahan sistem, seperti `Failed to resume session: EBADF: bad file descriptor, read`.3655Sebelum v2.1.282, kegagalan ini muncul tanpa penjelasan: `claude --resume <session-id>` berakhir pada `Failed to resume session <session-id>`, dan proses `-p` hanya mencetak teks kesalahan sistem, seperti `Failed to resume session: EBADF: bad file descriptor, read`.
3635 3656
3636<h3 id="cannot-switch-renderers-in-this-session">3657<h3 id="cannot-switch-renderers-in-this-session">
3637 Tidak dapat mengganti renderer dalam sesi ini3658 Tidak dapat beralih renderer dalam sesi ini
3638</h3>3659</h3>
3639 3660
3640Ketika Anda mengganti renderer, Claude Code memulai ulang prosesnya. Anda menjalankan [`/tui`](/docs/id/fullscreen#enable-fullscreen-rendering) dalam sesi Claude Code menolak untuk memulai ulang, jadi tidak mengganti dan menyimpan apa pun. Pesan mana yang Anda lihat memberi tahu Anda penyebabnya:3661Saat Anda beralih renderer, Claude Code memulai ulang prosesnya. Anda menjalankan [`/tui`](/docs/id/fullscreen#enable-fullscreen-rendering) dalam sesi yang tidak mau dimulai ulang oleh Claude Code, sehingga Claude Code tidak beralih dan tidak menyimpan apa pun. Pesan yang Anda lihat menunjukkan penyebabnya:
3641 3662
3642* `Cannot switch renderers while work is running in the background`: Anda memiliki pekerjaan background yang berjalan yang restart akan mengorbankan, seperti shell background atau subagent. Tunggu pekerjaan selesai atau hentikan dengan [`/tasks`](/docs/id/commands), kemudian jalankan `/tui fullscreen` atau `/tui default` lagi3663* `Cannot switch renderers while work is running in the background`: Anda memiliki pekerjaan latar belakang yang sedang berjalan dan akan ditinggalkan oleh proses mulai ulang, seperti shell latar belakang atau subagent. Tunggu hingga pekerjaan selesai atau hentikan dengan [`/tasks`](/docs/id/commands), lalu jalankan `/tui fullscreen` atau `/tui default` lagi
3643* `Cannot switch renderers in this session`: sesi memiliki pembatasan Claude Code tidak dapat lewatkan ke proses yang dimulai ulang. Sebelum v2.1.234, Claude Code dimulai ulang bagaimanapun dan sesi yang diluncurkan ulang berjalan tanpanya3664* `Cannot switch renderers in this session`: sesi memiliki pembatasan yang tidak dapat diteruskan Claude Code ke proses yang dimulai ulang. Sebelum v2.1.234, Claude Code tetap memulai ulang dan sesi yang diluncurkan kembali berjalan tanpa pembatasan tersebut
3644 3665
3645Dalam pesan pembatasan, bagian dalam tanda kurung menamai pembatasan Claude Code temukan:3666Dalam pesan pembatasan, bagian di dalam tanda kurung menyebutkan pembatasan yang ditemukan Claude Code:
3646 3667
3647```text theme={null}3668```text theme={null}
3648Cannot switch renderers in this session — it has restrictions a restart can't carry over (permission rules set for this session only). Nothing was changed. Running /tui fullscreen in a session started without them switches every later session too.3669Cannot switch renderers in this session — it has restrictions a restart can't carry over (permission rules set for this session only). Nothing was changed. Running /tui fullscreen in a session started without them switches every later session too.
3649```3670```
3650 3671
3651Setiap alasan pesan dapat menunjukkan dalam tanda kurung:3672Setiap alasan yang dapat ditampilkan pesan di dalam tanda kurung:
3652 3673
3653* `launch flags: a custom system prompt, a tool allowlist, or restricted settings`: Anda memulai sesi dengan flag Claude Code tidak lewatkan kembali ke proses yang dimulai ulang. Flag ini termasuk [`--system-prompt`](/docs/id/cli-reference#cli-flags), `--system-prompt-file`, `--append-system-prompt-file`, [`--tools`](/docs/id/cli-reference#cli-flags) allowlist, [`--setting-sources`](/docs/id/cli-reference#cli-flags), dan [`--permission-prompt-tool`](/docs/id/cli-reference#cli-flags)3674* `launch flags: a custom system prompt, a tool allowlist, or restricted settings`: Anda memulai sesi dengan flag yang tidak diteruskan kembali oleh Claude Code ke proses yang dimulai ulang. Flag ini mencakup [`--system-prompt`](/docs/id/cli-reference#cli-flags), `--system-prompt-file`, `--append-system-prompt-file`, allowlist [`--tools`](/docs/id/cli-reference#cli-flags), [`--setting-sources`](/docs/id/cli-reference#cli-flags), dan [`--permission-prompt-tool`](/docs/id/cli-reference#cli-flags)
3654* `permission rules set for this session only`: [permission update](/docs/id/hooks#permission-update-entries) dari hook atau SDK caller menambahkan aturan deny atau ask dengan destinasi `session`. Aturan allow yang scoped sesi tidak memicu penolakan. Restart menjatuhkannya, dan Claude Code meminta lagi sebagai gantinya3675* `permission rules set for this session only`: sebuah [pembaruan izin](/docs/id/hooks#permission-update-entries) dari hook atau pemanggil SDK menambahkan aturan deny atau ask dengan tujuan `session`. Aturan allow yang berlingkup sesi tidak memicu penolakan ini. Proses mulai ulang akan menghapusnya, dan Claude Code akan meminta izin lagi sebagai gantinya
3655* `ask-before-running rules with no command-line form`: permission update dari hook atau SDK caller menambahkan aturan ask bersama aturan Claude Code lewatkan kembali sebagai `--allowed-tools` dan `--disallowed-tools`. Tidak ada flag untuk aturan ask3676* `ask-before-running rules with no command-line form`: pembaruan izin dari hook atau pemanggil SDK menambahkan aturan ask di samping aturan yang diteruskan kembali oleh Claude Code sebagai `--allowed-tools` dan `--disallowed-tools`. Tidak ada flag untuk aturan ask
3656* `permission rules a command line cannot carry intact` dan `added directories a command line cannot carry intact`: permission update menambahkan aturan atau path direktori mid-session. Baris perintah proses yang dimulai ulang tidak dapat membawa teksnya sebagai nilai yang sama3677* `permission rules a command line cannot carry intact` dan `added directories a command line cannot carry intact`: pembaruan izin menambahkan aturan atau jalur direktori di tengah sesi. Baris perintah proses yang dimulai ulang tidak dapat membawa teksnya sebagai nilai yang sama
3657 3678
3658**Yang harus dilakukan:**3679**Yang harus dilakukan:**
3659 3680
3660* Dalam sesi yang dimulai tanpa pembatasan itu, jalankan `/tui fullscreen`, atau `/tui default` untuk beralih kembali. Claude Code menyimpan pengaturan [`tui`](/docs/id/settings-reference#tui) di sana3681* Dalam sesi yang dimulai tanpa pembatasan tersebut, jalankan `/tui fullscreen`, atau `/tui default` untuk beralih kembali. Claude Code menyimpan [pengaturan `tui`](/docs/id/settings-reference#tui) di sana
3661 3682
3662<h3 id="couldnt-open-claude-desktop">3683<h3 id="couldnt-open-claude-desktop">
3663 Tidak dapat membuka Claude Desktop3684 Tidak dapat membuka Claude Desktop
3664</h3>3685</h3>
3665 3686
3666Anda 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.3687Anda menjalankan [`/desktop`](/docs/id/desktop#coming-from-the-cli) atau aliasnya `/app` dalam sesi, atau [`claude --desktop`](/docs/id/cli-reference#cli-flags) di shell Anda, dan perintah sistem yang digunakan Claude Code untuk membuka Claude Desktop gagal. Setelah `/desktop`, sesi tetap berada di terminal; `claude --desktop` mencetak pesan tanpa awalan `Error:` dan keluar dengan status 1.
3667 3688
3668Teks 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`:3689Teks di dalam tanda kurung menyebutkan perintah yang gagal, beserta status keluarnya dan baris pertama output kesalahannya jika perintah tersebut menghasilkannya. Di macOS perintah tersebut adalah `open`, seperti dalam contoh ini; di Windows perintahnya adalah `rundll32`:
3669 3690
3670```text theme={null}3691```text theme={null}
3671Error: 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.3692Error: 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.
3673 3694
3674**Yang harus dilakukan:**3695**Yang harus dilakukan:**
3675 3696
3676* Buka Claude Desktop sendiri, kemudian jalankan `/desktop` atau `claude --desktop` lagi3697* Buka Claude Desktop sendiri, lalu jalankan `/desktop` atau `claude --desktop` lagi
3677* 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 debug3698* Untuk membaca output kesalahan lengkap dari perintah yang gagal, aktifkan logging debug dengan `/debug` dan jalankan `/desktop` lagi, atau jalankan `claude --desktop --debug-file <path>`, lalu periksa log debug
3678 3699
3679Sebelum 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.3700Sebelum v2.1.285, pesan tersebut diakhiri dengan `Open Claude Desktop and run /desktop again.` Sebelum v2.1.275, pesannya adalah `Failed to open Claude Desktop. Please try opening it manually.` dan tidak menyebutkan apa yang gagal.
3680 3701
3681<h3 id="terminal-setup-left-your-zed-keymap-unchanged">3702<h3 id="terminal-setup-left-your-zed-keymap-unchanged">
3682 /terminal-setup meninggalkan keymap Zed Anda tidak berubah3703 /terminal-setup membiarkan keymap Zed Anda tidak berubah
3683</h3>3704</h3>
3684 3705
3685Anda menjalankan [`/terminal-setup`](/docs/id/terminal-config#enter-multiline-prompts) di Zed, dan Claude Code tidak dapat menyelesaikan pembaruan ke `keymap.json` Zed Anda, jadi meninggalkannya seperti apa adanya.3706Anda menjalankan [`/terminal-setup`](/docs/id/terminal-config#enter-multiline-prompts) di Zed, dan Claude Code tidak dapat menyelesaikan pembaruan pada `keymap.json` Zed Anda, sehingga file tersebut dibiarkan seperti semula.
3686 3707
3687Setiap pesan menamai path ke keymap Anda dan berakhir dengan blok keybinding untuk ditambahkan sendiri:3708Setiap pesan menyebutkan jalur ke keymap Anda dan diakhiri dengan blok pintasan keyboard yang dapat Anda tambahkan sendiri:
3688 3709
3689```text theme={null}3710```text theme={null}
3690Couldn't update your Zed keymap, so it was left unchanged.3711Couldn't update your Zed keymap, so it was left unchanged.
3692{ "context": "Terminal", "bindings": { "shift-enter": ["terminal::SendText", "\u001b\r"] } }3713{ "context": "Terminal", "bindings": { "shift-enter": ["terminal::SendText", "\u001b\r"] } }
3693```3714```
3694 3715
3695Baris pertama pesan menamai penyebabnya:3716Baris pertama pesan menyebutkan penyebabnya:
3696 3717
3697* `Couldn't read your Zed keymap, so it was left unchanged.`: Claude Code tidak dapat membaca file, misalnya karena izin file3718* `Couldn't read your Zed keymap, so it was left unchanged.`: Claude Code tidak dapat membaca file tersebut, misalnya karena hak akses file
3698* `Your Zed keymap isn't a readable list of keybindings, so it was left unchanged.`: file dibaca dengan baik tetapi tidak diuraikan sebagai array blok keybinding, bahkan dengan komentar `//` dan trailing comma yang diizinkan3719* `Your Zed keymap isn't a readable list of keybindings, so it was left unchanged.`: file berhasil dibaca tetapi tidak dapat di-parse sebagai array blok pintasan keyboard, bahkan dengan komentar `//` dan koma di akhir yang diizinkan
3699* `Couldn't back up your Zed keymap; not modifying it.`: Claude Code tidak dapat menyalin file ke backup `.bak` di sebelahnya, jadi tidak mengubah apa pun3720* `Couldn't back up your Zed keymap; not modifying it.`: Claude Code tidak dapat menyalin file ke cadangan `.bak` di sebelahnya, sehingga tidak mengubah apa pun
3700* `Couldn't update your Zed keymap, so it was left unchanged.`: hasil yang digabung tidak memverifikasi sebagai keymap valid yang membawa keybinding, jadi Claude Code membuangnya alih-alih menulis. Blok keybinding dengan kunci yang diduplikasi dapat menyebabkan ini3721* `Couldn't update your Zed keymap, so it was left unchanged.`: hasil penggabungan tidak terverifikasi sebagai keymap valid yang berisi pintasan tersebut, sehingga Claude Code membuangnya alih-alih menulisnya. Blok pintasan keyboard dengan kunci duplikat dapat menyebabkan hal ini
3701 3722
3702**Yang harus dilakukan:**3723**Yang harus dilakukan:**
3703 3724
3704* Salin blok dari pesan ke array tingkat atas di `keymap.json` Anda di path yang pesan namakan3725* Salin blok dari pesan ke dalam array tingkat atas di `keymap.json` Anda pada jalur yang disebutkan pesan
3705* Untuk `isn't a readable list of keybindings`, perbaiki kesalahan sintaks, atau buat nilai tingkat atas file menjadi array, kemudian jalankan `/terminal-setup` lagi3726* Untuk `isn't a readable list of keybindings`, perbaiki kesalahan sintaks, atau jadikan nilai tingkat atas file sebagai array, lalu jalankan `/terminal-setup` lagi
3706 3727
3707Sebelum v2.1.247, `/terminal-setup` tidak dapat menguraikan keymap Zed yang menggunakan komentar `//` atau trailing comma, dan mengganti seluruh file dengan hanya keybinding-nya sendiri sambil melaporkan keybinding sebagai diinstal. Untuk mengembalikan keymap yang versi sebelumnya ganti, gunakan file backup `.bak` yang dijelaskan di bawah [Enter multiline prompts](/docs/id/terminal-config#enter-multiline-prompts).3728Sebelum v2.1.247, `/terminal-setup` tidak dapat mem-parse keymap Zed yang menggunakan komentar `//` atau koma di akhir, dan mengganti seluruh file hanya dengan pintasannya sendiri sambil melaporkan bahwa pintasan tersebut telah terpasang. Untuk memulihkan keymap yang telah diganti oleh versi sebelumnya, gunakan file cadangan `.bak` yang dijelaskan di [Memasukkan prompt multibaris](/docs/id/terminal-config#enter-multiline-prompts).
3708 3729
3709<h3 id="skill-usage-reports-are-not-available-on-this-connection">3730<h3 id="skill-usage-reports-are-not-available-on-this-connection">
3710 Laporan penggunaan skill tidak tersedia di koneksi ini3731 Laporan penggunaan skill tidak tersedia pada koneksi ini
3711</h3>3732</h3>
3712 3733
3713Anda menjalankan [`/skill-doctor`](/docs/id/skills#find-unused-skills) melalui [Remote Control](/docs/id/remote-control), dari ponsel atau browser Anda. Claude Code tidak mengirim laporan penggunaan skill melalui Remote Control dan menjawab dengan pesan ini sebagai gantinya:3734Anda menjalankan [`/skill-doctor`](/docs/id/skills#find-unused-skills) melalui [Remote Control](/docs/id/remote-control), dari ponsel atau browser Anda. Claude Code tidak mengirim laporan penggunaan skill melalui Remote Control dan membalas dengan pesan ini sebagai gantinya:
3714 3735
3715```text theme={null}3736```text theme={null}
3716Skill usage reports are not available on this connection.3737Skill usage reports are not available on this connection.
3718 3739
3719**Yang harus dilakukan:**3740**Yang harus dilakukan:**
3720 3741
3721* Jalankan `/skill-doctor` di terminal di mesin tempat sesi berjalan, atau jalankan `claude -p "/skill-doctor"` di sana3742* Jalankan `/skill-doctor` di terminal pada mesin tempat sesi berjalan, atau jalankan `claude -p "/skill-doctor"` di sana
3722 3743
3723<h3 id="custom-output-styles-cant-be-selected-over-remote-control">3744<h3 id="custom-output-styles-cant-be-selected-over-remote-control">
3724 Gaya output kustom tidak dapat dipilih melalui Remote Control3745 Gaya output kustom tidak dapat dipilih melalui Remote Control
3725</h3>3746</h3>
3726 3747
3727Anda menjalankan [`/output-style`](/docs/id/output-styles#change-your-output-style) dari aplikasi mobile atau web melalui [Remote Control](/docs/id/remote-control), atau command tiba dalam pesan yang dialihkan ke sesi. Karena giliran seperti itu mungkin tidak berasal dari pemilik akun, Claude Code mencantumkan dan memilih hanya [gaya built-in](/docs/id/output-styles#built-in-output-styles) di atasnya, dan menambahkan pemberitahuan ini kapan pun command mencantumkan gaya atau tidak mengenali nama yang Anda berikan. Nama [gaya kustom](/docs/id/output-styles#create-a-custom-output-style) mendapat jawaban yang sama dengan nama yang tidak ada:3748Anda menjalankan [`/output-style`](/docs/id/output-styles#change-your-output-style) dari aplikasi seluler atau web melalui [Remote Control](/docs/id/remote-control), atau perintah tersebut datang dalam pesan yang diteruskan ke dalam sesi. Karena giliran seperti itu mungkin tidak berasal dari pemilik akun, Claude Code hanya menampilkan dan memilih [gaya bawaan](/docs/id/output-styles#built-in-output-styles) pada giliran tersebut, dan menambahkan pemberitahuan ini setiap kali perintah menampilkan daftar gaya atau tidak mengenali nama yang Anda berikan. Nama [gaya kustom](/docs/id/output-styles#create-a-custom-output-style) mendapatkan balasan yang sama seperti nama yang tidak ada:
3728 3749
3729```text theme={null}3750```text theme={null}
3730Custom output styles can't be selected over Remote Control or from a relayed message. Select one in the session itself, or pick a built-in style here.3751Custom output styles can't be selected over Remote Control or from a relayed message. Select one in the session itself, or pick a built-in style here.
3732 3753
3733**Yang harus dilakukan:**3754**Yang harus dilakukan:**
3734 3755
3735* Pilih gaya built-in, misalnya `/output-style concise`3756* Pilih gaya bawaan, misalnya `/output-style concise`
3736* Untuk menggunakan gaya kustom, atur [`outputStyle`](/docs/id/settings-reference#outputstyle) di `.claude/settings.local.json` project, atau jalankan `/output-style <style>` di terminal sesi sendiri jika memilikinya3757* Untuk menggunakan gaya kustom, atur [`outputStyle`](/docs/id/settings-reference#outputstyle) di `.claude/settings.local.json` proyek, atau jalankan `/output-style <style>` di terminal sesi itu sendiri jika ada
3737 3758
3738<h3 id="output-styles-are-saved-to-local-settings-which-this-session-doesnt-load">3759<h3 id="output-styles-are-saved-to-local-settings-which-this-session-doesnt-load">
3739 Gaya output disimpan ke pengaturan lokal yang sesi ini tidak muat3760 Gaya output disimpan ke pengaturan lokal yang tidak dimuat oleh sesi ini
3740</h3>3761</h3>
3741 3762
3742Anda mencoba mengganti [gaya output](/docs/id/output-styles) dengan `/output-style <style>` atau `/config outputStyle=<style>` dalam sesi yang sumber pengaturannya mengecualikan `local`. Contohnya adalah sesi [Agent SDK](/docs/id/agent-sdk/typescript) yang [`settingSources`](/docs/id/agent-sdk/typescript#options)-nya meninggalkan `"local"` dan sesi CLI yang dimulai dengan nilai [`--setting-sources`](/docs/id/cli-reference#cli-flags) yang meninggalkan `local`. Kedua command menyimpan gaya ke `.claude/settings.local.json`, file yang sesi seperti itu tidak pernah membaca kembali, jadi Claude Code menolak alih-alih menulis pengaturan yang tidak akan berpengaruh:3763Anda mencoba beralih [gaya output](/docs/id/output-styles) dengan `/output-style <style>` atau `/config outputStyle=<style>` dalam sesi yang sumber pengaturannya tidak menyertakan `local`. Contohnya adalah sesi [Agent SDK](/docs/id/agent-sdk/typescript) yang [`settingSources`](/docs/id/agent-sdk/typescript#options)-nya tidak menyertakan `"local"` dan sesi CLI yang dimulai dengan nilai [`--setting-sources`](/docs/id/cli-reference#cli-flags) yang tidak menyertakan `local`. Kedua perintah menyimpan gaya ke `.claude/settings.local.json`, file yang tidak pernah dibaca kembali oleh sesi seperti itu, sehingga Claude Code menolak alih-alih menulis pengaturan yang tidak akan berpengaruh:
3743 3764
3744```text theme={null}3765```text theme={null}
3745Output styles are saved to local settings (.claude/settings.local.json), which this session doesn't load, so the style can't be changed here.3766Output styles are saved to local settings (.claude/settings.local.json), which this session doesn't load, so the style can't be changed here.
3748**Yang harus dilakukan:**3769**Yang harus dilakukan:**
3749 3770
3750* Tambahkan `local` ke sumber pengaturan sesi dan beralih lagi3771* Tambahkan `local` ke sumber pengaturan sesi dan beralih lagi
3751* Atur kunci [`outputStyle`](/docs/id/settings-reference#outputstyle) dalam file pengaturan yang sesi muat, seperti `.claude/settings.json` di project atau `~/.claude/settings.json`. Dalam SDK TypeScript, atur `outputStyle` di dalam objek `settings` inline sebagai gantinya; lihat [Activate an output style](/docs/id/agent-sdk/modifying-system-prompts#activate-an-output-style)3772* Atur kunci [`outputStyle`](/docs/id/settings-reference#outputstyle) di file pengaturan yang dimuat oleh sesi, seperti `.claude/settings.json` di proyek atau `~/.claude/settings.json`. Di TypeScript SDK, atur `outputStyle` di dalam objek `settings` inline sebagai gantinya; lihat [Mengaktifkan gaya output](/docs/id/agent-sdk/modifying-system-prompts#activate-an-output-style)
3752 3773
3753<h2 id="plugin-errors">3774<h2 id="plugin-errors">
3754 Kesalahan plugin3775 Kesalahan plugin
4476 Kesalahan sesi latar belakang4497 Kesalahan sesi latar belakang
4477</h2>4498</h2>
4478 4499
4479[Sesi latar belakang](/docs/id/agent-view) berjalan tanpa terminal interaktif mereka sendiri, jadi perintah yang membutuhkan satu berperilaku berbeda di sana. Pesan-pesan ini muncul dalam transkrip sesi latar belakang, di terminal yang terhubung ke satu, di sesi atau shell tempat Anda mengirim, atau, untuk [entri worktree-guard](#write-or-command-blocked-because-the-path-cannot-be-safely-resolved) di bawah, di sesi apa pun yang terisolasi dalam worktree atau menjalankan subagent yang terisolasi worktree; di mana pesan spesifik untuk satu permukaan, entrinya mengatakan demikian.4500[Sesi latar belakang](/docs/id/agent-view) berjalan tanpa terminal interaktif mereka sendiri, jadi perintah yang membutuhkan satu berperilaku berbeda di sana. Pesan-pesan ini muncul dalam transkrip sesi latar belakang, di terminal yang terhubung ke satu, di sesi atau shell tempat Anda mengirim, atau, untuk [entri worktree-guard](#write-or-command-blocked-because-the-path-cannot-be-safely-resolved) di bawah, di sesi apa pun yang terisolasi dalam worktree atau menjalankan subagent yang terisolasi worktree; di mana pesan spesifik untuk satu surface, entrinya mengatakan demikian.
4480 4501
4481<h3 id="commands-refused-in-a-background-session">4502<h3 id="commands-refused-in-a-background-session">
4482 Perintah ditolak dalam sesi latar belakang4503 Perintah ditolak dalam sesi latar belakang
4483</h3>4504</h3>
4484 4505
4485Perintah yang membuka dialog interaktif tidak dapat melakukannya saat tidak ada terminal yang terhubung ke sesi latar belakang. `/install-github-app`, daftar pengaturan `/mcp`, dan tindakan autentikasi dalam menu server MCP merespons dengan pesan. Untuk `/install-github-app` dan daftar pengaturan `/mcp`, sesi juga muncul di bawah **Needs input** dalam [tampilan agen](/docs/id/agent-view) sehingga Anda dapat menemukannya, melampirkan, dan menjalankan perintah lagi. Saat terminal terhubung, perintah-perintah ini berfungsi secara normal.4506Perintah yang membuka dialog interaktif tidak dapat melakukannya saat tidak ada terminal yang terhubung ke sesi latar belakang. `/install-github-app`, daftar pengaturan `/mcp`, dan tindakan autentikasi dalam menu server MCP merespons dengan pesan. Untuk `/install-github-app` dan daftar pengaturan `/mcp`, sesi juga muncul di bawah **Needs input** dalam [tampilan agent](/docs/id/agent-view) sehingga Anda dapat menemukannya, melampirkan, dan menjalankan perintah lagi. Saat terminal terhubung, perintah-perintah ini berfungsi secara normal.
4486 4507
4487Sebelum v2.1.216, sesi tidak muncul di bawah **Needs input** setelah `/install-github-app` atau daftar pengaturan `/mcp` ditolak. Di v2.1.213 hingga v2.1.215, perintah masih berfungsi saat terminal terhubung, dan pesan penolakan memberi tahu Anda untuk melampirkan dan menjalankan perintah lagi. Dari v2.1.208 hingga v2.1.212, Claude Code menolaknya bahkan saat terminal terhubung, dengan pesan seperti `Can't open MCP settings in a background session`; pada versi tersebut, jalankan perintah dari sesi `claude` biasa sebagai gantinya, atau tingkatkan. Sebelum v2.1.208, mereka membuka dialog mereka di dalam sesi latar belakang. Di v2.1.208 saja, Claude Code juga menolak pemilih `/model` dalam sesi latar belakang, dan `/upgrade` mencetak URL upgrade alih-alih membuka browser.4508Sebelum v2.1.216, sesi tidak muncul di bawah **Needs input** setelah `/install-github-app` atau daftar pengaturan `/mcp` ditolak. Di v2.1.213 hingga v2.1.215, perintah masih berfungsi saat terminal terhubung, dan pesan penolakan memberi tahu Anda untuk melampirkan dan menjalankan perintah lagi. Dari v2.1.208 hingga v2.1.212, Claude Code menolaknya bahkan saat terminal terhubung, dengan pesan seperti `Can't open MCP settings in a background session`; pada versi tersebut, jalankan perintah dari sesi `claude` biasa sebagai gantinya, atau tingkatkan. Sebelum v2.1.208, mereka membuka dialog mereka di dalam sesi latar belakang. Di v2.1.208 saja, Claude Code juga menolak pemilih `/model` dalam sesi latar belakang, dan `/upgrade` mencetak URL upgrade alih-alih membuka browser.
4488 4509
4494 4515
4495**Yang harus dilakukan:**4516**Yang harus dilakukan:**
4496 4517
4497* Lampirkan ke sesi dari tampilan agen dan jalankan perintah lagi4518* Lampirkan ke sesi dari tampilan agent dan jalankan perintah lagi
4498* Atau gunakan formulir yang dinamai pesan, seperti `/mcp reconnect <server>`, `/mcp enable`, atau `/mcp disable`, yang berfungsi tanpa melampirkan4519* Atau gunakan formulir yang dinamai pesan, seperti `/mcp reconnect <server>`, `/mcp enable`, atau `/mcp disable`, yang berfungsi tanpa melampirkan
4499 4520
4500<h3 id="write-or-command-blocked-because-the-path-cannot-be-safely-resolved">4521<h3 id="write-or-command-blocked-because-the-path-cannot-be-safely-resolved">
4511 4532
4512**Yang harus dilakukan:**4533**Yang harus dilakukan:**
4513 4534
4514* Biasanya tidak ada: pesan lengkap masuk ke Claude sebagai kesalahan alat, dan Claude mencoba lagi dengan jalur langsung yang dinamainya. Untuk pengeditan file yang diblokir, tampilan percakapan menampilkan hanya baris `Error editing file` pendek; pesan lengkap muncul dalam tampilan transkrip, yang Anda buka dengan `Ctrl+O`. Perintah yang diblokir mencetaknya dalam output perintahnya.4535* Biasanya tidak ada: pesan lengkap masuk ke Claude sebagai kesalahan tool, dan Claude mencoba lagi dengan jalur langsung yang dinamainya. Untuk pengeditan file yang diblokir, tampilan percakapan menampilkan hanya baris `Error editing file` pendek; pesan lengkap muncul dalam tampilan transkrip, yang Anda buka dengan `Ctrl+O`. Perintah yang diblokir mencetaknya dalam output perintahnya.
4515* Jika blokir berulang pada file yang sama, jalur kemungkinan besar berjalan melalui symlink yang berkomitmen yang targetnya berisi `..`, seperti `docs/current -> ../README.md`; minta Claude untuk mengedit file target dengan jalur sebenarnya alih-alih melalui tautan4536* Jika blokir berulang pada file yang sama, jalur kemungkinan besar berjalan melalui symlink yang di-commit yang targetnya berisi `..`, seperti `docs/current -> ../README.md`; minta Claude untuk mengedit file target dengan jalur sebenarnya alih-alih melalui tautan
4516 4537
4517<h3 id="write-or-command-blocked-because-the-path-names-a-network-location">4538<h3 id="write-or-command-blocked-because-the-path-names-a-network-location">
4518 Penulisan atau perintah diblokir karena jalur menamai lokasi jaringan4539 Penulisan atau perintah diblokir karena jalur menamai lokasi jaringan
4561This session has no saved transcript — it was stopped before its first response finished. If it was backgrounded from another conversation, that one is still intact; `claude respawn <id>` starts this one fresh.4582This session has no saved transcript — it was stopped before its first response finished. If it was backgrounded from another conversation, that one is still intact; `claude respawn <id>` starts this one fresh.
4562```4583```
4563 4584
4564Membuka baris sesi yang sama dalam [tampilan agen](/docs/id/agent-view) menampilkan `Press enter again to restart this session fresh` di bawah daftar sebagai gantinya, dan `Enter` kedua pada baris memulai ulang sesi dengan percakapan kosong. Sebelum v2.1.212, membuka baris yang dihentikan menampilkan pesan penolakan tanpa cara untuk memulai ulang dari tampilan agen. Sebelum v2.1.211, membuka sesi yang dihentikan secara diam-diam memulai percakapan kosong itu dan dapat menjalankan kembali prompt asli sesi.4585Membuka baris sesi yang sama dalam [tampilan agent](/docs/id/agent-view) menampilkan `Press enter again to restart this session fresh` di bawah daftar sebagai gantinya, dan `Enter` kedua pada baris memulai ulang sesi dengan percakapan kosong. Sebelum v2.1.212, membuka baris yang dihentikan menampilkan pesan penolakan tanpa cara untuk memulai ulang dari tampilan agent. Sebelum v2.1.211, membuka sesi yang dihentikan secara diam-diam memulai percakapan kosong itu dan dapat menjalankan kembali prompt asli sesi.
4565 4586
4566**Yang harus dilakukan:**4587**Yang harus dilakukan:**
4567 4588
4568* Percakapan yang Anda latarbelakangkan masih utuh: lanjutkan dengan [`claude --resume`](/docs/id/sessions) atau terus bekerja di dalamnya4589* Percakapan yang Anda latarbelakangkan masih utuh: lanjutkan dengan [`claude --resume`](/docs/id/sessions) atau terus bekerja di dalamnya
4569* Untuk memulai sesi yang dihentikan segar bagaimanapun, jalankan `claude respawn <id>` dengan ID dari pesan, atau tekan `Enter` dua kali pada barisnya dalam tampilan agen4590* Untuk memulai sesi yang dihentikan segar bagaimanapun, jalankan `claude respawn <id>` dengan ID dari pesan, atau tekan `Enter` dua kali pada barisnya dalam tampilan agent
4570* Jika sesi memang menyelesaikan respons dan Anda masih melihat penolakan ini pada versi sebelum v2.1.214, folder yang tidak dapat dibaca di `~/.claude/projects` dapat membuat pemindaian transkrip melewatkan percakapan yang disimpan; perbarui ke v2.1.214 atau lebih baru, yang mentoleransi folder yang tidak dapat dibaca selama pemindaian4591* Jika sesi memang menyelesaikan respons dan Anda masih melihat penolakan ini pada versi sebelum v2.1.214, folder yang tidak dapat dibaca di `~/.claude/projects` dapat membuat pemindaian transkrip melewatkan percakapan yang disimpan; perbarui ke v2.1.214 atau lebih baru, yang mentoleransi folder yang tidak dapat dibaca selama pemindaian
4571 4592
4572<h3 id="this-session-is-running-in-another-terminal">4593<h3 id="this-session-is-running-in-another-terminal">
4573 Sesi ini berjalan di terminal lain4594 Sesi ini berjalan di terminal lain
4574</h3>4595</h3>
4575 4596
4576Anda membuka baris sesi yang dihentikan dalam [tampilan agen](/docs/id/agent-view), dan percakapan yang disimpannya sudah terbuka dalam proses Claude Code langsung lain di mesin ini, jadi Claude Code menolak untuk memulai proses kedua yang akan menulis ke transkrip yang sama. Pesan mana yang Anda lihat tergantung pada [apa yang memegang percakapan](/docs/id/agent-view#opening-a-session-says-the-conversation-is-already-open):4597Anda membuka baris sesi yang dihentikan dalam [tampilan agent](/docs/id/agent-view), dan percakapan yang disimpannya sudah terbuka dalam proses Claude Code langsung lain di mesin ini, jadi Claude Code menolak untuk memulai proses kedua yang akan menulis ke transkrip yang sama. Pesan mana yang Anda lihat tergantung pada [apa yang memegang percakapan](/docs/id/agent-view#opening-a-session-says-the-conversation-is-already-open):
4577 4598
4578```text theme={null}4599```text theme={null}
4579Can't open — this session is running in another terminal4600Can't open — this session is running in another terminal
4601This session's saved conversation is no longer on disk (it ended while the background service was off, and old transcripts are cleaned up), so there is nothing to resume. `claude rm 7c5dcf5d` deletes the row; `claude respawn 7c5dcf5d` runs its original prompt again instead.4622This session's saved conversation is no longer on disk (it ended while the background service was off, and old transcripts are cleaned up), so there is nothing to resume. `claude rm 7c5dcf5d` deletes the row; `claude respawn 7c5dcf5d` runs its original prompt again instead.
4602```4623```
4603 4624
4604`claude attach <id>` mencetak teks ini. Dalam tampilan agen, footer lebih pendek dan berakhir dengan `ctrl+x deletes the row`.4625`claude attach <id>` mencetak teks ini. Dalam tampilan agent, footer lebih pendek dan berakhir dengan `ctrl+x deletes the row`.
4605 4626
4606**Yang harus dilakukan:**4627**Yang harus dilakukan:**
4607 4628
4611Sebelum v2.1.248, membuka baris seperti itu menjalankan kembali prompt asli sesi alih-alih menolak, menarik tugas yang berusia berminggu-minggu kembali ke latar depan.4632Sebelum v2.1.248, membuka baris seperti itu menjalankan kembali prompt asli sesi alih-alih menolak, menarik tugas yang berusia berminggu-minggu kembali ke latar depan.
4612 4633
4613<h3 id="worktree-has-commits-that-are-not-pushed-anywhere">4634<h3 id="worktree-has-commits-that-are-not-pushed-anywhere">
4614 Worktree memiliki komitmen yang tidak didorong ke mana pun4635 Worktree memiliki commit yang tidak didorong ke mana pun
4615</h3>4636</h3>
4616 4637
4617Anda mencoba menghapus [sesi latar belakang](/docs/id/agent-view#what-deleting-a-session-removes) yang worktree-nya menyimpan komitmen yang Claude Code tidak dapat memastikan disimpan di tempat lain. Claude Code menyimpan worktree dan baris sesi daripada menghancurkan komitmen yang tidak terlihat. `claude rm` menamai cabang dan komitmen yang tidak didorong, dan mengatakan cara melanjutkan:4638Anda mencoba menghapus [sesi latar belakang](/docs/id/agent-view#what-deleting-a-session-removes) yang worktree-nya menyimpan commit yang Claude Code tidak dapat memastikan disimpan di tempat lain. Claude Code menyimpan worktree dan baris sesi daripada menghancurkan commit yang tidak terlihat. `claude rm` menamai branch dan commit yang tidak didorong, dan mengatakan cara melanjutkan:
4618 4639
4619```text theme={null}4640```text theme={null}
4620kept 7c5dcf5d — its worktree is still at "/home/you/project/.claude/worktrees/fix-login"4641kept 7c5dcf5d — its worktree is still at “/home/you/project/.claude/worktrees/fix-login”
4621 2 unpushed commits on "claude/fix-login": a1b2c3d "Fix login flow" and 1 more. They exist on no remote, so deleting the worktree would lose them.4642 2 unpushed commits on “claude/fix-login”: a1b2c3d “Fix login flow” and 1 more. They exist on no remote, so deleting the worktree would lose them.
4622 push them and run 'claude rm 7c5dcf5d' again, or discard the worktree and its commits: claude rm 7c5dcf5d --discard-unpushed a1b2c3d000000000000000000000000000000000@0123456789abcdef0123456789abcdef4643 push them and run 'claude rm 7c5dcf5d' again, or discard the worktree and its commits: claude rm 7c5dcf5d --discard-unpushed a1b2c3d000000000000000000000000000000000@0123456789abcdef0123456789abcdef
4623```4644```
4624 4645
4625Ketika Claude Code tidak dapat merangkum komitmen, baris detail berbunyi `The worktree has unpushed commits` sebagai gantinya. Dalam [tampilan agen](/docs/id/agent-view), baris sesi menampilkan `not deleted` dengan alasan yang sama.4646Ketika Claude Code tidak dapat merangkum commit, baris detail berbunyi `The worktree has unpushed commits` sebagai gantinya. Dalam [tampilan agent](/docs/id/agent-view), baris sesi menampilkan `not deleted` dengan alasan yang sama.
4626 4647
4627Komitmen pada remote tidak memblokir penghapusan. Begitu juga komitmen pada salinan lokal cabang default remote `origin` Anda, selama cabang itu diperiksa dalam checkout utama Anda, direktori repositori itu sendiri daripada worktree.4648Commit pada remote tidak memblokir penghapusan. Begitu juga commit pada salinan lokal branch default remote `origin` Anda, selama branch itu diperiksa dalam checkout utama Anda, direktori repositori itu sendiri daripada worktree.
4628 4649
4629**Yang harus dilakukan:**4650**Yang harus dilakukan:**
4630 4651
4631* Untuk menyimpan komitmen, dorong cabang worktree, atau gabungkan ke dalam cabang default yang diperiksa dalam checkout utama Anda, kemudian hapus sesi lagi4652* Untuk menyimpan commit, dorong branch worktree, atau gabungkan ke dalam branch default yang diperiksa dalam checkout utama Anda, kemudian hapus sesi lagi
4632* Untuk membuang komitmen, jalankan perintah `claude rm <id> --discard-unpushed` yang dicetak pesan, atau tekan `Ctrl+X` dua kali pada baris sesi dalam tampilan agen lagi. Ini menghapus sesi dan worktree bersama dengan cabangnya, komitmen yang tidak didorong, dan perubahan yang tidak berkomitmen. Jika worktree telah mendapatkan komitmen sejak penolakan, Claude Code menyimpannya lagi dan menampilkan status yang diperbarui4653* Untuk membuang commit, jalankan perintah `claude rm <id> --discard-unpushed` yang dicetak pesan, atau tekan `Ctrl+X` dua kali pada baris sesi dalam tampilan agent lagi. Ini menghapus sesi dan worktree bersama dengan branch-nya, commit yang tidak didorong, dan perubahan yang belum di-commit. Jika worktree telah mendapatkan commit sejak penolakan, Claude Code menyimpannya lagi dan menampilkan status yang diperbarui
4633* Ketika pesan mengatakan worktree juga dicatat oleh sesi selesai lain, menghapus lagi tidak membuangnya: dorong komitmen, kemudian hapus sesi lagi4654* Ketika pesan mengatakan worktree juga dicatat oleh sesi selesai lain, menghapus lagi tidak membuangnya: dorong commit, kemudian hapus sesi lagi
4634 4655
4635Sebelum v2.1.268, `claude rm` menempatkan ringkasan komitmen pada baris `kept` itu sendiri. Ketika `claude rm` tidak dapat merangkum komitmen, baris `kept` berbunyi `worktree has commits that are not pushed anywhere` sebagai pengganti ringkasan.4656Sebelum v2.1.268, `claude rm` menempatkan ringkasan commit pada baris `kept` itu sendiri. Ketika `claude rm` tidak dapat merangkum commit, baris `kept` berbunyi `worktree has commits that are not pushed anywhere` sebagai pengganti ringkasan.
4636 4657
4637Sebelum v2.1.260, pesan tidak menamai cabang atau komitmen, dan menghapus lagi ditolak dengan cara yang sama: menghapus sesi tanpa mendorong berarti menghapus worktree sendiri dengan `git worktree remove --force <path>`, kemudian menjalankan `claude rm <id>` lagi.4658Sebelum v2.1.260, pesan tidak menamai branch atau commit, dan menghapus lagi ditolak dengan cara yang sama: menghapus sesi tanpa mendorong berarti menghapus worktree sendiri dengan `git worktree remove --force <path>`, kemudian menjalankan `claude rm <id>` lagi.
4638 4659
4639Sebelum v2.1.248, cabang default yang diperiksa dalam checkout utama Anda tidak dihitung: cabang yang sudah Anda gabungkan di sana masih memicu penolakan ini sampai komitmennya mencapai remote.4660Sebelum v2.1.248, branch default yang diperiksa dalam checkout utama Anda tidak dihitung: branch yang sudah Anda gabungkan di sana masih memicu penolakan ini sampai commit-nya mencapai remote.
4640 4661
4641<h3 id="terminal-host-process-died">4662<h3 id="terminal-host-process-died">
4642 Proses host terminal mati4663 Proses host terminal mati
4644 4665
4645Setiap terminal [sesi latar belakang](/docs/id/agent-view) berjalan dalam proses host di bawah layanan latar belakang, dan proses itu mati saat layanan masih menyimpan koneksinya, jadi sesi tidak dapat dijangkau.4666Setiap terminal [sesi latar belakang](/docs/id/agent-view) berjalan dalam proses host di bawah layanan latar belakang, dan proses itu mati saat layanan masih menyimpan koneksinya, jadi sesi tidak dapat dijangkau.
4646 4667
4647Di Linux dan WSL, layanan latar belakang memeriksa setiap proses host setiap beberapa detik, menandai sesi gagal ketika proses telah keluar tetapi koneksinya ke layanan tidak pernah ditutup, dan menampilkan alasannya pada barisnya dalam [tampilan agen](/docs/id/agent-view#read-session-state):4668Di Linux dan WSL, layanan latar belakang memeriksa setiap proses host setiap beberapa detik, menandai sesi gagal ketika proses telah keluar tetapi koneksinya ke layanan tidak pernah ditutup, dan menampilkan alasannya pada barisnya dalam [tampilan agent](/docs/id/agent-view#read-session-state):
4648 4669
4649```text theme={null}4670```text theme={null}
4650terminal host process died — press Enter to restart4671terminal host process died — press Enter to restart
4662 4683
4663**Yang harus dilakukan:**4684**Yang harus dilakukan:**
4664 4685
4665* Dalam tampilan agen, tekan `Enter` pada baris yang gagal; sesi dimulai ulang pada proses host segar dan percakapan dilanjutkan4686* Dalam tampilan agent, tekan `Enter` pada baris yang gagal; sesi dimulai ulang pada proses host segar dan percakapan dilanjutkan
4666* Dari shell, jalankan `claude attach <id>` lagi. Claude Code mencetak `Session <id>'s terminal host died — restarting it on a fresh one…` dan membuka kembali sesi4687* Dari shell, jalankan `claude attach <id>` lagi. Claude Code mencetak `Session <id>'s terminal host died — restarting it on a fresh one…` dan membuka kembali sesi
4667* Anda tidak dapat memulai ulang baris perintah shell dengan cara ini; kirim perintah lagi untuk menjalankannya kembali4688* Anda tidak dapat memulai ulang baris perintah shell dengan cara ini; kirim perintah lagi untuk menjalankannya kembali
4668 4689
4674 4695
4675Anda membuka [sesi latar belakang](/docs/id/agent-view) dan layanan latar belakang menerima pembukaan, tetapi tidak ada output yang tiba selama sekitar sepuluh detik, jadi Claude Code menyimpulkan bahwa proses yang menyampaikan terminal sesi tidak dapat memberikan output, dan mengakhiri upaya alih-alih menunggu.4696Anda membuka [sesi latar belakang](/docs/id/agent-view) dan layanan latar belakang menerima pembukaan, tetapi tidak ada output yang tiba selama sekitar sepuluh detik, jadi Claude Code menyimpulkan bahwa proses yang menyampaikan terminal sesi tidak dapat memberikan output, dan mengakhiri upaya alih-alih menunggu.
4676 4697
4677Dalam tampilan agen, Claude Code menawarkan restart dalam footer:4698Dalam tampilan agent, Claude Code menawarkan restart dalam footer:
4678 4699
4679```text theme={null}4700```text theme={null}
4680Press enter again to restart this session — it isn't responding (its conversation is saved and resumes).4701Press enter again to restart this session — it isn't responding (its conversation is saved and resumes).
4690 4711
4691**Yang harus dilakukan:**4712**Yang harus dilakukan:**
4692 4713
4693* Dalam tampilan agen, tekan `Enter` pada baris yang sama lagi. Claude Code menghentikan proses yang tidak responsif dan memulai ulang sesi, dan percakapan dilanjutkan. Tidak ada yang dihentikan tanpa tekan kedua itu4714* Dalam tampilan agent, tekan `Enter` pada baris yang sama lagi. Claude Code menghentikan proses yang tidak responsif dan memulai ulang sesi, dan percakapan dilanjutkan. Tidak ada yang dihentikan tanpa tekan kedua itu
4694* Dari shell, jalankan `claude stop <id>`, kemudian `claude attach <id>`4715* Dari shell, jalankan `claude stop <id>`, kemudian `claude attach <id>`
4695* Untuk baris perintah shell, tekan `Ctrl+X` dalam tampilan agen atau jalankan `claude stop <id>` untuk menghentikannya; kirim perintah lagi untuk menjalankannya kembali4716* Untuk baris perintah shell, tekan `Ctrl+X` dalam tampilan agent atau jalankan `claude stop <id>` untuk menghentikannya; kirim perintah lagi untuk menjalankannya kembali
4696 4717
4697<h3 id="session-was-stopped-while-the-respawn-was-in-flight">4718<h3 id="session-was-stopped-while-the-respawn-was-in-flight">
4698 Sesi dihentikan saat respawn sedang dalam perjalanan4719 Sesi dihentikan saat respawn sedang dalam perjalanan
4708 4729
4709**Yang harus dilakukan:**4730**Yang harus dilakukan:**
4710 4731
4711* Jika Anda tidak menghentikan sesi, buka barisnya lagi dalam tampilan agen atau jalankan `claude respawn <id>` untuk memulainya kembali4732* Jika Anda tidak menghentikan sesi, buka barisnya lagi dalam tampilan agent atau jalankan `claude respawn <id>` untuk memulainya kembali
4712* Jika Anda menghentikannya sendiri, tidak ada yang tersisa untuk dilakukan: sesi tetap dihentikan4733* Jika Anda menghentikannya sendiri, tidak ada yang tersisa untuk dilakukan: sesi tetap dihentikan
4713 4734
4714<h3 id="session-agent-no-longer-available">4735<h3 id="session-agent-no-longer-available">
4715 Agen sesi tidak lagi tersedia4736 Agent sesi tidak lagi tersedia
4716</h3>4737</h3>
4717 4738
4718Anda melanjutkan sesi yang menjalankan [agen khusus](/docs/id/sub-agents#invoke-subagents-explicitly), dimulai dengan `--agent` atau pengaturan `agent`, dan Claude Code tidak menemukan agen dengan nama itu. Ini mencari direktori asli sesi terlebih dahulu, ketika Anda telah [mempercayai ruang kerja itu](/docs/id/permissions#project-allow-rules-and-workspace-trust), kemudian direktori tempat Anda melanjutkan. Sesi masih dilanjutkan, tetapi dengan alat default, jadi pembatasan alat agen tidak lagi berlaku:4739Anda melanjutkan sesi yang menjalankan [agent khusus](/docs/id/sub-agents#invoke-subagents-explicitly), dimulai dengan `--agent` atau pengaturan `agent`, dan Claude Code tidak menemukan agent dengan nama itu. Ini mencari direktori asli sesi terlebih dahulu, ketika Anda telah [mempercayai workspace itu](/docs/id/permissions#project-allow-rules-and-workspace-trust), kemudian direktori tempat Anda melanjutkan. Sesi masih dilanjutkan, tetapi dengan tool default, jadi pembatasan tool agent tidak lagi berlaku:
4719 4740
4720```text theme={null}4741```text theme={null}
4721This session was running agent 'code-reviewer', which is no longer available (no agent by that name in /home/you/project). Continuing with the default tools and system prompt — the agent's tool restrictions no longer apply. To restore it, re-create the agent, or resume with an explicit --agent <name>.4742This session was running agent 'code-reviewer', which is no longer available (no agent by that name in /home/you/project). Continuing with the default tools and system prompt — the agent's tool restrictions no longer apply. To restore it, re-create the agent, or resume with an explicit --agent <name>.
4722```4743```
4723 4744
4724Peringatan hanya menamai direktori yang Claude Code cari, dan muncul dalam percakapan yang dilanjutkan apakah Anda membangunkan [sesi latar belakang](/docs/id/agent-view), menjalankan `/resume` atau `claude --resume`, atau melanjutkan dalam [mode non-interaktif](/docs/id/headless), di mana ia juga masuk ke stderr. Sesi menggunakan `--input-format stream-json` tidak menampilkannya, karena Agent SDK menyediakan agen setelah startup.4745Peringatan hanya menamai direktori yang Claude Code cari, dan muncul dalam percakapan yang dilanjutkan apakah Anda membangunkan [sesi latar belakang](/docs/id/agent-view), menjalankan `/resume` atau `claude --resume`, atau melanjutkan dalam [mode non-interaktif](/docs/id/headless), di mana ia juga masuk ke stderr. Sesi menggunakan `--input-format stream-json` tidak menampilkannya, karena Agent SDK menyediakan agent setelah startup.
4725 4746
4726Claude Code tidak menyimpan fallback ke sesi, jadi peringatan berulang pada setiap resume sampai Anda bertindak. Agen `claude` bawaan tidak memicu peringatan, karena jatuh kembali ke set alat default tidak mengubah apa pun untuk itu. Sebelum v2.1.216, Claude Code secara diam-diam melanjutkan sebagai agen default, dan pencarian mencakup hanya direktori tempat Anda melanjutkan, jadi agen yang bersifat proyek hilang pada resume apa pun dari direktori lain.4747Claude Code tidak menyimpan fallback ke sesi, jadi peringatan berulang pada setiap resume sampai Anda bertindak. Agent `claude` bawaan tidak memicu peringatan, karena jatuh kembali ke set tool default tidak mengubah apa pun untuk itu. Sebelum v2.1.216, Claude Code secara diam-diam melanjutkan sebagai agent default, dan pencarian mencakup hanya direktori tempat Anda melanjutkan, jadi agent yang bersifat proyek hilang pada resume apa pun dari direktori lain.
4727 4748
4728**Yang harus dilakukan:**4749**Yang harus dilakukan:**
4729 4750
4730* Buat ulang file agen di `.claude/agents/<name>.md` dalam proyek sesi, atau di `~/.claude/agents/<name>.md` untuk agen pribadi, kemudian lanjutkan lagi4751* Buat ulang file agent di `.claude/agents/<name>.md` dalam proyek sesi, atau di `~/.claude/agents/<name>.md` untuk agent pribadi, kemudian lanjutkan lagi
4731* Atau lanjutkan dengan `--agent <name>` yang menamai agen yang memang ada, untuk menjalankan sesi sebagai agen itu sebagai gantinya4752* Atau lanjutkan dengan `--agent <name>` yang menamai agent yang memang ada, untuk menjalankan sesi sebagai agent itu sebagai gantinya
4732* Jika agen bersifat proyek dan Anda belum mempercayai direktori asli sesi, jalankan Claude Code di sana sekali, terima dialog kepercayaan, kemudian lanjutkan lagi4753* Jika agent bersifat proyek dan Anda belum mempercayai direktori asli sesi, jalankan Claude Code di sana sekali, terima dialog kepercayaan, kemudian lanjutkan lagi
4733 4754
4734<h3 id="claude_code_process_wrapper-launcher-errors">4755<h3 id="claude_code_process_wrapper-launcher-errors">
4735 Kesalahan peluncur CLAUDE\_CODE\_PROCESS\_WRAPPER4756 Kesalahan peluncur CLAUDE\_CODE\_PROCESS\_WRAPPER
4741CLAUDE_CODE_PROCESS_WRAPPER: launcher `/opt/corp/launcher` is not an executable regular file4762CLAUDE_CODE_PROCESS_WRAPPER: launcher `/opt/corp/launcher` is not an executable regular file
4742```4763```
4743 4764
4744Peluncur yang dimulai tetapi keluar tanpa mengganti dirinya dengan Claude Code gagal sesi yang dimulainya, dan baris sesi dalam tampilan agen melaporkan bahwa peluncur `must exec, not daemonize`, diikuti oleh apa pun yang dicetak peluncur. Sesi yang tidak dapat dimulai atau menjangkau layanan latar belakang karena peluncur melaporkan masalah peluncur sebagai alasan di dalam `Couldn't reach the background service (...)`.4765Peluncur yang dimulai tetapi keluar tanpa mengganti dirinya dengan Claude Code gagal sesi yang dimulainya, dan baris sesi dalam tampilan agent melaporkan bahwa peluncur `must exec, not daemonize`, diikuti oleh apa pun yang dicetak peluncur. Sesi yang tidak dapat dimulai atau menjangkau layanan latar belakang karena peluncur melaporkan masalah peluncur sebagai alasan di dalam `Couldn't reach the background service (...)`.
4745 4766
4746**Yang harus dilakukan:**4767**Yang harus dilakukan:**
4747 4768
4778 EACCES saat memulai sesi latar belakang4799 EACCES saat memulai sesi latar belakang
4779</h3>4800</h3>
4780 4801
4781Claude Code tidak dapat menjalankan binernya sendiri untuk memulai [layanan latar belakang](/docs/id/agent-view#the-supervisor-process) yang menyelenggarakan sesi latar belakang. Pada instalasi npm, ini biasanya berarti `npm install -g @anthropic-ai/claude-code` mengganti biner pada saat itu, apakah Anda menjalankannya atau [auto-updater](/docs/id/setup#auto-updates) melakukannya. Kesalahan muncul ketika Anda membuka sesi dari [tampilan agen](/docs/id/agent-view):4802Claude Code tidak dapat menjalankan binernya sendiri untuk memulai [layanan latar belakang](/docs/id/agent-view#the-supervisor-process) yang menyelenggarakan sesi latar belakang. Pada instalasi npm, ini biasanya berarti `npm install -g @anthropic-ai/claude-code` mengganti biner pada saat itu, apakah Anda menjalankannya atau [auto-updater](/docs/id/setup#auto-updates) melakukannya. Kesalahan muncul ketika Anda membuka sesi dari [tampilan agent](/docs/id/agent-view):
4782 4803
4783```text theme={null}4804```text theme={null}
4784Couldn't start the background service — spawn background service: EACCES: permission denied, posix_spawn '/usr/local/lib/node_modules/@anthropic-ai/claude-code/bin/claude'4805Couldn't start the background service — spawn background service: EACCES: permission denied, posix_spawn '/usr/local/lib/node_modules/@anthropic-ai/claude-code/bin/claude'
4797**Yang harus dilakukan:**4818**Yang harus dilakukan:**
4798 4819
4799* Tunggu beberapa detik, kemudian buka sesi atau kirim lagi. Ketika pesan mengatakan Claude Code sedang diperbarui, coba lagi setelah pembaruan selesai.4820* Tunggu beberapa detik, kemudian buka sesi atau kirim lagi. Ketika pesan mengatakan Claude Code sedang diperbarui, coba lagi setelah pembaruan selesai.
4800* Jika kesalahan bertahan saat tidak ada instalasi npm yang berjalan, pengguna Anda tidak dapat menjalankan biner yang diinstal. Periksa izinnya dan direktorinya, atau instal ulang Claude Code.4821* Jika kesalahan bertahan saat tidak ada instalasi npm yang berjalan, pengguna Anda tidak dapat menjalankan biner yang diinstal. Periksa hak aksesnya dan direktorinya, atau instal ulang Claude Code.
4801 4822
4802<h3 id="background-service-exited-before-it-became-reachable">4823<h3 id="background-service-exited-before-it-became-reachable">
4803 Layanan latar belakang keluar sebelum dapat dijangkau4824 Layanan latar belakang keluar sebelum dapat dijangkau
4804</h3>4825</h3>
4805 4826
4806Proses yang Claude Code mulai sebagai [layanan latar belakang](/docs/id/agent-view#the-supervisor-process) keluar sebelum menerima koneksi, jadi Claude Code tidak dapat membuka sesi Anda. Ketika layanan mencetak kesalahan sebelum keluar, alasan dalam tanda kurung memberikan kode keluar atau sinyal dan baris pertama yang dicetak layanan, yang menamai apa yang menghentikannya:4827Proses yang Claude Code mulai sebagai [layanan latar belakang](/docs/id/agent-view#the-supervisor-process) keluar sebelum menerima koneksi, jadi Claude Code tidak dapat membuka sesi Anda. Ketika layanan mencetak kesalahan sebelum keluar, alasan dalam tanda kurung memberikan exit code atau sinyal dan baris pertama yang dicetak layanan, yang menamai apa yang menghentikannya:
4807 4828
4808```text theme={null}4829```text theme={null}
4809Couldn't reach the background service (background service exited before it became reachable (exit code N): <the service's first error line>) — run 'claude daemon status'4830Couldn't reach the background service (background service exited before it became reachable (exit code N): <the service's first error line>) — run 'claude daemon status'
4810```4831```
4811 4832
4812Ketika Anda membuka sesi dari [tampilan agen](/docs/id/agent-view), alasan yang sama mengikuti `Couldn't start the background service —`. Ketika layanan tidak mencetak apa pun sebelum keluar, pesan mengatakan `nothing on stderr` sebagai gantinya.4833Ketika Anda membuka sesi dari [tampilan agent](/docs/id/agent-view), alasan yang sama mengikuti `Couldn't start the background service —`. Ketika layanan tidak mencetak apa pun sebelum keluar, pesan mengatakan `nothing on stderr` sebagai gantinya.
4813 4834
4814Claude Code melaporkan kegagalan dengan baris kesalahan layanan. Sebelum v2.1.246, kegagalan muncul hanya setelah menunggu 45 detik, sebagai `background service did not become reachable within 45s`, tanpa baris kesalahan layanan.4835Claude Code melaporkan kegagalan dengan baris kesalahan layanan. Sebelum v2.1.246, kegagalan muncul hanya setelah menunggu 45 detik, sebagai `background service did not become reachable within 45s`, tanpa baris kesalahan layanan.
4815 4836
4816Dua alasan yang dikutip memiliki penyebab yang diketahui:4837Dua alasan yang dikutip memiliki penyebab yang diketahui:
4817 4838
4818* `Error: claude native binary not installed.`: instalasi npm mengganti biner Claude Code pada saat itu, jadi layanan menjalankan placeholder npm sebagai gantinya. Coba lagi setelah instalasi selesai; jika baris bertahan tanpa instalasi yang berjalan, [selesaikan instalasi npm](/docs/id/troubleshoot-install#native-binary-not-found-after-npm-install). Sebelum v2.1.257, pembaruan diri npm macOS menghasilkan kegagalan ini pada setiap awal selama jendela instalasi.4839* `Error: claude native binary not installed.`: instalasi npm mengganti biner Claude Code pada saat itu, jadi layanan menjalankan placeholder npm sebagai gantinya. Coba lagi setelah instalasi selesai; jika baris bertahan tanpa instalasi yang berjalan, [selesaikan instalasi npm](/docs/id/troubleshoot-install#native-binary-not-found-after-npm-install). Sebelum v2.1.257, pembaruan diri npm macOS menghasilkan kegagalan ini pada setiap awal selama jendela instalasi.
4819* `nothing on stderr` dengan kode keluar 1, pada setiap awal, di Windows: `daemon.lock` menamai proses yang Claude Code tidak dapat menandai atau membuktikan hilang, jadi setiap layanan baru menyimpulkan yang lain menyimpan kunci dan keluar. Kunci yang penulis Claude Code dapat membuktikan hilang diganti sendiri dan tidak menghasilkan kegagalan ini. Ketika kegagalan berulang pada setiap awal, hapus `~/.claude/daemon.lock`, kemudian buka sesi atau kirim lagi. Sebelum v2.1.257, kunci seperti itu memblokir setiap awal sampai Anda menghapus file.4840* `nothing on stderr` dengan exit code 1, pada setiap awal, di Windows: `daemon.lock` menamai proses yang Claude Code tidak dapat menandai atau membuktikan hilang, jadi setiap layanan baru menyimpulkan yang lain menyimpan kunci dan keluar. Kunci yang penulis Claude Code dapat membuktikan hilang diganti sendiri dan tidak menghasilkan kegagalan ini. Ketika kegagalan berulang pada setiap awal, hapus `~/.claude/daemon.lock`, kemudian buka sesi atau kirim lagi. Sebelum v2.1.257, kunci seperti itu memblokir setiap awal sampai Anda menghapus file.
4820 4841
4821**Yang harus dilakukan:**4842**Yang harus dilakukan:**
4822 4843
4833Couldn't start a background session (working directory no longer exists or is not accessible: /tmp/demo)4854Couldn't start a background session (working directory no longer exists or is not accessible: /tmp/demo)
4834```4855```
4835 4856
4836Sebelum v2.1.257, sesi tampak dimulai dan kemudian ditampilkan dalam tampilan agen sebagai baris yang gagal dengan alasan yang sama.4857Sebelum v2.1.257, sesi tampak dimulai dan kemudian ditampilkan dalam tampilan agent sebagai baris yang gagal dengan alasan yang sama.
4837 4858
4838Sebelum v2.1.281, pesan ini juga muncul ketika direktori sudah hilang sebelum Anda memulai sesi. Kasus itu melaporkan [`could not be resolved on disk`](#workspace-not-trusted-when-dispatching-a-background-session).4859Sebelum v2.1.281, pesan ini juga muncul ketika direktori sudah hilang sebelum Anda memulai sesi. Kasus itu melaporkan [`could not be resolved on disk`](#workspace-not-trusted-when-dispatching-a-background-session).
4839 4860
4842* Buat ulang direktori yang dinamai pesan, atau kirim dari direktori yang ada, kemudian coba lagi4863* Buat ulang direktori yang dinamai pesan, atau kirim dari direktori yang ada, kemudian coba lagi
4843 4864
4844<h3 id="workspace-not-trusted-when-dispatching-a-background-session">4865<h3 id="workspace-not-trusted-when-dispatching-a-background-session">
4845 Ruang kerja tidak dipercaya saat mengirim sesi latar belakang4866 Workspace tidak dipercaya saat mengirim sesi latar belakang
4846</h3>4867</h3>
4847 4868
4848Anda memulai atau memulai ulang [sesi latar belakang](/docs/id/agent-view) dalam direktori yang belum Anda [percayai](/docs/id/permissions#project-allow-rules-and-workspace-trust), dan dialog kepercayaan ruang kerja tidak dapat muncul untuk bertanya. Claude Code tidak memulai sesi:4869Anda memulai atau memulai ulang [sesi latar belakang](/docs/id/agent-view) dalam direktori yang belum Anda [percayai](/docs/id/permissions#project-allow-rules-and-workspace-trust), dan dialog kepercayaan workspace tidak dapat muncul untuk bertanya. Claude Code tidak memulai sesi:
4849 4870
4850```text theme={null}4871```text theme={null}
4851Workspace not trusted. Run `claude` in /path/to/project once and accept the trust prompt, then retry.4872Workspace not trusted. Run `claude` in /path/to/project once and accept the trust prompt, then retry.
4858* **`The home directory is trusted one session at a time`**: direktori sesi adalah direktori home Anda. Claude Code tidak pernah menyimpan kepercayaan untuk direktori home, jadi menerima dialog di sana dalam sesi sebelumnya tidak dihitung.4879* **`The home directory is trusted one session at a time`**: direktori sesi adalah direktori home Anda. Claude Code tidak pernah menyimpan kepercayaan untuk direktori home, jadi menerima dialog di sana dalam sesi sebelumnya tidak dihitung.
4859* **`<path> could not be resolved on disk`**: Claude Code tidak dapat menemukan direktori sesi di disk.4880* **`<path> could not be resolved on disk`**: Claude Code tidak dapat menemukan direktori sesi di disk.
4860 4881
4882Sebelum v2.1.286, di Windows, pesan ini juga dapat muncul di direktori yang sudah Anda percayai, jika catatan kepercayaannya disimpan dengan jalur dalam huruf besar/kecil yang berbeda. Perbarui ke v2.1.286 atau lebih baru.
4883
4861**Yang harus dilakukan:**4884**Yang harus dilakukan:**
4862 4885
4863* Jalankan `claude` di direktori yang dinamai pesan dan terima dialog kepercayaan, kemudian jalankan perintah lagi4886* Jalankan `claude` di direktori yang dinamai pesan dan terima dialog kepercayaan, kemudian jalankan perintah lagi
