21Cocokkan pesan yang Anda lihat di terminal dengan bagian di bawah ini.21Cocokkan pesan yang Anda lihat di terminal dengan bagian di bawah ini.
22 22
23| Pesan | Bagian |23| Pesan | Bagian |
24| :-------------------------------------------------------------------------------------------- | :------------------------------------------------------------------------------------------------------------------------------ |24| :------------------------------------------------------------------------------------------------- | :------------------------------------------------------------------------------------------------------------------------------ |
25| `API Error: 500 Internal server error` | [Kesalahan server](#api-error-500-internal-server-error) |25| `API Error: 500 Internal server error` | [Kesalahan server](#api-error-500-internal-server-error) |
26| `API Error: Repeated 529 Overloaded errors` | [Kesalahan server](#api-error-repeated-529-overloaded-errors) |26| `API Error: Repeated 529 Overloaded errors` | [Kesalahan server](#api-error-repeated-529-overloaded-errors) |
27| `Request timed out` | [Kesalahan server](#request-timed-out), atau [Jaringan](#unable-to-connect-to-api) jika pesan menyebutkan koneksi internet Anda |27| `Request timed out` | [Kesalahan server](#request-timed-out), atau [Jaringan](#unable-to-connect-to-api) jika pesan menyebutkan koneksi internet Anda |
39| `Not logged in · Please run /login` | [Autentikasi](#not-logged-in) |39| `Not logged in · Please run /login` | [Autentikasi](#not-logged-in) |
40| `Could not resolve authentication method` | [Autentikasi](#could-not-resolve-authentication-method) |40| `Could not resolve authentication method` | [Autentikasi](#could-not-resolve-authentication-method) |
41| `Invalid API key` | [Autentikasi](#invalid-api-key) |41| `Invalid API key` | [Autentikasi](#invalid-api-key) |
42| `Your apiKeyHelper script is failing` | [Autentikasi](#your-apikeyhelper-script-is-failing) |
42| `This organization has been disabled` | [Autentikasi](#this-organization-has-been-disabled) |43| `This organization has been disabled` | [Autentikasi](#this-organization-has-been-disabled) |
43| `Your organization has disabled API key authentication` | [Autentikasi](#your-organization-has-disabled-api-key-authentication) |44| `Your organization has disabled API key authentication` | [Autentikasi](#your-organization-has-disabled-api-key-authentication) |
44| `Your organization has disabled Claude subscription access` | [Autentikasi](#your-organization-has-disabled-claude-subscription-access) |45| `Your organization has disabled Claude subscription access` | [Autentikasi](#your-organization-has-disabled-claude-subscription-access) |
45| `Routines are disabled by your organization's policy` | [Autentikasi](#routines-are-disabled-by-your-organizations-policy) |46| `Routines are disabled by your organization's policy` | [Autentikasi](#routines-are-disabled-by-your-organizations-policy) |
46| `Remote Control is only available when using Claude via api.anthropic.com` | [Autentikasi](#remote-control-requires-the-anthropic-api) |47| `Remote Control is only available when using Claude via api.anthropic.com` | [Autentikasi](#remote-control-requires-the-anthropic-api) |
47| `OAuth token revoked` / `OAuth token has expired` | [Autentikasi](#oauth-token-revoked-or-expired) |48| `OAuth token revoked` / `OAuth token has expired` | [Autentikasi](#oauth-token-revoked-or-expired) |
49| `Login expired · Please run /login` | [Autentikasi](#login-expired) |
50| `Failed to authenticate: OAuth session expired and could not be refreshed` | [Autentikasi](#login-expired) |
48| `does not meet scope requirement user:profile` | [Autentikasi](#oauth-scope-requirement) |51| `does not meet scope requirement user:profile` | [Autentikasi](#oauth-scope-requirement) |
49| `AWS credentials expired or invalid` | [Autentikasi](#aws-credentials-expired-or-invalid) |52| `AWS credentials expired or invalid` | [Autentikasi](#aws-credentials-expired-or-invalid) |
50| `AWS authentication failed` | [Autentikasi](#aws-authentication-failed) |53| `AWS authentication failed` | [Autentikasi](#aws-authentication-failed) |
54| `AWS default-chain credential resolve timed out` | [Autentikasi](#aws-default-chain-credential-resolve-timed-out) |
51| `Unable to connect to API` | [Jaringan](#unable-to-connect-to-api) |55| `Unable to connect to API` | [Jaringan](#unable-to-connect-to-api) |
52| `Waiting for API response · will retry in` | [Percobaan ulang otomatis](#automatic-retries), atau [Jaringan](#unable-to-connect-to-api) jika terus berlanjut |56| `Waiting for API response · will retry in` | [Percobaan ulang otomatis](#automatic-retries), atau [Jaringan](#unable-to-connect-to-api) jika terus berlanjut |
57| `Bedrock streaming response has content-type "..."; expected "application/vnd.amazon.eventstream"` | [Jaringan](#bedrock-streaming-response-has-an-unexpected-content-type) |
53| `SSL certificate verification failed` | [Jaringan](#ssl-certificate-errors) |58| `SSL certificate verification failed` | [Jaringan](#ssl-certificate-errors) |
54| `SSL certificate error (...)` during login or startup | [Jaringan](#ssl-certificate-errors) |59| `SSL certificate error (...)` during login or startup | [Jaringan](#ssl-certificate-errors) |
55| `403` with `x-deny-reason: host_not_allowed` in a cloud or routine session | [Jaringan](#host-not-allowed-in-a-cloud-session) |60| `403` with `x-deny-reason: host_not_allowed` in a cloud or routine session | [Jaringan](#host-not-allowed-in-a-cloud-session) |
76| `--bg and --print conflict` | [Kesalahan baris perintah](#command-line-errors) |81| `--bg and --print conflict` | [Kesalahan baris perintah](#command-line-errors) |
77| `Error: --json-schema is not a valid JSON Schema` | [Kesalahan baris perintah](#command-line-errors) |82| `Error: --json-schema is not a valid JSON Schema` | [Kesalahan baris perintah](#command-line-errors) |
78| `Could not import <server>: <reason>` | [Kesalahan baris perintah](#could-not-import-a-server-from-claude-desktop) |83| `Could not import <server>: <reason>` | [Kesalahan baris perintah](#could-not-import-a-server-from-claude-desktop) |
84| `Error: MCP tool <name> (passed via --permission-prompt-tool) not found` | [Kesalahan baris perintah](#mcp-permission-prompt-tool-not-found) |
79| `Marketplace "<name>" is registered from an untrusted source` | [Kesalahan plugin](#marketplace-is-registered-from-an-untrusted-source) |85| `Marketplace "<name>" is registered from an untrusted source` | [Kesalahan plugin](#marketplace-is-registered-from-an-untrusted-source) |
86| `references ${user_config.*} in a shell-form command` | [Kesalahan plugin](#plugin-command-references-user-config) |
87| `Monitor "<name>" from plugin <plugin> references ${user_config.*} in its command` | [Kesalahan plugin](#plugin-command-references-user-config) |
88| `headersHelper for MCP server '<name>' references ${user_config.*}` | [Kesalahan plugin](#plugin-command-references-user-config) |
89| `would be spawned with zero tools — refusing` | [Kesalahan alat](#agent-would-be-spawned-with-zero-tools) |
90| `File is covered by a Read deny rule in your permission settings` | [Kesalahan alat](#file-is-covered-by-a-read-deny-rule) |
91| `Can't open MCP settings in a background session` | [Kesalahan sesi latar belakang](#commands-refused-in-a-background-session) |
92| `CLAUDE_CODE_PROCESS_WRAPPER: launcher ...` | [Kesalahan sesi latar belakang](#claude_code_process_wrapper-launcher-errors) |
80| `Ignoring N permissions.allow entries from ... this workspace has not been trusted` | [Peringatan konfigurasi](#workspace-has-not-been-trusted) |93| `Ignoring N permissions.allow entries from ... this workspace has not been trusted` | [Peringatan konfigurasi](#workspace-has-not-been-trusted) |
81| Responses seem lower quality than usual | [Kualitas respons](#responses-seem-lower-quality-than-usual) |94| Responses seem lower quality than usual | [Kualitas respons](#responses-seem-lower-quality-than-usual) |
82 95
86 99
87Claude Code mencoba ulang kegagalan transien sebelum menampilkan kesalahan kepada Anda. Kesalahan server, respons kelebihan beban, waktu tunggu permintaan, throttle 429 sementara, dan koneksi yang terputus semuanya dicoba ulang hingga 10 kali dengan backoff eksponensial. {/* min-version: 2.1.198 */}Mulai dari v2.1.198, ini mencakup koneksi yang terputus di tengah respons sebelum output yang terlihat telah dialirkan: Claude Code mengeluarkan kembali permintaan dengan backoff yang sama dan giliran berlanjut daripada berhenti dengan kesalahan koneksi. {/* min-version: 2.1.199 */}Mulai dari v2.1.199, throttle 429 sementara yang tidak membawa header kuota paket Anda juga dicoba ulang ketika Anda masuk dengan langganan claude.ai; versi sebelumnya hanya mencoba ulang untuk autentikasi kunci API dan Enterprise.100Claude Code mencoba ulang kegagalan transien sebelum menampilkan kesalahan kepada Anda. Kesalahan server, respons kelebihan beban, waktu tunggu permintaan, throttle 429 sementara, dan koneksi yang terputus semuanya dicoba ulang hingga 10 kali dengan backoff eksponensial. {/* min-version: 2.1.198 */}Mulai dari v2.1.198, ini mencakup koneksi yang terputus di tengah respons sebelum output yang terlihat telah dialirkan: Claude Code mengeluarkan kembali permintaan dengan backoff yang sama dan giliran berlanjut daripada berhenti dengan kesalahan koneksi. {/* min-version: 2.1.199 */}Mulai dari v2.1.199, throttle 429 sementara yang tidak membawa header kuota paket Anda juga dicoba ulang ketika Anda masuk dengan langganan claude.ai; versi sebelumnya hanya mencoba ulang untuk autentikasi kunci API dan Enterprise.
88 101
89Dua kelas kegagalan tidak dicoba ulang, karena percobaan ulang tidak dapat berhasil:102Beberapa kelas kegagalan tidak dicoba ulang, karena percobaan ulang tidak dapat berhasil:
90 103
91* {/* min-version: 2.1.199 */}Mulai dari v2.1.199, kegagalan validasi sertifikat TLS, seperti proxy yang menginspeksi TLS, bundel `NODE_EXTRA_CA_CERTS` yang hilang, atau sertifikat yang kedaluwarsa, gagal pada percobaan pertama sehingga perbaikan muncul segera daripada setelah anggaran percobaan ulang penuh. Lihat [Kesalahan sertifikat SSL](#ssl-certificate-errors). Kondisi TLS transien seperti timeout handshake masih mencoba ulang.104* {/* min-version: 2.1.199 */}Mulai dari v2.1.199, kegagalan validasi sertifikat TLS, seperti proxy yang menginspeksi TLS, bundel `NODE_EXTRA_CA_CERTS` yang hilang, atau sertifikat yang kedaluwarsa, gagal pada percobaan pertama sehingga perbaikan muncul segera daripada setelah anggaran percobaan ulang penuh. Lihat [Kesalahan sertifikat SSL](#ssl-certificate-errors). Kondisi TLS transien seperti timeout handshake masih mencoba ulang.
92* {/* min-version: 2.1.199 */}Mulai dari v2.1.199, kesalahan server yang tiba setelah Claude telah dialirkan output yang terlihat menjaga respons parsial dan menambahkan [pemberitahuan respons tidak lengkap](#the-response-above-may-be-incomplete) daripada mencoba ulang, karena menjalankan kembali permintaan dapat menjalankan panggilan alat yang sama dua kali. Versi sebelumnya membuang output parsial dan melaporkan giliran sebagai kesalahan.105* {/* min-version: 2.1.199 */}Mulai dari v2.1.199, kesalahan server yang tiba setelah Claude telah dialirkan output yang terlihat menjaga respons parsial dan menambahkan [pemberitahuan respons tidak lengkap](#the-response-above-may-be-incomplete) daripada mencoba ulang, karena menjalankan kembali permintaan dapat menjalankan alat yang sama dua kali. Versi sebelumnya membuang output parsial dan melaporkan giliran sebagai kesalahan.
106* {/* min-version: 2.1.208 */}Respons streaming [Amazon Bedrock dengan tipe konten yang tidak terduga](#bedrock-streaming-response-has-an-unexpected-content-type) gagal pada percobaan pertama, karena gateway atau proxy yang menulis ulang respons akan menulis ulang percobaan ulang dengan cara yang sama. Memerlukan Claude Code v2.1.208 atau lebih baru.
93 107
94Saat mencoba ulang, spinner menampilkan hitungan mundur `Retrying in Ns · attempt x/y` setelah label kesalahan. Label menyebutkan alasan spesifik dari percobaan pertama untuk kegagalan yang dapat Anda tindaklanjuti segera: jaringan tidak aktif, handshake TLS gagal, atau Anda mencapai batas laju. Untuk kesalahan lainnya, itu berbunyi `API error` pada awalnya. {/* min-version: 2.1.198 */}Mulai dari v2.1.198, itu beralih ke alasan spesifik dari percobaan ketiga, atau pada percobaan terakhir ketika `CLAUDE_CODE_MAX_RETRIES` memungkinkan lebih sedikit dari tiga; versi sebelumnya hanya beralih pada percobaan terakhir.108Saat mencoba ulang, spinner menampilkan hitungan mundur `Retrying in Ns · attempt x/y` setelah label kesalahan. Label menyebutkan alasan spesifik dari percobaan pertama untuk kegagalan yang dapat Anda tindaklanjuti segera: jaringan tidak aktif, handshake TLS gagal, atau Anda mencapai batas laju. Untuk kesalahan lainnya, itu berbunyi `API error` pada awalnya. {/* min-version: 2.1.198 */}Mulai dari v2.1.198, itu beralih ke alasan spesifik dari percobaan ketiga, atau pada percobaan terakhir ketika `CLAUDE_CODE_MAX_RETRIES` memungkinkan lebih sedikit dari tiga; versi sebelumnya hanya beralih pada percobaan terakhir.
95 109
285 299
286Claude Code memblokir permintaan lebih lanjut hingga waktu reset yang ditunjukkan dalam pesan. Batas sesi dan mingguan dibagikan di semua model, jadi beralih model tidak memulihkan akses. Batas Opus hanya berlaku untuk permintaan Opus, jadi beralih ke model lain dengan `/model` membuat Anda tetap bekerja.300Claude Code memblokir permintaan lebih lanjut hingga waktu reset yang ditunjukkan dalam pesan. Batas sesi dan mingguan dibagikan di semua model, jadi beralih model tidak memulihkan akses. Batas Opus hanya berlaku untuk permintaan Opus, jadi beralih ke model lain dengan `/model` membuat Anda tetap bekerja.
287 301
302Penggunaan dihitung terhadap tunjangan sesi dan mingguan pada saat yang sama. Satu ledakan aktivitas berat, seperti fanout alur kerja besar, dapat menghabiskan tunjangan mingguan sebelum jendela sesi direset.
303
288**Yang harus dilakukan:**304**Yang harus dilakukan:**
289 305
290* Tunggu waktu reset yang ditunjukkan dalam kesalahan306* Tunggu waktu reset yang ditunjukkan dalam kesalahan
430* Jika kunci berasal dari skrip [`apiKeyHelper`](/id/settings#available-settings), jalankan skrip secara langsung untuk mengonfirmasi bahwa skrip mencetak kunci yang valid di stdout446* Jika kunci berasal dari skrip [`apiKeyHelper`](/id/settings#available-settings), jalankan skrip secara langsung untuk mengonfirmasi bahwa skrip mencetak kunci yang valid di stdout
431* Jalankan `/status` untuk mengonfirmasi sumber kredensial mana yang sebenarnya digunakan Claude Code447* Jalankan `/status` untuk mengonfirmasi sumber kredensial mana yang sebenarnya digunakan Claude Code
432 448
449<h3 id="your-apikeyhelper-script-is-failing">
450 Skrip apiKeyHelper Anda gagal
451</h3>
452
453Perintah yang dikonfigurasi dalam pengaturan [`apiKeyHelper`](/id/settings#available-settings) keluar dengan kesalahan, habis waktu, atau tidak mencetak apa pun ke stdout. Tanpa kunci dari skrip, permintaan mencapai API dengan kredensial placeholder, dan API menolaknya dengan `401`.
454
455```text theme={null}
456Your apiKeyHelper script is failing · This usually means you need to re-authenticate with your provider · Run /status to see the script's error output
457```
458
459Claude Code menjalankan kembali skrip dan mencoba ulang permintaan hingga dua kali lagi sebelum menampilkan pesan ini, jadi kegagalan muncul dalam tiga upaya. {/* min-version: 2.1.208 */}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 daripada kegagalan skrip.
460
461Menjalankan `/login` tidak membantu di sini: output helper [mengambil prioritas](/id/authentication#authentication-precedence) atas login yang disimpan selama pengaturan ada.
462
463**Yang harus dilakukan:**
464
465* Jalankan perintah yang dikonfigurasi dalam `apiKeyHelper` secara langsung di shell Anda untuk mereproduksi kegagalan
466* Jika perintah melaporkan sesi yang kedaluwarsa, autentikasi ulang dengan penyedia kredensial Anda, misalnya dengan masuk kembali ke SSO atau vault rahasia Anda
467* Perbaiki perintah sehingga mencetak kunci ke stdout dan keluar dengan kode 0. Lihat [putar kredensial dengan apiKeyHelper](/id/llm-gateway-connect#rotate-credentials-with-apikeyhelper) untuk pengaturan yang berfungsi.
468* Jalankan `/status` untuk mengonfirmasi bahwa `apiKeyHelper` adalah sumber kredensial aktif. Setiap kali perintah gagal, kode keluar dan output kesalahannya muncul di panel `Cloud authentication` di terminal.
469
433<h3 id="this-organization-has-been-disabled">470<h3 id="this-organization-has-been-disabled">
434 Organisasi ini telah dinonaktifkan471 Organisasi ini telah dinonaktifkan
435</h3>472</h3>
532 569
533Login yang disimpan Anda 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.570Login yang disimpan Anda 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.
534 571
572Kedua 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.
573
535```text theme={null}574```text theme={null}
536OAuth token revoked · Please run /login575OAuth token revoked · Please run /login
537OAuth token has expired · Please run /login576OAuth token has expired · Please run /login
545* Untuk prompt login berulang di seluruh peluncuran, lihat pemeriksaan jam sistem dan Keychain macOS di [Troubleshooting](/id/troubleshoot-install#not-logged-in-or-token-expired)584* Untuk prompt login berulang di seluruh peluncuran, lihat pemeriksaan jam sistem dan Keychain macOS di [Troubleshooting](/id/troubleshoot-install#not-logged-in-or-token-expired)
546* Untuk kegagalan lainnya termasuk `403 Forbidden` dan masalah browser OAuth, lihat [Login dan autentikasi](/id/troubleshoot-install#login-and-authentication)585* Untuk kegagalan lainnya termasuk `403 Forbidden` dan masalah browser OAuth, lihat [Login dan autentikasi](/id/troubleshoot-install#login-and-authentication)
547 586
587<h3 id="login-expired">
588 Login kedaluwarsa
589</h3>
590
591Claude 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 berhenti secara lokal sebelum mencapai API, karena hanya `/login` yang dapat membuat kredensial baru. {/* min-version: 2.1.206 */}Sebelum v2.1.206, Claude Code mengirim permintaan 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 daripada prompt untuk masuk.
592
593```text theme={null}
594Login expired · Please run /login
595```
596
597Dalam [mode non-interaktif](/id/headless) (`-p`) dan [Agent SDK](/id/agent-sdk/overview), pesan berbunyi sebagai berikut, dan kode kesalahan terstruktur adalah `authentication_failed`:
598
599```text theme={null}
600Failed to authenticate: OAuth session expired and could not be refreshed
601```
602
603Ini bukan keadaan yang sama dengan [Token OAuth dicabut atau kedaluwarsa](#oauth-token-revoked-or-expired). Pesan tersebut melaporkan 401 yang dikembalikan API. Claude Code sendiri menghasilkan `Login expired` untuk login yang sudah gagal diperbaharui, jadi tidak mengirim permintaan.
604
605Sesi yang diautentikasi dengan kunci API, [`CLAUDE_CODE_OAUTH_TOKEN`](/id/env-vars), atau penyedia pihak ketiga tidak menggunakan login yang disimpan dan tidak pernah melihat pesan ini.
606
607**Yang harus dilakukan:**
608
609* Jalankan `/login` untuk masuk lagi. Mencoba ulang tanpa masuk menunjukkan pesan yang sama pada setiap permintaan.
610* 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 [buat token jangka panjang dengan `claude setup-token`](/id/authentication#generate-a-long-lived-token).
611* Jika masuk terus gagal, lihat [Login dan autentikasi](/id/troubleshoot-install#login-and-authentication)
612
548<h3 id="oauth-scope-requirement">613<h3 id="oauth-scope-requirement">
549 Persyaratan cakupan OAuth614 Persyaratan cakupan OAuth
550</h3>615</h3>
603* Jika kredensial Anda saat ini, konfirmasi izin IAM di [Konfigurasi IAM](/id/amazon-bedrock#iam-configuration) terlampir pada identitas yang Anda gunakan dan bahwa model yang dipilih diaktifkan untuk akun dan wilayah Anda668* Jika kredensial Anda saat ini, konfirmasi izin IAM di [Konfigurasi IAM](/id/amazon-bedrock#iam-configuration) terlampir pada identitas yang Anda gunakan dan bahwa model yang dipilih diaktifkan untuk akun dan wilayah Anda
604* Jalankan `aws sts get-caller-identity` untuk mengonfirmasi identitas mana yang digunakan permintaan Anda; `AWS_PROFILE` yang sudah usang atau profil default adalah penyebab umum ketidakcocokan izin669* Jalankan `aws sts get-caller-identity` untuk mengonfirmasi identitas mana yang digunakan permintaan Anda; `AWS_PROFILE` yang sudah usang atau profil default adalah penyebab umum ketidakcocokan izin
605 670
671<h3 id="aws-default-chain-credential-resolve-timed-out">
672 Penyelesaian kredensial rantai default AWS habis waktu
673</h3>
674
675Rantai penyedia kredensial default AWS tidak menghasilkan kredensial dalam 60 detik, jadi Claude Code menghentikan penyelesaian dan gagal permintaan. Kegagalan adalah penyelesaian kredensial lokal: permintaan tidak pernah mencapai [Amazon Bedrock](/id/amazon-bedrock), [Claude Platform on AWS](/id/claude-platform-on-aws), atau [endpoint Mantle](/id/amazon-bedrock#use-the-mantle-endpoint). Claude Code menghapus [cache kredensial](/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.
676
677```text theme={null}
678API Error: AWS default-chain credential resolve timed out
679```
680
681Penyebab umum adalah perintah `credential_process` di profil AWS Anda yang menunggu input yang tidak dapat diterima, dan kontainer atau VM yang layanan metadata instans (IMDS) tidak pernah menjawab probe rantai. {/* min-version: 2.1.207 */}Sebelum v2.1.207, rantai yang macet membiarkan permintaan menunggu tanpa batas waktu daripada gagal dengan pesan ini.
682
683**Yang harus dilakukan:**
684
685* Jalankan `aws sts get-caller-identity` di shell yang sama dengan `AWS_PROFILE` yang sama. Jika juga hang, perbaiki profil; perintah `credential_process` yang meminta secara interaktif adalah penyebab umum.
686* Selesaikan langkah masuk sebelum memulai Claude Code, misalnya `aws sso login --profile myprofile`, sehingga rantai diselesaikan dari cache SSO lokal daripada menunggu alur browser
687* Jika rantai Anda menjalankan masuk interaktif yang secara sah memerlukan lebih dari 60 detik, seperti SSO dengan MFA melalui wrapper seperti `aws-vault`, naikkan batas dalam milidetik dengan [`CLAUDE_CODE_AWS_CHAIN_RESOLVE_TIMEOUT_MS`](/id/env-vars)
688
606<h2 id="network-and-connection-errors">689<h2 id="network-and-connection-errors">
607 Kesalahan jaringan dan koneksi690 Kesalahan jaringan dan koneksi
608</h2>691</h2>
609 692
610Kesalahan ini berarti permintaan jaringan dari Claude Code gagal mencapai tujuannya. Biasanya berasal dari jaringan lokal Anda, proxy, atau firewall, atau dari kebijakan jaringan lingkungan cloud.693Kesalahan ini berarti permintaan jaringan dari Claude Code gagal mencapai tujuannya, atau sesuatu antara Claude Code dan API mengubah respons dalam perjalanannya kembali. Biasanya berasal dari jaringan lokal Anda, proxy, atau firewall, atau dari kebijakan jaringan lingkungan cloud.
611 694
612<h3 id="unable-to-connect-to-api">695<h3 id="unable-to-connect-to-api">
613 Tidak dapat terhubung ke API696 Tidak dapat terhubung ke API
640* Di macOS, klien VPN yang terputus atau dihapus dapat meninggalkan antarmuka tunnel atau aturan routing. Periksa `ifconfig` untuk antarmuka `utun` yang sudah usang dan hapus ekstensi jaringan VPN di System Settings.723* Di macOS, klien VPN yang terputus atau dihapus dapat meninggalkan antarmuka tunnel atau aturan routing. Periksa `ifconfig` untuk antarmuka `utun` yang sudah usang dan hapus ekstensi jaringan VPN di System Settings.
641* Docker Desktop dan runtime container serupa dapat mengintersepsi lalu lintas keluar. Tutup mereka dan coba lagi untuk mengesampingkan ini.724* Docker Desktop dan runtime container serupa dapat mengintersepsi lalu lintas keluar. Tutup mereka dan coba lagi untuk mengesampingkan ini.
642 725
726<h3 id="bedrock-streaming-response-has-an-unexpected-content-type">
727 Bedrock streaming response memiliki content-type yang tidak terduga
728</h3>
729
730Gateway atau proxy antara Claude Code dan [Amazon Bedrock](/id/amazon-bedrock) mengubah badan respons streaming atau header `Content-Type`-nya. Amazon Bedrock melakukan streaming respons sebagai `application/vnd.amazon.eventstream`, dan Claude Code menolak respons streaming yang berhasil yang melaporkan content-type berbeda daripada mendekode badan yang tidak dapat dibacanya. Permintaan tidak diulang.
731
732```text theme={null}
733Bedrock streaming response has content-type "text/event-stream"; expected "application/vnd.amazon.eventstream". A gateway or proxy between Claude Code and Bedrock is likely transforming the response body — Bedrock's binary event-stream format must be passed through unmodified. Set CLAUDE_CODE_DISABLE_BEDROCK_CONTENT_TYPE_GUARD=1 to suppress this check while the gateway is being fixed.
734```
735
736{/* min-version: 2.1.208 */}Sebelum v2.1.208, konfigurasi yang sama muncul sebagai `API Error: Truncated event message received` setelah seluruh respons telah di-buffer.
737
738**Yang harus dilakukan:**
739
740* Konfigurasikan gateway untuk melewatkan badan respons `InvokeModelWithResponseStream` dan header `Content-Type`-nya tanpa diubah. Perantara yang memancarkan kembali aliran sebagai server-sent events adalah penyebab umum.
741* Jika gateway hanya menulis ulang header dan melewatkan badan biner tanpa diubah, atur [`CLAUDE_CODE_DISABLE_BEDROCK_CONTENT_TYPE_GUARD=1`](/id/env-vars) untuk melewati pemeriksaan sampai gateway diperbaiki. Lihat [Streaming errors behind a gateway or proxy](/id/amazon-bedrock#streaming-errors-behind-a-gateway-or-proxy).
742
643<h3 id="ssl-certificate-errors">743<h3 id="ssl-certificate-errors">
644 Kesalahan sertifikat SSL744 Kesalahan sertifikat SSL
645</h3>745</h3>
859* **Agent SDK**: teks kesalahan menghilangkan petunjuk karena model diatur secara terprogram. Atur [`model` pada `Options`](/id/agent-sdk/typescript#options) di TypeScript atau [`ClaudeAgentOptions(model=...)`](/id/agent-sdk/python#claudeagentoptions) di Python, dan tangani kesalahan terstruktur `model_not_found` untuk menampilkan pengambil ulang atau pemilih model Anda sendiri.959* **Agent SDK**: teks kesalahan menghilangkan petunjuk karena model diatur secara terprogram. Atur [`model` pada `Options`](/id/agent-sdk/typescript#options) di TypeScript atau [`ClaudeAgentOptions(model=...)`](/id/agent-sdk/python#claudeagentoptions) di Python, dan tangani kesalahan terstruktur `model_not_found` untuk menampilkan pengambil ulang atau pemilih model Anda sendiri.
860* Gunakan alias seperti `sonnet` atau `opus` alih-alih ID versi lengkap. Alias diselesaikan ke default yang dipertahankan sehingga tidak menjadi usang. Lihat [Konfigurasi model](/id/model-config).960* Gunakan alias seperti `sonnet` atau `opus` alih-alih ID versi lengkap. Alias diselesaikan ke default yang dipertahankan sehingga tidak menjadi usang. Lihat [Konfigurasi model](/id/model-config).
861* Jika model yang salah terus kembali di CLI, ID yang usang diatur di suatu tempat. Periksa dalam [urutan prioritas](/id/model-config#setting-your-model): flag `--model`, variabel lingkungan `ANTHROPIC_MODEL`, kemudian bidang `model` di `.claude/settings.local.json`, `.claude/settings.json` proyek Anda, dan `~/.claude/settings.json`. Hapus nilai yang usang dan Claude Code kembali ke default akun Anda.961* Jika model yang salah terus kembali di CLI, ID yang usang diatur di suatu tempat. Periksa dalam [urutan prioritas](/id/model-config#setting-your-model): flag `--model`, variabel lingkungan `ANTHROPIC_MODEL`, kemudian bidang `model` di `.claude/settings.local.json`, `.claude/settings.json` proyek Anda, dan `~/.claude/settings.json`. Hapus nilai yang usang dan Claude Code kembali ke default akun Anda.
962* {/* min-version: 2.1.206 */}Claude Code melaporkan login claude.ai yang kedaluwarsa sebagai [Login expired](#login-expired), bukan sebagai kesalahan ini. Sebelum v2.1.206, login yang kedaluwarsa yang tidak lagi dapat disegarkan gagal di setiap model dengan kesalahan ini; jalankan `/login` jika Anda melihat itu di versi yang lebih lama.
862* Untuk penyebaran Google Cloud's Agent Platform, lihat [Pemecahan masalah Google Cloud's Agent Platform](/id/google-vertex-ai#troubleshooting).963* Untuk penyebaran Google Cloud's Agent Platform, lihat [Pemecahan masalah Google Cloud's Agent Platform](/id/google-vertex-ai#troubleshooting).
863 964
864<h3 id="model-is-not-a-recognized-model-id">965<h3 id="model-is-not-a-recognized-model-id">
1085 Nilai --json-schema bukan JSON Schema yang valid1186 Nilai --json-schema bukan JSON Schema yang valid
1086</h3>1187</h3>
1087 1188
1088Skema yang Anda berikan ke [`--json-schema`](/id/cli-reference#cli-flags) dalam [mode non-interaktif](/id/headless#get-structured-output) gagal kompilasi JSON Schema, jadi `claude` keluar dengan kode 1 alih-alih menjalankan prompt. Sebelum v2.1.205, skema yang tidak valid menghasilkan output tidak terstruktur tanpa kesalahan, dan skema apa pun yang menggunakan kata kunci `format` dianggap tidak valid.1189Skema yang Anda teruskan ke [`--json-schema`](/id/cli-reference#cli-flags) dalam [mode non-interaktif](/id/headless#get-structured-output) gagal kompilasi JSON Schema, jadi `claude` keluar dengan kode 1 alih-alih menjalankan prompt. Sebelum v2.1.205, skema yang tidak valid menghasilkan output tidak terstruktur tanpa kesalahan, dan skema apa pun yang menggunakan kata kunci `format` dianggap tidak valid.
1089 1190
1090```text theme={null}1191```text theme={null}
1091Error: --json-schema is not a valid JSON Schema: data/type must be equal to one of the allowed values1192Error: --json-schema is not a valid JSON Schema: data/type must be equal to one of the allowed values
1098**Yang harus dilakukan:**1199**Yang harus dilakukan:**
1099 1200
1100* Perbaiki bagian skema yang diagnostik sebutkan, kemudian jalankan kembali perintahnya1201* Perbaiki bagian skema yang diagnostik sebutkan, kemudian jalankan kembali perintahnya
1101* Jika diagnostiknya adalah `schema too large`, kurangi nesting skema dan penggunaan kembali `$ref`1202* Jika diagnostiknya adalah `schema too large`, kurangi nesting skema dan penggunaan ulang `$ref`
1102* Lihat [Get structured output](/id/headless#get-structured-output) untuk skema dan perintah yang berfungsi1203* Lihat [Get structured output](/id/headless#get-structured-output) untuk skema dan perintah yang berfungsi
1103 1204
1104<h3 id="could-not-import-a-server-from-claude-desktop">1205<h3 id="could-not-import-a-server-from-claude-desktop">
1118* 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` lagi1219* 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` lagi
1119* Tambahkan server itu secara langsung dengan `claude mcp add` atau `claude mcp add-json` dengan nama yang valid. Lihat [Import MCP servers from Claude Desktop](/id/mcp#import-mcp-servers-from-claude-desktop).1220* Tambahkan server itu secara langsung dengan `claude mcp add` atau `claude mcp add-json` dengan nama yang valid. Lihat [Import MCP servers from Claude Desktop](/id/mcp#import-mcp-servers-from-claude-desktop).
1120 1221
1222<h3 id="mcp-permission-prompt-tool-not-found">
1223 Alat prompt izin MCP tidak ditemukan
1224</h3>
1225
1226Alat yang Anda teruskan ke [`--permission-prompt-tool`](/id/cli-reference#cli-flags) tidak ada di antara alat MCP yang terhubung ketika jalankan pertama kali memerlukan keputusan izin, baik karena servernya tidak pernah terhubung atau karena tidak ada server yang terhubung yang mengekspos alat dengan nama itu. Claude Code masih mengirim prompt Anda: jalankan [non-interaktif](/id/headless) keluar dengan kesalahan ini, dan kode keluar 1, pada panggilan alat pertama yang memerlukan persetujuan, jadi tidak menghasilkan jawaban meskipun permintaan telah dibuat. Sebelum prompt pertama, Claude Code menunggu hingga batas waktu koneksi per-server 30 detik yang ditetapkan oleh [`MCP_TIMEOUT`](/id/env-vars) untuk server itu terhubung. {/* min-version: 2.1.206 */}Sebelum v2.1.206, startup tidak menunggu server selesai terhubung, jadi server yang dimulai lambat tetapi sehat menghasilkan kesalahan ini juga.
1227
1228```text theme={null}
1229Error: MCP tool mcp__permissions__approve (passed via --permission-prompt-tool) not found. Available MCP tools: none
1230```
1231
1232Daftar setelah `Available MCP tools:` menyebutkan alat MCP yang terhubung ketika penantian berakhir.
1233
1234**Yang harus dilakukan:**
1235
1236* Periksa bahwa server dimulai dan tetap terhubung: jalankan `claude mcp list` di direktori yang sama dan konfirmasi server terdaftar sebagai terhubung
1237* Konfirmkan nama alat cocok dengan nama `mcp__<server>__<tool>` yang server ekspos
1238* Jika server memerlukan lebih dari 30 detik untuk dimulai, naikkan [`MCP_TIMEOUT`](/id/env-vars)
1239
1121<h2 id="plugin-errors">1240<h2 id="plugin-errors">
1122 Kesalahan Plugin1241 Kesalahan plugin
1123</h2>1242</h2>
1124 1243
1125Kesalahan ini berasal dari konfigurasi [plugin](/id/plugins) dan [marketplace](/id/plugin-marketplaces). Untuk masalah plugin yang tidak menghasilkan salah satu pesan di halaman ini, seperti URL marketplace yang tidak memuat atau plugin yang terpasang tetapi tidak muncul, lihat [Troubleshooting Plugin](/id/discover-plugins#troubleshooting).1244Kesalahan ini berasal dari konfigurasi [plugin](/id/plugins) dan [marketplace](/id/plugin-marketplaces). Untuk masalah plugin yang tidak menghasilkan salah satu pesan di halaman ini, seperti URL marketplace yang tidak memuat atau plugin yang terpasang tetapi tidak muncul, lihat [Troubleshooting plugin](/id/discover-plugins#troubleshooting).
1126 1245
1127<h3 id="marketplace-is-registered-from-an-untrusted-source">1246<h3 id="marketplace-is-registered-from-an-untrusted-source">
1128 Marketplace terdaftar dari sumber yang tidak terpercaya1247 Marketplace terdaftar dari sumber yang tidak terpercaya
1129</h3>1248</h3>
1130 1249
1131Marketplace terdaftar dengan nama yang [dicadangkan untuk marketplace Anthropic resmi](/id/plugin-marketplaces#marketplace-schema), tetapi sumber terdaftarnya bukan repositori GitHub `anthropics`. Claude Code memeriksa ulang nama yang dicadangkan setiap kali memuat atau menyegarkan marketplace, sehingga marketplace dan plugin yang dipasang darinya berhenti memuat. Sebelum v2.1.205, nama hanya diperiksa ketika marketplace ditambahkan, sehingga entri yang terdaftar sebelum namanya dicadangkan terus memuat.1250Marketplace terdaftar dengan nama yang [dicadangkan untuk marketplace resmi Anthropic](/id/plugin-marketplaces#marketplace-schema), tetapi sumber terdaftarnya bukan repositori GitHub `anthropics`. Claude Code memeriksa ulang nama yang dicadangkan setiap kali memuat atau menyegarkan marketplace, sehingga marketplace dan plugin yang dipasang darinya berhenti memuat. Sebelum v2.1.205, nama hanya diperiksa ketika marketplace ditambahkan, sehingga entri yang terdaftar sebelum namanya dicadangkan terus memuat.
1132 1251
1133```text theme={null}1252```text theme={null}
1134Marketplace "claude-community" is registered from an untrusted source: The name 'claude-community' is reserved for official Anthropic marketplaces. Only repositories from 'github.com/anthropics/' can use this name. To fix it, remove the marketplace and re-add it from the official source.1253Marketplace "claude-community" is registered from an untrusted source: The name 'claude-community' is reserved for official Anthropic marketplaces. Only repositories from 'github.com/anthropics/' can use this name. To fix it, remove the marketplace and re-add it from the official source.
1136 1255
1137**Yang harus dilakukan:**1256**Yang harus dilakukan:**
1138 1257
1139* Jalankan `claude plugin marketplace remove <name>`, kemudian tambahkan marketplace lagi dari repositori `github.com/anthropics` resmi1258* Jalankan `claude plugin marketplace remove <name>`, kemudian tambahkan marketplace lagi dari repositori resmi `github.com/anthropics`
1140* Jika Anda menerbitkan marketplace pihak ketiga yang menggunakan nama sebelum dicadangkan, ubah namanya dan minta pengguna untuk menambahkannya kembali dari sumber Anda1259* Jika Anda menerbitkan marketplace pihak ketiga yang menggunakan nama sebelum nama tersebut dicadangkan, ubah namanya dan minta pengguna untuk menambahkannya kembali dari sumber Anda
1141* Lihat daftar nama yang dicadangkan di bawah [Marketplace schema](/id/plugin-marketplaces#marketplace-schema)1260* Lihat daftar nama yang dicadangkan di bawah [Marketplace schema](/id/plugin-marketplaces#marketplace-schema)
1142 1261
1262<h3 id="plugin-command-references-user-config">
1263 Plugin command references user\_config in a shell command
1264</h3>
1265
1266Hook plugin, [monitor](/id/plugins-reference#monitors), atau perintah MCP [`headersHelper`](/id/mcp#use-dynamic-headers-for-custom-authentication) mereferensikan opsi `${user_config.KEY}` [plugin](/id/plugins-reference#user-configuration), dan string yang disubstitusi akan diteruskan ke shell. Nilai yang dikonfigurasi berisi `$(...)`, backtick, atau `;` akan berjalan sebagai kode di sana, jadi Claude Code menolak untuk memulai komponen alih-alih mensubstitusi nilai. Pemeriksaan berjalan pada template perintah, sehingga kesalahan muncul bahkan ketika tidak ada nilai yang dikonfigurasi. Sebelum v2.1.207, nilai disubstitusi ke dalam perintah shell.
1267
1268Redaksi tergantung pada permukaan mana yang mereferensikan opsi. Hook bentuk shell melaporkan:
1269
1270```text theme={null}
1271Hook from plugin formatter@acme-tools references ${user_config.*} in a shell-form command. The substituted value would be re-parsed by the shell. Use exec form instead — {"command": "<executable>", "args": ["${user_config.KEY}", ...]} — or read $CLAUDE_PLUGIN_OPTION_<KEY> from the hook's environment. Command: ./scripts/notify.sh ${user_config.webhook_url}
1272```
1273
1274Monitor melaporkan:
1275
1276```text theme={null}
1277Monitor "deploy-status" from plugin deploy-tools references ${user_config.*} in its command. The substituted value would be passed to a shell. Monitor commands cannot safely reference ${user_config.*}; have the monitor script read the value from a config file or prompt instead.
1278```
1279
1280MCP `headersHelper` melaporkan:
1281
1282```text theme={null}
1283headersHelper for MCP server 'internal-api' references ${user_config.*}. The substituted value would be passed to a shell; read the value inside the helper script instead (e.g. from an env var set in the server's "env" block).
1284```
1285
1286**Yang harus dilakukan:**
1287
1288* Untuk hook, tambahkan array `args` sehingga berjalan dalam [exec form](/id/hooks#exec-form-and-shell-form), di mana setiap `${user_config.KEY}` menjadi satu argumen tanpa shell di antaranya. Atau lepaskan referensi dan baca variabel lingkungan `$CLAUDE_PLUGIN_OPTION_<KEY>` di dalam skrip
1289* Untuk monitor, lepaskan referensi dan buat skrip monitor membaca nilai dari file konfigurasi
1290* Untuk `headersHelper`, pindahkan `${user_config.KEY}` ke dalam bidang `headers` server, yang tidak diurai shell, atau baca nilai di dalam skrip helper
1291
1292<h2 id="tool-errors">
1293 Kesalahan Tool
1294</h2>
1295
1296Kesalahan ini berasal dari tool bawaan Claude yang menolak input. Claude memperbaiki sebagian besar kesalahan tool secara otomatis; dua kesalahan di bawah ini memerlukan perubahan dari Anda, karena berasal dari definisi subagent atau aturan izin yang Anda kontrol.
1297
1298<h3 id="agent-would-be-spawned-with-zero-tools">
1299 Agent would be spawned with zero tools
1300</h3>
1301
1302Tidak ada yang ada dalam [daftar `tools` subagent](/id/sub-agents#supported-frontmatter-fields) yang terselesaikan menjadi tool, jadi Claude Code menolak untuk meluncurkan subagent daripada memulai yang tidak dapat bertindak. Pesan mengelompokkan entri berdasarkan alasan mereka tidak terselesaikan: bukan tool yang dikenali, tool yang tidak tersedia untuk subagent, atau dikenali tetapi tidak cocok dengan tool apa pun dalam sesi saat ini. Menghilangkan bidang `tools` tidak pernah memicu penolakan ini. Pola server MCP seperti `mcp__github__*` tidak dikecualikan: ketika tidak ada tool yang terhubung berasal dari server itu, peluncuran ditolak dengan pola dalam grup yang tidak cocok dengan apa pun. Sebelum v2.1.208, subagent diluncurkan tanpa tool dan mengembalikan hasil yang kosong atau membingungkan.
1303
1304```text theme={null}
1305Agent 'code-reviewer' would be spawned with zero tools — refusing. Its tools list resolved to nothing: unrecognized [Grpe]. Fix the agent's tools frontmatter or pass a different subagent_type.
1306```
1307
1308**Yang harus dilakukan:**
1309
1310* Perbaiki setiap entri yang dinamai kesalahan terhadap [tool yang tersedia untuk subagent](/id/sub-agents#available-tools)
1311* Hapus entri untuk tool yang tidak dimiliki sesi, seperti tool MCP dari server yang tidak terhubung
1312* Untuk memberikan subagent setiap tool yang dimiliki induk, hapus bidang `tools` daripada membuat daftar tool
1313
1314<h3 id="file-is-covered-by-a-read-deny-rule">
1315 File is covered by a Read deny rule
1316</h3>
1317
1318Tool Edit dipanggil pada jalur yang cocok dengan [aturan deny `Read`](/id/permissions#read-and-edit), termasuk membuat file baru di jalur itu. Pengeditan menulis ulang konten yang harus dapat dibaca Claude kembali, jadi panggilan ditolak sebelum akses file apa pun. Aturan memblokir tool Edit saja: Write dan NotebookEdit tidak tercakup oleh aturan deny `Read`. Sebelum v2.1.208, hanya aturan deny `Edit` yang memblokir pengeditan, dan aturan deny `Read` saja tidak.
1319
1320```text theme={null}
1321File is covered by a Read deny rule in your permission settings and cannot be edited.
1322```
1323
1324**Yang harus dilakukan:**
1325
1326* Jika Claude harus dapat mengedit file, hapus atau persempit aturan deny `Read` di `/permissions` atau di [settings](/id/settings#permission-settings)
1327* Jika file harus tetap tidak tersentuh, pertahankan aturan dan tambahkan aturan deny `Edit` untuk jalur yang sama sehingga tool Write dan NotebookEdit juga diblokir
1328
1329<h2 id="background-session-errors">
1330 Kesalahan sesi latar belakang
1331</h2>
1332
1333[Sesi latar belakang](/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, dalam tampilan agen atau setelah melampirkan.
1334
1335<h3 id="commands-refused-in-a-background-session">
1336 Perintah yang ditolak dalam sesi latar belakang
1337</h3>
1338
1339Perintah yang membuka dialog interaktif ditolak dalam sesi latar belakang dengan pesan yang menyebutkan formulir yang berfungsi di sana atau memberi tahu Anda untuk menjalankan perintah dari terminal biasa. `/install-github-app`, daftar pengaturan `/mcp`, dan tindakan autentikasi dalam menu server MCP semuanya ditolak dengan cara ini. Sebelum v2.1.208, mereka membuka dialog mereka di dalam sesi latar belakang.
1340{/* max-version: 2.1.208 */}Dalam v2.1.208 saja, pemilih `/model` juga ditolak dalam sesi latar belakang, dan `/upgrade` mencetak URL upgrade alih-alih membuka browser.
1341
1342Redaksi menyebutkan perintah yang ditolak. Daftar pengaturan `/mcp` melaporkan:
1343
1344```text theme={null}
1345Can't open MCP settings in a background session — use `/mcp enable|disable|reconnect <server>` to steer, or run /mcp from an interactive terminal to authenticate.
1346```
1347
1348**Yang harus dilakukan:**
1349
1350* Gunakan formulir yang disebutkan pesan, seperti `/mcp reconnect <server>`, `/mcp enable`, atau `/mcp disable`
1351* Untuk alur masuk dan otorisasi, jalankan perintah dari sesi `claude` biasa dalam terminal
1352
1353<h3 id="claude_code_process_wrapper-launcher-errors">
1354 Kesalahan peluncur CLAUDE\_CODE\_PROCESS\_WRAPPER
1355</h3>
1356
1357[`CLAUDE_CODE_PROCESS_WRAPPER`](/id/corporate-launcher) diatur, dan nilainya tidak dapat digunakan, jadi Claude Code menolak untuk memulai proses yang terpengaruh daripada menjalankannya tanpa peluncur. Masalah konfigurasi dilaporkan dengan pesan yang dimulai dengan nama variabel dan menyatakan alasannya, misalnya:
1358
1359```text theme={null}
1360CLAUDE_CODE_PROCESS_WRAPPER: launcher `/opt/corp/launcher` is not an executable regular file
1361```
1362
1363Peluncur yang dimulai tetapi keluar tanpa mengganti dirinya dengan Claude Code gagal dalam sesi yang sedang dimulai, 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 mencapai layanan latar belakang karena peluncur melaporkan masalah peluncur sebagai alasan di dalam `Couldn't reach the background service (...)`.
1364
1365**Yang harus dilakukan:**
1366
1367* Atur variabel ke jalur absolut dari executable yang diakhiri dengan memanggil `exec "$@"`. Lihat [kontrak peluncur](/id/corporate-launcher#the-launcher-contract) untuk kontrak lengkap
1368* Periksa `/status`, yang menunjukkan perintah peluncuran yang diselesaikan dalam entri Self-exec-nya dan memperingatkan ketika layanan latar belakang yang berjalan tidak cocok, atau jalankan `claude daemon status` dari shell
1369* Setelah memperbaiki nilai dalam blok `env` dari [pengaturan](/id/corporate-launcher#set-up-the-launcher), mulai ulang layanan latar belakang dengan `claude daemon stop --any` sehingga pengiriman berikutnya memulai yang dibungkus
1370
1143<h2 id="configuration-warnings">1371<h2 id="configuration-warnings">
1144 Peringatan Konfigurasi1372 Peringatan Konfigurasi
1145</h2>1373</h2>
1160 1388
1161* Jalankan `claude` di direktori dan terima dialog kepercayaan. {/* min-version: 2.1.200 */}Dialog muncul bahkan ketika direktori induk sudah dipercaya, mencantumkan aturan yang ditahan, dan memungkinkan Anda menolak dan terus bekerja tanpanya. Sebelum v2.1.200, tidak ada dialog yang muncul dalam situasi itu, jadi langkah ini tidak dapat diselesaikan di sana.1389* Jalankan `claude` di direktori dan terima dialog kepercayaan. {/* min-version: 2.1.200 */}Dialog muncul bahkan ketika direktori induk sudah dipercaya, mencantumkan aturan yang ditahan, dan memungkinkan Anda menolak dan terus bekerja tanpanya. Sebelum v2.1.200, tidak ada dialog yang muncul dalam situasi itu, jadi langkah ini tidak dapat diselesaikan di sana.
1162* Dalam [mode non-interaktif](/id/headless) dengan `-p` tidak ada dialog yang ditampilkan. Atur entri `hasTrustDialogAccepted` dalam `~/.claude.json` menggunakan kunci `projects` yang tepat yang dicetak pesan.1390* Dalam [mode non-interaktif](/id/headless) dengan `-p` tidak ada dialog yang ditampilkan. Atur entri `hasTrustDialogAccepted` dalam `~/.claude.json` menggunakan kunci `projects` yang tepat yang dicetak pesan.
1163* {/* min-version: 2.1.200 */}Jika pesan menyebutkan `.claude/settings.local.json` dan Anda memulai Claude Code di luar repositori git atau di direktori home Anda, perbarui ke v2.1.200 atau lebih baru. Versi 2.1.196 hingga 2.1.199 memperlakukan `.claude/settings.local.json` Anda sendiri sebagai yang disediakan repositori di workspace tersebut. Lihat [Aturan allow proyek dan kepercayaan workspace](/id/permissions#project-allow-rules-and-workspace-trust).1391* {/* min-version: 2.1.200 */}Jika pesan menyebutkan `.claude/settings.local.json` dan Anda memulai Claude Code di luar repositori git atau di direktori home Anda, perbarui ke v2.1.200 atau lebih baru. Versi 2.1.196 hingga 2.1.199 memperlakukan `.claude/settings.local.json` Anda sendiri sebagai yang disediakan repositori di workspace tersebut. {/* min-version: 2.1.207 */}Pada v2.1.207 dan lebih baru, pembaruan tidak cukup di luar repositori git jika Anda belum mempercayai folder: menentukan bahwa folder tidak berada di dalam repositori menjalankan git, dan Claude Code menjalankan pemeriksaan itu hanya setelah Anda menerima dialog kepercayaan, jadi gunakan langkah pertama. Direktori home Anda dan [configuration home](/id/permissions#project-allow-rules-and-workspace-trust) lainnya dikecualikan dan tidak menunggu dialog. Lihat [Project allow rules and workspace trust](/id/permissions#project-allow-rules-and-workspace-trust).
1164 1392
1165<h2 id="responses-seem-lower-quality-than-usual">1393<h2 id="responses-seem-lower-quality-than-usual">
1166 Respons tampak berkualitas lebih rendah dari biasanya1394 Respons tampak berkualitas lebih rendah dari biasanya
1177Periksa ini terlebih dahulu:1405Periksa ini terlebih dahulu:
1178 1406
1179* **Model selection**: jalankan `/model` untuk mengonfirmasi Anda berada di model yang Anda harapkan. Pilihan `/model` sebelumnya atau variabel lingkungan `ANTHROPIC_MODEL` mungkin membuat Anda berada di model yang lebih kecil dari yang Anda maksudkan.1407* **Model selection**: jalankan `/model` untuk mengonfirmasi Anda berada di model yang Anda harapkan. Pilihan `/model` sebelumnya atau variabel lingkungan `ANTHROPIC_MODEL` mungkin membuat Anda berada di model yang lebih kecil dari yang Anda maksudkan.
1180* **Effort level**: jalankan `/effort` untuk memeriksa tingkat reasoning saat ini dan naikkan untuk debugging atau pekerjaan desain yang sulit. Default bervariasi menurut model, jadi periksa sebelum menganggap Anda di bawah maksimum. Lihat [Adjust effort level](/id/model-config#adjust-effort-level) untuk default per-model dan pintasan `ultrathink`.1408* **Effort level**: jalankan `/effort` untuk memeriksa tingkat reasoning saat ini dan naikkan untuk debugging atau pekerjaan desain yang sulit. Default bervariasi menurut model, jadi periksa sebelum mengasumsikan Anda di bawah maksimum. Lihat [Adjust effort level](/id/model-config#adjust-effort-level) untuk default per-model dan pintasan `ultrathink`.
1181* **Context pressure**: jalankan `/context` untuk melihat seberapa penuh jendela tersebut. Jika mendekati kapasitas, jalankan `/compact` pada titik alami atau `/clear` untuk memulai dari awal. Lihat [Explore the context window](/id/context-window) untuk cara auto-compact mempengaruhi giliran sebelumnya.1409* **Context pressure**: jalankan `/context` untuk melihat seberapa penuh jendela tersebut. Jika mendekati kapasitas, jalankan `/compact` pada titik alami atau `/clear` untuk memulai dari awal. Lihat [Explore the context window](/id/context-window) untuk cara auto-compact mempengaruhi giliran sebelumnya.
1182* **Stale instructions**: file `CLAUDE.md` yang besar atau ketinggalan zaman dan definisi alat MCP mengonsumsi konteks dan dapat mengarahkan respons. {/* min-version: 2.1.205 */}Pemeriksaan `/doctor` menandai file memori yang berukuran besar dan ekstensi yang tidak digunakan, dan `/context` menampilkan penggunaan token alat MCP. Sebelum v2.1.205, `/doctor` membuka layar diagnostik yang menandai file memori yang berukuran besar dan definisi subagent.1410* **Stale instructions**: file `CLAUDE.md` yang besar atau ketinggalan zaman dan definisi alat MCP mengonsumsi konteks dan dapat mengarahkan respons. {/* min-version: 2.1.205 */}Pemeriksaan `/doctor` menandai file memori yang berukuran besar dan ekstensi yang tidak digunakan, dan `/context` menampilkan penggunaan token alat MCP. Sebelum v2.1.205, `/doctor` membuka layar diagnostik yang menandai file memori yang berukuran besar dan definisi subagent.
1183 1411
1184Ketika respons salah, rewinding biasanya bekerja lebih baik daripada membalas dengan koreksi. Tekan Esc dua kali atau jalankan `/rewind` untuk mundur ke sebelum giliran yang buruk, kemudian rephrase prompt dengan spesifik lebih lanjut. Mengoreksi dalam-thread menjaga upaya yang salah dalam konteks, yang dapat menambatkan jawaban nanti ke dalamnya. Lihat [Checkpointing](/id/checkpointing).1412Ketika respons salah, rewinding biasanya bekerja lebih baik daripada membalas dengan koreksi. Tekan Esc dua kali atau jalankan `/rewind` untuk mundur ke sebelum giliran yang buruk, kemudian rephrase prompt dengan spesifik lebih lanjut. Mengoreksi dalam-thread menjaga upaya yang salah dalam konteks, yang dapat menambatkan jawaban kemudian ke dalamnya. Lihat [Checkpointing](/id/checkpointing).
1185 1413
1186Jika kualitas masih tampak tidak sesuai setelah memeriksa di atas, jalankan `/feedback` dan jelaskan apa yang Anda harapkan versus apa yang Anda dapatkan. Feedback yang dikirimkan dengan cara ini mencakup transkrip percakapan, yang merupakan cara tercepat bagi Anthropic untuk mendiagnosis regresi nyata. Lihat [Report an error](#report-an-error) jika `/feedback` tidak tersedia di lingkungan Anda.1414Jika kualitas masih tampak tidak sesuai setelah memeriksa di atas, jalankan `/feedback` dan jelaskan apa yang Anda harapkan versus apa yang Anda dapatkan. Feedback yang dikirimkan dengan cara ini mencakup transkrip percakapan, yang merupakan cara tercepat bagi Anthropic untuk mendiagnosis regresi nyata. Lihat [Report an error](#report-an-error) jika `/feedback` tidak tersedia di lingkungan Anda.
1187 1415
1188{/* min-version: 2.1.201 */}Jika Sonnet 5 menolak permintaan dan mengutip injeksi prompt yang dicurigai pada Claude Code v2.1.200 atau lebih awal, jalankan `claude update` untuk mengambil perbaikan v2.1.201.1416Jika Claude memperingatkan tentang injeksi prompt yang dicurigai, atau menolak permintaan karena injeksi yang dicurigai, dan teks yang dinamai peringatan adalah konteks yang ditambahkan Claude Code ke percakapan secara otomatis daripada konten file atau web, jalankan `claude update` dan coba lagi. Jika peringatan berulang setelah memperbarui, [laporkan](/id/#report-an-error) daripada menempel konten yang ditandai kembali ke dalam prompt. {/* min-version: 2.1.201 */}Sebelum v2.1.201, Sonnet 5 menolak beberapa permintaan dengan cara yang sama.
1189 1417
1190<h2 id="report-an-error">1418<h2 id="report-an-error">
1191 Laporkan kesalahan1419 Laporkan kesalahan
1199 1427
1200Jika kesalahan tidak tercantum di sini atau perbaikan yang disarankan tidak membantu:1428Jika kesalahan tidak tercantum di sini atau perbaikan yang disarankan tidak membantu:
1201 1429
1202* Jalankan `/feedback` di dalam Claude Code untuk mengirimkan transkrip dan deskripsi ke Anthropic. Perintah ini juga menawarkan untuk membuka masalah GitHub yang sudah diisi sebelumnya. Di Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry, dan penyedia pihak ketiga lainnya, `/feedback` menyimpan arsip lokal yang dapat Anda kirimkan ke perwakilan akun Anthropic Anda.1430* Jalankan `/feedback` di dalam Claude Code untuk mengirimkan transkrip dan deskripsi ke Anthropic. Perintah ini juga menawarkan untuk membuka masalah GitHub yang sudah diisi sebelumnya. Pengiriman ke Anthropic memerlukan [authentication](/id/authentication). Di Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry, dan penyedia pihak ketiga lainnya, atau ketika tidak ada kredensial Anthropic yang dikonfigurasi, `/feedback` menyimpan arsip lokal yang dapat Anda kirimkan ke perwakilan akun Anthropic Anda.
1203* Jalankan `claude doctor` dari shell Anda untuk diagnostik sistem file hanya-baca dari instalasi Anda, atau jalankan pemeriksaan `/doctor` di dalam Claude Code untuk menemukan dan memperbaiki masalah konfigurasi1431* Jalankan `claude doctor` dari shell Anda untuk diagnostik sistem file read-only dari instalasi Anda, atau jalankan pemeriksaan `/doctor` di dalam Claude Code untuk menemukan dan memperbaiki masalah pengaturan
1204* Periksa [status.claude.com](https://status.claude.com) untuk insiden aktif1432* Periksa [status.claude.com](https://status.claude.com) untuk insiden aktif
1205* Cari [masalah yang ada](https://github.com/anthropics/claude-code/issues) di GitHub1433* Cari [existing issues](https://github.com/anthropics/claude-code/issues) di GitHub
