Referensi kesalahan

Cari pesan kesalahan runtime Claude Code dengan arti masing-masing dan cara memperbaikinya.

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

Kecuali untuk 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, dan cloud sessions, karena ketiganya membungkus CLI Claude Code yang sama. Untuk masalah spesifik permukaan lainnya, lihat bagian pemecahan masalah di halaman permukaan tersebut.

Temukan kesalahan Anda

Cocokkan pesan yang Anda lihat dengan bagian di bawah ini.

Pengulangan otomatis

Claude Code mengulangi kegagalan transien hingga 10 kali dengan exponential backoff sebelum menampilkan kesalahan kepada Anda. Tidak selalu mengulangi kegagalan yang tiba di tengah respons Claude. Ketika Anda melihat salah satu kesalahan di halaman ini, Claude Code telah membuat pengulangan apa pun yang berlaku untuk kegagalan tersebut; daftar di bawah mengatakan kegagalan mana yang mendapat anggaran penuh, mana yang mendapat anggaran lebih kecil, dan mana yang tidak mendapat apa pun.

Claude Code mengulangi kegagalan ini:

• Server errors, overloaded responses, dan request timeouts yang tiba sebelum respons Claude mulai streaming.
• Dropped connections. Ketika koneksi terputus di tengah permintaan sebelum Claude menyelesaikan bagian mana pun dari responsnya, termasuk pemikirannya, Claude Code mengeluarkan kembali permintaan dengan backoff yang sama dan giliran berlanjut, bahkan jika beberapa teks telah mulai streaming. Ketika terputus setelah Claude selesai berpikir tetapi sebelum memulai teks atau panggilan alat apa pun, Claude Code malah mengeluarkan kembali permintaan hingga dua kali dengan cepat, dan mengakhiri giliran dengan Connection lost before a response was produced jika koneksi terus terputus pada titik itu.
• Koneksi yang Claude Code deteksi rusak karena komputer Anda tidur di tengah permintaan. Claude Code menghitungnya sebagai dropped connection sesuai aturan di atas; setelah label pengulangan menyebutkan alasan spesifik, dibaca Connection lost while your computer was asleep, dan jika giliran berakhir setelah Claude selesai berpikir tetapi sebelum teks atau panggilan alat apa pun, pesan berbunyi Your computer went to sleep before a response was produced.
• Stalled response stream, ketika response headers telah tiba tetapi tidak ada respons Claude yang tiba, atau ketika Claude selesai berpikir tetapi belum memulai teks atau panggilan alat apa pun: Claude Code membatalkan koneksi yang macet dan mengeluarkan kembali permintaan paling banyak sekali, di luar anggaran 10-percobaan di atas. Jika respons macet untuk kedua kalinya setelah Claude selesai berpikir tetapi sebelum teks atau panggilan alat apa pun, Claude Code mengakhiri giliran dengan The response stalled before a response was produced.
• Streaming request yang API tidak pernah jawab dengan response headers, pada koneksi di mana first-byte deadline berjalan: Claude Code membatalkannya pada deadline dan mengirimnya kembali paling banyak sekali per model request, dalam anggaran pengulangan, kemudian mengakhiri giliran dengan No response from API jika percobaan itu juga tidak dijawab. Pada koneksi lain, permintaan menunggu API_TIMEOUT_MS. Ketika Anda menetapkan CLAUDE_CODE_RETRY_WATCHDOG, batas satu pengulangan tidak berlaku.
• Temporary 429 throttles, tetapi bukan 429 spend-limit gateway, yang bukan throttle; lihat Spend limit reached.
  • Ketika Anda masuk dengan langganan claude.ai, ini mencakup 429 throttles yang tidak membawa header kuota rencana Anda. Sebelum v2.1.199, Claude Code hanya mengulangi throttles tersebut untuk API key dan Enterprise sign-ins.
• Permintaan ditolak karena input plus max_tokens melebihi context limit. Mengirimnya kembali tanpa perubahan akan gagal dengan cara yang sama, jadi Claude Code mengulangi dengan max_tokens yang dikurangi, dan berhenti mengulangi dan melakukan compact sebagai gantinya dalam dua kasus:
  • Ketika tidak ada pengurangan yang dapat muat, misalnya ketika percakapan itu sendiri hampir mengisi context window.
  • Ketika pengulangan tidak dapat menyusutkan max_tokens lebih jauh. Sebelum v2.1.218, Claude Code dapat mengirim kembali permintaan yang dikurangi yang masih tidak muat, seperti ketika extended thinking budget melebihi context yang tersisa, sampai anggaran pengulangan habis.
• Expired atau missing Google Cloud credential pada Google Cloud's Agent Platform, atau AWS credentials yang gagal dimuat di mesin Anda. Claude Code membuang credentials yang di-cache dan mengulangi hingga dua kali, kemudian melaporkan kesalahan sehingga Anda dapat re-authenticate segera, seperti dijelaskan di bawah Could not load AWS or Google Cloud credentials. Sebelum v2.1.228, Claude Code mengulangi failing Google Cloud credential melalui anggaran pengulangan penuh sebelum menampilkan kesalahan.
• 401 atau 403 dari Anthropic API, secara langsung atau melalui LLM gateway, sementara script apiKeyHelper menyediakan credential. Claude Code menjalankan kembali script dan mengulangi dengan output segar-nya, dalam anggaran pengulangan penuh. Ketika script itu sendiri gagal pada re-run, Claude Code menampilkan Your apiKeyHelper script is failing sebagai gantinya.

Sebelum v2.1.227, Connection lost before a response was produced berbunyi Connection closed while thinking, before producing a response dan The response stalled before a response was produced berbunyi Response stalled while thinking, before producing a response.

Claude Code tidak mengulangi kegagalan ini:

• TLS certificate validation failure, seperti TLS-inspecting proxy, missing NODE_EXTRA_CA_CERTS bundle, atau expired certificate. Claude Code melaporkan kesalahan pada percobaan pertama, sehingga Anda dapat memperbaiki setup certificate dengan segera; lihat SSL certificate errors. Claude Code masih mengulangi transient TLS conditions seperti handshake timeout. Sebelum v2.1.199, Claude Code mengulangi certificate failures melalui anggaran pengulangan penuh sebelum menampilkan kesalahan.
• Server error, dropped connection, atau stalled stream yang tiba setelah Claude menyelesaikan blok teks atau panggilan alat, atau telah memulai satu setelah menyelesaikan pemikirannya, tetapi sebelum menyelesaikan respons. Claude Code tidak menjalankan kembali permintaan, karena itu dapat mengeksekusi panggilan alat yang sama dua kali. Ini menyimpan apa yang Claude selesaikan, menjalankan panggilan alat apa pun yang Claude selesaikan, dan melanjutkan giliran dari hasil mereka. Untuk apa yang Anda lihat dalam sesi interaktif dan non-interaktif, baca The response above may be incomplete. Sebelum v2.1.199, Claude Code membuang output parsial dan melaporkan seluruh giliran sebagai kesalahan ketika server error tiba di tengah-tengah stream.
• Kegagalan yang tiba setelah Claude menyelesaikan respons: tidak ada yang perlu diulangi, jadi Claude Code menyimpan respons lengkap dan mengakhiri giliran secara normal.
• Amazon Bedrock streaming response dengan unexpected content-type, karena gateway atau proxy yang menulis ulang respons akan menulis ulang pengulangan dengan cara yang sama. Memerlukan Claude Code v2.1.208 atau lebih baru.
• Non-streaming retry dari failed streaming request yang mendapat success status tetapi no Claude API message in the body. Claude Code mengakhiri giliran dengan kesalahan itu.
• Permintaan yang policy check organisasi Anda tolak, yang muncul sebagai baris API Error: yang membawa pesan penolakan. Administrator organisasi Anda menyiapkan check dengan Inference hooks, fitur Claude Enterprise, dan pesan berakhir dengan instruksi yang mereka konfigurasi, atau secara default memberi tahu Anda untuk menghubungi mereka. Claude Code tidak mengirim kembali permintaan yang ditolak ke model yang sama atau ke fallback model, karena penolakan adalah tentang konten permintaan daripada model. Sebelum v2.1.239, Claude Code dapat mengirim kembali permintaan yang ditolak, tanpa streaming atau pada fallback model yang dikonfigurasi, sebelum menampilkan penolakan kepada Anda.

Apa yang Anda lihat saat Claude Code mengulangi atau menunggu

Saat mengulangi, spinner menampilkan countdown 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, TLS handshake gagal, atau Anda mencapai rate limit. Untuk kesalahan lain dibaca API error pada awalnya. Mulai v2.1.198 beralih ke alasan spesifik dari percobaan ketiga, atau pada percobaan terakhir ketika CLAUDE_CODE_MAX_RETRIES memungkinkan lebih sedikit dari tiga; versi sebelumnya beralih hanya pada percobaan terakhir.

Mulai v2.1.198, spinner tip biasa ditekan selama pengulangan. Setelah alasan kesalahan terungkap, jika kegagalan adalah 529 overload baris di bawah countdown juga menyebutkan di mana memeriksa status layanan: status.claude.com pada Anthropic API, atau penyedia atau host gateway yang dinamai dalam pesan pada konfigurasi lain.

Jika tidak ada data yang tiba pada response stream selama 20 detik sementara permintaan masih tertunda, spinner menampilkan Waiting for API response · will retry in … · check your network sebelum pengulangan apa pun telah dimulai. Permintaan belum gagal: countdown berjalan ke titik di mana Claude Code membatalkan koneksi yang macet. Setelah pembatalan, apa yang Anda lihat tergantung pada seberapa jauh respons telah sampai:

• Sebelum Claude menyelesaikan blok teks atau panggilan alat, atau memulai satu setelah menyelesaikan pemikirannya, Claude Code mengulangi permintaan atau mengakhiri giliran dengan kesalahan. Automatic retries mengatakan stalls mana yang diulanginya dan berapa kali.
• Setelah Claude menyelesaikan blok teks atau panggilan alat, atau memulai satu setelah menyelesaikan pemikirannya, tetapi sebelum Claude menyelesaikan respons, Claude Code menyimpan apa yang Claude selesaikan, melanjutkan giliran dari panggilan alat apa pun yang Claude selesaikan, dan menampilkan The response above may be incomplete. Dalam sesi non-interaktif, dan untuk respons subagent dalam sesi apa pun, Claude Code mungkin pertama-tama meminta Claude untuk melanjutkan respons; entry itu mengatakan kapan itu terjadi dan kapan Anda masih melihat pemberitahuan di sana.
• Setelah Claude menyelesaikan respons, Claude Code mengakhiri giliran secara normal.

Banner menghapus dirinya sendiri setelah data dilanjutkan atau pengulangan berhasil. Jika muncul kembali pada setiap percobaan, perlakukan sebagai network issue. Sebelum v2.1.185, banner muncul setelah 10 detik dengan wording berbeda.

Saat Claude berkonsultasi dengan advisor, banner muncul setelah 90 detik tanpa data bukan 20, karena review advisor yang panjang dapat mengirim tidak ada selama lebih dari 20 detik. Sebelum v2.1.214, threshold 20-detik diterapkan selama advisor calls juga, jadi banner muncul selama advisor reviews bahkan ketika tidak ada yang salah.

Sesuaikan perilaku pengulangan

Anda dapat menyesuaikan perilaku pengulangan dengan variabel lingkungan ini:

Kesalahan server

Sebagian 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 dan Agent dihentikan lebih awal karena kesalahan API juga mencakup penyebab di sisi Anda, seperti akun Amazon Bedrock yang tidak dapat memanggil model pengklasifikasi atau subagent yang mencapai batas penggunaan.

API Error: 500 Internal server error

Claude Code menampilkan kode status dan pesan kesalahan API untuk respons 5xx apa pun. Contoh di bawah menunjukkan respons 500 di Anthropic API:

API Error: 500 Internal server error. This is a server-side issue, usually temporary — try again in a moment. If it persists, check https://status.claude.com.

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

Ini menunjukkan kegagalan yang tidak terduga di dalam API. Ini tidak disebabkan oleh prompt, pengaturan, atau akun Anda.

Yang harus dilakukan:

• Periksa status.claude.com, atau halaman status penyedia yang disebutkan dalam pesan, untuk insiden aktif
• Tunggu satu menit, kemudian 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.
• Jika kesalahan berlanjut tanpa insiden yang diposting, jalankan /feedback sehingga Anthropic dapat menyelidiki dengan detail permintaan Anda. Lihat Report an error jika /feedback tidak tersedia di lingkungan Anda.

API Error: Repeated 529 Overloaded errors

API sementara pada kapasitas di semua pengguna. Claude Code telah mencoba kembali beberapa kali sebelum menampilkan pesan ini:

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

Kalimat terakhir bervariasi menurut penyedia dengan cara yang sama seperti kesalahan 500 di atas.

529 bukan batas penggunaan Anda dan tidak dihitung terhadap kuota Anda.

Yang harus dilakukan:

• Periksa status.claude.com, atau halaman status penyedia yang disebutkan dalam pesan, untuk pemberitahuan kapasitas
• Coba lagi dalam beberapa menit
• Jalankan /model dan beralih ke model yang berbeda untuk terus bekerja, karena kapasitas dilacak per model. Claude Code meminta Anda untuk melakukan ini ketika satu model mengalami beban yang sangat tinggi, misalnya Opus is experiencing high load, please use /model to switch to Sonnet.

Request timed out

API tidak merespons sebelum batas waktu koneksi.

Request timed out

Ini dapat terjadi selama periode beban tinggi atau ketika model menghasilkan respons yang sangat besar. Waktu tunggu permintaan default adalah 10 menit.

Yang harus dilakukan:

• Coba lagi permintaan
• Untuk tugas yang berjalan lama, pecah pekerjaan menjadi prompt yang lebih kecil
• Jika penyebabnya adalah jaringan lambat atau proxy, naikkan API_TIMEOUT_MS seperti yang dijelaskan dalam Automatic retries
• Jika waktu tunggu sering terjadi dan jaringan Anda sehat, lihat Network and connection errors di bawah

No response from API

Claude 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 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, batas satu percobaan ulang tidak berlaku dan Claude Code mencoba ulang di bawah anggaran yang dijelaskan dalam Tune retry behavior.

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

Claude Code menetapkan tunggu header respons upaya pertama dan tunggu percobaan ulang secara terpisah:

• Upaya pertama: CLAUDE_STREAM_FIRST_BYTE_TIMEOUT_MS 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, jadi variabel yang mengubah waktu tunggu itu mengubah tunggu ini juga. Bagaimanapun, Claude Code menambahkan satu detik untuk setiap 32KB badan permintaan.
• 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.

Tidak 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 alih-alih batas waktu ini.

Yang harus dilakukan:

• 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.
• Jika terulang, perlakukan sebagai network or proxy problem. Proxy yang menerima koneksi dan tidak pernah meneruskan permintaan menghasilkan kesalahan ini pada setiap upaya.
• 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.
• 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.

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

The response above may be incomplete

Permintaan 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:

API Error: Server error mid-response. The response above may be incomplete.
API Error: Connection lost mid-response. The response above may be incomplete.
API Error: Your computer went to sleep mid-response. The response above may be incomplete.
API Error: The response stopped arriving. The response above may be incomplete.

• 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.
• Connection lost mid-response: koneksi putus.
• 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.
• 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 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.

Sebelum v2.1.227, Connection lost mid-response membaca Connection closed mid-response dan The response stopped arriving membaca Response stalled mid-stream.

Dalam empat kasus, Claude Code menangani kegagalan tanpa menampilkan pemberitahuan ini segera:

• Sebelumnya dalam respons, Claude Code baik mencoba ulang kegagalan atau mengakhiri giliran dengan kesalahan yang berbeda. Lihat Automatic retries.
• 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.
• Dalam non-interactive session, seperti run -p, run Agent SDK, atau cloud session, 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.
• Dalam subagent, 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.

Yang harus dilakukan:

• 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.
• Dalam non-interactive mode (-p):
  • 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.
  • Dengan --output-format json atau stream-json, Claude Code melaporkan pesan ini di bidang result.
  • Untuk melanjutkan giliran setelah koneksi stabil, lanjutkan sesi dan kirim continue seperti yang dijelaskan dalam Continue conversations.

Auto mode cannot determine the safety of an action

Model yang auto mode gunakan untuk mengklasifikasikan tindakan tidak dapat menghasilkan keputusan, jadi auto mode tidak menyetujui tindakan secara otomatis. Pesan yang Anda lihat tergantung pada bagaimana pengklasifikasi gagal.

Pembacaan, pencarian, dan pengeditan di dalam direktori kerja Anda melewati pengklasifikasi, jadi mereka terus bekerja dalam semua kasus ini.

Ketika model pengklasifikasi tidak tersedia:

<model> is temporarily unavailable, so auto mode cannot determine the safety of <tool> right now. Wait a moment and then try this action again.

Ketika 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). Rate-limited, overloaded, dan server errors bersifat sementara, dan mencoba ulang berfungsi. Jika (timed out) atau (connection failed) terulang, periksa koneksi Anda; lihat Unable to connect to API. Sebelum v2.1.229, pesan tidak pernah menyebutkan kategori dan membaca Wait briefly and then try this action again.

Ketika tidak ada kategori yang cocok, pesan muncul tanpa kategori dalam tanda kurung; lebih dari satu kegagalan menghasilkan bentuk itu. Di Amazon Bedrock, termasuk 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.

Yang harus dilakukan:

• Coba lagi setelah beberapa detik; Claude melihat pesan yang sama dan biasanya mencoba ulang sendiri. Kegagalan sementara tidak terkait dengan auto mode eligibility; Anda tidak perlu mengubah pengaturan
• Jika percobaan ulang terus gagal, lanjutkan dengan tugas read-only dan kembali ke tindakan yang diblokir nanti
• 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 Anda memungkinkan memanggilnya; untuk ID model Mantle, hubungi tim akun AWS Anda

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

Ketika pengklasifikasi mengembalikan respons yang tidak dapat diurai:

Auto mode could not evaluate this action and is blocking it for safety — run with --debug for details

Yang harus dilakukan:

• Coba lagi tindakan; ini biasanya berhasil pada upaya berikutnya
• Jalankan claude --debug dan ulangi tindakan untuk melihat respons pengklasifikasi yang mendasar dalam log debug

Ketika pemeriksaan keamanan API terpisah memblokir permintaan pengklasifikasi karena konten percakapan sebelumnya:

Auto mode could not evaluate this action and is blocking it for safety — a safety check separate from auto mode blocked this request because of earlier conversation content — it isn't about the action itself — run with --debug for details

Claude Code menolak tindakan tetapi memberi tahu Claude bahwa ini bukan penilaian bahwa tindakan tidak aman, dan untuk melanjutkan dengan tugas lain daripada mencoba ulang. Penolakan ini tidak dihitung terhadap auto mode's pause thresholds. Dalam run -p non-interactive, Claude Code tidak menghentikan run. Apa yang Claude terima tergantung pada tempat ia meminta tindakan:

• Ke background subagent dalam run -p tanpa --input-format stream-json, Claude Code mengembalikan hasil kesalahan yang berisi Agent aborted: auto mode classifier request refused by the safety safeguard in headless mode
• Di tempat lain, termasuk sesi interaktif dan percakapan utama run -p, Claude Code mengembalikan penolakan itu ke Claude

Sebelum v2.1.225, Claude Code menghitung penolakan ini terhadap ambang batas jeda dan mengembalikan pesan penolakan yang sama seperti blok pengklasifikasi asli.

Yang harus dilakukan:

• Ini bukan keputusan tentang tindakan Anda. Konten yang sudah ada dalam percakapan Anda memicu filter keamanan di API ketika auto mode mengirim percakapan ke pengklasifikasi
• Mencoba ulang tidak akan membantu; konten percakapan yang sama akan memicu filter lagi
• Dalam sesi interaktif, beralih ke permission mode yang berbeda sehingga Anda dapat menyetujui tindakan ketika diminta
• Mulai percakapan segar tanpa konten pemicu

Ketika percakapan telah tumbuh lebih besar dari jendela konteks pengklasifikasi:

Auto mode classifier transcript exceeded context window — falling back to manual approval (try /compact to reduce conversation size)

Apa yang terjadi pada tindakan tergantung pada tempat Claude memintanya:

• Dalam sesi interaktif, auto mode kembali ke prompt izin normal untuk tindakan itu sehingga Anda dapat menyetujui atau menolaknya secara manual
• Ke background subagent dalam run -p non-interactive 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
• Di tempat lain dalam run -p tanpa --permission-prompt-tool, tidak ada prompt untuk kembali, jadi tindakan tidak berjalan dan run berlanjut

Yang harus dilakukan:

• Dalam sesi interaktif, setujui atau tolak tindakan dalam prompt yang muncul
• Dalam sesi interaktif, jalankan /compact untuk mengurangi ukuran percakapan sehingga tindakan berikutnya cocok dalam jendela pengklasifikasi lagi

The server returned no safety verdict

Di bawah server-side classifier review, auto mode menolak tindakan ketika server tidak memberikan putusan untuk itu. Penolakan menyebutkan kategori dalam tanda kurung ketika Claude Code dapat menentukan satu, seperti (timed out):

The server-side auto mode classifier gave no verdict (timed out), so auto mode cannot determine the safety of <tool>.

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

Setelah sepuluh respons berturut-turut tanpa putusan, auto mode menghentikan giliran:

Auto mode is unavailable — the server returned no safety verdict for the last 10 responses, so Claude stopped. Send a message to try again, or switch out of auto mode.

Pesan berhenti muncul di tempat yang berbeda dalam setiap jenis sesi:

• Dalam sesi interaktif, pesan muncul sebagai peringatan dalam transkrip dan giliran berakhir
• Dalam run -p non-interactive, run berakhir dan melaporkan kesalahan eksekusi. Dengan output teks default, pesan mencetak di stderr.
• Ketika subagent mencapai batas, subagent berhenti sebelum selesai, dan Claude menerima apa pun yang dihasilkan dengan catatan bahwa auto mode menghentikannya

Yang harus dilakukan:

• Kirim pesan lain untuk membuat Claude mencoba lagi. Hitungan respons dimulai dari awal.
• Jika berhenti terulang dan permintaan Anda melewati LLM gateway or proxy, periksa apakah itu memotong respons streaming pendek atau menulis ulangnya. Server-side classifier review mengatakan perilaku gateway mana yang menyebabkan penolakan, dan gateway compatibility guide mencantumkan apa yang harus dilewatkan tanpa perubahan.
• Atur CLAUDE_CODE_AUTO_MODE_SERVER=0 sebelum Anda memulai Claude Code untuk menggunakan permintaan pengklasifikasi miliknya sendiri. Sebelum v2.1.281, Claude Code tidak membaca variabel pada koneksi langsung ke Anthropic API.
• Untuk menyetujui tindakan sendiri, switch out of auto mode

Sebelum v2.1.280, Claude Code menolak setiap tindakan dari respons tanpa putusan segera dan tidak pernah menghentikan giliran.

Agent terminated early due to an API error

Permintaan API subagent 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.

Agent terminated early due to an API error: <error detail>

Yang harus dilakukan:

• Cocokkan detail kesalahan setelah titik dua dengan bagiannya sendiri di halaman ini, seperti Usage limits atau Server errors, dan ikuti langkah bagian itu
• Setelah kesalahan yang mendasar hilang, minta Claude untuk mencoba ulang tugas atau resume the subagent

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

Batas penggunaan

Sebagian besar kesalahan di bagian ini berarti kuota yang terikat pada akun atau paket Anda telah tercapai. Tiga kesalahan bekerja berbeda: Server is temporarily limiting requests adalah throttle sisi server yang tidak terkait dengan kuota paket Anda, Usage credits required for 1M context adalah pemeriksaan hak akses daripada kuota yang habis, dan The prompt to confirm went unanswered berarti prompt persetujuan usage credits ditutup tanpa jawaban, terlepas dari apakah kuota tercapai atau tidak.

You've hit your session limit

Paket langganan mencakup tunjangan penggunaan bergulir. Ketika habis, Anda akan melihat salah satu pesan ini:

You've hit your session limit · resets 3:45pm
You've hit your weekly limit · resets Mon 12:00am
You've hit your Opus limit · resets 3:45pm
You've hit your Sonnet limit · resets 3:45pm

Blok Claude Code memblokir permintaan lebih lanjut hingga waktu reset yang ditunjukkan dalam pesan. Batas sesi dan mingguan dibagikan di semua model, jadi beralih model tidak mengembalikan akses. Batas Opus dan Sonnet masing-masing hanya berlaku untuk permintaan ke keluarga model tersebut, jadi beralih ke model di luar keluarga dengan /model membuat Anda tetap bekerja.

Dalam sesi interaktif yang masuk dengan langganan claude.ai, Claude Code juga dapat menunggu di sesi terbuka dan melanjutkan tugas yang terputus segera setelah reset. Saat menunggu, baris di bagian bawah sesi berbunyi Usage limit reached · continuing automatically at 3:45pm · esc to cancel. Tekan Esc pada prompt kosong untuk membatalkan penantian. Lihat Wait for a usage limit to reset untuk melihat apa yang Anda lihat, cara memulai atau membatalkan penantian, dan cara mematikan lanjutan otomatis. Sebelum v2.1.234, Claude Code tidak menawarkan penantian ini.

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

Yang harus dilakukan:

• Tunggu waktu reset yang ditunjukkan dalam kesalahan
• Di tab Code dari Desktop app, kartu batas sesi menawarkan kotak centang Auto-continue when limits reset. Kartu batas mingguan tidak. Ketika dicentang, aplikasi Desktop mencoba kembali giliran yang terputus setelah reset dan menampilkan waktu percobaan kembali pada kartu. Kotak centang Desktop dan pengaturan Continue automatically at usage limit CLI di /config terpisah, jadi matikan masing-masing secara terpisah.
• Untuk batas Opus atau Sonnet, jalankan /model dan beralih ke model di luar keluarga tersebut untuk terus bekerja. Setiap model memiliki cache prompt-nya sendiri, jadi permintaan berikutnya membaca ulang seluruh percakapan tanpa cache hits; lihat Switching models
• Jalankan /usage untuk melihat batas paket Anda dan kapan mereka direset
• Jalankan /usage-credits untuk membeli penggunaan tambahan di Pro dan Max, atau memintanya dari admin Anda di Team dan Enterprise. Lihat usage credits for paid plans untuk cara ini ditagih.
• Untuk meningkatkan paket Anda untuk batas dasar yang lebih tinggi, lihat claude.com/pricing

Sebelum jendela habis, Claude Code dapat memperingatkan Anda bahwa Anda telah menggunakan sebagian besar, dengan pesan seperti You've used 85% of your session limit · resets 3:45pm. Untuk memantau tunjangan sisa Anda secara terus-menerus, tambahkan bidang rate_limits ke custom status line, atau di aplikasi Desktop klik usage ring di sebelah pemilih model.

Usage credits required for 1M context

Model yang dipilih menggunakan jendela konteks diperluas 1M-token, dan paket Anda hanya mencakupnya melalui usage credits.

API Error: Usage credits required for 1M context · run /usage-credits to turn them on (they take effect after you restart Claude Code), or /model to switch to standard context

Ini adalah pemeriksaan hak akses, bukan kehabisan kuota. Ini muncul bahkan ketika tunjangan sesi dan mingguan Anda memiliki kapasitas yang tersisa. Lihat Extended context untuk paket mana yang mencakup konteks 1M secara langsung dan mana yang memerlukan usage credits. Claude Code menjalankan pemeriksaan ini ketika Anda memilih model dengan /model, dan hanya pada koneksi langsung ke API Anthropic; jika Anda menunjuk ANTHROPIC_BASE_URL ke LLM gateway, /model memungkinkan pemilihan [1m] dan gateway memutuskan apakah permintaan berhasil.

Ketika kesalahan ini muncul di tengah percakapan karena konteks tumbuh melampaui 200K token, Claude Code secara otomatis mengompres percakapan kembali di bawah batas konteks standar dan menjaga sesi pada batas itu sesudahnya, jadi tidak ada tindakan yang diperlukan. Pada versi sebelum v2.1.172, kesalahan berulang pada setiap permintaan berikutnya termasuk /compact; jalankan /clear pada versi tersebut untuk pulih. Langkah-langkah di bawah berlaku ketika Anda secara eksplisit memilih model [1m].

Yang harus dilakukan:

• Jalankan /model dan pilih varian tanpa akhiran [1m] untuk kembali ke jendela konteks standar
• Di mana pesan menyebutkan /usage-credits, jalankan untuk mengaktifkan penagihan terukur untuk varian 1M di Pro dan Max, atau untuk meminta usage credits dari admin Anda di Team dan Enterprise. Setelah usage credits aktif, mulai ulang Claude Code atau mulai sesi baru, mana pun yang pesan katakan. Sampai saat itu, sesi tetap pada batas konteks standar.
• Jika kesalahan berlanjut setelah /model, ID model 1M mungkin diatur di tempat lain. Lihat Setting your model untuk lokasi konfigurasi yang harus diperiksa dalam urutan prioritas.
• Untuk menghapus varian 1M dari pemilih model sepenuhnya, atur CLAUDE_CODE_DISABLE_1M_CONTEXT=1

Sebelum v2.1.268, pesan berakhir dengan run /usage-credits to turn them on, or /model to switch to standard context dan tidak menyebutkan restart.

The prompt to confirm went unanswered

Jika akun Anda memerlukan Fable usage-credits consent, Claude Code meminta Anda untuk mengonfirmasi sebelum permintaan Fable menagih usage credits. Ketika tidak ada yang menjawab prompt persetujuan itu dalam sesi yang mungkin tidak memiliki siapa pun di terminalnya, Claude Code menutup prompt dan mengakhiri giliran dengan salah satu pesan ini:

Fable limit reached · continuing on Fable 5.1 uses usage credits, and the prompt to confirm went unanswered — nothing was sent · answer it where this session is running, or /model to change
Fable 5.1 now uses usage credits · the prompt to confirm went unanswered — nothing was sent · answer it where this session is running, or /model to change

Pesan menyebutkan model Fable sesi, jadi di Fable 5 mereka membaca continuing on Fable 5 dan Fable 5 now uses usage credits. Sebelum v2.1.257, pesan pertama dimulai dengan Fable 5 limit reached.

Ini terjadi dalam sesi Remote Control, background sessions, dan sesi rekan tim agent team. Claude Code menampilkan prompt persetujuan hanya dalam tampilan interaktif sesi sendiri: terminal tempat ia berjalan, atau, untuk sesi latar belakang, agents view setelah Anda melampirkan. Klien Remote Control tidak dapat menampilkannya. Claude Code menutup prompt pada batas waktu dialogExpiry, lima menit secara default, atau segera setelah prompt baru tiba sementara tidak ada yang mengetik di terminal itu, seperti prompt yang dikirim dari klien Remote Control. Mengetik di terminal tempat sesi berjalan membatalkan batas waktu, dan Claude Code menunggu jawaban Anda. Dalam tampilan terlampir sesi latar belakang, mengetik tidak membatalkan batas waktu, dan prompt baru masih menutup prompt persetujuan, jadi jawab sebelum salah satu terjadi. Claude Code tidak mengirim apa pun dan menjaga model Anda, jadi ketika Anda mengirim prompt berikutnya, Claude Code menampilkan prompt persetujuan lagi.

Yang harus dilakukan:

• Di terminal tempat sesi berjalan, kirim prompt lain dan jawab prompt persetujuan ketika muncul kembali. Untuk sesi latar belakang, lampirkan terlebih dahulu dari agents view. Mengirim ulang dari klien Remote Control menampilkan pesan ini lagi, karena klien tidak dapat menampilkan prompt.
• Jalankan /model untuk beralih ke model yang tidak menagih usage credits
• Untuk memberi diri Anda lebih banyak waktu untuk mencapai terminal itu, atur dialogExpiry ke nilai yang lebih lama atau "never"

Sebelum v2.1.236, pesan ini tidak muncul: sementara klien Remote Control terhubung, Claude Code menunggu 60 detik untuk jawaban dan kemudian melanjutkan giliran pada model default Anda.

Server is temporarily limiting requests

API menerapkan throttle jangka pendek yang tidak terkait dengan kuota paket Anda.

API Error: Server is temporarily limiting requests (not your usage limit)

Claude Code membedakan ini dari batas paket Anda dengan tidak adanya header kuota terpadu yang dibawa respons batas nyata. Mulai dari v2.1.199 ini dicoba ulang secara otomatis dengan backoff sebelum ditampilkan, terlepas dari cara Anda mengautentikasi. Pada versi sebelumnya, sesi yang masuk dengan langganan claude.ai gagal pada giliran pertama; hanya API key dan Enterprise sign-ins yang mencoba ulangnya.

Yang harus dilakukan:

• Tunggu sebentar dan coba lagi
• Periksa status.claude.com jika terus berlanjut

Request rejected (429)

Anda telah mencapai batas laju yang dikonfigurasi untuk kunci API, proyek Amazon Bedrock, atau proyek Google Cloud Anda.

API Error: Request rejected (429) · this may be a temporary capacity issue. If it persists, check https://status.claude.com.

Kalimat di akhir menyebutkan di mana memeriksa kesehatan layanan dan bervariasi menurut penyedia. Konfigurasi Amazon Bedrock, Agent Platform Google Cloud, dan Microsoft Foundry menyebutkan status layanan penyedia itu sebagai gantinya dari halaman status Anthropic. ANTHROPIC_BASE_URL kustom menyebutkan host gateway.

Yang harus dilakukan:

• Jalankan /status dan konfirmasi kredensial aktif adalah yang Anda harapkan. ANTHROPIC_API_KEY yang tersesat di lingkungan Anda dapat merutekan permintaan melalui kunci tingkat rendah daripada langganan Anda.
• Periksa konsol penyedia Anda untuk batas aktif dan minta tingkat yang lebih tinggi jika diperlukan
• Untuk kunci API Anthropic, lihat rate limits reference untuk cara kerja tingkat dan cara menetapkan batas per-workspace
• Kurangi concurrency: turunkan CLAUDE_CODE_MAX_TOOL_USE_CONCURRENCY, hindari menjalankan banyak subagen paralel, atau beralih ke model yang lebih kecil dengan /model untuk run skrip volume tinggi

You've hit your monthly spend limit

Penggunaan yang disertakan paket Anda tidak dapat menutupi permintaan ini, dan usage credits yang sebaliknya akan membayarnya telah mencapai batas pengeluaran. Itu terjadi ketika salah satu jendela penggunaan paket Anda telah habis, atau ketika permintaan adalah permintaan yang hanya dibayar oleh usage credits, seperti permintaan ke model yang bills to usage credits. Pesan menyebutkan batas siapa yang memblokir Anda. Teks setelah · mengatakan cara meningkatkan batas itu, dan bervariasi dengan paket Anda dan apakah Anda mengelola penagihan:

You've hit your monthly spend limit · raise it at claude.ai/settings/usage
You've hit your individual spend limit · ask your admin for a higher limit
You've hit your org's monthly spend limit · visit claude.ai/admin-settings/usage to raise it
You've hit your team's shared budget · ask your admin to raise it at claude.ai/admin-settings/usage
You've hit your channel's monthly spend limit · an org owner or channel manager can raise it in the channel's Claude settings

team's shared budget adalah anggaran terpusat yang admin tetapkan untuk grup yang Anda termasuk; pesan tidak menyebutkan grup. channel's monthly spend limit adalah anggaran dari satu saluran Slack tempat sesi berjalan, jadi organisasi Anda mungkin masih memiliki anggaran di luar itu.

Ketika salah satu jendela paket Anda adalah yang habis, pesan juga mengatakan kapan jendela itu direset, misalnya · your session limit resets 3:45pm, dan akses kembali kemudian tanpa siapa pun menaikkan batas. Pada organisasi dengan penagihan berbasis penggunaan, pesan mengatakan usage limit sebagai gantinya dari spend limit, seperti dalam You've hit your individual usage limit.

Sebelum v2.1.239, pesan tidak menyebutkan waktu reset jendela paket. Sebelum v2.1.268, anggaran terpusat grup menghasilkan pesan individual spend limit daripada team's shared budget.

Jika Anda terhubung melalui gateway aplikasi Claude dan melihat spend limit reached huruf kecil, itu adalah batas operator gateway Anda sebagai gantinya; lihat Spend limit reached.

Yang harus dilakukan:

• Di Pro dan Max, tingkatkan batas pengeluaran bulanan Anda di Settings > Usage di claude.ai, atau jalankan /usage-credits
• Di Team dan Enterprise, tingkatkan batas di Admin settings > Usage jika Anda mengelola penagihan, atau minta admin untuk melakukannya. /usage-credits mengirim permintaan itu ke admin Anda untuk Anda
• Untuk batas saluran, minta pemilik org atau manajer saluran untuk menaikkannya di claude.ai. Lihat Per-channel limits dalam dokumentasi Claude Tag
• Jika pesan menyebutkan waktu reset untuk jendela paket Anda, Anda dapat menunggunya sebagai gantinya
• Jalankan /usage untuk melihat jendela paket Anda dan kapan masing-masing direset

Spend limit reached

Anda terhubung melalui Claude apps gateway dan telah melampaui spend cap yang operator gateway Anda tetapkan. Gateway memblokir permintaan Anda sampai periode yang dinamai direset atau operator menaikkan batas. Ini menandai setiap respons 429 yang diblokir x-should-retry: false, jadi Claude Code menampilkan pesan ini tanpa mencoba ulang.

spend limit reached (daily; resets 2026-08-09 00:00 UTC)

Pesan menyebutkan periode batas dan waktu reset, dan ketika operator mengonfigurasi blocked_message, instruksi mereka mengikutinya. Sebelum v2.1.225, pesan hanya berbunyi spend limit reached; gateway pada versi yang lebih lama masih mengirim bentuk yang lebih pendek itu.

Yang harus dilakukan:

• Tunggu waktu reset yang pesan namakan, atau ikuti instruksi operator jika pesan membawanya
• Minta operator gateway Anda untuk menaikkan batas jika Anda mencapainya secara rutin

Pesan terkait, spend limit unavailable, berarti gateway tidak dapat membaca catatan pengeluarannya dan memblokir permintaan sebagai tindakan pencegahan daripada atas batas Anda. Biasanya ini hilang dengan sendirinya; jika terus berlanjut, beri tahu operator gateway Anda.

Credit balance is too low

Organisasi Console Anda telah kehabisan kredit prabayar, atau Claude Code mengirim permintaan Anda dengan kunci API Console ketika Anda bermaksud menggunakan langganan Anda.

Credit balance is too low

Yang harus dilakukan:

• Jika Anda memiliki paket Pro, Max, Team, atau Enterprise dan melihat ini, jalankan /status dan periksa baris API key. ANTHROPIC_API_KEY yang disetujui di lingkungan Anda merutekan permintaan melalui kunci itu daripada langganan Anda. Batalkan pengaturannya di shell saat ini dan hapus dari profil shell Anda, kemudian luncurkan ulang claude. Jalankan /login jika Anda belum masuk dengan langganan Anda.
• Tambahkan kredit di platform.claude.com/settings/billing, dan pertimbangkan untuk mengaktifkan auto-reload di sana sehingga saldo diisi ulang sebelum mencapai nol
• Atur batas pengeluaran per-workspace di Console untuk mencegah satu proyek menguras saldo org. Lihat Manage costs effectively.

Could not update your spend limit

Server menolak perubahan batas pengeluaran yang Anda buat dari prompt yang muncul ketika Anda mencapai batas pengeluaran Anda.

Could not update your spend limit: <reason from the server>

Ketika server menjelaskan penolakan, pesan berakhir dengan alasan itu, dan mencoba ulang nilai yang sama gagal lagi. Ketika kegagalan tidak memiliki alasan yang disediakan server, seperti koneksi yang terputus, pesan berbunyi Could not update your spend limit. Press Enter to retry. dan mencoba ulang dapat berhasil. Sebelum v2.1.216, Claude Code menampilkan bentuk generik untuk setiap kegagalan.

Yang harus dilakukan:

• Jika pesan menyertakan alasan, pilih batas yang memuaskannya, seperti jumlah yang lebih rendah
• Jika pesan hanya menampilkan bentuk generik, coba ulang; kegagalan mungkin bersifat sementara
• Jika perubahan terus gagal, buatlah dari claude.ai billing settings Anda di browser sebagai gantinya

Kesalahan autentikasi

Kesalahan ini berarti Claude Code tidak dapat membuktikan identitas Anda kepada API. Jalankan /status kapan saja untuk melihat kredensial mana yang saat ini aktif.

Belum masuk

Tidak ada kredensial yang valid tersedia untuk sesi ini.

Not logged in · Please run /login

Yang harus dilakukan:

• Jalankan /login untuk autentikasi dengan langganan Claude Anda atau akun Console
• Jika Anda mengharapkan variabel lingkungan untuk mengautentikasi Anda, konfirmasi bahwa ANTHROPIC_API_KEY diatur dan diekspor di shell tempat Anda meluncurkan claude
• Untuk CI atau otomasi di mana login interaktif tidak mungkin, konfigurasikan skrip apiKeyHelper yang mengambil kunci saat startup
• Lihat Prioritas autentikasi untuk memahami kredensial mana yang digunakan Claude Code ketika beberapa ada

Jika Anda diminta untuk masuk berulang kali, lihat Belum masuk atau token kedaluwarsa untuk pemeriksaan jam sistem dan langkah pemulihan penyimpanan kredensial macOS.

Tidak dapat menyelesaikan metode autentikasi

Sesi mencapai klien API tanpa kredensial apa pun. Sesi latar belakang dan sesi cloud menampilkan pesan ini ketika pekerja dimulai tanpa kredensial. Jalankan interaktif, -p, dan Agent SDK melaporkan kondisi yang sama seperti Belum masuk dan menulis string ini hanya ke log debug mereka, jadi jika Anda menemukannya di sana, ikuti entri itu sebagai gantinya.

Could 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

Pada versi saat ini, kesalahan berarti tidak ada kredensial yang tersedia untuk proses pekerja. Sebelum v2.1.174, sesi latar belakang yang ditugaskan ke pekerja pra-inisialisasi yang 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.

Yang harus dilakukan:

• Tingkatkan ke v2.1.176 atau lebih baru jika ini muncul dalam sesi latar belakang atau cloud dan kredensial Anda sudah dikonfigurasi
• Konfirmasi bahwa ANTHROPIC_API_KEY, CLAUDE_CODE_OAUTH_TOKEN, atau kredensial penyedia cloud Anda diatur di lingkungan yang meluncurkan pekerja, bukan hanya di shell interaktif Anda
• Untuk Agent SDK, lihat pengaturan autentikasi dalam panduan cepat
• Jalankan /status dalam sesi interaktif di lingkungan yang sama untuk mengonfirmasi sumber kredensial mana yang diselesaikan

Kunci API tidak valid

Variabel lingkungan ANTHROPIC_API_KEY atau skrip apiKeyHelper mengembalikan kunci yang ditolak API, atau Claude Code memblokir kunci dari ANTHROPIC_API_KEY sebelum mengirimnya.

Invalid API key · Fix external API key

Ketika 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 oleh header HTTP dan menghentikan permintaan sebelum mengirimnya. Lihat Nilai header permintaan tidak valid untuk cara membaca deskripsi dan memperbaiki nilai.

Yang harus dilakukan:

• Periksa kesalahan ketik dan konfirmasi bahwa kunci belum dicabut di Console
• 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.
• Batalkan pengaturan ANTHROPIC_API_KEY dan jalankan /login untuk menggunakan autentikasi langganan sebagai gantinya
• Jika kunci berasal dari skrip apiKeyHelper, jalankan skrip secara langsung untuk mengonfirmasi bahwa skrip mencetak kunci yang valid ke stdout
• Jalankan /status untuk mengonfirmasi sumber kredensial mana yang sebenarnya digunakan Claude Code

Skrip apiKeyHelper Anda gagal

Claude Code menjalankan perintah dalam pengaturan 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:

• Perintah keluar dengan kesalahan atau waktu habis
• Perintah tidak mencetak apa pun ke stdout
• Perintah mencetak sesuatu selain kunci, seperti spanduk login atau baris log. Panel menunjukkan 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.

Your apiKeyHelper script is failing · This usually means you need to re-authenticate with your provider · Run /status to see the script's error output

Dalam mode non-interaktif, stderr juga membawa alasan spesifik, diawali dengan apiKeyHelper failed:.

Claude 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 penuh mengirim ulang permintaan dengan kredensial placeholder dan kemudian melaporkan kesalahan autentikasi 401 generik sebagai gantinya dari kegagalan skrip.

Menjalankan /login tidak membantu di sini: output pembantu mengambil prioritas atas login yang disimpan selama pengaturan ada.

Yang harus dilakukan:

• Jalankan perintah yang dikonfigurasi dalam apiKeyHelper secara langsung di shell Anda untuk mereproduksi kegagalan
• Jika perintah melaporkan sesi yang kedaluwarsa, autentikasi ulang dengan penyedia kredensial Anda, misalnya dengan masuk kembali ke SSO atau brankas rahasia Anda
• Perbaiki perintah sehingga hanya mencetak kunci ke stdout, sebagai token ASCII yang dapat dicetak tunggal hingga 16.384 karakter, dan keluar dengan kode 0. Lihat putar kredensial dengan apiKeyHelper untuk pengaturan yang berfungsi.
• Jalankan /status untuk melihat kegagalan dan konfirmkan bahwa apiKeyHelper adalah sumber kredensial aktif. Baris apiKeyHelper menunjukkan Failing dengan detail kegagalan terakhir, seperti kode keluar dan output kesalahan perintah, dan hilang setelah jalankan yang berhasil berikutnya. Sebelum v2.1.274, /status hanya menunjukkan sumber kredensial, bukan kegagalan.
• Setiap kali perintah gagal, kode keluar dan output kesalahannya juga muncul dalam panel Authentication di terminal. Sebelum v2.1.212, panel berjudul Cloud authentication.

Nilai header permintaan tidak valid

Nilai yang Claude Code akan kirim sebagai header permintaan berisi 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 menamai variabel atau pengaturan untuk diperbaiki. Penyebab umum adalah kredensial yang ditempel dari dokumen atau obrolan yang membawa karakter tak terlihat atau jeda baris yang tersesat.

Claude Code menjalankan pemeriksaan ini ketika mengirim permintaan ke Claude API secara langsung atau melalui gateway LLM. Pada penyedia cloud pihak ketiga seperti Amazon Bedrock, Claude Code tidak menjalankannya sebelum mengirim.

Invalid auth token · Fix external auth token
Invalid ANTHROPIC_CUSTOM_HEADERS · Fix the environment variable
Invalid request header from the environment · Fix the environment variable

Bagian pertama dari pesan tergantung pada tempat nilai buruk berasal:

• Invalid auth token: token pembawa dari ANTHROPIC_AUTH_TOKEN atau CLAUDE_CODE_OAUTH_TOKEN
• Invalid ANTHROPIC_CUSTOM_HEADERS: nama header atau nilai yang Anda atur dalam ANTHROPIC_CUSTOM_HEADERS. 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.
• 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.

Claude Code melaporkan ANTHROPIC_API_KEY buruk yang ditangkap oleh pemeriksaan ini sebagai Kunci API tidak valid, dengan deskripsi trailing yang sama. Ini melaporkan kredensial /login yang disimpan buruk sebagai Belum masuk sebagai gantinya; jalankan /login untuk menyimpan yang baru. Output skrip 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.

Setelah · kedua, pesan menjelaskan masalahnya, seperti dalam contoh lengkap ini:

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

Posisi menghitung karakter mulai dari satu. Deskripsi dibangun dari frasa tetap dan hitungan 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.

Yang harus dilakukan:

• Atur ulang variabel atau pengaturan yang dinamai pesan, mengetik ulang karakter di sekitar posisi yang dilaporkan daripada menempel dari sumber yang sama lagi
• Untuk ANTHROPIC_CUSTOM_HEADERS, simpan satu pasangan Name: Value per baris dan tulis ulang pasangan yang dihitung pesan
• Jalankan /status untuk mengonfirmasi sumber kredensial mana yang aktif

Organisasi ini telah dinonaktifkan

Claude Code menggunakan ANTHROPIC_API_KEY lama dari organisasi Console yang dinonaktifkan. Ketika Anda memiliki login langganan yang disimpan, kunci menimpanya.

Your ANTHROPIC_API_KEY belongs to a disabled organization · Unset the environment variable to use your subscription instead
Your ANTHROPIC_API_KEY belongs to a disabled organization · Update or unset the environment variable
API Error: 400 ... This organization has been disabled.

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

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

Yang harus dilakukan:

• Batalkan pengaturan ANTHROPIC_API_KEY di shell saat ini dan hapus dari profil shell Anda, kemudian luncurkan ulang claude
• 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.
• Jalankan /status setelahnya untuk mengonfirmasi kredensial aktif adalah langganan Anda
• Jika tidak ada variabel lingkungan yang diatur dan kesalahan berlanjut, organisasi yang dinonaktifkan adalah yang terikat pada /login Anda. Hubungi dukungan atau masuk dengan akun berbeda.

Organisasi Anda telah menonaktifkan autentikasi kunci API

Pesan 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:

Your organization has disabled API key authentication · Run /login to sign in with your claude.ai account
Your organization has disabled API key authentication · Unset ANTHROPIC_API_KEY to use your claude.ai account instead
Your organization has disabled API key authentication · Unset ANTHROPIC_API_KEY and run /login to sign in with your claude.ai account
Your organization has disabled API key authentication · Unset the apiKeyHelper setting and run /login to sign in with your claude.ai account

Variabel lingkungan dan apiKeyHelper mengambil prioritas atas /login, jadi menjalankan /login saja tidak membantu sementara salah satu masih memasok kunci. Lihat Prioritas autentikasi.

Yang harus dilakukan:

• 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
• Jika pesan menamai apiKeyHelper, hapus pengaturan apiKeyHelper dari settings.json Anda
• Jalankan /login untuk masuk dengan akun claude.ai Anda
• Jalankan /status setelahnya untuk mengonfirmasi kredensial aktif adalah langganan Anda daripada kunci API
• Jika Anda memerlukan autentikasi kunci API untuk otomasi, minta admin organisasi Anda untuk mengaktifkannya kembali di Console

Organisasi Anda telah menonaktifkan akses langganan Claude

Organisasi Claude Anda tidak memungkinkan masuk ke Claude Code dengan login langganan. Menjalankan /login lagi dengan akun yang sama mengembalikan kesalahan yang sama.

Your organization has disabled Claude subscription access for Claude Code · Use an Anthropic API key instead, or ask your admin to enable access

Ini adalah pengaturan organisasi sisi server, jadi tidak dapat ditimpa dari pengaturan lokal, variabel lingkungan, atau bendera CLI.

Agent SDK dan mode non-interaktif -p menampilkan ini sebagai kode kesalahan oauth_org_not_allowed.

Yang harus dilakukan:

• Minta admin Anda untuk mengaktifkan akses Claude Code untuk organisasi Anda
• Autentikasi dengan kunci API Console sebagai gantinya dari langganan Anda. Lihat Autentikasi Claude Console untuk pengaturan.
• Jika Anda adalah admin dan tidak melihat opsi untuk mengaktifkan akses, hubungi dukungan Anthropic

Rutinitas dinonaktifkan oleh kebijakan organisasi Anda

Pemilik 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 di claude.ai/code. Pada Claude Code v2.1.227 atau lebih baru, pengaturan yang sama juga menyembunyikan /schedule di CLI.

Routines are disabled by your organization's policy.

Ini adalah pengaturan sisi server, jadi tidak dapat ditimpa dari pengaturan lokal, variabel lingkungan, atau bendera CLI.

Yang harus dilakukan:

• Minta Pemilik dalam organisasi Anda untuk mengaktifkan toggle Routines di claude.ai/admin-settings/claude-code
• Untuk pekerjaan terjadwal satu kali yang tidak memerlukan rutinitas tingkat organisasi, lihat tugas terjadwal

Remote Control memerlukan Anthropic API

Sesi tidak berbicara langsung dengan Anthropic API, jadi tidak ada backend claude.ai untuk Remote Control untuk dipasangkan.

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

Kalimat kedua menjelaskan apa yang mengarahkan sesi menjauh dari Anthropic API; sebelum v2.1.219, pesan hanya kalimat pertama. Tergantung pada penyebabnya, pesan menamai:

• Variabel penyedia CLAUDE_CODE_USE_*, seperti CLAUDE_CODE_USE_BEDROCK untuk Amazon Bedrock atau CLAUDE_CODE_USE_VERTEX untuk Platform Agen Google Cloud
• ANTHROPIC_BASE_URL menunjuk ke host selain api.anthropic.com, seperti gateway LLM atau proxy, bahkan ketika Anda masuk dengan claude.ai; sebelum v2.1.196, URL dasar khusus tidak memblokir Remote Control
• ANTHROPIC_UNIX_SOCKET diatur, jadi sesi mengirim permintaannya melalui soket lokal daripada ke api.anthropic.com
• Masuk gateway cloud perusahaan melalui /login, yang tidak mendukung Remote Control dan tidak memiliki variabel untuk dibatalkan pengaturannya

Yang harus dilakukan:

• 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 dengan Anthropic API
• Jika variabel tidak diatur di shell Anda, periksa kunci env dalam file pengaturan Anda, yang menerapkan variabel lingkungan ke setiap sesi
• Untuk pesan startup Remote Control ini dan lainnya, lihat Troubleshoot Remote Control

Remote Control tidak dapat menyegarkan login Anda

Claude Code menjalankan koneksi 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.

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

Ketika 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:

Remote Control disconnected — Claude.ai login expired — run /login to restore Remote Control
Remote Control disconnected — Claude.ai login expired — run /login, then /remote-control
Remote Control disconnected — Claude.ai login was rejected — run /login, then /remote-control
Remote Control disconnected — OAuth token unavailable — run /login to restore Remote Control
Remote Control disconnected — OAuth token refresh failed — run /login to re-authenticate
Remote Control disconnected — JWT refresh failed: no OAuth token — run /login
Remote Control disconnected — Signed out of Claude — run /login, then /remote-control

Claude Code menamai penyebabnya di tengah pesan:

• Claude.ai login expired dan Claude.ai login was rejected: claude.ai tidak lagi menerima token login yang disimpan Anda, karena kedaluwarsa atau dicabut
• OAuth token unavailable: Claude Code tidak memiliki token login yang disimpan ketika kredensial koneksi jatuh tempo untuk pembaruan
• OAuth token refresh failed: claude.ai menolak token login yang disimpan Anda saat Claude Code terhubung kembali, dan menyegarkan token tidak menghasilkan yang baru
• JWT refresh failed: no OAuth token: Claude Code tidak menemukan token login yang disimpan untuk diperbarui
• Signed out of Claude: Anda keluar di mesin ini, misalnya dengan menjalankan /logout di terminal lain, jadi Claude Code tidak memiliki login yang disimpan untuk memperbarui koneksi

Yang harus dilakukan:

• Jalankan /login untuk masuk lagi
• 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.

Sebelum v2.1.224, OAuth token refresh failed — run /login to re-authenticate membaca OAuth token refresh failed — re-authenticate, then re-enable Remote Control, dan JWT refresh failed: no OAuth token — run /login membaca 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.

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

Remote Control berhenti karena akun yang masuk berubah

Claude Code menampilkan baris ini selama sesi Remote Control ketika Anda masuk ke akun claude.ai atau organisasi berbeda di mesin ini. Anda membuat sakelar di luar sesi Claude Code, misalnya dengan menjalankan /login di terminal lain.

Sesi Remote Control yang Anda mulai saat masuk melalui /login milik akun claude.ai dan organisasi yang masuk pada saat itu.

Remote 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

Claude Code menghentikan sesi Remote Control segera setelah claude.ai mengonfirmasi bahwa akun atau organisasi berubah. Sesi lokal Anda terus berjalan tanpa Remote Control.

Yang harus dilakukan:

• Jalankan /remote-control untuk memulai sesi Remote Control baru di bawah akun atau organisasi saat ini
• Untuk beralih kembali, jalankan /login dan masuk ke akun atau organisasi sebelumnya lagi. Kemudian jalankan /remote-control.

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

Remote Control berhenti karena aplikasi yang menjalankan sesi keluar atau beralih akun

Ketika 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 dan mengirim aplikasi salah satu baris ini:

Remote Control stopped — the app running this session is now signed in to a different Claude account
Remote Control stopped — the app running this session is signed out of Claude. Sign in there, then turn Remote Control back on

Sesi lokal Anda terus berjalan tanpa Remote Control.

Yang harus dilakukan:

• Jika aplikasi keluar, masuk lagi, kemudian aktifkan Remote Control kembali di aplikasi
• 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.

Sebelum v2.1.238, Claude Code mengirim aplikasi pesan run /login yang tercantum di bawah Remote Control tidak dapat menyegarkan login Anda dalam kedua kasus.

Token OAuth dicabut atau kedaluwarsa

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

Kedua 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 sebagai gantinya. Jika Anda autentikasi dengan token berumur panjang dalam CLAUDE_CODE_OAUTH_TOKEN, Anda melihat pesan yang sama ketika token itu kedaluwarsa atau dicabut.

OAuth token revoked · Please run /login
Please run /login · API Error: 401 OAuth token has expired ...

Yang harus dilakukan:

• Jalankan /login untuk masuk lagi
• Jika kesalahan kembali dalam sesi yang sama setelah autentikasi ulang, jalankan /logout terlebih dahulu untuk sepenuhnya menghapus token yang disimpan, kemudian /login
• 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 menunjukkan kredensial ini sebagai baris Auth token membaca CLAUDE_CODE_OAUTH_TOKEN. Hasilkan token segar dengan claude setup-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.
• Untuk prompt berulang untuk masuk di seluruh peluncuran, lihat pemeriksaan jam sistem dan langkah pemulihan penyimpanan kredensial macOS dalam Troubleshooting
• Untuk kegagalan lainnya termasuk 403 Forbidden dan masalah browser OAuth, lihat Login dan autentikasi

API Error: 401 Kredensial autentikasi tidak valid

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

Please run /login · API Error: 401 Invalid authentication credentials

Yang harus dilakukan:

• Jika /status menunjukkan baris API key yang tidak ditandai sebagai tidak digunakan, ANTHROPIC_API_KEY yang disetujui ANTHROPIC_API_KEY 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.
• Jika /status hanya menunjukkan login Anda, jalankan /login sekali. Jika kredensial dicabut, login segar menggantinya.
• 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.
• Jika ANTHROPIC_BASE_URL menunjuk ke gateway LLM, teks setelah 401 adalah pesan gateway Anda daripada Anthropic, dan /login tidak mengubahnya. Perbaiki kredensial yang diharapkan gateway Anda sebagai gantinya.

Login kedaluwarsa

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

Sebelum 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 atau 401 sebagai gantinya dari prompt untuk masuk.

Login expired · Please run /login

Dalam mode non-interaktif (-p) dan Agent SDK, pesan berbunyi sebagai berikut, dan kode kesalahan terstruktur adalah authentication_failed:

Failed to authenticate: OAuth session expired and could not be refreshed

Ini bukan keadaan yang sama seperti Token OAuth dicabut atau kedaluwarsa. Pesan-pesan itu melaporkan penolakan yang dikembalikan API. Claude Code 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 usang, Claude Code menunjukkan Akun Anda ditahan sebagai gantinya.

Sesi yang diautentikasi dengan kunci API, CLAUDE_CODE_OAUTH_TOKEN, atau penyedia pihak ketiga tidak menggunakan login yang disimpan dan tidak pernah melihat pesan ini.

Anda dapat memeriksa keadaan ini sebelum permintaan gagal: /status menunjukkan 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 menunjukkan 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.

Yang harus dilakukan:

• Jalankan /login untuk masuk lagi. Mencoba lagi tanpa masuk menunjukkan pesan yang sama pada setiap permintaan.
• 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.
• Jika masuk terus gagal, lihat Login dan autentikasi

Login Claude tidak diterima

Anda mencoba memulai sesi cloud, dan server menolak untuk membuatnya dengan 401: itu tidak menerima login Claude yang dikirim mesin ini, biasanya karena login kedaluwarsa atau dicabut.

Bagian pertama dari baris adalah alasan server sendiri ketika memberikan satu. Jika tidak, baris berbunyi:

Claude login not accepted · Run /login, then try again

Yang harus dilakukan:

• Jalankan /login, selesaikan masuk, kemudian mulai sesi lagi

Artefak memerlukan login claude.ai

Claude Code menolak artefak publikasi atau baca karena sesi tidak memiliki login claude.ai yang dapat digunakan untuk artefak.

Setiap bentuk pesan dimulai dengan kata-kata yang sama, diikuti dengan solusi yang tergantung pada cara sesi Anda autentikasi. Tanpa kredensial yang bersaing, itu berbunyi:

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

Yang harus dilakukan:

• Jalankan /login dan pilih Claude account with subscription. Opsi Anthropic Console account tidak menyediakan kredensial claude.ai.
• 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
• Ketika pesan mengatakan sesi jarak jauh ini autentikasi melalui mesin yang meluncurkannya, masuk ke claude.ai di mesin itu, kemudian hubungkan kembali sesi
• Ketika pesan mengatakan kredensial disuntikkan oleh lingkungan host sesi, Anda tidak dapat mengubahnya dalam sesi itu; mulai sesi yang masuk ke claude.ai
• Lihat Ketersediaan untuk persyaratan lain yang dimiliki artefak, seperti paket, penyedia model, dan kebijakan organisasi

Kebijakan administrator memerlukan masuk Cloud gateway

Pengaturan terkelola administrator di mesin ini menetapkan forceLoginMethod ke "gateway" atau menetapkan forceLoginGatewayUrl. Kecuali Anda memilih penyedia cloud melalui variabel seperti CLAUDE_CODE_USE_BEDROCK, Claude Code kemudian hanya menerima masuk gateway aplikasi Claude. Anda melihat salah satu dari dua pesan:

Not signed in to the Cloud gateway — run /login.

Permintaan model gagal dengan pesan ini ketika sesi tidak memiliki masuk gateway, misalnya karena Anda belum menjalankan /login sejak kebijakan mencapai mesin.

Jika Anda juga memiliki kredensial ANTHROPIC_API_KEY, ANTHROPIC_AUTH_TOKEN, atau apiKeyHelper yang dikonfigurasi dan pengaturan terkelola menetapkan forceLoginMethod, Claude Code keluar saat startup sebagai gantinya dengan pesan yang dimulai:

Administrator policy requires a Cloud gateway sign-in on this machine; the
Anthropic-issued credential configured here (ANTHROPIC_API_KEY,
ANTHROPIC_AUTH_TOKEN, or apiKeyHelper) is not used.

Yang harus dilakukan:

• Jalankan /login dan selesaikan masuk di layar Cloud gateway
• Untuk pesan startup, hapus pengaturan ANTHROPIC_API_KEY, ANTHROPIC_AUTH_TOKEN, atau apiKeyHelper yang Anda konfigurasi, kemudian mulai claude dan jalankan /login
• Jika Anda percaya mesin tidak boleh memerlukan gateway, minta administrator yang mengelolanya untuk menghapus forceLoginMethod dan forceLoginGatewayUrl dari pengaturan terkelolanya

Pada v2.1.265, regresi juga menunjukkan 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.

Sebelum 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 terkelolanya hanya menetapkan forceLoginGatewayUrl tidak memerlukan masuk gateway, dan Claude Code menggunakan kredensial sisa di sana.

Akun Anda ditahan

Akun Claude di balik login Anda telah ditangguhkan. Claude Code menunjukkan pesan pertama ketika mencoba memperbarui login yang disimpan dan mempelajari tentang penahan, dan yang kedua ketika masuk yang Anda selesaikan di browser melaporkannya:

Your account is on hold and can't use Claude Code. View details or appeal: https://claude.ai/restricted
Your account is on hold and can't sign in to Claude Code. View details or appeal: https://claude.ai/restricted

Masuk lagi dengan akun yang sama tidak menghapus pesan, karena penahan ada di akun daripada login. Dalam mode non-interaktif (-p) dan Agent SDK, kode kesalahan terstruktur adalah account_on_hold. Sebelum v2.1.235, Claude Code melaporkan akun yang ditahan sebagai Login kedaluwarsa · Silakan jalankan /login, yang langkah pemulihan tidak dapat menghapus penahan.

Yang harus dilakukan:

• Buka tautan dalam pesan untuk melihat detail penahan atau mengajukan banding
• 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

Login profil Anthropic kedaluwarsa

Claude Code mengautentikasi melalui profil kredensial Anthropic yang kredensial login yang disimpan telah kedaluwarsa, dan profil tidak menyimpan kredensial penyegaran yang dapat digunakan Claude Code untuk memperbarui. Claude Code menghentikan setiap permintaan secara lokal tanpa mencoba lagi, karena percobaan lagi akan membaca kredensial yang sama yang kedaluwarsa.

Anthropic profile login expired · Re-authenticate your Anthropic profile
Anthropic profile login expired · Run /login to use your claude.ai account instead, or re-authenticate the profile

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

Pada mesin yang menawarkan masuk tanpa kunci, 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:

• Ketika Anda menetapkan ANTHROPIC_PROFILE secara eksplisit, pesan berakhir dengan Re-authenticate your Anthropic profile.
• 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 menunjukkan bentuk Re-authenticate your Anthropic profile dalam kasus ini juga.

Yang harus dilakukan:

• Masuk ke profil lagi, kemudian coba lagi: pada mesin yang menawarkan masuk tanpa kunci, 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 membuatnya
• Jika administrator menyediakan kredensial profil, minta mereka untuk mengeluarkan yang baru
• Jalankan /status untuk mengonfirmasi sumber kredensial aktif dan nama profil
• Untuk berhenti menggunakan profil, batalkan pengaturan ANTHROPIC_PROFILE jika Anda menetapkannya, kemudian autentikasi dengan cara lain, seperti /login atau ANTHROPIC_API_KEY

Persyaratan cakupan OAuth

Token yang disimpan mendahului cakupan izin yang dibutuhkan fitur yang lebih baru. Anda melihat ini paling sering dari /usage dan indikator penggunaan baris status:

OAuth token does not meet scope requirement: user:profile

Yang harus dilakukan:

• Jalankan /login untuk mendapatkan token baru dengan cakupan saat ini. Anda tidak perlu keluar terlebih dahulu.

claude.ai menolak token sesi

Permintaan konektor claude.ai gagal karena claude.ai menolak token dari login Claude Code Anda, biasanya login yang kedaluwarsa dan tidak dapat disegarkan. Token yang ditolak adalah login Anda, bukan otorisasi konektor sendiri di claude.ai, jadi mengotorisasi konektor lagi tidak menyelesaikannya. Dalam /mcp, konektor menunjukkan sebagai connected · session token rejected dan tampilan detailnya berbunyi:

claude.ai rejected the session token. Run /login, then reconnect.

Yang harus dilakukan:

• Jalankan /login untuk masuk lagi
• 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.

Sebelum v2.1.222, Claude Code menandai konektor sebagai memerlukan autentikasi sebagai gantinya, yang menunjukkan Anda pada alur otorisasi konektor meskipun menyelesaikannya tidak menyelesaikan keadaan.

Server MCP memerlukan Anda untuk masuk lagi

Server MCP jarak jauh menolak kredensial pada panggilan alat di tengah sesi, biasanya karena masuk atau token kedaluwarsa atau karena token kekurangan izin yang dibutuhkan alat. Panggilan alat gagal, dan /mcp menandai server sebagai memerlukan autentikasi.

Untuk server yang Anda masuki dari Claude Code, termasuk konektor claude.ai, masuk kedaluwarsa atau dicabut:

MCP server "<name>" needs you to sign in again (run /mcp to re-authenticate)

Jalankan /mcp, pilih server, dan masuk lagi dari menunya.

Untuk server yang dikonfigurasi dengan skrip headersHelper, Claude Code sudah menjalankan kembali pembantu dan mencoba lagi panggilan sekali sebelum menunjukkan ini:

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

Periksa bahwa pembantu mengembalikan kredensial yang diterima server, kemudian hubungkan kembali dari /mcp, yang menjalankan pembantu lagi.

Untuk server dengan header Authorization statis dalam konfigurasinya:

MCP server "<name>" rejected the Authorization header in its config (update it, then run /mcp to reconnect)

Perbarui nilai header tempat server dikonfigurasi, kemudian hubungkan kembali dari /mcp.

Sebelum v2.1.273, kasus masuk yang kedaluwarsa, headersHelper, dan header Authorization semuanya menunjukkan MCP server "<name>" requires re-authorization (token expired).

Server 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:

MCP server "<name>" needs additional permissions (scope: "<scope>") — run /mcp to re-authenticate

Jalankan /mcp, pilih server, dan autentikasi lagi dari menunya.

Ketika konfigurasi server tidak menetapkan oauth.scopes atau authServerMetadataUrl, 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.

Sebelum v2.1.274, kasus ini menunjukkan pesan needs you to sign in again, dan sebelum v2.1.273 itu menunjukkan requires re-authorization (token expired) seperti kasus lainnya.

Ketidakcocokan penerbit dalam respons otorisasi

Selama masuk OAuth MCP, 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 menunjukkan kesalahan dalam menu server /mcp setelah masuk browser:

Issuer mismatch in authorization response (RFC 9207): expected "https://auth.example.com", received "https://other.example.com"

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.

Yang harus dilakukan:

• Coba masuk lagi dari /mcp
• 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-nya
• Untuk terhubung saat server sedang diperbaiki, mulai Claude Code dengan MCP_SDK_GENERATION=v1, yang runtime-nya tidak menjalankan pemeriksaan ini. Ini menghapus perlindungan terhadap serangan pencampuran, jadi lebih suka perbaikan sisi server

Sebelum v2.1.232, Claude Code menggunakan runtime v2 hanya dalam peluncuran bertahap atau ketika Anda menetapkan MCP_SDK_GENERATION=v2.

Kredensial AWS kedaluwarsa atau tidak valid

Token sesi AWS Anda kedaluwarsa atau ditolak. Pesan ini muncul pada 401 dari Claude Platform di AWS atau titik akhir Mantle, yang merupakan cara penyedia itu melaporkan token keamanan yang kedaluwarsa.

Petunjuk tindakan di tengah bervariasi dengan pengaturan Anda. Bagian yang stabil adalah AWS credentials expired or invalid terkemuka:

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

Sebelum v2.1.273, pesan ini muncul hanya ketika awsAuthRefresh dikonfigurasi.

Yang harus dilakukan:

• Jika petunjuk mengatakan kredensial dikelola oleh lingkungan ini, aplikasi yang meluncurkan Claude Code memiliki kredensial dan langkah lain di sini tidak berlaku: coba lagi, atau hubungi administrator Anda
• Jika awsAuthRefresh diatur, jalankan perintah yang dinamai dalam pesan, seperti aws sso login --profile myprofile, di terminal lain dan selesaikan masuk browser, kemudian coba lagi. Jika tidak, segarkan kredensial AWS yang Anda gunakan sendiri: masuk SSO, kunci akses, kunci API, atau token proxy Anda
• 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
• 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 sama

Autentikasi AWS gagal

Penyedia AWS Anda mengembalikan 403, atau Amazon Bedrock mengembalikan 401.

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

401 dari Amazon Bedrock juga mendarat di sini daripada di bawah Kredensial AWS kedaluwarsa atau tidak valid, 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.

Penyegaran kredensial memperbaiki token yang kedaluwarsa dan tidak dapat memperbaiki penyebab lain, jadi pesan menawarkan keduanya:

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

Petunjuk tindakan di tengah bervariasi dengan pengaturan Anda. Bagian yang stabil adalah AWS authentication failed terkemuka.

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

Sebelum v2.1.273, pesan ini muncul hanya ketika awsAuthRefresh dikonfigurasi.

Yang harus dilakukan:

• Jika petunjuk mengatakan kredensial dikelola oleh lingkungan ini, aplikasi yang meluncurkan Claude Code memiliki kredensial dan langkah lain di sini tidak berlaku: coba lagi, atau hubungi administrator Anda
• Segarkan kredensial AWS Anda jika kredensial yang kedaluwarsa adalah penyebabnya: jalankan perintah awsAuthRefresh yang dinamai dalam pesan ketika satu diatur, atau segarkan masuk SSO, kunci akses, kunci API, atau token proxy Anda sendiri
• Jika kredensial Anda saat ini, konfirmasi izin IAM dalam Konfigurasi IAM dilampirkan ke identitas yang Anda gunakan dan model yang dipilih diaktifkan untuk akun dan wilayah Anda
• Jalankan aws sts get-caller-identity untuk mengonfirmasi identitas mana yang digunakan permintaan Anda; profil AWS_PROFILE yang sudah usang atau profil default adalah penyebab umum ketidakcocokan izin

Kredensial Google Cloud kedaluwarsa atau tidak valid

Kredensial Google Cloud Anda untuk Platform Agen Google Cloud kedaluwarsa atau ditolak: permintaan mengembalikan 401, yang merupakan cara Platform Agen melaporkan kedaluwarsa kredensial.

Petunjuk tindakan di tengah bervariasi dengan pengaturan Anda. Bagian yang stabil adalah Google Cloud credentials expired or invalid terkemuka:

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

Yang harus dilakukan:

• Jika petunjuk mengatakan kredensial dikelola oleh lingkungan ini, aplikasi yang meluncurkan Claude Code memiliki kredensial dan langkah lain di sini tidak berlaku: coba lagi, atau hubungi administrator Anda
• Jika Anda autentikasi dengan kredensial default aplikasi, jalankan perintah gcpAuthRefresh yang dinamai dalam pesan, atau gcloud auth application-default login, dan selesaikan masuk, kemudian coba lagi
• Jika Anda merutekan melalui gateway LLM dengan CLAUDE_CODE_SKIP_VERTEX_AUTH diatur, segarkan token gateway dalam ANTHROPIC_AUTH_TOKEN atau ANTHROPIC_CUSTOM_HEADERS, kemudian coba lagi
• Jika Anda autentikasi dengan file kunci akun layanan, konfirmasi GOOGLE_APPLICATION_CREDENTIALS menunjuk ke kunci yang valid. Lihat Konfigurasi kredensial GCP
• Jika kesalahan berulang setelah penyegaran, konfirmasi identitas bekerja di luar Claude Code dengan gcloud auth application-default print-access-token di shell yang sama

Sebelum v2.1.273, 401 dari Platform Agen menunjukkan pesan Please run /login atau Failed to authenticate generik sebagai gantinya, yang tidak dapat menyegarkan kredensial Google Cloud.

Autentikasi Google Cloud gagal

Platform Agen Google Cloud 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.

Petunjuk tindakan di tengah bervariasi dengan pengaturan Anda. Bagian yang stabil adalah Google Cloud authentication failed terkemuka:

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

Yang harus dilakukan:

• Jika petunjuk mengatakan kredensial dikelola oleh lingkungan ini, aplikasi yang meluncurkan Claude Code memiliki kredensial dan langkah lain di sini tidak berlaku: coba lagi, atau hubungi administrator Anda
• Konfirmkan peran dalam Konfigurasi IAM diberikan kepada identitas yang Anda autentikasi dengan
• Konfirmkan model diaktifkan untuk proyek Anda. Lihat Minta akses model

Sebelum v2.1.273, 403 dari Platform Agen menunjukkan pesan Please run /login atau Failed to authenticate generik sebagai gantinya, yang tidak dapat menyegarkan kredensial Google Cloud.

Autentikasi Microsoft Foundry gagal

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 tengah bervariasi dengan pengaturan Anda. Bagian yang stabil adalah Microsoft Foundry authentication failed terkemuka:

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

Yang harus dilakukan:

• Jika petunjuk mengatakan kredensial dikelola oleh lingkungan ini, aplikasi yang meluncurkan Claude Code memiliki kredensial dan langkah lain di sini tidak berlaku: coba lagi, atau hubungi administrator Anda
• Segarkan kredensial yang Anda konfigurasi dalam Konfigurasi kredensial Azure: putar ANTHROPIC_FOUNDRY_API_KEY, buat ANTHROPIC_FOUNDRY_AUTH_TOKEN segar, atau jalankan az login sehingga rantai kredensial Microsoft Entra default dapat masuk lagi
• Jika kredensial saat ini, konfirmkan identitas memiliki akses ke sumber daya Foundry. Lihat Konfigurasi RBAC Azure

Sebelum v2.1.273, 401 atau 403 dari Microsoft Foundry menunjukkan pesan Please run /login atau Failed to authenticate generik sebagai gantinya, yang tidak dapat menyegarkan kredensial Azure.

Tidak dapat memuat kredensial AWS atau Google Cloud

Claude 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 lagi dua kali sebelum menunjukkan 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:

API Error: Could not load AWS credentials · Could not load credentials from any providers. Check or refresh your AWS credentials and try again.
API Error: Could not load Google Cloud credentials · invalid_grant. Check or refresh your Google Cloud credentials and try again.

Dalam mode non-interaktif dengan -p dan dalam Agent SDK, kode kesalahan terstruktur adalah cloud_credential_error. Sebelum v2.1.267, pesan hanya menunjukkan teks detail setelah API Error:, dan kode terstruktur adalah server_error atau unknown.

Yang harus dilakukan:

• Jalankan perintah masuk penyedia Anda, seperti aws sso login --profile myprofile atau gcloud auth application-default login, kemudian coba lagi. Kredensial Bedrock, Platform Agen, atau Foundry tidak memuat menunjukkan cara mengonfirmasi kredensial di luar Claude Code
• Jika detail membaca AWS default-chain credential resolve timed out, rantai tergantung daripada gagal, jadi ikuti Resolusi kredensial rantai default AWS habis waktu sebagai gantinya

Resolusi kredensial rantai default AWS habis waktu

Rantai penyedia kredensial default AWS tidak menghasilkan kredensial dalam 60 detik, jadi Claude Code menghentikan resolusi dan gagal permintaan. Waktu habis ini adalah satu penyebab Tidak dapat memuat kredensial AWS atau Google Cloud. Kegagalan adalah resolusi kredensial lokal: permintaan tidak pernah mencapai Amazon Bedrock, Claude Platform di AWS, atau titik akhir Mantle. Claude Code menghapus cache kredensial dan mencoba lagi sebelum kesalahan ini muncul, jadi pada saat Anda melihatnya rantai telah macet pada upaya berulang.

API Error: Could not load AWS credentials · AWS default-chain credential resolve timed out. Check or refresh your AWS credentials and try again.

Penyebab umum adalah perintah credential_process dalam profil AWS Anda yang menunggu input yang tidak dapat diterima, dan kontainer atau VM yang layanan metadata instans (IMDS) tidak pernah menjawab probe rantai.

Sebelum v2.1.267, pesan membaca API Error: AWS default-chain credential resolve timed out. Sebelum v2.1.207, rantai yang macet meninggalkan permintaan menunggu tanpa batas daripada gagal.

Yang harus dilakukan:

• 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.
• Selesaikan langkah masuk sebelum memulai Claude Code, misalnya aws sso login --profile myprofile, sehingga rantai diselesaikan dari cache SSO lokal daripada menunggu alur browser
• 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

Verifikasi pengaturan Bedrock habis waktu menunggu AWS

Panggilan ke AWS selama wizard pengaturan Bedrock, seperti pencarian kredensial atau pemeriksaan identitas, tidak selesai dalam batas 60 detik. Wizard berhenti menunggu dan gagal langkah verifikasi:

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

Angka mencerminkan batas Anda: 60 detik secara default, atau nilai yang Anda atur dalam CLAUDE_CODE_AWS_CHAIN_RESOLVE_TIMEOUT_MS.

Penyebab umum adalah jaringan atau proxy yang macet permintaan ke AWS, termasuk penyegaran token SSO, dan pembantu kredensial masih menunggu input yang tidak dapat Anda lihat. Naikkan batas hanya ketika pembantu secara sah memerlukan lebih banyak waktu.

Permintaan tunggal yang macet ke AWS juga dapat gagal pada waktu habis per-permintaan sendiri, yang menunjukkan pesan yang lebih pendek pada langkah yang sama:

A request to AWS timed out. Check your network and proxy settings, then try again.

Ketika waktu habis yang sama terjadi pada langkah pin model, wizard menandai model sebagai unreachable daripada menunjukkan pesan apa pun.

Yang harus dilakukan:

• 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 pembantu kredensial dalam profil AWS Anda; perbaiki itu terlebih dahulu.
• Selesaikan masuk interaktif apa pun sebelum membuka wizard, misalnya aws sso login --profile myprofile
• Jika pembantu 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

Sesi gateway cloud kedaluwarsa

Anda masuk melalui gateway aplikasi Claude, dan sesi gateway yang disimpan di mesin ini telah kedaluwarsa dan tidak dapat diperbarui, atau gateway tidak lagi menerimanya, misalnya setelah rahasia JWT gateway diganti. Jika Anda melihat baris ini ketika memulai claude secara interaktif, sesi telah dibuka keluar dari gateway:

Cloud gateway session expired — run /login to reconnect.

Baris yang sama dapat muncul di tengah sesi ketika kredensial gateway kedaluwarsa dan Claude Code tidak dapat memperbarui.

Dalam jalankan non-interaktif, sesi latar belakang atau sesi yang tidak diawasi lainnya, atau subperintah claude selain claude auth, Claude Code keluar dengan pesan ini sebagai gantinya ketika gateway tidak lagi menerima sesi:

Cloud gateway <url> no longer accepts this session. Start `claude` and sign in again with /login.

Yang harus dilakukan:

• Jalankan /login dalam sesi dan selesaikan masuk browser
• Untuk peluncuran non-interaktif, mulai claude di lingkungan yang sama, jalankan /login, kemudian jalankan kembali perintah Anda

Masuk tidak diterima ke Cloud gateway

Anda mencoba memulai sesi cloud, dan server menolak untuk membuatnya dengan 401: itu tidak menerima login Claude yang dikirim mesin ini, biasanya karena login kedaluwarsa atau dicabut.

Bagian pertama dari baris adalah alasan server sendiri ketika memberikan satu. Jika tidak, baris berbunyi:

Claude login not accepted · Run /login, then try again

Yang harus dilakukan:

• Jalankan /login, selesaikan masuk, kemudian mulai sesi lagi

Gateway menolak permintaan

Anda masuk melalui gateway aplikasi Claude, dan permintaan mengembalikan 403: gateway, atau upstream di baliknya, menolaknya. Masuk lagi tidak mengubah penolakan, jadi pesan menunjuk ke administrator gateway Anda:

Gateway refused the request · signing in again won't change this — check with your gateway administrator · API Error: 403 ...

Yang harus dilakukan:

• Minta administrator gateway Anda untuk mencari permintaan. Ekor API Error: membawa penolakan yang dikembalikan gateway
• Untuk administrator: aturan kontrol akses pada gateway mengembalikan 403 yang dicatat log audit dengan alasannya, dan penolakan otorisasi upstream melewati per Pesan kesalahan Upstream

Sebelum v2.1.273, 403 pada sesi gateway menunjukkan pesan Please run /login atau Failed to authenticate generik sebagai gantinya, dan masuk lagi tidak menghapus penolakan.

Kesalahan jaringan dan koneksi

Sebagian besar kesalahan ini berarti permintaan jaringan dari Claude Code gagal mencapai tujuannya, atau sesuatu antara Claude Code dan API mengubah respons dalam perjalanannya kembali; jika entri juga memiliki penyebab lokal, seperti penulisan arsip yang gagal, isinya akan mengatakan demikian. Mereka biasanya berasal dari jaringan lokal Anda, proxy, atau firewall, atau dari kebijakan jaringan lingkungan cloud.

Unable to connect to API

Koneksi TCP ke API gagal atau tidak pernah selesai. Untuk kode kesalahan koneksi umum, nama pesan menunjukkan jenis kegagalan dan menyimpan kode dalam tanda kurung:

Unable to connect to API. Check your internet connection
Connection refused — a firewall or proxy may be blocking it (ConnectionRefused)
Can't reach the API server — check your internet or DNS (ENOTFOUND)
No internet route — check your connection or VPN (EHOSTUNREACH)
Couldn't connect through your proxy (ERR_PROXY_TUNNEL) — the proxy refused the tunnel: check its credentials and that it allows this host
Connection dropped (ECONNRESET)
fetch failed
Request timed out. Check your internet connection and proxy settings

Kode yang Claude Code tidak kenali muncul sebagai Unable to connect to API diikuti oleh kode dalam tanda kurung. Beberapa pesan ini dapat menampilkan lebih dari satu kode: Connection refused dapat menampilkan ConnectionRefused atau ECONNREFUSED, misalnya, dan Can't reach the API server dapat menampilkan ENOTFOUND atau FailedToOpenSocket.

Sebelum v2.1.227, setiap pesan berkode ini berbunyi Unable to connect to API diikuti oleh kode, misalnya Unable to connect to API (ECONNREFUSED).

Penyebab umum termasuk tidak ada akses internet, VPN yang memblokir api.anthropic.com, atau proxy perusahaan yang diperlukan yang tidak dikonfigurasi.

Yang harus dilakukan:

• Konfirmasi Anda dapat menjangkau host API dari shell yang sama dengan menjalankan curl -I https://api.anthropic.com. Di Windows PowerShell gunakan curl.exe -I https://api.anthropic.com sehingga alias Invoke-WebRequest bawaan tidak digunakan.
• Jika Anda berada di belakang proxy perusahaan, atur HTTPS_PROXY sebelum meluncurkan Claude Code dan lihat Konfigurasi jaringan
• Jika Anda merutekan melalui gateway LLM atau relay, atur ANTHROPIC_BASE_URL ke alamatnya. Lihat Hubungkan Claude Code ke gateway LLM untuk pengaturan.
• Pastikan firewall Anda memungkinkan host yang tercantum dalam Persyaratan akses jaringan
• Kegagalan intermiten diulang secara otomatis; kegagalan persisten menunjukkan masalah jaringan lokal

Jika curl berhasil tetapi Claude Code masih gagal, penyebabnya biasanya sesuatu antara runtime dan jaringan daripada jaringan itu sendiri:

• Di Linux dan WSL, periksa /etc/resolv.conf untuk nameserver yang tidak dapat dijangkau. WSL khususnya dapat mewarisi resolver yang rusak dari host.
• Di macOS, klien VPN yang terputus atau dihapus dapat meninggalkan antarmuka terowongan atau aturan perutean. Periksa ifconfig untuk antarmuka utun yang basi dan hapus ekstensi jaringan VPN di Pengaturan Sistem.
• Docker Desktop dan runtime kontainer serupa dapat mencegat lalu lintas keluar. Keluar dari mereka dan coba lagi untuk mengesampingkan ini.

Unable to connect to Anthropic services

Selama pengaturan pertama kali, Claude Code memeriksa bahwa dapat menjangkau api.anthropic.com dan platform.claude.com sebelum menampilkan langkah masuk. Ketika salah satu pemeriksaan gagal, Claude Code mencetak alasannya dan keluar.

Unable to connect to Anthropic services
Failed to connect to api.anthropic.com: ECONNREFUSED
Connection to api.anthropic.com timed out after 10 seconds
A proxy is configured via HTTPS_PROXY. Check that it allows connections to the host above.

Claude Code mengirim pemeriksaan melalui konfigurasi proxy yang sama dengan permintaan API dan memberikan setiap probe 10 detik. Ketika probe yang gagal melewati proxy, pesan menamai variabel lingkungan yang mengonfigurasinya, seperti HTTPS_PROXY. Sebelum v2.1.222, pemeriksaan menggunakan transport proxy yang berbeda tanpa batas waktu: di belakang URL proxy dengan skema https://, dapat macet pada Checking connectivity... tanpa batas dan kemudian gagal meskipun permintaan API melalui proxy yang sama berhasil.

Claude Code melewati pemeriksaan ini ketika file pengaturan terkelola, kebijakan MDM, atau pembantu kebijakan menetapkan forceLoginMethod ke "gateway", atau menetapkan forceLoginGatewayUrl tanpa forceLoginMethod. Dengan salah satu konfigurasi, Claude Code membuka langkah masuk di layar Cloud gateway daripada metode masuk Anthropic. Claude Code juga melewati pemeriksaan ketika sumber pengaturan terkelola di mesin ada tetapi tidak dapat dibaca, karena sumber itu mungkin menyimpan konfigurasi gateway. Sebelum v2.1.247, Claude Code menjalankan pemeriksaan di bawah konfigurasi ini juga, dan keluar dengan kesalahan ini ketika titik akhir Anthropic tidak dapat dijangkau.

Yang harus dilakukan:

• Jika pesan menamai variabel proxy, periksa bahwa nilainya menunjuk ke proxy yang tepat dan minta tim jaringan Anda untuk memungkinkan koneksi HTTPS melaluinya ke host dalam pesan. Lihat Konfigurasi jaringan.
• Kerjakan pemeriksaan dalam Unable to connect to API. Tes curl dan panduan firewall di sana berlaku untuk pemeriksaan ini juga.
• Jika organisasi Anda masuk melalui cloud gateway dan kesalahan ini muncul pada run pertama, perbarui ke Claude Code v2.1.247 atau lebih baru.
• Jika jaringan Anda terbuka dan kegagalan berlanjut, Claude Code mungkin tidak tersedia di negara Anda

Socket is closed

Socket is closed berarti koneksi yang membawa respons streaming ditutup sementara respons masih tiba. Penyebab paling umum adalah proxy perusahaan di Windows yang menjatuhkan terowongan yang sudah terbentuk di tengah respons.

Tergantung seberapa jauh respons telah berkembang, Claude Code mengulang permintaan, menyimpan apa yang Claude hasilkan, atau mengakhiri giliran. Lihat Pengulangan otomatis.

Sebelum v2.1.214, Claude Code tidak mengulang kegagalan ini, dan giliran berhenti dengan kesalahan yang berisi Socket is closed.

Yang harus dilakukan:

• Jika Anda melihat kesalahan ini, perbarui ke v2.1.214 atau lebih baru dengan claude update, kemudian kirim pesan Anda lagi
• Jika giliran terus gagal di belakang proxy yang sama setelah memperbarui, kerjakan Unable to connect to API dan periksa pengaturan proxy dalam Konfigurasi jaringan

API returned an empty or malformed response

Claude Code menampilkan kesalahan ini ketika pengulangan non-streaming dari permintaan streaming yang gagal mendapatkan status kesuksesan HTTP tetapi isi bukan pesan API Claude: biasanya halaman kesalahan HTML atau masuk, isi kosong, atau JSON dalam format lain. Proxy, gateway, atau halaman masuk jaringan yang menjawab di tempat API adalah sumber biasa. Claude Code tidak mengulang permintaan, dan giliran berakhir dengan kesalahan ini.

API returned an empty or malformed response (HTTP 200) — check for a proxy or gateway intercepting the request.

Setelah pembukaan itu, pesan melaporkan apa yang kembali dan permintaan mana yang gagal:

• Klausa Response: dengan tipe konten, jenis isi, seperti body is an HTML page atau empty body, ukurannya dalam byte, dan apakah respons membawa id permintaan Anthropic. Ketika respons menamai server yang dapat dikenali, seperti nginx atau cloudflare, atau membawa header perantara, seperti cf-ray atau via, klausa mencantumkan yang itu juga.
• Kalimat yang menamai id permintaan streaming yang gagal dan kegagalan yang memicu pengulangan. Ketika aliran telah dibuka sebelum kegagalan, ia juga melaporkan berapa banyak peristiwa aliran yang tiba dan, jika ada, berapa lama aliran telah diam ketika upaya gagal.

Sebelum v2.1.234, pesan berakhir setelah intercepting the request.

Sebelum v2.1.271, balasan yang membawa pesan API yang valid di bawah tipe konten non-JSON seperti text/plain juga mengakhiri giliran dengan kesalahan ini. Beberapa gateway LLM menggunakan tipe konten itu untuk balasan non-streaming.

Yang harus dilakukan:

• Baca klausa Response: untuk melihat sistem mana yang menjawab. Isi HTML, tidak ada id permintaan Anthropic, atau server bernama seperti nginx atau cloudflare berarti sesuatu antara Claude Code dan API menjawab di tempatnya
• Jika Anda merutekan melalui gateway LLM, uji rute dengan permintaan langsung dan perbaiki hop yang mengembalikan respons non-API
• Di jaringan dengan halaman masuk, seperti Wi-Fi tamu, selesaikan masuk di browser, kemudian coba lagi
• Jika hanya rute non-streaming melalui gateway Anda yang rusak, atur CLAUDE_CODE_DISABLE_NONSTREAMING_FALLBACK=1 sehingga permintaan yang gagal di tengah aliran masuk ke jalur pengulangan normal daripada fallback ini, kecuali ketika titik akhir streaming itu sendiri mengembalikan 404, di mana Claude Code masih jatuh kembali

Streaming response ended before any complete data was received

Respons streaming dari penyedia model Anda selesai tanpa memberikan data yang dapat digunakan, jadi Claude Code mengirim ulang permintaan tanpa streaming untuk menyelesaikan giliran. Claude Code menampilkan peringatan sekali per sesi, hanya dalam sesi interaktif. Sebelum v2.1.239, Claude Code diam-diam mengulang tanpa streaming.

Streaming response ended before any complete data was received. Retrying without streaming. If this keeps happening, check any proxy or gateway between Claude Code and your model provider.

Claude Code mengirim setiap permintaan yang terpengaruh dua kali: upaya streaming kosong dan pengulangan. Penyebab biasa adalah proxy atau gateway yang mengonsumsi atau mengubah isi respons streaming dalam perjalanannya kembali.

Yang harus dilakukan:

• Konfigurasikan proxy atau gateway apa pun antara Claude Code dan penyedia model Anda untuk melewatkan isi respons streaming dan headernya tanpa dimodifikasi
• Di Amazon Bedrock, lihat Kesalahan streaming di belakang gateway atau proxy untuk persyaratan header dan isi

Bedrock streaming response has an unexpected content-type

Gateway atau proxy antara Claude Code dan Amazon Bedrock mengubah isi respons streaming atau header Content-Type nya. Amazon Bedrock melakukan streaming respons sebagai application/vnd.amazon.eventstream. Daripada mendekode isi yang tidak dapat dibaca, Claude Code menolak respons streaming yang berhasil yang melaporkan tipe konten yang berbeda. Claude Code tidak mengulang permintaan.

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

Sebelum v2.1.208, kesalahan konfigurasi yang sama muncul sebagai API Error: Truncated event message received setelah seluruh respons telah di-buffer.

Yang harus dilakukan:

• Konfigurasikan gateway untuk melewatkan isi respons InvokeModelWithResponseStream dan header Content-Type nya tanpa dimodifikasi. Perantara yang memancarkan ulang aliran sebagai peristiwa yang dikirim server adalah penyebab umum.
• Menetapkan CLAUDE_CODE_DISABLE_BEDROCK_CONTENT_TYPE_GUARD=1 menyembunyikan kesalahan ini, tetapi Claude Code tidak mendekode isi biner di bawah header yang ditulis ulang, jadi permintaan itu jatuh kembali ke jalur non-streaming yang lebih lambat. Lihat Kesalahan streaming di belakang gateway atau proxy.

SSL certificate errors

Proxy atau perangkat keamanan di jaringan Anda mencegat lalu lintas TLS dengan sertifikat mereka sendiri, dan Claude Code tidak mempercayainya.

Unable to connect to API: SSL certificate verification failed (UNABLE_TO_GET_ISSUER_CERT_LOCALLY). The certificate comes from an authority Claude Code doesn't trust, usually a TLS-inspecting corporate proxy or a gateway signed by a private CA: set NODE_EXTRA_CA_CERTS to that CA bundle, or add it to the system certificate store · see https://code.claude.com/docs/en/network-config
Unable to connect to API: Self-signed certificate detected (SELF_SIGNED_CERT_IN_CHAIN). The certificate comes from an authority Claude Code doesn't trust, usually a TLS-inspecting corporate proxy or a gateway signed by a private CA: set NODE_EXTRA_CA_CERTS to that CA bundle, or add it to the system certificate store · see https://code.claude.com/docs/en/network-config

Sebelum v2.1.273, kedua pesan berakhir di Check your proxy or corporate SSL certificates, tanpa kode OpenSSL atau petunjuk NODE_EXTRA_CA_CERTS.

Mulai dari v2.1.199, kegagalan validasi sertifikat tidak diulang, jadi kesalahan ini muncul pada upaya pertama daripada setelah anggaran pengulangan penuh. Versi sebelumnya menghabiskan beberapa menit mengulang sebelum menampilkannya. Kondisi TLS sementara, seperti batas waktu jabat tangan, masih mengulang.

Selama /login dan pemeriksaan konektivitas startup, kegagalan yang sama menghasilkan pesan yang berbeda:

SSL certificate error (UNABLE_TO_GET_ISSUER_CERT_LOCALLY). If you are behind a corporate proxy or TLS-intercepting firewall, set NODE_EXTRA_CA_CERTS to your CA bundle path, or ask IT to allowlist *.anthropic.com. Run `claude doctor` for details.

Di Amazon Bedrock, permintaan yang Claude Code sendiri kirim ke AWS, seperti panggilan kredensial peran STS dan SSO, penemuan model, dan pemeriksaan wizard pengaturan, bergantung pada konfigurasi sertifikat yang sama. Lihat Kesalahan sertifikat di belakang proxy yang memeriksa TLS.

Yang harus dilakukan:

• Ekspor bundel CA organisasi Anda dan arahkan Claude Code ke sana dengan NODE_EXTRA_CA_CERTS=/path/to/ca-bundle.pem
• Lihat Konfigurasi jaringan untuk instruksi pengaturan lengkap
• Jangan atur NODE_TLS_REJECT_UNAUTHORIZED=0, yang menonaktifkan validasi sertifikat sepenuhnya

Host not allowed in a cloud session

Permintaan HTTP keluar dari sesi cloud atau rutinitas diblokir oleh kebijakan jaringan lingkungan.

HTTP 403
x-deny-reason: host_not_allowed

Anda juga dapat melihat sertifikat TLS yang tidak cocok dengan sertifikat asli tujuan. Sesi cloud merutekan lalu lintas keluar melalui proxy yang memberlakukan kebijakan jaringan, jadi sertifikat yang tidak cocok berarti proxy mengakhiri koneksi, bukan tujuan.

Ini bukan masalah jaringan sisi klien. Sesi cloud dan rutinitas berjalan di dalam VM yang di-sandbox yang lalu lintas keluarnya melalui jaringan sesi disaring ke daftar izin lingkungan cloud; operasi GitHub dan lalu lintas konektor MCP menggunakan saluran terpisah, itulah mengapa mereka dapat terus bekerja sementara host lain diblokir. Lingkungan Default menggunakan akses Trusted, yang memungkinkan daftar izin default dari registri paket, API penyedia cloud, registri kontainer, dan domain pengembangan umum dan memblokir domain lain di jalur itu.

Yang harus dilakukan:

Langkah-langkah ini mengubah salah satu lingkungan Anda sendiri. Lingkungan bersama organisasi terbuka hanya-baca di pemilih, jadi minta Pemilik untuk mengubah akses jaringannya dari halaman Cloud environments dalam pengaturan admin.

• Buka rutinitas untuk pengeditan, atau mulai sesi cloud. Pilih ikon cloud yang menampilkan nama lingkungan Anda, seperti Default, untuk membuka pemilih. Arahkan ke lingkungan Anda dan klik ikon pengaturan.
• Dalam dialog Update cloud environment, ubah Network access dari Trusted ke Custom, kemudian tambahkan domain yang diblokir ke Allowed domains. Masukkan satu domain per baris. Periksa Also include default list of common package managers untuk menyimpan daftar izin default bersama domain kustom Anda. Pilih Full sebagai gantinya jika Anda menginginkan akses tanpa batas.
• Klik Save changes. Jalankan berikutnya menggunakan daftar izin yang diperbarui.

Lihat Akses jaringan untuk tingkat akses dan daftar izin default. Sesi CLI lokal tidak terpengaruh oleh kebijakan ini.

The proxy refused the connection

Anda melihat pesan ini ketika Claude membaca artefak melalui proxy yang Anda atur dalam HTTPS_PROXY atau variabel proxy terkait. Konten artefak berasal dari *.frame.claudeusercontent.com, jadi Claude Code terlebih dahulu mengirim proxy permintaan CONNECT yang memintanya membuka terowongan ke host itu. Ketika proxy menolak, tidak ada yang mencapai host, dan pesan membawa status HTTP proxy:

artifact content fetch failed (proxy refused the connection: HTTP 407)
artifact content fetch failed (proxy refused the connection: HTTP 403)
the proxy refused the connection to the artifact's content host (HTTP 502)

Status adalah jawaban proxy terhadap CONNECT. Host tidak pernah menjawab, jadi setiap status menunjuk ke perbaikan yang berbeda:

• HTTP 407: proxy memerlukan kredensial yang tidak didapatkan. Masukkan mereka dalam URL proxy, seperti yang ditunjukkan Autentikasi Dasar.
• HTTP 403: proxy menolak untuk menggali terowongan ke *.frame.claudeusercontent.com. Minta siapa pun yang menjalankan proxy untuk memungkinkan host itu, yang Persyaratan akses jaringan cantumkan.
• Status apa pun yang lain, seperti HTTP 502: proxy tidak membuka terowongan karena alasannya sendiri, seperti gagal menjangkau host. Cari status dalam log proxy.
• unreadable reply sebagai pengganti status: apa pun yang ada di alamat proxy tidak menjawab dengan baris status HTTP. Periksa bahwa alamatnya adalah proxy HTTP.

Yang harus dilakukan:

• Periksa alamat dan kredensial dalam variabel proxy, seperti yang dijelaskan Konfigurasi Proxy, kemudian jalankan curl -x http://proxy.example.com:8080 -I https://api.anthropic.com dari shell tempat Anda memulai Claude Code, menggunakan URL proxy Anda sendiri. Di Windows PowerShell, jalankan curl.exe. Jika probe ini gagal dengan cara yang sama, perbaiki pengaturan proxy terlebih dahulu. Jika berhasil, penolakan khusus untuk host artefak.
• Jika jaringan Anda membiarkan Claude Code menjangkau host artefak secara langsung, tambahkan .frame.claudeusercontent.com ke NO_PROXY. Simpan entri itu sempit: entri .claudeusercontent.com yang lebih luas juga melewati proxy untuk bridge.claudeusercontent.com, yang organisasi dengan IP allowlisting perlu menyimpan di proxy.

Sebelum v2.1.238, Claude Code melaporkan terowongan yang ditolak sebagai kesalahan jaringan generik.

The cloud environments service returned an empty or unexpected response

Claude Code meminta daftar cloud environments Anda di beberapa titik, seperti ketika Anda membuat sesi cloud dari CLI atau menjalankan /remote-env. Ketika tidak dapat membaca jawaban server, menampilkan salah satu pesan ini:

The cloud environments service returned an empty response (HTTP 200 with no body). This is usually temporary — try again in a moment.
The cloud environments service returned a response in an unexpected format (HTTP 200 with a non-JSON body). This is usually temporary — try again in a moment.
The cloud environments service returned a response in an unexpected format (HTTP 200 without a usable environments list). This is usually temporary — try again in a moment.

Server menerima permintaan tetapi menjawab dengan isi yang bukan daftar lingkungan: kosong, bukan JSON, atau JSON tanpa daftar. Ini biasanya menyertai gangguan sisi layanan dan menghapus sendiri. Tergantung pada permukaan yang meminta daftar, Claude Code dapat menambahkan awalan, seperti couldn't list environments: dalam dialog /remote-env.

Yang harus dilakukan:

• Coba lagi tindakan. Claude Code meminta daftar lagi setiap kali
• Jika pesan terus muncul, periksa status.claude.com untuk insiden aktif

Sebelum v2.1.236, Claude Code menampilkan TypeError JavaScript mentah daripada pesan-pesan ini.

Couldn't reconnect to your Remote Control session

Couldn't reconnect to your Remote Control session. Retry, or start a fresh session without --resume.

Melanjutkan dengan claude --resume atau claude --continue menghubungkan kembali ke sesi Remote Control yang dicatat dalam percakapan itu. Pesan ini berarti koneksi kembali gagal karena alasan yang mungkin sementara, seperti gangguan jaringan atau kesalahan server, jadi Claude Code tidak dapat mengkonfirmasi apakah sesi jarak jauh masih ada. Sesi lokal Anda terus berjalan tanpa Remote Control.

Yang harus dilakukan:

• Jalankan /remote-control untuk mencoba lagi koneksi
• Mulai sesi baru dengan claude --remote-control untuk membuat sesi Remote Control baru
• Untuk pesan startup Remote Control lainnya, lihat Troubleshoot Remote Control

Jika server melaporkan sebaliknya bahwa sesi sebelumnya hilang, Anda tidak melihat pesan ini. Claude Code memulai sesi baru di tempatnya atau menampilkan Previous session is unavailable — run /remote-control to start a new one, tergantung pada catatan koneksi kembali percakapan. Dari v2.1.227 hingga v2.1.231, Claude Code menampilkan pesan yang dimulai dengan Remote Control could not resume the previous session under the current login sebagai gantinya, dan versi sebelumnya berperilaku berbeda lagi.

Sessions ended while this machine was offline

Claude Code menampilkan pesan ini di terminal yang menjalankan claude remote-control setelah mesin Anda offline cukup lama sehingga server membersihkan lingkungan Remote Control yang mesin Anda layani. Sesi di lingkungan itu berakhir, dan Anda tidak dapat melanjutkannya. Hitungannya adalah jumlah sesi yang berakhir.

2 sessions ended while this machine was offline — the environment was cleaned up on the server and can't be resumed.

Yang harus dilakukan:

• Ketika Claude Code mencantumkan worktrees yang disimpan di bawah pesan ini, ambil pekerjaan yang tidak dikomit dari mereka
• Jalankan claude remote-control untuk memulai lingkungan segar

Couldn't share the transcript

Setelah Anda setuju untuk berbagi transkrip sesi Anda dari prompt survei, seperti survei kualitas sesi, Claude Code mengunggahnya ke Anthropic, atau menyimpan arsip lokal sebagai gantinya di penyedia pihak ketiga, di sesi Claude apps gateway, dan ketika tidak ada kredensial Anthropic yang tersedia. Pesan ini berarti berbagi tidak selesai.

Couldn't share the transcript.

Unggahan harus sesuai dengan batas 8 MiB. Dalam sesi yang panjang, Claude Code secara progresif menjatuhkan bagian dari berbagi, pengaturan model permintaan terakhir terlebih dahulu, kemudian percakapan terstruktur dan transkrip subagen, dan menampilkan pesan ini hanya ketika tidak ada versi yang dikurangi yang dapat dikirim atau kesalahan jaringan atau server menghentikan unggahan. Ketika Claude Code menyimpan arsip lokal sebagai gantinya, pesan berarti tidak dapat menulis arsip.

Yang harus dilakukan:

• Jalankan /feedback untuk mengirim transkrip dengan deskripsi apa yang terjadi. Lihat Report an error jika /feedback tidak tersedia di lingkungan Anda
• Jika permintaan lain juga gagal, periksa koneksi jaringan Anda dan lihat Unable to connect to API

Kesalahan permintaan

Kesalahan ini berkaitan dengan konten permintaan Anda. Sebagian besar kembali dari API setelah menolak permintaan; beberapa diproduksi secara lokal oleh Claude Code sebelum permintaan dikirim.

Prompt terlalu panjang

Percakapan ditambah file yang dilampirkan melebihi jendela konteks model.

Prompt is too long

Dalam sesi interaktif, Claude Code menampilkan kesalahan ini sebagai:

Context limit reached · /compact or /clear to continue

Baris hanya menyebutkan /clear ketika DISABLE_COMPACT diatur. Bentuk kesalahan yang lebih panjang, seperti bentuk kegagalan pemadatan di bawah, tetap mempertahankan pesan Prompt is too long ·. Dalam output -p dan transkrip, teksnya tetap Prompt is too long.

Ketika Anda mematikan auto-compact di pengaturan pengguna Anda, baris juga mengatakan demikian:

Context limit reached · /compact or /clear to continue · auto-compact is off · /config to turn it on

Tombol Auto-compact di /config menulis autoCompactEnabled ke pengaturan pengguna. Petunjuk muncul hanya ketika perubahan /config akan berlaku. Misalnya, tidak muncul ketika DISABLE_AUTO_COMPACT atau DISABLE_COMPACT mematikan auto-compact. Juga tidak muncul ketika cakupan prioritas lebih tinggi, seperti pengaturan proyek atau terkelola, menetapkan autoCompactEnabled ke false. Sebelum v2.1.235, baris tidak membawa petunjuk auto-compact.

Amazon Bedrock melaporkan kondisi ini sebagai Input is too long for requested model., yang Claude Code tangani dengan cara yang sama. Sebelum v2.1.217, Claude Code tidak mengenali pesan Bedrock, jadi auto-compact tidak pernah dipicu dan /compact gagal dengan kesalahan yang sama.

Gateway aplikasi Claude melaporkan kondisi ini sebagai capability_rejected: prompt_too_long ketika upstream cloud menolak permintaan dalam bentuk kesalahan penyedia sendiri. Claude Code memperlakukan token sama dengan Prompt is too long. Sebelum v2.1.228, Claude Code tidak mengenali token, jadi auto-compact tidak dipicu.

Ketika pemadatan otomatis berjalan pada giliran ini dan gagal pada kesalahan yang mendasar, seperti model yang tidak tersedia atau kegagalan autentikasi, pesan menyebutkan kesalahan itu setelah pemisah:

Prompt is too long · automatic compaction failed: <the underlying error>

Selesaikan kesalahan yang dinamai terlebih dahulu; /compact gagal pada kesalahan yang sama sampai Anda melakukannya. Sebelum v2.1.229, pemadatan otomatis yang gagal menampilkan Prompt is too long tanpa penyebabnya.

Ketika pemadatan otomatis berjalan pada kesalahan ini, biasanya merangkum pertukaran tertua Anda dan menyimpan yang terbaru. Sebagai upaya terakhir, Claude Code merangkum secara berbeda:

• Ketika tidak dapat merangkum seluruh pertukaran, Claude Code menyimpan prompt terbaru Anda kata demi kata dan merangkum semuanya sebelumnya.
• Dalam hal itu, ketika percakapan tidak berakhir dengan prompt Anda, Claude Code merangkum seluruh percakapan sebagai gantinya.

Claude Code melewati pemulihan ini ketika konten yang akan dibawanya tidak menyimpan balasan model dan kurang dari sekitar 1.000 token teks Anda sendiri, seperti pengiriman ulang singkat setelah tempel berukuran besar. Jalankan /clear untuk memulai segar. Sebelum v2.1.269, pemadatan gagal setiap kali tidak dapat merangkum seluruh pertukaran, jadi sesi dalam keadaan itu mencapai kesalahan ini lagi pada setiap giliran.

Percakapan pertukaran tunggal tidak memiliki giliran sebelumnya untuk dirangkum. Ketika pemadatan otomatis akan berjalan pada satu, Claude Code melewati upaya dan menjelaskan apa yang mengisi permintaan sebagai gantinya. Ketika API tidak melaporkan jumlah token dalam kesalahannya, pesan berbunyi:

Prompt is too long · this conversation is a single exchange and cannot be compacted — the request size comes mostly from system prompt, tool definitions, or attachments.

Ketika API melaporkan jumlah token dalam kesalahannya, Claude Code membandingkannya dengan estimasi sendiri tentang ukuran percakapan untuk mengetahui mana yang paling banyak dari permintaan: konten percakapan sendiri, atau prompt sistem, definisi alat, dan konten lampiran yang Claude Code kirim dengannya. Ketika konten percakapan sendiri paling banyak dari permintaan, pesan berbunyi:

Prompt is too long · the request is ~<request tokens> tokens (limit <limit>) and this conversation's own content is most of it. A single-exchange conversation cannot be compacted; start with less content (smaller files or pasted text).

Ketika sebagian besar permintaan berada di luar percakapan, pesan berbunyi:

Prompt is too long · the request is ~<request tokens> tokens (limit <limit>) but this conversation is only ~<conversation tokens> tokens — the rest is system prompt, tool definitions, and attachment content. A single-exchange conversation cannot be compacted; reduce attached files/tools or start with less context.

Sebelum v2.1.162, Claude Code mencoba pemadatan bagaimanapun dan menampilkan Prompt is too long telanjang ketika gagal.

Yang harus dilakukan:

• Jalankan /compact untuk merangkum giliran sebelumnya dan membebaskan ruang, atau /clear untuk memulai segar. Jika /compact menjawab Not enough messages to compact., percakapan adalah pertukaran tunggal tanpa apa pun sebelumnya untuk dirangkum, jadi ruang diambil oleh prompt itu dan apa yang Claude Code kirim dengan setiap permintaan: jalankan /clear dan kirim ulang dengan teks tempel lebih sedikit atau lampiran lebih kecil, atau kurangi definisi alat dan file memori menggunakan langkah-langkah di bawah
• Jalankan /context untuk melihat rincian apa yang mengonsumsi jendela: prompt sistem, alat, file memori, dan pesan
• Nonaktifkan server MCP yang tidak Anda gunakan dengan /mcp disable <name> untuk menghapus definisi alat mereka dari konteks
• Pangkas file memori CLAUDE.md besar, atau pindahkan instruksi ke aturan bersifat jalur yang dimuat hanya ketika relevan
• Subagen mewarisi setiap definisi alat MCP dari sesi induk, yang dapat mengisi jendela konteks mereka sebelum giliran pertama. Nonaktifkan server MCP yang tidak Anda gunakan sebelum menelurkan subagen.
• Auto-compact aktif secara default dan biasanya mencegah kesalahan ini. Jika Anda mematikannya di /config atau dengan DISABLE_AUTO_COMPACT, aktifkan kembali. Jika Anda tetap mematikannya, jalankan /compact sendiri sebelum jendela penuh.

Lihat Jelajahi jendela konteks untuk tampilan interaktif tentang bagaimana konteks terisi.

Konteks melebihi batas token

/context menampilkan peringatan ini di bagian atas outputnya ketika percakapan telah melampaui jendela konteks model. Permintaan gagal dengan Prompt is too long sampai Anda membebaskan ruang. Sesi interaktif menampilkan kesalahan itu sebagai baris Context limit reached.

Context exceeds the 200k-token limit by 94k tokens — run /compact or /clear to continue.

Ketika batas yang Anda lampaui adalah jendela pemadatan, seperti batas 200K pada model konteks 1M, peringatan berbunyi berbeda. Jendela pemadatan dapat duduk di bawah jendela konteks model, jadi permintaan melewatinya masih dapat berhasil.

Context is 94k tokens past the 200k-token compaction window — run /compact to reduce usage.

Kedua bentuk menyebutkan /clear bukan /compact ketika Anda telah menetapkan DISABLE_COMPACT.

Yang harus dilakukan:

• Dalam percakapan multi-giliran, jalankan /compact untuk merangkum giliran sebelumnya dan membebaskan ruang. Untuk memulai segar sebagai gantinya, jalankan /clear
• Untuk lebih banyak cara mengurangi penggunaan, lihat Prompt is too long

Sebelum v2.1.216, /context menampilkan penggunaan di atas 100% tanpa baris peringatan yang menjelaskan apa artinya atau cara pulih.

Kesalahan selama pemadatan: Percakapan terlalu panjang

/compact sendiri gagal karena tidak ada cukup konteks bebas untuk menampung ringkasan yang dihasilkannya.

Error during compaction: Conversation too long. Press esc twice to go up a few messages and try again.

Ini dapat terjadi ketika jendela sudah penuh pada saat auto-compact dipicu, atau ketika Anda menjalankan /compact setelah melihat Prompt is too long. Dalam sesi interaktif, kesalahan itu adalah baris Context limit reached.

Yang harus dilakukan:

• Tekan Esc dua kali untuk membuka daftar pesan dan mundur beberapa giliran. Ini menghilangkan pesan terbaru dari konteks. Kemudian jalankan /compact lagi.
• Jika mundur tidak membebaskan cukup ruang, jalankan /clear untuk memulai sesi segar. Percakapan sebelumnya Anda disimpan dan dapat dibuka kembali dengan /resume.

Pesan ini dan kegagalan /compact lainnya ditampilkan dalam gaya kesalahan. Sebelum v2.1.216, mereka dirender dalam gaya redup yang sama dengan output perintah yang berhasil, jadi Anda dapat membaca pemadatan yang gagal sebagai kesuksesan.

Permintaan terlalu besar

Badan permintaan mentah melebihi batas 32MB API sebelum tokenisasi, biasanya karena konten tempel besar, hasil alat, atau lampiran. Batas ini terpisah dari jendela konteks.

Request too large (max 32MB). Accumulated images and attachments in the conversation pushed the request over the limit. Run /compact, or double press esc to go back and remove attachments.

Ketika permintaan langsung ke API Claude dan API sendiri menolaknya, Claude Code mengukur percakapan dan merumuskan pesan berdasarkan apakah pemulihan dapat bekerja. Melalui proxy, gateway, atau penyedia cloud Anda mendapatkan pesan umum. Bentuk yang diukur:

• Request too large (max 32MB; 20.1MB of about 33.4MB is images or documents).: gambar atau dokumen mendorong permintaan melampaui batas. Claude Code mencoba ulang dengan mereka dihilangkan.
• Request too large for the API's 32MB request limit: pesan saja sudah melampaui batas, jadi pesan mengatakan compacting cannot make it fit dan Claude Code tidak mencoba ulang. Dalam mode non-interaktif, pesan memberi tahu Anda untuk mengurangi input atau memulai sesi baru sebagai gantinya.

Sebelum v2.1.212, percakapan dengan cukup gambar terakumulasi gagal pada setiap giliran dengan Request too large (max 32MB). Double press esc to go back and try with a smaller file. Sebelum v2.1.229, Claude Code menampilkan saran lampiran untuk setiap penolakan, bahkan ketika pemadatan tidak dapat membantu.

Yang harus dilakukan:

• Jika pesan mengatakan compacting cannot make it fit, tekan Esc dua kali untuk mundur melampaui giliran yang menambahkan konten besar, atau jalankan /clear untuk memulai segar
• Jika tidak, jalankan /compact, yang menghilangkan gambar dan lampiran terakumulasi
• Referensikan file besar berdasarkan jalur bukan menempel konten mereka, jadi Claude dapat membacanya dalam potongan
• Untuk gambar, lihat Image was too large di bawah

Gambar terlalu besar

Gambar yang ditempel atau dilampirkan melebihi batas ukuran atau dimensi API.

Image was too large. Double press esc to go back and try again with a smaller image.
API Error: 400 ... image dimensions exceed max allowed size

Claude Code mengganti gambar yang tidak dapat diproses dengan placeholder teks dan mencoba ulang, jadi pesan berikutnya berhasil. Pada versi sebelum 2.1.142, gambar yang ditempel dapat tetap berada dalam percakapan dan mengulangi kesalahan yang sama pada setiap pesan berikutnya. Untuk pulih pada versi tersebut, tekan Esc dua kali dan mundur melampaui giliran tempat gambar ditambahkan.

Yang harus dilakukan:

• Ubah ukuran gambar sebelum menempel. API menerima gambar hingga 8000 piksel di tepi terpanjang untuk satu gambar, atau 2000 piksel ketika banyak gambar berada dalam konteks.
• Ambil tangkapan layar yang lebih ketat dari wilayah yang relevan bukan layar penuh

Tidak dapat mengubah ukuran gambar

Claude Code tidak dapat mengurangi skala gambar yang dilampirkan sebelum mengirimnya ke API.

Unable to resize image — image processing is unavailable and dimensions could not be read from the file header. Please convert the image to PNG, JPEG, GIF, or WebP.
Unable to resize image — dimensions exceed the 2000x2000px limit and image processing failed. Please resize the image to reduce its pixel dimensions.
Unable to resize image (… raw, … base64). The image exceeds the … API limit and compression failed. Please resize the image manually or use a smaller image.
Unable to resize image — could not verify image dimensions are within the 2000x2000px API limit.
Unable to resize image — it is a CMYK JPEG, which Claude Code cannot decode, and at …px it is over the 2000x2000px limit, so it cannot be sent. Re-save it as an RGB PNG or JPEG and try again.
Unable to resize image — it is an animated WebP whose first frame Claude Code cannot decode, and at …px it is over the 2000x2000px limit, so it cannot be sent. Save its first frame as a PNG or JPEG and try again.
Unable to resize image — its pixels could not be decoded (the file may be damaged, or use an encoding Claude Code cannot read), and it is over the … API limit (… raw, … base64), so it cannot be sent. Re-save it as a PNG or JPEG and try again.

Claude Code biasanya mengubah ukuran gambar besar secara otomatis. Kesalahan ini berarti gambar tidak dapat didekode atau diubah ukurannya agar sesuai dengan batas API.

Yang harus dilakukan:

• Jika pesan meminta Anda mengonversi gambar, konversikan ke PNG, JPEG, GIF, atau WebP dan lampirkan lagi. Claude Code dapat memverifikasi dimensi untuk format ini dari header file, tanpa mendekode gambar.
• Jika pesan melaporkan batas dimensi atau ukuran, ubah ukuran atau kompres ulang gambar di bawah batas itu sebelum melampirkan.
• Jika pesan menyebutkan penyebab, seperti JPEG CMYK, WebP animasi, atau file yang mungkin rusak, simpan ulang gambar dalam format yang disarankan pesan dan lampirkan lagi.

Kesalahan PDF

PDF yang Anda lampirkan tidak dapat diproses. Pesan ditampilkan di sini dalam bentuk non-interaktif mereka; dalam sesi interaktif mereka malah meminta Anda untuk tekan esc dua kali dan coba lagi.

PDF too large (max 100 pages, 20MB). Try reading the file a different way (e.g., extract text with pdftotext).
PDF is password protected. Try using a CLI tool to extract or convert the PDF.
The PDF file was not valid. Try converting it to text first (e.g., pdftotext).

Yang harus dilakukan:

• Untuk PDF berukuran besar, minta Claude membaca rentang halaman dengan alat Read bukan melampirkan seluruh file, atau ekstrak teks dengan alat seperti pdftotext dan referensikan file output berdasarkan jalur
• Untuk PDF yang dilindungi atau tidak valid, hapus kata sandi atau ekspor ulang file dari aplikasi sumbernya, kemudian coba lagi

Input tambahan tidak diizinkan

Proxy atau gateway LLM antara Claude Code dan API menghilangkan header permintaan anthropic-beta, jadi API menolak bidang yang bergantung padanya.

API Error: 400 ... Extra inputs are not permitted ... context_management
API Error: 400 ... Unexpected value(s) for the `anthropic-beta` header

Claude Code mengirim bidang khusus beta seperti context_management dan effort bersama header anthropic-beta yang mengaktifkannya. Ketika gateway meneruskan badan tetapi menghilangkan header, API melihat bidang yang tidak dikenalinya.

Yang harus dilakukan:

• Konfigurasikan gateway Anda untuk meneruskan header anthropic-beta. Lihat feature pass-through untuk apa yang harus diteruskan gateway.
• Sebagai fallback, atur CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1 sebelum meluncurkan. Disable pre-release capabilities mencakup cakupan yang tepat.

Skema input alat tidak valid

Alat dalam permintaan mendeklarasikan input_schema yang gagal validasi JSON Schema API, jadi API menolak seluruh permintaan. Angka setelah tools. adalah posisi alat yang gagal dalam daftar alat permintaan, bukan nama yang dapat Anda cari.

API Error: 400 ... tools.N.custom.input_schema: JSON schema is invalid
API Error: 400 ... tools.N.custom.input_schema.properties: Property keys should match pattern '^[a-zA-Z0-9_.-]{1,64}$'

Bentuk pertama berarti skema bukan JSON Schema draft 2020-12 yang valid. Bentuk kedua berarti nama properti tingkat atas tidak cocok dengan pola yang dikutip pesan.

Claude Code mengecualikan alat MCP yang skema input-nya akan gagal validasi ini ketika memuat alat server, jadi permintaan biasanya tidak pernah menyertakan satu.

Pada deployment di mana pengambilan flag dimatikan, atau pada mesin yang flagnya tidak pernah tiba, Claude Code mencatat dalam log server alat mana yang akan ditolak tetapi mengirimnya bagaimanapun, jadi kesalahan ini masih dapat terjadi.

Kesalahan juga dapat terjadi untuk alat yang skemanya mendeklarasikan dialek JSON Schema selain draft 2020-12 di $schema. Claude Code tidak memeriksa skema tersebut terhadap meta-skema JSON Schema, meskipun pemeriksaan nama properti tingkat atas masih berlaku.

Sebelum v2.1.216, tidak ada deployment yang menjalankan pemeriksaan pengecualian.

Yang harus dilakukan:

• Jika versi Claude Code Anda lebih awal dari v2.1.216, jalankan claude update.
• Hapus atau nonaktifkan server MCP yang mendeklarasikan skema tidak valid. Kesalahan hanya menyebutkan alat berdasarkan posisi. Pada v2.1.216 atau lebih baru, periksa log setiap server untuk baris yang menyebutkan alat yang skema input-nya akan ditolak. Jika tidak ada log yang menyebutkan satu, nonaktifkan server satu per satu.
• Jika Anda memelihara server, perbaiki input_schema alat. Skema harus berupa JSON Schema yang valid, dan nama properti tingkat atas harus 1 hingga 64 karakter panjang dan hanya menggunakan huruf ASCII dan digit, _, ., dan -. Lihat Tools with invalid input schemas.

Ada masalah dengan model yang dipilih

Nama model yang dikonfigurasi tidak dikenali atau akun Anda tidak memiliki akses ke model tersebut. Mulai dari v2.1.160 petunjuk trailing, ditampilkan di sini dalam bentuk interaktifnya, bervariasi menurut permukaan.

There's an issue with the selected model (claude-...). It may not exist or you may not have access to it. Run /model to pick a different model.

Yang harus dilakukan:

• CLI Interaktif: jalankan /model untuk memilih dari model yang tersedia untuk akun Anda.
• Mode non-interaktif (-p): teruskan --model dengan alias atau ID yang valid, atau atur ANTHROPIC_MODEL. Teks kesalahan menampilkan Run --model di permukaan ini.
• Agent SDK: teks kesalahan menghilangkan petunjuk karena model diatur secara terprogram. Atur model pada Options di TypeScript atau ClaudeAgentOptions(model=...) di Python, dan tangani kesalahan terstruktur model_not_found untuk menampilkan pemilih ulang atau pemilih model Anda sendiri.
• Gunakan alias seperti sonnet atau opus bukan ID versi lengkap. Alias menyelesaikan ke default yang dipertahankan sehingga tidak menjadi usang. Lihat Model configuration.
• Jika model yang salah terus kembali di CLI, ID usang diatur di suatu tempat. Periksa tempat Anda dapat mengatur model dalam urutan prioritas dan hapus nilai usang.
• Model yang baru diluncurkan dapat tersedia di API Anthropic sebelum Amazon Bedrock, Platform Agent Google Cloud, atau Foundry Microsoft menawarkannya. Jika Anda menyematkan ID model baru pada salah satu penyedia tersebut dan melihat kesalahan ini, periksa katalog model penyedia Anda untuk ketersediaan di wilayah Anda, dan pertahankan versi sebelumnya yang disematkan sampai yang baru muncul di sana.
• Claude Code melaporkan login claude.ai yang kedaluwarsa sebagai 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 pada versi yang lebih lama.
• Untuk deployment Platform Agent Google Cloud, lihat Troubleshooting Platform Agent Google Cloud.

Model bukan ID model yang dikenali

String model yang Anda teruskan ke sakelar model bukan alias model, ID model yang diketahui versi Claude Code ini, atau ID yang dimulai dengan claude-. Penyebab biasanya adalah kesalahan ketik di ID, nama tampilan seperti Sonnet 5 di mana ID claude-sonnet-5 diharapkan, atau alias yang hanya dikenali versi Claude Code yang lebih baru. Claude Code menolak sakelar segera. Sebelum v2.1.200, Claude Code menyimpan string dan gagal pada permintaan berikutnya dengan Ada masalah dengan model yang dipilih.

Model "claud-sonnet-5" is not a recognized model id. Did you mean 'claude-sonnet-5'?

Petunjuk trailing menyebutkan alias atau ID model yang paling cocok. Ketika tidak ada yang cukup dekat, itu berbunyi Run /model to see available models. sebagai gantinya.

Claude Code menghasilkan kesalahan ini secara lokal pada saat sakelar diminta, sebelum permintaan API apa pun dibuat. Ini berlaku ketika model diatur melalui metode Agent SDK setModel(), oleh aplikasi seperti Desktop app yang menjalankan CLI Claude Code untuk Anda, atau ketika Anda memilih model dari perangkat yang terhubung melalui Remote Control. Sebelum v2.1.260, pemeriksaan tidak mencakup pilihan Remote Control, jadi Claude Code menerapkan pilihan dan permintaan berikutnya gagal dengan Ada masalah dengan model yang dipilih.

Yang harus dilakukan:

• Jalankan /model tanpa argumen untuk membuka pemilih dan pilih dari model yang tersedia untuk akun Anda, kemudian teruskan alias atau ID yang ditampilkan di sana
• Jika Anda menggunakan alias yang didukung versi Claude Code yang lebih baru, jalankan claude update. ID lengkap yang dimulai dengan claude- melewati pemeriksaan lokal ini bahkan ketika model lebih baru dari versi Claude Code Anda. Server masih dapat memerlukan versi minimum untuk model itu; lihat Claude Code does not support this model.
• Model yang disimpan sebelum v2.1.200 tidak diperbaiki oleh pemeriksaan ini. Jika nilai usang terus kembali, hapus dari lokasi yang tercantum di bawah Setting your model.
• Pemeriksaan hanya berjalan di API Anthropic. Pada penyedia atau gateway lain apa pun, termasuk ANTHROPIC_BASE_URL kustom, penyedia menentukan nama model, jadi Claude Code menerima string apa pun dan meneruskannya. Claude Code masih dapat menulis baris diagnostik model yang tidak dikenali pada waktu permintaan, di setiap penyedia.

Model tidak ditemukan

Anda memilih model dengan /model <name> dan Claude Code tidak dapat mengkonfirmasi bahwa model dengan nama itu ada. Ketika nama bukan alias model atau ejaan lain yang Claude Code terima secara lokal, /model memverifikasinya dengan permintaan API minimal, dan kesalahan ini biasanya adalah jawaban endpoint API Anda. Nama yang tidak dapat menjadi ID model sama sekali, seperti yang berisi spasi, mendapatkan pesan yang sama.

Model 'claude-opus-9' not found

Pada penyedia dengan ID model khusus penyedia, pesan dapat menambahkan saran Try '...' instead yang menyebutkan ID penyedia Anda untuk model fallback.

Yang harus dilakukan:

• Jalankan /model tanpa argumen dan pilih dari model yang tersedia untuk akun Anda, atau gunakan alias model seperti sonnet, yang menyelesaikan ke default yang dipertahankan
• Jika Anda mengetik ID lengkap, periksa terhadap katalog model penyedia Anda. Model yang baru diluncurkan dapat tersedia di API Anthropic sebelum penyedia atau wilayah Anda menawarkannya.
• Sebelum v2.1.265, /model juga menolak ejaan alias opusplan[1m] dengan kesalahan ini. Pada versi tersebut, perbarui Claude Code, atau atur model di settings atau dengan --model sebagai gantinya.

Claude Opus tidak tersedia dengan paket Claude Pro

Paket langganan aktif Anda tidak menyertakan model yang Anda pilih.

Claude Opus is not available with the Claude Pro plan. If you have updated your subscription plan recently, run /logout and /login for the plan to take effect.

Yang harus dilakukan:

• Jalankan /model dan pilih model yang disertakan paket Anda
• Jika Anda baru-baru ini meningkatkan paket dan masih melihat ini, jalankan /logout kemudian /login. Token yang disimpan mencerminkan paket Anda pada saat Anda masuk, jadi meningkatkan di claude.ai tidak berlaku dalam sesi yang ada sampai Anda autentikasi ulang.
• Lihat claude.com/pricing untuk model mana yang disertakan setiap paket

Claude Code tidak mendukung model ini

API menolak permintaan dengan 400 karena versi Claude Code Anda di bawah minimum yang diperlukan. Baik model yang Anda pilih memerlukan versi yang lebih baru, yang diperiksa server per model, atau kebijakan organisasi Anda memerlukan satu. 400 membawa kode kesalahan claude_code_version_too_old, dan pesan mengatakan minimum mana yang berlaku.

API Error: 400 Claude Code 2.1.219 does not support this model; version 2.1.255 or newer is required. Run 'claude update', or update the Claude desktop app, then try again.

Pesan kebijakan organisasi berbunyi:

API Error: 400 Claude Code 2.1.240 is older than the minimum version required by your organization's policy. Run 'claude update', or update the Claude desktop app, to continue.

Yang harus dilakukan:

• Jalankan claude update, atau perbarui aplikasi desktop Claude, kemudian mulai sesi baru
• Untuk pesan per-model, Anda dapat terus bekerja dalam sesi saat ini dengan beralih ke model lain dengan /model
• Untuk pesan kebijakan organisasi, perbarui sebelum Anda melanjutkan

Model dibatasi oleh pengaturan organisasi Anda

Admin organisasi Anda telah menonaktifkan model ini di konsol admin claude.ai, atau dikecualikan oleh daftar izin availableModels dalam pengaturan terkelola. Ketika model yang dibatasi diatur dengan --model, ANTHROPIC_MODEL, atau pengaturan model, Claude Code mengganti model yang diizinkan dan melanjutkan. Mengetik /model <name> untuk model yang dibatasi ditolak dengan Run /model to choose a different model. dan sesi menyimpan model saat ini. Pemberitahuan substitusi juga dapat muncul di tengah sesi setelah admin menonaktifkan model yang sedang dijalankan sesi di konsol admin claude.ai.

Model "claude-opus-4-8" is restricted by your organization's settings. Using claude-sonnet-4-6 instead.

Pemberitahuan dengan awalan nama agen, skill, atau perintah berarti pembatasan diterapkan pada model yang diminta subagen: subagen berjalan pada model yang diganti dan model sesi Anda tidak berubah. Sebelum v2.1.223, Claude Code menampilkan pemberitahuan hanya untuk subagen yang diluncurkan dengan alat Agent.

Claude Code memperlakukan alias keluarga model, salah satu dari opus, sonnet, haiku, atau fable, sebagai permintaan untuk keluarga itu bukan untuk versi terbarunya. Di API Anthropic dan di Claude Platform on AWS, alias keluarga yang dibatasi menyelesaikan ke versi terbaru keluarga yang diizinkan organisasi Anda dan daftar izin availableModels, dan pemberitahuan substitusi menyebutkan versi itu. Claude Code menolak /model <alias> hanya ketika setiap versi keluarga dibatasi. Sebelum v2.1.205, alias keluarga diganti atau ditolak berdasarkan versi terbarunya saja, bahkan ketika versi yang lebih lama dari keluarga yang sama diizinkan.

Yang harus dilakukan:

• Jalankan /model untuk memilih dari model yang diizinkan organisasi Anda. Model yang dibatasi disembunyikan dari pemilih.
• Jika model yang dibatasi diatur di --model, ANTHROPIC_MODEL, bidang model file pengaturan, atau frontmatter model dari subagen, skill, atau perintah, hapus atau perbarui nilai itu sehingga pemberitahuan tidak berulang
• Jika Anda memerlukan akses ke model yang dibatasi, minta admin organisasi Anda untuk mengaktifkannya. Lihat Organization model restrictions.

Sakelar model diblokir oleh hook PreModelSwitch

Hook PreModelSwitch tidak menyetujui sakelar model yang Anda atau klien minta, jadi sesi menyimpan model saat ini. Ketika sakelar berasal dari host Agent SDK atau Remote Control bukan perintah yang Anda ketik, pesan berbunyi Model switch blocked by a PreModelSwitch hook tanpa menyebutkan model target.

Model switch to Opus 4.6 was blocked by a PreModelSwitch hook: Opus 4.6 is retired for this project. Use a newer model.

Alasan setelah titik dua mengatakan apa yang menolak sakelar:

• Alasan yang ditulis hook: hook PreModelSwitch menyediakan alasan itu ketika menolak sakelar atau meminta konfirmasi. Tangani apa yang dimintanya, atau pilih model yang diizinkan hook Anda.
• PreModelSwitch hook <name> did not respond before its timeout: hook yang tidak menjawab sebelum timeout-nya memblokir sakelar. Perbaiki perintah yang menggantung atau naikkan timeout hook itu, kemudian sakelar lagi.
• confirmation required, and this session cannot ask: hook menjawab ask tanpa alasan, dan permintaan kontrol tidak memiliki cara untuk menampilkan prompt konfirmasi. Perintah /model dalam run -p melaporkan kondisi yang sama dengan (run /model interactively to confirm) setelah alasan. Buat sakelar dari sesi interaktif, atau ubah keputusan hook untuk model ini.
• so organization-managed PreModelSwitch hooks could not be checked: Claude Code tidak dapat mengetahui hook PreModelSwitch mana yang plugin terkelola organisasi Anda berikan, misalnya karena plugin terkelola gagal dimuat. Salah satu hook itu mungkin memblokir sakelar, jadi Claude Code menolak bukan menerapkan sakelar yang tidak diperiksa. Awal alasan menyebutkan apa yang gagal. Claude Code memeriksa ulang pada setiap upaya sakelar, jadi kegagalan yang sejak itu telah dihapus berhenti memblokir; jika terus gagal, jalankan claude --debug dan sakelar lagi untuk menangkap detail, kemudian perbaiki plugin atau minta admin Anda memperbaikinya.
• a PreModelSwitch hook failed before answering atau PreModelSwitch hooks were cancelled (the control stream closed) before answering: jalankan hook berakhir tanpa putusan, dan Claude Code tidak memperlakukan itu sebagai persetujuan. Jalankan claude --debug untuk melihat apa yang gagal, kemudian sakelar lagi.

Sebelum v2.1.260, penolakan plugin terkelola berbunyi plugin hooks could not be loaded, so PreModelSwitch hooks could not be checked; see the debug log. Claude Code mencoba ulang pemuatan plugin sekali kemudian menolak sakelar kemudian dalam sesi, bahkan ketika organisasi Anda tidak mengelola plugin apa pun. Mulai ulang sesi untuk menjalankan pemuatan plugin lagi pada versi tersebut.

Tidak dapat menyimpannya sebagai default Anda

Anda memilih model untuk disimpan sebagai default Anda, misalnya dengan /model <name> atau Enter di pemilih /model, dan Claude Code tidak dapat menulis pilihan ke file pengaturan pengguna Anda, ~/.claude/settings.json. Sakelar itu sendiri diterapkan, jadi sesi saat ini berjalan pada model yang Anda pilih, tetapi default Anda tidak berubah dan sesi berikutnya dimulai pada nilai lama.

Set model to Fable 5.1 for this session only · couldn't save it as your default: ~/.claude/settings.json can't be written (EROFS)

Alasan setelah jalur file mengatakan apa yang gagal:

• can't be written (<code>): penulisan gagal dengan kode kesalahan sistem operasi dalam tanda kurung, seperti EROFS ketika file, atau file yang ditautkannya, duduk di sistem file yang menolak penulisan. Buat file dapat ditulis dan sakelar lagi. Jika alat lain menghasilkan file, atur kunci model di alat itu sebagai gantinya; lihat A change you made in Claude Code is lost in new sessions.
• isn't valid JSON: file di disk tidak diurai, dan Claude Code meninggalkannya tidak tersentuh bukan menimpa konten yang tidak dapat dibaca kembali. Perbaiki kesalahan sintaks, kemudian sakelar lagi; lihat Fix a broken settings file.

Pemberitahuan yang berakhir couldn't confirm it was saved as your default (~/.claude/settings.json is still being written) berarti penulisan belum selesai setelah tiga detik. Ini berlanjut di latar belakang, jadi default mungkin masih disimpan; periksa model mana yang dimulai sesi berikutnya Anda, atau jalankan /model <name> lagi.

Sebelum v2.1.265, pemberitahuan mengatakan model itu saved as your default for new sessions bahkan ketika penulisan gagal.

thinking.type.enabled tidak didukung untuk model ini

Versi Claude Code Anda lebih lama dari minimum untuk model yang dipilih. CLI mengirim konfigurasi pemikiran yang model tidak lagi terima.

API Error: 400 ... "thinking.type.enabled" is not supported for this model. Use "thinking.type.adaptive" and "output_config.effort" to control thinking behavior.

Yang harus dilakukan:

• Jalankan claude update dan mulai ulang Claude Code. Opus 4.7 memerlukan v2.1.111 atau lebih baru. Opus 4.8 memerlukan v2.1.154 atau lebih baru. Sonnet 5 memerlukan v2.1.197 atau lebih baru. Opus 5 memerlukan v2.1.219 atau lebih baru. Opus 5.5 memerlukan v2.1.280 atau lebih baru
• Jika Anda tidak dapat meningkatkan, jalankan /model dan pilih Opus 4.6 atau Sonnet 4.6 sebagai gantinya
• Jika Anda mencapai ini di Agent SDK, tingkatkan paket SDK sebagai gantinya. Opus 4.8 memerlukan TypeScript SDK v0.3.154 atau lebih baru dan Python SDK v0.2.88 atau lebih baru. Sonnet 5 memerlukan TypeScript SDK v0.3.197 atau lebih baru. Opus 5 memerlukan TypeScript SDK v0.3.219 atau lebih baru. Opus 5.5 memerlukan TypeScript SDK v0.3.280 atau lebih baru

Effort tidak tersedia dengan pemikiran dimatikan

Anda mematikan extended thinking dan menjalankan pada effort level di atas high. Model tidak menerima kombinasi itu, jadi API menolak permintaan.

API Error: Effort 'xhigh' isn't available with thinking turned off on this model · run /effort high to continue, or turn thinking back on (unset MAX_THINKING_TOKENS=0)

Yang harus dilakukan:

• Turunkan effort level ke high atau di bawahnya.
• Nyalakan pemikiran kembali, misalnya dengan membatalkan MAX_THINKING_TOKENS atau menghapus "alwaysThinkingEnabled": false dari pengaturan Anda.

Sebelum v2.1.242, Claude Code menampilkan pesan API sendiri: API Error: 400 output_config.effort 'xhigh' is not supported when thinking is disabled on this model. Use effort 'high' or below, or enable thinking. Sebelum v2.1.251, Claude Code mengirim permintaan pada effort level yang Anda atur, jadi Opus 5 menolak setiap permintaan di atas high dengan pemikiran dimatikan. Claude Code sekarang mengirim effort high sebagai gantinya ke model yang diketahuinya menolak kombinasi, seperti Opus 5, jadi pada v2.1.251 atau lebih baru kesalahan ini mencapai Anda hanya dari model yang Claude Code tidak tahu menolaknya.

Anggaran pemikiran melebihi batas output

Anggaran extended thinking yang dikonfigurasi melebihi panjang respons maksimum, jadi tidak ada ruang yang tersisa untuk jawaban sebenarnya.

API Error: 400 ... max_tokens must be greater than thinking.budget_tokens

Claude Code menyesuaikan nilai-nilai ini secara otomatis di API Anthropic. Anda biasanya melihat kesalahan ini di Amazon Bedrock atau Platform Agent Google Cloud ketika MAX_THINKING_TOKENS diatur lebih tinggi dari batas output penyedia, atau ketika mode rencana menaikkan anggaran pemikiran.

Yang harus dilakukan:

• Turunkan MAX_THINKING_TOKENS, atau naikkan CLAUDE_CODE_MAX_OUTPUT_TOKENS di atas anggaran pemikiran
• Lihat Extended thinking untuk bagaimana anggaran berinteraksi dengan panjang output

Ketidakcocokan blok penggunaan alat atau pemikiran

Riwayat percakapan mencapai API dalam keadaan tidak konsisten, biasanya setelah panggilan alat dihentikan atau giliran diedit di tengah aliran.

API Error: 400 due to tool use concurrency issues. Run /rewind to recover the conversation.
API Error: 400 orphaned tool_result in conversation history. Run /rewind to recover the conversation.
API Error: 400 duplicate tool_use ID in conversation history. Run /rewind to recover the conversation.
API Error: 400 ... unexpected `tool_use_id` found in `tool_result` blocks
API Error: 400 ... thinking blocks ... cannot be modified

Semua varian berarti hal yang sama: urutan blok tool_use, tool_result, dan thinking dalam riwayat tidak lagi cocok dengan apa yang diharapkan API.

Yang harus dilakukan:

• Jika Anda menggunakan Opus 4.7 atau Opus 4.8, jalankan claude update terlebih dahulu. Versi sebelum v2.1.156 dapat memicu kesalahan ini selama penggunaan alat normal, dan /rewind tidak menghapusnya.
• Jalankan /rewind, atau tekan Esc dua kali, untuk mundur ke checkpoint sebelum giliran yang rusak dan lanjutkan dari sana. Lihat Checkpointing untuk bagaimana checkpoint dibuat dan dipulihkan.

Konten alat yang tidak didukung dihapus

Ketika Claude Code terhubung langsung ke API Anthropic dan memuat atau melihat pratinjau sesi yang disimpan, ia menghapus konten alat yang API Anthropic tidak terima dan meninggalkan baris ini di mana konten yang dihapus duduk di antara dua blok pemikiran:

[Unsupported tool content removed]

Konten seperti itu mencapai file sesi ketika sesuatu selain API Anthropic menjawab dalam format API, biasanya proxy pihak ketiga yang diatur melalui ANTHROPIC_BASE_URL yang menerjemahkan panggilan alat penyedia lain. Claude Code menghapusnya hanya ketika sesi terhubung langsung ke API Anthropic, dan memuat riwayat yang disimpan seperti adanya ketika sesi berjalan melalui proxy atau di penyedia lain. Sebelum v2.1.246, Claude Code mengirim penggunaan alat dan hasilnya kembali ke API, dan setiap giliran sesi yang dilanjutkan gagal dengan kesalahan 400 seperti messages.1.content.0.server_tool_use.name: Input should be 'web_search', 'web_fetch', ....

Yang harus dilakukan:

• Tidak ada yang diperlukan ketika Anda melihat baris placeholder. Sesi berlanjut tanpa konten yang dihapus.
• Jika setiap giliran sesi yang dilanjutkan gagal dengan kesalahan 400 sebagai gantinya, jalankan claude update dan lanjutkan sesi lagi. Versi sebelum v2.1.246 tidak menghapus konten.

role 'system' harus mendahului pesan 'assistant'

API menolak permintaan dengan 400 karena pesan sistem duduk pada posisi dalam percakapan yang tidak diterimanya:

API Error: 400 messages.6: role 'system' must precede an 'assistant' message or end the array; ...

Claude Code mengirim beberapa teks pengingat dan lampiran sebagai pesan sistem di dalam percakapan. Ketika API menolak posisi satu, Claude Code mencoba ulang permintaan sekali dengan teks itu dikirim sebagai pesan pengguna biasa sebagai gantinya. Pesan penempatan saudara API, seperti use the top-level 'system' parameter for the initial system prompt, mendapatkan pemulihan yang sama.

Ketika kesalahan muncul, pesan sistem yang ditolak bukan yang dapat dihapus Claude Code. Itu biasanya berarti proxy atau gateway LLM antara Claude Code dan API menambahkan pesan sistem mereka sendiri atau mengurutkan ulang percakapan.

Yang harus dilakukan:

• Jalankan /clear untuk memulai percakapan segar. Jika kesalahan kembali di sana juga, penyebabnya ada di jalur permintaan, bukan di percakapan yang disimpan.
• Jika kesalahan berulang pada setiap giliran di belakang proxy atau gateway yang dikonfigurasi melalui ANTHROPIC_BASE_URL, terhubung tanpa proxy untuk mengkonfirmasi sumber, dan laporkan kesalahan ke siapa pun yang mengoperasikannya

Sebelum v2.1.280, Claude Code tidak mengenali pesan ini, jadi kesalahan juga muncul ketika pesan sistem yang ditolak adalah yang dikirim Claude Code sendiri, dan setiap giliran percakapan kemudian gagal dengan cara yang sama.

Encrypted\_content tidak valid dalam blok search\_result

API menolak permintaan dengan 400 karena riwayat percakapan menyimpan konten pencarian web yang dihosting yang tidak dapat didekripsi. Pesan menyebutkan bidang yang tidak dapat dibacanya:

API Error: 400 messages.21.content.0: Invalid `encrypted_content` in `search_result` block
API Error: 400 messages.21.content.3.citations.0: Invalid `encrypted_index` in `text` block
API Error: 400 Failed to decrypt web search result content

Hasil dari alat pencarian web yang dihosting API membawa bidang terenkripsi yang hanya dapat dibaca API. API menolak permintaan yang memutar ulang konten yang tidak dapat didekripsi, seperti konten yang diproduksi untuk organisasi berbeda.

Alat WebSearch Claude Code sendiri mencatat hasil pencarian sebagai teks biasa, jadi blok ini biasanya mencapai percakapan melalui proxy atau gateway LLM yang menjalankan pencarian web yang dihosting itu sendiri.

Blok yang ditolak tetap berada dalam riwayat percakapan, jadi setiap giliran kemudian dan /compact gagal dengan cara yang sama.

Yang harus dilakukan:

• Jalankan /clear atau mulai sesi baru; percakapan baru tidak membawa blok yang ditolak
• Jika Anda menjalankan Claude Code di belakang proxy atau gateway, laporkan kesalahan ke siapa pun yang mengoperasikannya

Penolakan Kebijakan Penggunaan

API menolak untuk merespons karena konten dalam percakapan memicu pemeriksaan Kebijakan Penggunaan. Pesan menyertakan ID Permintaan yang dapat Anda kutip untuk mendukung jika Anda percaya penolakan tidak benar.

API Error: Opus 4.6 can't help with this. Start a new session to continue.

Send feedback with /feedback or learn more: https://www.anthropic.com/legal/aup

Pesan menyebutkan model yang menolak, atau Claude ketika tidak ada model yang dicatat.

Pemeriksaan mengevaluasi seluruh percakapan, bukan hanya prompt terbaru Anda, jadi mengirim pesan baru dalam sesi yang sama biasanya memicu ulang penolakan yang sama. Hal yang sama berlaku setelah keluar dan membuka kembali sesi dengan --continue atau --resume, karena transkrip di disk masih berisi konten pemicu. Di Amazon Bedrock, Platform Agent Google Cloud, dan Microsoft Foundry, pesan ini juga mencakup permintaan yang langkah-langkah keselamatan model tandai sebagai topik keamanan siber. Lihat Safety measures flagged a cybersecurity topic.

Sebelum v2.1.219, pesan berbunyi Claude Code is unable to respond to this request, which appears to violate our Usage Policy (https://www.anthropic.com/legal/aup). Please double press esc to edit your last message or start a new session for Claude Code to assist with a different task.

Yang harus dilakukan:

• Tekan Esc dua kali atau jalankan /rewind untuk mundur ke checkpoint sebelum giliran yang memicu penolakan, kemudian rephrase atau ambil pendekatan berbeda. Lihat Checkpointing.
• Jika Anda tidak dapat mengidentifikasi giliran mana yang menyebabkannya, jalankan /clear untuk memulai percakapan segar dalam proyek yang sama. Percakapan sebelumnya Anda disimpan di disk dan tetap tersedia di /resume.
• Dalam mode non-interaktif (-p), di mana rewind tidak tersedia, coba ulang dengan prompt yang diucapkan ulang dalam sesi baru tanpa --continue. Pemeriksaan kebijakan bervariasi menurut model, jadi beralih ke model berbeda dengan --model juga dapat menyelesaikan penolakan dalam beberapa kasus.

Langkah-langkah keselamatan menandai topik keamanan siber

Langkah-langkah keselamatan model menandai konten dalam percakapan sebagai topik keamanan siber. Pesan menyebutkan model yang menandai permintaan:

API Error: Opus 4.8's safeguards flagged this message. Our intentionally broad safeguards allow us to deliver more capabilities faster, but can sometimes flag legitimate cybersecurity work. Apply to the Cyber Verification Program to reduce these interruptions. Send feedback with /feedback or learn more: https://support.claude.com/en/articles/14604842-real-time-cyber-safeguards-on-claude

Pesan menautkan ke Program Verifikasi Siber, yang memberikan akses untuk pekerjaan keamanan siber yang sah. Di Opus 5.5, yang memerlukan v2.1.280 atau lebih baru, pesan dibuka dengan Opus 5.5's safeguards flagged this session sebagai gantinya. Ketika kategori yang ditandai memiliki model fallback yang tersedia, Claude Code beralih model bukan menampilkan kesalahan ini.

Di Amazon Bedrock, Platform Agent Google Cloud, dan Microsoft Foundry, bendera keamanan siber menghasilkan pesan Penolakan Kebijakan Penggunaan sebagai gantinya.

Penjaga itu sendiri adalah server-side dan mendahului v2.1.203; rilis klien sejak itu hanya mengubah pesan wording. Dari v2.1.203 melalui v2.1.218, pesan berbunyi <model> has safety measures that flagged this message for a cybersecurity topic. To learn about the Cyber Verification Program and apply for access, visit our help center: diikuti oleh tautan pusat bantuan yang sama, dan sesi interaktif ditambahkan If you were not engaging in a cybersecurity topic, please send feedback via /feedback. Sebelum v2.1.203, itu berbunyi <model>'s safeguards flagged this message for a cybersecurity topic. If your work requires this access, you can apply for an exemption: diikuti oleh tautan formulir pengecualian.

Yang harus dilakukan:

• Jika pekerjaan Anda memerlukan konten ini, ajukan permohonan akses melalui Program Verifikasi Siber
• Jika permintaan Anda bukan tentang topik keamanan siber, jalankan /feedback untuk melaporkan positif palsu
• Untuk terus bekerja dalam sesi yang sama, tekan Esc dua kali atau jalankan /rewind untuk mundur ke checkpoint sebelum giliran yang memicu bendera, kemudian ambil pendekatan berbeda. Lihat Checkpointing.

Kesalahan instalasi

Kesalahan ini muncul saat menginstal atau memperbarui Claude Code, dari skrip instalasi, claude install, atau claude update. Untuk masalah command not found, PATH, izin, dan TLS selama pengaturan, lihat Troubleshoot installation and login.

Installation was killed before it could finish

Skrip instalasi melaporkan ketika langkah claude install dihentikan oleh sinyal. Di Linux, kode keluar 137 berarti proses menerima SIGKILL, dan pada host dengan memori rendah itu biasanya pembunuh out-of-memory (OOM) kernel. Skrip mencetak penjelasan ini dan keluar dengan kode 137:

Installation was killed before it could finish (exit code 137). This usually means the system ran out of memory.
Claude Code needs roughly 512MB of free memory to install. Free up memory, then run this script again.

Untuk sinyal fatal lainnya, dan untuk kode keluar 137 di macOS, skrip mencetak Installation was killed before it could finish (exit code <N>) dengan kode keluar aktual dan menghilangkan penjelasan out-of-memory. Pesan berasal dari skrip instalasi yang digunakan macOS dan Linux, yang juga mencakup instalasi di dalam WSL; skrip instalasi Windows asli tidak pernah mencetaknya. Sebelum v2.1.200, skrip keluar hanya dengan baris Killed shell yang kosong.

Yang harus dilakukan:

• Hentikan proses lain untuk membebaskan memori, kemudian jalankan kembali penginstal
• Tambahkan ruang swap atau pindah ke instans yang lebih besar. Lihat Install killed on low-memory Linux servers untuk perintah file swap.

The connection dropped while downloading the update

Koneksi ke server unduhan ditutup saat claude install, claude update, atau automatic updater mengambil biner Claude Code, dan pengulangan tidak berhasil. Claude Code mencoba ulang unduhan ketika koneksi putus, transfer macet, atau file yang diunduh gagal checksumnya, hingga tiga percobaan total. Kesalahan HTTP yang selesai, seperti 404, tidak dicoba ulang karena server sudah menjawab. Sebelum v2.1.202, koneksi yang putus tunggal gagal mengunduh segera dengan kesalahan kosong aborted alih-alih mencoba ulang.

The connection dropped while downloading the update (attempt 3/3: aborted). Check your network — proxies sometimes cut off large downloads.

Teks dalam tanda kurung menyebutkan percobaan mana yang gagal dan kesalahan jaringan yang mendasarinya. claude update mendahului pesan dengan Error: Failed to install native update di stderr.

Unduhan yang tetap terhubung tetapi tidak selesai dalam 10 menit gagal dengan Download timed out: exceeded the total deadline sebagai gantinya. Claude Code tidak mencoba ulang unduhan yang habis waktu, karena koneksi yang terlalu lambat untuk selesai dalam batas waktu tidak akan selesai pada pengulangan segera. Langkah-langkah di bawah berlaku untuk kedua pesan.

Penyebab umum adalah proxy atau gateway yang menutup transfer panjang sebelum selesai. Biner Claude Code adalah unduhan besar, jadi batas koneksi proxy yang tidak pernah mempengaruhi lalu lintas API normal masih dapat mengganggu.

Yang harus dilakukan:

• Jalankan claude update lagi. Pada jaringan yang sehat, unduhan biasanya berhasil pada run berikutnya. Untuk pesan yang habis waktu, jalankan lagi dari jaringan yang lebih cepat atau kurang dibatasi.
• Jika jaringan Anda memerlukan proxy, atur HTTPS_PROXY sebelum menjalankan penginstal atau claude update. Lihat Check network connectivity.
• Jika proxy korporat terus menutup transfer, minta tim jaringan Anda untuk mengizinkan unduhan lengkap dari downloads.claude.ai. Lihat Network access requirements.
• Jalankan claude doctor dari shell Anda untuk diagnostik instalasi

Kesalahan baris perintah

Kesalahan ini berasal dari 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 mereka berjalan. Mereka juga berasal dari /tui, yang meluncurkan kembali CLI.

Konflik antara --bg dan --print

Pesan 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 latar belakang yang kemudian Anda lampirkan dengan claude agents, sementara --print berjalan non-interaktif dan tidak pernah memulai sesi interaktif yang claude agents lampirkan. Sebelum v2.1.198, kombinasi ini secara diam-diam membuat pekerjaan latar belakang yang tidak pernah bisa dilampirkan.

--bg dan --print berkonflik: --print tidak pernah memulai sesi interaktif yang `claude agents` lampirkan, jadi pekerjaan tidak akan dapat dilampirkan. Prompt adalah posisional — lepaskan --print: `claude --bg '<task>'`.

Yang harus dilakukan:

• Lepaskan -p atau --print. --bg mengambil prompt sebagai argumen posisionalnya, jadi claude --bg "<task>" adalah perintah lengkapnya. Lihat Dispatch new agents from your shell.
• Untuk menjalankan prompt secara non-interaktif dan mencetak hasilnya alih-alih membuat sesi latar belakang, lepaskan --bg dan jalankan claude -p "<task>"

Konfigurasi --agents tidak valid

Nilai yang Anda berikan ke --agents tidak valid, jadi claude keluar dengan kode 1 alih-alih memulai sesi. Ketika Anda melewatkan --safe-mode, --resume, atau --continue, atau mengatur CLAUDE_CODE_SAFE_MODE, Claude Code tidak memeriksa nilainya dan memulai sesi. Sebelum v2.1.242, Claude Code memulai sesi bagaimanapun dan menghilangkan definisi yang tidak bisa dimuat.

Error: Invalid --agents configuration:
<what failed>

Apa yang mengikuti baris pertama tergantung pada bagaimana nilainya 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:

1. Ketika nilai tidak diuraikan sebagai JSON, Claude Code mencetak satu baris invalid JSON: yang membawa pesan parser JSON sendiri
2. Ketika diuraikan tetapi definisi agen tidak cocok dengan skema untuk subagen yang ditentukan CLI, Claude Code mencetak satu baris per masalah
3. Ketika nama agen dimulai dengan -, Claude Code mencetak <name>: agent names must not start with '-'

Ketika ada lebih dari 20 baris masalah, Claude Code mencetak 20 yang pertama dan mengganti sisanya dengan …and N more.

Yang harus dilakukan:

• Perbaiki setiap masalah yang daftar pesan, kemudian jalankan perintah lagi. Lihat bidang yang diambil subagen yang ditentukan CLI.

Sesi cloud tidak dapat dibuat dari sesi --restricted

Ketika Anda memulai sesi dengan --restricted, Claude Code menolak untuk membuat sesi 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:

Cloud sessions cannot be created from a --restricted session: they would not enforce it.

Yang harus dilakukan:

• Jalankan tugas secara lokal dalam sesi terbatas
• Jika Anda mengontrol bagaimana sesi diluncurkan, mulai sesi claude baru tanpa --restricted dan buat sesi cloud dari sana

Sebelum v2.1.248, Claude Code tidak memiliki flag --restricted; versi sebelumnya menolak flag itu sendiri dengan kesalahan opsi yang tidak dikenal.

Sesi cloud dinonaktifkan oleh kebijakan organisasi Anda

Kebijakan allow_remote_sessions organisasi Anda mati, jadi sesi cloud dan perintah yang menggunakannya tidak tersedia:

Cloud sessions are disabled by your organization's policy. Contact your organization admin to enable them.

Pesan muncul ketika Anda membuat sesi cloud dari terminal dan ketika Anda mengirimkan perintah yang memerlukan sesi cloud, seperti /teleport, /remote-env, atau /web-setup. Sebelum v2.1.268, mengirimkan salah satu perintah itu mengembalikan Unknown command sebagai gantinya.

Ini adalah kebijakan organisasi sisi server, jadi tidak dapat ditimpa dari pengaturan lokal, variabel lingkungan, atau flag CLI.

Jika Claude Code belum memuat kebijakan organisasi Anda atau tidak dapat mengambilnya, perintah itu menjawab Couldn't verify your organization's policy for cloud sessions. Check your network connection, then restart Claude Code and try again. sebagai gantinya.

Yang harus dilakukan:

• Minta Owner di organisasi Anda untuk mengaktifkan sesi cloud di pengaturan admin Claude Code di claude.ai/admin-settings/claude-code
• Jika pesan mengatakan tidak dapat memverifikasi kebijakan, periksa koneksi jaringan Anda, kemudian mulai ulang Claude Code dan coba lagi

Nilai --json-schema bukan JSON Schema yang valid

Skema yang Anda berikan ke --json-schema dalam mode non-interaktif 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 diperlakukan sebagai tidak valid.

Error: --json-schema is not a valid JSON Schema: data/type must be equal to one of the allowed values

Teks setelah titik dua kedua adalah diagnostik validator dan menyebutkan kata kunci atau lokasi yang gagal. Skema yang menggunakan kata kunci format, seperti "format": "email", valid: Claude Code menerima format sebagai anotasi dan tidak memberlakukannya.

Claude Code menjalankan dua pemeriksaan sebelum kompilasi skema: menolak nilai yang tidak dapat diuraikan JSON dengan Error: --json-schema is not valid JSON, dan JSON yang valid tetapi bukan objek dengan Error: --json-schema must be a JSON object.

Yang harus dilakukan:

• Perbaiki bagian skema yang diagnostik sebutkan, kemudian jalankan kembali perintah
• Jika diagnostik adalah schema too large, kurangi nesting skema dan penggunaan kembali $ref
• Lihat Get structured output untuk skema kerja dan perintah

File pengaturan melebihi batas 2MiB

File yang Anda berikan ke --settings lebih besar dari 2 MiB, jadi claude keluar dengan kode 1 saat startup alih-alih memuatnya. File pengaturan adalah dokumen JSON kecil, jadi file sebesar ini biasanya berarti jalur menunjuk ke file yang salah. 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.

Error: Settings file exceeds the 2MiB limit: /path/to/settings.json

Claude Code menolak jalur --settings yang bukan file biasa dengan cara yang sama: perangkat, FIFO, atau soket melaporkan Error: Cannot use settings file (Not a regular file (device, FIFO, or socket)) diikuti oleh jalur, dan direktori melaporkan alasan EISDIR.

Yang harus dilakukan:

• Arahkan --settings ke file pengaturan JSON biasa di bawah 2 MiB. Lihat Settings untuk formatnya.

Direktori saat ini tidak lagi ada

Anda 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 sama-sama. Sebelum v2.1.239, Claude Code mogok dengan sumber bundle minified dan stack ENOENT ... uv_cwd mentah di stderr alih-alih pesan ini.

The current directory no longer exists (it was deleted or moved). Start Claude Code from an existing directory.
error: The current working directory was deleted, so that command didn't work. Please cd into a different directory and try again.

Penyebab dan perbaikannya sama untuk kedua bentuk.

Ketika Claude Code tidak dapat membaca direktori kerja karena alasan lain, seperti perubahan izin, pesan menyebutkan kode kesalahan sebagai gantinya: Can't read the current directory (EACCES). Start Claude Code from a different directory.

Di macOS, EPERM untuk direktori di ~/Desktop, ~/Documents, ~/Downloads, atau iCloud Drive biasanya berarti macOS memblokir aplikasi terminal Anda dari folder itu. Perintah lain yang membaca folder itu gagal dengan cara yang sama: ls di sana melaporkan Operation not permitted, bahkan dengan sudo.

Yang harus dilakukan:

• Ubah ke direktori yang ada, seperti direktori home atau proyek Anda, kemudian jalankan claude lagi
• Jika direktori dibuat kembali di jalur yang sama, shell Anda masih memegang yang dihapus. Jalankan cd "$PWD" atau tinggalkan dan masuki kembali direktori, kemudian jalankan claude lagi
• 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 terminal

Direktori temp ditolak atau tidak dapat dibuat

Di macOS dan Linux, Claude Code membuat direktori temp pribadi saat startup, claude-<uid> di bawah direktori temp sistem atau override CLAUDE_CODE_TMPDIR. Ketika direktori tidak dapat dibuat, atau entri yang sudah ada di jalur itu gagal pemeriksaan keamanan, Claude Code mencetak kegagalan ke stderr dan keluar dengan kode 1 daripada memulai sesi:

ENOSPC: no space left on device, mkdir '/tmp/claude-501'

Temp directory /tmp/claude-501 is not a directory (may be an attacker-planted symlink). Refusing to use it. Set CLAUDE_CODE_TMPDIR to a directory you control, or ask an administrator to remove it.

Temp directory /tmp/claude-501 is owned by uid 502, expected 501. Refusing to use it — another user may have pre-created it. Set CLAUDE_CODE_TMPDIR to a directory you control, or ask an administrator to remove it.

Temp directory /tmp/claude-501 is not readable (its mode may have been altered, or a path component denies search). Refusing to use it — restore its permissions (chmod 0700) or remove it. Set CLAUDE_CODE_TMPDIR to a directory you control, or ask an administrator to remove it.

Yang harus dilakukan:

• Untuk ENOSPC, bebaskan ruang disk di volume yang menyimpan direktori temp
• Untuk bentuk Refusing to use it, hapus entri yang disebutkan itu sendiri, bukan apa yang ditunjuk link, dan mulai Claude Code lagi; untuk bentuk owned by uid, hanya administrator atau pengguna itu yang dapat menghapusnya
• Untuk is not readable, jalankan chmod 0700 di direktori yang disebutkan, atau hapus dan mulai lagi
• Dalam kasus apa pun, atur CLAUDE_CODE_TMPDIR ke direktori yang Anda kontrol dan mulai Claude Code lagi, meninggalkan jalur yang ditolak sendirian

Direktori tidak dapat diselesaikan ke lokasi nyata

Anda menjalankan /add-dir untuk subdirektori direktori kerja Anda, dan Claude Code tidak dapat menyelesaikan direktori ke lokasi nyatanya.

Anda sudah memiliki akses file ke subdirektori direktori kerja, jadi /add-dir hanya memuat skills, commands, dan agents-nya. Sebelum memuatnya, Claude Code memeriksa bahwa lokasi nyata direktori, dengan symlink apa pun yang diselesaikan, berada di dalam direktori kerja. Ketika Claude Code tidak dapat menyelesaikan lokasi itu, tidak memuat apa pun dan menampilkan pesan ini:

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

Yang harus dilakukan:

• Periksa bahwa jalur menyebutkan direktori nyata di dalam direktori kerja, kemudian jalankan /add-dir lagi
• Pesan tidak mengubah akses file Anda; hanya melaporkan bahwa konten .claude/ direktori tidak dimuat

Sebelum 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 jalur dengan desain; direktori baik-baik saja dan mencoba kembali tidak bisa membantu.

Workspace tidak dipercaya saat memulai Remote Control

Anda memulai mode server Remote Control dengan claude remote-control atau alias claude rc-nya di direktori yang belum Anda percayai. Perintah tidak menampilkan dialog kepercayaan workspace itu sendiri, jadi keluar dengan kode 1 dan menyebutkan perbaikannya:

Error: Workspace not trusted. Please run `claude` in /Users/you/project first to review and accept the workspace trust dialog.

Di 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 menampilkan pesan di atas, yang sarannya tidak dapat berhasil di sana.

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

Yang harus dilakukan:

• Jalankan claude di direktori, terima dialog kepercayaan workspace, kemudian jalankan claude remote-control lagi
• Di direktori home Anda, ubah ke direktori proyek dan mulai Remote Control di sana

Tidak dibawa ke sesi yang Remote Control mulai

Anda memulai Remote Control dengan flag claude global sebelum verba 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 verba tidak pernah mencapai sesi itu. Claude Code menolak untuk memulai sebagai gantinya, menyebutkan flag:

Error: `--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`).

Claude Code tidak menolak flag global yang aman untuk dijatuhkan, seperti --verbose, --model, atau --session-id yang disuntikkan wrapper atau --plugin-dir: mengabaikannya dan Remote Control dimulai.

Claude Code juga menolak untuk memulai untuk flag global yang belum dikenalinya sebagai aman, jadi flag yang ditambahkan dalam rilis yang lebih baru dapat muncul dalam pesan ini sampai rilis yang lebih baru menandainya aman.

Yang harus dilakukan:

• Hapus flag dari sebelum verba dan berikan opsi Remote Control sendiri setelahnya; claude remote-control --help mencantumnya
• Ketika flag yang ditolak adalah --permission-mode, jalankan claude remote-control --permission-mode <mode> untuk mengatur mode izin untuk sesi yang Remote Control mulai

Sebelum v2.1.248, claude remote-control tidak menerima flag-nya sendiri ketika flag global datang terlebih dahulu, dan perintah gagal dengan kesalahan unknown option.

claude import belum tersedia dalam build ini

Anda menjalankan claude import, dan Claude Code menemukan alur impor dimatikan, jadi perintah 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.

`claude import` is not yet available in this build. Run `claude` and use /mcp or edit ~/.claude/settings.json directly.

Claude Code mengaktifkan claude import melalui flag fitur yang diambilnya dari Anthropic dan disimpan di disk. Pesan ini berarti nilai yang disimpan mati. Penyebabnya biasanya salah satu dari berikut:

• Anda belum memulai sesi sejak instalasi, jadi Claude Code belum mengambil flag. claude import pertama dapat mencetak ini bahkan ketika fitur tersedia untuk Anda.
• Anda menggunakan Claude Code melalui Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry, atau Claude Platform di AWS, atau melalui gateway aplikasi Claude. Claude Code tidak mengambil flag fitur dalam sesi ini, jadi claude import tetap tidak tersedia.
• Anda mengatur DISABLE_TELEMETRY, DO_NOT_TRACK, DISABLE_GROWTHBOOK, atau CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC, yang mematikan pengambilan flag fitur, jadi claude import tetap tidak tersedia.

Yang harus dilakukan:

• Pada instalasi segar, mulai claude, tunggu sesi dimuat, keluar, dan jalankan claude import lagi
• Di mana pengambilan flag fitur tetap mati, atur konfigurasi sendiri: tambahkan server MCP dengan claude mcp add, dan buat CLAUDE.md files, skills dan commands, dan subagents yang ingin Anda bawa. Pesan juga menyebutkan ~/.claude/settings.json. Dari konfigurasi yang claude import bawa, file itu hanya menyimpan mode izin; Claude Code tidak membaca server MCP darinya.

Tidak dapat membaca konfigurasi Claude Code

Anda menjalankan claude import sementara Claude Code tidak dapat menguraikan ~/.claude.json, file tempat menyimpan login dan status per-proyek Anda. Subperintah membaca file itu untuk memeriksa ketersediaan tetapi tidak menampilkan dialog pemulihan yang ditampilkan sesi interaktif, 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.

Could not read Claude Code config — run `claude` with no arguments to recover it.

Yang harus dilakukan:

• Jalankan claude tanpa argumen. Claude Code mendeteksi file yang tidak valid dan menawarkan untuk mengatur ulangnya. Kemudian jalankan claude import lagi.
• Untuk menyimpan edit manual yang Anda buat, perbaiki sintaks JSON di ~/.claude.json di editor sebagai gantinya, kemudian jalankan kembali claude import

Tidak dapat mengimpor server dari Claude Desktop

Claude Code tidak dapat menambahkan salah satu server yang Anda pilih di claude mcp add-from-claude-desktop. Perintah 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 dan tidak ada server yang dipilih ditambahkan.

Could not import my server: Invalid name my server. Names can only contain letters, numbers, hyphens, and underscores.

Teks 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 organisasi Anda.

Yang harus dilakukan:

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

Tidak dapat menambahkan server MCP ke cakupan yang dikelola

Anda menjalankan claude mcp add atau claude mcp add-json dengan --scope managed. Cakupan itu menyimpan server yang organisasi Anda sediakan melalui pengaturan yang dikelola managedMcpServers. Claude Code membacanya dari pengaturan yang dikelola saja, jadi perintah tidak dapat menulis server ke cakupan itu.

Cannot add MCP server to scope: managed

Yang harus dilakukan:

• Tambahkan server ke cakupan yang dapat Anda tulis: local, user, atau project. Tanpa --scope, perintah menggunakan local. Lihat MCP installation scopes
• Untuk menyediakan server kepada setiap pengguna di organisasi Anda, tambahkan ke managedMcpServers dalam pengaturan yang dikelola yang Anda sebarkan

Tidak dapat membaca .mcp.json

Perintah yang membaca .mcp.json proyek, 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 biasa atau lebih besar dari 2 MiB, jadi keluar dengan kesalahan ini alih-alih membaca file.

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

Sebelum v2.1.257, FIFO di .mcp.json membiarkan perintah menunggu selamanya tanpa output, dan symlink ke file perangkat seperti /dev/zero menumbuhkan memori sampai proses dibunuh.

Yang harus dilakukan:

• Periksa apa yang duduk di .mcp.json di direktori saat ini. Ganti dengan file JSON biasa dalam format cakupan proyek, atau hapus, kemudian jalankan perintah lagi.

Server adalah Anthropic-hosted dan tidak mendukung OAuth lokal

Anda memulai sign-in untuk server MCP yang URL-nya menunjuk ke host konektor 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 berfungsi melalui claude.ai.

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

Claude Code mencocokkan host ini berdasarkan URL, jadi pesan muncul ketika server yang Anda tambahkan dengan claude mcp add atau di .mcp.json menunjuk ke salah satunya.

Yang harus dilakukan:

• Hapus entri Anda dengan claude mcp remove <name>, sehingga tidak dapat menyembunyikan konektor claude.ai di URL yang sama
• Setelah menghapusnya, hubungkan layanan di claude.ai/customize/connectors, sambil masuk ke akun yang Anda gunakan di Claude Code. Setelah terhubung, konektor muncul di Claude Code secara otomatis jika metode autentikasi aktif Anda adalah login langganan claude.ai

Server menolak header Authorization yang dicetak oleh headersHelper yang dikonfigurasi

Server MCP yang headersHelper-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 kembali ke OAuth untuk server:

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

Claude Code menjalankan kembali helper pada setiap upaya koneksi, jadi retry setelah penolakan sementara, seperti perlombaan rotasi token, dapat berhasil dengan kredensial segar.

Yang harus dilakukan:

• Jalankan perintah headersHelper sendiri dengan cara Claude Code menjalankannya: dari direktori Claude Code menjalankannya, dengan variabel lingkungan Claude Code mengaturnya, dan tanpa variabel kredensial Claude Code menghapusnya untuk server dari .mcp.json proyek, plugin, atau file agen proyek. Periksa bahwa itu mencetak nilai Authorization yang titik akhir server terima
• Setelah memperbaiki helper atau sumber kredensialnya, pilih server di /mcp dan pilih Reconnect

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

Alat prompt izin MCP tidak ditemukan

Alat yang Anda berikan ke --permission-prompt-tool tidak ada di antara alat 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 alat dengan nama itu. Claude Code masih mengirimkan prompt Anda: run non-interaktif keluar dengan kesalahan ini, dan kode keluar 1, pada panggilan alat pertama yang memerlukan persetujuan, jadi tidak menghasilkan jawaban meskipun permintaan dibuat. Sebelum prompt pertama, Claude Code menunggu hingga timeout koneksi per-server 30 detik yang ditetapkan oleh MCP_TIMEOUT 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.

Error: MCP tool mcp__permissions__approve (passed via --permission-prompt-tool) not found. Available MCP tools: none

Daftar setelah Available MCP tools: menyebutkan alat MCP yang terhubung ketika tunggu berakhir.

Yang harus dilakukan:

• Periksa bahwa server dimulai dan tetap terhubung: jalankan claude mcp list di direktori yang sama dan konfirmkan server terdaftar sebagai terhubung
• Konfirmkan nama alat cocok dengan nama mcp__<server>__<tool> yang server ekspos
• Jika server memerlukan lebih lama dari 30 detik untuk dimulai, naikkan MCP_TIMEOUT

Port callback OAuth sudah digunakan

Ketika 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 yang ditetapkan melalui variabel MCP_OAUTH_CALLBACK_PORT atau --callback-port, karena tanpa itu Claude Code memilih port yang tersedia.

OAuth callback port <port> is already in use — another process may be holding it. Run `lsof -ti:<port> -sTCP:LISTEN` to find it.

Di Windows, perintah yang disarankan adalah netstat -ano | findstr :<port> sebagai gantinya.

Yang harus dilakukan:

• Jalankan perintah dari pesan untuk menemukan proses yang memegang port, dan hentikan atau tunggu selesai
• Jika program lain memerlukan port itu secara permanen, daftarkan URI pengalihan berbeda dengan server dan atur port-nya dengan MCP_OAUTH_CALLBACK_PORT atau --callback-port, mana pun yang Anda gunakan
• Kemudian mulai sign-in lagi, misalnya dengan memilih server di /mcp

Tidak ada port yang tersedia untuk pengalihan OAuth

Ketika Anda masuk ke server MCP jarak jauh dengan OAuth, 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 perangkat lunak keamanan atau kebijakan sandbox yang menolak pendengar lokal.

No available ports for OAuth redirect

Sebelum v2.1.268, Claude Code tidak 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.

Yang harus dilakukan:

• Periksa apakah perangkat lunak keamanan atau kebijakan sandbox memblokir proses dari mendengarkan di 127.0.0.1, dan izinkan Claude Code mengikat port lokal
• Kemudian mulai sign-in lagi, misalnya dengan memilih server di /mcp

/security-review gagal tanpa origin/HEAD

/security-review membangun konteks review dengan membedakan cabang Anda terhadap origin/HEAD, ref lokal yang mencatat cabang mana yang default di remote origin Anda. Ketika ref itu tidak ada, perintah git yang mengumpulkan diff gagal dan review berhenti sebelum dimulai.

Error: Shell command failed for pattern "!`git diff --name-only origin/HEAD...`": [stderr]
fatal: ambiguous argument 'origin/HEAD...': unknown revision or path not in the working tree.
Use '--' to separate paths from revisions, like this:
'git <command> [<revision>...] -- [<file>...]'

Pesan dapat mengutip git log atau git diff berbeda sebagai gantinya. Git membuat origin/HEAD hanya ketika remote mengiklankan cabang default dan refspec fetch Anda mencakupnya, yang git clone penuh dari remote dengan commit lakukan. Ref hilang dalam setup ini:

• Checkout single-branch atau CI, yang mengambil refspec terlalu sempit
• Remote yang server-side HEAD menunjuk ke cabang yang tidak ada yang dorong
• Repository tanpa remote origin, atau yang tidak pernah Anda ambil

Claude Code menampilkan kesalahan yang sama untuk skill apa pun yang menyuntikkan konteks dinamis, dan perintah yang disuntikkan gagal membatalkan invokasi skill itu. Dua string saudara api sebelum perintah berjalan sama sekali:

• Shell command permission check failed for pattern "...": pemeriksaan izin perintah tidak mengizinkannya. Permission checks on injected commands mencakup hasil mana yang membatalkan dalam setiap mode izin dan cara pra-menyetujui perintah dengan allowed-tools
• 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

Yang harus dilakukan:

• Buat ref dengan menyebutkan cabang default remote Anda: git remote set-head origin <default-branch>. Ini berfungsi kapan pun ref pelacakan lokal origin/<default-branch> ada. Jika tidak, seperti dalam klon single-branch, ambil cabang terlebih dahulu: jalankan git remote set-branches --add origin <branch>, kemudian git fetch origin, kemudian jalankan kembali perintah set-head. Jalankan kembali /security-review.
• Jika Anda lebih suka tidak menyebutkan cabang, jalankan git fetch origin dan kemudian git remote set-head origin --auto, yang menanyakan remote cabang mana yang default-nya. Gagal dengan error: Cannot determine remote HEAD ketika remote tidak mengiklankan cabang default, karena kosong atau HEAD-nya menunjuk ke cabang yang tidak ada yang dorong; sebutkan cabang secara eksplisit sebagai gantinya. Gagal dengan error: Not a valid ref ketika klon Anda tidak mengambil cabang itu; perluas refspec seperti di atas terlebih dahulu.
• Jika repository tidak memiliki remote, tambahkan dengan git remote add origin <url> dan ambil sebelum membuat ref. Jika remote kosong, dorong cabang Anda terlebih dahulu dengan git push -u origin HEAD dan sebutkan cabang itu dalam perintah set-head; origin/HEAD kemudian menunjuk ke cabang yang baru saja Anda dorong, jadi /security-review melihat diff kosong sampai cabang menyimpang darinya.

Input harus disediakan saat menggunakan --print

claude telanjang memerlukan stdout menjadi terminal untuk memulai UI interaktif. Ketika stdout dialihkan, atau konsol bukan terminal nyata, seperti PowerShell ISE dan beberapa panel output IDE, claude berjalan non-interaktif sebagai gantinya. Itu adalah mode yang sama dengan claude -p, yang memerlukan prompt, jadi pesan menyebutkan --print bahkan ketika Anda tidak melewatkan flag. Melewatkan -p/--print tanpa prompt dan tidak ada yang disalurkan di stdin menghasilkan kesalahan yang sama di mana pun.

Error: Input must be provided either through stdin or as a prompt argument when using --print

Yang harus dilakukan:

• Untuk penggunaan interaktif, jalankan claude di terminal nyata: Windows Terminal atau konsol PowerShell daripada ISE, dan terminal terintegrasi IDE Anda daripada panel output
• Untuk penggunaan satu kali, berikan prompt: claude -p "your question", atau salurkan dengan echo "your question" | claude -p

Input hanya berisi whitespace

Dalam mode non-interaktif, Claude Code menolak prompt yang terdiri sepenuhnya dari spasi, tab, atau baris baru alih-alih mengirimnya, karena API menolak pesan tanpa teks yang terlihat. Pesan mana yang Anda lihat tergantung di mana prompt kosong berasal:

• Argumen prompt atau stdin yang disalurkan 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
• Pesan yang dikirimkan ke sesi --input-format stream-json atau Agent SDK 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.

Sebelum v2.1.229, Claude Code mengirimkan pesan whitespace-only ke API, yang menolak permintaan dengan kesalahan 400.

Yang harus dilakukan:

• Sertakan teks yang terlihat dalam prompt. Jika skrip membangun prompt dari variabel atau file, periksa bahwa sumber tidak kosong sebelum memanggil Claude Code.

input stream-json membawa lebih dari 256M karakter tanpa baris baru

Program Anda mengirim lebih dari 268.435.456 karakter di stdin tanpa baris baru ke run claude -p --input-format stream-json, jadi Claude Code mencetak kesalahan ini ke stderr dan keluar dengan kode 1 alih-alih membuffer input lebih lanjut. 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.

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

Input sepanjang ini tanpa baris baru biasanya berarti produsen bukan produsen stream-json sama sekali, seperti file biner atau output log biasa yang disalurkan secara tidak sengaja. Pesan tunggal di atas anggaran gagal pemeriksaan yang sama.

Yang harus dilakukan:

• Periksa apa yang disalurkan ke stdin. Dengan --input-format stream-json, setiap pesan harus satu baris JSON yang diakhiri baris baru
• Untuk mengirim teks biasa sebagai gantinya, lepaskan --input-format stream-json; claude -p membaca prompt teks biasa dari stdin secara default

Perintah tidak dikenal

Dalam sesi terminal interaktif, Anda mengirimkan nama / yang tidak cocok dengan perintah apa pun dalam sesi ini, jadi Claude Code melaporkan nama alih-alih menjalankan apa pun:

Unknown command: /hepl. Did you mean /help?

Claude Code menyarankan nama perintah atau alias terdekat yang menu daftar dalam sesi ini. Ketika tidak ada yang dekat, pesan berakhir setelah nama. Penyebabnya biasanya salah satu dari berikut:

• Typo, seperti /hepl untuk /help. How the command menu matches what you type mencakup memilih kecocokan dekat sebelum Anda kirimkan
• Perintah yang ada tetapi tidak tersedia dalam sesi ini karena persyaratan tidak terpenuhi, seperti platform, rencana, atau metode autentikasi Anda. Entri pemecahan masalah untuk /web-setup dan /schedule memandu dua kasus umum. Beberapa perintah menjawab dengan pesan mereka sendiri ketika kebijakan organisasi Anda menonaktifkannya, seperti Cloud sessions are disabled by your organization's policy
• Perintah dari plugin atau server MCP yang tidak diinstal atau terhubung dalam sesi ini

Claude Code menjawab nama / yang tidak cocok dengan cara ini hanya dalam sesi terminal interaktif. Dalam setiap sesi lain, mengirimkan prompt ke Claude sebagai pesan normal sebagai gantinya, dengan catatan bahwa perintah tidak berjalan dan daftar perintah Claude dapat jalankan dalam sesi. Sesi itu termasuk:

• run -p
• Aplikasi Agent SDK
• Tab Kode dari Desktop app
• Panel chat dari VS Code extension
• Sesi cloud dan routines

Untuk perintah bawaan yang tidak dapat berjalan dalam salah satu sesi itu, Claude Code masih menjawab bahwa perintah tidak tersedia alih-alih mengirimnya ke Claude. Sebelum v2.1.274, hanya sesi cloud dan routines yang mengirimkan nama yang tidak cocok ke Claude. Sebelum v2.1.273, mereka menjawab Unknown command juga.

Claude Code tidak memperlakukan setiap prompt yang dimulai dengan / sebagai perintah. Mengirimkan prompt ke Claude sebagai pesan normal ketika kata pertama setelah / dimulai dengan tanda baca, seperti /-- yang membuka komentar doc Lean, atau adalah jalur seperti /var/log/syslog.

Sebelum v2.1.236, jika Anda menekan Enter sementara menu perintah mencantumkan kecocokan dekat untuk nama yang Anda ketik, Claude Code menjalankan kecocokan itu, jadi typo seperti /hepl menjalankan /help alih-alih menghasilkan pesan ini.

Yang harus dilakukan:

• Jalankan nama yang disarankan, atau ketik / diikuti bagian dari nama untuk melihat apa yang tersedia dalam sesi ini
• Jika Claude Code melaporkan perintah yang didokumentasikan sebagai tidak dikenal, periksa barisnya dalam referensi perintah untuk persyaratan yang disebutkan

Diff terlalu besar untuk ultrareview

Diff antara cabang Anda dan cabang dasar, termasuk perubahan yang tidak berkomitmen dan staged, melebihi batas ukuran untuk ultrareview, jadi /code-review ultra dan subperintah claude ultrareview menolak review sebelum sesi cloud dimulai. Review yang ditolak tidak menggunakan run gratis dan tidak menagih kredit penggunaan. Pesan menyebutkan batas yang berlaku, ukuran diff Anda, dan file yang berkontribusi paling banyak baris yang berubah. Sebelum v2.1.216, pesan menampilkan hanya statistik diff mentah.

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

Meninjau pull request menerapkan batas yang sama; bentuk pesan itu dimulai PR #<N> is too large for ultrareview dan menyebutkan file dan jumlah baris PR.

Yang harus dilakukan:

• Berikan cabang dasar yang lebih dekat ke pekerjaan Anda, seperti /code-review ultra develop, jadi review mencakup hanya diff terhadap cabang itu
• Pisahkan perubahan menjadi cabang yang lebih kecil dan tinjau masing-masing. File yang pesan sebutkan berkontribusi paling banyak baris yang berubah, jadi mulai dengan memindahkan itu ke cabang mereka sendiri.

Tidak dapat menemukan merge-base dengan cabang dasar

/code-review ultra dan subperintah claude ultrareview meninjau diff antara cabang Anda dan cabang dasar, yang memerlukan komitmen yang keduanya bagikan. Ketika git merge-base tidak menemukan apa pun, Claude Code menolak review sebelum sesi cloud dimulai. Pada klon Claude Code dapat verifikasi lengkap, dengan setidaknya satu cabang, itu kembali ke meninjau setiap file yang dilacak alih-alih menolak. Anda melihat penolakan ini ketika cabang dasar tidak dapat ditemukan sama sekali, ketika Claude Code tidak dapat memverifikasi bahwa klon Anda lengkap, atau di repository langka di mana diff seluruh pohon tidak mungkin, seperti format objek SHA-256.

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

Petunjuk setelah kalimat pertama tergantung pada apa yang Claude Code amati:

• Anda tidak melewatkan cabang dasar: Claude Code dibandingkan terhadap cabang default repository dan menyarankan melewatkan dasar Anda secara eksplisit, seperti dalam contoh di atas
• Anda melewatkan cabang dasar yang sudah ada di klon Anda: petunjuk membaca Make sure <branch> exists locally or on origin (try `git fetch origin <branch>`)
• Anda melewatkan cabang dasar yang tidak ada di klon 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 klon Anda dangkal, itu menyarankan git fetch --unshallow origin sebagai gantinya. Sebelum v2.1.221, petunjuk menyarankan git fetch --unshallow origin untuk setiap cabang dasar yang diambil, dan pada klon lengkap perintah itu gagal dengan fatal: --unshallow on a complete repository does not make sense.

Yang harus dilakukan:

• Jika cabang lain adalah dasar nyata Anda, berikan secara eksplisit: /code-review ultra <branch>
• Jika klon Anda mungkin tidak memiliki riwayat penuh, jalankan git fetch --unshallow origin dan jalankan kembali review

Checkout Anda tidak memiliki cabang

Checkout dapat memiliki komitmen tetapi tidak ada cabang: jika Anda menjalankan git init diikuti git fetch <url> dan git checkout FETCH_HEAD, Anda mendapatkan HEAD terlepas dengan tidak ada refs. Claude Code mengemas repository Anda sebagai bundel git untuk mengunggahnya untuk ultrareview, dan tidak dapat membundel repository yang tidak memiliki cabang atau refs lainnya, jadi /code-review ultra dan subperintah claude ultrareview menolak review sebelum sesi cloud dimulai.

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

Sebelum v2.1.221, Claude Code mencoba meninjau setiap file yang dilacak dalam checkout ini, dan unggahan gagal.

Yang harus dilakukan:

• Buat cabang di komitmen saat ini Anda dengan git checkout -b <name>, kemudian jalankan kembali review

Tidak ada akun GitHub yang terhubung ke akun Claude Anda

Anda 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 dapat menjangkau repository PR. Tidak ada akun yang terhubung, atau koneksi kedaluwarsa, jadi klon cloud akan gagal dan Claude Code menolak peluncuran. Claude Code tidak menghabiskan run gratis atau menagih kredit penggunaan untuk peluncuran yang ditolak.

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

Ketika /web-setup tidak tersedia dalam sesi Anda, pesan hanya menyebutkan tautan claude.ai.

Yang harus dilakukan:

• Jalankan /web-setup untuk menghubungkan login GitHub CLI Anda ke akun Claude Anda, atau hubungkan akun di claude.ai/connect-github
• Jalankan kembali review satu menit setelah terhubung

Sebelum v2.1.248, Claude Code tidak memeriksa ini sebelum peluncuran.

Akun GitHub yang terhubung Anda tidak dapat melihat repository

Anda menjalankan /code-review ultra <PR#> atau claude ultrareview <PR#>, dan akun GitHub yang terhubung ke akun Claude Anda tidak dapat membaca repository PR, jadi klon cloud akan gagal dan Claude Code menolak peluncuran. Claude Code tidak menghabiskan run gratis atau menagih kredit penggunaan untuk peluncuran yang ditolak.

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

Ketika /web-setup tidak tersedia dalam sesi Anda, pesan hanya menyebutkan instalasi aplikasi.

Yang harus dilakukan:

• Jika CLI gh lokal Anda dapat membaca repository, jalankan /web-setup untuk menghubungkan login itu ke akun Claude Anda
• Jalankan kembali review setelah perubahan

Sebelum v2.1.248, Claude Code tidak memeriksa ini sebelum peluncuran.

Preflight GitHub App gagal secara sementara

Anda memulai sesi cloud dari repository lokal, dan dua langkah gagal bersama-sama. Claude Code tidak dapat membangun atau mengunggah bundel repository Anda. Sebelum unggahan, itu memeriksa apakah layanan cloud dapat mengklon repository dari GitHub, dan daripada jawaban pasti, pemeriksaan itu berakhir dalam kesalahan yang retry dapat bersihkan, seperti kesalahan jaringan, timeout, atau kesalahan server sementara. Pesan lengkap dimulai dengan apa yang menghentikan bundel, misalnya Could not upload repo bundle (<error>), dan berakhir dengan kalimat preflight:

Could not upload repo bundle (<error>). The GitHub App preflight failed transiently (network or service hiccup) — retry in a moment to start from GitHub instead

Yang harus dilakukan:

• Jalankan kembali perintah setelah beberapa saat. Ketika pemeriksaan GitHub lulus, Claude Code dapat memulai sesi dari klon GitHub, jadi unggahan yang gagal tidak lagi memblokir peluncuran
• Jika retry terus gagal, awal pesan menyebutkan apa yang menghentikan unggahan. Ketika penyebab itu adalah sesuatu yang dapat Anda perbaiki, perbaiki sehingga sesi dapat dimulai dari repository lokal Anda sebagai gantinya

Sebelum v2.1.251, Claude Code mengakhiri pesan dengan Please set up GitHub on https://claude.ai/code bahkan ketika pemeriksaan GitHub gagal hanya secara sementara, dan saran setup tidak dapat membersihkan kegagalan sementara.

GitHub tidak terhubung ke akun Claude Anda

Anda memulai sesi cloud 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:

GitHub 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

Ketika Anda membuat routine dengan /schedule, pesan yang sama muncul sebagai catatan setup yang menyebutkan repository; catatan tidak memblokir pembuatan routine.

Yang harus dilakukan:

• Jalankan /web-setup untuk menghubungkan login GitHub CLI Anda ke akun Claude Anda, atau hubungkan akun di claude.ai/connect-github. Lihat GitHub authentication options untuk bagaimana keduanya berbeda.
• Jalankan kembali perintah satu menit setelah terhubung

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

Otorisasi single sign-on diperlukan

Anda menjalankan /install-github-app 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:

Single sign-on authorization needed
<owner>/<repo> belongs to an organization that enforces SAML single sign-on, and your GitHub CLI token isn't authorized for it yet.

Yang harus dilakukan:

• Otorisasi kembali login GitHub CLI Anda dengan cakupan repo dan workflow dengan menjalankan gh auth refresh -h github.com -s repo,workflow, dan otorisasi organisasi ketika GitHub meminta single sign-on
• Jika Anda mengautentikasi dengan token akses pribadi di GH_TOKEN, buka github.com/settings/tokens, pilih Configure SSO pada token, dan otorisasi organisasi
• Jalankan /install-github-app lagi

Sebelum v2.1.273, Claude Code menampilkan peringatan Admin permissions required untuk kondisi ini sebagai gantinya.

Gagal melanjutkan percakapan

Claude Code tidak dapat membaca atau memproses transkrip yang disimpan untuk sesi yang Anda pilih dari pemilih claude --resume, jadi mengakhiri proses daripada melanjutkan dalam keadaan sebagian dimuat. Pesan mencakup perintah untuk retry:

Failed to resume the conversation.
Run claude --resume <session-id> to retry, or claude to start a new session.

Claude Code keluar dengan kode 1 setelah menampilkan pesan. Pemilih /resume di dalam sesi yang berjalan melaporkan Failed to resume conversation dalam percakapan sebagai gantinya, dan sesi saat ini Anda terus berjalan. Sebelum v2.1.216, resume yang gagal dari pemilih claude --resume tetap di spinner Resuming conversation… tanpa batas waktu alih-alih menampilkan pesan ini.

Yang harus dilakukan:

• Jalankan claude --resume <session-id> dengan ID sesi dari pesan untuk retry
• 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.
• Jika retry gagal lagi, jalankan claude untuk memulai sesi baru

Tidak ada percakapan yang ditemukan dengan ID sesi

Anda melewatkan ID sesi ke claude --resume <session-id> dan tidak ada transkrip yang disimpan cocok:

No conversation found with session ID: <session-id>

Claude Code keluar dengan kode 1 setelah menampilkan pesan. Claude Code mencari proyek saat ini terlebih dahulu, kemudian setiap proyek lain di mesin ini untuk ID. Sebelum v2.1.223, pencarian berhenti di direktori proyek saat ini dan worktree git-nya, jadi resume dari direktori tempat sesi terakhir bekerja.

Penyebab umum:

• ID yang salah ketik: untuk run non-interaktif, ID adalah bidang session_id dari output --output-format json
• Transkrip yang dihapus: Claude Code menghapus transkrip setelah periode retensi, 30 hari secara default, mengikuti aturan pembersihan retensi
• Mesin berbeda: Claude Code menyimpan transkrip secara lokal, jadi resume sesi di mesin tempat itu berjalan
• Salinan duplikat: jika Anda menyalin direktori proyek di bawah ~/.claude/projects sehingga dua transkrip membawa ID yang sama, Claude Code melaporkan pesan ini daripada resume satu salinan secara sewenang-wenang

Yang harus dilakukan:

• Untuk sesi interaktif, buka pemilih sesi dengan claude --resume dan tekan Ctrl+A untuk memperluas ke setiap proyek di mesin ini, kemudian pilih sesi
• Sesi yang dibuat dengan claude -p atau Agent SDK tidak muncul dalam pemilih, jadi periksa kembali ID terhadap session_id yang run asli Anda cetak

Tidak dapat mengganti renderer dalam sesi ini

Ketika Anda mengganti renderer, Claude Code memulai ulang prosesnya. Anda menjalankan /tui dalam sesi Claude Code menolak untuk memulai ulang, jadi tidak mengganti dan menyimpan apa pun. Pesan mana yang Anda lihat memberi tahu Anda penyebabnya:

• Cannot switch renderers while work is running in the background: Anda memiliki pekerjaan latar belakang yang berjalan yang restart akan meninggalkan, seperti shell latar belakang atau subagen. Tunggu pekerjaan selesai atau hentikan dengan /tasks, kemudian jalankan /tui fullscreen atau /tui default lagi
• Cannot switch renderers in this session: sesi memiliki pembatasan Claude Code tidak dapat lulus ke proses yang dimulai ulang. Sebelum v2.1.234, Claude Code memulai ulang bagaimanapun dan sesi yang diluncurkan kembali berjalan tanpanya

Dalam pesan pembatasan, bagian dalam tanda kurung menyebutkan pembatasan Claude Code temukan:

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

Setiap alasan pesan dapat tunjukkan dalam tanda kurung:

• launch flags: a custom system prompt, a tool allowlist, or restricted settings: Anda memulai sesi dengan flag Claude Code tidak lulus kembali ke proses yang dimulai ulang. Flag ini termasuk --system-prompt, --system-prompt-file, --append-system-prompt-file, daftar allowlist --tools, --setting-sources, dan --permission-prompt-tool
• permission rules set for this session only: pembaruan izin dari hook atau pemanggil SDK menambahkan aturan deny atau ask dengan tujuan session. Aturan allow yang scoped sesi tidak memicu penolakan. Restart menjatuhkan mereka, dan Claude Code meminta lagi sebagai gantinya
• ask-before-running rules with no command-line form: pembaruan izin dari hook atau pemanggil SDK menambahkan aturan ask bersama aturan Claude Code lulus kembali sebagai --allowed-tools dan --disallowed-tools. Tidak ada flag untuk aturan ask
• permission rules a command line cannot carry intact dan added directories a command line cannot carry intact: pembaruan izin menambahkan aturan atau jalur direktori mid-session. Baris perintah proses yang dimulai ulang tidak dapat membawa teksnya sebagai nilai yang sama

Yang harus dilakukan:

• Dalam sesi yang dimulai tanpa pembatasan itu, jalankan /tui fullscreen, atau /tui default untuk beralih kembali. Claude Code menyimpan pengaturan tui di sana

Couldn't open Claude Desktop

Anda menjalankan /desktop, atau alias /app-nya, dan perintah sistem yang Claude Code gunakan untuk membuka Claude Desktop gagal. Sesi tetap di terminal.

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

Yang harus dilakukan:

• Buka Claude Desktop sendiri, kemudian jalankan /desktop lagi
• Untuk membaca output kesalahan lengkap perintah itu, aktifkan debug logging dengan /debug, jalankan /desktop lagi, dan periksa log debug

Sebelum v2.1.275, pesan adalah Failed to open Claude Desktop. Please try opening it manually. dan tidak mengatakan apa yang gagal.

/terminal-setup meninggalkan keymap Zed Anda tidak berubah

Anda menjalankan /terminal-setup di Zed, dan Claude Code tidak dapat menyelesaikan pembaruan ke keymap.json Zed Anda, jadi meninggalkannya seperti apa adanya.

Setiap pesan menyebutkan jalur ke keymap Anda dan berakhir dengan blok keybinding untuk ditambahkan sendiri:

Couldn't update your Zed keymap, so it was left unchanged.
To add the binding yourself, add this block to the keymap array in <path to keymap.json>:
{ "context": "Terminal", "bindings": { "shift-enter": ["terminal::SendText", "\u001b\r"] } }

Baris pertama pesan menyebutkan penyebabnya:

• Couldn't read your Zed keymap, so it was left unchanged.: Claude Code tidak dapat membaca file, misalnya karena izin file
• 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 diizinkan
• 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 pun
• Couldn't update your Zed keymap, so it was left unchanged.: hasil yang digabung tidak memverifikasi sebagai keymap yang valid membawa keybinding, jadi Claude Code membuangnya alih-alih menulis. Blok keybinding dengan kunci yang diduplikasi dapat menyebabkan ini

Yang harus dilakukan:

• Salin blok dari pesan ke array tingkat atas di keymap.json Anda di jalur yang pesan sebutkan
• Untuk isn't a readable list of keybindings, perbaiki kesalahan sintaks, atau buat nilai tingkat atas file menjadi array, kemudian jalankan /terminal-setup lagi

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

Laporan penggunaan skill tidak tersedia pada koneksi ini

Anda menjalankan /skill-doctor melalui Remote Control, dari ponsel atau browser Anda. Claude Code tidak mengirimkan laporan penggunaan skill melalui Remote Control dan menjawab dengan pesan ini sebagai gantinya:

Skill usage reports are not available on this connection.

Yang harus dilakukan:

• Jalankan /skill-doctor di terminal di mesin tempat sesi berjalan, atau jalankan claude -p "/skill-doctor" di sana

Gaya output kustom tidak dapat dipilih melalui Remote Control

Anda menjalankan /output-style dari aplikasi mobile atau web melalui Remote Control, atau perintah tiba dalam pesan yang disalurkan ke sesi. Karena giliran seperti itu mungkin tidak berasal dari pemilik akun, Claude Code mencantumkan dan memilih hanya gaya bawaan di atasnya, dan menambahkan pemberitahuan ini kapan pun perintah mencantumkan gaya atau tidak mengenali nama yang Anda berikan. Nama gaya kustom mendapat jawaban yang sama dengan nama yang tidak ada:

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

Yang harus dilakukan:

• Pilih gaya bawaan, misalnya /output-style concise
• Untuk menggunakan gaya kustom, atur outputStyle di .claude/settings.local.json proyek, atau jalankan /output-style <style> di terminal sesi sendiri jika memilikinya

Gaya output disimpan ke pengaturan lokal yang sesi ini tidak muat

Anda mencoba mengganti gaya output dengan /output-style <style> atau /config outputStyle=<style> dalam sesi yang sumber pengaturannya mengecualikan local. Contohnya adalah sesi Agent SDK yang settingSources-nya meninggalkan "local" dan sesi CLI yang dimulai dengan nilai --setting-sources yang meninggalkan local. Kedua perintah menyimpan gaya ke .claude/settings.local.json, file yang sesi seperti itu tidak pernah baca kembali, jadi Claude Code menolak alih-alih menulis pengaturan yang tidak akan berpengaruh:

Output styles are saved to local settings (.claude/settings.local.json), which this session doesn't load, so the style can't be changed here.

Yang harus dilakukan:

• Tambahkan local ke sumber pengaturan sesi dan beralih lagi
• Atur kunci outputStyle dalam file pengaturan yang sesi muat, seperti .claude/settings.json di proyek atau ~/.claude/settings.json. Dalam SDK TypeScript, atur outputStyle di dalam objek settings inline sebagai gantinya; lihat Activate an output style

Kesalahan plugin

Kesalahan ini berasal dari konfigurasi plugin dan marketplace. 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 Pemecahan masalah plugin.

plugin eval is currently in early access

Anda menjalankan claude plugin eval atau claude plugin eval init dan keluar dengan kode 1 dengan salah satu pesan ini sebelum melakukan apa pun:

`plugin eval` is currently in early access

`plugin eval` is currently unavailable

Pesan pertama berarti build Anda lebih lama dari v2.1.269, versi pertama di mana perintah tersedia secara umum. Pesan kedua berarti Anthropic telah mematikan perintah di sisi server; tidak ada yang di mesin Anda yang menghidupkannya kembali.

Yang harus dilakukan:

• Jalankan claude --version, kemudian claude update, dan jalankan perintah lagi dalam sesi baru. Lihat persyaratan untuk plugin evals
• Jika Anda melihat pesan kedua pada build saat ini, coba lagi nanti setelah claude update lain

Marketplace is registered from an untrusted source

Marketplace terdaftar dengan nama yang dicadangkan untuk marketplace Anthropic resmi, tetapi sumber terdaftarnya bukan repositori GitHub anthropics. Claude Code memeriksa ulang nama yang dicadangkan setiap kali memuat atau menyegarkan marketplace, sehingga marketplace dan plugin yang dipasang darinya berhenti memuat. Sebelum v2.1.205, nama hanya diperiksa ketika marketplace ditambahkan, jadi entri yang terdaftar sebelum namanya dicadangkan terus memuat.

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

Untuk marketplace yang sumbernya bukan repositori GitHub atau URL Git, seperti direktori lokal, kalimat tengah berbunyi can only be used with GitHub sources from the 'anthropics' organization sebagai gantinya. claude plugin marketplace add menjalankan pemeriksaan yang sama, dan menolak nama yang dicadangkan dengan Failed to add marketplace: diikuti oleh kalimat nama yang dicadangkan yang sama.

Yang harus dilakukan:

• Jika marketplace sudah terdaftar, jalankan claude plugin marketplace remove <name>, kemudian tambahkan lagi dari repositori github.com/anthropics resmi
• Jika Anda menerbitkan marketplace pihak ketiga yang menggunakan nama sebelum dicadangkan, ubah namanya dan minta pengguna untuk menambahkannya kembali dari sumber Anda
• Lihat daftar nama yang dicadangkan di bawah Marketplace schema

Marketplace name is another spelling of a reserved name

Nama marketplace bukan sendiri nama yang dicadangkan, tetapi Claude Code memperlakukannya sebagai ejaan lain dari satu. Reserved names mencantumkan ejaan mana yang dihitung sebagai nama yang dicadangkan. Claude Code menolak nama seperti itu ketika Anda menambahkan marketplace:

Failed to add marketplace: "claude.code.plugins" is another spelling of "claude-code-plugins", a reserved marketplace name.

Ketika marketplace sudah terdaftar dengan nama seperti itu, entrinya berhenti memuat, dan /plugin, claude plugin install, dan claude plugin update memperingatkan:

known_marketplaces.json has an entry named "claude.code.plugins", another spelling of the reserved marketplace name "claude-code-plugins", so it is ignored. Remove it with: claude plugin marketplace remove claude.code.plugins

Ketika nama memerlukan quoting shell, penolakan saat penambahan berbunyi This marketplace's name is another spelling of "<reserved>", a reserved marketplace name. It is not exactly the reserved name it appears to be.

Yang harus dilakukan:

• Ubah nama marketplace menjadi nama yang tidak mengeja nama yang dicadangkan dan tambahkan lagi
• Untuk peringatan entri yang diabaikan, jalankan perintah claude plugin marketplace remove yang diberikannya, atau hapus entri dari ~/.claude/plugins/known_marketplaces.json

Marketplace is already added from a different source

Anda mengonfirmasi penambahan marketplace melalui /plugin install <plugin> --marketplace <source>, dan katalog yang Claude Code ambil dari sumber itu menamai dirinya sama dengan marketplace yang sudah Anda tambahkan dari sumber berbeda. Claude Code menyimpan marketplace yang ada daripada menggantinya, dan plugin tidak terpasang.

Marketplace "acme-tools" is already added from a different source (github:acme/plugins). To use this source instead, remove that marketplace first with /plugin marketplace remove acme-tools.

Yang harus dilakukan:

• Jika marketplace yang sudah Anda tambahkan adalah yang Anda inginkan, pasang dari sana berdasarkan nama: /plugin install <plugin>@<name>
• Untuk beralih ke sumber baru, jalankan /plugin marketplace remove <name>, kemudian coba instalasi lagi

Plugin command references user\_config in a shell command

Hook plugin, monitor, atau perintah MCP headersHelper mereferensikan opsi ${user_config.KEY} plugin, 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 daripada mensubstitusi nilai. Pemeriksaan berjalan pada template perintah, jadi kesalahan muncul bahkan ketika tidak ada nilai yang dikonfigurasi. Sebelum v2.1.207, nilai disubstitusi ke dalam perintah shell.

Kata-katanya tergantung pada permukaan mana yang mereferensikan opsi. Hook bentuk shell melaporkan:

Hook 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}

Monitor melaporkan:

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

MCP headersHelper melaporkan:

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

Yang harus dilakukan:

• Untuk hook, tambahkan array args sehingga berjalan dalam exec 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
• Untuk monitor, lepaskan referensi dan buat skrip monitor membaca nilai dari file konfigurasi
• Untuk headersHelper, pindahkan ${user_config.KEY} ke bidang headers server, yang tidak diurai shell, atau baca nilai di dalam skrip helper

Plugin archive integrity check failed

Entri marketplace plugin menggunakan sumber archive dengan pin sha256, dan digest file yang diunduh tidak cocok dengan pin. Claude Code menolak instalasi, jadi tidak ada yang berubah dalam cache plugin. Ketidakcocokan memiliki tiga kemungkinan penyebab:

• File di URL berubah setelah penulis menghitung pin
• Penulis memasukkan digest yang salah di entri marketplace
• URL melayani file yang berbeda dari yang penulis pin

Plugin archive integrity check failed for https://artifacts.example.com/claude-plugins/my-plugin.zip: expected sha256 6bfa50e3d2e00c052b46abe51fff89346ac803e45771f76dcf6df1ab74cca5e1, got ac52220c0914ef8ca6a602e4a7362f88d30fb021110f72a6d15b68c3fe7df2b7. The archive was not installed. Verify the sha256 in the marketplace entry, or that the URL serves the intended file.

Yang harus dilakukan:

• Jika Anda menerbitkan plugin, hitung ulang digest file yang tepat yang dilayani URL, misalnya dengan shasum -a 256 my-plugin.zip, atau Get-FileHash -Algorithm SHA256 my-plugin.zip di PowerShell, dan perbarui sha256 di entri marketplace
• Jika Anda memasang plugin, jalankan /plugin marketplace update <name> untuk menyegarkan katalog jika entri telah diperbaiki, kemudian coba instalasi lagi
• Jika digest masih tidak setuju setelah penyegaran, tanyakan kepada pemilik marketplace file mana yang mereka pin sebelum memasang

Path escapes plugin directory

Jalur komponen plugin, yang dideklarasikan dalam plugin.json plugin atau dalam entri marketplace, diselesaikan di luar direktori plugin itu sendiri. Claude Code menghapus jalur itu dan memuat sisa plugin. Nama komponen dalam pesan, seperti commands atau hooks, menamai bidang yang mendeklarasikan jalur.

commands path escapes plugin directory: ./../shared.md

Dalam output perintah claude plugin, kesalahan yang sama berbunyi Path escapes plugin directory: ./../shared.md (commands).

Claude Code menolak baik jalur yang menunjuk di luar plugin seperti yang ditulis, seperti ../shared-utils, dan symlink yang mengarah di luar plugin dan bukan salah satu yang aturan symlink marketplace izinkan. Untuk symlink, pesan juga mengatakan di mana jalur diselesaikan:

commands path escapes plugin directory: ./commands/deploy.md — it resolves to /home/user/shared/deploy.md, outside the plugin directory

Di macOS dan Linux, Claude Code juga menolak jalur komponen yang berisi backslash di mana pun di dalamnya, bahkan ketika jalur tetap berada di dalam plugin. Plugin yang jalur komponen menggunakan pemisah gaya Windows memuat di Windows dan memicu penolakan ini di platform lain:

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

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

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

Yang harus dilakukan:

• Pindahkan file yang direferensikan ke dalam direktori plugin dan arahkan jalur ke sana dengan jalur relatif ./
• Jika jalur adalah symlink ke file di luar plugin, ganti symlink dengan salinan file
• Jika pesan mengatakan jalur berisi backslash, tulis jalur dengan garis miring maju, misalnya ./commands/deploy.md
• Untuk berbagi file dengan plugin lain di marketplace yang sama, tautkan dengan symlink di dalam direktori plugin, mengikuti aturan symlink

Path could not be checked

Claude Code menanyakan sistem operasi apakah jalur plugin ada dan mendapat kesalahan selain "tidak ditemukan", jadi tidak memuat apa yang dinamai jalur. Berapa banyak plugin yang memuat tergantung pada jalur mana yang gagal:

• Salah satu dari lokasi komponen default plugin, seperti folder skills/, file monitors/monitors.json, atau SKILL.md di root plugin: komponen lain plugin masih memuat
• Direktori plugin itu sendiri: tidak ada yang memuat dari plugin itu

Anda tidak melihat kesalahan ini untuk jalur yang tidak ada sama sekali. Di /plugin, kesalahan muncul di bawah plugin dan menamai jalur dan kode yang dikembalikan sistem operasi:

skills path could not be checked: /home/user/my-plugin/skills (ELOOP)

Di claude plugin list, kesalahan yang sama berbunyi Path not found: /home/user/my-plugin/skills (skills, ELOOP).

Penyebab yang menghasilkan kesalahan ini termasuk:

• ELOOP: symlink dalam jalur menunjuk pada dirinya sendiri atau membentuk loop
• EIO atau ESTALE: jalur berada di mount jaringan yang rusak atau basi
• EACCES: salah satu direktori di atas jalur menolak Anda izin untuk melintasinya

Yang harus dilakukan:

• Ganti symlink yang menunjuk pada dirinya sendiri dengan folder nyata, atau hapus
• Jika jalur berada di mount jaringan, pasang kembali bagian
• Jika kodenya adalah EACCES, pulihkan izin eksekusi Anda di direktori di atas jalur
• Jalankan /reload-plugins setelah memperbaiki jalur, atau mulai ulang Claude Code, untuk memuat plugin atau komponen

Sebelum v2.1.265, Claude Code memperlakukan folder komponen default yang tidak dapat diperiksa sebagai tidak ada dan memuat plugin tanpa komponen itu, tanpa kesalahan.

Marketplace entry path does not stay inside the marketplace directory

Entri marketplace plugin mendeklarasikan jalur sumber yang Claude Code tidak dapat diselesaikan ke lokasi di dalam direktori marketplace itu sendiri, jadi plugin tidak memasang atau memuat. Penolakan mencakup:

• Jalur entri yang absolut, memanjat keluar dari marketplace dengan .., atau dieja seperti jalur jaringan
• Di macOS dan Linux, jalur entri yang berisi backslash di mana pun setelah ./ terkemuka
• Entri di marketplace yang diambil dari sumber jarak jauh, seperti git atau URL, yang mencapai targetnya melalui symlink yang diselesaikan di luar direktori marketplace
• Entri relatif di marketplace yang ditambahkan dari URL langsung ke marketplace.json: Claude Code hanya mengunduh file itu, jadi tidak ada file plugin lokal untuk jalur yang dinamai. Lihat Plugins with relative paths fail in URL-based marketplaces

claude plugin install melaporkan penolakan seperti ini:

Cannot install my-plugin@my-marketplace: its marketplace entry path does not stay inside the marketplace directory (an absolute, climbing, network-shaped, backslash-containing or link-traversing entry, an entry of a fetched marketplace that resolves or opens outside its tree — or a relative entry in a url-catalog marketplace, which has no local directory)

Ketika entri plugin yang sudah terpasang gagal pemeriksaan yang sama, claude plugin list menampilkan plugin sebagai failed to load dengan:

Plugin source path refused: ./my-plugin does not stay inside its marketplace directory. Check that the marketplace entry has a plain relative path.

Yang harus dilakukan:

• Jika Anda memelihara marketplace, tulis source entri sebagai jalur relatif biasa dengan garis miring maju, seperti ./plugins/my-plugin, dan jaga agar symlink apa pun yang dilintasinya menunjuk ke dalam direktori marketplace
• Jika Anda menambahkan marketplace dari URL langsung, entri relatif tidak dapat diselesaikan. Minta penulis marketplace untuk menggunakan sumber plugin lain, atau tambahkan marketplace dari repositori git-nya sebagai gantinya

Failed to load marketplace configuration

Claude Code menyimpan marketplace plugin yang telah Anda tambahkan dalam file registri di ~/.claude/plugins/known_marketplaces.json. Perintah plugin yang memerlukan registri, seperti claude plugin install, gagal dengan salah satu dari dua pesan ketika Claude Code tidak dapat menggunakan file:

• Failed to load marketplace configuration: file bukan JSON yang valid, atau tidak dapat dibaca. File kosong gagal dengan cara ini juga.
• Marketplace configuration file is corrupted: file adalah JSON yang valid tetapi isinya tidak cocok dengan skema registri.

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

Dengan file kosong, claude plugin install melaporkan:

✘ Failed to install plugin "my-plugin": Failed to load marketplace configuration: JSON Parse error: Unexpected EOF

Sebelum v2.1.246, claude plugin install tidak melaporkan kegagalan ini.

Yang harus dilakukan:

• Buka ~/.claude/plugins/known_marketplaces.json dan perbaiki JSON, atau perbaiki entri yang pesan namakan sebagai tidak cocok dengan skema registri
• Jika Anda tidak dapat memperbaikinya, hapus file atau ganti isinya dengan {}, kemudian tambahkan kembali setiap marketplace dengan claude plugin marketplace add <source>. Claude Code mendaftarkan kembali marketplace yang dideklarasikan pengaturan pengguna atau terkelola Anda dalam extraKnownMarketplaces lain kali Anda memulainya di folder yang telah Anda percayai.

Plugin is required by your organization

Anda menjalankan claude plugin disable, atau menggunakan tab Installed /plugin, untuk mematikan plugin yang disinkronkan dari claude.ai yang organisasi Anda tandai sebagai diperlukan:

Plugin "<name>@synced" is required by your organization and can't be disabled here. Contact your admin to change it.

Claude Code tidak menyimpan apa pun dan plugin tetap diaktifkan.

Ketika Anda mencoba menonaktifkan plugin yang diperlukan oleh plugin yang diperlukan, Claude Code menolak dengan cara yang sama, dengan pesan yang menamai plugin yang diperlukan yang membutuhkannya.

Yang harus dilakukan:

• Tanyakan admin organisasi claude.ai Anda untuk mengubah status yang diperlukan plugin di claude.ai

Kesalahan alat

Kesalahan ini berasal dari alat bawaan Claude. Claude memperbaiki sebagian besar kesalahan alat secara otomatis. Ketika salah satu memerlukan perubahan dari Anda, daftar What to do kesalahan tersebut mengatakan apa yang harus diubah.

Agent would be spawned with zero tools

Setiap entri dalam tools list subagent gagal cocok dengan alat yang dapat digunakan, jadi Claude Code menolak untuk meluncurkan subagent: tanpa alat, itu tidak bisa bertindak. Pesan mengelompokkan entri Anda berdasarkan apa yang salah:

• Unrecognized: entri tidak cocok dengan nama alat apa pun, biasanya kesalahan ketik seperti Grpe untuk Grep.
• Not available to subagents: entri menamai alat nyata yang subagent tidak bisa gunakan. Subagent latar belakang menyimpan set alat bawaan yang lebih kecil, jadi entri yang hanya dapat digunakan subagent foreground mendarat di sini ketika subagent akan berjalan di latar belakang, yang merupakan default. Jika Anda mencantumkan Agent, pesan melaporkannya di bawah grup berikutnya.
• Matched no tools in this session: entri valid tetapi tidak ada alat dalam sesi saat ini yang cocok sekarang, seperti mcp__github__* tanpa server MCP GitHub yang terhubung, atau Agent untuk subagent pada batas kedalaman.

Menghilangkan bidang tools tidak pernah memicu penolakan ini. Jika Anda membiarkan daftar tools kosong, atau disallowedTools menghapus setiap entri di dalamnya, Claude Code juga melewati penolakan dan meluncurkan subagent tanpa alat.

Sebelum v2.1.208, subagent diluncurkan tanpa alat dan dapat mengembalikan hasil yang kosong atau membingungkan.

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

What to do:

• Perbaiki setiap entri yang dinamai kesalahan terhadap alat yang tersedia untuk subagent
• Hapus entri untuk alat yang tidak dimiliki sesi, seperti alat MCP dari server yang tidak terhubung
• Untuk alat yang subagent latar belakang lepaskan, seperti CronCreate, hapus entri. Untuk menyimpan alat, matikan mode fork dan minta Claude menjalankan subagent di foreground
• Hapus bidang tools alih-alih mencantumkan alat untuk memberikan subagent setiap alat yang tersedia untuk subagent
• Untuk daftar tools yang hanya berisi Agent, naikkan batas kedalaman atau berikan agen setidaknya satu alat lain: Claude Code menahan Agent pada batas itu, jadi daftar tanpa yang lain di dalamnya diselesaikan ke tidak ada alat

File is covered by a Read deny rule

Alat Edit atau Write dipanggil pada jalur yang cocok dengan aturan penolakan Read, termasuk membuat file baru di jalur itu. Kedua alat mengubah konten yang harus dapat dibaca Claude, jadi Claude Code menolak panggilan sebelum akses file apa pun. NotebookEdit tidak tercakup oleh aturan penolakan Read. Sebelum v2.1.228, aturan memblokir alat Edit saja, dan sebelum v2.1.208, hanya aturan penolakan Edit yang memblokir edit.

File is covered by a Read deny rule in your permission settings and cannot be edited.

Ketika Claude Code menolak alat Write, pesan berakhir and cannot be written sebagai gantinya.

What to do:

• Jika Claude harus dapat mengubah file, hapus atau persempit aturan penolakan Read di /permissions atau di settings
• Jika file harus tetap tidak tersentuh, simpan aturan dan tambahkan aturan penolakan Edit untuk jalur yang sama untuk memblokir alat NotebookEdit juga

subagent\_type is required

subagent_type is required: the general-purpose agent is not available in this session. Available agents: ...

Claude memanggil Agent tool tanpa subagent_type, dan sesi ini tidak memiliki subagent tujuan umum untuk kembali. Itu adalah kasus dalam dua pengaturan:

• CLAUDE_AGENT_SDK_DISABLE_BUILTIN_AGENTS=1 diatur dalam mode non-interaktif, yang menghapus setiap subagent bawaan
• Agen thread utama sesi memiliki tools: Agent(...) allowlist yang meninggalkan general-purpose

What to do:

• Biasanya tidak ada: pesan mencantumkan subagent yang dimiliki sesi, jadi Claude dapat mencoba lagi dengan salah satunya
• Jika Claude terus gagal, tambahkan general-purpose ke allowlist tools: Agent(...), atau batalkan CLAUDE_AGENT_SDK_DISABLE_BUILTIN_AGENTS

Sebelum v2.1.235, panggilan yang sama gagal dengan Agent type 'general-purpose' not found.

Memory index is over its read limit

Claude menulis ke indeks memori otomatis MEMORY.md dan meninggalkannya di atas salah satu batas bacanya: 200 baris atau 25KB. Penulisan berhasil, tetapi hanya 200 baris pertama atau 25KB, mana pun yang lebih dulu, dimuat di awal sesi, jadi semuanya melampaui batas dijatuhkan setiap kali indeks dibaca. Sebelum v2.1.210, indeks yang melampaui batas secara diam-diam dipotong pada beban berikutnya tanpa sinyal waktu penulisan.

Error: this write left the memory index at MEMORY.md at 214 lines, over its 200-line read limit. The write succeeded, but everything past the limit is silently dropped each time the index is loaded — entries at the end are already invisible to readers. Rewrite it to under 140 lines now: keep one line per entry, move detail into topic files, and merge or drop stale entries.

Hanya konten yang dimuat yang dihitung terhadap batas. Frontmatter YAML dan komentar HTML tingkat blok dilepas sebelum indeks dimuat, jadi mereka dikecualikan dari pengukuran. Sebelum v2.1.211, Claude Code mengukur file mentah, dan frontmatter atau komentar dapat memicu kesalahan ini bahkan ketika konten yang dimuat cocok.

Claude Code memberikan kesalahan kepada Claude setelah penulisan daripada mencetaknya sebagai spanduk di terminal Anda, jadi Anda mungkin hanya memperhatikannya dalam transkrip.

Ketika penulisan Claude membawa file dekat dengan batas tanpa melewatinya, Claude Code mengembalikan pengingat yang lebih ringan untuk mengompak indeks alih-alih kesalahan ini.

What to do:

• Biarkan Claude menulis ulang MEMORY.md, atau minta: simpan satu baris per entri, pindahkan detail ke file topik, dan gabungkan atau lepaskan entri basi
• Untuk memangkas indeks sendiri, lihat Audit and edit your memory

pkill pattern matches the Claude Code process

Perintah pkill dalam panggilan alat Bash menggunakan pola, biasanya dengan -f, yang cocok dengan proses Claude Code itu sendiri, jadi Claude Code menolak perintah alih-alih membiarkannya mengakhiri sesi. Claude Code menguji pola dengan pgrep sebelum menjalankan pkill dan menolak ketika ID proses miliknya ada dalam hasil. Pemeriksaan berjalan di Linux saja; di macOS, pkill berjalan tanpa modifikasi. Sebelum v2.1.214, perintah berjalan, dan pola yang cocok membunuh sesi Claude Code di tengah-putaran.

pkill: refusing to run — this pattern matches the Claude CLI process (PID 12345). Narrow the pattern, or target your own children with `pkill -P $$ ...`.

Penolakan muncul dalam hasil alat Bash daripada sebagai spanduk di terminal Anda, dan Claude biasanya menyesuaikan perintah dengan sendirinya.

What to do:

• Persempit pola sehingga hanya cocok dengan proses yang dimaksudkan, misalnya jalur lengkap biner target daripada substring pendek
• Untuk menghentikan proses yang dimulai oleh shell saat ini, gunakan pkill -P $$ dengan pola, yang membatasi kecocokan ke proses anak shell itu sendiri

Failed to write to a teammate's inbox

Claude Code tidak dapat menulis pesan ke file kotak surat rekan kerja di bawah ~/.claude/teams/{team-name}/inboxes/, jadi penerima tidak menerima apa pun. Penulisan gagal ketika Claude Code tidak dapat membuat atau memperbarui file, misalnya karena disk penuh, direktori tidak dapat ditulis, atau agen lain menahan kunci kotak surat terlalu lama. Sebelum v2.1.224, Claude Code melaporkan pesan sebagai terkirim bahkan ketika penulisan gagal.

Kesalahan muncul dalam hasil alat agen pengirim daripada sebagai spanduk di terminal Anda, dan teksnya memberitahu Claude untuk mencoba lagi:

Failed to write to researcher's inbox — nothing was sent. Try again, or message the lead.

Pesan protokol tim agen terstruktur gagal dengan cara yang sama, dan kesalahan menamai pesan yang tidak terkirim: ketika Claude Code tidak dapat menulis persetujuan rencana, penolakan rencana, permintaan shutdown, atau penolakan shutdown, kesalahan berbunyi Failed to write the <message> to <name>'s inbox — nothing was sent. plan approval dalam daftar itu adalah keputusan pemimpin yang menyetujui rencana rekan kerja; pengajuan rencana rekan kerja adalah pesan plan approval request yang terpisah. Pesan itu dan dua pesan protokol lainnya membawa teks pesan mereka sendiri dan konsekuensi:

• Failed to write the plan approval request to the lead's inbox — plan not submitted; try again: rencana rekan kerja tidak pernah mencapai pemimpin, dan rekan kerja tetap dalam mode rencana sampai pengajuan ulang berhasil
• The permission request could not be delivered to the team lead (mailbox write failed): permintaan izin rekan kerja tidak pernah mencapai pemimpin, jadi tidak ada yang menyetujui panggilan alat
• The confirmation could not be written to team-lead's inbox.: persetujuan shutdown itu sendiri berlaku dan rekan kerja keluar; hanya konfirmasi kepada pemimpin yang hilang

Ketika Anda mengirim pesan ke rekan kerja sendiri, mengetik @name diikuti oleh pesan dalam sesi pemimpin, kegagalan yang sama muncul sebagai notifikasi, Couldn't write to @name's inbox — message not sent. Try again., dan Claude Code menyimpan teks Anda di kotak prompt sehingga Anda dapat mengirimnya lagi.

What to do:

• Minta pengirim untuk mengirim ulang pesan; pertentangan untuk kunci kotak surat bersifat sementara dan jelas saat mencoba lagi
• Periksa ruang disk gratis, dan periksa bahwa ~/.claude/teams dan file di bawahnya dapat ditulis oleh pengguna Anda

Teammate's agent definition was not restored

Claude mengirim pesan ke rekan kerja tim agen yang dihentikan, dan Claude Code membawanya kembali tanpa menerapkan kembali definisi subagent yang dihasilkannya, karena file definisinya berasal dari folder tanpa kepercayaan yang disimpan. Pemberitahuan mengikuti laporan resume dalam hasil alat agen pengirim:

Its agent definition was not restored: the folder its definition file came from is not trusted (source: projectSettings), so the teammate is running with the team-essential tools and no custom instructions. To restore it, the user needs to run Claude Code in that folder once and accept the trust dialog (the --debug log names the folder); do not change trust settings on the user's behalf.

Pemeriksaan berlaku untuk definisi di direktori .claude/agents/ dari proyek atau direktori --add-dir, dan menerima dialog kepercayaan untuk folder induk tidak memuaskannya.

What to do:

• Jalankan claude di folder yang dinamai debug log dan terima dialog kepercayaan. Definisi diterapkan kembali saat Claude Code membawa rekan kerja kembali berikutnya; Anda tidak perlu memulai ulang sesi pemimpin
• Atau atur entri hasTrustDialogAccepted ke true di ~/.claude.json, menggunakan kunci projects["<path>"] yang tepat yang dicetak log debug

Message too large for cross-session delivery

Pesan lintas sesi Claude ke sesi lain Anda di mesin ini terlalu panjang untuk dikirim. Claude Code menolaknya, dan sesi penerima tidak mendapat apa pun. Penolakan muncul dalam hasil alat sesi pengirim, bukan sebagai spanduk di terminal Anda. Ini menamai kedua ukuran dan cara membuat pesan cocok:

Failed to send to api-worker: Message too large for cross-session delivery: the serialized message is 1,203,844 characters and the limit is 1,048,576. Shorten the message text — put bulk content in a file the recipient can read rather than in the message — or split it into smaller messages.

Mengirim ulang teks yang sama gagal dengan cara yang sama.

What to do:

• Minta Claude untuk merangkum pesan, atau untuk menempatkan konten massal dalam file dan mengirim jalur file
• Minta Claude untuk membagi konten di beberapa pesan yang lebih pendek

Sebelum v2.1.235, Claude Code melaporkan pesan yang terlalu besar sebagai terkirim. Sesi penerima menjatuhkannya tanpa dibaca.

Too many messages to this session just now

Claude mengirim ledakan cepat pesan lintas sesi ke salah satu sesi Anda di mesin ini, dan ledakan mencapai apa yang diterima kotak surat sesi itu. Claude Code menolak pengiriman berikutnya, dan sesi penerima tidak mendapat apa pun darinya. Penolakan muncul dalam hasil alat sesi pengirim, bukan sebagai spanduk di terminal Anda:

Failed to send to api-worker: Too many messages to this session just now: 30 were sent recently and more would be dropped by its rate limit, so this one was not sent. Batch what remains into one message, or wait a little before sending more.

What to do:

• Biasanya tidak ada: Claude mengelompokkan konten yang tersisa menjadi satu pesan, atau menunggu sebelum mengirim lebih banyak
• Jika Anda sendiri yang memicu ledakan, minta Claude untuk menggabungkan apa yang tersisa menjadi satu pesan

Sebelum v2.1.236, Claude Code melaporkan pengiriman ini sebagai terkirim. Sesi penerima menjatuhkannya tanpa dibaca.

Refusing to send a cross-session message

Sebelum Claude Code menulis pesan lintas sesi ke sesi lain Anda di mesin ini, itu memeriksa bahwa soket kotak surat sesi target adalah titik akhir yang ditujukan pesan. Ketika pemeriksaan gagal, Claude Code menolak pengiriman dalam sesi pengirim, dan sesi target tidak menerima apa pun. Untuk pesan yang dikirim Claude, penolakan muncul dalam hasil alat sesi pengirim:

Failed to send to api-worker: Refusing to send: reply target is a symlink

Teks setelah Refusing to send: menamai pemeriksaan yang gagal:

• reply target is a symlink: tautan simbolis duduk di jalur soket sesi target. Claude Code tidak mengirimkan melaluinya, karena tautan di sana dapat mengarahkan pesan ke titik akhir yang tidak dibuat sesi target.
• cannot vet reply target: Claude Code tidak dapat memeriksa jalur target sama sekali, misalnya karena membacanya gagal dengan kesalahan izin.
• connected endpoint is not the expected process: proses yang menahan soket bukan sesi yang ditujukan pesan, jadi alamat sudah usang atau proses lain mengganti soket.
• connected endpoint identity could not be read: Claude Code terhubung tetapi tidak dapat membaca proses mana yang menahan ujung lain, jadi tidak dapat mengkonfirmasi target. Ini bisa bersifat sementara.
• connected endpoint is not owned by this user: proses yang menahan soket berjalan sebagai akun pengguna yang berbeda, jadi bukan salah satu sesi Anda.
• connected endpoint owner could not be read: Claude Code terhubung tetapi tidak dapat membaca akun pengguna mana yang memiliki ujung lain, jadi tidak dapat mengkonfirmasi titik akhir adalah milik Anda.
• connected endpoint is a different process with the expected pid: ID proses cocok dengan yang ditujukan pesan, tetapi Claude Code tidak dapat mengkonfirmasi itu adalah proses yang sama. Biasanya sesi itu keluar dan sistem operasi menggunakan kembali ID prosesnya, jadi alamat sudah usang.

What to do:

• Biasanya tidak ada: pemeriksaan menjaga pesan agar tidak mencapai titik akhir selain sesi yang ditujukan, dan tidak ada yang dikirim
• Minta Claude untuk mencantumkan sesi Anda lagi dan mengirim ulang; penolakan yang disebabkan oleh alamat yang sudah usang jelas setelah Claude mengirim ke yang saat ini
• Jika reply target is a symlink berulang untuk satu sesi, periksa apa yang membuat tautan di jalur soket sesi itu, ditampilkan di /status di bawah Peer address
• Untuk connected endpoint identity could not be read, kirim ulang; kondisi dapat bersifat sementara
• Jika connected endpoint is not owned by this user muncul di mesin bersama, sesi di alamat itu berjalan di bawah akun pengguna lain, jadi Claude tidak dapat mengirim pesannya dari milik Anda

Sebelum v2.1.248, Claude Code tidak memeriksa pengguna pemilik titik akhir atau waktu mulai proses, jadi penolakan yang menamai pemeriksaan itu tidak muncul di versi sebelumnya.

Refusing to read, write, or search a path

Claude Code memeriksa aturan izin jalur file, kemudian mengkonfirmasi resolusi itu lagi ketika alat membuka file atau memulai pencarian. Ketika tidak dapat mengkonfirmasi bahwa jalur masih mengarah ke lokasi yang disetujui pemeriksaan, Claude Code menolak operasi alih-alih mengikutinya. Penolakan muncul dalam hasil alat:

Refusing to read /path/to/file: its symlink resolution changed after permission was checked (a link on the way now leads somewhere the check did not see). If a link in the working directory is being rewritten concurrently, stop that and retry.

Setiap penolakan menamai alasannya:

• its symlink resolution changed after permission was checked: tautan simbolis di sepanjang jalur, atau di akar pencarian Grep atau Glob, diganti antara pemeriksaan izin dan operasi. Dalam penolakan baca, frasa dalam tanda kurung menamai perbandingan mana yang gagal.
• its parent-directory symlink resolution changed after permission was checked: direktori yang dilalui jalur penulisan tidak lagi diselesaikan ke lokasi yang disetujui
• it is a symbolic link. Write to the link's target path instead: tautan simbolis duduk di lokasi penulisan yang disetujui itu sendiri, misalnya CLAUDE.md yang merupakan tautan simbolis ke AGENTS.md; pesan mengarahkan Claude ke target tautan
• Refusing to write through symlink: <path>. Resolve the symlink and pass the real target path explicitly.: kondisi yang sama ditangkap ketika penulis lain membuka file, seperti penulisan ke .mcp.json yang ditautkan
• Refusing to write into symlinked directory: <path>: direktori yang menyimpan file itu sendiri adalah tautan simbolis, misalnya direktori .claude/ proyek yang ditautkan ke lokasi lain
• a path one of its Read deny rules is written through changed while the search was being prepared. Retry.: aturan penolakan Read untuk pencarian menamai jalur yang melewati tautan simbolis, dan tautan itu berubah saat Claude Code menyiapkan pencarian
• it could not be opened (EACCES) — it is unreadable, or is being replaced concurrently.: akar pencarian ada tetapi tidak dapat dibuka; kode dalam tanda kurung adalah kesalahan sistem operasi
• its permission check expired before it ran (too many concurrent file operations). Retry.: Claude Code mengeluarkan catatan persetujuan di bawah banyak operasi file simultan sebelum alat menggunakannya; mencoba lagi menjalankan pemeriksaan izin segar
• ripgrep was found only by name on PATH, and a search outside the working directory cannot apply your Read deny rules in that configuration: Claude Code tidak dapat menyelesaikan biner rg ke jalur absolut, jadi menolak pencarian di luar direktori kerja daripada menjalankan pencarian yang tidak dicakup aturan penolakan Anda

What to do:

• Biasanya tidak ada: penolakan mencapai Claude sebagai hasil alat, dan operasi yang ditolak tidak berjalan
• Jika penolakan tautan simbolis berulang pada satu jalur, temukan apa yang terus menulis ulang tautan di sana, seperti alat build atau file watcher, atau minta Claude menggunakan jalur yang diselesaikan file alih-alih yang ditautkan
• Jika penolakan ini muncul untuk setiap file saat Claude Code berjalan di Windows di dalam AppContainer atau sandbox token terbatas, tingkatkan ke v2.1.265 atau lebih baru
• Jika penolakan baca muncul di macOS untuk file yang tidak ada yang menulis ulang, seperti tangkapan layar yang diseret ke prompt, tingkatkan ke v2.1.273 atau lebih baru
• Untuk penolakan ripgrep, instal ripgrep dengan manajer paket Anda sehingga rg diselesaikan ke jalur absolut di PATH, atau simpan pencarian di bawah direktori kerja

Sebelum v2.1.251, Claude Code memeriksa kembali resolusi jalur hanya untuk penulisan file, jadi tautan yang diganti setelah pemeriksaan izin dapat mengarahkan baca atau pencarian ke lokasi berbeda tanpa pesan. Dari ini, hanya penolakan penulisan direktori induk, melalui-tautan, dan direktori-tertaut muncul di versi sebelumnya.

Task output swap refused

Claude Code menyimpan output setiap perintah Bash ke file di bawah direktori tempnya. Setiap kali membuka salah satu file ini, itu memeriksa bahwa jalur masih mengarah ke file yang dibuat, tanpa tautan simbolis, tautan keras ekstra, atau direktori yang dipindahkan mengarahkannya. Pesan ini berarti pemeriksaan itu gagal, jadi Claude Code menolak operasi daripada menulis atau membaca output melalui jalur itu. Pesan muncul dalam hasil alat Bash:

task output swap refused (tasks dir moved or linked): /private/tmp/claude-501/-Users-you-my-project/1f0e62dc-4b0a-4f5e-9c2d-8a7b6c5d4e3f/tasks/b7k2f9m3q.output. To recover: restart Claude Code with CLAUDE_CODE_TMPDIR set to a fresh directory; or, if /private/tmp/claude-501/-Users-you-my-project is a stray directory or a symbolic link that should not be there, remove that entry itself (not what it points to) and restart.

Teks dalam tanda kurung menamai pemeriksaan yang gagal. Alasan seperti output symlink was re-pointed, output file identity changed, dan not a regular file semuanya melaporkan kondisi yang sama: sesuatu di atau sepanjang jalur output tidak lagi file yang dibuat Claude Code. Hanya beberapa alasan yang membawa kalimat To recover:.

Jika pemeriksaan gagal saat perintah masih berjalan, Claude Code menghentikan perintah, dan hasilnya melaporkan:

Command killed: its output file was replaced or could no longer be verified

What to do:

• Tingkatkan ke v2.1.260 atau lebih baru. Versi sebelumnya kadang-kadang menunjukkan pesan ini ketika tidak ada tautan atau direktori yang dipindahkan
• Mulai ulang Claude Code dengan CLAUDE_CODE_TMPDIR diatur ke direktori segar
• Atau periksa direktori proyek Anda di bawah direktori temp Claude Code, /private/tmp/claude-501/-Users-you-my-project dalam pesan contoh. Jika jalur itu adalah tautan simbolis, atau direktori yang tidak seharusnya ada, hapus tautan atau direktori itu sendiri daripada target tautan, dan mulai ulang Claude Code
• Jika penolakan berulang, proses mengganti, menautkan, atau menghapus entri di bawah direktori temp Claude Code saat sesi berjalan. Atur CLAUDE_CODE_TMPDIR ke direktori yang tidak dikelola apa pun dan mulai ulang

The source file is not valid UTF-8 text

Claude mencoba menerbitkan artefak dari file yang byte-nya tidak didekodekan sebagai teks, atau yang teksnya sudah berisi karakter pengganti U+FFFD, jadi Claude Code menolak publikasi sebelum mengunggah apa pun. Pesan muncul dalam hasil alat Artefak dan menamai posisi pertama untuk diperbaiki:

file_path: the source file is not valid UTF-8 text (first invalid byte at line 12, column 40). It may be saved in another encoding or contain binary data. Rewrite it as UTF-8, then publish again. Nothing was published.

file_path: the source file has the replacement character U+FFFD at line 12, column 40, usually left where an earlier edit or paste lost a character. Replace it with the intended text (in HTML, write an intended U+FFFD as �), then publish again. Nothing was published.

Claude Code mendekodekan file sebagai UTF-8, atau sebagai UTF-16 ketika dimulai dengan tanda urutan byte UTF-16 little-endian. Ketika file UTF-16 seperti itu tidak didekodekan, pesan pertama menamai UTF-16 dan masih memberitahu Anda untuk menulis ulang file sebagai UTF-8. Ketika lebih banyak posisi mengikuti yang dinamai, pesan menambahkan hitungan seperti (+2 more) setelah posisi.

What to do:

• Biasanya tidak ada: Claude menulis ulang file dan menerbitkan lagi
• Jika file adalah yang Anda tulis atau ekspor, simpan lagi sebagai UTF-8, dan ganti setiap U+FFFD dengan karakter yang hilang oleh edit, paste, atau konversi sebelumnya
• Untuk menampilkan U+FFFD yang disengaja di halaman, tuliskan sebagai � dalam HTML alih-alih karakter literal

Sebelum v2.1.267, Claude Code mengunggah file seperti itu tanpa memeriksanya, dan server menolak publikasi sebagai gantinya.

Reading a local file from outside the connected folders in a Cowork session

Dalam sesi Cowork yang berjalan di mesin Anda di aplikasi Claude Desktop, Claude menamai file lokal untuk artefak. Claude Code tidak dapat mengkonfirmasi file adalah file biasa di dalam folder yang terhubung sesi: jalur duduk di luar folder itu, melewati tautan simbolis, atau dieja dengan cara yang dapat menamai file berbeda dari yang terlihat. Membaca file seperti itu memerlukan persetujuan Anda, dan dalam sesi yang tidak dapat menampilkan kartu persetujuan, seperti yang ditetapkan untuk melewati semua persetujuan, Claude Code menolak pembacaan.

Penolakan muncul dalam hasil alat Artefak; ketika file tidak dapat diperiksa sama sekali, itu menamai kegagalan itu sebagai gantinya:

Reading a local file from outside this session's connected folders, or through a link, needs the approval card, and no one can answer it in this Cowork session. Use a plain file inside the connected folders; do not retry this file in this session.

cannot read file_path (ENOENT) — the file could not be examined, and no one can answer the approval card in this Cowork session. Check that the file exists as a plain file inside the connected folders, then retry with that path.

What to do:

• Biasanya tidak ada: pesan memberitahu Claude untuk menggunakan file biasa di dalam folder yang terhubung sebagai gantinya
• Untuk menempatkan file yang tepat itu dalam artefak, salin ke salah satu folder yang terhubung sesi sebagai file biasa, bukan tautan simbolis, dan tanyakan lagi

WebFetch cannot fetch localhost

Claude memanggil WebFetch dengan URL yang nama hostnya tidak memiliki titik, seperti http://localhost:3000 atau nama intranet telanjang seperti http://wiki/. WebFetch menolak URL ini sebelum membuat permintaan apa pun:

WebFetch cannot fetch localhost or other hostnames without a dot. To reach a local server, use Bash with curl instead.

What to do:

• Biasanya tidak ada: pesan menunjukkan Claude ke curl melalui alat Bash, yang dapat menjangkau server lokal dan intranet

Sebelum v2.1.268, WebFetch melaporkan URL ini dengan kesalahan Invalid URL generik.

Kesalahan sesi latar belakang

Sesi latar belakang 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 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.

Perintah ditolak dalam sesi latar belakang

Perintah 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, dan sesi muncul di bawah Needs input dalam tampilan agen sehingga Anda dapat menemukannya, melampirkan, dan menjalankan perintah lagi. Saat terminal terhubung, perintah-perintah ini berfungsi secara normal.

Sebelum v2.1.216, sesi tidak muncul di bawah Needs input setelah salah satu penolakan ini. 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.

Kata-kata tersebut menamai perintah. Daftar pengaturan /mcp melaporkan:

Can't open MCP settings while no terminal is attached to this background session. This session now shows "needs input" in agent view — open it and run /mcp to manage servers, or use `/mcp enable|disable|reconnect <server>` to steer without the panel.

Yang harus dilakukan:

• Lampirkan ke sesi dari tampilan agen, di mana sesi terdaftar di bawah Needs input, dan jalankan perintah lagi
• Atau gunakan formulir yang dinamai pesan, seperti /mcp reconnect <server>, /mcp enable, atau /mcp disable, yang berfungsi tanpa melampirkan

Penulisan atau perintah diblokir karena jalur tidak dapat diselesaikan dengan aman

Claude mengatasi file atau direktori kerja melalui ejaan yang penjaga isolasi worktree tidak dapat menyelesaikan ke satu lokasi yang dapat diverifikasi. Penjaga memeriksa penulisan dan direktori kerja perintah di sesi apa pun yang terisolasi dalam worktree, interaktif atau latar belakang, dan di subagent yang terisolasi worktree. Ini menyelesaikan symlink sebelum memeriksa bahwa operasi tidak mencapai checkout bersama, dan ketika resolusi gagal, ia memblokir operasi daripada membiarkannya mendarat di sana. Pesan menamai bentuk jalur yang ditolaknya dan cara mencoba lagi:

This write was blocked because the path is spelled in a form that cannot be safely resolved (for example through a symlink storing a raw dot segment, a network-share or device-namespace shape, or an unreadable ancestor directory). If the file is inside the worktree /path/to/worktree, address it by its direct symlink-free path instead.

Perintah yang diblokir melaporkan penyebab yang sama untuk direktori kerjanya dan berakhir dengan re-run the command from its direct symlink-free path. Sebelum v2.1.217, penjaga membandingkan ejaan jalur tanpa menyelesaikan symlink, jadi ejaan ini tidak diblokir dan penulisan yang dirutekan melalui symlink dapat mendarat di checkout bersama.

Yang harus dilakukan:

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

Penulisan atau perintah diblokir karena jalur menamai lokasi jaringan

Claude mengatasi file atau direktori kerja melalui jalur yang menamai drive yang bukan di mesin Anda, bagian UNC seperti \\server\share\file atau jalur automount /net, sementara checkout sesi berada di disk lokal. Penjaga isolasi worktree yang sama tidak dapat memverifikasi bahwa jalur seperti itu tetap keluar dari checkout bersama, jadi ia memblokir operasi. Mengisolasi sesi dalam worktree tidak menghilangkan blokir. Pesan menamai bentuk jalur yang digunakan sebagai gantinya:

This write was blocked because the path is network-shaped (a UNC share or /net automount spelling) while this session's checkout is local. Isolating cannot unblock it. If the file is genuinely inside the worktree /path/to/worktree, address it by its local, plainly-spelled path instead.

Perintah yang diblokir melaporkan penyebab yang sama untuk direktori kerjanya dan berakhir dengan re-run the command from its local, plainly-spelled path. Sebelum v2.1.217, penjaga hanya membandingkan teks jalur, jadi mengatasi file di dalam checkout melalui jalur UNC atau /net tidak diblokir.

Yang harus dilakukan:

• Biasanya tidak ada: Claude mencoba lagi dengan ejaan lokal yang diminta pesan
• Jika file berada di bagian jaringan daripada file lokal yang dieja dengan jalur jaringan, file tersebut berada di luar ruang kerja lokal sesi Anda; editnya dari sesi interaktif biasa sebagai gantinya

Perintah diblokir oleh pemeriksaan isolasi worktree

Claude menjalankan perintah Bash atau Monitor dalam sesi yang terisolasi dalam worktree, dan Claude Code menolaknya karena salah satu dari dua alasan:

• Perintah menunjukkan git ke checkout utama.
• Claude Code tidak dapat memverifikasi dari teks perintah bahwa git apa pun yang dijalankan perintah tetap berada di dalam worktree. Perintah yang tidak pernah menamai git masih dapat ditolak karena alasan ini, karena memperluas indirection variabel seperti ${!name} atau menjalankan substitusi fungsi Bash seperti ${ command; } menghasilkan nilai pada runtime yang dapat menjadi perintah itu sendiri.

Bagian tengah pesan menamai apa yang tidak dapat diverifikasi:

This session is isolated in the worktree /path/to/worktree, but this command evaluates ${!x@P} arithmetically inside a construct too complex to verify, which can run a command hidden in a variable's value. Refusing to run it — a worktree-isolated session's git operations must target its own worktree. Split it into plain, separate commands and run them from /path/to/worktree.

Yang harus dilakukan:

• Biasanya tidak ada: Claude membaca pesan dan menulis ulang perintah dengan cara yang diminta kalimat terakhirnya
• Jika perintah yang Anda minta terus ditolak, ejakan nilai yang ditandai secara harfiah: ganti indirection atau substitusi dengan nilainya, dan jalankan git sebagai perintah biasa terpisahnya dari dalam worktree
• Untuk bertindak pada checkout utama dengan sengaja, jalankan perintah sendiri di terminal di luar sesi

Sesi ini tidak memiliki transkrip yang disimpan

Anda melampirkan ke sesi latar belakang yang dihentikan yang dilatarbelakangkan dari percakapan lain dengan ← atau /background dan dihentikan sebelum respons pertamanya selesai. Sampai respons pertama itu selesai, percakapan masih hidup hanya dalam sesi tempat ia dilatarbelakangkan, jadi claude attach menolak untuk memulai sesi yang dihentikan daripada memulai percakapan kosong di bawah ID sesi yang sama. Pesan berakhir dengan perintah claude respawn untuk sesi ini:

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

Membuka baris sesi yang sama dalam tampilan agen 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.

Yang harus dilakukan:

• Percakapan yang Anda latarbelakangkan masih utuh: lanjutkan dengan claude --resume atau terus bekerja di dalamnya
• Untuk memulai sesi yang dihentikan segar bagaimanapun, jalankan claude respawn <id> dengan ID dari pesan, atau tekan Enter dua kali pada barisnya dalam tampilan agen
• 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

Sesi ini berjalan di terminal lain

Anda membuka baris sesi yang dihentikan dalam tampilan agen, 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:

Can't open — this session is running in another terminal
This conversation is already open in another running Claude session — use that one, or close it and try again

• running in another terminal: terminal memegang percakapan, misalnya yang tempat Anda melanjutkannya dengan claude --resume atau /resume. Baris juga menampilkan Open in a terminal.
• already open in another running Claude session: proses Claude Code non-interaktif lain menahannya, misalnya proses sesi latar belakang untuk percakapan yang sama yang belum keluar.

Claude Code menyimpan balasan yang Anda ketik saat membuka baris dan mengirimkannya sebagai prompt berikutnya sesi ketika sesi berikutnya dimulai.

Yang harus dilakukan:

• Lanjutkan percakapan dalam proses yang memilikinya, atau keluar dari proses itu dan buka baris lagi

Sebelum v2.1.248, hanya penolakan already open in another running Claude session yang ada: percakapan yang dilanjutkan dalam terminal tidak dihitung sebagai terbuka, dan membuka baris memulai proses Claude Code kedua yang menulis ke percakapan yang sama.

Percakapan yang disimpan sesi ini tidak lagi ada di disk

Anda membuka sesi latar belakang yang berakhir saat layanan latar belakang mati, dan pembersihan transkrip telah menghapus percakapan yang disimpannya, misalnya setelah mesin mati selama berminggu-minggu. Membuka baris seperti itu biasanya melanjutkan percakapan yang disimpannya. Tanpa apa pun yang tersisa untuk dilanjutkan, Claude Code menolak daripada menjalankan kembali prompt asli sesi tanpa bertanya:

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

claude attach <id> mencetak teks ini. Dalam tampilan agen, footer lebih pendek dan berakhir dengan ctrl+x deletes the row.

Yang harus dilakukan:

• Jalankan claude rm <id> untuk menghapus baris. Ketika salah satu dari kasus yang disimpan berlaku, claude rm menyimpan baris dan worktree sebagai gantinya dan menamai alasannya
• Untuk menjalankan prompt asli sesi lagi sebagai percakapan segar, jalankan claude respawn <id>

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

Worktree memiliki komitmen yang tidak didorong ke mana pun

Anda mencoba menghapus sesi latar belakang 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:

kept 7c5dcf5d — its worktree is still at "/home/you/project/.claude/worktrees/fix-login"
  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.
  push them and run 'claude rm 7c5dcf5d' again, or discard the worktree and its commits: claude rm 7c5dcf5d --discard-unpushed a1b2c3d000000000000000000000000000000000@0123456789abcdef0123456789abcdef

Ketika Claude Code tidak dapat merangkum komitmen, baris detail berbunyi The worktree has unpushed commits sebagai gantinya. Dalam tampilan agen, baris sesi menampilkan not deleted dengan alasan yang sama.

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

Yang harus dilakukan:

• Untuk menyimpan komitmen, dorong cabang worktree, atau gabungkan ke dalam cabang default yang diperiksa dalam checkout utama Anda, kemudian hapus sesi lagi
• 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 diperbarui
• Ketika pesan mengatakan worktree juga dicatat oleh sesi selesai lain, menghapus lagi tidak membuangnya: dorong komitmen, kemudian hapus sesi lagi

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

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

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

Proses host terminal mati

Setiap terminal sesi latar belakang berjalan dalam proses host di bawah layanan latar belakang, dan proses itu mati saat layanan masih menyimpan koneksinya, jadi sesi tidak dapat dijangkau.

Di 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:

terminal host process died — press Enter to restart

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

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

Couldn't attach to <id> — This session's terminal host process died (the conversation is saved) — run `claude attach <id>` again to restart it on a fresh host.

Percakapan disimpan bagaimanapun.

Baris yang menjalankan perintah shell sebagai gantinya menampilkan terminal host process died — its output is gone; the command was not run again, dan claude attach mencetak This command's terminal host process died — its output is gone and the command was not run again. Claude Code tidak pernah menjalankan kembali perintah untuk Anda.

Yang harus dilakukan:

• Dalam tampilan agen, tekan Enter pada baris yang gagal; sesi dimulai ulang pada proses host segar dan percakapan dilanjutkan
• 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
• Anda tidak dapat memulai ulang baris perintah shell dengan cara ini; kirim perintah lagi untuk menjalankannya kembali

Sebelum v2.1.247, proses host yang mati dapat melewati setiap pemeriksaan kelangsungan hidup yang dijalankan layanan latar belakang, jadi membuka sesi menampilkan opening… · esc to cancel tanpa batas dan claude attach <id> menunggu tanpa melaporkan kesalahan.

Sesi tidak merespons

Anda membuka sesi latar belakang 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.

Dalam tampilan agen, Claude Code menawarkan restart dalam footer:

Press enter again to restart this session — it isn't responding (its conversation is saved and resumes).

Dari shell, claude attach <id> mencetak penyebab dan keluar:

Couldn't attach to <id> — Session isn't responding — `claude stop <id>`, then `claude attach <id>` restarts it (the conversation is saved).

Claude Code tidak pernah memulai ulang baris yang menjalankan perintah shell untuk Anda, karena restart akan menjalankan perintah lagi.

Yang harus dilakukan:

• 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 itu
• Dari shell, jalankan claude stop <id>, kemudian claude attach <id>
• Untuk baris perintah shell, tekan Ctrl+X dalam tampilan agen atau jalankan claude stop <id> untuk menghentikannya; kirim perintah lagi untuk menjalankannya kembali

Sesi dihentikan saat respawn sedang dalam perjalanan

Anda membuka sesi latar belakang yang prosesnya tidak berjalan, dan saat Claude Code memulainya kembali, proses Claude Code lain menghentikannya, misalnya claude stop di terminal lain. Claude Code menyimpan sesi tetap dihentikan:

Session <id> was stopped while the respawn was in flight

Membuka sesi yang baru saja Anda kirim, saat prosesnya masih dimulai, menunggu proses sebagai gantinya. Sebelum v2.1.246, membukanya pada saat itu dapat menghentikannya dan menampilkan pesan ini.

Yang harus dilakukan:

• Jika Anda tidak menghentikan sesi, buka barisnya lagi dalam tampilan agen atau jalankan claude respawn <id> untuk memulainya kembali
• Jika Anda menghentikannya sendiri, tidak ada yang tersisa untuk dilakukan: sesi tetap dihentikan

Agen sesi tidak lagi tersedia

Anda melanjutkan sesi yang menjalankan agen khusus, 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, kemudian direktori tempat Anda melanjutkan. Sesi masih dilanjutkan, tetapi dengan alat default, jadi pembatasan alat agen tidak lagi berlaku:

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

Peringatan hanya menamai direktori yang Claude Code cari, dan muncul dalam percakapan yang dilanjutkan apakah Anda membangunkan sesi latar belakang, menjalankan /resume atau claude --resume, atau melanjutkan dalam mode non-interaktif, di mana ia juga masuk ke stderr. Sesi menggunakan --input-format stream-json tidak menampilkannya, karena Agent SDK menyediakan agen setelah startup.

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

Yang harus dilakukan:

• Buat ulang file agen di .claude/agents/<name>.md dalam proyek sesi, atau di ~/.claude/agents/<name>.md untuk agen pribadi, kemudian lanjutkan lagi
• Atau lanjutkan dengan --agent <name> yang menamai agen yang memang ada, untuk menjalankan sesi sebagai agen itu sebagai gantinya
• Jika agen bersifat proyek dan Anda belum mempercayai direktori asli sesi, jalankan Claude Code di sana sekali, terima dialog kepercayaan, kemudian lanjutkan lagi

Kesalahan peluncur CLAUDE\_CODE\_PROCESS\_WRAPPER

CLAUDE_CODE_PROCESS_WRAPPER 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:

CLAUDE_CODE_PROCESS_WRAPPER: launcher `/opt/corp/launcher` is not an executable regular file

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

Yang harus dilakukan:

• Atur variabel ke jalur absolut dari executable yang berakhir dengan memanggil exec "$@". Lihat kontrak peluncur untuk kontrak lengkap
• Periksa /status, yang menampilkan 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
• Setelah memperbaiki nilai dalam blok env dari pengaturan, mulai ulang layanan latar belakang dengan claude daemon stop --any sehingga pengiriman berikutnya memulai yang dibungkus

EUNKNOWN saat memulai sesi latar belakang

Windows menolak untuk memulai program dengan kode kesalahan yang tidak memiliki nama standar, jadi kegagalan muncul sebagai EUNKNOWN. Pemicu biasanya adalah kebijakan pembatasan perangkat lunak, seperti Group Policy atau AppLocker, memblokir program yang dimulai. Kesalahan muncul ketika Anda memulai sesi latar belakang dengan /background atau claude --bg:

Couldn't reach the background service (spawn background service: EUNKNOWN: unknown error, uv_spawn) — run 'claude daemon status'

Pada beberapa akun pesan mengatakan daemon sebagai pengganti background service.

Pada instalasi npm, EUNKNOWN yang muncul saat npm install -g @anthropic-ai/claude-code mengganti biner memiliki penyebab yang sama dengan EACCES selama reinstal dan hilang ketika Anda mencoba lagi setelah instalasi selesai.

Claude Code memulai layanan latar belakang melalui PowerShell sehingga layanan bertahan menutup terminal, menggunakan PowerShell 7 ketika diinstal dan Windows PowerShell 5.1 sebaliknya. Ketika tidak ada PowerShell yang dapat berjalan, Claude Code memulai layanan secara langsung sebagai gantinya, jadi kebijakan yang memblokir hanya PowerShell tidak menyebabkan kesalahan ini. Jika Anda melihatnya saat tidak ada instalasi npm yang berjalan, kebijakan memblokir executable Claude Code itu sendiri.

Sebelum v2.1.212, Claude Code hanya menggunakan Windows PowerShell 5.1 untuk memulai layanan, jadi mesin apa pun di mana Group Policy memblokir PowerShell 5.1 gagal dengan Couldn't start the session — EUNKNOWN: unknown error, uv_spawn, bahkan dengan PowerShell 7 diinstal.

Yang harus dilakukan:

• Jika pesan berbunyi Couldn't start the session, tingkatkan ke v2.1.212 atau lebih baru. Pada versi sebelumnya Anda juga dapat menjalankan claude daemon run di terminal terpisah terlebih dahulu, kemudian mulai sesi latar belakang lagi. Perintah itu menjalankan layanan latar belakang di latar depan terminal, jadi layanan berlangsung hanya selama terminal itu tetap terbuka.
• Jika instalasi npm mengganti biner, tunggu hingga selesai, kemudian mulai sesi latar belakang lagi
• Jika kesalahan muncul pada v2.1.212 atau lebih baru saat tidak ada instalasi npm yang berjalan, minta administrator Windows Anda untuk mengizinkan executable Claude Code dalam kebijakan pembatasan
• Jika layanan latar belakang berhenti ketika Anda menutup terminal, Claude Code memulainya tanpa PowerShell. Instal PowerShell 7, atau minta administrator Anda untuk membuka blokir PowerShell, sehingga layanan dapat bertahan lebih lama dari terminal.

EACCES saat memulai sesi latar belakang

Claude Code tidak dapat menjalankan binernya sendiri untuk memulai layanan latar belakang 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 melakukannya. Kesalahan muncul ketika Anda membuka sesi dari tampilan agen:

Couldn't start the background service — spawn background service: EACCES: permission denied, posix_spawn '/usr/local/lib/node_modules/@anthropic-ai/claude-code/bin/claude'

Ketika Anda memulai sesi dengan /background atau claude --bg, alasan yang sama muncul di dalam Couldn't reach the background service (...). Selama jendela reinstal yang sama kesalahan dapat menamai kode lain sebagai gantinya, seperti ENOENT atau ENOEXEC, atau EUNKNOWN atau EPERM di Windows; EUNKNOWN yang bertahan di seluruh percobaan ulang memiliki penyebab berbeda.

Pada instalasi npm, Claude Code menunggu reinstal selesai dan mencoba lagi sendiri: hingga sepuluh detik, dan hingga dua menit saat instalasi npm Claude Code masih terlihat berjalan di mesin, yang mencakup proses Claude Code lain mengunduh pembaruan. Ketika instalasi melampaui waktu tunggu itu, kegagalan menamai pembaruan alih-alih kode kesalahan telanjang:

Claude Code is being updated by npm on this machine (still not runnable after 2 min, EACCES) — try again when the update finishes

Sebelum v2.1.257, waktu tunggu berhenti pada sepuluh detik dalam setiap kasus, jadi kesalahan ini muncul saat proses Claude Code lain masih mengunduh pembaruan. Sebelum v2.1.246, Claude Code gagal sekaligus, tanpa menunggu.

Yang harus dilakukan:

• Tunggu beberapa detik, kemudian buka sesi atau kirim lagi. Ketika pesan mengatakan Claude Code sedang diperbarui, coba lagi setelah pembaruan selesai.
• 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.

Layanan latar belakang keluar sebelum dapat dijangkau

Proses yang Claude Code mulai sebagai layanan latar belakang 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:

Couldn'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'

Ketika Anda membuka sesi dari tampilan agen, 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.

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

Dua alasan yang dikutip memiliki penyebab yang diketahui:

• 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. Sebelum v2.1.257, pembaruan diri npm macOS menghasilkan kegagalan ini pada setiap awal selama jendela instalasi.
• 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.

Yang harus dilakukan:

• Jika pesan mengutip baris, perbaiki apa yang dinamainya, kemudian buka sesi atau kirim lagi. Upaya berikutnya memulai layanan lagi
• Jalankan claude daemon status untuk memeriksa apakah layanan berjalan sekarang

Direktori kerja tidak lagi ada saat memulai sesi latar belakang

Anda mencoba memulai sesi latar belakang dalam direktori yang tidak lagi ada. Ini terjadi ketika Anda mengirim dari tampilan agen atau menjalankan /background setelah direktori tempat Anda bekerja dihapus atau dipindahkan. Ini juga terjadi ketika Anda melampirkan ke atau memulai ulang sesi yang prosesnya telah keluar dan direktorinya hilang, karena proses baru akan dimulai di direktori yang sama. Claude Code tidak memulai sesi, dan pesan menamai direktori yang hilang:

Couldn't start a background session (working directory no longer exists or is not accessible: /tmp/demo)

Sebelum v2.1.257, sesi tampak dimulai dan kemudian ditampilkan dalam tampilan agen sebagai baris yang gagal dengan alasan yang sama.

Yang harus dilakukan:

• Buat ulang direktori yang dinamai pesan, atau kirim dari direktori yang ada, kemudian coba lagi

Kesalahan Wrapper dan IDE

Kesalahan ini berasal dari program yang meluncurkan Claude Code untuk Anda, seperti ekstensi IDE atau aplikasi Agent SDK, bukan dari Claude Code itu sendiri.

Proses Claude Code keluar dengan kode N

Proses claude yang mendasar keluar dengan kode bukan nol. Kode keluar saja tidak mengatakan apa yang gagal: kesalahan sebenarnya ada di output proses itu sendiri, yang wrapper tambahkan ketika menangkap apa pun dan sebaliknya menyimpannya di log-nya.

Error: Claude Code process exited with code 1

Di Windows, build native dapat keluar dengan kode 4294967295 tepat setelah giliran selesai. Ketika keluar itu mendarat di batas giliran, tanpa pesan menunggu dan tidak ada tugas latar belakang yang berjalan, ekstensi VS Code menutup sesi dengan tenang alih-alih menampilkan kesalahan ini. Pesan Anda berikutnya melanjutkan percakapan.

Sebelum v2.1.273, ekstensi menampilkan kesalahan untuk keluar itu di setiap batas giliran, meskipun tidak ada yang hilang.

Yang harus dilakukan:

• Di VS Code, ikuti tautan View output logs yang ditampilkan dengan kesalahan untuk melihat kegagalan yang mendasar
• Dalam aplikasi Agent SDK, tangkap kesalahan di sekitar loop pesan Anda. Entri di bawah CLI process exit mencakup apa yang diterima kode Anda di setiap bahasa SDK.
• Jalankan claude di terminal dalam proyek yang sama. Kegagalan biasanya direproduksi di sana dengan pesan kesalahan sebenarnya, yang kemudian dapat Anda cari di halaman ini.
• Jalankan claude doctor di terminal untuk memeriksa instalasi dan konfigurasi

Tidak dapat menemukan Claude CLI di PATH

Ekstensi VS Code menampilkan kesalahan ini di Windows ketika Anda membuka Claude Code di terminal terintegrasi, shell terminal adalah PowerShell, dan ekstensi tidak dapat menemukan executable claude yang terinstal di PATH. Ekstensi menolak untuk meluncurkan Claude Code sampai menemukan claude yang terinstal di PATH.

Failed to run Claude Code: Error: Could not locate the Claude CLI on PATH. Launching by name in a PowerShell terminal would run a 'claude' from the open folder instead of the installed CLI, so the launch was blocked. Make sure the Claude CLI's install directory is on your system PATH (not only your PowerShell profile), then restart VS Code and try again. VS Code reads PATH when it starts, so PATH changes take effect only after a restart.

Yang harus dilakukan:

• Buka jendela PowerShell baru di luar VS Code dan jalankan where.exe claude. Jika tidak mencetak jalur, CLI tidak ada di PATH Anda: tambahkan direktori instalasinya dengan mengikuti Verify your PATH. Jika mencetak jalur, entri berasal dari profil PowerShell Anda atau dari perubahan PATH yang belum diambil VS Code; dua langkah berikutnya mencakup kasus-kasus tersebut.
• Atur entri PATH sebagai variabel lingkungan pengguna atau sistem, bukan di profil PowerShell Anda. Ekstensi tidak menjalankan profil Anda, jadi edit PATH yang hanya ada di sana tidak pernah mencapainya.
• Mulai ulang VS Code setelah mengubah PATH. Ekstensi memeriksa PATH yang ditangkap VS Code saat startup, jadi perubahan PATH hanya berlaku setelah restart.

Koneksi ke Claude Code berakhir sebelum pesan ini selesai

Ekstensi VS Code mengirim pesan Anda ke proses claude, dan koneksi berakhir tanpa kesalahan sebelum proses mengakui atau menyelesaikannya. Ekstensi tidak dapat mengatakan apakah pesan diproses, jadi meminta Anda untuk mengirimnya lagi:

The connection to Claude Code ended before this message completed — it may not have been processed, so please send it again.

Yang harus dilakukan:

• Kirim pesan lagi. Pesan berikutnya memulai proses claude segar yang melanjutkan percakapan.
• Jika terulang, jalankan claude di terminal dalam proyek yang sama. Kegagalan yang terus mengakhiri proses biasanya direproduksi di sana dengan pesan kesalahan sebenarnya.

Peringatan dan kesalahan Rewind

Pesan-pesan ini berasal dari pemulihan kode /rewind. Restored the code, but skipped N files adalah peringatan yang menunjukkan bahwa Claude Code melewati beberapa jalur. No files were restored adalah kesalahan yang berarti tidak ada yang dipulihkan.

Restored the code, but skipped files

Pemulihan kode /rewind melewati satu atau lebih jalur terlacak alih-alih menulis atau menghapus melaluinya. Claude Code melewati jalur ketika:

• itu adalah, atau menjadi, symlink, hard link, atau file non-reguler lainnya
• direktorinya berubah sejak checkpoint
• backup-nya tidak dapat dibaca dengan aman

Jalur yang dilewati mempertahankan konten saat ini mereka. Sebelum v2.1.216, /rewind menulis dan menghapus melalui link di jalur terlacak, dan tidak melaporkan pemulihan sebagian.

Restored the code, but skipped 2 files: the tracked path is (or became) a link or other non-regular file, its directory changed since the checkpoint, or its backup could not be safely read. Skipped files were left untouched — run with --debug for the paths.

Yang harus dilakukan:

• Identifikasi file mana yang dilewati sehingga Anda dapat menangani masing-masing dengan langkah-langkah di bawah ini. Pesan hanya memberikan hitungan; log debug di ~/.claude/debug/<session-id>.txt menamai setiap jalur yang dilewati saat pemulihan berjalan, jadi aktifkan logging debug dengan /debug sebelum pemulihan berikutnya Anda. Di macOS atau Linux, Anda dapat menemukan link secara langsung: find . -type l untuk symlink dan find . -type f -links +1 untuk file hard-linked.
• Jika file yang dilewati adalah link yang Anda buat dengan sengaja, seperti file konfigurasi yang dikelola oleh manajer dotfile atau file yang hard-linked oleh alat seperti pnpm, rewind membiarkan kontennya saja. Untuk membatalkan perubahan sesi terhadapnya, minta Claude untuk membalikkan edit atau edit file sendiri
• Jika Anda tidak membuat link, periksa jalur sebelum mempercayai kontennya: sesuatu mengganti file setelah checkpoint

No files were restored

Claude Code menampilkan pesan ini ketika Anda memulihkan kode dengan /rewind dan tidak dapat memulihkan file apa pun dalam checkpoint tersebut. Untuk setiap file, baik backup yang disimpan Claude Code sebelum mengeditnya hilang, atau Claude Code tidak dapat menulis atau menghapus file.

Failed to restore the code:
No files were restored: 1 file failed (backup missing, or the file could not be updated)

Claude Code menghapus backup sesi dalam retention sweep, secara default sekitar 30 hari setelah sesi terakhir menyimpannya. Jika Anda melanjutkan sesi setelah itu, /rewind masih mencantumkan checkpoint-nya, tetapi rewind ke salah satunya dapat gagal dengan kesalahan ini. Jika pesan juga mengatakan N paths were skipped for link safety, lihat Restored the code, but skipped files untuk jalur-jalur tersebut.

Ketika Anda fork sesi, misalnya dengan --fork-session atau /branch, Claude Code menyalin backup sesi asli ke fork. Ketika Claude Code tidak dapat menyalin backup, misalnya karena disk penuh, backup tersebut hilang di fork. Rewind ke checkpoint yang membutuhkannya dapat gagal dengan kesalahan ini.

Yang harus dilakukan:

• Batalkan perubahan dengan cara lain: minta Claude untuk membalikkan edit-nya, atau pulihkan file dari version control. Ketika backup hilang, menjalankan /rewind lagi gagal dengan cara yang sama.
• Jika Claude Code tidak dapat menulis atau menghapus file, perbaiki apa yang memblokir penulisan, seperti izin file, kemudian jalankan /rewind lagi.
• Untuk menyimpan backup lebih lama di sesi mendatang, naikkan cleanupPeriodDays.

Sebelum v2.1.260, Claude Code secara diam-diam melewati file yang backup-nya hilang, dan rewind tampak berhasil.

Peringatan penyimpanan sesi

Claude Code menampilkan peringatan ini pada baris persisten di bawah kotak input ketika tidak menyimpan transkrip sesi Anda. Sesi tetap berfungsi baik cara; peringatan memberi tahu Anda bahwa sesi mungkin hilang dari --resume nanti.

Penulisan transkrip gagal

Claude Code menyimpan transkrip ke disk saat Anda bekerja, dan penulisannya ke file transkrip gagal. Pesan ini menyebutkan penyebabnya dengan kode kesalahan yang mendasar, misalnya disk penuh:

Transcript writes are failing (disk full — ENOSPC) · recent messages may not be saved for resume

Peringatan muncul pada titik berbeda tergantung pada kesalahannya:

• Pada kegagalan pertama untuk kondisi yang tidak hilang dengan sendirinya: disk penuh, kuota disk terlampaui, sistem file hanya-baca, jalur melebihi batas panjang sistem file, atau, di macOS dan Linux, kesalahan izin
• Setelah kegagalan berulang yang berlangsung setidaknya satu menit untuk semuanya, termasuk kesalahan izin di Windows, di mana pemindaian antivirus dapat gagal pada satu penulisan yang kemudian berhasil saat dicoba ulang

Sebelum v2.1.217, Claude Code menghapus penulisan yang gagal tanpa peringatan, dan --resume yang hilang pesan terbaru kemudian adalah tanda pertama.

Yang harus dilakukan:

• Perbaiki kondisi yang disebutkan kode kesalahan: bebaskan ruang disk untuk ENOSPC; naikkan atau hapus kuota untuk EDQUOT; pulihkan akses tulis ke lokasi transkrip untuk EACCES, EPERM, atau EROFS
• Peringatan hilang dengan sendirinya pada penulisan berikutnya yang berhasil; tidak perlu restart
• Pesan yang dikirim saat peringatan ditampilkan mungkin masih hilang ketika Anda melanjutkan sesi nanti

Penyimpanan transkrip dimatikan karena CLAUDE\_CODE\_SKIP\_PROMPT\_HISTORY diatur

Sesi ini dimulai dengan CLAUDE_CODE_SKIP_PROMPT_HISTORY diatur, jadi Claude Code tidak menulis transkrip atau riwayat prompt untuk sesi ini:

Transcript saving is off — CLAUDE_CODE_SKIP_PROMPT_HISTORY is set · --resume will not find this session; if unintended, unset it and restart

Variabel ini adalah opt-out yang disengaja untuk sesi skrip sementara, tetapi juga dapat mencapai sesi melalui profil shell, skrip pembungkus, atau proses induk yang mengekspornya.

Yang harus dilakukan:

• Jika Anda mengatur variabel dengan sengaja, tidak ada tindakan yang diperlukan; pemberitahuan ini mengonfirmasi bahwa sesi tidak akan muncul di --resume, --continue, atau riwayat panah-atas
• Jika tidak, hapus variabel dari shell atau skrip yang meluncurkan claude, kemudian mulai sesi baru. Pesan dari sesi saat ini tidak disimpan secara retroaktif.

Penyimpanan transkrip dimatikan karena penanda CLAUDE\_CODE\_CHILD\_SESSION yang diwariskan

Claude Code mengatur CLAUDE_CODE_CHILD_SESSION dalam subproses yang dihasilkannya, dan memperlakukan sesi interaktif yang mewarisinya sebagai bersarang: Claude Code tidak menyimpan transkrip untuk sesi tersebut, jadi sesi yang Claude sendiri mulai tidak mengisi daftar --resume Anda. Pemberitahuan ini berarti sesi saat ini Anda mewarisi penanda:

Transcript saving is off — inherited CLAUDE_CODE_CHILD_SESSION marker · restart with CLAUDE_CODE_FORCE_SESSION_PERSISTENCE=1 to keep future transcripts

Pemberitahuan ini diharapkan ketika Anda menjalankan claude dari dalam sesi Claude Code lain; pemberitahuan ini menandakan salah klasifikasi ketika penanda bocor melalui perantara yang tahan lama, misalnya terminal, sesi screen, atau peluncur yang awalnya dimulai oleh sesi Claude Code.

Di dalam tmux, Claude Code mendeteksi penanda yang tiba melalui lingkungan global server tmux dan terus menyimpan, jadi pemberitahuan ini tidak muncul untuk kasus itu.

Yang harus dilakukan:

• Jika Anda memulai sesi ini dari dalam sesi Claude Code lain dengan sengaja, tidak ada tindakan yang diperlukan
• Jika ini adalah sesi tingkat atas, keluar dan restart dengan CLAUDE_CODE_FORCE_SESSION_PERSISTENCE=1 diatur. Penyimpanan berlaku dari restart, jadi pesan yang dikirim sebelumnya tidak disimpan.
• Untuk memperbaiki peluncuran di masa depan dari terminal atau peluncur yang sama, hapus CLAUDE_CODE_CHILD_SESSION dari lingkungannya

Peringatan Konfigurasi

Claude Code menulis sebagian besar pesan ini ke stderr, bukan ke dalam percakapan, dan menulis sebagian besar di saat startup. Sebuah entri mengatakan demikian ketika pesannya muncul di tempat lain, seperti dalam log debug atau sebagai pemberitahuan startup dalam tampilan percakapan, atau pada waktu lain, seperti baris diagnostik model yang tidak dikenali pada saat permintaan.

Fullscreen renderer tidak selesai memulai

Sesi fullscreen sebelumnya di mesin ini keluar sebelum selesai memulai, jadi Claude Code memulai sesi ini pada renderer klasik dan mencetak salah satu pemberitahuan ini:

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

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

Yang harus dilakukan:

• Ikuti Fullscreen rendering. Ini mengatakan pemberitahuan mana yang Anda dapatkan, apa yang Claude Code lakukan di sesi-sesi berikutnya, dan cara mencoba fullscreen lagi atau tetap menggunakan renderer klasik.
• Jika sesi yang mati mencetak pesan keluar, lihat Claude Code keluar setelah kesalahan antarmuka yang tidak dapat dipulihkan untuk mengetahui apa yang dinamainya.

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

Claude Code keluar setelah kesalahan antarmuka yang tidak dapat dipulihkan

Claude Code mencetak pesan ini ketika keluar karena antarmuka terminalnya mengalami kesalahan yang tidak dapat dipulihkan, di salah satu renderer. Kalimat kedua muncul hanya ketika kesalahan terjadi saat renderer fullscreen sedang memulai:

Claude Code exited after an unrecoverable interface error (<error>). It happened while the fullscreen renderer was starting, so the next launch will use the classic renderer (CLAUDE_CODE_DISABLE_ALTERNATE_SCREEN=1 forces that any time).

Yang harus dilakukan:

• Mulai Claude Code lagi. Untuk melanjutkan percakapan, jalankan claude --resume di direktori yang sama.
• Jika pesan menyebutkan renderer fullscreen, Fullscreen rendering mengatakan apa yang dilakukan peluncuran berikutnya, yang tergantung pada cara Anda mengaktifkan fullscreen, dan cara mencoba fullscreen lagi atau tetap menggunakan renderer klasik.

Sebelum v2.1.236, Claude Code keluar tanpa mencetak pesan setelah kesalahan jenis ini.

Deskripsi agent melebihi batas token 15.0k

Claude Code menampilkan peringatan ini sebagai pemberitahuan startup dalam tampilan percakapan daripada di stderr. Deskripsi gabungan dari subagents Anda, kecuali yang bawaan, melebihi 15.000 token seperti yang diperkirakan Claude Code. Setiap agent menghitung namanya ditambah frontmatter description nya. Claude Code memuat setiap agent terlepas dari apakah totalnya melebihi batas, jadi peringatan tidak mengubah apa yang dimuat.

Agent descriptions are over the 15.0k-token limit (~16.2k tokens) · ask Claude to trim agent descriptions in .claude/agents/

Yang harus dilakukan:

• Perpendek frontmatter description dari file agent Anda, atau minta Claude untuk memangkasnya untuk Anda.
• Hapus file agent yang tidak lagi Anda gunakan.

Workspace belum dipercaya

Claude Code menemukan aturan permissions.allow atau entri permissions.additionalDirectories dalam .claude/settings.json atau .claude/settings.local.json proyek dan tidak menerapkannya, karena aturan allow dari pengaturan proyek memerlukan kepercayaan workspace. Jumlah, nama pengaturan, dan file yang dinamai dalam pesan bervariasi dengan konfigurasi Anda. Aturan deny dan ask tidak terpengaruh.

Ignoring 2 permissions.allow entries from .claude/settings.local.json: this workspace has not been trusted. Run Claude Code interactively here once and accept the trust dialog, or set projects["/Users/you/project"].hasTrustDialogAccepted: true in /Users/you/.claude.json.

Yang harus dilakukan:

• Jalankan claude di direktori dan terima dialog kepercayaan. Project allow rules and workspace trust mengatakan folder mana yang dicakup oleh penerimaan tersebut.
• Dalam mode non-interaktif dengan -p tidak ada dialog yang ditampilkan. Atur entri hasTrustDialogAccepted dalam ~/.claude.json menggunakan kunci projects yang tepat yang dicetak pesan.
• 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. 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 lainnya dikecualikan dan tidak menunggu dialog. Lihat Project allow rules and workspace trust.

Direktori kerja adalah jalur jaringan

Claude Code tidak menambahkan jalur jaringan sebagai direktori kerja. Mencari jalur jaringan dapat menghubungi host yang dinamainya, dan di Windows kontak itu dapat mengirim kredensial Anda ke host, jadi Claude Code menolak jalur tanpa mencarinya. Anda melihat pesan ini ketika Anda menjalankan /add-dir dengan jalur seperti itu, atau sebagai peringatan pada startup. Ketika muncul pada startup, Claude Code memulai tanpa direktori itu.

\\server\share is a network path, which cannot be added as a working directory. On Windows, map the share to a drive letter and pass it at launch with --add-dir (a drive letter added mid-session does not yet carry remote-read trust).

Jalur yang Claude Code tolak dengan cara ini termasuk:

• Berbagi UNC seperti \\server\share
• Jalur automount seperti /net/<host>, kecuali Anda meluncurkan Claude Code dari direktori di bawah automount host itu
• Jalur lokal yang mencapai lokasi jaringan melalui symbolic link atau junction

Huruf drive yang dipetakan dan jalur \\wsl$ tidak dihitung sebagai jalur jaringan.

Yang harus dilakukan:

• Di Windows, petakan berbagi ke huruf drive, misalnya dengan net use Z: \\server\share, dan teruskan drive pada peluncuran dengan claude --add-dir Z:\.
• Di macOS atau Linux, pasang berbagi di jalur lokal dan tambahkan jalur itu sebagai gantinya.
• Jika jalur ada di permissions.additionalDirectories, hapus dari file pengaturan yang mencantumnya.

Sebelum v2.1.257, Claude Code menerima jalur jaringan yang dapat dijangkau sebagai direktori kerja.

Pengaturan yang dikelola jarak jauh gagal dimuat

Sesi Anda memenuhi syarat untuk server-managed settings, tetapi Claude Code tidak dapat mengambilnya, jadi menampilkan peringatan ini dalam sesi interaktif. Penyebab dalam tanda kurung menyebutkan apa yang gagal, seperti network error, request timed out, atau authentication rejected (401), dan sisa baris mengatakan kebijakan mana yang dijalankan sesi:

• Pengaturan di-cache dari pengambilan sebelumnya yang berhasil: Claude Code menjalankan sesi pada kebijakan yang di-cache itu, kecuali variabel lingkungan yang ditahan, dan baris berbunyi using cached policy.
• Tidak ada cache: Claude Code menjalankan sesi tanpa server-managed settings, dan baris berbunyi no remote policy applied.

Yang harus dilakukan:

• Bertindak atas penyebab yang dinamai pesan: untuk penyebab jaringan, periksa bahwa mesin ini dapat menjangkau api.anthropic.com; untuk penyebab autentikasi, periksa sign-in Anda dengan /status
• Jalankan /status atau claude doctor untuk diagnostik lengkap

Sebelum v2.1.248, Claude Code melaporkan pengambilan pengaturan yang gagal hanya dalam log debug.

Pengaturan yang dikelola tidak disetujui

Server-managed settings organisasi Anda mencakup pengaturan yang memerlukan persetujuan Anda, dan Anda menolak dialog persetujuan keamanan, jadi Claude Code keluar tanpa menerapkannya:

Managed settings were not approved; exiting without applying them.

Yang harus dilakukan:

• Mulai Claude Code lagi dan setujui dialog untuk melanjutkan di bawah pengaturan organisasi Anda. Dialog yang ditolak tidak diingat, jadi muncul lagi pada startup berikutnya.
• Jika Anda tidak yakin tentang pengaturan yang dialog cantumkan, tanyakan kepada siapa pun yang memelihara pengaturan yang dikelola organisasi Anda sebelum menyetujui

Server MCP diblokir oleh kebijakan yang dikelola perusahaan

Anda memilih Reconnect pada server di /mcp, atau mengaktifkan kembali server yang dinonaktifkan di sana, dan pengaturan yang membatasi server MCP memblokir server itu. Claude Code menolak untuk menghubungkannya dan menampilkan:

MCP server <name> is blocked by enterprise managed policy

Salah satu dari pengaturan ini dapat menghasilkan pesan:

• Entri deniedMcpServers yang cocok dengan server, termasuk yang ada di ~/.claude/settings.json Anda sendiri atau .claude/settings.json proyek
• Daftar allowedMcpServers yang tidak cocok dengan server
• strictPluginOnlyCustomization dengan mcp terkunci, yang memblokir server yang dikonfigurasi dalam ~/.claude.json dan .mcp.json
• disableClaudeAiConnectors, ketika server adalah konektor claude.ai

Yang harus dilakukan:

• Periksa file pengaturan pengguna dan proyek Anda sendiri untuk salah satu pengaturan ini dan ubah atau hapus
• Jika tidak ada pengaturan Anda sendiri yang menjelaskan blokir, tanyakan administrator Anda pengaturan yang dikelola mana yang memblokir server

Sebelum v2.1.257, Reconnect dan re-enable di /mcp dapat menghubungkan server yang pembaruan kebijakan mid-session memblokir.

Dokumen pengaturan yang dikelola tidak dapat diuraikan

Organisasi Anda menerapkan managed settings, dan salah satu dokumen yang diterapkan ada tetapi tidak dapat diuraikan sebagai objek JSON, jadi Claude Code keluar dengan kode 1 pada startup daripada berjalan tanpa kebijakan yang dibawa dokumen. Baris menyebutkan sumber yang gagal sebelum pesan:

/Library/Application Support/ClaudeCode/managed-settings.json: Managed settings document could not be parsed as a JSON object; none of its settings are in effect. Fix or remove it.

Sumbernya adalah salah satu dari:

• Jalur file managed-settings.json atau file drop-in di bawah managed-settings.d
• Profil preferensi yang dikelola macOS, per-user managed preferences atau device-level managed preferences
• Nilai registry Windows, Registry: HKLM\SOFTWARE\Policies\ClaudeCode\Settings

Find entries Claude Code dropped mencantumkan apa yang membuat setiap sumber tidak dapat diuraikan.

Claude Code menolak untuk memulai bahkan ketika sumber admin lain memberikan kebijakan yang valid. Anda melihat kesalahan ini dalam sesi interaktif, claude -p, sesi Agent SDK, background sessions, dan sebagian besar subperintah, claude doctor termasuk. Penolakan gagal tertutup dengan sengaja: pengaturan dalam dokumen yang tidak dapat diuraikan Claude Code tidak dapat ditegakkan, dan memulai bagaimanapun akan menjalankan sesi tanpa kontrol organisasi Anda.

Masalah skema dalam dokumen yang dapat diuraikan tidak menghasilkan kesalahan ini. Find entries Claude Code dropped mencakup apa yang Claude Code lakukan dengan satu.

Ketika direktori managed-settings.d/ ada tetapi tidak dapat didaftar, Claude Code melaporkan Managed settings drop-in directory could not be read: diikuti oleh kesalahan yang mendasar sebagai gantinya. Find entries Claude Code dropped mencakup kapan kegagalan baca keluar pada startup.

Yang harus dilakukan:

• Jika Anda mengelola mesin, perbaiki dokumen yang dinamai sehingga diuraikan sebagai objek JSON, atau hapus file, profil, atau nilai registry. managed-settings.json kosong dihitung sebagai {} dan tidak memblokir peluncuran.
• Jika tidak, minta administrator Anda untuk memperbaiki dokumen yang diterapkan. Tidak ada dalam file pengaturan Anda sendiri yang menyebabkan atau menghapus kesalahan ini.

otelHeadersHelper gagal

Claude Code menampilkan peringatan ini sebagai notifikasi dalam antarmuka terminal, sekali per sesi interaktif, ketika skrip otelHeadersHelper gagal atau mencetak output yang tidak memenuhi persyaratan skrip.

Sementara skrip terus gagal, ekspor gagal dan backend telemetri Anda tidak menerima apa pun dari sesi.

Teks setelah See /status: mengatakan apa yang gagal, seperti kode keluar skrip diikuti oleh output kesalahannya:

otelHeadersHelper failed; telemetry is not being exported. See /status: exited 1: token service unreachable

Yang harus dilakukan:

• Jalankan /status untuk membaca detail kegagalan.
• Perbaiki skrip sehingga keluar 0 dalam 30 detik dan mencetak objek JSON dari nilai header string di stdout. Lihat script requirements.
• Jika organisasi Anda menerapkan skrip melalui managed settings, minta siapa pun yang memeliharanya untuk memperbaikinya.

Dalam mode non-interaktif dengan -p, kegagalan yang sama muncul di stderr sebagai otelHeadersHelper failed (OpenTelemetry export headers unavailable): <error> sebagai gantinya.

headersHelper tidak dijalankan

Claude Code menghubungkan server MCP dengan headers statis saja dan melewati headersHelper server, karena helper adalah perintah shell dan folder tidak memiliki kepercayaan yang disimpan. Folder mendapatkan kepercayaan yang disimpan ketika Anda mengatur entrinya di ~/.claude.json dengan tangan atau, di luar direktori home Anda, ketika Anda menerima dialog kepercayaan untuk itu dalam sesi interaktif. Lihat Trust a folder before its headersHelper runs untuk server mana pemeriksaan ini berlaku.

Claude Code menulis baris ini dalam mode non-interaktif saja, sekali per server. Dalam sesi interaktif, itu menulis penolakan yang sama ke log debug sebagai gantinya.

MCP server 'internal-api': headersHelper not run — this workspace has no persisted trust; accept the trust dialog here once interactively, or set projects["/Users/you/project"].hasTrustDialogAccepted in /Users/you/.claude.json.

Kunci projects yang dicetak pesan adalah folder yang Project allow rules and workspace trust katakan Claude Code kunci kepercayaan. Menerima dialog kepercayaan untuk folder induk tidak memenuhi pemeriksaan, dan sesi -p atau SDK tidak memenuhinya juga.

Yang harus dilakukan:

• Jalankan claude di folder yang dinamai pesan, terima dialog kepercayaan, kemudian jalankan perintah -p atau SDK Anda lagi
• Atur entri hasTrustDialogAccepted dalam ~/.claude.json sendiri, menggunakan kunci projects yang tepat yang dicetak pesan
• Jika Anda memulai sesi di direktori home Anda, bekerja dari direktori proyek yang telah Anda percayai. Ketika Anda menerima dialog kepercayaan di direktori home Anda, Claude Code menyimpan kepercayaan itu untuk sesi saat ini saja.

Aturan Tool(content) yang salah format

Aturan izin dalam salah satu file pengaturan Anda tidak memiliki bentuk Tool atau Tool(content), misalnya karena teks mengikuti tanda kurung penutup atau salah satu tanda kurung hilang. Claude Code melewati aturan dan mencantumnya dalam dialog pengaturan yang tidak valid ketika sesi interaktif dimulai, dan dalam output claude doctor:

Invalid permission rule "Bash(ls) x" was skipped: Malformed Tool(content) rule. Rules take the form Tool or Tool(content) and must end at the closing ")"; parentheses inside the content are literal

Yang harus dilakukan:

• Dalam file pengaturan yang tercantum dengan pesan, tulis ulang aturan sehingga berakhir pada tanda kurung penutupnya, misalnya Bash(ls *) sebagai pengganti Bash(ls) x
• Biarkan tanda kurung di dalam konten apa adanya. Mereka literal, jadi aturan seperti Edit(./Finance (2024)/**) valid tanpa escaping

Sebelum v2.1.260, Claude Code melaporkan aturan dengan tanda kurung yang tidak cocok sebagai Mismatched parentheses.

Tidak cocok dengan pemeriksaan izin file

Claude Code menemukan aturan izin Write, NotebookEdit, MultiEdit, atau Glob dengan jalur dalam salah satu file pengaturan Anda, dalam managed settings, atau dalam nilai flag --allowedTools, --disallowedTools, atau --settings. Itu memeriksa izin file terhadap aturan Edit dan Read saja, jadi tidak pernah berkonsultasi dengan aturan jalur yang menyebutkan salah satu alat file lainnya. Itu menyimpan aturan dan tidak mengubah apa pun yang lain; peringatan menyebutkan aturan, sumbernya dalam tanda kurung, dan penggantian untuk ditulis:

Permission deny rule (.claude/settings.json): Write(docs/**) is not matched by file permission checks — only Edit(path) rules are. Use Edit(docs/**) instead (Edit rules cover all file-editing tools).

Yang harus dilakukan:

• Ganti aturan Write(path), NotebookEdit(path), dan MultiEdit(path) warisan dengan Edit(path). Aturan Edit mencakup semua alat pengeditan file.
• Kecuali dalam --allowedTools, di mana Claude Code menerima aturan Glob tanpa peringatan, ganti aturan Glob(path) dengan Read(path).
• Perbaiki aturan di sumber yang dinamai peringatan dalam tanda kurung: jalur file pengaturan, atau flag itu sendiri untuk --allowed-tools dan --disallowed-tools. Jalur claude-settings-<hash>.json yang tidak ada di disk mewakili nilai --settings inline. Perbaiki JSON yang Anda teruskan ke flag itu.
• Biarkan aturan nama alat bare seperti Write atau Glob saja. Claude Code mencocokkannya di tingkat alat dan tidak memperingatkan tentang mereka.
• Jika sumber berbunyi managed policy settings, teruskan peringatan kepada siapa pun yang memelihara pengaturan yang dikelola Anda, karena Anda tidak dapat menghapusnya sendiri.

Dalam background session atau dengan --output-format json atau stream-json, Claude Code menulis peringatan ke log debug daripada stderr, jadi output yang dibaca mesin tetap bersih. Jalankan dengan --debug untuk menangkapnya di ~/.claude/debug/<session-id>.txt. Sebelum v2.1.210, Claude Code menerima aturan ini tanpa peringatan.

Memiliki wildcard sebelum sisa perintah

Claude Code menemukan aturan allow Bash yang * nya datang sebelum kata belakangan yang menentukan perintah mana itu, seperti Bash(git * main) atau Bash(git -C * status *), dalam salah satu file pengaturan Anda, dalam managed settings, atau dalam nilai flag --allowedTools atau --settings. * cocok dengan teks apa pun, termasuk opsi yang disisipkan pada posisi itu: Bash(git * main) juga menyetujui git -c core.fsmonitor=<script> diff main, di mana -c membuat git menjalankan program yang dinamai perintah. Wildcard patterns menunjukkan aturan pencocokan.

Peringatan ada sehingga Anda dapat mempersempit aturan yang wildcard-nya lebih luas dari yang Anda maksudkan. Claude Code menyimpan aturan dan tidak mengubah apa pun tentang cara pencocokannya; peringatan menyebutkan aturan dan sumbernya dalam tanda kurung:

Permission allow rule (.claude/settings.json): Bash(git -C * status *) has a wildcard before the rest of the command, so it also matches any options inserted at that position and approves them without a prompt. For git, options such as -c and --exec-path can run arbitrary commands. Replace that * with the exact value you mean, or only use * after the subcommand (for example Bash(git status *)).

Yang harus dilakukan:

• Ganti * sebelum subperintah dengan nilai yang tepat yang Anda maksudkan: Bash(git checkout main) sebagai pengganti Bash(git * main).
• Pindahkan setiap * setelah subperintah: Bash(git status *) sebagai pengganti Bash(git -C * status *). Tulis satu aturan per subperintah yang ingin Anda izinkan.
• Perbaiki aturan di sumber yang dinamai peringatan dalam tanda kurung: jalur file pengaturan, atau flag --allowed-tools itu sendiri. Jalur claude-settings-<hash>.json yang tidak ada di disk mewakili nilai --settings inline. Perbaiki JSON yang Anda teruskan ke flag itu.
• Jika sumber berbunyi managed policy settings, teruskan peringatan kepada siapa pun yang memelihara pengaturan yang dikelola Anda, karena Anda tidak dapat menghapusnya sendiri.

Claude Code tidak memperingatkan tentang aturan deny dan ask dengan bentuk yang sama: itu menolak atau meminta perintah tambahan yang mereka cocokkan daripada menyetujuinya. Itu juga tidak memperingatkan tentang aturan yang subperintahnya datang sebelum * pertama, seperti Bash(git commit *), atau aturan di mana tidak ada kata selain opsi yang mengikuti *, seperti Bash(git *), atau tentang aturan awalan :* seperti Bash(git:*).

Dalam background session atau dengan --output-format json atau stream-json, Claude Code menulis peringatan ke log debug daripada stderr, jadi output yang dibaca mesin tetap bersih. Jalankan dengan --debug untuk menangkapnya di ~/.claude/debug/<session-id>.txt. Sebelum v2.1.246, Claude Code menerima aturan ini tanpa peringatan.

crossSessionInbound harus salah satu dari accept, hold, refuse

File pengaturan menetapkan crossSessionInbound ke nilai yang tidak dikenali Claude Code, seperti typo "reject". Kalimat kedua peringatan tergantung pada file mana yang menyimpan nilai; dalam file pengguna, proyek, lokal, atau --settings berbunyi:

"crossSessionInbound" must be one of "accept", "hold", "refuse"; received "reject". This value was ignored; while it is present, cross-session messages are held for your approval instead of being delivered. Set it to one of the values above.

Dalam managed settings, Claude Code memperlakukan nilai yang tidak dikenali sebagai refuse, nilai paling ketat, dan peringatan mengatakan pesan lintas sesi ditolak sampai administrator memperbaikinya. Untuk cara hold menggabungkan dengan nilai dalam file pengaturan lainnya, lihat crossSessionInbound.

Yang harus dilakukan:

• Atur kunci ke "accept", "hold", atau "refuse", atau hapus
• Ketika peringatan menyebutkan managed settings, minta administrator untuk memperbaiki nilai

Sebelum v2.1.248, Claude Code mengabaikan nilai yang tidak dikenali tanpa peringatan.

Batas 200K tidak ditegakkan

Anda menetapkan CLAUDE_CODE_DISABLE_1M_CONTEXT=1, yang biasanya membuat auto-compaction menahan sesi pada model konteks 1M ke jendela 200K, tetapi tidak ada ambang batas compaction yang membatasi sesi ini pada atau di bawah 200K, jadi percakapan dapat tumbuh melampaui itu.

CLAUDE_CODE_DISABLE_1M_CONTEXT is set, but the 200K limit isn't enforced for <model>, so this session can grow past it. To enforce it, set CLAUDE_CODE_AUTO_COMPACT_WINDOW=200000 (or the autoCompactWindow setting).

Claude Code menegakkan batas 200K sendiri untuk setiap model yang dikenalinya sebagai memiliki jendela 1M asli, dan untuk ID model yang tidak dikenalinya, itu compacts pada jendela yang diasumsikan. Peringatan muncul ketika konfigurasi lain mengalahkan penegakan itu:

• ID model bukan yang dikenali Claude Code, seperti alias LLM gateway, dan Anda menetapkan CLAUDE_CODE_DISABLE_UNKNOWN_MODEL_WINDOW_ENFORCEMENT=1 atau menaikkan jendela yang diasumsikan melampaui 200K dengan CLAUDE_CODE_MAX_CONTEXT_TOKENS. Dalam hal ini pesan juga menawarkan or update to a Claude Code version that recognizes <model> sebagai obat.
• Beta context-1m yang diminta melalui ANTHROPIC_BETAS atau flag --betas masih meminta API untuk jendela 1M pada model yang menerima beta itu, sementara tidak ada yang compacts sesi pada 200K

Yang harus dilakukan:

• Atur CLAUDE_CODE_AUTO_COMPACT_WINDOW=200000, atau pengaturan autoCompactWindow ke 200000, sehingga auto-compaction compacts pada batas 200K
• Jika pesan menyebutkan ID model yang versi ini tidak kenali, jalankan claude update. Versi yang mengenali ID sebagai model konteks 1M menegakkan batas tanpa konfigurasi lebih lanjut.
• Jika Anda ingin sesi menggunakan jendela penuh model sebagai gantinya, batalkan CLAUDE_CODE_DISABLE_1M_CONTEXT; peringatan melaporkan hanya bahwa batas 200K tidak ditegakkan

Dalam background session atau dengan --output-format json atau stream-json, Claude Code menulis peringatan ke log debug daripada stderr.

ID model yang tidak dikenali pada permintaan

Claude Code mengirim permintaan untuk ID model yang versi Claude Code Anda tidak kenali, dan tidak menemukan entri modelOverrides yang memetakan ID itu ke model yang dikenalinya. Claude Code masih mengirim permintaan dengan ID seperti yang Anda konfigurasi, dan tidak keluar atau beralih model.

[claude-code:unrecognized_model] {"model":"my-proxy-model","query_source":"sdk"}

Dalam skrip atau harness yang membaca stderr, cocokkan pada awalan [claude-code:unrecognized_model]. Setelah awalan dan satu spasi, Claude Code menulis objek JSON satu baris. Claude Code dapat menambahkan bidang ke dalamnya dalam versi yang lebih baru, jadi abaikan bidang apa pun yang tidak Anda harapkan. Itu menulis setidaknya dua ini:

• model: string model seperti yang Anda konfigurasi
• query_source: jalur permintaan yang menggunakan model. Claude Code melaporkan sdk untuk jalankan -p dan nilai yang dimulai dengan agent: untuk subagent.

Claude Code menulis baris ke salah satu dari dua tempat, tergantung pada cara Anda menjalankannya:

• Dalam mode non-interaktif dengan -p, Claude Code menulis ke stderr di bawah setiap --output-format, jadi Anda dapat menguraikan stdout tanpa memfilter baris keluar
• Dalam sesi interaktif atau background session, Claude Code menulis ke log debug sebagai gantinya; jalankan dengan --debug untuk menangkapnya di ~/.claude/debug/<session-id>.txt

Claude Code menulis baris sekali per string model per proses. Itu menulis baris terpisah untuk setiap ID yang tidak dikenali lebih lanjut, seperti yang digunakan subagent atau background functionality.

Claude Code tidak menulis baris untuk ID penyedia yang diselesaikannya ke model yang dikenalinya, seperti Amazon Bedrock us.anthropic.claude-... ID, ID Agent Platform Google Cloud dengan akhiran versi @, dan nama deployment Microsoft Foundry yang berisi ID model Claude. Claude Code memeriksa model di balik application inference profile ARN Amazon Bedrock daripada ARN itu sendiri. Itu tidak menulis baris untuk ARN yang tidak dapat diselesaikannya, seperti yang salah ketik.

Yang harus dilakukan:

• Jika Anda menetapkan ID dengan sengaja, seperti alias LLM gateway, tambahkan entri modelOverrides ke file pengaturan Anda dengan ID sebagai nilainya. Gunakan ID model Anthropic sebagai kunci, bukan alias keluarga seperti opus. Untuk my-proxy-model dari baris contoh, tambahkan entri ini:

  {
    "modelOverrides": {
      "claude-opus-4-6": "my-proxy-model"
    }
  }
  

  Claude Code kemudian memperlakukan my-proxy-model sebagai claude-opus-4-6 dan berhenti menulis baris.

• Jika ID menyebutkan model yang lebih baru dari versi Claude Code Anda, jalankan claude update

• Jika ID adalah typo, perbaiki di mana pun dari tempat Anda dapat menetapkan model atau variabel alias yang menyimpannya. Jika query_source dimulai dengan agent:, perbaiki di mana Anda menetapkan model subagent sebagai gantinya.

Sebelum v2.1.233, Claude Code tidak menulis baris ketika mengirim permintaan untuk ID model yang tidak dikenalinya.

File mask sandbox basi ditinggalkan oleh sesi yang dibunuh

claude doctor mencetak peringatan ini dalam diagnostiknya, dan /status mencantumkan baris yang sama. Itu muncul di Linux dan WSL2 ketika sandboxing diaktifkan dengan isolasi filesystem aktif.

Sementara perintah sandboxed berjalan, sandbox menyimpan penolakan tulis pada file yang belum ada dengan membuat placeholder read-only 0-byte di sana, dan menghapusnya setelahnya. Sesi yang dibunuh sebelum pembersihan itu berjalan, misalnya oleh SIGKILL, meninggalkan placeholder di belakang. Sesi-sesi kemudian mengikatnya read-only lagi pada setiap start, jadi penulisan pengaturan seperti menyimpan "Yes, and don't ask again" gagal di mana satu duduk.

- Stale sandbox mask files left by a killed session: /home/you/project/.claude/settings.local.json
  Fix: Remove each with `rm <path>` while no other Claude Code session is running in that project — a 0-byte read-only file where a settings file belongs makes "Yes, and don't ask again" fail to save, and the sandbox binds it read-only again on every start

Yang harus dilakukan:

• Keluar dari sesi Claude Code lain yang berjalan di proyek itu, kemudian hapus setiap file yang tercantum dengan rm. Peringatan menyebutkan hingga tiga file dan menghitung sisanya, jadi jalankan kembali claude doctor setelah menghapus sampai peringatan tidak lagi muncul. Placeholder yang sandbox sesi lain masih gunakan adalah bagian hidup dari perlindungan tulis sesi itu
• Jika pilihan izin yang Anda simpan dengan "Yes, and don't ask again" tidak tetap, simpan lagi setelah menghapus placeholder

Sebelum v2.1.257, claude doctor tidak menandai file-file ini; versi-versi sebelumnya meninggalkan placeholder yang sama di belakang ketika sesi dibunuh.

Respons tampak berkualitas lebih rendah dari biasanya

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

• --fallback-model yang dikonfigurasi mengambil alih setelah kesalahan ketersediaan, hanya untuk giliran itu, dengan pemberitahuan dalam transkrip
• Pemeriksaan startup Amazon Bedrock atau Google Cloud's Agent Platform menemukan model default Anda tidak tersedia
• Fallback model otomatis pada Fable 5.1, Fable 5, Opus 5.5, dan Opus 5 memindahkan sesi ke model fallback kategori yang ditandai, ketika kategori itu memiliki satu, dan menampilkan pemberitahuan dalam transkrip

Pemeriksaan Model selection di bawah menangkap kasus kedua dan ketiga; yang pertama muncul sebagai pemberitahuan transkrip daripada perubahan /model. Model configuration menjelaskan kapan setiap fallback berlaku.

Periksa ini terlebih dahulu:

• 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.
• Effort level: jalankan /effort untuk memeriksa tingkat penalaran 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 untuk default per-model dan pintasan ultrathink.
• Context pressure: jalankan /context untuk melihat seberapa penuh jendela itu. Jika mendekati kapasitas, jalankan /compact pada titik alami atau /clear untuk memulai segar. Lihat Explore the context window untuk bagaimana auto-compact mempengaruhi giliran sebelumnya.
• Stale instructions: file CLAUDE.md yang besar atau ketinggalan zaman dan definisi alat MCP mengonsumsi konteks dan dapat mengarahkan respons. 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.

Ketika respons salah, rewinding biasanya bekerja lebih baik daripada membalas dengan koreksi. Tekan Esc dua kali atau jalankan /rewind untuk mundur ke sebelum giliran buruk, kemudian rephrase prompt dengan lebih spesifik. Mengoreksi dalam-thread menjaga upaya yang salah dalam konteks, yang dapat menambatkan jawaban nanti ke sana. Lihat Checkpointing.

Jika kualitas masih tampak tidak benar setelah memeriksa di atas, jalankan /feedback dan jelaskan apa yang Anda harapkan versus apa yang Anda dapatkan. Umpan balik yang dikirimkan dengan cara ini mencakup transkrip percakapan, yang merupakan cara tercepat bagi Anthropic untuk mendiagnosis regresi nyata. Lihat Report an error jika /feedback tidak tersedia di lingkungan Anda.

Jika Claude memperingatkan tentang injeksi prompt yang dicurigai, atau menolak permintaan karena injeksi yang dicurigai, dan teks yang dinamai peringatan adalah konteks yang Claude Code tambahkan ke percakapan secara otomatis daripada konten file atau web, jalankan claude update dan coba lagi. Jika peringatan berulang setelah memperbarui, laporkan daripada menempel konten yang ditandai kembali ke prompt. Sebelum v2.1.201, Sonnet 5 menolak beberapa permintaan dengan cara yang sama.

Laporkan kesalahan

Untuk kesalahan dari komponen yang tidak tercakup di halaman ini, lihat panduan yang relevan:

• Server MCP gagal terhubung atau autentikasi: MCP
• Skrip hook gagal atau memblokir alat: Debug hooks
• Izin ditolak atau kesalahan sistem file selama instalasi: Troubleshoot installation and login

Jika kesalahan tidak tercantum di sini atau perbaikan yang disarankan tidak membantu:

• 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. 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.
• 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
• Periksa status.claude.com untuk insiden aktif
• Cari existing issues di GitHub