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 surface lainnya, lihat bagian pemecahan masalah di halaman surface tersebut.
Claude Code memanggil Claude API untuk respons model, jadi sebagian besar kesalahan runtime memetakan ke kode kesalahan API yang mendasar. Halaman ini mencakup apa arti setiap kesalahan di dalam Claude Code dan cara memulihkan. Untuk definisi kode status HTTP mentah, lihat Claude Platform error reference.
Temukan kesalahan Anda
Cocokkan pesan yang Anda lihat dengan bagian di bawah ini.Retry otomatis
Claude Code mencoba ulang kegagalan transien hingga 10 kali dengan exponential backoff sebelum menampilkan kesalahan kepada Anda. Claude Code tidak selalu mencoba ulang kegagalan yang tiba di tengah respons Claude. Ketika Anda melihat salah satu kesalahan di halaman ini, Claude Code telah melakukan retry apa pun yang berlaku untuk kegagalan tersebut. Claude Code mencoba ulang kegagalan ini:- Server errors, overloaded responses, dan request timeouts yang tiba sebelum respons Claude mulai streaming.
- Server error atau overloaded response yang tiba setelah Claude selesai berpikir tetapi sebelum memulai teks atau panggilan tool apa pun. Claude Code mencoba ulang server error pada titik itu hingga dua kali. Sebelum v2.1.284, Claude Code mengakhiri giliran dengan kesalahan tersebut pada titik itu.
- 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 tool apa pun, Claude Code malah mengeluarkan kembali permintaan hingga dua kali dengan cepat, dan mengakhiri giliran dengan
Connection lost before a response was producedjika 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 retry menyebutkan alasan spesifik, dibaca
Connection lost while your computer was asleep, dan jika giliran berakhir setelah Claude selesai berpikir tetapi sebelum teks atau panggilan tool apa pun, pesan berbunyiYour 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 tool apa pun: Claude Code membatalkan koneksi yang macet dan melakukan streaming ulang permintaan paling banyak sekali. Jika respons macet untuk kedua kalinya setelah Claude selesai berpikir tetapi sebelum teks atau panggilan tool apa pun, Claude Code mengakhiri giliran dengan
The response stalled before a response was produced. - Permintaan streaming yang tidak pernah dijawab API dengan response headers, pada koneksi tempat first-byte deadline berjalan. Pada deadline, Claude Code membatalkan permintaan dan mengirimnya kembali dalam anggaran retry. Jika deadline juga terpicu untuk pengiriman ulang, giliran berakhir dengan No response from API. Ketika Anda menetapkan
CLAUDE_CODE_RETRY_WATCHDOG, Claude Code terus mengirim ulang dalam anggaran tersebut sebagai gantinya. - Respons streaming yang dihentikan oleh filter konten output API sebelum Claude selesai berpikir atau memulai teks atau panggilan tool apa pun. Claude Code mengirim kembali permintaan sekali, dalam anggaran retry, dan menampilkan Output blocked by content filtering policy jika filter juga menghentikan respons kedua.
- Temporary 429 throttles, tetapi bukan
429spend-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 paket Anda. Sebelum v2.1.199, Claude Code hanya mencoba ulang throttles tersebut untuk kunci API dan Enterprise sign-ins.
- Permintaan ditolak karena input plus
max_tokensmelebihi context limit. Mengirimnya kembali tanpa perubahan akan gagal dengan cara yang sama, jadi Claude Code mencoba ulang denganmax_tokensyang dikurangi, dan berhenti mencoba ulang 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 retry tidak dapat menyusutkan
max_tokenslebih 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 retry habis.
- Respons yang menyatakan Claude sedang memanggil tool tetapi tidak berisi panggilan tool. Claude Code mencoba ulang dengan meminta Claude memberikan panggilan tool tersebut, hingga dua kali. Jika kedua retry gagal dengan cara yang sama, Anda melihat
The model's tool call could not be parsed (retry also failed).dan giliran berakhir. Untuk mencoba lagi, kirim pesan lain. Sebelum v2.1.307, Claude Code mencoba ulang sekali sebelum mengakhiri giliran. - Expired atau missing Google Cloud credential pada Google Cloud’s Agent Platform, atau kredensial AWS yang gagal dimuat di mesin Anda. Claude Code membuang kredensial yang di-cache dan mencoba ulang 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 mencoba ulang failing Google Cloud credential melalui anggaran retry penuh sebelum menampilkan kesalahan.
401atau403dari Anthropic API, secara langsung atau melalui LLM gateway, sementara scriptapiKeyHelpermenyediakan kredensial. Claude Code menjalankan kembali script dan mencoba ulang dengan output segar-nya, dalam anggaran retry penuh. Ketika script itu sendiri gagal pada re-run, Claude Code menampilkan Your apiKeyHelper script is failing sebagai gantinya.
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 mencoba ulang kegagalan ini:
- TLS certificate validation failure, seperti TLS-inspecting proxy, missing
NODE_EXTRA_CA_CERTSbundle, 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 mencoba ulang transient TLS conditions seperti handshake timeout. Sebelum v2.1.199, Claude Code mencoba ulang certificate failures melalui anggaran retry penuh sebelum menampilkan kesalahan. - Server error, dropped connection, atau stalled stream yang tiba setelah Claude menyelesaikan blok teks atau panggilan tool, atau telah memulai satu setelah menyelesaikan pemikirannya, tetapi sebelum menyelesaikan respons. Claude Code tidak menjalankan kembali permintaan, karena itu dapat mengeksekusi panggilan tool yang sama dua kali. Ini menyimpan apa yang Claude selesaikan, menjalankan panggilan tool 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 dicoba ulang, 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 retry 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 mencoba ulang atau menunggu
Saat mencoba ulang, spinner menampilkan countdownRetrying 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 retry. 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.
Waiting for API response
BannerWaiting for API response · will retry in … · check your network berarti Claude Code telah menunggu setidaknya 20 detik tanpa menerima data apa pun untuk sebuah permintaan. Permintaan belum gagal: countdown berjalan ke titik di mana Claude Code membatalkan koneksi yang macet. Jika pembatalan terjadi:
- Sebelum Claude menyelesaikan blok teks atau panggilan tool, atau memulai satu setelah menyelesaikan pemikirannya, Claude Code mencoba ulang permintaan atau mengakhiri giliran dengan kesalahan. Automatic retries mengatakan stalls mana yang dicoba ulang dan berapa kali.
- Setelah Claude menyelesaikan blok teks atau panggilan tool, atau memulai satu setelah menyelesaikan pemikirannya, tetapi sebelum Claude menyelesaikan respons, Claude Code menyimpan apa yang Claude selesaikan, melanjutkan giliran dari panggilan tool 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 menunggu muncul dan hilang di balik gateway
Jika bannerWaiting for API response muncul dan hilang saat Claude berpikir dan Anda terhubung melalui gateway, perbarui Claude Code ke v2.1.309 atau lebih baru. Banner muncul setelah 45 detik tanpa data pada koneksi berikut:
ANTHROPIC_BASE_URLditetapkan ke host selain Anthropic API, seperti LLM gateway- Sesi Claude apps gateway
- Claude Platform on AWS dengan
ANTHROPIC_AWS_BASE_URLditetapkan
Sesuaikan perilaku retry
Anda dapat menyesuaikan perilaku retry dengan environment variable ini:Berapa lama percobaan non-streaming menunggu
Percobaan non-streaming berakhir pada request timeout-nya atau pada body idle timeout, mana pun yang lebih dulu terjadi:- Request timeout:
API_TIMEOUT_MSketika Anda menetapkan nilai positif, jika tidak 300 detik dalam sesi lokal. - Body idle timeout: 5 hingga 6 menit tanpa respons, setinggi apa pun Anda menetapkan
API_TIMEOUT_MS, di tempat timeout ini berjalan dan Anda belum mematikannya.
Kesalahan server
Sebagian besar kesalahan ini berasal dari penyedia inferensi: layanan Anthropic di Anthropic API, dan layanan di balik endpoint penyedia tersebut di Amazon Bedrock, Google Cloud’s Agent Platform, Microsoft Foundry, atau gateway khusus. Auto mode tidak dapat menentukan keamanan suatu tindakan 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:ANTHROPIC_BASE_URL khusus menyebutkan host gateway.
Respons 5xx dari API itu sendiri menunjukkan kegagalan yang tidak terduga di dalam API. Ini tidak disebabkan oleh prompt, pengaturan, atau akun Anda.
Ketika proxy, load balancer, atau gateway menjawab dengan halaman kesalahan HTML, pesan menampilkan kode status dan judul halaman, seperti API Error: 502 Bad Gateway. Untuk halaman tanpa judul, pesan menampilkan kode status dan nama standarnya. Sebelum v2.1.281, kode status dijatuhkan ketika halaman memiliki judul, dan markup mentah halaman dicetak ketika tidak ada.
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 againalih-alih menempel seluruh hal. - Jika
ANTHROPIC_BASE_URLmengarah ke LLM gateway dan setiap permintaan gagal dengan cara ini, periksa apakah gateway Anda dan upstream-nya menerima bidang pencarian tool. Secara default, Claude Code mengirim bidang tooldefer_loadingdan bloktool_reference, bersama headeranthropic-betayang mengaktifkannya. Sebelum v2.1.304, pencarian tool dinonaktifkan di balik gateway kecuali Anda mengaktifkannya denganENABLE_TOOL_SEARCH. - Jika kesalahan berlanjut tanpa insiden yang diposting, jalankan
/feedbacksehingga Anthropic dapat menyelidiki dengan detail permintaan Anda. Lihat Report an error jika/feedbacktidak tersedia di lingkungan Anda.
API Error: Repeated 529 Overloaded errors
API sementara pada kapasitas di semua pengguna. Claude Code telah mencoba ulang beberapa kali sebelum menampilkan pesan ini:- Periksa status.claude.com, atau halaman status penyedia yang disebutkan dalam pesan, untuk pemberitahuan kapasitas
- Coba lagi dalam beberapa menit
-
Jalankan
/modeldan 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, misalnyaOpus is experiencing high load, please use /model to switch to Sonnet. Pada model Fable pesan menyebutkan Fable. Dalam sesi yang dijalankan aplikasi Claude Desktop, seperti tab Code atau Cowork, pesan berbunyiOpus is experiencing high load. Switch to Sonnet.dan Anda beralih model dengan pemilih model aplikasi.
Request timed out
API tidak merespons sebelum batas waktu koneksi.API_TIMEOUT_MS ke 0, timeout permintaan ini dinonaktifkan. Batas waktu byte pertama dan timeout idle badan respons tidak dinonaktifkan ketika Anda menetapkan 0, jadi permintaan streaming tetap berjalan di bawah mana pun di antara keduanya yang berlaku untuk koneksi Anda. Upaya non-streaming tetap mempertahankan batas 300 detiknya dalam sesi lokal dan masih dapat berakhir dengan pesan ini.
Yang harus dilakukan:
- Jika setiap permintaan gagal dengan pesan ini dan Anda menetapkan
API_TIMEOUT_MSke0, periksaclaude --version. Pada versi sebelum v2.1.305, perbarui Claude Code atau tetapkan nilai positif. - Coba lagi permintaan
- Jika penyebabnya adalah jaringan lambat atau proxy, naikkan
API_TIMEOUT_MSseperti yang dijelaskan dalam Automatic retries - Jika timeout 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. Claude Code membatalkan permintaan seperti itu alih-alih menunggu timeout permintaanAPI_TIMEOUT_MS penuh, dan mengirimnya lagi jika retry budget memungkinkan. Ketika batas waktu juga terlewati untuk retry, giliran berakhir dengan pesan ini, yang menunjukkan berapa lama setiap upaya menunggu.
Jika Anda menetapkan CLAUDE_CODE_RETRY_WATCHDOG, Claude Code terus mencoba ulang di bawah anggaran yang dijelaskan dalam Tune retry behavior alih-alih mengakhiri giliran.
-
Upaya pertama:
CLAUDE_STREAM_FIRST_BYTE_TIMEOUT_MSketika Anda menetapkannya ke 1 atau lebih, diklem antara 10 detik dan 30 menit. Jika tidak, Claude Code menggunakan timeout watchdog tingkat byte yang tercantum dalam Streaming idle watchdogs, jadi variabel yang mengubah timeout itu mengubah tunggu ini juga. Bagaimanapun, Claude Code menambahkan satu detik untuk setiap 32KB badan permintaan. -
Retry: satu detik kurang dari
API_TIMEOUT_MS, hanya di bawah 10 menit secara default, sehingga retry dapat melampaui proxy atau gateway yang menahan respons hingga generasi selesai. Di Amazon Bedrock, retry menggunakan batas waktu yang sama dengan upaya pertama, dan pesan menunjukkan satu durasi alih-alih dua. Kecuali di Amazon Bedrock, jika Anda menetapkanAPI_TIMEOUT_MSke0, retry menunggu 10 menit ditambah satu detik per 32KB, atau selama upaya pertama jika itu lebih lama.
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.
Dalam sesi Claude apps gateway, batas waktu ini hanya berjalan ketika Anda mengaktifkannya dengan menetapkan CLAUDE_STREAM_FIRST_BYTE_TIMEOUT_MS ke 1 atau lebih.
Yang harus dilakukan:
- Kirim pesan Anda lagi. Pesan asli Anda masih ada dalam percakapan, jadi untuk prompt yang panjang Anda dapat mengetik
try againalih-alih menempel seluruh hal. - Jika terulang, perlakukan sebagai network or proxy problem.
- Jika proxy atau gateway di jaringan Anda menahan respons hingga selesai, naikkan
API_TIMEOUT_MSsehingga retry menunggu lebih lama. Di Amazon Bedrock, naikkanCLAUDE_STREAM_FIRST_BYTE_TIMEOUT_MSjuga. - Jika upaya pertama terus habis waktu dan retry kemudian berhasil, naikkan
CLAUDE_STREAM_FIRST_BYTE_TIMEOUT_MSsehingga upaya pertama juga menunggu cukup lama.
API_TIMEOUT_MS penuh, 10 menit secara default, sebelum menggagalkan permintaan streaming yang tidak dijawab. Sebelum v2.1.261, retry menunggu batas waktu yang sama dengan upaya pertama dan pesan tidak menunjukkan durasi. Sebelum v2.1.307, Claude Code mengabaikan CLAUDE_STREAM_FIRST_BYTE_TIMEOUT_MS dalam sesi Claude apps gateway.
The response above may be incomplete
Permintaan streaming gagal sementara respons masih berlangsung, setelah Claude menyelesaikan blok teks atau panggilan tool, atau telah memulai satu setelah menyelesaikan pemikirannya. Mengirim ulang permintaan dapat menjalankan panggilan tool yang sama dua kali, jadi Claude Code menyimpan output yang Claude selesaikan dan menambahkan pemberitahuan ini alih-alih membuang giliran. Varian mana yang Anda lihat menyebutkan penyebabnya: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. Anda juga melihat varian ini ketika proxy atau gateway mengakhiri badan respons dengan bersih sebelum respons selesai.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.Part of the response never arrived: peristiwa stream dijatuhkan antara API dan Claude Code, jadi peristiwa yang lebih baru mereferensikan konten yang tidak pernah tiba. Sebelum v2.1.281, kasus ini mengakhiri giliran denganAPI Error: Content block not found.The response stream was malformed: peristiwa tiba untuk blok konten yang sudah selesai, atau peristiwa tiba rusak. Peristiwa yang rusak adalah peristiwa yang datanya bukan JSON yang valid, yang kontennya hilang, atau yang kontennya tidak cocok dengan jenis peristiwa. Sebelum v2.1.284, kesalahan parser mentah, seperti yang dimulai denganAPI Error: JSON Parse error, muncul sebagai gantinya ketika peristiwa dengan JSON yang tidak valid tiba setelah Claude menyelesaikan pemikirannya, blok teks, atau panggilan tool.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 melaluiANTHROPIC_BASE_URLatauANTHROPIC_AWS_BASE_URLsementara ping keep-alive server masih tiba, karena hanya menghitung peristiwa respons yang diurai di sana; upgrade menghentikan timeout palsu itu di rute tersebut. Gateway yang dicapai melalui URL dasar penyedia sepertiANTHROPIC_BEDROCK_BASE_URLtidak dibungkus oleh watchdog byte; lihat Streaming idle watchdogs.
Connection lost mid-response berbunyi Connection closed mid-response dan The response stopped arriving berbunyi Response stalled mid-stream.
Ketika peristiwa stream yang dijatuhkan, diduplikasi, atau rusak tiba sebelum Claude memulai teks atau panggilan tool apa pun, Anda tidak melihat pemberitahuan ini:
- Jika Claude hanya menyelesaikan pemikirannya, Claude Code mengeluarkan kembali permintaan. Ketika stream yang diterbitkan kembali putus dengan cara yang sama, giliran berakhir dengan
Part of the response never arrived and no response was produced. Try again.atauThe response stream was malformed and no response was produced. Try again. - Jika tidak ada yang selesai, Claude Code mengirim ulang permintaan tanpa streaming. Jika Anda mematikan fallback itu dengan
CLAUDE_CODE_DISABLE_NONSTREAMING_FALLBACK, giliran berakhir denganAPI Error: Content block not founduntuk peristiwa yang dijatuhkan atauAPI Error: Content block already closeduntuk peristiwa yang diduplikasi. Untuk peristiwa yang rusak dengan fallback dimatikan, giliran berakhir denganAPI Error: Stream event unreadableatau kesalahan parser mentah.
- 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 mengirimcontinuesendiri ketika respons cut-off berada dalam percakapan utama dan berisi teks tetapi tidak ada panggilan tool: Claude Code menyimpan output parsial dan meminta Claude untuk melanjutkan dari tempat ia berhenti, hingga tiga kali berturut-turut. Anda melihat pemberitahuan ini untuk respons seperti itu hanya setelah Claude Code menggunakan kelanjutan itu. Sebelum v2.1.246, Claude Code mengakhiri giliran non-interaktif dengan pemberitahuan ini pada cut-off pertama. - Dalam subagent, apakah sesi interaktif atau tidak: ketika respons cut-off-nya berisi teks tetapi tidak ada panggilan tool, Claude Code meminta subagent untuk melanjutkan. Pemberitahuan menjadi pesan terakhir subagent hanya setelah kelanjutan itu digunakan. Sebelum v2.1.257, subagent menampilkan pemberitahuan ini pada cut-off pertama.
- Dalam sesi interaktif, baca respons yang tetap di layar: Claude Code menyimpan setiap blok yang Claude selesaikan sebelum kesalahan, tetapi membuang blok akhir yang terputus ketika giliran berakhir, jadi kalimat atau panggilan tool terakhir mungkin hilang. Balas dengan
continueuntuk 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
-pdan menjatuhkan respons yang sudah dihasilkan. - Dengan
--output-format jsonataustream-json, Claude Code melaporkan pesan ini di bidangresult. - Untuk melanjutkan giliran setelah koneksi stabil, lanjutkan sesi dan kirim
continueseperti yang dijelaskan dalam Continue conversations.
- 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
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. Ketika model pengklasifikasi tidak tersedia:Not run · auto mode's check had no usable answer muncul di bawah panggilan tool alih-alih pesan ini. Baris tersebut juga dapat menggantikan pesan yang menyatakan server tidak memberikan putusan atau, di luar sesi jarak jauh, pesan yang diawali Auto mode could not evaluate. Tekan Ctrl+O untuk membaca pesannya di penampil transkrip. Sebelum v2.1.296, pesan muncul sebagai kesalahan merah.
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). 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 berbunyi 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 retry 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 retry terus gagal, lanjutkan dengan tugas read-only dan kembali ke tindakan yang diblokir nanti
- Di Amazon Bedrock, jika pesan kembali pada setiap retry, periksa bahwa akun Anda dapat memanggil model yang disebutkan: untuk model Amazon Bedrock standar, konfirmasi IAM policy Anda memungkinkan memanggilnya; untuk ID model Mantle, hubungi tim akun AWS Anda
- Jika pesan kembali pada setiap retry dan menyebutkan model yang Anda tetapkan di
CLAUDE_CODE_AUTO_MODE_MODEL, periksa bahwa API atau penyedia cloud tempat sesi Anda berjalan menyediakan ID model tersebut. Jika tidak, tetapkan variabel ke ID model yang disediakannya, atau hapus variabel untuk menggunakan model pengklasifikasi default.
- Coba lagi tindakan; ini biasanya berhasil pada upaya berikutnya
- Jalankan
claude --debugdan ulangi tindakan untuk detail dalam log debug
-p non-interactive, Claude Code tidak menghentikan run. Apa yang Claude terima tergantung pada tempat ia meminta tindakan:
- Ke background subagent dalam run
-ptanpa--input-format stream-json, Claude Code mengembalikan hasil kesalahan yang berisiAgent 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
- 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
- Dalam sesi interaktif, auto mode melakukan fallback ke dialog izin normal untuk tindakan itu sehingga Anda dapat menyetujui atau menolaknya secara manual
- Ke background subagent dalam run
-pnon-interactive tanpa--input-format stream-json, Claude Code mengembalikan hasil kesalahan yang berisiAgent aborted: auto mode classifier transcript exceeded context window in headless mode, dan run berlanjut - Di tempat lain dalam run
-ptanpa--permission-prompt-tool, tidak ada dialog izin untuk fallback, jadi tindakan tidak berjalan dan run berlanjut
- Dalam sesi interaktif, setujui atau tolak tindakan dalam dialog izin yang muncul
- Dalam sesi interaktif, jalankan
/compactuntuk 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):
Auto mode check unavailable dengan hitungan mundur, dan menekan Esc mengganggu giliran.
Setelah sepuluh respons berturut-turut tanpa putusan, auto mode menghentikan giliran:
- Dalam sesi interaktif, pesan muncul sebagai peringatan dalam transkrip dan giliran berakhir
- Dalam run
-pnon-interactive, run berakhir dan melaporkan kesalahan eksekusi. Dengan output teks default, pesan dicetak di stderr. - Ketika subagent mencapai batas, subagent berhenti sebelum selesai, dan Claude menerima apa pun yang dihasilkan dengan catatan bahwa auto mode menghentikannya
- Dalam sesi interaktif, tekan
Ctrl+Ountuk membaca teks penolakan di penampil transkrip. - Jika penolakan menyebutkan
(the conversation is too long for the check), jalankan/compactdi prompt Claude Code untuk memperpendek percakapan. Sampai percakapan lebih pendek, mengirim pesan lain akan mendapatkan penolakan yang sama. Jika Anda mematikan auto-compact, aktifkan kembali agar Claude Code melakukan compaction sendiri di lain waktu. - 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=0sebelum 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
a hook changed this call's input after auto mode reviewed it
Penolakan ini berarti hook atau mod mengubah input panggilan setelah server meninjaunya, sehingga tinjauan tersebut tidak mencakup apa yang akan dijalankan. Ini bukan penilaian bahwa tindakan tersebut tidak aman.
Panggilan berikutnya dalam respons Claude yang sama dapat ditolak dengan alasan ini:
- Hentikan perubahan: matikan hook atau mod yang mengubah panggilan tersebut atau panggilan sebelumnya dalam respons Claude yang sama, atau minta administrator Anda untuk mematikannya. Untuk mencari hook, jalankan
/hooksdi prompt Claude Code. Dalam sesi terminal, jalankan/pluginuntuk melihat mod yang aktif. - Setujui panggilan sendiri: beralih ke mode Manual
Was not reviewed and did not run
Penolakanwas not reviewed and did not run berarti percakapan terlalu panjang bagi pengklasifikasi auto mode untuk memeriksa tindakan, sehingga tindakan tidak berjalan. Claude Code mengembalikan pesan ini ke Claude:
- Penolakan
gave no verdict (the conversation is too long for the check) - Pesan
Auto mode classifier transcript exceeded context window
- Jika compaction yang diumumkan pesan berhasil, Anda tidak perlu melakukan apa pun.
- Jika Anda melihat salah satu dari dua pesan tersebut, jalankan
/compactdi prompt Claude Code untuk memperpendek percakapan sendiri. Jika Anda mematikan auto-compact, aktifkan kembali agar Claude Code melakukan compaction sendiri di lain waktu.
Agent terminated early due to an API error
Permintaan API subagent gagal secara terminal, misalnya karena batas penggunaan tercapai atau retry untuk kesalahan server habis, jadi subagent berhenti sebelum menyelesaikan tugasnya. Pesan ini memerlukan Claude Code v2.1.199 atau lebih baru; sebelumnya teks kesalahan API dikembalikan ke Claude seolah-olah itu adalah hasil subagent.- 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
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 kredit penggunaan 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:/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. 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 ulang giliran yang terputus setelah reset dan menampilkan waktu retry pada kartu. Kotak centang Desktop dan pengaturan Continue automatically at usage limit CLI di
/configterpisah, jadi matikan masing-masing secara terpisah. - Untuk batas Opus atau Sonnet, jalankan
/modeldan 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
/usageuntuk melihat batas paket Anda dan kapan mereka direset - Jalankan
/usage-creditsuntuk membeli penggunaan tambahan di Pro, Max, dan Ultra, 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
You've used 85% of your session limit · resets 3:45pm. Untuk memantau tunjangan sisa Anda, tambahkan bidang rate_limits ke custom status line, atau di aplikasi Desktop klik usage ring.
Usage credits required for 1M context
Model yang dipilih menggunakan context window diperluas 1M-token, dan paket Anda hanya mencakupnya melalui kredit penggunaan./compact; jalankan /clear pada versi tersebut untuk pulih. Langkah-langkah di bawah berlaku ketika Anda secara eksplisit memilih model [1m].
Yang harus dilakukan:
- Jalankan
/modeldan pilih varian tanpa akhiran[1m]untuk kembali ke context window standar - Di mana pesan menyebutkan
/usage-credits, jalankan untuk mengaktifkan penagihan terukur untuk varian 1M di Pro, Max, dan Ultra, atau untuk meminta kredit penggunaan dari admin Anda di Team dan Enterprise. Setelah kredit penggunaan 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
run /usage-credits to turn them on, or /model to switch to standard context dan tidak menyebutkan restart.
The prompt to confirm went unanswered
Ketika prompt persetujuan kredit penggunaan Fable ditutup tanpa ada yang menjawabnya, Claude Code mengakhiri giliran dengan salah satu pesan ini:continuing on Fable 5.2 dan Fable 5.2 now uses usage credits. Dengan Remote Control terhubung, setiap pesan dapat berakhir dengan Claude stopped here · send a message to be asked again, or switch models sebagai gantinya. Sebelum v2.1.257, pesan pertama dimulai dengan Fable 5 limit reached.
Ini terjadi dalam sesi Remote Control, background sessions, agent team sesi rekan tim, dan sesi yang aplikasi lain menghosting melalui Agent SDK. Untuk kapan Claude Code menutup prompt, lihat Fable and usage credits.
Yang harus dilakukan:
- Di mana sesi berjalan, di terminal atau di aplikasi yang menghosting, kirim prompt lain dan jawab prompt persetujuan ketika muncul kembali. Untuk sesi latar belakang, lampirkan terlebih dahulu dari agents view. Jika pesan mengatakan
Claude stopped here, Anda juga dapat membalas dari perangkat yang terhubung dan menjawab prompt persetujuan di sana. - Jalankan
/modeluntuk beralih ke model yang tidak menagih kredit penggunaan - Untuk memberi diri Anda lebih banyak waktu, atur
dialogExpiryke nilai yang lebih lama atau"never"
Server is temporarily limiting requests
API menerapkan throttle jangka pendek yang tidak terkait dengan kuota paket Anda.- Tunggu sebentar dan coba lagi
- Periksa status.claude.com jika terus berlanjut
Request rejected (429)
Anda telah mencapai rate limit yang dikonfigurasi untuk kunci API, proyek Amazon Bedrock, atau proyek Google Cloud Anda.ANTHROPIC_BASE_URL kustom menyebutkan host gateway.
Ketika proxy, load balancer, atau gateway antara Claude Code dan API menjawab dengan halaman HTML 429-nya sendiri, teks setelah · adalah judul halaman itu ketika memiliki satu, seperti Too Many Requests. Sebelum v2.1.281, markup halaman lengkap dicetak setelah ·.
Yang harus dilakukan:
- Jalankan
/statusdan konfirmasi kredensial aktif adalah yang Anda harapkan.ANTHROPIC_API_KEYyang 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: hindari menjalankan banyak subagent paralel, atau beralih ke model yang lebih kecil dengan
/modeluntuk run skrip volume tinggi
You’ve hit your monthly spend limit
Penggunaan yang disertakan paket Anda tidak dapat menutupi permintaan ini, dan kredit penggunaan yang sebaliknya akan membayarnya telah mencapai batas pengeluaran. Paket Anda tidak dapat menutupi permintaan ketika salah satu jendela penggunaannya telah habis, atau ketika hanya kredit penggunaan yang membayar permintaan tersebut. Salah satu contohnya adalah permintaan ke model yang menagih ke kredit penggunaan. Kata-kata sebelum· menyebutkan batas yang memblokir Anda, seperti batas pengeluaran bulanan org Anda, dan teks setelahnya mengatakan cara agar batas itu dinaikkan. Dalam sesi cloud atau di bawah Remote Control, teks itu tidak memberikan URL, dan pesan tentang monthly spend limit milik Anda sendiri tidak mengatakan cara menaikkannya. Sesi lain menampilkan bentuk seperti ini:
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 channel 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.
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, Max, dan Ultra, tingkatkan batas pengeluaran bulanan Anda di Settings > Usage di claude.ai, atau jalankan
/usage-credits - Di Team dan Enterprise, tingkatkan batas di Organization settings > Usage jika Anda mengelola penagihan, atau minta admin untuk melakukannya.
/usage-creditsmengirim permintaan itu ke admin Anda untuk Anda - Untuk batas channel, minta pemilik org atau manajer channel 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
/usageuntuk melihat jendela paket Anda dan kapan masing-masing direset
Spend limit reached
Anda terhubung melalui Claude apps gateway dan telah mencapai spend cap yang ditetapkan operator gateway Anda. Gateway memblokir permintaan Anda sampai operator menaikkan batas, atau sampai batas direset jika nilainya di atas $0. Gateway menandai setiap respons429 yang diblokir dengan x-should-retry: false, sehingga di terminal Claude Code menampilkan pesan ini tanpa mencoba ulang.
- Dengan tanggal: batas direset pada pukul 00:00 UTC pada tanggal tersebut
- Tanpa tanggal: batas Anda adalah $0, atau gateway Anda menjalankan versi yang lebih lama dari v2.1.225
spend limit reached (daily; resets 2026-08-09 00:00 UTC).
Yang harus dilakukan:
- Jika pesan memuat tanggal, tunggu reset, atau ikuti catatan operator jika pesan membawanya
- Minta operator gateway Anda untuk menaikkan batas jika pesan tidak memuat tanggal, jika Anda masih diblokir setelah tanggal tersebut, atau jika Anda mencapai batas secara rutin
This request exceeds your group's budget, berarti anggaran terpusat grup Anda telah habis. Ikuti langkah-langkah yang disebutkannya:
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.- Jika Anda memiliki paket Pro, Max, Ultra, Team, atau Enterprise dan melihat ini, jalankan
/statusdan periksa barisAPI key.ANTHROPIC_API_KEYyang 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 ulangclaude. Jalankan/loginjika 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. Press Enter to retry. dan mencoba ulang dapat berhasil. Sebelum v2.1.216, Claude Code menampilkan bentuk generik untuk setiap kegagalan.
Jika Anda menghapus batas, bentuk generik dimulai dengan Could not remove your spend limit pada v2.1.327 atau yang lebih baru.
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
Error autentikasi
Error berikut berarti Claude Code tidak dapat membuktikan identitas Anda kepada API. Jalankan/status kapan saja untuk melihat kredensial mana yang sedang aktif.
Not logged in
Tidak ada kredensial valid yang tersedia untuk sesi ini.Authentication required · Sign in again to continue, dan Anda masuk kembali dari aplikasi tersebut.
Jika Anda masuk dengan akun claude.ai Anda di jendela Claude Code lain yang menggunakan direktori konfigurasi yang sama, sesi interaktif yang menampilkan pesan ini akan mulai menggunakan login tersebut dengan sendirinya. Anda tidak perlu memulainya ulang.
Sebelum v2.1.286 di macOS, sesi dapat terus menampilkan pesan tersebut setelah Anda masuk dari jendela lain. Pada versi tersebut, mulai ulang sesi yang menampilkan pesan itu.
Yang perlu dilakukan:
- Jalankan
/loginuntuk mengautentikasi dengan langganan Claude atau akun Console Anda - Jika Anda mengharapkan environment variable yang mengautentikasi Anda, pastikan
ANTHROPIC_API_KEYtelah diatur dan diekspor di shell tempat Anda menjalankanclaude - Untuk CI atau otomatisasi yang tidak memungkinkan login interaktif, konfigurasikan skrip
apiKeyHelperyang mengambil kunci saat startup - Jika job
claude -pkeluar dengan pesan ini ketika seseorang masuk kembali ke akun dan organisasi claude.ai yang sama, perbarui Claude Code di tempat proses masuk tersebut dijalankan. Sebelum v2.1.318, Claude Code menghapus login tersimpan selama proses masuk tersebut, sebelum menyimpan login yang baru. - Lihat Prioritas autentikasi untuk memahami kredensial mana yang digunakan Claude Code ketika terdapat beberapa kredensial
Could not resolve authentication method
Sesi mencapai klien API tanpa kredensial apa pun. Sesi latar belakang dan sesi cloud menampilkan pesan ini ketika worker dimulai tanpa kredensial. Eksekusi interaktif,-p, dan Agent SDK melaporkan kondisi yang sama sebagai Not logged in dan menulis string ini hanya ke log debug mereka, jadi jika Anda menemukannya di sana, ikuti entri tersebut.
- Upgrade ke v2.1.176 atau lebih baru jika pesan ini muncul di sesi latar belakang atau sesi cloud dan kredensial Anda sudah dikonfigurasi
- Pastikan
ANTHROPIC_API_KEY,CLAUDE_CODE_OAUTH_TOKEN, atau kredensial penyedia cloud Anda diatur di lingkungan yang menjalankan worker, bukan hanya di shell interaktif Anda - Untuk Agent SDK, lihat pengaturan autentikasi di mulai cepat
- Jalankan
/statusdalam sesi interaktif di lingkungan yang sama untuk memastikan sumber kredensial mana yang digunakan
Invalid API key
Environment variableANTHROPIC_API_KEY atau skrip apiKeyHelper mengembalikan kunci yang ditolak oleh API, atau Claude Code memblokir kunci dari ANTHROPIC_API_KEY sebelum mengirimkannya.
Fix external API key dengan deskripsi seperti Invalid X-Api-Key header value from ANTHROPIC_API_KEY: it contains a line break at character 41 (120 characters on 2 lines)., API tidak pernah melihat kunci tersebut. Claude Code menemukan karakter yang tidak dapat dibawa oleh header HTTP dan menghentikan permintaan sebelum mengirimkannya. Lihat Invalid request header value untuk cara membaca deskripsi dan memperbaiki nilainya.
Yang perlu dilakukan:
- Periksa kesalahan ketik dan pastikan kunci belum dicabut di Console
- Di shell yang sama, jalankan
env | grep ANTHROPIC, atau di PowerShellGet-ChildItem Env:ANTHROPIC*. Alat seperti direnv, plugin shell dotenv, dan terminal IDE dapat memuat kunci usang dari file.envdi proyek Anda tanpa Anda mengaturnya secara eksplisit. - Hapus pengaturan
ANTHROPIC_API_KEYdan jalankan/loginuntuk menggunakan autentikasi langganan sebagai gantinya - Jika kunci berasal dari skrip
apiKeyHelper, jalankan skrip secara langsung untuk memastikan skrip mencetak kunci yang valid ke stdout - Jalankan
/statusuntuk memastikan sumber kredensial mana yang sebenarnya digunakan Claude Code
Your apiKeyHelper script is failing
Claude Code menjalankan perintah di pengaturanapiKeyHelper Anda dan tidak mendapatkan kunci kembali. Tanpa kunci, permintaan mencapai API dengan kredensial placeholder, dan API menolaknya dengan 401. Panel Authentication di terminal menunjukkan mana yang terjadi di antara hal berikut:
- Perintah keluar dengan error atau mengalami timeout
- Perintah tidak mencetak apa pun ke stdout
- Perintah mencetak sesuatu selain kunci, seperti banner login atau baris log. Panel menampilkan
returned output that cannot be used as an API keydan menyebutkan masalahnya, tanpa mengulang output tersebut. Sebelum v2.1.227, Claude Code mengirimkan apa pun yang dicetak perintah, setelah memangkas spasi di sekitarnya.
apiKeyHelper failed:.
Claude Code menjalankan ulang skrip dan mencoba ulang permintaan hingga dua kali lagi sebelum menampilkan pesan ini, sehingga kegagalan muncul dalam tiga percobaan. Sebelum v2.1.208, Claude Code menghabiskan seluruh anggaran retry untuk mengirim ulang permintaan dengan kredensial placeholder, lalu melaporkan error autentikasi 401 generik alih-alih kegagalan skrip.
Menjalankan /login tidak membantu di sini: output helper diutamakan daripada login tersimpan selama pengaturan tersebut ada.
Yang perlu dilakukan:
- Jalankan perintah yang dikonfigurasi di
apiKeyHelpersecara 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 secrets vault Anda
- Perbaiki perintah agar hanya mencetak kunci ke stdout, sebagai satu token ASCII yang dapat dicetak dengan panjang hingga 16.384 karakter, dan keluar dengan exit code 0. Lihat rotasi kredensial dengan apiKeyHelper untuk pengaturan yang berfungsi.
- Jalankan
/statusuntuk melihat kegagalan dan memastikanapiKeyHelperadalah sumber kredensial yang aktif. BarisapiKeyHelpermenampilkanFailingbeserta detail kegagalan terakhir, seperti exit code dan output error perintah, dan menghilang setelah eksekusi berikutnya berhasil. Sebelum v2.1.274,/statushanya menampilkan sumber kredensial, bukan kegagalannya. - Setiap kali perintah gagal, exit code dan output error-nya juga muncul di panel
Authenticationdi terminal. Sebelum v2.1.212, panel tersebut berjudulCloud authentication.
Claude Code didn’t send your claude.ai login
Pesan-pesan ini berarti Claude Code menolak permintaan Anda dan tidak mengirimkan login claude.ai Anda:Your organization's settings need an update: minta administrator Anda untuk memperbaiki konfigurasi API key helper- Untuk memberi tahu administrator Anda sumber terkelola mana yang ada di mesin Anda, jalankan
/statusdi prompt Claude Code dan salin barisSetting sources. Jika muncul barisSkipped sources, salin juga baris tersebut - Jika Anda mengelola pengaturan dan helper berada di file pengaturan terkelola mesin atau kebijakan MDM, lihat When a machine’s
apiKeyHelperisn’t in effect
- Untuk memberi tahu administrator Anda sumber terkelola mana yang ada di mesin Anda, jalankan
Couldn't load your organization's settings: periksa koneksi Anda, lalu mulai ulang Claude Code. Jika pesan muncul kembali setelah memulai ulang, beri tahu administrator AndaRestart Claude Code to finish signing in: mulai ulang Claude Code
Claude Code didn't send your claude.ai login.
Invalid request header value
Nilai yang akan dikirim Claude Code sebagai header permintaan mengandung karakter yang tidak dapat dibawa oleh header HTTP: pemisah baris, byte NUL, atau karakter di atasU+00FF, seperti tanda kutip melengkung atau spasi lebar-nol. Claude Code menghentikan permintaan sebelum apa pun dikirim dan menyebutkan variabel atau pengaturan yang perlu diperbaiki. Penyebab umumnya adalah kredensial yang ditempel dari dokumen atau obrolan yang membawa karakter tak terlihat atau pemisah baris yang tidak disengaja.
Claude Code menjalankan pemeriksaan ini ketika mengirim permintaan ke Claude API secara langsung atau melalui LLM gateway. Pada penyedia cloud pihak ketiga seperti Amazon Bedrock, Claude Code tidak menjalankannya sebelum mengirim.
Invalid auth token: bearer token dariANTHROPIC_AUTH_TOKENatauCLAUDE_CODE_OAUTH_TOKENInvalid ANTHROPIC_CUSTOM_HEADERS: nama atau nilai header yang Anda atur diANTHROPIC_CUSTOM_HEADERS. Deskripsi menghitung pasanganName: Valuemana yang bermasalah, sepertidistinct header 2 of 3 parsed from ANTHROPIC_CUSTOM_HEADERS, tanpa mengulang nama atau nilainya, karena Anda yang memilih keduanya.Invalid request header from the environment: nilai yang disalin Claude Code ke header permintaan dari environment variable lain, sepertiCLAUDE_AGENT_SDK_CLIENT_APP. Deskripsi menyebutkan variabel yang perlu diperbaiki.
ANTHROPIC_API_KEY yang salah yang tertangkap oleh pemeriksaan ini sebagai Invalid API key, dengan deskripsi penutup yang sama. Claude Code melaporkan kredensial /login tersimpan yang salah sebagai Not logged in; jalankan /login untuk menyimpan kredensial baru. Output skrip apiKeyHelper tidak pernah mencapai pemeriksaan ini: Claude Code memvalidasinya saat skrip berjalan, dan output yang tidak dapat dibawa oleh header HTTP gagal dengan Your apiKeyHelper script is failing.
Setelah · kedua, pesan menjelaskan masalahnya, seperti pada contoh lengkap berikut:
a non-ASCII character.
Yang perlu dilakukan:
- Atur ulang variabel atau pengaturan yang disebutkan pesan, ketik ulang karakter di sekitar posisi yang dilaporkan alih-alih menempelkannya lagi dari sumber yang sama
- Untuk
ANTHROPIC_CUSTOM_HEADERS, pertahankan satu pasanganName: Valueper baris dan tulis ulang pasangan yang dihitung oleh pesan - Jalankan
/statusuntuk memastikan sumber kredensial mana yang aktif
This organization has been disabled
Claude Code menggunakanANTHROPIC_API_KEY usang dari organisasi Console yang dinonaktifkan. Ketika Anda memiliki login langganan tersimpan, kunci tersebut menimpanya.
· bergantung pada kredensial tersimpan Anda: bentuk pertama muncul ketika /login yang tersimpan dapat mengambil peran setelah Anda menghapus pengaturan kunci, dan bentuk kedua ketika kunci tersebut adalah satu-satunya kredensial Anda.
Jika Anda mengekspor kunci di profil shell Anda atau memuatnya dari .env, Claude Code menggunakannya alih-alih /login, bahkan dengan langganan Pro, Max, atau Ultra yang berfungsi. Dalam mode non-interaktif (-p), kunci selalu digunakan jika ada.
Yang perlu dilakukan:
- Hapus pengaturan
ANTHROPIC_API_KEYdi shell saat ini dan hapus dari profil shell Anda, lalu jalankan ulangclaude - Jika pesan menyebutkan
Update or unset, Anda tidak memiliki login tersimpan sebagai cadangan. Hapus pengaturan kunci dan jalankan/login, atau ganti kunci dengan kunci dari organisasi Console yang aktif. - Jalankan
/statussetelahnya untuk memastikan kredensial aktif adalah langganan Anda - Jika tidak ada environment variable yang diatur dan error tetap muncul, hubungi dukungan atau masuk dengan akun lain.
Your organization has disabled API key authentication
Pesan ini memerlukan Claude Code v2.1.169 atau lebih baru. Admin organisasi Console Anda telah menonaktifkan autentikasi kunci API, sehingga API menolak kunci yang dikirim Claude Code. Petunjuk pemulihan setelah· bervariasi tergantung asal kunci:
apiKeyHelper diutamakan daripada /login, sehingga menjalankan /login saja tidak membantu selama salah satunya masih menyediakan kunci. Lihat Prioritas autentikasi.
Yang perlu dilakukan:
- Jika pesan menyebutkan
ANTHROPIC_API_KEY, hapus pengaturannya di shell saat ini dan hapus dari profil shell atau file.envAnda, lalu jalankan ulangclaude - Jika pesan menyebutkan
apiKeyHelper, hapus pengaturanapiKeyHelperdarisettings.jsonAnda - Jalankan
/loginuntuk masuk dengan akun claude.ai Anda - Jalankan
/statussetelahnya untuk memastikan kredensial aktif adalah langganan Anda, bukan kunci API - Jika Anda memerlukan autentikasi kunci API untuk otomatisasi, minta admin organisasi Anda untuk mengaktifkannya kembali di Console
Your organization has disabled Claude subscription access
Organisasi Claude Anda tidak mengizinkan masuk ke Claude Code dengan login langganan. Menjalankan/login lagi dengan akun yang sama akan menghasilkan error yang sama.
-p menampilkan ini sebagai kode error oauth_org_not_allowed.
Yang perlu dilakukan:
- Minta admin Anda untuk mengaktifkan akses Claude Code bagi organisasi Anda
- Autentikasi dengan kunci API Console alih-alih langganan Anda. Lihat Autentikasi Claude Console untuk pengaturannya.
- Jika Anda adalah admin dan tidak melihat opsi untuk mengaktifkan akses, hubungi dukungan Anthropic
Scheduled tasks are off for your organization
Tugas terjadwal cloud dinonaktifkan untuk organisasi Anda, sehingga Anda tidak dapat membuat atau menjalankannya. Pesan dari claude.ai menyebutnya scheduled tasks atau routines, dan diikuti kalimat tentang admin Anda:- Tanyakan kepada Owner Team atau Enterprise Anda apakah mereka dapat mengaktifkan toggle berlabel Scheduled tasks (Was Routines) atau Routines di Organization settings > Capabilities > Remote sessions
Remote Control requires the Anthropic API
Sesi tidak berkomunikasi langsung dengan Anthropic API, yang diperlukan oleh Remote Control.- Variabel penyedia
CLAUDE_CODE_USE_*, sepertiCLAUDE_CODE_USE_BEDROCKuntuk Amazon Bedrock atauCLAUDE_CODE_USE_VERTEXuntuk Agent Platform Google Cloud ANTHROPIC_BASE_URLyang mengarah ke host selainapi.anthropic.com, seperti LLM gateway atau proxy, bahkan ketika Anda masuk dengan claude.ai; sebelum v2.1.196, base URL kustom tidak memblokir Remote ControlANTHROPIC_UNIX_SOCKETdiatur, sehingga sesi mengirim permintaannya melalui socket lokal alih-alih keapi.anthropic.com- Proses masuk cloud gateway enterprise yang dilakukan melalui
/login, yang tidak mendukung Remote Control dan tidak memiliki variabel untuk dihapus pengaturannya
- Hapus pengaturan variabel yang disebutkan pesan, seperti
CLAUDE_CODE_USE_BEDROCKatauANTHROPIC_BASE_URL, dan mulai ulang sesi, atau mulai Remote Control dari sesi yang berkomunikasi langsung dengan Anthropic API - Jika variabel tidak diatur di shell Anda, periksa kunci
envdi file pengaturan Anda, yang menerapkan environment variable ke setiap sesi - Untuk pesan ini dan pesan startup Remote Control lainnya, lihat Pemecahan masalah Remote Control
Remote Control couldn’t refresh your login
Claude Code menjalankan koneksi Remote Control aktif dengan kredensial berumur pendek yang diperoleh dan diperbaruinya menggunakan login claude.ai tersimpan Anda. Ketika claude.ai berhenti menerima login tersebut, atau Claude Code tidak lagi memiliki login tersimpan, Claude Code menghentikan Remote Control dan memerlukan Anda untuk masuk kembali. Kedua kegagalan dapat terjadi saat Claude Code masih menghubungkan atau kemudian, saat memperbarui kredensial. Ketika Claude Code meminta layanan login untuk me-refresh login tersimpan Anda dan tidak mendapat jawaban, Claude Code tetap menjalankan Remote Control dan mencoba refresh lagi selama kredensial koneksi saat ini masih valid. Refresh tidak mendapat jawaban ketika Claude Code tidak dapat menjangkau layanan login, permintaan mengalami timeout, atau layanan gagal tanpa menolak login Anda. Jika layanan login masih belum menjawab saat kredensial tersebut kedaluwarsa, Claude Code menghentikan Remote Control dan melaporkanOAuth token refresh failed.
Ketika Claude Code menghentikan Remote Control, Claude Code menampilkan alasannya dalam peringatan dan dalam baris transkrip yang diawali dengan Remote Control disconnected. Sesi lokal Anda tetap berjalan tanpa Remote Control. Bagian ini mencakup baris-baris berikut:
Claude.ai login expireddanClaude.ai login was rejected: claude.ai tidak lagi menerima token login tersimpan Anda, karena token tersebut kedaluwarsa atau dicabutOAuth token unavailable: Claude Code tidak memiliki token login tersimpan ketika kredensial koneksi sudah waktunya diperbaruiOAuth token refresh failed: claude.ai menolak token login tersimpan Anda saat Claude Code sedang menghubungkan ulang, dan me-refresh token tidak menghasilkan token baruJWT refresh failed: no OAuth token: Claude Code tidak menemukan token login tersimpan untuk melakukan pembaruanSigned out of Claude: Anda keluar di mesin ini, misalnya dengan menjalankan/logoutdi terminal lain, sehingga Claude Code tidak lagi memiliki login tersimpan untuk memperbarui koneksi
- Jalankan
/loginuntuk masuk kembali - Jalankan
/remote-controluntuk menghubungkan ulang sesi. Pesan yang diakhiri denganrun /login to restore Remote Controltidak memerlukan langkah ini: Claude Code terhubung ulang dengan sendirinya setelah Anda masuk.
OAuth token refresh failed — run /login to re-authenticate berbunyi OAuth token refresh failed — re-authenticate, then re-enable Remote Control, dan JWT refresh failed: no OAuth token — run /login berbunyi no OAuth token available for recovery (code <N>). Pesan Claude.ai login expired, Claude.ai login was rejected, dan OAuth token unavailable ditambahkan di v2.1.225.
Sebelum v2.1.238, Claude Code melaporkan kasus yang sekarang menyebutkan 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 refresh login tidak mendapat jawaban.
Remote Control could not renew this computer’s connection
Peringatan ini muncul di terminal yang menjalankanclaude remote-control ketika server tidak dapat menggunakan login claude.ai Anda untuk memperbarui kredensial koneksinya sebelum kedaluwarsa. Kalimat terakhir peringatan menyebutkan berapa lama kredensial saat ini masih berfungsi, atau bahwa kredensial tersebut sudah kedaluwarsa:
- Jika peringatan meminta Anda menjalankan
claude /login, buka terminal lain di mesin yang menjalankan server, jalankanclaude /logindi sana, dan masuk dengan akun claude.ai Anda - Jika server masih tidak dapat masuk setelah kredensial koneksi kedaluwarsa, server mencetak kesalahan yang berisi
Poll: Authentication failed (401)dan berhenti. Masuk kembali seperti yang disebutkan dalam kalimat kedua peringatan, lalu jalankanclaude remote-controllagi di terminal tempat server berhenti.
Remote Control stopped because the signed-in account changed
Claude Code menampilkan baris ini selama sesi Remote Control ketika Anda masuk ke akun atau organisasi claude.ai yang berbeda di mesin ini. Anda melakukan pergantian tersebut di luar sesi Claude Code, misalnya dengan menjalankan/login di terminal lain.
Sesi Remote Control yang Anda mulai saat masuk melalui /login menjadi milik akun dan organisasi claude.ai yang sedang masuk pada saat itu.
- Jalankan
/remote-controluntuk memulai sesi Remote Control baru di bawah akun atau organisasi saat ini - Untuk beralih kembali, jalankan
/logindan masuk kembali ke akun atau organisasi sebelumnya. Kemudian jalankan/remote-control.
Remote Control server rejected the request (HTTP 404). Kegagalan tersebut dapat terjadi berjam-jam setelah pergantian.
Remote Control stopped because the app running the session signed out or switched accounts
Ketika aplikasi desktop Claude atau IDE menjadi host sesi Anda, Claude Code mendapatkan token login-nya dari aplikasi tersebut, bukan dari/login. Ketika claude.ai menolak token tersebut, Claude Code meminta token baru dari aplikasi. Jika aplikasi menjawab bahwa aplikasi telah keluar, atau bahwa aplikasi kini masuk ke akun Claude yang berbeda, Claude Code mengakhiri sesi Remote Control dan mengirimkan salah satu baris berikut ke aplikasi:
- Jika aplikasi telah keluar, masuk kembali ke aplikasi tersebut, lalu aktifkan kembali Remote Control di aplikasi
- Jika aplikasi beralih akun, Claude Code tidak dapat melanjutkan sesi yang telah berakhir di bawah akun baru. Mulai sesi Remote Control baru di bawah akun tersebut.
run /login yang tercantum di bagian Remote Control couldn’t refresh your login ke aplikasi dalam kedua kasus.
OAuth token revoked or expired
Login tersimpan Anda tidak lagi valid. Token yang dicabut berarti Anda keluar di semua tempat atau admin menghapus akses; token yang kedaluwarsa berarti refresh otomatis gagal di tengah sesi. Kedua pesan melaporkan penolakan yang dikembalikan API untuk permintaan yang dikirim Claude Code. Ketika login tersimpan sudah dihapus setelah pembaruan yang gagal, lihat Login expired. Jika Anda melakukan autentikasi dengan token berumur panjang diCLAUDE_CODE_OAUTH_TOKEN, Anda melihat pesan yang sama ketika token tersebut kedaluwarsa atau dicabut.
-p) dan Agent SDK, pesannya berbunyi sebagai berikut, dan kode error terstrukturnya adalah authentication_failed:
Your account does not have access to Claude. Please login again or contact your administrator.
Yang perlu dilakukan:
- Jalankan
/logindi prompt Claude Code untuk masuk kembali - Jika perintah
-patau program Agent SDK Anda menggunakan login tersimpan, jalankanclaudedi lingkungan yang sama, selesaikan/login, lalu jalankan perintah atau program tersebut lagi. Untuk otomatisasi yang tidak dapat masuk secara interaktif, autentikasi denganANTHROPIC_API_KEYatau buat token berumur panjang denganclaude setup-token. - Jika Anda mengautentikasi dengan environment variable
CLAUDE_CODE_OAUTH_TOKEN, Claude Code terus mengirimkan nilai yang Anda atur setelah permintaan gagal dengan 401, alih-alih beralih ke token dari login tersimpan./statusmenampilkan kredensial ini sebagai barisAuth tokenyang berbunyiCLAUDE_CODE_OAUTH_TOKEN. Buat token baru denganclaude setup-tokendan mulai ulang dengan token tersebut, atau hapus pengaturan variabel dan jalankan/login. Sebelum v2.1.225, Claude Code dapat mengganti nilai variabel di tengah sesi dengan token akses berumur pendek dari login tersimpan, dan sesi kembali gagal dengan error 401 setelah token tersebut kedaluwarsa. - Untuk permintaan masuk yang berulang di setiap peluncuran, lihat pemeriksaan jam sistem dan langkah pemulihan penyimpanan kredensial macOS di Pemecahan masalah
- Untuk kegagalan lain termasuk
403 Forbiddendan masalah browser OAuth, lihat Login dan autentikasi
API Error: 401 Invalid authentication credentials
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, sehingga token yang kedaluwarsa bukanlah penyebabnya. Kredensial tersebut dapat berupa login tersimpan Anda atauANTHROPIC_API_KEY yang disetujui, dan perbaikannya berbeda, jadi mulailah dengan menjalankan /status untuk melihat mana yang aktif.
- Jika
/statusmenampilkan barisAPI keyyang tidak ditandai sebagai tidak digunakan,ANTHROPIC_API_KEYyang disetujui adalah kredensial aktif dan diutamakan daripada login Anda, sehingga/logintidak menggantikannya. Rotasi kunci di Claude Console, atau kembali ke langganan Anda dengan menjalankanunset ANTHROPIC_API_KEY, atau di PowerShellRemove-Item Env:ANTHROPIC_API_KEY. - Jika
/statushanya menampilkan login Anda, jalankan/loginsekali. Jika kredensial telah dicabut, login baru akan menggantikannya. - Jika pesan yang sama muncul kembali untuk akun login yang sama, akun atau organisasi tersebut tidak lagi aktif. Periksa akun dan organisasi yang dilaporkan
/status, dan minta admin organisasi Anda untuk memulihkan akses. - Jika
ANTHROPIC_BASE_URLmengarah ke LLM gateway, teks setelah401adalah pesan dari gateway Anda, bukan dari Anthropic, dan/logintidak mengubahnya. Perbaiki kredensial yang diharapkan gateway Anda sebagai gantinya. - Jika setiap permintaan gagal dengan
401setelah gateway Anda memiliki kredensial yang diharapkannya, periksa bahwa gateway dan upstream-nya menerima field tool search. Secara default, Claude Code mengirim field tooldefer_loadingdan bloktool_reference, dengan headeranthropic-betayang mengaktifkannya. Sebelum v2.1.304, tool search dinonaktifkan di balik gateway kecuali Anda mengaktifkannya denganENABLE_TOOL_SEARCH.
Login expired
Claude Code mencoba memperbarui login claude.ai tersimpan Anda dan layanan OAuth menolak refresh token yang tersimpan, sehingga Claude Code menghapus kredensial yang tersimpan. Tanpa kredensial tersimpan lainnya, permintaan model kemudian berhenti dengan pesan ini:-p) dan Agent SDK, pesannya berbunyi sebagai berikut, dan kode error terstrukturnya adalah authentication_failed:
reached its time limit pada Claude Code v2.1.318 atau yang lebih baru. Untuk pesan Login expired yang diakhiri dengan or re-authenticate your Anthropic profile, lihat Anthropic profile login expired.
Ketika pembaruan gagal karena akun itu sendiri ditangguhkan, Claude Code menampilkan Your account is on hold.
Yang perlu dilakukan:
- Jalankan
/loginuntuk masuk kembali. - Jika Anda masuk dengan akun claude.ai Anda di jendela Claude Code lain, lihat Not logged in untuk mengetahui kapan sesi ini mulai menggunakan login tersebut dengan sendirinya.
- Dalam mode non-interaktif, jalankan
claudedi lingkungan yang sama, selesaikan/login, lalu jalankan ulang perintah Anda. Untuk otomatisasi yang tidak dapat masuk secara interaktif, autentikasi denganANTHROPIC_API_KEYatau buat token berumur panjang denganclaude setup-token. - Jika proses masuk terus gagal, lihat Login dan autentikasi
Could not refresh your login because another Claude Code process is refreshing it
Pesan ini tidak berarti login Anda ditolak. Login claude.ai tersimpan Anda telah kedaluwarsa dan perlu diperbarui. Proses Claude Code lain di mesin yang sama memegang kunci refresh bersama, atau keluar dan meninggalkannya, dan refresh tidak mengalami kemajuan selama sesi ini menunggu. Claude Code menghentikan permintaan sebelum mengirimkannya:-p) dan Agent SDK, pesannya berbunyi sebagai berikut, dan kode error terstrukturnya adalah server_error:
- Coba lagi dalam satu menit. Jika proses lain menyelesaikan refresh terlebih dahulu, sesi ini menggunakan login yang telah diperbarui.
- Jika pesan terus muncul, tutup jendela dan proses Claude Code lainnya, lalu coba lagi.
- Jika pesan muncul tanpa ada proses Claude Code lain yang berjalan, jalankan
/login. Masuk kembali tidak menunggu kunci refresh.
Could not refresh your login: the disk that holds the Claude Code config directory is full
Kosongkan ruang pada disk yang menyimpan direktori konfigurasi Claude Code, lalu kirim pesan Anda lagi. Masuk kembali tidak akan membantu selama disk penuh, karena login baru tidak dapat disimpan. Direktori konfigurasi adalah~/.claude di direktori home Anda kecuali Anda mengatur CLAUDE_CONFIG_DIR.
-p) dan Agent SDK, pesannya berbunyi:
- Untuk skrip, jalankan ulang perintah
claude -p-nya - Jika disk sudah menunjukkan ruang kosong, kehabisan kuota disk atau inode menghasilkan pesan yang sama. Hapus file milik Anda sendiri di disk tersebut. Jika pesan muncul kembali, hapus banyak file kecil alih-alih beberapa file besar, karena setiap file memakan satu inode berapa pun ukurannya.
Couldn’t save your login
Anda masuk dengan claude.ai, tetapi Claude Code tidak dapat menyimpan login ke penyimpanan kredensialnya, sehingga login tidak selesai. Di macOS, hal ini dapat terjadi ketika login keychain terkunci, misalnya saat sleep atau idle, setelah Claude Code sudah membaca atau menyimpan kredensial di dalamnya selama sesi yang sama.- Di macOS, buka kunci login keychain, lalu jalankan
/loginlagi - Di platform lain, jalankan
/loginlagi - Jika login masih tidak tersimpan, lihat Not logged in or token expired untuk perintah membuka kunci keychain dan langkah pemulihan penyimpanan kredensial lainnya
Sign in again to take your previous account or API key off the config file
Peringatan ini setelah Anda masuk berarti akun apa pun yang sebelumnya Anda gunakan untuk masuk mungkin masih tersimpan di~/.claude.json:
~/.claude.json jika login Console membuatnya di Linux atau Windows.
Yang perlu dilakukan:
- Jalankan
claude auth logindi shell Anda untuk masuk kembali. Claude Code kemudian mencoba ulang penyimpanan yang menghapus akun atau kunci API yang diganti dari file tersebut.
Your account or API key may still be in the config file
Anda menjalankan/logout atau claude auth logout, dan Claude Code mengeluarkan proses ini tetapi tidak dapat memastikan bahwa ~/.claude.json tidak lagi menyimpan akun Anda. Entah penyimpanan tidak berhasil, atau file tidak dapat dibaca kembali untuk diperiksa.
~/.claude.json jika login Console membuatnya di Linux atau Windows.
Yang perlu dilakukan:
- Jalankan
claude auth logoutdi shell Anda untuk mencoba menyimpan lagi. Ketika penyimpanan berhasil, perintah mencetakSuccessfully logged out from your Anthropic account.
Couldn’t start the local listener that receives the browser sign-in
Masing-masing pesan ini dari/login, claude auth login, atau claude setup-token berarti Claude Code tidak dapat membuka port di 127.0.0.1 tempat browser Anda mengembalikan hasil masuk.
Dengan pemberitahuan yang diawali The browser can't return the sign-in to Claude Code automatically, proses masuk berlanjut tanpa port tersebut. Tidak ada browser yang terbuka, dan pemberitahuan muncul di atas URL tempat Anda masuk sebagai gantinya:
Couldn't start the local listener, proses masuk berhenti. Hal ini terjadi, misalnya, ketika Anda mem-pipe input ke claude auth login:
The browser can't return the sign-in to Claude Code automatically: Anda tidak perlu memperbaiki apa pun terlebih dahulu. Buka URL yang ditampilkan di bawah pemberitahuan di browser dan masuk. Browser kemudian menampilkan kode: tempelkan ke Claude Code di promptPaste code here >, dan proses masuk berlanjut dari sana.Couldn't start the local listener that receives the browser sign-in: jalankan perintah yang sama lagi. Jika berhenti dengan cara yang sama, masuk dengan token atau kunci API alih-alih browser. Atau, jika Anda mem-pipe input keclaude auth login, jalankan di terminal agar dapat menerima kode yang ditempel.- Untuk masuk dengan token atau kunci API alih-alih browser: jika Anda menggunakan langganan claude.ai, jalankan
claude setup-tokendi mesin tempat proses masuk berfungsi. Kemudian atur token yang dicetaknya sebagai environment variableCLAUDE_CODE_OAUTH_TOKENdi mesin ini. Jika tidak, atur environment variableANTHROPIC_API_KEYke kunci dari Claude Console. Prioritas autentikasi menjelaskan bagaimana Claude Code memilih di antara kredensial. - Untuk mengembalikan pengembalian browser otomatis: Claude Code harus dapat mendengarkan di
127.0.0.1. Jika berjalan di dalam sandbox, periksa apakah kebijakan sandbox mengizinkan mendengarkan di port lokal, lalu masuk kembali. Jika mendengarkan seharusnya berfungsi di sana dan pemberitahuan masih muncul, jalankan/feedbackagar laporan menyertakan detail lingkungan Anda.
Failed to start OAuth callback server: Failed to start server. Is port 0 in use?. Pada versi-versi tersebut, perbarui Claude Code dan masuk kembali, atau masuk dengan token atau kunci API alih-alih browser.
Claude login not accepted
Anda mencoba memulai sesi cloud, dan server menolak membuatnya dengan 401: server tidak menerima login Claude yang dikirim mesin ini, biasanya karena login telah kedaluwarsa atau dicabut. Bagian pertama baris tersebut adalah alasan dari server sendiri jika server memberikannya. Jika tidak, barisnya berbunyi:- Jalankan
/login, selesaikan proses masuk, lalu mulai sesi lagi
Artifacts need a claude.ai login
Claude Code menolak publikasi atau pembacaan artifact karena sesi tidak memiliki login claude.ai yang dapat digunakan untuk artifact. Setiap bentuk pesan diawali dengan kata-kata yang sama, diikuti solusi yang bergantung pada cara sesi Anda diautentikasi. Tanpa kredensial yang bersaing, pesannya berbunyi:- Jalankan
/logindan pilih Claude account with subscription. Opsi Anthropic Console account tidak menyediakan kredensial claude.ai. - Ketika pesan menyebutkan kredensial yang diutamakan, seperti
ANTHROPIC_API_KEY, pengaturanapiKeyHelper, atau kunci Console yang disimpan oleh/loginsebelumnya, hapus kredensial tersebut sesuai petunjuk pesan, lalu jalankan/login - Ketika pesan menyebutkan bahwa sesi jarak jauh ini diautentikasi melalui mesin yang meluncurkannya, masuk ke claude.ai di mesin tersebut, lalu hubungkan ulang sesi
- Ketika pesan menyebutkan bahwa kredensial disuntikkan oleh lingkungan host sesi, Anda tidak dapat mengubahnya dalam sesi tersebut; mulai sesi yang masuk ke claude.ai
- Lihat Ketersediaan untuk persyaratan artifact lainnya, seperti paket, penyedia model, dan kebijakan organisasi
Administrator policy requires a Cloud gateway sign-in
Pengaturan terkelola administrator di mesin ini mengaturforceLoginMethod ke "gateway" atau mengatur forceLoginGatewayUrl. Kecuali Anda memilih penyedia cloud melalui variabel seperti CLAUDE_CODE_USE_BEDROCK, Claude Code kemudian hanya menerima proses masuk Claude apps gateway. Anda akan melihat salah satu dari dua pesan:
/login sejak kebijakan diterapkan ke mesin.
Jika mesin juga menyimpan kredensial yang diterbitkan Anthropic dan pengaturan terkelola mengatur forceLoginMethod atau forceLoginOrgUUID, Claude Code keluar saat startup sebagai gantinya. Kredensial tersebut dapat berupa variabel ANTHROPIC_API_KEY atau ANTHROPIC_AUTH_TOKEN, pengaturan apiKeyHelper, atau kunci API yang disimpan oleh login Claude Console sebelumnya.
Pesan startup menyebutkan kredensial yang dikonfigurasi untuk sesi, tempat kredensial tersebut diatur, dan langkah untuk menghapusnya. Misalnya, dengan variabel ANTHROPIC_API_KEY yang diatur di shell Anda, pesannya berbunyi:
- Untuk
Not signed in to the Cloud gateway, jalankan/logindan selesaikan proses masuk di layar Cloud gateway - Untuk pesan startup, hapus kredensial dengan mengikuti langkah-langkah di akhir pesan
- Jika Anda yakin mesin tersebut seharusnya tidak memerlukan gateway, minta administrator yang mengelolanya untuk menghapus
forceLoginMethoddanforceLoginGatewayUrldari pengaturan terkelolanya
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. Jika Anda melihat kata-kata tersebut dan tidak dapat menentukan kredensial mana yang harus dihapus, perbarui ke v2.1.284 atau lebih baru dan mulai claude lagi.
Pada v2.1.265, sebuah regresi juga menampilkan pesan pertama di beberapa konfigurasi LLM gateway dan proxy yang diautentikasi dengan kunci API, apiKeyHelper, atau header kustom, bahkan tanpa persyaratan administrator di mesin. Perbarui ke v2.1.266 atau lebih baru. Anda tidak perlu mengubah konfigurasi Anda.
Sebelum v2.1.261, di mesin yang mengatur forceLoginMethod ke "gateway", Claude Code menggunakan login tersimpan yang tersisa alih-alih menggagalkan permintaan model, dan melaporkan kredensial lingkungan yang dikonfigurasi dengan This machine's managed settings require a first-party login alih-alih pesan startup.
Your account is on hold
Akun Claude di balik login Anda telah ditangguhkan. Claude Code menampilkan pesan pertama ketika mencoba memperbarui login tersimpan Anda dan mengetahui penangguhan tersebut, dan pesan kedua ketika proses masuk yang Anda selesaikan di browser melaporkannya:-p) dan Agent SDK, kode error terstrukturnya adalah account_on_hold. Sebelum v2.1.235, Claude Code melaporkan akun yang ditangguhkan sebagai Login expired · Please run /login, yang langkah pemulihannya tidak dapat menghapus penangguhan.
Yang perlu dilakukan:
- Buka tautan di pesan untuk melihat detail penangguhan atau mengajukan banding
- Jika Anda memiliki akun Claude lain atau kunci API yang tidak terpengaruh oleh penangguhan, Anda dapat terus bekerja selama penangguhan diselesaikan: jalankan
/logindengan akun tersebut, atau atur kunci denganANTHROPIC_API_KEY
Anthropic profile login expired
Claude Code melakukan autentikasi melalui profil kredensial Anthropic yang kredensial login tersimpannya telah kedaluwarsa, dan profil tersebut tidak menyimpan kredensial penyegaran yang dapat digunakan Claude Code untuk memperbaruinya. Claude Code menghentikan setiap permintaan secara lokal tanpa mencoba ulang.- Jika pesan diawali dengan
Login expired, jalankan/loginuntuk masuk kembali - Untuk memperbarui profil yang ditulis oleh login Console tanpa kunci atau
ant auth logindari Claude Platform CLI, jalankan/logindi mesin yang menawarkan login tanpa kunci. Pilih akun Anthropic Console, lalu Sign in with your Console account. Claude Code mengganti kredensial yang kedaluwarsa di profil tersebut - Untuk memperbarui profil yang dibuat oleh alat lain, masuk kembali dengan alat tersebut. Jika Anda memilih Sign in with your Console account di
/login, Claude Code membiarkan profil apa adanya dan membuat kunci API - Jika administrator yang menyediakan kredensial profil, minta mereka untuk menerbitkan kredensial baru
- Jalankan
/statusuntuk memastikan sumber kredensial aktif dan nama profil - Untuk berhenti menggunakan profil, hapus pengaturan
ANTHROPIC_PROFILEjika Anda mengaturnya, lalu autentikasi dengan cara lain, seperti/loginatauANTHROPIC_API_KEY
- Ketika Claude Code menemukan profil dari direktori konfigurasi Anda dan mode autentikasinya adalah
user_oauth, pesan diawali denganLogin expireddan menawarkan/loginterlebih dahulu. Claude Code memberikan prioritas kepada/loginyang berfungsi daripada profil yang ditemukan, lalu melakukan autentikasi dengan akun claude.ai Anda sebagai gantinya. Dari v2.1.234 hingga v2.1.277, bentuk ini berbunyiAnthropic profile login expired · Run /login to use your claude.ai account instead, or re-authenticate the profile. Sebelum v2.1.234, Claude Code juga menampilkan bentukRe-authenticate your Anthropic profiledalam kasus ini. - Ketika Anda memilih profil dengan
ANTHROPIC_PROFILE, pesan diawali denganAnthropic profile login expired.
ANTHROPIC_PROFILE, yang ditemukan Claude Code sebagai profil aktif di direktori konfigurasi Anthropic Anda, atau yang ditulis Claude Code ketika Anda masuk tanpa kunci API. Sesi yang diautentikasi dengan kunci API, bearer token seperti ANTHROPIC_AUTH_TOKEN, atau penyedia pihak ketiga tidak pernah melihat pesan ini.
OAuth scope requirement
Token yang tersimpan dibuat sebelum adanya scope izin yang dibutuhkan oleh fitur yang lebih baru:- Jalankan
/loginuntuk mendapatkan token baru dengan scope saat ini. Anda tidak perlu keluar terlebih dahulu.
claude.ai rejected the session token
Permintaan konektor claude.ai gagal karena claude.ai menolak token dari login Claude Code Anda. Token yang ditolak adalah login Anda, bukan otorisasi konektor itu sendiri di claude.ai, sehingga mengotorisasi konektor lagi tidak menyelesaikannya. Di/mcp, konektor ditampilkan sebagai session token rejected dan tampilan detailnya berbunyi:
- Jalankan
/loginuntuk masuk kembali - Hubungkan ulang konektor dari
/mcp, atau jalankan/mcp reconnect <server>. Menghubungkan ulang sebelum Anda masuk kembali akan membuat konektor tetap dalam kondisi yang sama. Opsi Reconnect di panel/mcpmelaporkanyour claude.ai session token was rejected; bentuk/mcp reconnect <server>yang diketik melaporkan penghubungan ulang yang berhasil meskipun token masih ditolak.
MCP server needs you to sign in again
Server MCP jarak jauh menolak kredensial pada panggilan tool di tengah sesi, biasanya karena proses masuk atau token telah kedaluwarsa atau karena token tidak memiliki izin yang dibutuhkan tool. Panggilan tool gagal, dan/mcp menandai server sebagai memerlukan autentikasi.
Untuk server yang Anda masuki dari Claude Code, termasuk konektor claude.ai, proses masuk telah kedaluwarsa atau dicabut:
/mcp, pilih server, dan masuk kembali dari menunya.
Untuk server yang dikonfigurasi dengan skrip headersHelper, Claude Code telah menjalankan ulang helper dan mencoba ulang panggilan sekali sebelum menampilkan ini:
/mcp, yang menjalankan helper lagi.
Untuk server dengan header Authorization statis di konfigurasinya:
/mcp.
Dalam sesi Cowork di mesin Anda pada aplikasi Claude Desktop, pesan-pesan ini berarti server MCP menolak kredensial yang diberikan kepadanya. Perbaiki kredensial yang disebutkan pesan, lalu mulai tugas atau obrolan baru di Cowork:
- Kredensial
headersHelperditolak: periksa apakah helper mengembalikan kredensial yang diterima server, lalu mulai tugas atau obrolan baru di Cowork - Header
Authorizationditolak: perbarui nilaiAuthorizationdi bawahheadersdalam konfigurasi server tersebut, lalu mulai tugas atau obrolan baru di Cowork
run /mcp to reconnect, meskipun /mcp tidak tersedia di sana. Jika Anda melihat akhiran tersebut di Cowork, tetap periksa helper atau perbarui header, lalu mulai tugas atau obrolan baru. Sebelum v2.1.273, kasus login kedaluwarsa, headersHelper, dan header Authorization semuanya menampilkan MCP server "<name>" requires re-authorization (token expired).
Server juga dapat menolak panggilan tool dengan HTTP 403 insufficient_scope untuk meminta Anda mengotorisasi suatu scope, terkadang scope yang sudah tercantum di token Anda. Pesan menyebutkan scope tersebut:
/mcp, pilih server, dan autentikasi kembali dari menunya.
Ketika konfigurasi server tidak mengatur oauth.scopes maupun authServerMetadataUrl, Claude Code meminta scope yang disebutkan server. Dengan salah satu pengaturan tersebut, Claude Code meminta scope dari pengaturan itu sebagai gantinya. Jika Anda menetapkan oauth.scopes, tambahkan scope yang hilang ke daftar tersebut sebelum Anda mengautentikasi kembali.
Sebelum v2.1.274, kasus ini menampilkan pesan needs you to sign in again, dan sebelum v2.1.273 menampilkan requires re-authorization (token expired) seperti kasus lainnya.
Couldn’t read the stored credentials for MCP server
Claude Code menyimpan proses masuk Anda untuk server MCP OAuth di penyimpanan kredensial. Pesan ini berarti Claude Code tidak dapat membaca penyimpanan tersebut, sehingga permintaan ke server tidak dijalankan:claude -p atau Agent SDK di macOS, keychain dapat menjadi terbaca setelah sebuah permintaan sudah terkirim tanpa proses masuk yang tersimpan. Permintaan tersebut gagal dengan:
-
Jika pesan meminta Anda membuka kunci keychain Mac Anda, jalankan
claude doctordi sesi shell tempat Anda menjalankan Claude Code, dan periksa laporannya untuk peringatan keychain:-
Jika laporan mencantumkan peringatan yang diawali dengan
macOS Keychain is not writable, atau shell Anda tidak memiliki perintahclaude, jalankan perintah buka kunci ini di sesi shell tersebut: - Jika laporan tidak mencantumkan peringatan keychain, lewati perintah buka kunci
-
Jika laporan mencantumkan peringatan yang diawali dengan
-
Coba lagi di tempat Anda melihat pesan tersebut:
- Untuk
claude -p, jalankan perintah lagi - Dalam sesi interaktif, hubungkan ulang server dari
/mcpjika server ditampilkan sebagai gagal di sana, lalu minta Claude untuk mencoba lagi - Dalam aplikasi Agent SDK yang terus berjalan, panggil
reconnectMcpServer()di TypeScript atauClaudeSDKClient.reconnect_mcp_server()di Python, atau mulai sesi baru
- Untuk
-
Jika server kemudian melaporkan bahwa server memerlukan autentikasi, Claude Code tidak menemukan proses masuk yang dapat digunakannya untuk server tersebut. Masuk secara interaktif: jalankan
/mcpdalam sesi Claude Code, atauclaude mcp login <name>di shell Anda. Dalam aplikasi Agent SDK, lihat Autentikasi OAuth2 di Agent SDK.
claude -p atau Agent SDK di Mac dengan login keychain yang terkunci melaporkan server sebagai memerlukan autentikasi alih-alih menampilkan salah satu pesan tersebut.
MCP server URL is missing or not a valid URL
Claude Code menolak memulai proses masuk OAuth untuk server MCP jarak jauh karenaurl yang dikonfigurasi untuk server tidak dapat diurai sebagai URL. Kecuali Claude Code memiliki masalah konfigurasi yang lebih spesifik untuk dilaporkan bagi server tersebut, menjalankan claude mcp login <name> di shell Anda mencetak penolakan sebagai:
- Atur
urlentri ke endpoint server yang sebenarnya di tempat server dikonfigurasi, atau atur environment variable yang disebutkan oleh referensi${VAR}miliknya, lalu jalankan proses masuk lagi.
Issuer mismatch in authorization response
Selama proses masuk OAuth MCP, server otorisasi mengarahkan kembali ke Claude Code dengan parameteriss yang tidak menyebutkan issuer yang diharapkan Claude Code dari metadata OAuth server. Issuer yang salah pada langkah ini merupakan ciri serangan mix-up server otorisasi, sehingga Claude Code menggagalkan proses masuk alih-alih menukar kode otorisasi. Claude Code menampilkan error di menu server /mcp setelah proses masuk browser:
expected adalah issuer dari metadata OAuth server, dan received adalah nilai iss yang dibawa redirect. Proses masuk yang redirect-nya tidak membawa parameter iss lolos pemeriksaan, kecuali metadata server mengatur authorization_response_iss_parameter_supported, dalam hal ini Claude Code menggagalkan proses masuk.
Yang perlu dilakukan:
- Coba proses masuk lagi dari
/mcp - Jika error berulang, laporkan ke operator server. Perbaikannya ada di sisi server: server otorisasi harus mengembalikan issuer yang sama di parameter
issdengan yang diiklankannya di metadata - Untuk terhubung selama server sedang diperbaiki, mulai Claude Code dengan
MCP_SDK_GENERATION=v1, yang runtime-nya tidak menjalankan pemeriksaan ini. Ini menghilangkan perlindungan terhadap serangan mix-up, jadi utamakan perbaikan di sisi server
MCP_SDK_GENERATION=v2.
Stopped an OAuth request
Pesan ini berarti Claude Code menghentikan permintaan OAuth untuk server MCP karena endpoint OAuth mengalihkannya. Dalam kedua bentuk pesan, alamat pertama adalah alamat yang mengirimkan pengalihan:- Minta siapa pun yang menjalankan alamat pertama, seperti operator server MCP, untuk menghapus atau memperbaiki pengalihan tersebut. Kemudian coba lagi dari
/mcp.
Refusing to send credentials to non-https token endpoint
Pada runtime v2, Claude Code mengirimkan permintaan token OAuth MCP hanya ke token endpoint yang dilayani melalui HTTPS atau dilocalhost, 127.0.0.1, atau ::1. Pesan ini berarti token endpoint server bukan keduanya, sehingga Claude Code berhenti sebelum mengirimkan permintaan. Hal itu terjadi setelah proses masuk browser, sehingga langkah browser berhasil terlebih dahulu, dan terjadi lagi setiap kali Claude Code me-refresh token server.
Dalam bentuk lengkapnya, pesan ini berasal dari MCP SDK dan mengutip token endpoint yang ditolaknya. Di log debug, pesan ini mengikuti Error during auth completion: untuk proses masuk atau Token refresh failed: untuk refresh. Di shell Anda, claude mcp login <name> mencetaknya setelah Couldn't complete authentication for "<name>":, dan dalam sesi, /mcp menampilkannya di bawah menu server:
io, diikuti oleh from the MCP SDK for dan URL server yang disamarkan. Error lain dari MCP SDK memiliki bentuk yang sama di sana. Pesan yang disamarkan dapat berupa error ini hanya ketika token endpoint server adalah http:// biasa di alamat selain localhost, 127.0.0.1, atau ::1.
Yang perlu dilakukan:
- Layani token endpoint tersebut melalui HTTPS, misalnya dengan menempatkan server di belakang reverse proxy atau tunnel yang mengakhiri TLS dan mengonfigurasi server untuk mengiklankan alamat
https:// - Untuk terhubung tanpa mengubah server, mulai Claude Code dengan
MCP_SDK_GENERATION=v1, yang runtime-nya tidak menerapkan aturan ini dan mengirimkan permintaan token melalui HTTP biasa. Pilihan tersebut berlaku hingga Anda keluar dan berlaku untuk setiap server. Runtime v1 juga melewati pemeriksaan issuer, jadi utamakan melayani endpoint melalui HTTPS
AWS credentials expired or invalid
Token sesi AWS Anda telah kedaluwarsa atau ditolak. Pesan ini muncul pada 401 dari Claude Platform on AWS atau endpoint Mantle, yang merupakan cara penyedia tersebut melaporkan token keamanan yang kedaluwarsa. Petunjuk tindakan di bagian tengah bervariasi sesuai pengaturan Anda. Bagian yang tetap adalah awalanAWS credentials expired or invalid:
awsAuthRefresh dikonfigurasi.
Yang perlu dilakukan:
- Jika petunjuk menyebutkan bahwa kredensial dikelola oleh lingkungan ini, aplikasi yang meluncurkan Claude Code memiliki kredensial tersebut dan langkah lain di sini tidak berlaku: coba lagi, atau hubungi administrator Anda
- Jika
awsAuthRefreshdiatur, jalankan perintah yang disebutkan dalam pesan, sepertiaws sso login --profile myprofile, di terminal lain dan selesaikan proses masuk browser, lalu coba lagi. Jika tidak, refresh sendiri kredensial AWS yang Anda gunakan: proses masuk SSO, access key, kunci API, atau token proxy Anda - Dengan
awsAuthRefreshdiatur dalam sesi interaktif, Anda dapat menjalankan/loginsebagai gantinya, pilih 3rd-party platform, lalu 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 error berulang setelah perintah refresh berhasil, pastikan identitas valid di luar Claude Code dengan
aws sts get-caller-identitydi shell dan profil yang sama
AWS authentication failed
Penyedia AWS Anda mengembalikan 403, atau Amazon Bedrock mengembalikan 401. Amazon Bedrock melaporkan token keamanan yang kedaluwarsa sebagai 403, tetapi 403 juga merupakan cara Amazon Bedrock melaporkan penolakan otorisasi, sepertiAccessDeniedException karena izin IAM yang tidak ada. Claude Code tidak dapat membedakan kedua penyebab tersebut.
401 dari Amazon Bedrock juga masuk ke sini alih-alih ke AWS credentials expired or invalid, karena Amazon Bedrock tidak melaporkan token yang kedaluwarsa sebagai 401. 401 dari endpoint tersebut biasanya berasal dari hal lain di jalur permintaan, seperti proxy perusahaan.
Refresh kredensial memperbaiki token yang kedaluwarsa tetapi tidak dapat memperbaiki penyebab lainnya, sehingga pesan menawarkan keduanya:
AWS authentication failed.
Ketika 403 merupakan jawaban Amazon Bedrock bahwa Anda tidak memiliki akses ke model dengan ID model yang ditentukan, petunjuk akan meminta Anda untuk mengaktifkan model untuk akun dan region Anda di konsol Amazon Bedrock.
Sebelum v2.1.273, pesan ini hanya muncul ketika awsAuthRefresh dikonfigurasi.
Yang perlu dilakukan:
- Jika petunjuk menyebutkan bahwa kredensial dikelola oleh lingkungan ini, aplikasi yang meluncurkan Claude Code memiliki kredensial tersebut dan langkah lain di sini tidak berlaku: coba lagi, atau hubungi administrator Anda
- Refresh kredensial AWS Anda jika kredensial yang kedaluwarsa adalah penyebabnya: jalankan perintah
awsAuthRefreshyang disebutkan dalam pesan jika diatur, atau refresh sendiri proses masuk SSO, access key, kunci API, atau token proxy Anda - Jika kredensial Anda masih berlaku, pastikan izin IAM di Konfigurasi IAM terpasang pada identitas yang Anda gunakan dan bahwa model yang dipilih diaktifkan untuk akun dan region Anda
- Jalankan
aws sts get-caller-identityuntuk memastikan identitas mana yang digunakan oleh permintaan Anda
Google Cloud credentials expired or invalid
Kredensial Google Cloud Anda untuk Agent Platform Google Cloud telah kedaluwarsa atau ditolak: permintaan mengembalikan 401, yang merupakan cara Agent Platform melaporkan kredensial yang kedaluwarsa. Petunjuk tindakan di bagian tengah bervariasi sesuai pengaturan Anda. Bagian yang tetap adalah awalanGoogle Cloud credentials expired or invalid:
- Jika petunjuk menyebutkan bahwa kredensial dikelola oleh lingkungan ini, aplikasi yang meluncurkan Claude Code memiliki kredensial tersebut dan langkah lain di sini tidak berlaku: coba lagi, atau hubungi administrator Anda
- Jika Anda mengatur
CLAUDE_CODE_USE_ANTHROPIC_GOOGLE_CLOUD, ikuti langkah-langkah untuk Claude Models on Google Cloud (dikelola Anthropic) sebagai gantinya - Jika Anda mengautentikasi dengan application default credentials, jalankan perintah
gcpAuthRefreshyang disebutkan dalam pesan, ataugcloud auth application-default login, dan selesaikan proses masuk, lalu coba lagi - Jika Anda merutekan melalui LLM gateway dengan
CLAUDE_CODE_SKIP_VERTEX_AUTHdiatur, refresh token gateway diANTHROPIC_AUTH_TOKENatauANTHROPIC_CUSTOM_HEADERS, lalu coba lagi - Jika Anda mengautentikasi dengan file kunci service account, pastikan
GOOGLE_APPLICATION_CREDENTIALSmengarah ke kunci yang valid. Lihat Konfigurasi kredensial GCP - Jika error berulang setelah refresh, pastikan identitas berfungsi di luar Claude Code dengan
gcloud auth application-default print-access-tokendi shell yang sama
Please run /login atau Failed to authenticate sebagai gantinya, yang tidak dapat me-refresh kredensial Google Cloud.
Google Cloud authentication failed
Agent Platform dari Google Cloud mengembalikan 403, yang digunakannya untuk penolakan otorisasi, bukan untuk kredensial yang kedaluwarsa. Biasanya identitas yang Anda gunakan untuk autentikasi tidak memiliki izin IAM, atau model tersebut belum diaktifkan untuk proyek Anda. Petunjuk tindakan di bagian tengah bervariasi sesuai penyiapan Anda. Bagian yang tetap adalah awalanGoogle Cloud authentication failed:
- Jika petunjuk menyatakan bahwa kredensial dikelola oleh lingkungan ini, aplikasi yang meluncurkan Claude Code adalah pemilik kredensial tersebut dan langkah-langkah lain di sini tidak berlaku: coba lagi, atau hubungi administrator Anda
- Jika Anda mengatur
CLAUDE_CODE_USE_ANTHROPIC_GOOGLE_CLOUD, ikuti langkah-langkah untuk Claude Models on Google Cloud (dikelola Anthropic) sebagai gantinya - Pastikan peran dalam konfigurasi IAM telah diberikan kepada identitas yang Anda gunakan untuk autentikasi
- Pastikan model telah diaktifkan untuk proyek Anda. Lihat Meminta akses model
Please run /login atau Failed to authenticate, yang tidak dapat memperbarui kredensial Google Cloud.
Microsoft Foundry authentication failed
Microsoft Foundry mengembalikan 401 atau 403: kredensial Azure pada permintaan ditolak, atau identitas di baliknya tidak memiliki akses ke resource Foundry./login tidak dapat membuat kredensial Azure. Petunjuk tindakan di bagian tengah bervariasi sesuai penyiapan Anda. Bagian yang tetap adalah awalan Microsoft Foundry authentication failed:
- Jika petunjuk menyatakan bahwa kredensial dikelola oleh lingkungan ini, aplikasi yang meluncurkan Claude Code adalah pemilik kredensial tersebut dan langkah-langkah lain di sini tidak berlaku: coba lagi, atau hubungi administrator Anda
- Perbarui kredensial yang Anda konfigurasikan di Mengonfigurasi kredensial Azure: rotasi
ANTHROPIC_FOUNDRY_API_KEY, buatANTHROPIC_FOUNDRY_AUTH_TOKENyang baru, atau jalankanaz loginagar rantai kredensial default Microsoft Entra dapat masuk kembali - Jika kredensial masih berlaku, pastikan identitas tersebut memiliki akses ke resource Foundry. Lihat Konfigurasi Azure RBAC
Please run /login atau Failed to authenticate, yang tidak dapat memperbarui kredensial Azure.
Could not load AWS or Google Cloud credentials
Claude Code tidak dapat memperoleh kredensial yang dapat digunakan dari rantai penyedia kredensial AWS atau dari application default credentials Google Anda di mesin tempat Claude Code berjalan, sehingga tidak ada permintaan yang mencapai penyedia cloud Anda. Detail setelah· menyebutkan penyebab spesifiknya, seperti sesi SSO yang kedaluwarsa, application default credentials yang tidak ada yang dilaporkan sebagai Could not load the default credentials, atau proses masuk yang dicabut yang dilaporkan sebagai invalid_grant:
-p dan di Agent SDK, kode error terstrukturnya adalah cloud_credential_error. Sebelum v2.1.267, pesan hanya menampilkan teks detail setelah API Error:, dan kode terstrukturnya adalah server_error atau unknown.
Yang harus dilakukan:
- Jalankan perintah masuk penyedia Anda, seperti
aws sso login --profile myprofileataugcloud auth application-default login, lalu coba lagi. Kredensial Bedrock, Agent Platform, atau Foundry tidak dimuat menunjukkan cara memastikan kredensial di luar Claude Code - Jika detailnya berbunyi
AWS default-chain credential resolve timed out, rantai tersebut macet alih-alih gagal, jadi ikuti AWS default-chain credential resolve timed out sebagai gantinya
AWS default-chain credential resolve timed out
Rantai penyedia kredensial default AWS tidak menghasilkan kredensial dalam 60 detik, sehingga Claude Code menghentikan proses resolusi dan menggagalkan permintaan. Timeout ini adalah salah satu penyebab Could not load AWS or Google Cloud credentials. Kegagalan ini terjadi pada resolusi kredensial lokal: permintaan tidak pernah mencapai Amazon Bedrock, Claude Platform on AWS, atau endpoint Mantle. Claude Code menghapus cache kredensial miliknya dan mencoba ulang sebelum error ini muncul, sehingga saat Anda melihatnya, rantai tersebut telah macet pada beberapa percobaan berulang.credential_process dalam profil AWS Anda yang menunggu input yang tidak dapat diterimanya, serta container atau VM yang instance metadata service (IMDS)-nya tidak pernah menjawab probe dari rantai tersebut.
Sebelum v2.1.267, pesannya berbunyi API Error: AWS default-chain credential resolve timed out.
Sebelum v2.1.207, rantai yang macet membuat permintaan menunggu tanpa batas alih-alih gagal.
Yang harus dilakukan:
- Jalankan
aws sts get-caller-identitydi shell yang sama denganAWS_PROFILEyang sama. Jika perintah itu juga macet, perbaiki profilnya; perintahcredential_processyang meminta input secara interaktif adalah penyebab umum. - Selesaikan langkah masuk sebelum memulai Claude Code, misalnya
aws sso login --profile myprofile - Jika rantai Anda menjalankan proses masuk interaktif yang memang membutuhkan lebih dari 60 detik, seperti SSO dengan MFA melalui wrapper seperti
aws-vault, naikkan batasnya dalam milidetik denganCLAUDE_CODE_AWS_CHAIN_RESOLVE_TIMEOUT_MS
Bedrock setup verification timed out waiting for AWS
Panggilan ke AWS selama verifikasi kredensial di wizard penyiapan Bedrock, seperti pencarian kredensial atau pemeriksaan identitas, tidak selesai dalam batas 60 detik. Wizard berhenti menunggu dan menggagalkan langkah verifikasi:CLAUDE_CODE_AWS_CHAIN_RESOLVE_TIMEOUT_MS.
Penyebab umumnya adalah jaringan atau proxy yang menahan permintaan ke AWS, termasuk pembaruan token SSO, serta credential helper yang masih menunggu input yang tidak dapat Anda lihat. Naikkan batasnya hanya jika helper tersebut memang membutuhkan waktu lebih lama.
Satu permintaan ke AWS yang macet juga dapat gagal karena timeout per permintaannya sendiri, yang menampilkan pesan lebih pendek pada langkah yang sama:
unreachable alih-alih menampilkan salah satu pesan tersebut.
Yang harus dilakukan:
- Jalankan
aws sts get-caller-identitydi shell yang sama. Jika perintah itu juga macet, kemacetan berada di luar Claude Code, yaitu di jaringan Anda, proxy Anda, atau credential helper dalam profil AWS Anda; perbaiki itu terlebih dahulu. - Selesaikan proses masuk interaktif apa pun sebelum membuka wizard, misalnya
aws sso login --profile myprofile - Jika credential helper dalam profil AWS Anda memang membutuhkan lebih dari 60 detik untuk meminta input dari Anda, naikkan batasnya dalam milidetik dengan
CLAUDE_CODE_AWS_CHAIN_RESOLVE_TIMEOUT_MS
Cloud gateway session expired
Anda masuk melalui Claude apps gateway, dan sesi gateway yang tersimpan di mesin ini telah kedaluwarsa dan tidak dapat diperbarui, atau gateway tidak lagi menerimanya, misalnya setelah JWT secret gateway diganti. Jika Anda melihat baris ini saat memulaiclaude secara interaktif, sesi telah dibuka dalam keadaan keluar dari gateway:
claude selain claude auth, Claude Code keluar dengan pesan ini sebagai gantinya ketika gateway tidak lagi menerima sesi tersebut:
- Jalankan
/logindi sesi dan selesaikan proses masuk melalui browser - Untuk peluncuran non-interaktif, mulai
claudedi lingkungan yang sama, jalankan/login, lalu jalankan ulang perintah Anda
Sign-in timed out while waiting for you to continue
Selama proses masuk Claude apps gateway, gateway menyebutkan akun yang masuk, dan Claude Code meminta Anda untuk mengonfirmasinya sebelum menyimpan kredensial. Anda membiarkan konfirmasi terbuka melewati masa berlaku proses masuk itu sendiri, dan gateway tidak menerbitkan refresh token yang dapat memperbaruinya, sehingga Claude Code tidak menyimpan apa pun saat Anda melanjutkan:- Jalankan
/loginlagi dan konfirmasi akun sebelum proses masuk kedaluwarsa
Gateway refused the request
Anda masuk melalui Claude apps gateway, dan sebuah permintaan mengembalikan 403: gateway, atau upstream di belakangnya, menolaknya. Masuk kembali tidak mengubah penolakan, sehingga pesan tersebut mengarahkan Anda ke administrator gateway:- Minta administrator gateway Anda untuk menelusuri permintaan tersebut. Bagian akhir
API Error:memuat penolakan yang dikembalikan gateway - Untuk administrator: aturan kontrol akses pada gateway mengembalikan 403 yang dicatat oleh log audit beserta alasannya, dan penolakan otorisasi dari upstream diteruskan sesuai Pesan error upstream
Please run /login atau Failed to authenticate, dan masuk kembali tidak menghilangkan penolakan tersebut.
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 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 gunakancurl.exe -I https://api.anthropic.comsehingga aliasInvoke-WebRequestbawaan tidak digunakan. - Jika Anda berada di belakang proxy perusahaan, atur
HTTPS_PROXYsebelum meluncurkan Claude Code dan lihat Konfigurasi jaringan - Jika Anda merutekan melalui gateway LLM atau relay, atur
ANTHROPIC_BASE_URLke alamatnya. Lihat Hubungkan Claude Code ke gateway LLM untuk pengaturan. - Jika
ANTHROPIC_BASE_URLsudah menunjuk ke gateway Anda dan setiap permintaan berakhir denganConnection dropped, periksa apakah gateway Anda dan upstream-nya menerima field tool search. Secara default, Claude Code mengirim field tooldefer_loadingdan bloktool_reference, beserta headeranthropic-betayang mengaktifkannya. Sebelum v2.1.304, tool search dinonaktifkan di belakang gateway kecuali Anda mengaktifkannya denganENABLE_TOOL_SEARCH. - Pastikan firewall Anda memungkinkan host yang tercantum dalam Persyaratan akses jaringan
- Kegagalan intermiten dicoba ulang secara otomatis
curl berhasil tetapi Claude Code masih gagal, penyebabnya biasanya sesuatu antara runtime dan jaringan daripada jaringan itu sendiri:
- Periksa apakah
ANTHROPIC_BASE_URLdiatur dengan menjalankanecho $ANTHROPIC_BASE_URL, atauecho $env:ANTHROPIC_BASE_URLdi PowerShell, dan cari di blokenvdari file pengaturan Anda. Ketika diatur, Claude Code mengirim permintaan model ke alamat itu daripadaapi.anthropic.com, jadi nilai sisa yang menunjuk ke proxy lokal atau gateway yang tidak lagi berjalan menghasilkanConnection refusedmeskipuncurlmenjangkau API. Hapus dari profil shell atau pengaturan Anda dan mulai Claude Code dari terminal baru. - Di Linux dan WSL, periksa
/etc/resolv.confuntuk 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
ifconfiguntuk antarmukautunyang 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 menjangkauapi.anthropic.com dan platform.claude.com sebelum menampilkan langkah masuk. Ketika salah satu pemeriksaan gagal, Claude Code mencetak alasannya dan keluar.
HTTPS_PROXY. Sebelum v2.1.222, pemeriksaan menggunakan transport proxy yang berbeda tanpa timeout: 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 endpoint Anthropic tidak dapat dijangkau.
Claude Code juga melewati pemeriksaan di mesin tanpa pengaturan terkelola ketika ~/.claude/settings.json milik Anda sendiri menamai gateway dengan forceLoginMethod dan forceLoginGatewayUrl. Sebelum v2.1.295, Claude Code menjalankan pemeriksaan dalam kasus tersebut.
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
curldan panduan firewall di sana berlaku untuk pemeriksaan ini juga. - 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 mencoba ulang permintaan, menyimpan apa yang Claude hasilkan, atau mengakhiri giliran. Lihat Retry otomatis.
Sebelum v2.1.214, Claude Code tidak mencoba ulang 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 retry 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 mencoba ulang permintaan, dan giliran berakhir dengan kesalahan ini.- Klausa
Response:dengan tipe konten, jenis isi, sepertibody is an HTML pageatauempty body, ukurannya dalam byte, dan apakah respons membawa id permintaan Anthropic. Ketika respons menamai server yang dapat dikenali, sepertinginxataucloudflare, atau membawa header perantara, seperticf-rayatauvia, klausa mencantumkan yang itu juga. - Kalimat yang menamai id permintaan streaming yang gagal dan kegagalan yang memicu retry. Ketika stream telah dibuka sebelum kegagalan, ia juga melaporkan berapa banyak peristiwa stream yang tiba dan, jika ada, berapa lama stream telah diam ketika upaya gagal.
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 sepertinginxataucloudflareberarti 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=1untuk mematikan fallback ini, kecuali ketika endpoint streaming itu sendiri mengembalikan404, di mana Claude Code tetap menggunakan fallback
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 mencoba ulang tanpa streaming.- 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 headerContent-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 mencoba ulang permintaan.
API Error: Truncated event message received setelah seluruh respons telah di-buffer.
Yang harus dilakukan:
- Konfigurasikan gateway untuk melewatkan isi respons
InvokeModelWithResponseStreamdan headerContent-Typenya tanpa dimodifikasi. Perantara yang memancarkan ulang stream sebagai peristiwa yang dikirim server adalah penyebab umum. - Menetapkan
CLAUDE_CODE_DISABLE_BEDROCK_CONTENT_TYPE_GUARD=1menyembunyikan kesalahan ini, tetapi Claude Code tidak mendekode isi biner di bawah header yang ditulis ulang, jadi permintaan itu beralih 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.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 dicoba ulang, jadi kesalahan ini muncul pada upaya pertama daripada setelah anggaran retry penuh. Versi sebelumnya menghabiskan beberapa menit mencoba ulang sebelum menampilkannya. Kondisi TLS sementara, seperti timeout handshake, masih dicoba ulang.
Selama /login dan pemeriksaan konektivitas startup, kegagalan yang sama menghasilkan pesan yang berbeda:
- 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
Dalam sesi cloud atau tugas terjadwal cloud,403 atau kesalahan DNS seperti ENOTFOUND dapat berarti bahwa host yang diminta tidak ada dalam allowlist lingkungan cloud. Untuk memastikannya, periksa host tersebut terhadap daftar itu. 403 dengan header ini memastikan pemblokiran, tetapi tidak setiap 403 dari permintaan yang diblokir memilikinya:
- Lalu lintas GitHub dan konektor: operasi GitHub dan lalu lintas konektor MCP menggunakan saluran terpisah, itulah mengapa mereka dapat terus bekerja sementara host lain diblokir
- Lingkungan default: lingkungan Default menggunakan akses Limited dengan Allow package managers dicentang. Sesinya menjangkau allowlist default dari registri paket, API penyedia cloud, registri kontainer, dan domain pengembangan umum.
- Buka lingkungan Anda untuk pengeditan, baik dari formulir tugas terjadwal cloud atau dari pemilih lingkungan tempat Anda memulai sesi cloud.
- Dalam dialog Edit cloud environment, pilih Limited di bawah Network access, kemudian tambahkan domain yang diblokir ke Allowed domains. Masukkan satu domain per baris. Centang Allow package managers untuk mengizinkan allowlist default bersama domain Anda sendiri. Pilih Full sebagai gantinya jika Anda menginginkan akses tanpa batas.
- Klik Save changes. Jalankan berikutnya menggunakan allowlist yang diperbarui. Untuk sesi cloud yang sudah terbuka, lihat kapan perubahan akses jaringan mencapai sesi yang ada.
The proxy refused the connection
Anda melihat pesan ini ketika Claude membaca artifact melalui proxy yang Anda atur dalamHTTPS_PROXY atau variabel proxy terkait. Konten artifact 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:
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 membuat 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 replysebagai pengganti status: apa pun yang ada di alamat proxy tidak menjawab dengan baris status HTTP. Periksa bahwa alamatnya adalah proxy HTTP.
- 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.comdari shell tempat Anda memulai Claude Code, menggunakan URL proxy Anda sendiri. Di Windows PowerShell, jalankancurl.exe. Jika probe ini gagal dengan cara yang sama, perbaiki pengaturan proxy terlebih dahulu. Jika berhasil, penolakan khusus untuk host artifact. - Jika jaringan Anda membiarkan Claude Code menjangkau host artifact secara langsung, tambahkan
.frame.claudeusercontent.comkeNO_PROXY. Simpan entri itu sempit: entri.claudeusercontent.comyang lebih luas juga melewati proxy untukbridge.claudeusercontent.com, yang organisasi dengan IP allowlisting perlu tetap lewatkan melalui proxy.
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:
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
Failed to fetch session from Sessions API
Pesan ini berarti Claude Code menemukan sesi cloud yang Anda minta untuk ditarik ke terminal Anda tetapi tidak dapat membaca riwayat percakapannya dari server Anthropic, sehingga tidak membukanya:claude --teleport, /teleport, atau memilih sesi dalam daftar /tasks. claude --teleport <session-id> mencetaknya dan keluar dengan kode 1.
Yang harus dilakukan:
- Jalankan teleport yang sama lagi. Jika gagal dengan cara yang sama, laporkan masalahnya
Couldn’t load the history of cloud session
Pesan ini berarti Claude Code menemukan sesi cloud yang Anda minta untuk ditarik ke terminal Anda, tetapi permintaan untuk riwayat percakapannya kembali dengan hasil tidak ditemukan:- Buka tautan dalam pesan untuk memeriksa sesi di browser Anda. Jika sesi terbuka di sana dan teleport yang sama gagal dengan cara ini lagi, laporkan masalahnya.
Couldn’t reconnect to your Remote Control session
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 mengonfirmasi apakah sesi jarak jauh masih ada. Sesi lokal Anda terus berjalan tanpa Remote Control.
Yang harus dilakukan:
- Jalankan
/remote-controluntuk mencoba lagi koneksi - Mulai sesi baru dengan
claude --remote-controluntuk membuat sesi Remote Control baru - Untuk pesan startup Remote Control lainnya, lihat Troubleshoot Remote Control
Previous session is unavailable — run /remote-control to start a new one.
Sessions ended while this machine was offline
Claude Code menampilkan pesan ini di terminal yang menjalankanclaude 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.
- Ketika Claude Code mencantumkan worktree yang disimpan di bawah pesan ini, ambil pekerjaan yang tidak dikomit dari mereka
- Jalankan
claude remote-controluntuk 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.- Jalankan
/feedbackuntuk mengirim transkrip dengan deskripsi apa yang terjadi. Lihat Report an error jika/feedbacktidak tersedia di lingkungan Anda - Jika permintaan lain juga gagal, periksa koneksi jaringan Anda dan lihat Unable to connect to API
Couldn’t send feedback
Pesan yang diawaliCouldn't send feedback berarti layanan umpan balik tidak mengonfirmasi laporan yang Anda kirimkan dari dialog /feedback, /bug, atau /share, atau draf umpan balik yang berada dalam antrean. Anggap laporan tersebut tidak diterima. Ketika kalimat tentang organisasi Anda muncul setelah titik dua, organisasi Anda menolak umpan balik.
Contoh kedua adalah penolakan organisasi:
- Belum masuk: pesan berlanjut dengan
: not signed in. Run /login, then retry.Jalankan/login, lalu kirim lagi - Penolakan organisasi Anda: misalnya
: Feedback has not been enabled for your organization.atau: Feedback collection is not available for organizations with custom data retention policies.Setelah itu,/feedbackdapat menjawab bahwa fitur tersebut dinonaktifkan oleh kebijakan organisasi Anda selama tujuh hari. Draf dalam antrean tetap berada dalam antrean dan tetap kedaluwarsa sesuai jadwal - Kredensial ditolak: pesan berlanjut dengan
: the sign-in this session uses is not allowed to send feedbackatau: the server did not accept the credentials this session uses. Jalankan/statusdi prompt Claude Code untuk melihat login, token, atau kunci API mana yang dikirim sesi ini (request timed out)atau(couldn't reach the service)langsung setelahCouldn't send feedback: kirim laporan atau draf dalam antrean lagi. Dialog menyimpan teks Anda, dan pesan untuk draf dalam antrean menyatakanThe draft is still queued.Jika permintaan lain juga gagal, periksa koneksi jaringan Anda dan lihat Unable to connect to API. Jika terus gagal, ajukan laporan di github.com/anthropics/claude-code/issues(server returned <status>), atau tanpa alasan, langsung setelahCouldn't send feedback: status adalah kode respons layanan. Pesan layanan itu sendiri mengikutinya ketika layanan mengirimkannya, seperti dalam(server returned 403: Access Forbidden). Jika terus gagal, ajukan laporan di github.com/anthropics/claude-code/issues
Feedback payload too large
Pesan ini di layar tinjauan untuk draf umpan balik berarti Claude Code tidak memiliki konfirmasi bahwa layanan menerima draf tersebut. Anggap draf tersebut tidak diterima. Draf tetap berada dalam antrean/feedback Anda, sehingga Anda dapat mengirimnya lagi.
- Di layar tinjauan, atur Send transcript ke
no, lalu kirim draf lagi. Memperpendek detail menghapus paling banyak 10 KB teks, yang merupakan seluruh kapasitas detail sebuah draf.
MCP server connection timed out during a sleep or clock change
Pesan ini berarti koneksi ke server MCP mengalami timeout, dan Claude Code mendapati bahwa jam sistem Anda melompat maju selama upaya tersebut:- Dalam sesi interaktif: jalankan
/mcp, pilih server, dan pilih Reconnect - Di shell Anda: jalankan perintah
claude -p,claude mcp list, atauclaude mcp getlagi. Jika server kemudian gagal dengan pesan yang diawaliSkipping connection (recent failure cached, tunggu 15 menit dan jalankan perintah itu lagi. - Dalam aplikasi Agent SDK: panggil
reconnectMcpServer()di TypeScript atauClaudeSDKClient.reconnect_mcp_server()di Python - Jika server gagal lagi: jika pesannya berbeda dari pesan ini, lihat apa yang perlu diperiksa ketika server MCP tidak terhubung. Jika pesan ini muncul kembali meskipun komputer Anda tetap aktif dan tidak ada yang mengubah jamnya, lihat Report an error.
MCP server "<name>" connection timed out after <N>ms alih-alih pesan ini.
Kesalahan permintaan
Error ini berkaitan dengan konten permintaan Anda. Sebagian besar dikembalikan oleh API setelah API menolak permintaan; beberapa dihasilkan secara lokal oleh Claude Code sebelum permintaan apa pun dikirim.Prompt is too long
Percakapan beserta file yang dilampirkan melebihi context window model./clear ketika DISABLE_COMPACT diatur. Bentuk error yang lebih panjang, seperti bentuk compaction gagal di bawah, tetap menggunakan kata-kata Prompt is too long ·. Dalam output -p dan transkrip, teksnya tetap Prompt is too long.
Ketika Anda menonaktifkan auto-compact di pengaturan pengguna Anda, baris tersebut juga menyebutkannya:
/config menulis autoCompactEnabled ke pengaturan pengguna. Petunjuk ini hanya muncul ketika perubahan /config akan berlaku. Misalnya, petunjuk tidak muncul ketika DISABLE_AUTO_COMPACT atau DISABLE_COMPACT menonaktifkan auto-compact. Petunjuk juga tidak muncul ketika cakupan dengan prioritas lebih tinggi, seperti pengaturan proyek atau pengaturan terkelola, mengatur autoCompactEnabled ke false. Sebelum v2.1.235, baris tersebut tidak memuat petunjuk auto-compact.
Amazon Bedrock melaporkan kondisi ini sebagai Input is too long for requested model., yang ditangani Claude Code dengan cara yang sama. Sebelum v2.1.217, Claude Code tidak mengenali kata-kata Bedrock tersebut, sehingga auto-compact tidak pernah terpicu olehnya dan /compact gagal dengan error yang sama.
Claude apps gateway melaporkan kondisi ini sebagai capability_rejected: prompt_too_long ketika upstream cloud menolak permintaan dalam bentuk error milik penyedia itu sendiri. Claude Code memperlakukan token tersebut sama seperti Prompt is too long. Sebelum v2.1.228, Claude Code tidak mengenali token tersebut, sehingga auto-compact tidak terpicu olehnya.
Ketika compaction otomatis berjalan pada giliran ini dan gagal karena error yang mendasarinya, seperti model yang tidak tersedia atau kegagalan autentikasi, pesan tersebut menyebutkan error itu setelah pemisah:
/compact akan gagal dengan error yang sama sampai Anda melakukannya. Sebelum v2.1.229, compaction otomatis yang gagal menampilkan Prompt is too long tanpa penyebabnya.
Ketika compaction otomatis berjalan pada error ini, biasanya compaction merangkum pertukaran terlama Anda dan mempertahankan yang terbaru. Sebagai upaya terakhir, Claude Code merangkum dengan cara berbeda:
- Ketika tidak dapat merangkum satu pertukaran utuh pun, Claude Code mempertahankan prompt terbaru Anda kata demi kata dan merangkum semua yang ada sebelumnya.
- Dalam kasus tersebut, ketika percakapan tidak diakhiri dengan prompt Anda, Claude Code merangkum seluruh percakapan sebagai gantinya.
/clear untuk memulai dari awal. Sebelum v2.1.269, compaction gagal setiap kali tidak dapat merangkum pertukaran utuh, sehingga sesi dalam keadaan tersebut mengalami error ini lagi di setiap giliran.
Percakapan dengan satu pertukaran tidak memiliki giliran sebelumnya untuk dirangkum. Ketika compaction otomatis seharusnya berjalan pada percakapan seperti itu, Claude Code melewati upaya tersebut dan menjelaskan apa yang mengisi permintaan sebagai gantinya. Ketika API tidak melaporkan jumlah token dalam error-nya, pesannya berbunyi:
Prompt is too long saja ketika gagal.
Yang perlu dilakukan:
- Jalankan
/compactuntuk merangkum giliran sebelumnya dan mengosongkan ruang, atau/clearuntuk memulai dari awal. Jika/compactmenjawabNot enough messages to compact., percakapan tersebut adalah satu pertukaran tanpa apa pun sebelumnya untuk dirangkum, sehingga ruang terpakai oleh satu prompt tersebut dan apa yang dikirim Claude Code bersama setiap permintaan: jalankan/cleardan kirim ulang dengan lebih sedikit teks yang ditempel atau lampiran yang lebih kecil, atau kurangi definisi tool dan file memori dengan langkah-langkah di bawah - Jalankan
/contextuntuk melihat rincian apa yang menghabiskan window: system prompt, tool, file memori, dan pesan - Nonaktifkan server MCP yang tidak Anda gunakan dengan
/mcp disable <name>untuk menghapus definisi tool-nya dari konteks - Pangkas file memori
CLAUDE.mdyang besar, atau pindahkan instruksi ke aturan dengan cakupan path yang hanya dimuat ketika relevan - Auto-compact aktif secara default dan biasanya mencegah error ini. Jika Anda menonaktifkannya di
/configatau denganDISABLE_AUTO_COMPACT, aktifkan kembali. Jika Anda tetap menonaktifkannya, jalankan/compactsendiri sebelum window penuh. - Jika Claude Code memperingatkan bahwa ia tidak mengenali ID model Anda, peringatan tersebut dapat menyebutkan window yang diasumsikannya. Ketika window sebenarnya dari model berbeda, berikan window yang sebenarnya kepada Claude Code.
- Jika Anda menggunakan
ANTHROPIC_BASE_URLkustom dan kesalahan diawali denganPrompt is too long · automatic compaction failed, atur context window model atau perbarui ke v2.1.299 atau yang lebih baru. Sebelum v2.1.299, Claude Code mengakhiri giliran dengan pesan tersebut di dekat window 200K yang diasumsikan alih-alih mengirim permintaan.
- Jika Anda menggunakan
- Jika error muncul tepat setelah Anda menghentikan Claude saat sedang melakukan compaction percakapan, percakapan Anda tidak berubah dan masih cukup besar sehingga perlu compaction. Jalankan
/compactdan kirim pesan Anda lagi. Agar error tidak terulang, perbarui Claude Code ke v2.1.304 atau yang lebih baru. Sebelum v2.1.304, menghentikan pada saat itu dapat mengakhiri giliran dengan error ini. - Pada v2.1.305, dengan banyak tool MCP dan koneksi langsung ke Anthropic API, error ini dapat menyembunyikan error 400 atau 422 yang tidak terkait dari API. Perbarui Claude Code ke v2.1.306 atau yang lebih baru untuk melihat error aslinya.
Context exceeds the token limit
/context menampilkan peringatan ini di bagian atas output-nya ketika percakapan telah tumbuh melewati context window model:
Context exceeds, Anda tidak perlu menjalankan kedua perintah tersebut selama auto-compact aktif, yang merupakan default:
- Auto-compact aktif: kirim pesan Anda berikutnya. Jika masih gagal dengan
Prompt is too long, lihat entri tersebut. - Auto-compact nonaktif: di dalam sesi, jalankan
/compactjika peringatan menyebutkannya, atau/clearuntuk memulai ulang. Sampai Anda menjalankan salah satunya, pesan gagal denganContext limit reached, atauPrompt is too longdalam output-p.
/clear alih-alih /compact ketika Anda telah mengatur DISABLE_COMPACT.
Yang perlu dilakukan:
- Setelah peringatan window compaction: dalam percakapan multi-giliran, jalankan
/compactuntuk merangkum giliran sebelumnya dan mengosongkan ruang. Untuk memulai dari awal, jalankan/clear. - Untuk cara lain mengurangi penggunaan, lihat Prompt is too long
/context menampilkan penggunaan di atas 100% tanpa baris peringatan yang menjelaskan artinya atau cara memulihkannya.
Request too large
Body permintaan mentah melebihi batas 32MB API sebelum tokenisasi, biasanya karena konten tempelan yang besar, hasil tool, atau lampiran. Batas ini terpisah dari context window.Request too large (max 32MB; 20.1MB of about 33.4MB is images or documents).: gambar atau dokumen mendorong permintaan melewati batas. Claude Code mencoba ulang dengan menghapusnya.Request too large for the API's 32MB request limit: pesan-pesan itu sendiri sudah melewati batas, sehingga pesan menyebutkancompacting cannot make it fitdan Claude Code tidak mencoba ulang. Dalam mode non-interaktif, pesan meminta Anda untuk mengurangi input atau memulai sesi baru sebagai gantinya.
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 compaction tidak dapat membantu.
Yang perlu dilakukan:
- Jika pesan menyebutkan
compacting cannot make it fit, tekan Esc dua kali untuk mundur melewati giliran yang menambahkan konten besar tersebut, atau jalankan/clearuntuk memulai dari awal - Jika tidak, jalankan
/compact, yang membuang gambar dan lampiran yang terakumulasi - Rujuk file besar berdasarkan path alih-alih menempelkan isinya, sehingga Claude dapat membacanya dalam potongan-potongan
- Untuk gambar, lihat Image was too large di bawah
Image was too large
Gambar yang ditempel atau dilampirkan melampaui batas ukuran atau dimensi API.could not be processed and was removed berarti API menolak sebuah gambar dalam percakapan, misalnya gambar yang melewati batas ukuran atau dimensi.
Jika salah satu error ini terus muncul kembali, perbarui Claude Code. Pada versi yang lebih lama, error gambar dapat berulang karena alasan seperti berikut:
- Sebelum v2.1.299, dalam percakapan panjang dengan banyak gambar, Claude Code dapat menghapus gambar yang terakhir Anda lampirkan alih-alih gambar yang melewati batas. Baris
was removedkemudian berulang di setiap giliran, dan Claude tidak melihat gambar baru Anda. - Sebelum v2.1.299, di VS Code, aplikasi Desktop, dan Agent SDK, gambar yang Anda lampirkan saat Claude sedang bekerja tidak mendapatkan pengubahan ukuran seperti gambar lampiran lainnya. Gambar tersebut mencapai API dalam ukuran aslinya, yang menyebabkan error gambar berulang dalam percakapan panjang.
- Sebelum v2.1.166, gambar yang ditempel dapat tetap berada dalam percakapan, dan error yang sama kemudian berulang di setiap pesan berikutnya
- Ubah ukuran gambar sebelum menempelkannya. API menerima gambar hingga 8000 piksel pada sisi terpanjang untuk satu gambar, atau 3000 piksel ketika lebih dari 20 gambar berada dalam konteks.
- Ambil tangkapan layar yang lebih sempit dari area yang relevan alih-alih seluruh layar
- Untuk pesan
dimension limit for many-image requests, jalankan/compactdi prompt Claude Code jika pesan menyebutkannya, atau mulai sesi baru dengan lebih sedikit gambar
dimension limit for many-image requests menampilkan batas piksel yang disebutkan dalam error API.
Unable to resize image
Claude Code tidak dapat memperkecil gambar yang dilampirkan sebelum mengirimkannya ke API.2576x2576px di tempat contoh-contoh ini menyebutkan 2000x2000px.
Yang perlu dilakukan:
- Jika pesan meminta Anda mengonversi gambar, konversikan ke PNG, JPEG, GIF, atau WebP dan lampirkan lagi. Claude Code dapat memverifikasi dimensi untuk format-format ini dari header file, tanpa mendekode gambar.
- Jika pesan melaporkan batas dimensi atau ukuran, ubah ukuran atau kompres ulang gambar hingga di bawah batas tersebut sebelum melampirkannya.
- Jika pesan menyebutkan penyebab, seperti CMYK JPEG, WebP animasi, atau file yang mungkin rusak, simpan ulang gambar dalam format yang disarankan pesan dan lampirkan lagi.
Request rejected as unprocessable by the model
API menolak permintaan karena model tidak dapat memprosesnya. Pesan tersebut berasal dari API sendiri.- Jika pesan terus muncul dalam percakapan dengan gambar atau dokumen, hapus sendiri gambar atau dokumen tersebut. Tekan Esc dua kali untuk mundur melewati giliran yang menambahkannya, atau jalankan
/clearuntuk memulai dari awal.
Kesalahan PDF
PDF yang Anda lampirkan tidak dapat diproses. Pesan-pesan di sini ditampilkan dalam bentuk non-interaktifnya; dalam sesi interaktif, pesan tersebut meminta Anda menekan esc dua kali dan mencoba lagi.- Untuk PDF yang terlalu besar, minta Claude membaca rentang halaman dengan tool Read alih-alih melampirkan seluruh file, atau ekstrak teks dengan tool seperti
pdftotextdan rujuk file output berdasarkan path - Untuk PDF yang dilindungi atau tidak valid, hapus kata sandinya atau ekspor ulang file dari aplikasi sumbernya, lalu coba lagi
pdftoppm. Instal poppler-utils dengan perintah yang diberikan pesan, atau pada platform lain, build poppler yang menempatkan pdftoppm di PATH Anda. Lihat Perilaku tool Read untuk PDF mana yang dibaca berdasarkan rentang halaman.
Extra inputs are not permitted
Endpoint yang menerima permintaan menolak salah satu field permintaan sebagai input yang tidak diterimanya, dan pesan endpoint tersebut menyebutkan field itu.context_management dan defer_loading milik tool search bersama header anthropic-beta yang mengaktifkannya. Ketika gateway meneruskan body tetapi membuang header, API melihat field yang tidak dikenalinya. Ketika gateway meneruskan body berformat Anthropic ke upstream dengan skema berbeda, upstream tersebut menolak field seperti itu. Pasangan header beta dan field body membahas kedua kasus tersebut.
Yang perlu dilakukan:
- Jika pesan berisi
context_management: Extra inputs are not permitted, perbarui Claude Code ke v2.1.304 atau yang lebih baru. Setelah Anda memperbarui, Claude Code menanggapi penolakan ini dengan mengirim permintaan sekali lagi tanpa field tersebut. Sebelum v2.1.304, Claude Code tidak mencoba ulang penolakan ini. - Jika pesan menyebutkan
defer_loadingatautool_reference, perbarui Claude Code ke v2.1.305 atau yang lebih baru. Claude Code kemudian menanggapi penolakan ini dengan mengirim permintaan sekali lagi tanpa field tool search. - Jika gateway Anda membuang header, konfigurasikan agar meneruskan header
anthropic-beta. Lihat feature pass-through untuk apa yang harus diteruskan gateway. - Sebagai fallback, atur
CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1sebelum meluncurkan. Nonaktifkan kemampuan pra-rilis membahas cakupan pastinya.
diagnostics tanpa melibatkan gateway. Error ini muncul ketika sesi yang sudah menggunakan Anthropic API berpindah ke Amazon Bedrock atau Google Cloud’s Agent Platform tanpa restart. Misalnya, sesi yang Anda biarkan terbuka berpindah ke Bedrock ketika Anda menjalankan /setup-bedrock di jendela Claude Code lain. Pada versi-versi tersebut, jalankan /clear di sesi itu atau restart sesinya.
Tool input schema is invalid
Sebuah tool dalam permintaan mendeklarasikaninput_schema yang gagal dalam validasi JSON Schema API, sehingga API menolak seluruh permintaan. Angka setelah tools. adalah posisi tool yang gagal dalam daftar tool permintaan, bukan nama yang dapat Anda cari.
$schema. Claude Code tidak memeriksa skema tersebut terhadap meta-schema JSON Schema, meskipun pemeriksaan nama properti tingkat atas tetap berlaku.
Sebelum v2.1.216, tidak ada deployment yang menjalankan pemeriksaan pengecualian.
Yang perlu dilakukan:
- Jika versi Claude Code Anda lebih lama dari v2.1.300, jalankan
claude updatedi shell Anda. Sebelum v2.1.300, Claude Code tidak mencoba ulang permintaan tanpa parameter tool yang ditolak, sehingga error ini berulang di setiap permintaan yang menyertakan tool tersebut. - Hapus atau nonaktifkan server MCP yang mendeklarasikan skema tidak valid. Error hanya menyebutkan tool berdasarkan posisi. Pada v2.1.216 atau yang lebih baru, periksa log setiap server untuk baris yang menyebutkan tool yang skema input-nya akan ditolak. Jika tidak ada log yang menyebutkannya, nonaktifkan server satu per satu.
- Jika Anda memelihara server tersebut, perbaiki
input_schematool. Skema harus berupa JSON Schema yang valid, dan nama properti tingkat atas harus sepanjang 1 hingga 64 karakter dan hanya menggunakan huruf dan angka ASCII,_,., dan-. Lihat Tool dengan skema input tidak valid.
Nama tool MCP lebih dari 128 karakter
Sebuah server MCP mencantumkan tool yang nama lengkapnya, sepertimcp__<server>__<tool>, lebih panjang dari 128 karakter yang diterima API. Claude Code tidak menyertakan tool tersebut dalam tool yang dikirimnya ke Claude, dan tool lain dari server tersebut tetap berfungsi. Dalam sesi yang Anda mulai dengan claude --debug dari shell Anda, Claude Code menulis pesan ini ke log debug di ~/.claude/debug/<session-id>.txt:
- Jika Anda memelihara server tersebut, persingkat nama tool.
- Jika server berada dalam konfigurasi MCP Anda, berikan nama yang lebih pendek di sana, seperti
dbsebagai penggantianalytics-database. Kemudian perbarui apa pun yang merujuk ke server atau tool-nya dengan nama lama, seperti aturan izin dan matcher hook. - Jika sebuah plugin menyertakan server tersebut, nama lengkap tool juga mencakup nama plugin. Minta pemelihara plugin untuk mempersingkat nama server atau tool.
API Error: 400 ... tools.N.custom.name: String should have at most 128 characters.
tool_use.name lebih dari 200 karakter
Sebuah panggilan tool dalam riwayat percakapan membawa nama yang lebih panjang dari 200 karakter yang diterima API dalam permintaan:No such tool available dan percakapan berlanjut tanpa error API ini.
Yang perlu dilakukan:
- Jalankan
claude update, lalu lanjutkan percakapan. Versi yang diperbarui memperbaiki nama yang terlalu panjang ketika memuat transkrip, sehingga percakapan yang macet dapat berfungsi kembali.
/compact dan --resume, sehingga error ini berulang dan percakapan macet.
There’s an issue with the selected model
Nama model yang dikonfigurasi tidak dikenali atau akun Anda tidak memiliki akses ke model tersebut. Sejak v2.1.160, petunjuk di bagian akhir, yang ditampilkan di sini dalam bentuk interaktifnya, bervariasi menurut surface.- CLI interaktif: jalankan
/modeluntuk memilih dari model yang tersedia untuk akun Anda. - Mode non-interaktif (
-p): berikan--modeldengan alias atau ID yang valid, atau aturANTHROPIC_MODEL. Teks error menampilkanRun --modelpada surface ini. - Agent SDK: teks error menghilangkan petunjuk karena model diatur secara terprogram. Atur
modelpadaOptionsdi TypeScript atauClaudeAgentOptions(model=...)di Python, dan tangani error terstrukturmodel_not_founduntuk menampilkan retry atau pemilih model Anda sendiri. - Gunakan alias seperti
sonnetatauopusalih-alih ID berversi lengkap. Alias di-resolve ke default yang dipelihara sehingga tidak menjadi usang. Lihat Konfigurasi model. - Jika model yang salah terus muncul kembali di CLI, ada ID usang yang diatur di suatu tempat. Periksa tempat-tempat Anda dapat mengatur model dalam urutan prioritas dan hapus nilai yang usang.
- Sebelum v2.1.206, login claude.ai yang kedaluwarsa dan tidak dapat lagi diperbarui menyebabkan setiap model gagal dengan kesalahan ini. Jalankan
/loginpada versi-versi tersebut. - Jika
ANTHROPIC_BASE_URLmengarah ke LLM gateway dan setiap model gagal dengan cara ini, periksa apakah gateway Anda dan upstream-nya menerima field tool search. Secara default, Claude Code mengirim field tooldefer_loadingdan bloktool_reference, dengan headeranthropic-betayang mengaktifkannya. Sebelum v2.1.304, tool search dinonaktifkan di balik gateway kecuali Anda mengaktifkannya denganENABLE_TOOL_SEARCH. - Untuk deployment Google Cloud’s Agent Platform, lihat pemecahan masalah Google Cloud’s Agent Platform.
Model is not a recognized model id
String yang Anda berikan ke pergantian model bukan string yang dapat digunakan Claude Code sebagai model, sehingga Claude Code menolak pergantian tersebut tanpa mengirim permintaan dan sesi mempertahankan model saat ini. Anda dapat mendapatkan error ini ketika model diatur melalui metodesetModel() Agent SDK, oleh aplikasi yang menjalankan Claude Code CLI untuk Anda, seperti aplikasi Desktop, atau ketika Anda memilih model dari perangkat yang terhubung melalui Remote Control. Sebelum v2.1.200, Claude Code menyimpan string tersebut dan gagal pada permintaan berikutnya dengan There’s an issue with the selected model.
Sonnet 5, yang diulang pesan tanpa spasinya. Petunjuk di bagian akhir menyebutkan alias atau ID model yang paling cocok. Ketika tidak ada yang cukup dekat, petunjuk berbunyi Run /model to see available models. sebagai gantinya. Dalam sesi yang dimulai oleh aplikasi Desktop untuk Anda, petunjuk tanpa kecocokan berbunyi Switch to a different model.
Ketika Anda berganti melalui Agent SDK atau aplikasi di Anthropic API, hanya string yang tidak mungkin merupakan ID model yang mendapatkan error ini, seperti nama tampilan atau string kosong.
Ketika Anda memilih model dari perangkat Remote Control, Claude Code memeriksa string tersebut secara lokal. String apa pun yang bukan alias model, bukan model yang dicantumkan Claude Code atau yang Anda konfigurasikan, dan bukan ID yang diawali claude- akan mendapatkan error ini, termasuk ID yang salah ketik seperti claud-sonnet-5. Sebelum v2.1.260, pemeriksaan ini tidak mencakup pilihan dari Remote Control, sehingga string yang tidak dikenali diterapkan dan gagal pada permintaan berikutnya.
Yang perlu dilakukan:
- Jalankan
/modeltanpa argumen untuk membuka pemilih dan memilih dari model yang tersedia untuk akun Anda, lalu berikan alias atau ID yang ditampilkan di sana - Jika Anda menggunakan alias yang hanya didukung versi Claude Code yang lebih baru, jalankan
claude update, atau berikan ID lengkap model sebagai gantinya. Server masih dapat mewajibkan versi minimum Claude Code untuk model tersebut; lihat Claude Code does not support this model. - Model yang disimpan sebelum v2.1.200 tidak diperbaiki oleh pemeriksaan ini. Jika nilai usang terus muncul kembali, hapus dari lokasi yang tercantum di Mengatur model Anda.
- Pada penyedia apa pun selain Anthropic API, atau di balik gateway atau
ANTHROPIC_BASE_URLkustom, hanya string kosong yang mendapatkan error ini. Claude Code masih dapat menulis baris diagnostik model tidak dikenali pada saat permintaan, di setiap penyedia.
Model not found
Anda beralih ke sebuah model berdasarkan nama dan Claude Code tidak dapat memastikan bahwa model dengan nama tersebut ada. Ketika nama tersebut bukan alias model atau ejaan lain yang diterima Claude Code secara lokal, Claude Code memverifikasinya dengan permintaan API minimal, dan error ini biasanya merupakan jawaban endpoint API Anda. Dengan/model <name>, nama yang sama sekali tidak mungkin merupakan ID model, seperti yang mengandung spasi, mendapatkan pesan yang sama.
Try '...' instead yang menyebutkan ID penyedia Anda untuk model fallback.
Yang perlu dilakukan:
- Jalankan
/modeltanpa argumen dan pilih dari model yang tersedia untuk akun Anda, atau gunakan alias model sepertisonnet, yang di-resolve ke default yang dipelihara - Jika Anda mengetik ID lengkap, periksa terhadap katalog model penyedia Anda. Model yang baru diluncurkan dapat tersedia di Anthropic API sebelum penyedia atau wilayah Anda menawarkannya.
- Di Agent SDK,
setModel()gagal dengan pesan ini dan sesi tetap berjalan pada model sebelumnya. Di TypeScript SDK, panggilsupportedModels()untuk mencantumkan model yang dapat Anda gunakan. - Sebelum v2.1.265,
/modeljuga menolak ejaan aliasopusplan[1m]dengan error ini. Pada versi-versi tersebut, perbarui Claude Code, atau atur model di pengaturan atau dengan--modelsebagai gantinya.
Couldn’t confirm model with the API
Anda beralih model melalui metodesetModel() Agent SDK atau aplikasi yang menjalankan Claude Code CLI untuk Anda, seperti aplikasi Desktop, dan permintaan yang mengonfirmasi ID model dengan endpoint API Anda tidak mendapat jawaban dalam 15 detik. Sesi mempertahankan model saat ini.
Try again.
Yang perlu dilakukan:
- Beralih ke model tersebut lagi
- Jika pergantian terus gagal, periksa apakah Claude Code dapat menjangkau endpoint API Anda; lihat Error jaringan dan koneksi
Error API saat memeriksa model yang dipilih
Anda memilih model dengan/model <name>, atau aplikasi yang terhubung ke sesi meminta pergantian. API menolak permintaan minimal yang dikirim Claude Code untuk memverifikasi model, karena alasan yang tidak memiliki entri tersendiri, seperti rate limit atau error server. Sesi mempertahankan model saat ini, dan pesan diakhiri dengan menyatakan hal itu:
- Tindak lanjuti penjelasan server; untuk rate limit atau status 5xx, tunggu dan pilih model lagi
- Penolakan dengan kata-kata tersendiri dibahas oleh entri-entri di sekitarnya, seperti Model not found dan Model is restricted by your organization’s settings
Claude Opus is not available with the Claude Pro plan
Paket langganan aktif Anda tidak mencakup model yang Anda pilih.sign out and sign in again alih-alih menyebutkan perintahnya.
Yang perlu dilakukan:
- Jalankan
/modeldan pilih model yang termasuk dalam paket Anda - Jika Anda baru saja meningkatkan paket dan masih melihat pesan ini, jalankan
/logoutlalu/login. Token yang tersimpan mencerminkan paket Anda pada saat Anda masuk, sehingga peningkatan di claude.ai tidak berlaku dalam sesi yang sudah ada sampai Anda melakukan autentikasi ulang. - Lihat claude.com/pricing untuk model mana yang termasuk dalam setiap paket
Claude Code does not support this model
API menolak permintaan dengan 400 karena versi Claude Code Anda di bawah minimum yang diwajibkan. Entah model yang Anda pilih memerlukan versi yang lebih baru, yang diperiksa server per model, atau kebijakan organisasi Anda mewajibkannya. Respons 400 membawa kode errorclaude_code_version_too_old, dan pesan menyebutkan minimum mana yang berlaku.
- Jika Anda menjalankan
claude updatepada saluran rilis stable, perintah tersebut tidak membawa Anda melewati rilis stable terbaru, yang mungkin masih di bawah minimum yang diwajibkan. Pindah ke saluran latest, lalu perbarui lagi. Jika organisasi Anda mengunci saluran atau versi Anda melalui pengaturan terkelola, minta admin Anda untuk mengubahnya - Untuk kata-kata per model, Anda dapat terus bekerja dalam sesi saat ini dengan beralih ke model lain: jalankan
/modeldi CLI, panggilsetModel()pada objekQueryTypeScript SDK dalam mode input streaming, atau panggilset_model()padaClaudeSDKClientPython SDK - Untuk kata-kata kebijakan organisasi, lakukan pembaruan sebelum melanjutkan
Model is restricted by your organization’s settings
Admin organisasi Anda telah menonaktifkan model ini di konsol admin claude.ai, atau pengaturan terkelola mengecualikannya melalui allowlistavailableModels atau daftar deniedModels. Pemberitahuan muncul saat startup ketika --model, ANTHROPIC_MODEL, atau pengaturan model menyebutkan model yang dibatasi, dan pemberitahuan tersebut menyebutkan model yang digunakan sesi sebagai gantinya. Jika pengaturan terkelola tidak menyisakan model yang diizinkan untuk digunakan sesi, lihat Managed settings block the default model. Pemberitahuan penggantian juga dapat muncul di tengah sesi setelah admin menonaktifkan model yang sedang digunakan sesi di konsol admin claude.ai.
/model <name> untuk model yang dibatasi akan ditolak dan sesi mempertahankan model saat ini. Untuk model yang dinonaktifkan di konsol admin, penolakannya berbunyi Model '<name>' is restricted by your organization's settings. Run /model to choose a different model. Untuk model yang dikecualikan pengaturan terkelola, penolakannya berbunyi Model '<name>' is not available. Your organization restricts model selection.
Pemberitahuan yang diawali dengan nama agent, skill, atau perintah berarti pembatasan tersebut diterapkan pada model yang diminta subagent tersebut: subagent berjalan pada model pengganti dan model sesi Anda tidak berubah. Sebelum v2.1.223, Claude Code hanya menampilkan pemberitahuan untuk subagent yang diluncurkan dengan tool Agent.
Claude Code memperlakukan alias keluarga model, salah satu dari opus, sonnet, haiku, atau fable, sebagai permintaan untuk keluarga tersebut, bukan untuk versi terbarunya. Di Anthropic API dan di Claude Platform on AWS, alias keluarga yang dibatasi di-resolve ke versi terbaru dari keluarga tersebut yang diizinkan pengaturan organisasi Anda, dan pemberitahuan penggantian menyebutkan versi itu. Claude Code hanya menolak /model <alias> ketika setiap versi dari keluarga tersebut dibatasi. Sebelum v2.1.205, alias keluarga diganti atau ditolak hanya berdasarkan versi terbarunya, bahkan ketika versi yang lebih lama dari keluarga yang sama diizinkan.
Yang perlu dilakukan:
- Jalankan
/modeluntuk memilih dari model yang diizinkan organisasi Anda. Model yang dibatasi disembunyikan dari pemilih. - Jika model yang dibatasi diatur di
--model,ANTHROPIC_MODEL, fieldmodeldari file pengaturan, atau frontmattermodeldari subagent, skill, atau perintah, hapus atau perbarui nilai tersebut agar pemberitahuan tidak muncul lagi - Jika Anda memerlukan akses ke model yang dibatasi, minta admin organisasi Anda untuk mengaktifkannya. Lihat Pembatasan model organisasi.
Can’t switch to the default model
Anda memilih model Default, misalnya dengan memilih baris Default di pemilih/model atau mengetik /model default. Claude Code menolak pergantian tersebut, sehingga sesi mempertahankan model saat ini.
your organization's managed settings block it ... in "deniedModels": daftar deny terkelola memblokir model yang menjadi hasil resolve opsi Defaultyour organization allows only the models listed in "availableModels": allowlistavailableModelsterkelola denganavailableModelsMatchdiatur ke"exact"tidak menyertakan model yang menjadi hasil resolve opsi DefaultClaude Code couldn't read your organization's managed settings to check which models they allow: pengaturan terkelola tidak dapat dibaca, dan Claude Code menolak pergantian alih-alih menerapkannya tanpa pemeriksaan
- Untuk kata-kata
deniedModelsdanavailableModels, jalankan/modeldan pilih model yang diizinkan organisasi Anda berdasarkan nama - Minta administrator Anda untuk memperbarui pengaturan terkelola yang disebutkan pesan
- Untuk kata-kata
couldn't read, restart Claude Code; jika terus terjadi, minta administrator Anda untuk memeriksa pengaturan terkelola
Claude Code can't start di bawah pengaturan terkelola ini, lihat Managed settings block the default model.
Model switch was blocked by a PreModelSwitch hook
Sebuah hook PreModelSwitch tidak menyetujui pergantian model yang Anda atau klien minta, sehingga sesi mempertahankan model saat ini. Ketika pergantian berasal dari host Agent SDK atau Remote Control dan bukan dari perintah yang Anda ketik, pesannya berbunyiModel switch blocked by a PreModelSwitch hook tanpa menyebutkan model target.
- Alasan yang ditulis hook: hook PreModelSwitch memberikan alasan tersebut ketika menolak pergantian 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 pergantian. Perbaiki perintah yang macet atau naikkantimeouthook tersebut, lalu beralih lagi.confirmation required, and this session cannot ask: sebuah hook menjawabasktanpa alasan, dan permintaan kontrol tidak memiliki cara untuk menampilkan prompt konfirmasi. Perintah/modeldalam run-pmelaporkan kondisi yang sama dengan(run /model interactively to confirm)setelah alasan. Lakukan pergantian dari sesi interaktif, atau ubah keputusan hook untuk model ini.so organization-managed PreModelSwitch hooks could not be checked: Claude Code sebelum v2.1.323 menolak ketika tidak dapat mengetahui hook PreModelSwitch mana yang dikirimkan oleh plugin terkelola Anda. Teks sebelum frasa ini menyebutkan apa yang gagal. Untuk menghentikan penolakan, perbarui Claude Code. Agar hook dari plugin yang gagal juga berjalan, perbaiki plugin tersebut atau tanyakan kepada admin Anda. Untuk detailnya, mulaiclaude --debugdi shell Anda dan beralih model, lalu baca log debug.a PreModelSwitch hook failed before answeringatauPreModelSwitch hooks were cancelled (the control stream closed) before answering: run hook berakhir tanpa putusan, dan Claude Code tidak memperlakukannya sebagai persetujuan. Jalankanclaude --debuguntuk melihat apa yang gagal, lalu beralih lagi.
plugin hooks could not be loaded, so PreModelSwitch hooks could not be checked; see the debug log. Claude Code mencoba ulang pemuatan plugin sekali lalu menolak pergantian berikutnya dalam sesi, bahkan ketika organisasi Anda tidak mengelola plugin apa pun. Restart sesi untuk menjalankan pemuatan plugin lagi pada versi-versi tersebut.
Couldn’t save it as your default
Anda memilih model untuk disimpan sebagai default, misalnya dengan/model <name> atau Enter di pemilih /model, dan Claude Code tidak dapat menulis pilihan tersebut ke file pengaturan pengguna Anda, ~/.claude/settings.json. Perpindahan itu sendiri diterapkan, sehingga sesi saat ini berjalan pada model yang Anda pilih, tetapi default Anda tidak berubah dan sesi berikutnya dimulai dengan nilai lama.
can't be written (<code>): penulisan gagal dengan kode error sistem operasi dalam tanda kurung, sepertiEROFSketika file, atau file yang ditautkannya, berada di sistem file yang menolak penulisan. Jadikan file dapat ditulis dan beralih lagi. Jika tool lain menghasilkan file tersebut, atur kuncimodeldi tool itu sebagai gantinya; lihat Perubahan yang Anda buat di Claude Code hilang di sesi baru.isn't valid JSON: file di disk tidak dapat di-parse, dan Claude Code membiarkannya tidak tersentuh alih-alih menimpa konten yang tidak dapat dibacanya kembali. Perbaiki error sintaksis, lalu beralih lagi; lihat Memperbaiki file pengaturan yang rusak.
couldn't confirm it was saved as your default (~/.claude/settings.json is still being written) berarti penulisan belum selesai setelah tiga detik. Penulisan berlanjut di latar belakang, sehingga default mungkin masih tersimpan; periksa model mana yang digunakan sesi berikutnya saat dimulai, atau jalankan /model <name> lagi.
Sebelum v2.1.265, pemberitahuan menyatakan model tersebut saved as your default for new sessions bahkan ketika penulisan gagal.
Advisor is less capable than the current main model
Model advisor Anda berperingkat di bawah model utama sesi Anda, sehingga Claude Code mempertahankan pilihan tersebut tetapi tidak melampirkan advisor ke permintaan model utama.- Dalam sesi interaktif, notifikasi berbunyi
Advisor will not activate on the main model (advisor is less capable); subagents may still use it and may use more tokens · /advisor. - Ketika Anda meluncurkan dengan flag
--advisordalam mode non-interaktif, dan run tersebut bukan sesi latar belakang, sebuah peringatan dikirim ke stderr dan run tetap dimulai. Peringatan tersebut berbunyi"<advisor>" cannot advise "<main model>" (the advisor must be at least as capable as the main model). The advisor will not be used for the main model.Sesi interaktif hanya menulis peringatan tersebut ke log debug.
- Pilih advisor berperingkat lebih tinggi atau model utama berperingkat lebih rendah. Memilih model advisor menampilkan peringkat dan mencantumkan advisor yang diterima untuk setiap model utama.
- Biarkan advisor tetap diatur jika Anda ingin subagent yang modelnya dapat diberi saran oleh advisor tersebut tetap menggunakannya
thinking.type.enabled is not supported for this model
Versi Claude Code Anda lebih lama dari minimum untuk model yang dipilih. CLI mengirim konfigurasi thinking yang tidak lagi diterima model.- Jalankan
claude updatedan restart Claude Code. Opus 4.7 memerlukan v2.1.111 atau yang lebih baru. Opus 4.8 memerlukan v2.1.154 atau yang lebih baru. Sonnet 5 memerlukan v2.1.197 atau yang lebih baru. Opus 5 memerlukan v2.1.219 atau yang lebih baru. Opus 5.5 memerlukan v2.1.280 atau yang lebih baru. Sonnet 5.5 memerlukan v2.1.284 atau yang lebih baru - Pada saluran rilis stable, pembaruan tidak membawa Anda melewati rilis stable terbaru, yang mungkin masih lebih lama dari versi-versi ini. Pindah ke saluran latest, lalu perbarui
- Jika Anda tidak dapat meningkatkan versi, jalankan
/modeldan pilih Opus 4.6 atau Sonnet 4.6 sebagai gantinya - Jika Anda mengalami ini di Agent SDK, tingkatkan paket SDK sebagai gantinya. Opus 4.8 memerlukan TypeScript SDK v0.3.154 atau yang lebih baru dan Python SDK v0.2.88 atau yang lebih baru. Sonnet 5 memerlukan TypeScript SDK v0.3.197 atau yang lebih baru. Opus 5 memerlukan TypeScript SDK v0.3.219 atau yang lebih baru. Opus 5.5 memerlukan TypeScript SDK v0.3.280 atau yang lebih baru. Sonnet 5.5 memerlukan TypeScript SDK v0.3.284 atau yang lebih baru
Effort isn’t available with thinking turned off
Anda menonaktifkan extended thinking dan menjalankan dengan tingkat effort di atashigh. Model tidak menerima kombinasi tersebut, sehingga API menolak permintaan.
· bervariasi menurut sesi: dalam sesi non-interaktif berbunyi use --effort high (or the effortLevel setting), dan dalam sesi yang dijalankan aplikasi Claude Desktop berbunyi you can lower effort to High.
Yang perlu dilakukan:
- Turunkan tingkat effort ke
highatau lebih rendah. - Aktifkan kembali thinking, misalnya dengan menghapus pengaturan
MAX_THINKING_TOKENSatau menghapus"alwaysThinkingEnabled": falsedari pengaturan Anda.
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 dengan tingkat effort yang Anda atur, sehingga Opus 5 menolak setiap permintaan di atas high dengan thinking dinonaktifkan. Claude Code kini mengirim effort high sebagai gantinya ke model yang diketahuinya menolak kombinasi tersebut, seperti Opus 5.
Thinking budget melebihi batas output
Thinking budget extended thinking yang dikonfigurasi melebihi panjang respons maksimum, sehingga tidak ada ruang tersisa untuk jawaban yang sebenarnya.- Naikkan
CLAUDE_CODE_MAX_OUTPUT_TOKENSdi atas thinking budget - Lihat Extended thinking untuk mengetahui bagaimana budget berinteraksi dengan panjang output
Response exceeded the output token maximum
Balasan Claude mencapai jumlah token output terbesar yang diizinkan permintaan dan terpotong di sana:a request sent without streaming berarti permintaan streaming gagal dan Claude Code mengirimkannya ulang tanpa streaming, yang membatasi balasan hingga 64.000 token output. Sebelum v2.1.299, balasan yang terpotong pada permintaan yang dikirim ulang seperti itu mengakhiri giliran tanpa pesan ini, seolah-olah balasan tersebut lengkap.
Yang perlu dilakukan:
- Jika Claude menulis sebagian teks sebelum balasan terpotong, balas
continuedalam sesi interaktif untuk meminta sisanya. Teks tersebut tetap berada dalam percakapan. - Jika pesan meminta Anda mengatur
CLAUDE_CODE_MAX_OUTPUT_TOKENS, lihatCLAUDE_CODE_MAX_OUTPUT_TOKENSuntuk bagaimana nilainya dibatasi dan Mengatur environment variable untuk tempat mengaturnya - Agar setiap balasan tetap di bawah batas, minta Claude memberikan output dalam bagian-bagian yang lebih kecil, seperti satu file atau satu bagian per balasan
Ketidakcocokan tool use atau thinking block
Riwayat percakapan mencapai API dalam keadaan tidak konsisten.tool_use, tool_result, dan thinking dalam riwayat tidak lagi sesuai dengan yang diharapkan API.
Yang perlu dilakukan:
- Jika Anda menggunakan Opus 4.7 atau Opus 4.8, jalankan
claude updateterlebih dahulu. Versi sebelum v2.1.156 dapat memicu error ini selama penggunaan tool normal, dan/rewindtidak menghilangkannya. - 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.
Invalid data in redacted_thinking block
API menolak permintaan dengan 400 karena tidak dapat menerima blokredacted_thinking yang dibawa oleh giliran sebelumnya dalam riwayat percakapan.
- Jika Anda menggunakan v2.1.281 atau yang lebih lama dan setiap giliran gagal dengan error ini, jalankan
claude updatedan lanjutkan sesi - Jika error tetap ada, jalankan
/clearuntuk memulai percakapan yang tidak membawa blok tersebut
Unsupported tool content removed
Ketika Claude Code terhubung langsung ke Anthropic API dan memuat atau mempratinjau sesi yang tersimpan, Claude Code menghapus konten tool yang tidak diterima Anthropic API dan meninggalkan baris ini di tempat konten yang dihapus berada di antara dua thinking block:ANTHROPIC_BASE_URL yang menerjemahkan panggilan tool dari penyedia lain. Claude Code hanya menghapusnya ketika sesi terhubung langsung ke Anthropic API, dan memuat riwayat tersimpan apa adanya ketika sesi berjalan melalui proxy atau pada penyedia lain. Sebelum v2.1.246, Claude Code mengirim tool use dan hasilnya kembali ke API, dan setiap giliran dari sesi yang dilanjutkan gagal dengan error 400 seperti messages.1.content.0.server_tool_use.name: Input should be 'web_search', 'web_fetch', ....
Yang perlu dilakukan:
- Tidak ada yang perlu dilakukan ketika Anda melihat baris placeholder. Sesi berlanjut tanpa konten yang dihapus.
- Jika setiap giliran dari sesi yang dilanjutkan justru gagal dengan error 400, jalankan
claude updatedan lanjutkan sesi lagi. Versi sebelum v2.1.246 tidak menghapus konten tersebut.
role ‘system’ must precede an ‘assistant’ message
API menolak permintaan dengan 400 karena sebuah pesan sistem berada di posisi dalam percakapan yang tidak diterimanya:use the top-level 'system' parameter for the initial system prompt, mendapatkan pemulihan yang sama.
Ketika error tetap muncul, pesan sistem yang ditolak bukan pesan yang dapat dihapus Claude Code. Hal itu biasanya berarti proxy atau LLM gateway di antara Claude Code dan API menambahkan pesan sistemnya sendiri.
Yang perlu dilakukan:
- Jika error berulang di setiap giliran di balik proxy atau gateway yang dikonfigurasi melalui
ANTHROPIC_BASE_URL, hubungkan tanpa proxy untuk memastikan sumbernya, dan laporkan error tersebut kepada pihak yang mengoperasikannya - Jalankan
/clearuntuk memulai percakapan baru. Jika error muncul kembali di sana juga, penyebabnya berada di jalur permintaan, bukan di percakapan yang tersimpan.
Invalid encrypted_content in search_result block
API menolak permintaan dengan 400 karena riwayat percakapan berisi konten pencarian web terhosting yang tidak dapat didekripsinya. Kata-katanya menyebutkan field yang tidak dapat dibacanya:encrypted_stdout menyebutkan output dari program eksekusi kode terhosting yang membaca hasil tersebut, yang juga dienkripsi API. API menolak permintaan yang memutar ulang konten yang tidak dapat didekripsinya, seperti konten yang dihasilkan untuk organisasi lain.
Tool WebSearch milik Claude Code sendiri mencatat hasil pencarian sebagai teks biasa, sehingga blok-blok ini biasanya masuk ke percakapan melalui proxy atau LLM gateway yang menjalankan pencarian web terhosting sendiri.
Untuk ketiga kata-kata pencarian web, Claude Code tidak menyertakan panggilan pencarian, hasil, dan kutipan dalam apa yang dikirimnya dan mencoba ulang permintaan sekali, sehingga sesi berlanjut tanpa menampilkan error. Kata-kata encrypted_stdout tidak memiliki pemulihan seperti itu, sehingga pesan tersebut tetap sampai kepada Anda. Sebelum v2.1.282, Claude Code juga mempertahankan blok pencarian web yang ditolak, dan setiap giliran berikutnya serta /compact gagal dengan cara yang sama.
Yang perlu dilakukan:
- Jika Anda menggunakan v2.1.281 atau yang lebih lama dan setiap giliran gagal dengan salah satu kata-kata pencarian web, jalankan
claude updatedan lanjutkan sesi - Jika error tetap ada, atau pesan menyebutkan
encrypted_stdout, jalankan/rewinduntuk mundur ke checkpoint sebelum giliran yang menambahkan konten tersebut, atau jalankan/clearuntuk memulai percakapan yang tidak membawanya - Jika Anda menjalankan Claude Code di balik proxy atau gateway, laporkan error tersebut kepada pihak yang mengoperasikannya
Penolakan Usage Policy
API menolak untuk merespons karena konten dalam percakapan memicu pemeriksaan Usage Policy. Jika pesan menyertakan barisDetails: `[reasoning_extraction]`, lihat Safeguards menandai permintaan untuk penalaran Claude.
Pesan tersebut menyertakan Request ID dan Message ID yang dapat Anda kutip kepada tim dukungan jika Anda yakin penolakan tersebut keliru.
Claude jika tidak ada model yang tercatat.
Pemeriksaan ini mengevaluasi seluruh percakapan, bukan hanya prompt terakhir Anda, sehingga mengirim pesan baru dalam sesi yang sama biasanya memicu kembali penolakan yang sama. Hal yang sama berlaku setelah keluar dan membuka kembali sesi dengan --continue atau --resume, karena transkrip di disk masih berisi konten pemicunya. Di Amazon Bedrock, Google Cloud’s Agent Platform, dan Microsoft Foundry, pesan ini juga mencakup permintaan yang ditandai oleh langkah-langkah keamanan model sebagai topik keamanan siber. Lihat Langkah-langkah keamanan menandai topik keamanan siber.
Sebelum v2.1.219, pesannya 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
/rewinduntuk kembali ke checkpoint sebelum giliran yang memicu penolakan, lalu ubah susunan kata atau gunakan pendekatan yang berbeda. Lihat Checkpointing. - Jika Anda tidak dapat mengidentifikasi giliran mana yang menyebabkannya, jalankan
/clearuntuk memulai percakapan baru dalam proyek yang sama. Percakapan Anda sebelumnya tetap tersimpan di disk dan tetap tersedia di/resume. - Dalam mode non-interaktif (
-p), di mana rewind tidak tersedia, coba ulang dengan prompt yang susunan katanya diubah dalam sesi baru tanpa--continue. Pemeriksaan kebijakan berbeda-beda untuk setiap model, sehingga beralih ke model lain dengan--modeljuga dapat mengatasi penolakan dalam beberapa kasus.
Langkah-langkah keamanan menandai topik keamanan siber
Langkah-langkah keamanan model menandai konten dalam percakapan sebagai topik keamanan siber. Pesan tersebut menyebutkan nama model yang menandai permintaan:Details: `[reasoning_extraction]`, lihat Safeguards menandai permintaan untuk penalaran Claude.
Pesan ini menautkan ke Cyber Verification Program, yang memberikan akses untuk pekerjaan keamanan siber yang sah. Model dengan fallback model otomatis menampilkan pesan yang berbeda, tanpa tautan ini; pada Opus 5.5 dan Sonnet 5.5 pesan tersebut diawali dengan <model>'s safeguards flagged this session. Bagian tersebut juga membahas kapan Claude Code beralih model sebagai gantinya.
Di Amazon Bedrock, Google Cloud’s Agent Platform, dan Microsoft Foundry, penandaan keamanan siber menghasilkan pesan penolakan Usage Policy sebagai gantinya.
Yang harus dilakukan:
- Jika pekerjaan Anda memerlukan konten ini, ajukan akses melalui Cyber Verification Program
- Jika permintaan Anda tidak berkaitan dengan topik keamanan siber, jalankan
/feedbackuntuk melaporkan positif palsu tersebut - Untuk tetap bekerja dalam sesi yang sama, tekan Esc dua kali atau jalankan
/rewinduntuk kembali ke checkpoint sebelum giliran yang memicu penandaan, lalu gunakan pendekatan yang berbeda. Lihat Checkpointing.
- Dari v2.1.219 hingga v2.1.296, pesan tersebut juga dapat menyertakan
Apply to the Cyber Verification Program to reduce these interruptions.sebelum kalimat penutupnya - Dari v2.1.203 hingga v2.1.218, pesannya 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 dengan tautan pusat bantuan yang sama. Dalam sesi interaktif, pesan tersebut dilanjutkan denganIf you were not engaging in a cybersecurity topic, please send feedback via /feedback. - Sebelum v2.1.203, pesannya berbunyi
<model>'s safeguards flagged this message for a cybersecurity topic. If your work requires this access, you can apply for an exemption:diikuti dengan tautan formulir pengecualian
Safeguards menandai permintaan untuk penalaran Claude
API menolak permintaan karena safeguards menandainya sebagai permintaan agar model mereproduksi penalaran internalnya dalam respons. API menamai kategori penolakan inireasoning_extraction, dan pesan penolakan menyertakan baris berikut:
Details.
Yang harus dilakukan:
- Hapus atau ubah susunan kata instruksi apa pun yang meminta Claude menuliskan thinking atau penalarannya secara verbatim atau dalam format tetap, seperti bagian
<thinking>, bagian scratchpad, atau fieldreasoningdalam output JSON. Instruksi tersebut dapat berada di prompt Anda atau di kustomisasi yang dimuat Claude Code bersamanya, seperti CLAUDE.md, skill, prompt subagent, gaya output, atau deskripsi tool MCP. - Untuk memeriksa apakah suatu kustomisasi merupakan pemicunya, jalankan
claude --safe-modedi terminal Anda untuk memulai sesi dengan kustomisasi dinonaktifkan, lalu kirim prompt yang sama - Setelah Anda mengubah kustomisasi, mulai sesi baru
- Untuk mengubah susunan kata prompt yang sudah Anda kirim, lihat Rewind dan ringkas
- Anda tetap dapat meminta Claude menjelaskan jawabannya. Mintalah penjelasan singkat, bukti di balik suatu hasil, atau ringkasan tindakan yang diambilnya. Untuk membaca ringkasan pemikiran Claude, lihat
showThinkingSummaries. - Untuk contoh lainnya, dan apa yang harus dilakukan jika permintaan yang susunan katanya telah diubah masih ditolak, lihat Keep reasoning in thinking blocks
Output blocked by content filtering policy
Filter konten output API menghentikan respons yang sedang dihasilkan Claude. Teks pesan berasal dari API:- Ubah susunan kata pesan terakhir Anda atau gunakan pendekatan yang berbeda
- Untuk kembali ke checkpoint sebelum giliran yang memicu pemblokiran, tekan Esc dua kali atau jalankan
/rewind. Lihat Checkpointing
Kesalahan baris perintah
Kesalahan ini berasal dari baris perintahclaude dan subperintahnya, dari nama perintah yang Anda kirimkan di prompt, dan dari perintah seperti /security-review yang mengumpulkan konteks dengan menjalankan perintah shell sebelum prompt-nya berjalan. Kesalahan ini juga berasal dari /tui, yang meluncurkan ulang CLI.
Konflik antara --bg dan --print
Pesan ini memerlukan Claude Code v2.1.198 atau yang lebih baru. Anda menggabungkan --bg dengan -p atau --print dalam pemanggilan claude yang sama. --bg memulai sesi latar belakang yang nantinya Anda sambungkan dengan claude agents, sedangkan --print berjalan secara non-interaktif dan tidak pernah memulai sesi interaktif yang disambungkan oleh claude agents. Sebelum v2.1.198, kombinasi ini secara diam-diam membuat pekerjaan latar belakang yang tidak pernah dapat disambungkan.
- Hapus
-patau--print.--bgmenerima prompt sebagai argumen posisionalnya, sehinggaclaude --bg "<task>"adalah perintah lengkapnya. Lihat Dispatch agent baru dari shell Anda. - Untuk menjalankan prompt secara non-interaktif dan mencetak hasilnya alih-alih membuat sesi latar belakang, hapus
--bgdan jalankanclaude -p "<task>"
Couldn’t tell whether --bg is a flag or text
Anda menjalankan claude dengan --bg atau --background pada posisi di mana Claude Code tidak dapat membedakan apakah Anda memaksudkannya sebagai flag latar belakang atau sebagai teks. Perintah tersebut tidak memulai apa pun, mencetak baris ini, dan keluar dengan kode 1:
--background, baris tersebut akan menyebut --background sebagai gantinya.
Yang harus dilakukan:
- Untuk memulai sesi latar belakang, jalankan kembali perintah di shell Anda dengan flag diletakkan pertama:
claude --bg --name nightly-audit "<task>"
Konflik antara flag system prompt dan bentuk file-nya
Anda memberikan--append-subagent-system-prompt bersama dengan --append-subagent-system-prompt-file dalam satu pemanggilan claude, sehingga claude keluar dengan kode 1 alih-alih memulai sesi:
claude keluar dengan cara yang sama ketika Anda memberikan --system-prompt dengan --system-prompt-file, atau --append-system-prompt dengan --append-system-prompt-file, karena pasangan tersebut berkonflik alih-alih digabungkan. Pada versi tersebut, pesan menyebutkan pasangan yang Anda gabungkan.
Yang perlu dilakukan:
- Pertahankan satu bentuk flag dan hapus yang lain. Untuk menggabungkan file prompt tetap dengan teks per-run, gabungkan teks tersebut ke dalam file sebelum meluncurkan alih-alih memberikan kedua flag
Konfigurasi --agents tidak valid
Nilai yang Anda berikan ke --agents tidak valid, sehingga claude keluar dengan kode 1 alih-alih memulai sesi. Ketika Anda memberikan --safe-mode atau mengatur CLAUDE_CODE_SAFE_MODE, Claude Code mengabaikan --agents sepenuhnya. Dengan --resume atau --continue, nilai JSON inline tidak diperiksa dan sesi dimulai; nilai yang dibaca dari file diperiksa pada setiap peluncuran. Sebelum v2.1.242, Claude Code tetap memulai sesi.
- Ketika nilai diawali dengan
{tetapi tidak dapat diurai sebagai JSON, atau isi file--agentstidak dapat diurai, Claude Code mencetak satu barisinvalid JSON:yang memuat pesan dari pengurai JSON itu sendiri - Ketika nilai dapat diurai tetapi definisi agent tidak sesuai dengan skema untuk subagent yang didefinisikan melalui CLI, Claude Code mencetak satu baris per masalah
- Ketika nama agent diawali dengan
-, Claude Code mencetak<name>: agent names must not start with '-'
…and N more.
Dengan --print, --agents juga menerima path ke file JSON sebagai pengganti objek inline. Sebelum v2.1.281, --agents hanya menerima JSON inline dan memperlakukan path file sebagai JSON yang tidak valid. Bentuk file memiliki penolakannya sendiri, yang dicetak sebagai pengganti pesan ini, termasuk yang berikut:
Error: --agents takes a JSON object, or a file path only with --print (-p): Claude Code membaca nilai sebagai path file dalam sesi interaktif. Berikan definisi sebagai JSON inline, atau tambahkan-puntuk membacanya dari file.Error: --agents file not found: <path>: tidak ada file di path tersebut. Nilai yang tidak diawali dengan{dan bukan JSON yang valid dibaca sebagai path, sehingga JSON inline yang dirusak oleh shell Anda juga dapat gagal dengan cara ini. Periksa path atau tanda kutipnya dan jalankan perintah lagi.
- Perbaiki setiap masalah yang dicantumkan pesan, lalu jalankan perintah lagi. Lihat field yang diterima subagent yang didefinisikan melalui CLI.
Sesi cloud tidak dapat dibuat dari sesi --restricted
Ketika Anda memulai sesi dengan --restricted, Claude Code menolak membuat sesi cloud darinya, karena sesi baru akan berjalan di luar proses yang dibatasi dan tidak akan menerapkan mode terbatas. Claude Code menolak di sisi klien, sebelum menghubungi server, sehingga tidak ada sesi cloud yang dibuat:
- Jalankan tugas secara lokal di sesi terbatas
- Jika Anda mengendalikan cara sesi diluncurkan, mulai sesi
claudebaru tanpa--restricteddan buat sesi cloud dari sana
--restricted; versi sebelumnya menolak flag itu sendiri dengan kesalahan opsi tidak dikenal.
Sesi cloud dinonaktifkan oleh kebijakan organisasi Anda
Kebijakanallow_remote_sessions organisasi Anda dimatikan, sehingga sesi cloud dan perintah yang menggunakannya tidak tersedia:
/teleport, /remote-env, atau /web-setup. Sebelum v2.1.268, mengirimkan salah satu perintah tersebut mengembalikan Unknown command.
Jika pesan justru menyebutkan kredensial yang digunakan sesi ini dan diakhiri dengan Cloud sessions use your claude.ai login., lihat Cloud sessions use your claude.ai login. Jika Claude Code sama sekali tidak dapat memuat kebijakan organisasi Anda, Anda akan melihat pesan yang berbeda sebagai gantinya.
Yang perlu dilakukan:
- Minta Owner di organisasi Anda untuk mengaktifkan sesi cloud di pengaturan admin Claude Code di claude.ai/admin-settings/claude-code
Cloud sessions use your claude.ai login
Ketika penolakan kebijakan menyebutkan kredensial yang digunakan sesi ini dan diakhiri dengan kalimat ini, Claude Code memeriksa kebijakan sesi cloud dari organisasi yang menerbitkan kredensial tersebut. Organisasi tersebut dapat berbeda dari organisasi tempat login claude.ai Anda berada:--cloud atau --teleport. Sebelum v2.1.296, Claude Code juga mencetak bentuk yang meminta Anda menghubungi admin organisasi dalam kasus ini.
Couldn’t verify your organization’s policy for cloud sessions
Pesan-pesan ini berarti Claude Code tidak dapat memuat kebijakan organisasi Anda, yang diperiksanya sebelum membuat, melanjutkan, atau mengirim pesan ke sesi cloud. Selama permintaan kebijakan belum selesai, pesannya adalah:/teleport atau /web-setup, juga memberikan pesan ini. Hal ini terjadi bahkan ketika shell Anda akan mencetak bentuk Cloud sessions aren't available:, dan kalimat keduanya berbunyi Check your network connection, then restart Claude Code and try again.
Setelah permintaan kebijakan gagal, pesan menyebutkan apa yang gagal. Hal ini berlaku ketika Anda memulai, melanjutkan, atau mengirim pesan ke sesi cloud dari shell Anda dengan flag seperti --cloud atau --teleport. Tanpa rute ke API, pesannya berbunyi:
ANTHROPIC_API_KEY, pesan juga dapat menyebutkannya dan meminta Anda untuk menghapusnya:
Couldn't verify.
Yang harus dilakukan:
- Untuk pesan
Couldn't verify, periksa koneksi jaringan Anda dan coba lagi. Di dalam sesi, mulai ulang Claude Code terlebih dahulu - Untuk pesan
Cloud sessions aren't available:, lakukan apa yang diperlukan oleh penyebabnya, seperti memeriksa proxy Anda atau menghapus kredensial yang disebutkannya, lalu jalankan perintah lagi
Nothing was stashed because a folder replaced a tracked file
Pesan ini berarti sebuah folder di checkout Anda kini berada di tempat yang sebelumnya ditempati file atau link yang dilacak git. Pesan ini muncul setelah Anda memilih opsi stash saat menarik sesi cloud ke terminal Anda, misalnya denganclaude --teleport atau /teleport. Melakukan stash pada kondisi tersebut dapat menghapus file di dalam folder, sehingga Claude Code menolak stash dan membiarkan checkout serta index Anda tidak berubah:
- Lakukan commit atas perubahan tersebut atau pindahkan folder ke tempat lain, seperti yang disebutkan pesan, lalu jalankan teleport lagi
Nilai --json-schema bukan JSON Schema yang valid
Skema yang Anda berikan ke --json-schema dalam mode non-interaktif gagal dikompilasi sebagai JSON Schema, sehingga claude keluar dengan kode 1 alih-alih menjalankan prompt. Sebelum v2.1.205, skema yang tidak valid menghasilkan output tidak terstruktur tanpa kesalahan, dan setiap skema yang menggunakan kata kunci format diperlakukan sebagai tidak valid.
format, seperti "format": "email", adalah valid: Claude Code menerima format sebagai anotasi dan tidak menerapkannya.
Claude Code menjalankan dua pemeriksaan sebelum kompilasi skema: Claude Code menolak nilai yang bukan JSON yang dapat diurai dengan Error: --json-schema is not valid JSON, dan JSON valid yang bukan objek dengan Error: --json-schema must be a JSON object.
Yang perlu dilakukan:
- Perbaiki bagian skema yang disebutkan oleh diagnostik, lalu jalankan ulang perintah
- Lihat Mendapatkan output terstruktur untuk skema dan perintah yang berfungsi
File pengaturan melebihi batas 2MiB
File yang Anda berikan ke--settings berukuran lebih dari 2 MiB, sehingga claude keluar dengan kode 1 saat startup alih-alih memuatnya. Sebelum v2.1.214, Claude Code membaca file tanpa pemeriksaan ukuran, dan file berukuran beberapa gigabyte atau file perangkat seperti /dev/zero membuat memori bertambah tanpa batas.
--settings yang bukan file biasa dengan cara yang sama: perangkat, FIFO, atau socket melaporkan Error: Cannot use settings file (Not a regular file (device, FIFO, or socket)) diikuti path-nya, dan direktori melaporkan alasan EISDIR.
Yang perlu dilakukan:
- Arahkan
--settingske file pengaturan JSON biasa yang berukuran di bawah 2 MiB. Lihat Pengaturan untuk formatnya.
Configuration error in ~/.claude.json
Claude Code tidak dapat mem-parse~/.claude.json, file yang menyimpan detail akun Anda, server MCP, dan status per proyek. Startup non-interaktif seperti claude -p keluar dengan exit code 1.
Ketika Claude Code menemukan cadangan, output menyebutkannya dan mencetak baris cp yang menyalinnya kembali:
- Output memiliki baris
cp: jalankan baris tersebut di terminal Anda. Di Windows, jalankan di PowerShell. - Output tidak memiliki baris
cp, atau kesalahan muncul kembali setelah Anda menjalankannya: jika~/.claude.jsonmasih berisi konfigurasi Anda, perbaiki JSON-nya. Jika tidak bisa, salin file.claude.json.backup.<timestamp>lain dari~/.claude/backups/untuk menimpanya jika ada, atau ganti namanya. Tanpa file di~/.claude.json, Claude Code dimulai dengan pengaturan default dan tanpa isi yang dimuat file tersebut. ~/.claude.jsontidak lagi berisi konfigurasi Anda: temukan file.claude.json.corrupted.<timestamp>yang masih berisi konfigurasi tersebut, di~/.claude/backups/atau di direktori home Anda. Perbaiki JSON-nya, lalu salin untuk menimpa~/.claude.json. Jika Anda tidak dapat menemukan atau memperbaikinya, coba langkah yang sama dengan file.claude.json.backup.<timestamp>yang berisi konfigurasi Anda. Jika tidak ada yang berisi, ganti nama~/.claude.jsondan tambahkan kembali server MCP Anda denganclaude mcp add.
Claude configuration file was empty and no backup holds anything
Pesan ini saat startup berarti file yang disebutkannya kosong dan tidak ada salinan.backup dari file tersebut yang berisi apa pun. Claude Code dimulai dengan nilai default untuk apa yang disimpan file tersebut. File settings.json dan .mcp.json Anda adalah file terpisah.
- Siapkan kembali apa yang telah Anda konfigurasikan di file tersebut. Misalnya, tambahkan server MCP cakupan
userdanlocalAnda denganclaude mcp adddari terminal. - Masuk kembali jika Claude Code memintanya
Direktori saat ini sudah tidak ada
Anda memulaiclaude dari direktori yang dihapus atau dipindahkan setelah shell Anda memasukinya, misalnya worktree atau direktori sementara yang dihapus oleh shell lain. Claude Code tidak dapat membaca direktori kerjanya, sehingga keluar dengan kode 1 sebelum memulai sesi, baik dalam mode interaktif maupun non-interaktif. Sebelum v2.1.239, Claude Code mengalami crash dengan sumber bundle yang diminifikasi dan stack ENOENT ... uv_cwd mentah di stderr alih-alih pesan ini.
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 tersebut. Perintah lain yang membaca folder tersebut gagal dengan cara yang sama: ls di sana melaporkan Operation not permitted, bahkan dengan sudo.
Yang perlu dilakukan:
- Pindah ke direktori yang ada, seperti direktori home atau direktori proyek Anda, lalu jalankan
claudelagi - Jika direktori dibuat ulang di path yang sama, shell Anda masih memegang direktori yang telah dihapus. Jalankan
cd "$PWD"atau keluar lalu masuk kembali ke direktori tersebut, lalu jalankanclaudelagi - Untuk
EPERMdi macOS, tutup aplikasi terminal Anda dengan Cmd+Q, buka lagi, kembali ke folder tersebut, dan jalankanclaude. Jikalsdi folder tersebut masih gagal, buka System Settings > Privacy & Security > Files and Folders, aktifkan folder tersebut untuk aplikasi terminal Anda, lalu buka kembali terminal
Direktori sementara ditolak atau tidak dapat dibuat
Di macOS dan Linux, Claude Code membuat direktori sementara privat saat startup,claude-<uid> di bawah direktori sementara sistem atau override CLAUDE_CODE_TMPDIR. Ketika direktori tidak dapat dibuat, atau entri yang sudah ada di path tersebut gagal dalam pemeriksaan keamanan, Claude Code mencetak kegagalan ke stderr dan keluar dengan kode 1 alih-alih memulai sesi:
- Untuk
could not be createdyang diikutiis full (ENOSPC), kosongkan ruang disk pada volume yang disebut pesan. Ketika pesan justru mengatakanyour disk quota on the volume holding /tmp is used up (EDQUOT), hapus file milik Anda sendiri di volume tersebut yang tidak lagi Anda perlukan - Untuk bentuk
Refusing to use it, hapus entri yang disebutkan itu sendiri, bukan yang ditunjuk oleh tautan, dan mulai Claude Code lagi; untuk bentukowned by uid, hanya administrator atau pengguna tersebut yang dapat menghapusnya - Untuk
is not readable, jalankanchmod 0700pada direktori yang disebutkan, atau hapus direktori tersebut dan mulai lagi - Dalam semua kasus ini, atur
CLAUDE_CODE_TMPDIRke direktori yang Anda kendalikan dan mulai Claude Code lagi, tanpa mengubah path yang ditolak
ENOSPC: no space left on device, mkdir '/tmp/claude-501', dan langkah-langkah yang sama berlaku.
Claude Code could not save because the disk is full
Baris ini di stderr setelah runclaude -p berarti disk penuh atau kuota disk Anda habis, sehingga Claude Code tidak dapat menyimpan semua hal dari run tersebut:
json, run keluar dengan kode 1, dan jawaban sudah dicetak. Dengan output stream-json, run mempertahankan exit code biasanya, dan jawaban tetap diterima.
Yang harus dilakukan:
the disk is full (ENOSPC): sebelum run berikutnya, kosongkan ruang pada disk yang menyimpan path di pesanyour disk quota is used up (EDQUOT): sebelum run berikutnya, kosongkan ruang atau minta kuota yang lebih besar
Direktori tidak dapat di-resolve ke lokasi sebenarnya
Anda menjalankan/add-dir untuk subdirektori dari direktori kerja Anda, dan Claude Code tidak dapat me-resolve direktori tersebut ke lokasi sebenarnya.
Anda sudah memiliki akses file ke subdirektori dari direktori kerja, sehingga /add-dir hanya memuat skill, perintah, dan agent-nya. Sebelum memuatnya, Claude Code memeriksa bahwa lokasi sebenarnya direktori tersebut, dengan semua symlink di-resolve, berada di dalam direktori kerja. Ketika Claude Code tidak dapat me-resolve lokasi tersebut, Claude Code tidak memuat apa pun dan menampilkan pesan ini:
- Periksa bahwa path tersebut menunjuk ke direktori nyata di dalam direktori kerja, lalu jalankan
/add-dirlagi - Pesan ini tidak mengubah akses file Anda; pesan ini hanya melaporkan bahwa konten
.claude/direktori tersebut tidak dimuat
/add-dir <subdirectory> ketika direktori kerja berada di automount /net/<host>, tempat Claude Code memang tidak me-resolve path berdasarkan desain; direktorinya baik-baik saja dan mencoba ulang tidak membantu.
Workspace tidak dipercaya saat memulai Remote Control
Jika
claude ultrareview mencetak Error: Workspace not trusted, lihat Workspace not trusted when running claude ultrareview sebagai gantinya.claude remote-control atau alias claude rc-nya di direktori yang belum Anda percayai, dan perintah tersebut tidak dapat menanyakan apakah Anda ingin memercayainya. Misalnya, input standar atau output standar perintah bukan terminal karena salah satunya dialihkan atau di-pipe. Perintah keluar dengan kode 1:
Error: Workspace not trusted. muncul di terminal yang terlalu kecil untuk menampilkan apa yang diaktifkan dengan memercayai direktori, atau terminal yang tidak melaporkan ukurannya. Perbesar jendela atau beralih ke jendela terminal biasa, lalu jalankan claude rc lagi.
Di direktori home Anda, pesannya berbeda, karena dialog kepercayaan workspace tidak pernah menyimpan kepercayaan untuk direktori home, sehingga menerimanya di sana tidak dapat memenuhi pemeriksaan ini. Sebelum v2.1.214, direktori home menampilkan pesan di atas, yang sarannya tidak dapat berhasil di sana.
n atau menekan Enter pada pertanyaan Trust <directory>?, perintah mencetak pesan Remote Control did not start yang menyebutkan direktori tersebut dan keluar dengan kode 1. Jalankan claude rc lagi untuk menjawab y.
Yang perlu dilakukan:
- Percayai direktori tersebut dari terminal terlebih dahulu: jalankan
claudedi sana dan terima dialog kepercayaan workspace, lalu jalankan perintah awal Anda lagi - Di direktori home Anda, pindah ke direktori proyek dan mulai Remote Control di sana
Workspace not trusted when running claude ultrareview
Di folder yang belum Anda percayai, ketikaclaude ultrareview tidak dapat menanyakan apakah Anda memercayainya, run keluar dengan exit code 1 sebelum review dimulai:
claude ultrareview --json > findings.json, berarti standard output bukan terminal.
Yang harus dilakukan:
- Dalam skrip atau job CI, tambahkan
--trust-workspaceuntuk memercayai folder tersebut untuk eksekusi itu:claude ultrareview --trust-workspace. Tambahkan hanya untuk kode yang Anda percayai, karena git dan Claude Code kemudian dapat menjalankan program yang disebutkan dalam konfigurasi git dan pengaturan proyek di folder tersebut. Untuk pull request yang kodenya tidak Anda percayai, jalankan review dari branch yang Anda percayai. - Di mesin Anda sendiri, jalankan
claudedi folder tersebut dan terima dialog kepercayaan workspace, lalu jalankan perintah asli Anda lagi
/ultrareview dan /code-review ultra dapat berhenti dengan Ultrareview did not start: "<folder>" is not trusted, and this session started without asking whether you trust it. Mulai claude di folder tersebut tanpa menetapkan IS_DEMO, terima dialog kepercayaan workspace, dan jalankan perintah tersebut di sesi baru.
Setiap pesan berikut dari claude ultrareview berarti tidak ada review yang dimulai dan exit code-nya adalah 1:
Error: Workspace not trusted. This terminal ...: terminal tidak melaporkan jumlah baris dan kolom, atau tidak dapat memuat pertanyaan kepercayaan beserta peringatannya. Perbesar terminal atau gunakan terminal yang melaporkan ukurannya, lalu jalankanclaude ultrareviewlagi. Di luar direktori home Anda, Anda juga dapat menjalankanclaudedi folder tersebut sekali dan menerima dialog kepercayaan, sehingga run berikutnya di sana tidak bertanya.Error: Workspace not trusted. <folder> is your home directory: karena kepercayaan untuk direktori home Anda tidak pernah disimpan, menjalankanclaudedi sana terlebih dahulu tidak dapat membantu. Jalankanclaude ultrareviewdari direktori proyek sebagai gantinya, setelah menjalankanclaudedi sana sekali untuk menerima dialog kepercayaan, atau tambahkan--trust-workspace.No answer in time.diikutiError: Workspace not trusted: pertanyaanTrust <folder>? [y/N]tidak dijawab selama 5 menit. Jalankanclaude ultrareviewlagi dan jawab pertanyaan tersebut.Ultrareview did not start: <folder> is not trusted: Anda menolak pada pertanyaanTrust <folder>? [y/N], misalnya dengan menjawabnatau menekan Enter. Untuk memulai review, jalankanclaude ultrareviewlagi dan jawaby.Ultrareview did not start: `--trust-workspace` takes no value: sesuatu selain flag mengikuti--trust-workspace, seperti nomor PR ataufalse. Jika Anda tidak memercayai folder tersebut, jangan sertakan flag itu. Untuk memercayainya untuk eksekusi ini, letakkan nomor PR atau branch dasar sebelum flag:claude ultrareview 1234 --trust-workspace.
claude ultrareview tidak menerima --trust-workspace.
Remote Control tidak dimulai karena sebuah pertanyaan tidak mendapat jawaban
Pesan ini berarticlaude remote-control mengajukan pertanyaan first-run yang dikutip dalam pesan dan tidak mendapat jawaban:
Enable Remote Control?: dalam skrip atau service, input standar berakhir sebelum ada yang dapat menjawab. Jalankanclaude remote-controlsekali di terminal, sebagai pengguna yang menjalankan skrip atau service Anda, dan jawaby.Choose [1/2] (default: 1):: jalankanclaude remote-controllagi dan pilih mode spawn, atau berikan--spawn=same-diratau--spawn=worktreeuntuk melewati pertanyaan tersebut
Tidak diteruskan ke sesi yang dimulai Remote Control
Anda memulai Remote Control dengan flagclaude global sebelum kata kerja remote-control, yaitu flag yang akan membatasi atau mengonfigurasi sesi yang dimulai Remote Control, seperti --settings, --setting-sources, --permission-mode, --disallowed-tools, atau --mcp-config. Flag yang ditempatkan sebelum kata kerja tidak pernah mencapai sesi tersebut. Claude Code menolak untuk memulai, dengan menyebutkan flag tersebut:
--verbose, --model, atau --session-id atau --plugin-dir yang disisipkan oleh wrapper: Claude Code mengabaikannya dan Remote Control dimulai.
Claude Code juga menolak untuk memulai untuk flag global yang belum dikenalinya sebagai aman, sehingga flag yang ditambahkan dalam rilis yang lebih baru dapat muncul dalam pesan ini hingga rilis berikutnya menandainya sebagai aman.
Yang perlu dilakukan:
- Hapus flag dari posisi sebelum kata kerja dan berikan opsi Remote Control sendiri setelahnya;
claude remote-control --helpmencantumkannya - Ketika flag yang ditolak adalah
--permission-mode, jalankanclaude remote-control --permission-mode <mode>untuk mengatur mode izin bagi sesi yang dimulai Remote Control
claude remote-control tidak menerima flag-nya sendiri ketika flag global muncul lebih dulu, dan perintah gagal dengan kesalahan unknown option.
Remote Control did not start karena file --settings
File yang Anda teruskan ke claude remote-control --settings memiliki masalah:
- Perbaiki masalah yang disebutkan pesan, lalu jalankan perintah
claude remote-controlAnda lagi
The settings file has changed since Remote Control started
Pesan ini di terminal yang menjalankanclaude remote-control berarti sesi tidak akan dimulai dari file yang Anda teruskan ke --settings dalam keadaannya saat ini:
- Untuk menggunakan file dalam keadaannya saat ini, hentikan
claude remote-controldan jalankan perintah yang sama lagi. Untuk mengembalikan sesi yang sedang dilayaninya, lihat Melanjutkan sesi setelah menghentikan server. - Untuk mempertahankan pengaturan yang digunakan saat Remote Control dimulai, kembalikan isi file seperti semula, lalu jalankan perintah lagi jika
claude remote-controltelah keluar
--sandbox or --no-sandbox is not supported by claude remote-control
Error ini berarti perintah yang memulai server Remote Control Anda meneruskan --sandbox atau --no-sandbox setelah remote-control, dan claude remote-control tidak menerima kedua flag tersebut. Server keluar dengan kode 1 alih-alih dimulai:
- Hapus flag dari perintah, termasuk di skrip atau definisi layanan yang memulai server untuk Anda, lalu jalankan lagi
- Untuk menjalankan sesi yang dimulai server dalam sandbox, aktifkan sandboxing dengan mengatur
sandbox.enabledketruedalam file pengaturan
claude remote-control di v2.1.300, sehingga perintah yang ditulis untuk versi sebelumnya masih dapat memuat salah satunya.
claude import belum tersedia dalam build ini
Anda menjalankanclaude import, dan Claude Code mendapati alur impor dimatikan, sehingga perintah keluar dengan kode 1 alih-alih memulai impor. Sebelum v2.1.222, build dengan alur impor yang dimatikan memperlakukan import sebagai prompt dan memulai sesi interaktif alih-alih mencetak pesan ini.
claude import melalui feature flag yang diambilnya dari Anthropic dan di-cache di disk. Pesan ini berarti nilai yang di-cache dimatikan. Penyebabnya biasanya salah satu dari berikut:
- Anda belum memulai sesi sejak instalasi, sehingga Claude Code belum mengambil flag tersebut.
claude importpertama dapat mencetak pesan ini bahkan ketika fitur tersebut tersedia untuk Anda. - Anda menggunakan Claude Code melalui Amazon Bedrock, Agent Platform dari Google Cloud, Microsoft Foundry, atau Claude Platform on AWS, atau melalui Claude apps gateway. Claude Code tidak mengambil feature flag dalam sesi ini, sehingga
claude importtetap tidak tersedia. - Anda menetapkan
DISABLE_TELEMETRY,DO_NOT_TRACK,CLAUDE_CODE_DISABLE_FEATURE_FLAGS,DISABLE_GROWTHBOOK, atauCLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC, yang menonaktifkan pengambilan feature flag, sehinggaclaude importtetap tidak tersedia.
- Pada instalasi baru, mulai
claude, tunggu hingga sesi dimuat, keluar, dan jalankanclaude importlagi - Jika pengambilan feature flag tetap dimatikan, siapkan konfigurasi sendiri: tambahkan server MCP dengan
claude mcp add, dan buat fileCLAUDE.md, skill dan perintah, serta subagent yang ingin Anda bawa. Pesan ini juga menyebutkan~/.claude/settings.json. Dari konfigurasi yang dibawaclaude import, file tersebut hanya menyimpan mode izin; Claude Code tidak membaca server MCP darinya.
Tidak dapat membaca konfigurasi Claude Code
Anda menjalankanclaude import saat Claude Code tidak dapat mem-parse ~/.claude.json, file tempat ia menyimpan detail akun dan status per-proyek Anda. Subperintah membaca file tersebut untuk memeriksa ketersediaan tetapi tidak menampilkan dialog pemulihan yang ditampilkan sesi interaktif, sehingga ia keluar dengan kode 1. Sebelum v2.1.222, claude import dengan file konfigurasi yang tidak dapat dibaca memulai sesi interaktif, yang dialog pemulihannya menangani file tersebut.
- Jalankan
claudetanpa argumen. Claude Code mendeteksi file yang tidak valid dan menawarkan untuk meresetnya. Lalu jalankanclaude importlagi. - Untuk mempertahankan suntingan manual yang telah Anda buat, perbaiki sintaks JSON di
~/.claude.jsondengan editor, lalu jalankan ulangclaude import
Tidak dapat mengimpor server dari Claude Desktop
Claude Code tidak dapat menambahkan salah satu server yang Anda pilih diclaude mcp add-from-claude-desktop. Perintah tetap mengimpor server terpilih lainnya dan mencetak satu baris per server yang tidak dapat ditambahkannya. Sebelum v2.1.205, server pertama yang gagal menghentikan impor.
claude mcp hanya pada huruf, angka, tanda hubung, dan garis bawah. Alasan lainnya termasuk konfigurasi server yang gagal validasi dan server yang diblokir oleh kebijakan MCP organisasi Anda.
Yang perlu dilakukan:
- Ganti nama server di
claude_desktop_config.jsonagar hanya menggunakan huruf, angka, tanda hubung, dan garis bawah, lalu jalankanclaude mcp add-from-claude-desktoplagi - Tambahkan server tersebut secara langsung dengan
claude mcp addatauclaude mcp add-jsondengan nama yang valid. Lihat Mengimpor server MCP dari Claude Desktop.
Tidak dapat menambahkan server MCP ke cakupan managed
Anda menjalankanclaude mcp add atau claude mcp add-json dengan --scope managed. Cakupan tersebut menampung server yang disediakan organisasi Anda melalui pengaturan terkelola managedMcpServers. Claude Code hanya membacanya dari pengaturan terkelola, sehingga perintah tidak dapat menulis server ke cakupan tersebut.
- Tambahkan server ke cakupan yang dapat Anda tulis:
local,user, atauproject. Tanpa--scope, perintah menggunakanlocal. Lihat Cakupan instalasi MCP - Untuk menyediakan server bagi setiap pengguna di organisasi Anda, tambahkan ke
managedMcpServersdi pengaturan terkelola yang Anda deploy
Tidak dapat menambahkan server MCP ketika pengaturan terkelola hanya mengizinkan server plugin
Anda menjalankanclaude mcp add atau claude mcp add-json sementara pengaturan terkelola organisasi Anda mengatur strictPluginOnlyCustomization ke true atau ke daftar yang mencakup mcp. Dengan pengaturan tersebut, Claude Code tidak memuat server MCP dari ~/.claude.json atau .mcp.json, sehingga perintah keluar dengan kode 1 alih-alih menyimpan server yang tidak akan pernah dimuat:
claude mcp add-from-claude-desktop melaporkan setiap server yang Anda pilih sebagai tidak diimpor, dengan pesan ini sebagai alasannya. /import melaporkan pesan ini untuk setiap server MCP yang coba ditambahkannya dan tetap mengimpor item lain yang ditemukannya.
Sebelum v2.1.284, perintah ini menyimpan server dan melaporkan keberhasilan, dan server tidak pernah dimuat.
Yang perlu dilakukan:
- Instal plugin yang menyediakan server tersebut
- Minta administrator Anda untuk mendistribusikan server dalam plugin, atau menyediakannya melalui
managedMcpServersjika server tersebut adalah server HTTP atau SSE jarak jauh
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, mendapati bahwa file di direktori Anda saat ini bukan file biasa atau berukuran lebih dari 2 MiB, sehingga perintah keluar dengan kesalahan ini alih-alih membaca file.
.mcp.json membuat perintah menunggu selamanya tanpa output, dan symlink ke file perangkat seperti /dev/zero membuat memori bertambah hingga proses dihentikan.
Yang perlu dilakukan:
- Periksa apa yang ada di
.mcp.jsondi direktori Anda saat ini. Ganti dengan file JSON biasa dalam format cakupan proyek, atau hapus, lalu jalankan perintah lagi.
Server MCP tidak disimpan atau dihapus
Error ini berarti perintah seperticlaude mcp add atau claude mcp remove tidak berhasil memasukkan perubahan Anda ke ~/.claude.json. Proses Claude Code lain mungkin telah mengunci file tersebut, atau file tersebut mungkin read-only atau dilindungi oleh sandbox.
was not removed from sebagai pengganti was not saved to, dan remove the server again sebagai pengganti add the server again. Untuk server cakupan local, path diikuti oleh direktori proyek tempat entri tersebut berada, sebagai (local scope for /path/to/project).
Yang perlu dilakukan:
- Proses Claude Code lain sedang berjalan: perintah menunggu sekitar 10 hingga 20 detik untuk kunci file, lalu menyerah tanpa menulis. Jalankan perintah yang sama lagi dengan
CLAUDE_CODE_CONFIG_LOCK_WAIT_MSdiatur ke waktu tunggu yang lebih lama dalam milidetik, seperti60000. - File bersifat read-only atau dilindungi sandbox: buat file yang disebutkan pesan dapat ditulis dan jalankan perintah add atau remove yang sama lagi, atau jalankan perintah tersebut di luar sandbox.
claude mcp add, claude mcp add-json, dan claude mcp remove melaporkan keberhasilan bahkan ketika perubahan tidak mencapai file. Sebelum v2.1.318, pesan tidak menyebutkan kunci, dan Claude Code tidak membaca CLAUDE_CODE_CONFIG_LOCK_WAIT_MS.
Server MCP mungkin tidak disimpan atau dihapus
Anda menjalankanclaude mcp add, claude mcp add-json, atau claude mcp remove untuk server di cakupan user atau local, dan Claude Code tidak dapat membaca kembali ~/.claude.json untuk mengonfirmasi perubahan. Perubahan tersebut mungkin sudah atau belum tersimpan di disk. Tanda kurung setelah to confirm the change memberikan alasannya.
may not have been removed dan diakhiri dengan then remove the server again if it is still listed. Jika alasannya adalah the file was not found, server mungkin masih terkonfigurasi.
Sebelum v2.1.283, perintah melaporkan keberhasilan bahkan ketika perubahan tidak dapat dikonfirmasi.
Yang perlu dilakukan:
- Jalankan
claude mcp get <name>untuk memeriksa apakah perubahan ada di disk. Untuk server cakupanlocal, jalankan dari direktori proyek tempat server tersebut berada, karena cakupan lokal berlaku per proyek. - Jika server tidak ada setelah penambahan, atau masih tercantum setelah penghapusan, jalankan perintah tambah atau hapus yang sama lagi.
Server di-host oleh Anthropic dan tidak mendukung OAuth lokal
Anda memulai proses masuk untuk server MCP yang URL-nya menunjuk ke host konektor yang di-host Anthropic yang melakukan autentikasi melalui penyedia identitas pihak ketiga. Host ini mencakupmicrosoft365.mcp.claude.com, gmail.mcp.claude.com, dan gcal.mcp.claude.com. Claude Code menolak memulai alur OAuth lokalnya untuk host ini baik dari panel /mcp maupun claude mcp login, karena proses masuknya hanya berfungsi melalui claude.ai.
- Hapus entri Anda dengan
claude mcp remove <name>, agar entri tersebut tidak 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 dibuat oleh headersHelper yang dikonfigurasi
Server MCP yangheadersHelper-nya menyediakan header Authorization menjawab koneksi dengan HTTP 401 atau 403, sehingga Claude Code melaporkan koneksi sebagai gagal. Karena helper menyediakan header Authorization, Claude Code tidak melakukan fallback ke OAuth untuk server tersebut:
- Jalankan perintah
headersHelpersendiri dengan cara yang sama seperti Claude Code menjalankannya: dari direktori tempat Claude Code menjalankannya, dengan environment variable yang diatur Claude Code untuknya, dan tanpa variabel kredensial yang dihapus Claude Code untuk server dari.mcp.jsonproyek, plugin, atau file agent proyek. Periksa bahwa perintah tersebut mencetak nilaiAuthorizationyang diterima endpoint server - Setelah memperbaiki helper atau sumber kredensialnya, pilih server di
/mcpdan pilih Reconnect
Authorization. Penemuan tersebut dapat gagal dengan Incompatible auth server: does not support dynamic client registration alih-alih melaporkan kredensial yang ditolak.
Server MCP menolak kapabilitas elicitation
Server MCP yang dibangun di atas Java MCP SDK 0.11.0 hingga 0.17.0 menolak koneksi. Versi SDK tersebut tidak dapat mem-parse mode elicitationform dan url yang dideklarasikan Claude Code dalam handshake-nya. Pesannya berbunyi:
- Upgrade server ke Java MCP SDK 0.17.1 atau yang lebih baru, atau ke salah satu rilis Spring AI yang disebutkan dalam pesan
- Atau tambahkan
"bareElicitationCapability": trueke entri server tersebut dalam konfigurasi MCP Anda, lalu restart Claude Code. Field ini diterima pada entri stdio,sse,http, danwsdan memerlukan Claude Code v2.1.281 atau yang lebih baru
.mcp.json berikut mengatur field tersebut untuk satu server HTTP:
/mcp menampilkan server sebagai terhubung. Claude Code hanya mendeklarasikan mode form ke server tersebut, jadi hapus field tersebut setelah Anda meng-upgrade server.
Server juga dapat gagal dengan teks kesalahannya sendiri, seperti yang berisi Unrecognized field "form". Perbaikan yang sama berlaku.
Tool prompt izin MCP tidak ditemukan
Tool yang Anda berikan ke--permission-prompt-tool tidak termasuk di antara tool MCP yang terhubung saat run pertama kali memerlukan keputusan izin, baik karena servernya tidak pernah terhubung atau karena tidak ada server terhubung yang menyediakan tool dengan nama tersebut. Claude Code tetap mengirimkan prompt Anda: run non-interaktif keluar dengan kesalahan ini, dan exit code 1, pada panggilan tool pertama, sehingga tidak menghasilkan jawaban meskipun permintaan telah dibuat. Sebelum prompt pertama, Claude Code menunggu hingga timeout koneksi per server selama 30 detik yang diatur oleh MCP_TIMEOUT agar server tersebut terhubung. Sebelum v2.1.206, startup tidak menunggu server selesai terhubung, sehingga server yang lambat dimulai tetapi sehat juga menghasilkan kesalahan ini.
Available MCP tools: menyebutkan tool MCP yang terhubung.
Yang perlu dilakukan:
- Periksa bahwa server dimulai dan tetap terhubung: jalankan
claude mcp listdi direktori yang sama dan pastikan server tercantum sebagai terhubung - Pastikan nama tool cocok dengan nama
mcp__<server>__<tool>yang disediakan server - Jika server memerlukan lebih 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 listener lokal untuk menerima callback proses masuk. Jika port yang diperlukan listener tersebut dipegang oleh proses lain, proses masuk gagal dengan pesan ini. Hal ini sebagian besar terjadi dengan port callback tetap yang diatur melalui variabelMCP_OAUTH_CALLBACK_PORT atau --callback-port, karena tanpa itu Claude Code memilih port yang tersedia.
netstat -ano | findstr :<port>.
Yang perlu dilakukan:
- Jalankan perintah dari pesan untuk menemukan proses yang memegang port, dan hentikan proses tersebut atau tunggu hingga selesai
- Jika program lain memerlukan port tersebut secara permanen, daftarkan URI redirect yang berbeda dengan server dan atur port-nya dengan
MCP_OAUTH_CALLBACK_PORTatau--callback-port, mana pun yang Anda gunakan - Lalu mulai proses masuk lagi, misalnya dengan memilih server di
/mcp
Tidak ada port yang tersedia untuk redirect OAuth
Ketika Anda masuk ke server MCP jarak jauh dengan OAuth, Claude Code memulai listener lokal untuk menerima callback proses masuk. Proses masuk gagal dengan pesan ini ketika Claude Code tidak dapat mengikat port lokal untuknya. Sesuatu di mesin mencegahnya mendengarkan di127.0.0.1, misalnya perangkat lunak keamanan atau kebijakan sandbox yang menolak listener lokal.
- Periksa apakah perangkat lunak keamanan atau kebijakan sandbox memblokir proses dari mendengarkan di
127.0.0.1, dan izinkan Claude Code mengikat port lokal - Lalu mulai proses masuk lagi, misalnya dengan memilih server di
/mcp
/security-review gagal tanpa origin/HEAD
/security-review membangun konteks review-nya dengan membuat diff branch Anda terhadap origin/HEAD, ref lokal yang mencatat branch mana yang menjadi default pada remote origin Anda. Ketika ref tersebut tidak ada, perintah git yang mengumpulkan diff gagal dan review berhenti sebelum dimulai.
git log atau git diff yang berbeda. Git membuat origin/HEAD hanya ketika remote mengiklankan branch default dan refspec fetch Anda mencakupnya, yang dilakukan oleh git clone penuh dari remote yang memiliki commit. Ref tersebut tidak ada dalam pengaturan berikut:
- Checkout single-branch atau CI, yang melakukan fetch dengan refspec yang terlalu sempit
- Remote yang HEAD di sisi server-nya menunjuk ke branch yang tidak pernah di-push siapa pun
- Repositori tanpa remote
origin, atau yang tidak pernah Anda fetch
Shell command permission check failed for pattern "...": pemeriksaan izin perintah tidak mengizinkannya. Lihat Pemeriksaan izin pada perintah sisipan untuk hasil mana yang membatalkan di setiap mode izin dan kapanallowed-toolsmenyetujui perintah terlebih dahuluSkill <name> requires bash (`shell: bash` in frontmatter) but Git Bash was not found: frontmatter skill mengharuskan bash di mesin yang tidak memilikinya. Instal Git for Windows atau ubah frontmatter menjadishell: powershell. Lihat Cara perintah sisipan dijalankan
- Buat ref dengan menyebutkan branch default remote Anda:
git remote set-head origin <default-branch>. Ini berfungsi setiap kali ref pelacakan lokalorigin/<default-branch>ada. Jika tidak ada, seperti pada clone single-branch, fetch branch tersebut terlebih dahulu: jalankangit remote set-branches --add origin <branch>, lalugit fetch origin, lalu jalankan ulang perintah set-head. Jalankan ulang/security-review. - Jika Anda lebih memilih tidak menyebutkan branch, jalankan
git fetch originlalugit remote set-head origin --auto, yang menanyakan kepada remote branch mana yang menjadi default-nya. Perintah ini gagal denganerror: Cannot determine remote HEADketika remote tidak mengiklankan branch default, karena remote kosong atau HEAD-nya menunjuk ke branch yang tidak pernah di-push siapa pun; sebutkan branch secara eksplisit sebagai gantinya. Perintah ini gagal denganerror: Not a valid refketika clone Anda tidak melakukan fetch branch tersebut; perluas refspec seperti di atas terlebih dahulu. - Jika repositori tidak memiliki remote, tambahkan dengan
git remote add origin <url>dan lakukan fetch sebelum membuat ref. Jika remote kosong, push branch Anda terlebih dahulu dengangit push -u origin HEADdan sebutkan branch tersebut dalam perintah set-head;origin/HEADkemudian menunjuk ke branch yang baru saja Anda push, sehingga/security-reviewmelihat diff kosong hingga branch menyimpang darinya.
No shell command in a skill or command was run
No shell command in <name> was run berarti perintah konteks dinamis !`<command>` dalam file skill atau perintah tersebut memuat karakter yang ditolak oleh tool Bash atau PowerShell:
- Kedua tool: karakter kontrol mentah selain tab atau baris baru
- Tool PowerShell: juga U+FEFF atau U+180E
�, seperti dalam contoh tool Bash ini:
- Temukan setiap
�dalam perintah yang dikutip di akhir pesan. Hapus karakter yang diwakilinya dari file skill atau perintah, atau dari argumen atau opsi yang disubstitusikan ke dalam file tersebut.
Skill, perintah, atau hook melebihi batas 4,000,000 karakter
Pesan denganmore than 4,000,000 characters berarti skill, perintah, atau hook prompt atau agent tidak dijalankan. Jika Anda menempelkan teks panjang sebagai argumen, simpan teks tersebut ke file, jalankan /clear, karena teks tetap berada dalam percakapan, lalu teruskan path-nya. Di luar Code Mode, hook prompt atau agent PreToolUse yang melebihi batas tidak memblokir panggilan. Gunakan hook perintah, yang tidak memiliki batas seperti itu.
Input harus diberikan saat menggunakan --print
claude tanpa argumen memerlukan stdout berupa terminal untuk memulai UI interaktif. Ketika stdout dialihkan, atau konsol bukan terminal sungguhan, seperti PowerShell ISE dan beberapa panel output IDE, claude berjalan secara non-interaktif. Itu adalah mode yang sama dengan claude -p, yang memerlukan prompt, sehingga pesan menyebutkan --print bahkan ketika Anda tidak memberikan flag tersebut. Memberikan -p/--print tanpa prompt dan tanpa apa pun yang di-pipe ke stdin menghasilkan kesalahan yang sama di mana pun.
- Untuk penggunaan interaktif, jalankan
claudedi terminal sungguhan: Windows Terminal atau konsol PowerShell alih-alih ISE, dan terminal terintegrasi IDE Anda alih-alih panel output - Untuk penggunaan sekali jalan, berikan prompt:
claude -p "your question", atau pipe denganecho "your question" | claude -p
Claude Code tidak dapat membaca keyboard di sini
Anda menjalankanclaude tanpa -p, yang memulai sesi interaktif, tetapi input standarnya bukan terminal. Sesuatu melakukan pipe atau mengalihkannya, atau program yang meluncurkan claude menyediakan aliran inputnya sendiri.
Sesi interaktif memerlukan terminal untuk membaca ketikan Anda, dan apa yang dilakukan Claude Code tanpa terminal bergantung pada platform Anda:
- Windows: Claude Code mencetak pesan ke stderr dan keluar dengan kode 1 alih-alih memulai antarmuka
- macOS dan Linux: Claude Code membaca ketikan Anda dari
/dev/ttydan memulai sesi, dengan teks yang di-pipe sebagai prompt pertama Anda. Anda melihat pesan ini ketika/dev/ttytidak dapat dibuka, dan baris pertamanya menyebutkan/dev/ttysebagai pengganti kata-kata untuk Windows.
- Untuk bekerja secara interaktif, jalankan
claudelangsung di terminal, tanpa melakukan pipe atau mengalihkan inputnya - Untuk mendapatkan balasan tanpa antarmuka interaktif, misalnya dari skrip, tambahkan
-pdan berikan prompt sebagai argumen atau melalui stdin, seperticlaude -p "your question"atauecho "your question" | claude -p. Hal yang sama berlaku dengan--continuedan--resume <session-id>.
Raw mode is not supported.
Jika Anda melihat Raw mode is not supported selama claude install, lihat Raw mode is not supported selama instalasi.
Input hanya berisi whitespace
Dalam mode non-interaktif, Claude Code menolak prompt yang seluruhnya terdiri dari spasi, tab, atau baris baru alih-alih mengirimkannya, karena API menolak pesan tanpa teks yang terlihat. Pesan yang Anda lihat bergantung pada asal prompt kosong tersebut:- Argumen prompt atau stdin yang di-pipe untuk
claude -p:claudekeluar denganError: 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-jsonatau Agent SDK yang sedang berjalan: Claude Code mengakhiri giliran tanpa memanggil model dan sesi tetap dapat digunakan. Penolakan tiba sebagai pesan informasi dan sebagai teks hasil giliran:Blank prompt — the message was only whitespace, so nothing was sent to the model.
- Sertakan teks yang terlihat dalam prompt. Jika skrip membangun prompt dari variabel atau file, periksa bahwa sumbernya tidak kosong sebelum memanggil Claude Code.
Input stream-json membawa lebih dari 256M karakter tanpa baris baru
Program Anda mengirimkan lebih dari 268.435.456 karakter di stdin tanpa baris baru ke runclaude -p --input-format stream-json, sehingga Claude Code mencetak kesalahan ini ke stderr dan keluar dengan kode 1 alih-alih menampung lebih banyak input. Pesan menyatakan batas tersebut sebagai 256M. Sebelum v2.1.257, Claude Code menampung input semacam itu tanpa batas, membuat memori bertambah hingga proses crash atau dihentikan.
- Periksa apa yang di-pipe ke stdin. Dengan
--input-format stream-json, setiap pesan harus berupa satu baris JSON yang diakhiri baris baru - Untuk mengirimkan teks biasa, hapus
--input-format stream-json;claude -pmembaca prompt teks biasa dari stdin secara default
Unknown command
Dalam sesi terminal interaktif, Anda mengirimkan nama/ yang tidak cocok dengan perintah apa pun dalam sesi ini, sehingga Claude Code melaporkan nama tersebut alih-alih menjalankan apa pun:
- Salah ketik, seperti
/hepluntuk/help. Cara menu perintah mencocokkan apa yang Anda ketik membahas cara memilih kecocokan terdekat sebelum Anda mengirimkan - Perintah yang ada tetapi tidak tersedia dalam sesi ini karena suatu persyaratan tidak terpenuhi, seperti platform, paket, atau metode autentikasi Anda. Lihat entri untuk
/web-setup,/schedule, atau/auto-mode-setup. Beberapa perintah menjawab dengan pesannya sendiri ketika kebijakan organisasi Anda menonaktifkannya, sepertiCloud sessions are disabled by your organization's policy - Perintah dari plugin atau server MCP yang tidak diinstal atau tidak terhubung dalam sesi ini
/ yang tidak cocok dengan cara ini hanya dalam sesi terminal interaktif. Dalam setiap sesi lainnya, Claude Code mengirimkan prompt ke Claude sebagai pesan biasa, dengan catatan bahwa perintah tidak dijalankan dan daftar perintah yang dapat dijalankan Claude dalam sesi tersebut. Sesi tersebut meliputi:
- Run
-p - Aplikasi Agent SDK
- Tab Code di aplikasi Desktop
- Panel chat ekstensi VS Code
- Sesi cloud dan tugas terjadwal cloud
Unknown command.
Claude Code tidak memperlakukan setiap prompt yang diawali dengan / sebagai perintah. Claude Code mengirimkan prompt ke Claude sebagai pesan biasa ketika kata pertama setelah / diawali dengan tanda baca, seperti /-- yang membuka komentar dokumentasi Lean, atau merupakan path seperti /var/log/syslog.
Sebelum v2.1.236, jika Anda menekan Enter saat menu perintah mencantumkan kecocokan terdekat untuk nama yang Anda ketik, Claude Code menjalankan kecocokan tersebut, sehingga salah ketik seperti /hepl menjalankan /help alih-alih menghasilkan pesan ini.
Yang perlu dilakukan:
- Jalankan nama yang disarankan, atau ketik
/diikuti sebagian nama untuk melihat apa yang tersedia dalam sesi ini - Jika Claude Code melaporkan perintah yang terdokumentasi sebagai tidak dikenal, periksa barisnya di referensi perintah untuk persyaratan yang disebutkannya
Diff terlalu besar untuk ultrareview
Diff antara branch Anda dan branch dasar, termasuk perubahan yang belum di-commit dan yang di-stage, melebihi batas ukuran untuk ultrareview, sehingga/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 paling banyak menyumbang baris yang diubah. Sebelum v2.1.216, pesan hanya menampilkan statistik diff mentah.
PR #<N> is too large for ultrareview dan menyebutkan jumlah file dan baris PR.
Yang perlu dilakukan:
- Berikan branch dasar yang lebih dekat dengan pekerjaan Anda, seperti
/code-review ultra develop, sehingga review hanya mencakup diff terhadap branch tersebut - Pecah perubahan menjadi branch yang lebih kecil dan review masing-masing. File yang disebutkan pesan menyumbang baris yang diubah paling banyak, jadi mulailah dengan memindahkannya ke branch tersendiri.
Tidak dapat menemukan merge-base dengan branch dasar
/code-review ultra dan subperintah claude ultrareview me-review diff antara branch Anda dan branch dasar, yang memerlukan commit yang dimiliki bersama oleh keduanya. Ketika git merge-base tidak menemukannya, Claude Code menolak review sebelum sesi cloud dimulai. Pada clone yang dapat diverifikasi Claude Code sebagai lengkap, dengan setidaknya satu branch, Claude Code melakukan fallback ke me-review setiap file yang dilacak alih-alih menolak. Anda melihat penolakan ini ketika branch dasar sama sekali tidak dapat ditemukan, ketika Claude Code tidak dapat memverifikasi bahwa clone Anda lengkap, atau pada repositori langka tempat diff seluruh tree tidak dimungkinkan, seperti format objek SHA-256.
- Anda tidak memberikan branch dasar: Claude Code membandingkan dengan branch default repositori dan menyarankan untuk memberikan branch dasar Anda secara eksplisit, seperti pada contoh di atas
- Anda memberikan branch dasar yang sudah ada di clone Anda: petunjuknya berbunyi
Make sure <branch> exists locally or on origin (try `git fetch origin <branch>`) - Anda memberikan branch dasar yang tidak ada di clone Anda: Claude Code mengambilnya dari origin sebelum membandingkan. Petunjuknya berbunyi
<branch> was fetched from origin but shares no history with HEAD. If another branch is your real base, pass it explicitly (`/code-review ultra <branch>`); ketika Claude Code tidak dapat mengetahui apakah clone Anda shallow, Claude Code menyarankangit fetch --unshallow origin. Sebelum v2.1.221, petunjuk menyarankangit fetch --unshallow originuntuk setiap branch dasar yang diambil, dan pada clone yang lengkap perintah tersebut gagal denganfatal: --unshallow on a complete repository does not make sense.
- Jika branch lain adalah branch dasar Anda yang sebenarnya, berikan secara eksplisit:
/code-review ultra <branch> - Jika clone Anda mungkin tidak memiliki riwayat lengkap, jalankan
git fetch --unshallow origindan jalankan ulang review
Checkout Anda tidak memiliki branch
Checkout dapat memiliki commit tetapi tidak memiliki branch: jika Anda menjalankangit init diikuti dengan git fetch <url> dan git checkout FETCH_HEAD, Anda mendapatkan HEAD terlepas tanpa ref. Claude Code mengemas repositori Anda sebagai git bundle untuk mengunggahnya untuk ultrareview, dan tidak dapat mem-bundle repositori yang tidak memiliki branch atau ref lain, sehingga /code-review ultra dan subperintah claude ultrareview menolak review sebelum sesi cloud dimulai.
- Buat branch pada commit Anda saat ini dengan
git checkout -b <name>, lalu jalankan ulang 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 kepada server apakah akun GitHub yang terhubung ke akun Claude Anda dapat menjangkau repositori PR. Tidak ada akun yang terhubung, atau koneksinya kedaluwarsa, sehingga clone di cloud akan gagal dan Claude Code menolak peluncuran. Claude Code tidak menggunakan run gratis atau menagih kredit penggunaan untuk peluncuran yang ditolak.
/web-setup tidak tersedia dalam sesi Anda, pesan hanya menyebutkan tautan claude.ai.
Yang perlu dilakukan:
- Jalankan
/web-setupuntuk menghubungkan login GitHub CLI Anda ke akun Claude Anda, atau hubungkan akun di claude.ai/connect-github - Jalankan ulang review satu menit setelah menghubungkan
Akun GitHub yang terhubung tidak dapat melihat repositori
Anda menjalankan/code-review ultra <PR#> atau claude ultrareview <PR#>, dan akun GitHub yang terhubung ke akun Claude Anda tidak dapat membaca repositori PR, sehingga clone di cloud akan gagal dan Claude Code menolak peluncuran. Claude Code tidak menggunakan run gratis atau menagih kredit penggunaan untuk peluncuran yang ditolak.
/web-setup tidak tersedia dalam sesi Anda, pesan hanya menyebutkan instalasi aplikasi.
Yang perlu dilakukan:
- Jika CLI
ghlokal Anda dapat membaca repositori, jalankan/web-setupuntuk menghubungkan login tersebut ke akun Claude Anda - Jalankan ulang review setelah perubahan
Preflight GitHub App gagal sementara
Anda memulai sesi cloud dari repositori lokal, dan dua langkah gagal bersamaan. Claude Code tidak dapat mem-build atau mengunggah bundle repositori Anda. Sebelum pengunggahan, Claude Code memeriksa apakah layanan cloud dapat melakukan clone repositori dari GitHub, dan alih-alih jawaban pasti, pemeriksaan tersebut berakhir dengan kesalahan yang dapat diatasi dengan retry, seperti kesalahan jaringan, timeout, atau kesalahan server sementara. Pesan lengkap diawali dengan apa yang menghentikan bundle, misalnyaCould not upload repo bundle (<error>), dan diakhiri dengan kalimat preflight:
- Jalankan ulang perintah setelah beberapa saat. Ketika pemeriksaan GitHub berhasil, Claude Code dapat memulai sesi dari clone GitHub, sehingga unggahan yang gagal tidak lagi memblokir peluncuran
- Jika retry terus gagal, awal pesan menyebutkan apa yang menghentikan unggahan. Ketika penyebab tersebut dapat Anda perbaiki, perbaiki agar sesi dapat dimulai dari repositori lokal Anda
Please set up GitHub on https://claude.ai/code bahkan ketika pemeriksaan GitHub hanya gagal sementara, dan saran penyiapan tidak dapat mengatasi kegagalan sementara.
Unggahan repositori tidak dapat mengikuti pengaturan git
Anda memulai sesi cloud yang mengunggah repositori lokal Anda, atau ultrareview dari suatu branch, dan unggahan tidak dapat mengikuti salah satu pengaturan git yang menentukan aturan atribut mana yang berlaku untuk file Anda. Jika unggahan tetap dilanjutkan dan melewatkan suatu aturan, file yang diubah git sebelum menyimpannya, seperti file yang dienkripsi oleh clean filter, dapat sampai ke cloud dalam keadaan seperti di disk. Claude Code menolak unggahan, dan tidak ada yang diunggah:core.attributesFile dan attr.tree, masing-masing dengan perbaikannya sendiri.
Pesan dapat menyebutkan file konfigurasi yang ditarik konfigurasi git Anda melalui direktif include atau includeIf, bahkan ketika kondisi direktif tersebut tidak berlaku untuk repositori ini.
Yang perlu dilakukan:
- Terapkan perbaikan pada kalimat terakhir pesan
GitHub tidak terhubung ke akun Claude Anda
Anda memulai sesi cloud dari repositori lokal Anda, misalnya dengan/autofix-pr. Tidak ada akun GitHub yang terhubung ke akun Claude Anda, atau koneksinya kedaluwarsa, sehingga Claude Code menolak peluncuran:
/schedule, pesan yang sama muncul sebagai catatan penyiapan yang menyebutkan repositori; catatan tersebut tidak menghalangi pembuatan tugas.
Yang perlu dilakukan:
- Jalankan
/web-setupuntuk menghubungkan login GitHub CLI Anda ke akun Claude Anda, atau hubungkan akun di claude.ai/connect-github. Lihat Opsi autentikasi GitHub untuk perbedaan keduanya. - Jalankan ulang perintah satu menit setelah menghubungkan
Kebijakan organisasi GitHub memblokir Claude
Anda menjalankan perintah di prompt Claude Code yang memulai sesi cloud, seperti/autofix-pr. Sebelum membuat sesi, Claude Code memeriksa akses Claude ke repositori di GitHub, dan GitHub menolak karena organisasi GitHub Anda memiliki kebijakan yang memblokir Claude. Claude Code berhenti di situ dan menampilkan pesan yang menyebutkan kebijakan tersebut.
Jika yang memblokir akses adalah IP allow list, pesannya berbunyi:
- IP allow list: minta pemilik organisasi atau enterprise GitHub Anda untuk mengizinkan alamat IP keluar Anthropic. Lihat Allow list dan firewall GitHub untuk alamat dan pengaturan GitHub yang perlu diubah.
- Single sign-on: putuskan koneksi GitHub di claude.ai/customize/connectors, lalu hubungkan kembali. Saat GitHub meminta, klik Authorize di samping organisasi Anda agar koneksi baru diotorisasi untuk single sign-on-nya.
- Kebijakan Conditional Access: minta admin GitHub Enterprise atau Microsoft Entra ID Anda untuk mengizinkan Claude dalam kebijakan tersebut
- Setelah perubahan, jalankan perintah itu lagi
Otorisasi single sign-on diperlukan
Anda menjalankan/install-github-app dan memilih repositori yang organisasinya menerapkan SAML single sign-on. Sebelum penyiapan, Claude Code memeriksa akses Anda ke repositori dengan GitHub CLI, dan GitHub menolak pemeriksaan tersebut karena token gh Anda belum diotorisasi untuk organisasi tersebut. Wizard menampilkan peringatan beserta langkah-langkah untuk mengotorisasi:
- Otorisasi ulang login GitHub CLI Anda dengan scope
repodanworkflowdengan menjalankangh auth refresh -h github.com -s repo,workflow, lalu otorisasi organisasi saat GitHub meminta single sign-on - Jika Anda mengautentikasi dengan personal access token di
GH_TOKEN, buka github.com/settings/tokens, pilih Configure SSO pada token tersebut, lalu otorisasi organisasi - Jalankan
/install-github-applagi
Admin permissions required untuk kondisi ini.
Gagal melanjutkan percakapan
Claude Code tidak dapat membaca atau memproses transkrip tersimpan untuk sesi yang Anda pilih dari pemilihclaude --resume, sehingga ia mengakhiri proses alih-alih melanjutkan dalam keadaan termuat sebagian. Pesan tersebut menyertakan perintah untuk mencoba ulang:
/resume di dalam sesi yang sedang berjalan melaporkan Failed to resume conversation di dalam percakapan, dan sesi Anda saat ini tetap berjalan. Sebelum v2.1.216, kegagalan melanjutkan dari pemilih claude --resume tetap berada di spinner Resuming conversation… tanpa batas waktu alih-alih menampilkan pesan ini.
Yang perlu dilakukan:
- Jalankan
claude --resume <session-id>dengan ID sesi dari pesan tersebut untuk mencoba ulang - Pada versi sebelum v2.1.285, jika percobaan ulang gagal dengan cara yang sama, jalankan
claude updatelalu lanjutkan lagi. Versi-versi tersebut gagal melanjutkan ketika transkrip tersimpan berisi entri yang tidak dapat dibacanya. - Jika percobaan ulang gagal lagi, jalankan
claudeuntuk memulai sesi baru
Tidak ada percakapan yang ditemukan dengan ID sesi
Anda meneruskan ID sesi keclaude --resume <session-id> dan tidak ada transkrip tersimpan yang cocok dengannya:
- Salah ketik ID: untuk eksekusi non-interaktif, ID adalah field
session_iddari output--output-format json - Transkrip terhapus: Claude Code menghapus transkrip setelah periode retensi, 30 hari secara default, mengikuti aturan pembersihan retensi
- Mesin berbeda: Claude Code menyimpan transkrip secara lokal, jadi lanjutkan sesi di mesin tempat sesi tersebut dijalankan
- Salinan duplikat: jika Anda menyalin direktori proyek di bawah
~/.claude/projectssehingga dua transkrip memiliki ID yang sama, Claude Code melaporkan pesan ini alih-alih melanjutkan salah satu salinan secara sembarang
- Untuk sesi interaktif, buka pemilih sesi dengan
claude --resumedan tekanCtrl+Auntuk memperluasnya ke setiap proyek di mesin ini, lalu pilih sesinya - Sesi yang dibuat dengan
claude -patau Agent SDK tidak muncul di pemilih, jadi periksa kembali ID tersebut terhadapsession_idyang dicetak oleh eksekusi awal Anda
Windows melaporkan kesalahan (EBADF) saat Claude Code membaca file transkrip sesi ini
Anda melanjutkan sesi di Windows, file transkrip tersimpannya terbuka secara normal, lalu pembacaannya gagal dengan kesalahan sistem EBADF. Kesalahan sistem tidak menyebutkan alasan pembacaan gagal, sehingga pesan tersebut menyarankan kemungkinan penyebab dan hal yang dapat dicoba:Failed to resume session <session-id>. Perintah claude --resume atau claude -p keluar dengan kode 1 setelah menampilkannya. Setelah /resume di dalam sesi, sesi Anda saat ini tetap berjalan.
Yang perlu dilakukan:
- Kecualikan folder yang menyimpan transkrip sesi Anda dari perangkat lunak yang memindai atau mencegat pembacaan file, seperti alat keamanan, enkripsi, atau manajemen endpoint. Transkrip berada di
%USERPROFILE%\.claude\projectssecara default, atau di direktori yang disebutkan olehCLAUDE_CONFIG_DIR - Jika Anda tidak dapat menambahkan pengecualian, tambahkan Claude Code ke daftar aplikasi yang diizinkan oleh perangkat lunak tersebut
- Lanjutkan sesi lagi
claude --resume <session-id> berakhir di Failed to resume session <session-id>, dan eksekusi -p hanya mencetak teks kesalahan sistem, seperti Failed to resume session: EBADF: bad file descriptor, read.
Tidak dapat beralih renderer dalam sesi ini
Saat Anda beralih renderer, Claude Code memulai ulang prosesnya. Anda menjalankan/tui dalam sesi yang ditolak untuk dimulai ulang oleh Claude Code, sehingga ia tidak beralih dan tidak menyimpan apa pun. Pesan yang Anda lihat menunjukkan penyebabnya:
Cannot switch renderers while work is running in the background: Anda memiliki pekerjaan latar belakang yang sedang berjalan yang akan ditinggalkan oleh mulai ulang, seperti shell latar belakang atau subagent. Tunggu hingga pekerjaan selesai atau hentikan dengan/tasks, lalu jalankan/tui fullscreenatau/tui defaultlagiCannot switch renderers in this session: sesi memiliki batasan yang tidak dapat diteruskan Claude Code ke proses yang dimulai ulang. Sebelum v2.1.234, Claude Code tetap memulai ulang dan sesi yang diluncurkan kembali berjalan tanpa batasan tersebut
launch flags: a custom system prompt, a tool allowlist, or restricted settings: Anda memulai sesi dengan flag yang tidak diteruskan kembali oleh Claude Code ke proses yang dimulai ulang. Flag ini mencakup--system-prompt,--system-prompt-file,--append-system-prompt-file, allowlist--tools,--setting-sources, dan--permission-prompt-toolpermission rules set for this session only: sebuah pembaruan izin dari hook atau pemanggil SDK menambahkan aturan deny atau ask dengan tujuansession. Aturan allow yang dibatasi ke sesi tidak memicu penolakan. Mulai ulang akan menghapusnya, dan Claude Code akan meminta izin lagiask-before-running rules with no command-line form: pembaruan izin dari hook atau pemanggil SDK menambahkan aturan ask di samping aturan yang diteruskan kembali oleh Claude Code sebagai--allowed-toolsdan--disallowed-tools. Tidak ada flag untuk aturan askpermission rules a command line cannot carry intactdanadded directories a command line cannot carry intact: pembaruan izin menambahkan aturan atau path direktori di tengah sesi. Baris perintah proses yang dimulai ulang tidak dapat membawa teksnya sebagai nilai yang sama
- Dalam sesi yang dimulai tanpa batasan tersebut, jalankan
/tui fullscreen, atau/tui defaultuntuk beralih kembali. Claude Code menyimpan pengaturantuidi sana
Can’t restart while work is running or Remote Control is connected
Claude Code tidak memulai ulang, dan sesi Anda tetap berjalan seperti sebelumnya. Ikuti perbaikan yang ada di pesan.Claude Code couldn’t restart
Jika pesan ini menyatakan bahwa percakapan Anda tersimpan, percakapan tersebut ada di disk dan Anda dapat melanjutkannya dari titik berhentinya. Claude Code sedang memulai ulang dirinya sendiri, misalnya untuk beralih ke atau dari rendering fullscreen setelah Anda menjalankan/tui, dan tidak dapat memulai proses baru, sehingga keluar dengan status 1:
/tui adalah input pertama Anda di sesi baru, pesannya berbunyi Claude Code couldn't restart. Start Claude Code again.
Yang perlu dilakukan:
- Jalankan
claudelagi di shell Anda. Jika pesan menyatakan bahwa percakapan Anda tersimpan, jalankan/resumedi sesi baru dan pilih percakapannya. Jika tidak ada di daftar, perluas picker sesi - Jika proses mulai ulang terus gagal, mulai Claude Code dari shell Anda dengan
claude --debug-file claude-debug.log. Jika mulai ulang dari sesi tersebut gagal,claude-debug.logdi direktori tempat Anda memulai mencatat barisFailed to relaunch:dengan error dari sistem operasi. Sertakan baris tersebut saat Anda melaporkan masalahnya
Tidak dapat membuka Claude Desktop
Anda menjalankan/desktop atau aliasnya /app dalam sesi, atau claude --desktop di shell Anda, dan perintah sistem yang digunakan Claude Code untuk membuka Claude Desktop gagal. Setelah /desktop, sesi tetap berada di terminal; claude --desktop mencetak pesan tanpa awalan Error: dan keluar dengan status 1.
Teks di dalam tanda kurung menyebutkan perintah yang gagal, beserta status keluarnya dan baris pertama output kesalahannya jika perintah tersebut menghasilkannya. Di macOS perintah tersebut adalah open, seperti dalam contoh ini; di Windows perintahnya adalah rundll32:
- Buka Claude Desktop sendiri, lalu jalankan
/desktopatauclaude --desktoplagi - Untuk membaca output kesalahan lengkap dari perintah yang gagal, aktifkan logging debug dengan
/debuglalu jalankan/desktoplagi, atau jalankanclaude --desktop --debug-file <path>, lalu periksa log debug
Open Claude Desktop and run /desktop again. Sebelum v2.1.275, pesannya adalah Failed to open Claude Desktop. Please try opening it manually. dan tidak menyebutkan apa yang gagal.
/terminal-setup membiarkan keymap Zed Anda tidak berubah
Anda menjalankan/terminal-setup di Zed, dan Claude Code tidak dapat menyelesaikan pembaruan pada keymap.json Zed Anda, sehingga file tersebut dibiarkan seperti semula.
Setiap pesan menyebutkan path ke keymap Anda dan diakhiri dengan blok pintasan keyboard untuk Anda tambahkan sendiri:
Couldn't read your Zed keymap, so it was left unchanged.: Claude Code tidak dapat membaca file tersebut, misalnya karena hak akses fileYour Zed keymap isn't a readable list of keybindings, so it was left unchanged.: file terbaca dengan baik tetapi tidak dapat di-parse sebagai array blok pintasan keyboard, bahkan dengan komentar//dan koma di akhir yang diizinkanCouldn't back up your Zed keymap; not modifying it.: Claude Code tidak dapat menyalin file ke cadangan.bakdi sebelahnya, sehingga tidak mengubah apa punCouldn't update your Zed keymap, so it was left unchanged.: hasil penggabungan tidak terverifikasi sebagai keymap valid yang memuat pintasan tersebut, sehingga Claude Code membuangnya alih-alih menulisnya. Blok pintasan keyboard dengan kunci duplikat dapat menyebabkan hal ini
- Salin blok dari pesan ke dalam array tingkat atas di
keymap.jsonAnda pada path yang disebutkan pesan - Untuk
isn't a readable list of keybindings, perbaiki kesalahan sintaksis, atau jadikan nilai tingkat atas file sebagai array, lalu jalankan/terminal-setuplagi
/terminal-setup tidak dapat mem-parse keymap Zed yang menggunakan komentar // atau koma di akhir, dan mengganti seluruh file hanya dengan pintasannya sendiri sambil melaporkan pintasan tersebut sebagai terpasang. Untuk memulihkan keymap yang diganti oleh versi sebelumnya, gunakan file cadangan .bak yang dijelaskan di Memasukkan prompt multibaris.
Laporan penggunaan skill tidak tersedia pada koneksi ini
Anda menjalankan/skill-doctor melalui Remote Control, dari ponsel atau browser Anda. Claude Code tidak mengirim laporan penggunaan skill melalui Remote Control dan membalas dengan pesan ini:
- Jalankan
/skill-doctordi terminal pada mesin tempat sesi berjalan, atau jalankanclaude -p "/skill-doctor"di sana
Gaya output kustom tidak dapat dipilih melalui Remote Control
Anda menjalankan/output-style dari aplikasi seluler atau web melalui Remote Control, atau perintah tersebut tiba dalam pesan yang diteruskan ke dalam sesi. Karena giliran seperti itu mungkin tidak berasal dari pemilik akun, Claude Code hanya mencantumkan dan memilih gaya bawaan pada giliran tersebut, dan menambahkan pemberitahuan ini setiap kali perintah mencantumkan gaya atau tidak mengenali nama yang Anda berikan. Nama gaya kustom mendapat balasan yang sama dengan nama yang tidak ada:
- Pilih gaya bawaan, misalnya
/output-style concise - Untuk menggunakan gaya kustom, atur
outputStyledi.claude/settings.local.jsonproyek, atau jalankan/output-style <style>di terminal sesi itu sendiri jika ada
Gaya output disimpan ke pengaturan lokal yang tidak dimuat oleh sesi ini
Anda mencoba beralih gaya output dengan/output-style <style> atau /config outputStyle=<style> dalam sesi yang sumber pengaturannya tidak menyertakan local. Contohnya adalah sesi Agent SDK yang settingSources-nya tidak menyertakan "local" dan sesi CLI yang dimulai dengan nilai --setting-sources yang tidak menyertakan local. Kedua perintah menyimpan gaya ke .claude/settings.local.json, file yang tidak pernah dibaca kembali oleh sesi seperti itu, sehingga Claude Code menolak alih-alih menulis pengaturan yang tidak akan berpengaruh:
- Tambahkan
localke sumber pengaturan sesi lalu beralih lagi - Atur kunci
outputStyledi file pengaturan yang dimuat oleh sesi, seperti.claude/settings.jsondi proyek atau~/.claude/settings.json. Di TypeScript SDK, aturoutputStyledi dalam objeksettingsinline; lihat Mengaktifkan gaya output
/recap hanya berjalan saat Anda sendiri yang memintanya
Permintaan/recap tidak berasal dari input Anda sendiri. Permintaan tersebut tiba dalam pesan yang diteruskan ke sesi dari thread Slack, Teams, atau proyek, atau dalam prompt yang dikirim oleh tugas terjadwal cloud atau program lain.
Pesan yang diteruskan tetap mendapat pemberitahuan ini meskipun Anda sendiri yang menulisnya. Claude Code tidak dapat memastikan bahwa pesan yang diteruskan atau otomatis berasal dari orang yang akunnya menjalankan sesi, sehingga ia menjawab dengan pemberitahuan ini alih-alih ringkasan:
/recap yang Anda teruskan ke claude -p, atau yang dikirim oleh aplikasi Agent SDK Anda sendiri ke sesi yang diluncurkannya, dihitung sebagai input Anda sendiri.
Yang perlu dilakukan:
- Buka sesi sendiri dan jalankan
/recapdi sana: di terminalnya, di aplikasi Desktop atau aplikasi seluler, di claude.ai/code, atau melalui Remote Control - Jika tugas terjadwal cloud atau program lain yang mengirimkannya, hapus
/recapdari prompt tersebut
/feedback is disabled by your organization’s policy
Pesan ini berarti umpan balik produk dinonaktifkan, sehingga perintah yang Anda ketik tidak membuka dialog umpan balik. Kebijakan organisasi dan penolakan sebelumnya sama-sama menghasilkan pesan ini:- Kebijakan organisasi: kebijakan organisasi Anda tidak mengizinkan umpan balik produk dari Claude Code.
/feedback,/bug, dan/sharesemuanya menjawab dengan pesan ini. - Penolakan sebelumnya: layanan umpan balik menolak laporan yang Anda kirim, misalnya dengan
Couldn't send feedback: Feedback has not been enabled for your organization./feedbackdan/bugkemudian dapat menjawab dengan pesan ini. Hal ini berlaku selama tujuh hari sejak penolakan tersebut di mesin ini. Ini berlaku di setiap paket, termasuk Pro dan Max.
- Untuk melaporkan bug, buka issue di github.com/anthropics/claude-code/issues. Siapa pun dapat membaca issue di sana, jadi jangan sertakan kode, transkrip, dan apa pun yang bersifat rahasia.
- Setelah penolakan sebelumnya, tunggu hingga tujuh hari berlalu, lalu kirim laporan lagi untuk melihat apakah layanan masih menolaknya
/feedback is disabled by your organization's policy. Contact your organization admin to enable it.
Error 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 dapat dimuat atau plugin yang terinstal tetapi tidak muncul, lihat Pemecahan masalah plugin.plugin eval is currently in early access
Anda menjalankanclaude plugin eval atau claude plugin eval init dan perintah tersebut keluar dengan kode 1 dengan salah satu pesan berikut sebelum melakukan apa pun:
- Jalankan
claude --version, laluclaude update, dan jalankan perintah tersebut lagi dalam sesi baru. Lihat persyaratan untuk plugin evals - Jika Anda melihat pesan kedua pada build terbaru, coba lagi nanti setelah menjalankan
claude updatesekali lagi
Marketplace is registered from an untrusted source
Marketplace terdaftar dengan nama yang dicadangkan untuk marketplace resmi Anthropic, tetapi sumber terdaftarnya bukan repositori GitHubanthropics. Claude Code memeriksa ulang nama yang dicadangkan setiap kali memuat atau memperbarui marketplace, sehingga marketplace dan plugin yang diinstal darinya berhenti dimuat. Sebelum v2.1.205, entri yang didaftarkan sebelum namanya dicadangkan tetap dimuat.
can only be used with GitHub sources from the 'anthropics' organization. claude plugin marketplace add menjalankan pemeriksaan yang sama, dan menolak nama yang dicadangkan dengan Failed to add marketplace: diikuti kalimat nama-yang-dicadangkan yang sama.
Yang harus dilakukan:
- Jika marketplace sudah terdaftar, jalankan
claude plugin marketplace remove <name>, lalu tambahkan lagi dari repositori resmigithub.com/anthropics - Jika Anda menerbitkan marketplace pihak ketiga yang menggunakan nama tersebut sebelum nama itu dicadangkan, ganti namanya dan minta pengguna untuk menambahkannya kembali dari sumber Anda
- Lihat daftar nama yang dicadangkan di bawah Skema marketplace
Nama marketplace adalah ejaan lain dari nama yang dicadangkan
Nama marketplace itu sendiri bukan nama yang dicadangkan, tetapi Claude Code memperlakukannya sebagai ejaan lain dari salah satunya. Nama yang dicadangkan mencantumkan ejaan mana yang dihitung sebagai nama yang dicadangkan. Claude Code menolak nama seperti itu saat Anda menambahkan marketplace:/plugin, claude plugin install, serta claude plugin update memberikan peringatan:
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:
- Ganti nama marketplace menjadi nama yang tidak mengeja nama yang dicadangkan, lalu tambahkan lagi
- Untuk peringatan entri yang diabaikan, jalankan perintah
claude plugin marketplace removeyang diberikan, atau hapus entri tersebut dari~/.claude/plugins/known_marketplaces.json
Claude Code refuses the marketplace name
Nama marketplace yang terdaftar meniru marketplace resmi Anthropic berdasarkan aturan yang dicantumkan di bagian tersebut. Jika marketplace didaftarkan dengan nama seperti itu sebelum pemeriksaan memblokirnya, marketplace dan plugin yang diinstal darinya berhenti dimuat, karena Claude Code memeriksa nama tersebut setiap kali membaca katalog marketplace. Ketika nama tersebut meniru nama resmi,claude plugin list dan tab Errors di /plugin melaporkan setiap plugin yang terdampak dengan pesan yang diawali:
Claude Code refuses this marketplace's name: it looks like one of Anthropic's own. claude plugin marketplace add menolak nama apa pun yang meniru dengan Marketplace name impersonates an official Anthropic/Claude marketplace.
Sebelum v2.1.282, claude plugin list dan /plugin juga melaporkan plugin dari nama yang meniru sebagai gagal dimuat, tanpa menyebutkan nama marketplace sebagai penyebabnya.
Yang harus dilakukan:
- Untuk mempertahankan marketplace yang dideklarasikan secara inline oleh file pengaturan dengan
"source": "settings", ganti namanya sebelum Anda menghapus nama lama, karena menghapus marketplace juga menghapus entrinya dari file pengaturan Anda. Claude Code v2.1.292 atau yang lebih baru mencantumkan langkah-langkah ini dalam pesannya:- Di setiap file pengaturan yang mencantumkan marketplace di bawah
extraKnownMarketplaces, berikan kunci entri dansource.name-nya satu nama ASCII biasa yang baru dan tidak terlihat seperti nama resmi. Jika administrator menambahkan marketplace melalui pengaturan terkelola organisasi Anda, administrator yang melakukan langkah ini - Jalankan
claude plugin marketplace remove <old-name>, atau hapus nama lama di tab Marketplaces di/plugin. Ini juga menghapus instalasi plugin-nya dan menghapus data, opsi, dan rahasianya - Jalankan Claude Code lagi, di folder proyek jika file tersebut adalah file pengaturan proyek. Kemudian instal plugin dari marketplace yang telah diganti namanya
- Di setiap file pengaturan yang mencantumkan marketplace di bawah
- Untuk mempertahankan marketplace lainnya, tunggu hingga pengelolanya mengganti namanya, lalu jalankan
claude plugin marketplace update <name> - Untuk menghapus marketplace, jalankan
claude plugin marketplace remove <name>. Ini juga menghapus instalasi plugin yang diinstal dari marketplace tersebut dan menghapus data, opsi, dan rahasianya - Jika Anda menerbitkan marketplace tersebut, ganti namanya di
marketplace.jsonAnda; pengguna kemudian memperbarui marketplace alih-alih menghapusnya
Marketplace is already added from a different source
Anda menyebutkan sumber marketplace baru dengan--marketplace <source> pada perintah instal, di dalam sesi atau dari shell Anda. Katalog yang diambil Claude Code dari sumber tersebut memiliki nama yang sama dengan marketplace yang sudah Anda tambahkan dari sumber yang berbeda. Claude Code mempertahankan marketplace yang ada alih-alih menggantinya, dan plugin tidak diinstal.
- Jika marketplace yang sudah Anda tambahkan adalah yang Anda inginkan, instal darinya berdasarkan nama:
/plugin install <plugin>@<name> - Untuk beralih ke sumber baru, jalankan
/plugin marketplace remove <name>, lalu coba ulang instalasi
Perintah plugin mereferensikan user_config dalam perintah shell
Perintah hook plugin, monitor, atau MCPheadersHelper mereferensikan opsi plugin ${user_config.KEY}, dan string hasil substitusi akan diteruskan ke shell. Nilai terkonfigurasi yang berisi $(...), backtick, atau ; akan dijalankan sebagai kode di sana, sehingga Claude Code menolak untuk memulai komponen tersebut alih-alih menyubstitusikan nilainya. Pemeriksaan dijalankan pada template perintah, sehingga kesalahan muncul bahkan ketika belum ada nilai yang dikonfigurasi. Sebelum v2.1.207, nilai tersebut disubstitusikan ke dalam perintah shell.
Kata-katanya bergantung pada surface mana yang mereferensikan opsi tersebut. Hook berbentuk shell melaporkan:
headersHelper melaporkan:
- Untuk hook, tambahkan array
argsagar hook berjalan dalam bentuk exec, di mana setiap${user_config.KEY}menjadi satu argumen tanpa shell di antaranya. Atau hapus referensi tersebut dan baca environment variable$CLAUDE_PLUGIN_OPTION_<KEY>di dalam skrip - Untuk monitor, hapus referensi tersebut dan buat skrip monitor membaca nilainya dari file konfigurasi
- Untuk
headersHelper, pindahkan${user_config.KEY}ke fieldheadersserver, yang tidak di-parse oleh shell, atau baca nilainya di dalam skrip helper
Plugin archive integrity check failed
Entri marketplace plugin menggunakan sumberarchive dengan pin sha256, dan digest file yang diunduh tidak cocok dengan pin tersebut. Claude Code menolak instalasi, sehingga tidak ada yang berubah di cache plugin. Ketidakcocokan ini memiliki tiga kemungkinan penyebab:
- File di URL berubah setelah pembuat menghitung pin
- Pembuat memasukkan digest yang salah di entri marketplace
- URL menyajikan file yang berbeda dari yang di-pin oleh pembuat
- Jika Anda menerbitkan plugin tersebut, hitung ulang digest dari file persis yang disajikan URL, misalnya dengan
shasum -a 256 my-plugin.zip, atauGet-FileHash -Algorithm SHA256 my-plugin.zipdi PowerShell, lalu perbaruisha256di entri marketplace - Jika Anda menginstal plugin tersebut, jalankan
/plugin marketplace update <name>untuk memperbarui katalog jika entrinya sudah diperbaiki, lalu coba ulang instalasi - Jika digest masih tidak cocok setelah pembaruan, tanyakan kepada pemilik marketplace file mana yang mereka pin sebelum menginstal
Path escapes plugin directory
Salah satu path komponen plugin mengarah ke luar direktori plugin atau tidak dapat dipastikan berada di dalamnya, sehingga Claude Code mengabaikan path tersebut dan memuat sisa plugin. Untuk path yang dideklarasikan plugin diplugin.json atau entri marketplace-nya, nama komponen dalam pesan, seperti commands atau hooks, menyebutkan field yang mendeklarasikan path tersebut.
claude plugin, error yang sama berbunyi Path escapes plugin directory: ./../shared.md (commands).
Claude Code menolak baik path yang menunjuk ke luar plugin sebagaimana tertulis, seperti ../shared-utils, maupun symlink yang mengarah ke luar plugin dan tidak diizinkan oleh aturan symlink marketplace. Untuk symlink, pesan juga menyebutkan ke mana path tersebut di-resolve:
hooks/hooks.json, berarti Claude Code melewati file tersebut. Ketika Claude Code tidak dapat memastikan bahwa file tersebut berada di dalam plugin, atau di dalam marketplace-nya untuk plugin di marketplace lokal, Claude Code melewati file tersebut. Pesan tersebut melaporkan file-file ini di bawah nama komponen yang ditampilkan:
hooks/hooks.json:hooksmonitors/monitors.json:monitorsSKILL.mddi root plugin:skills
hooks/hooks.json yang di-resolve ke luar plugin maupun marketplace lokalnya:
commands yang dideklarasikan di entri marketplace bahkan ketika path tersebut menunjuk ke luar direktori plugin.
Sebelum v2.1.257, pemeriksaan pada path yang dideklarasikan plugin hanya melihat ejaan path, bukan ke mana symlink mengarah.
Yang harus dilakukan:
- Jika Anda menginstal plugin tersebut dan tidak mengelolanya, laporkan pesan tersebut kepada pembuatnya
- Untuk path yang dideklarasikan plugin, pindahkan file yang direferensikan ke dalam direktori plugin dan arahkan path ke file tersebut dengan path relatif
./ - Jika path tersebut, atau folder di atasnya di dalam plugin, adalah symlink yang mengarah ke luar plugin, ganti symlink tersebut dengan salinan dari apa yang ditunjuknya
- Jika pesan menyebutkan bahwa path yang dideklarasikan plugin berisi backslash, tulis path tersebut dengan garis miring, misalnya
./commands/deploy.md - Jika pesan diakhiri dengan
EACCES, pulihkan permission eksekusi Anda pada setiap direktori yang mengarah ke file atau folder yang disebutkan path tersebut. Periksa direktori di atas path, lalu ikuti setiap symlink yang Anda temui dan periksa direktori yang mengarah ke tempat yang ditunjuknya. Untuk kode kesalahan lainnya, cari di penyebab dan langkah untuk path yang tidak dapat diperiksa. - Untuk berbagi file dengan plugin lain di marketplace yang sama, tautkan dengan symlink di dalam direktori plugin, dengan mengikuti aturan symlink
Server file path not read
Pesanpath not read berarti Claude Code tidak membaca file server MCP atau LSP yang disebutkan plugin, karena path file tersebut. Sisa plugin tetap dimuat, tanpa server yang didefinisikan file tersebut.
Bagian .. tetap dihitung bahkan ketika path tetap berada di dalam plugin, seperti dalam contoh ini:
- Jika Anda menginstal plugin tersebut dan tidak mengelolanya, laporkan pesan tersebut kepada pembuatnya
- Jika Anda mengelola plugin tersebut, simpan file server di dalam direktori plugin. Sebutkan file tersebut di manifest atau entri marketplace dengan path yang diawali
./dan tidak mengandung.., misalnya./servers/x.json - Untuk berbagi satu file server antar plugin di marketplace yang sama, tautkan file tersebut ke setiap plugin dengan symlink, dengan mengikuti aturan symlink
Plugin not loaded: its manifest was not read
Claude Code tidak dapat memastikan bahwa manifest plugin marketplace di.claude-plugin/plugin.json berada di dalam plugin, sehingga tidak memuat apa pun dari plugin tersebut. Untuk plugin di marketplace lokal, Claude Code juga tidak dapat memastikan bahwa manifest berada di dalam marketplace tersebut. Pesan muncul di tab Errors di /plugin, dan alasan di bagian akhirnya menyebutkan apa yang ditemukan Claude Code.
Misalnya, pesan ini ditujukan untuk plugin di marketplace lokal yang folder .claude-plugin-nya adalah symlink yang mengarah ke luar marketplace:
- Jika alasan diakhiri dengan
EACCES, pulihkan permission eksekusi Anda pada setiap direktori yang mengarah ke manifest. Periksa direktori di atas manifest, lalu ikuti setiap symlink yang Anda temui dan periksa direktori yang mengarah ke tempat yang ditunjuknya. Untuk kode kesalahan lainnya, cari di penyebab dan langkah untuk path yang tidak dapat diperiksa. - Jika Anda mengelola plugin tersebut dan alasan menyebutkan ke mana manifest di-resolve, folder
.claude-pluginatauplugin.jsonitu sendiri adalah symlink yang mengarah ke sana. Ganti tautan tersebut dengan salinan dari apa yang ditunjuknya. - Jika Anda menginstal plugin tersebut dan tidak mengelolanya, laporkan pesan tersebut kepada pembuatnya
Path could not be checked
Claude Code menanyakan kepada sistem operasi apakah path plugin ada dan mendapatkan kesalahan selain “not found”, sehingga tidak memuat apa yang disebutkan path tersebut. Seberapa banyak plugin yang dimuat bergantung pada path mana yang gagal:- Salah satu lokasi komponen default plugin, seperti folder
skills/, filemonitors/monitors.json, atauSKILL.mddi root plugin: komponen plugin lainnya tetap dimuat - Direktori plugin itu sendiri: tidak ada apa pun dari plugin tersebut yang dimuat
/plugin, kesalahan muncul di bawah plugin dan menyebutkan path serta kode yang dikembalikan sistem operasi:
claude plugin list, error yang sama berbunyi Path not found: /home/user/my-plugin/skills (skills, ELOOP).
Penyebab yang menghasilkan kesalahan ini antara lain:
ELOOP: symlink dalam path menunjuk ke dirinya sendiri atau membentuk loopEIOatauESTALE: path berada di mount jaringan yang rusak atau kedaluwarsaEACCES: salah satu direktori di atas path tidak memberi Anda permission untuk menelusurinya
- Ganti symlink yang menunjuk ke dirinya sendiri dengan folder sungguhan, atau hapus symlink tersebut
- Jika path berada di mount jaringan, mount ulang share tersebut
- Jika kodenya
EACCES, pulihkan permission eksekusi Anda pada direktori di atas path - Jalankan
/reload-pluginssetelah memperbaiki path, atau mulai ulang Claude Code, untuk memuat plugin atau komponen tersebut
Marketplace entry path does not stay inside the marketplace directory
Entri marketplace plugin mendeklarasikan path sumber yang tidak dapat di-resolve oleh Claude Code ke lokasi di dalam direktori marketplace itu sendiri, sehingga plugin tidak diinstal maupun dimuat. Penolakan ini mencakup:- Path entri yang absolut, keluar dari marketplace dengan
.., atau dieja seperti path jaringan - Di macOS dan Linux, path entri yang berisi backslash di mana pun setelah
./di awal - Entri di marketplace yang diambil dari sumber jarak jauh, seperti git atau URL, yang mencapai targetnya melalui symlink yang di-resolve ke luar direktori marketplace
- Entri relatif di marketplace yang ditambahkan dari URL langsung ke
marketplace.json-nya: Claude Code hanya mengunduh file tersebut, sehingga tidak ada file plugin lokal yang dapat disebutkan oleh path. Lihat Plugin dengan path relatif gagal di marketplace berbasis URL
claude plugin install melaporkan penolakan seperti ini:
claude plugin list menampilkan plugin tersebut sebagai failed to load dengan:
- Jika Anda mengelola marketplace tersebut, tulis
sourceentri sebagai path relatif biasa dengan garis miring, seperti./plugins/my-plugin, dan pastikan setiap symlink yang dilewatinya menunjuk ke dalam direktori marketplace - Jika Anda menambahkan marketplace dari URL langsung, entri relatif tidak dapat di-resolve. Minta pembuat marketplace untuk menggunakan sumber plugin lain, atau tambahkan marketplace dari repositori git-nya
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 tersebut:
Failed to load marketplace configuration: file ada tetapi bukan JSON yang valid atau tidak dapat dibaca. File kosong juga gagal dengan cara ini.Marketplace configuration file is corrupted: file adalah JSON yang valid tetapi isinya tidak cocok dengan skema registri.
claude plugin install melaporkan:
claude plugin install tidak melaporkan kegagalan ini.
Yang harus dilakukan:
- Buka
~/.claude/plugins/known_marketplaces.jsondan perbaiki JSON-nya, atau perbaiki entri yang disebutkan pesan sebagai tidak cocok dengan skema registri - Jika Anda tidak dapat memperbaikinya, hapus file tersebut atau ganti isinya dengan
{}, lalu tambahkan kembali setiap marketplace denganclaude plugin marketplace add <source>. Claude Code mendaftarkan ulang marketplace yang dideklarasikan pengaturan pengguna atau pengaturan terkelola Anda diextraKnownMarketplacessaat berikutnya Anda memulainya di folder yang telah Anda percayai.
Plugin is required by your organization
Anda menjalankanclaude plugin disable, atau menggunakan tab Installed di /plugin, untuk mematikan plugin yang disinkronkan dari claude.ai yang ditandai wajib oleh organisasi Anda:
- Minta admin organisasi claude.ai Anda untuk mengubah status wajib plugin tersebut di claude.ai
Plugin was not uninstalled
Anda menjalankanclaude plugin uninstall, atau memilih Uninstall di tab Installed di /plugin, dan penghapusan instalasi berhenti dengan pesan yang diawali "<plugin>" was not uninstalled:. Jika teks setelah titik dua tersebut diawali installed_plugins.json alih-alih menyebutkan file pengaturan, penyebabnya adalah konten di installed_plugins.json yang tidak dapat dibaca oleh versi Claude Code ini. Untuk bentuk tersebut, lihat installed_plugins.json berisi catatan yang tidak dapat dibaca versi ini.
Ketika Claude Code menghapus entri plugin dari enabledPlugins dan membaca kembali file pengaturan cakupan tersebut, plugin tersebut masih aktif di sana, atau file yang dapat mengaktifkannya tidak dapat dibaca atau diperiksa. Menghapus opsi, rahasia, dan data tersimpan plugin selagi entri pengaturan dapat mengaktifkannya kembali akan menyebabkan semuanya hilang, sehingga penghapusan instalasi berhenti: plugin tetap terinstal dan tidak ada yang disimpannya yang dihapus.
it is still switched on in <file>, although the settings change reported no error: penulisan pengaturan melaporkan keberhasilan tetapi entri masih ada ketika file dibaca kembaliit is still switched on in <file>, and the settings change failed (<error>): file tidak dapat disimpan, karena alasan di dalam tanda kurung<file> is there and could not be read: file ada tetapi tidak dapat dibaca sebagai pengaturan, misalnya karena bukan JSON yang valid, sehingga file tersebut mungkin masih mengaktifkan plugin<file> (not read: it is on a network path or is a link to one, or could not be checked): Claude Code tidak membaca file pengaturan proyek atau lokal karena file tersebut, atau folder.claudeyang menampungnya, adalah tautan yang mengarah ke lokasi jaringan, atau karena Claude Code tidak dapat memeriksa path tersebut
claude plugin uninstall keluar dengan kode 1, dan dengan --json hasilnya membawa failureCode: "settings_still_on". /plugin menampilkan pesan yang sama.
Yang harus dilakukan:
- Ikuti kalimat terakhir pesan: perbaiki atau ganti file pengaturan yang disebutkannya, atau hapus sendiri entri plugin dari
enabledPluginsdi file tersebut, lalu jalankan penghapusan instalasi lagi
Skipping connection (recent failure cached; retries automatically in 15 min, or edit the plugin config to retry now)
Pesan ini berarti Claude Code tidak menjalankan server MCP yang disediakan plugin berbasis stdio, karena koneksi ke server tersebut gagal kurang dari 15 menit sebelumnya:claude -p setidaknya 15 menit setelah koneksi gagal terakhir, Claude Code mencoba server tersebut lagi.
Yang harus dilakukan:
Agar Claude Code mencoba server tersebut lagi tanpa menunggu:
- Dalam sesi interaktif: jalankan
/mcp, pilih server, lalu pilih Reconnect - Dalam aplikasi Agent SDK: panggil
reconnectMcpServer()di TypeScript atauClaudeSDKClient.reconnect_mcp_server()di Python dengan nama server - Dalam
claude -p: mulai sesi interaktif yang memuat plugin yang sama, di mesin yang sama dan dengan akun sistem operasi serta nilaiCLAUDE_CONFIG_DIRyang sama dengan run Anda. Sambungkan ulang server di sana dari/mcp. Setelah terhubung, Claude Code mencoba koneksi pada run Anda berikutnya. - Jika Anda sedang mengembangkan plugin: ubah
command,args, atauenvserver di.mcp.jsonatauplugin.jsonplugin. Claude Code mencoba koneksi pada sesi berikutnya atau runclaude -pyang memuat entri yang diubah.
Error tool
Error berikut berasal dari panggilan tool Claude. Claude memperbaiki sebagian besar error tool dengan sendirinya. Jika suatu error memerlukan perubahan dari Anda, daftar Yang harus dilakukan pada error tersebut menjelaskan apa yang perlu diubah.No such tool available
Claude memanggil tool dengan nama yang tidak ada dalam daftar tool sesi. Claude Code mengembalikan error tersebut kepada Claude sebagai hasil panggilan tool, dan giliran berlanjut. Jika Claude Code dapat mengetahui mengapa tool tersebut tidak ada, Claude Code menambahkan kalimat setelah nama tool yang menyebutkan alasannya atau menyebutkan tool yang seharusnya dipanggil, seperti pada baris kedua:- Jika hal ini terjadi sekali, Anda tidak perlu melakukan apa pun. Claude membaca error tersebut dan giliran berlanjut.
- Jika panggilan ke tool milik server MCP terus gagal dengan error ini, jalankan
/mcpdi sesi atauclaude mcp listdi shell Anda untuk memeriksa status server, lalu hubungkan kembali server yang gagal dari/mcp. Di Agent SDK, lihat Penanganan error.
MCP server connection closed before the tool call was answered
Panggilan tool ke server MCP HTTP atau konektor claude.ai kehilangan koneksinya sebelum server menjawab, sehingga Claude Code tidak dapat mengetahui apakah tool tersebut telah berjalan:- Periksa di layanan yang menjadi sasaran tool apakah tindakan tersebut terjadi, misalnya apakah issue atau catatan yang seharusnya dibuat sudah ada
- Jika tindakan tersebut terjadi, jangan jalankan tool itu lagi. Claude menerima pesan ini sebagai pengganti hasil tool, jadi beri tahu Claude hasilnya.
- Jika tindakan tersebut tidak terjadi, minta Claude menjalankan tool itu lagi. Anda tidak perlu menghubungkan kembali server terlebih dahulu, karena Claude Code akan terhubung lagi ke server tersebut untuk panggilan berikutnya ke salah satu tool-nya. Jika koneksi tersebut juga gagal, lihat Koneksi server jarak jauh yang terputus di tengah sesi.
- Jika Anda membangun server tersebut dan tool-nya aman dipanggil dua kali, tandai tool sebagai aman untuk diulang agar Claude Code dapat mengulangi panggilan yang hilang
MCP server is disabled
Pesan ini dalam hasil tool berarti Claude memanggil tool pada server MCP yang dimatikan. Claude Code tidak terhubung ke server tersebut, sehingga tool tidak berjalan, dan Claude menerima teks ini sebagai pengganti hasil:- Jika Anda memang bermaksud mematikan server tersebut, Anda tidak perlu melakukan apa pun
- Jika Claude memerlukan tool dari server tersebut, nyalakan kembali dari
/mcpdi prompt Claude Code - Di aplikasi Agent SDK, nyalakan kembali server dengan memanggil
toggleMcpServer()di TypeScript denganenableddisetel ketrue, atautoggle_mcp_server()di Python denganenableddisetel keTrue
Panggilan tool MCP mengalami timeout dengan pertanyaan server yang belum dijawab
Dalam mode non-interaktif, sebuah server MCP meminta input melalui elicitation selama panggilan tool, dan batas waktu panggilan habis sebelum jawaban datang:timed out after <N>s dan tidak menyebutkan apa pun tentang pertanyaan tersebut.
Yang harus dilakukan:
- Siapkan hook
Elicitationyang menjawab permintaan server - Di aplikasi Agent SDK TypeScript, buat callback
onElicitationAnda mengembalikan jawabannya sebelum batas waktu habis - Untuk memberi waktu lebih lama bagi jawaban, setel
timeoutyang lebih panjang dalam milidetik pada entri konfigurasi server, seperti"timeout": 600000untuk 10 menit - Jalankan tugas tersebut dalam sesi interaktif sebagai gantinya dan jawab sendiri dialog server
Permission prompt tool returned an invalid result
Tool yang Anda berikan ke--permission-prompt-tool mengembalikan jawaban yang tidak dapat dibaca Claude Code, sehingga panggilan tool yang menunggunya tidak berjalan, bahkan jika jawabannya mengizinkan panggilan tersebut:
- Kembalikan satu blok teks yang teksnya adalah
{"behavior": "allow"}atau{"behavior": "deny", "message": "<reason>"}. Untuk mengubah input, tambahkanupdatedInputke objekallow. Dari v2.1.86 hingga v2.1.206,allowmemerlukan"updatedInput": {}untuk mempertahankan input. - Jangan kembalikan
structuredContent, yang mungkin ditambahkan sendiri oleh MCP SDK Anda. Misalnya, daftarkan tool tersebut:FastMCPatauMCPServerdarimcp.server: denganstructured_output=FalseFastMCPdarifastmcp: denganoutput_schema=None, dan kembalikan string- MCP TypeScript SDK: tanpa
outputSchema
- Jika error hanya muncul dengan input sekitar 40 KB atau lebih, jangan salin input ke dalam
updatedInputataumessagepada deny. Untuk mengubah input sebesar itu, naikkan batas output tool prompt Anda.
Agent would be spawned with zero tools
Setiap entri dalam daftartools subagent gagal dicocokkan dengan tool yang dapat digunakan, sehingga Claude Code menolak meluncurkan subagent tersebut: tanpa tool, subagent tidak dapat bertindak. Pesan tersebut mengelompokkan entri Anda berdasarkan apa yang salah:
- Unrecognized: entri tidak cocok dengan nama tool mana pun, biasanya salah ketik seperti
GrpeuntukGrep. - Not available to subagents: entri menyebutkan tool nyata yang tidak dapat digunakan subagent. Subagent latar belakang memiliki set tool bawaan yang lebih kecil, sehingga entri yang hanya dapat digunakan oleh subagent latar depan masuk ke sini ketika subagent akan berjalan di latar belakang, yang merupakan default. Jika Anda mencantumkan
Agent, pesan melaporkannya di bawah kelompok berikutnya. - Matched no tools in this session: entri valid tetapi tidak ada tool dalam sesi saat ini yang cocok dengannya saat ini, seperti
mcp__github__*tanpa server MCP GitHub yang terhubung, atauAgentuntuk subagent yang berada pada batas kedalaman.
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 tool.
Sebelum v2.1.208, subagent diluncurkan tanpa tool dan dapat mengembalikan hasil yang kosong atau membingungkan.
- Perbaiki setiap entri yang disebutkan error dengan mengacu pada tool yang tersedia untuk subagent
- Hapus entri untuk tool yang tidak dimiliki sesi, seperti tool MCP dari server yang tidak terhubung
- Jika entri menyebutkan server MCP yang terhubung, bandingkan entri tersebut dengan nama server sebagaimana dieja dalam nama tool server tersebut, seperti
reports__v2dalammcp__reports__v2__get_totals. Untuk server tersebut, tulismcp__reports__v2__*, yaitumcp__diikuti nama lengkap dan__*. Denganmcp__reportsyang lebih pendek, yang menyebutkan server bernamareports, subagent tidak mendapatkan satu pun toolreports__v2 - Untuk tool yang dibuang oleh subagent latar belakang, seperti
CronCreate, hapus entrinya - Untuk tetap mempertahankan tool seperti
CronCreate, biarkan Claude menunggu subagent, karena subagent yang ditunggu Claude berjalan di latar depan dan mempertahankan tool tersebut. Jika definisi menyetelbackground: true, hapus field tersebut terlebih dahulu, karena field itu membuat subagent tetap di latar belakang - Hapus field
toolsalih-alih mencantumkan tool untuk memberi subagent setiap tool yang tersedia untuk subagent - Untuk daftar
toolsyang hanya berisiAgent, naikkan batas kedalaman atau beri agent setidaknya satu tool lain: Claude Code menahanAgentpada batas tersebut, sehingga daftar yang tidak berisi apa pun selain itu di-resolve menjadi tanpa tool
File is covered by a Read deny rule
Tool Edit atau Write dipanggil pada path yang cocok dengan aturan denyRead, termasuk membuat file baru pada path tersebut. Kedua tool mengubah konten yang harus dapat dibaca kembali oleh Claude, sehingga Claude Code menolak panggilan sebelum ada akses file apa pun. NotebookEdit tidak tercakup oleh aturan deny Read. Sebelum v2.1.228, aturan tersebut hanya memblokir tool Edit, dan sebelum v2.1.208, hanya aturan deny Edit yang memblokir pengeditan.
and cannot be written sebagai gantinya.
Yang harus dilakukan:
- Jika Claude seharusnya dapat mengubah file tersebut, hapus atau persempit aturan deny
Readdi/permissionsatau di pengaturan - Jika file tersebut harus tetap tidak tersentuh, pertahankan aturan tersebut dan tambahkan aturan deny
Edituntuk path yang sama agar tool NotebookEdit juga diblokir
Pengaturan memblokir penulisan di luar direktori kerja
Ketika Claude mencoba menulis file dan panggilan tool gagal dengan pesan ini, path tersebut berada di luar direktori kerja sesi danpermissions.blockWritesOutsideWorkingDirectories aktif:
- Jika Claude tidak seharusnya menulis di sana, jangan lakukan apa pun
- Untuk mengizinkan Claude menulis ke direktori yang sudah ada yang berisi path tersebut, jalankan
/add-dir <directory>di prompt Claude Code, atau berikan--add-dir <directory>saat Anda memulai Claude Code - Jika path tersebut adalah file pengaturan Claude Code, seperti
~/.claude/settings.json, edit sendiri file tersebut. Menambahkan direktorinya dengan/add-dirtidak membantu, karena Claude Code kemudian menolak penulisan tersebut sebagai file pengaturan. - Agar sebuah direktori tetap dapat ditulisi di setiap sesi, cantumkan di bawah
permissions.additionalDirectoriesdalam pengaturan pengguna atau pengaturan terkelola Anda - Untuk mematikan
permissions.blockWritesOutsideWorkingDirectories, hapus dari setiap file pengaturan yang menyetelnya, lalu mulai ulang Claude Code - Jika tidak ada file pengaturan Anda yang memiliki
permissions.blockWritesOutsideWorkingDirectories, pengaturan tersebut dapat berasal dari--settingsatau dari aplikasi host. Claude Code juga menolak penulisan ini selama tidak dapat membacapermissionsdalam pengaturan terkelola Anda. Tanyakan kepada pihak yang meluncurkan atau mengelola sesi.
Writes to Claude Code settings files are blocked
Ketika Claude mencoba menulis file dan panggilan tool gagal dengan pesan ini, Claude Code memperlakukan file tersebut sebagai salah satu file pengaturannya danpermissions.blockWritesOutsideWorkingDirectories aktif:
- Untuk mengubah pengaturan, edit sendiri file pengaturan tersebut
- Untuk mengizinkan Claude mengedit file pengaturan lagi, hapus
permissions.blockWritesOutsideWorkingDirectoriesdari setiap file pengaturan yang menyetelnya, lalu mulai ulang Claude Code - Jika file tersebut bukan salah satu file pengaturan Anda, temukan di antara file lain yang diperlakukan Claude Code sebagai file pengaturan:
- File yang Anda berikan ke
--agentsatau--mcp-config: edit sendiri - Salinan tersimpan dari pengaturan yang dikelola server dan file yang disimpan bersamanya: minta Owner untuk mengubah pengaturan di pengaturan yang dikelola server.
- File
.jsonapa pun, selama Claude Code tidak dapat menentukan ke mana foldermanaged-settings.d/mengarah: minta administrator Anda untuk memeriksa folder tersebut
- File yang Anda berikan ke
Path cannot contain null bytes
Argumen path atau pola pada panggilan tool file berisi byte null, yang tidak dapat diterima oleh sistem file dan tool pencarian. Read, Write, Edit, NotebookEdit, Glob, dan Grep memeriksa hal ini, dan pesan tersebut menyebutkan tool serta argumennya:- Tidak ada yang perlu dilakukan di pihak Anda: error dikembalikan kepada Claude sebagai hasil tool, dan pesan itu sendiri memberi tahu Claude untuk menghapus byte null dan mencoba lagi
Path contains null bytes, dan tool tidak pernah berjalan.
Perintah berisi karakter tak terlihat
Tool PowerShell menolak menjalankan perintah yang berisi U+FEFF atau U+180E:- Untuk perintah yang ditulis Claude: tidak ada yang perlu Anda perbaiki. Pesan tersebut memberi tahu Claude cara menulis ulang perintah.
- Untuk file skill atau perintah: pesan tersebut muncul setelah
No shell command in <name> was run. Lihat tempat menemukan karakter tersebut dan menghapusnya.
Perintah yang disetujui tidak dijalankan setelah Claude Code dimulai ulang
Perintah shell yang Anda setujui tidak berjalan, dan Claude menerima pesan ini sebagai hasil perintah:It does not keep track of that directory across a restart in a session that has been in a worktree.
Yang harus dilakukan:
- Biarkan Claude melanjutkan, dan jawab permintaan izin jika Anda diminta menyetujui perintah tersebut lagi.
File is too large to read as an image
Claude mencoba membaca file sebagai gambar dengan tool Read, dan file tersebut lebih besar dari 128 MB, ukuran maksimum yang dimuat Read dari file gambar. Tidak ada yang dibaca, dan Claude menerima error ini sebagai hasil tool:- Jika Claude mengikuti pesan
File is too largedan melanjutkan dengan mengubah ukuran gambar atau membaca salinan yang lebih kecil, jangan lakukan apa pun - Jika Claude berhenti pada error tersebut, ekspor sendiri salinan berukuran di bawah 128 MB, misalnya dengan resolusi lebih rendah, dan arahkan Claude ke file tersebut
- Jika path tersebut adalah pipe atau perangkat, arahkan Claude ke file gambar biasa sebagai gantinya
subagent_type is required
subagent_type, dan sesi ini tidak memiliki subagent serbaguna sebagai cadangan. Hal ini terjadi pada dua penyiapan:
CLAUDE_AGENT_SDK_DISABLE_BUILTIN_AGENTS=1disetel dalam mode non-interaktif, yang menghapus setiap subagent bawaan- Agent thread utama sesi memiliki allowlist
tools: Agent(...)yang tidak menyertakangeneral-purpose
- Biasanya tidak ada: pesan tersebut mencantumkan subagent yang dimiliki sesi, sehingga Claude dapat mencoba ulang dengan salah satunya
- Jika Claude terus gagal, tambahkan
general-purposeke allowlisttools: Agent(...), atau hapus setelanCLAUDE_AGENT_SDK_DISABLE_BUILTIN_AGENTS
Agent type 'general-purpose' not found.
Indeks memori melebihi batas bacanya
Claude menulis ke indeks auto memoryMEMORY.md dan membuatnya melebihi salah satu batas bacanya: 200 baris atau 25KB. Penulisan berhasil, tetapi hanya 200 baris pertama atau 25KB pertama, mana pun yang tercapai lebih dulu, yang dimuat di awal sesi, sehingga semua yang melewati batas dibuang setiap kali indeks dibaca. Sebelum v2.1.210, indeks yang melebihi batas dipotong secara diam-diam pada pemuatan berikutnya tanpa sinyal saat penulisan.
- Biarkan Claude menulis ulang
MEMORY.md, atau minta Claude melakukannya: pertahankan satu baris per entri, pindahkan detail ke file topik, dan gabungkan atau buang entri yang usang - Untuk memangkas indeks sendiri, lihat Audit dan edit memori Anda
Pola pkill cocok dengan proses Claude Code
Perintahpkill dalam panggilan tool Bash menggunakan pola, biasanya dengan -f, yang cocok dengan proses Claude Code itu sendiri, sehingga Claude Code menolak perintah tersebut alih-alih membiarkannya mengakhiri sesi. Claude Code menguji pola tersebut dengan pgrep sebelum menjalankan pkill dan menolak ketika ID prosesnya sendiri ada dalam hasil. Pemeriksaan ini hanya berjalan di Linux; di macOS, pkill berjalan tanpa modifikasi. Sebelum v2.1.214, perintah tersebut berjalan, dan pola yang cocok mematikan sesi Claude Code di tengah giliran.
- Persempit pola agar hanya cocok dengan proses yang dimaksud, misalnya path lengkap binary target, bukan substring pendek
- Untuk menghentikan proses yang dimulai oleh shell saat ini, gunakan
pkill -P $$dengan pola tersebut, yang membatasi pencocokan pada proses anak milik shell itu sendiri
Gagal menulis ke inbox rekan tim
Claude Code tidak dapat menulis pesan ke file mailbox rekan tim di bawah~/.claude/teams/{team-name}/inboxes/, sehingga penerima tidak menerima apa pun. Penulisan gagal ketika Claude Code tidak dapat membuat atau memperbarui file, misalnya karena disk penuh, direktori tidak dapat ditulisi, atau agent lain memegang kunci inbox terlalu lama. Sebelum v2.1.224, Claude Code melaporkan pesan sebagai terkirim bahkan ketika penulisan gagal.
Error muncul di hasil tool agent pengirim, bukan sebagai banner di terminal Anda, dan teksnya memberi tahu Claude untuk mencoba lagi:
Failed to write the <message> to <name>'s inbox — nothing was sent. plan approval dalam daftar tersebut adalah keputusan lead yang menyetujui rencana rekan tim; pengajuan rencana oleh rekan tim adalah pesan plan approval request yang terpisah. Pesan tersebut dan dua pesan protokol lainnya memiliki teks pesan dan konsekuensinya sendiri:
Failed to write the plan approval request to the lead's inbox — plan not submitted; try again: rencana rekan tim tidak pernah sampai ke lead, dan rekan tim tetap dalam plan mode hingga pengajuan ulang berhasilThe permission request could not be delivered to the team lead (mailbox write failed): permintaan izin rekan tim tidak pernah sampai ke lead, sehingga tidak ada yang menyetujui panggilan toolThe confirmation could not be written to team-lead's inbox.: persetujuan shutdown itu sendiri berlaku dan rekan tim keluar; hanya konfirmasi ke lead yang hilang
@name diikuti pesan di sesi lead, kegagalan yang sama muncul sebagai notifikasi, Couldn't write to @name's inbox — message not sent. Try again., dan Claude Code mempertahankan teks Anda di kotak prompt agar Anda dapat mengirimnya lagi.
Yang harus dilakukan:
- Minta pengirim mengirim ulang pesan; perebutan kunci inbox bersifat sementara dan akan hilang saat dicoba ulang
- Periksa ruang disk yang kosong, dan periksa bahwa
~/.claude/teamsbeserta file di bawahnya dapat ditulisi oleh pengguna Anda
Definisi agent rekan tim tidak dipulihkan
Claude mengirim pesan ke rekan tim tim agent yang telah berhenti, dan Claude Code menghidupkannya kembali tanpa menerapkan ulang definisi subagent yang digunakan saat rekan tim tersebut dibuat. Pemberitahuan muncul setelah laporan pelanjutan di hasil tool agent pengirim dan menyebutkan alasannya. Ketika file definisi berasal dari folder tanpa kepercayaan yang tersimpan, pemberitahuan berbunyi:.claude/agents/ milik proyek atau milik direktori --add-dir, dan menerima dialog kepercayaan untuk folder induk tidak memenuhinya.
Yang harus dilakukan:
- Jalankan
claudedi folder yang disebutkan log debug dan terima dialog kepercayaan. Definisi akan diterapkan ulang saat Claude Code menghidupkan kembali rekan tim tersebut berikutnya; Anda tidak perlu memulai ulang sesi lead - Atau setel entri
hasTrustDialogAcceptedketruedi~/.claude.json, menggunakan kunciprojects["<path>"]persis seperti yang dicetak log debug
Only a teammate can approve a shutdown request
Claude Code menolak persetujuan shutdown tim agent karena sesi yang mengirimnya tidak berjalan sebagai rekan tim. Tidak ada yang dikirim dan tidak ada yang dimatikan. Penolakan muncul di hasil tool sesi pengirim:- Jika penolakan muncul di sesi lead Anda, periksa terlebih dahulu apakah rekan tim tersebut sudah dimatikan sejak itu. Penolakan dikembalikan kepada Claude dengan instruksi untuk mengirim
shutdown_requestsebagai gantinya, dan giliran berlanjut. Di sesi lead interaktif,<name> has shut down.muncul ketika rekan tim menyetujui permintaan shutdown. - Jika rekan tim masih berjalan, minta lead di prompt-nya untuk mematikan rekan tim tersebut, misalnya
Ask the researcher teammate to shut down. Lihat Mematikan rekan tim. - Jika mantan rekan tim yang Anda lanjutkan sendiri dengan
claude --resumemendapat penolakan ini, tidak ada yang dikirim. Untuk mengakhiri sesi tersebut, jalankan/exitdi prompt-nya.
A command-line deny rule cannot be handed to a teammate intact
Pesan ini berarti Claude Code tidak memulai rekan tim split-pane di tim agent Anda. Claude Code meneruskan aturan deny baris perintah milik lead ke rekan tim split-pane melalui baris perintah rekan tim itu sendiri, dan berhenti ketika rekan tim akan membaca salah satu aturan tersebut secara berbeda:- Jalankan
/configdi sesi lead dan setel Teammate mode kein-process. Jika baris tersebut menampilkanoverriddendan sudah menunjukkanin-process, telusuri nilai-nilainya secara bergiliran hingga kembali ke nilai tersebut. Lalu minta Claude memulai rekan tim lagi. Rekan tim in-process berjalan di bawah aturan deny aktif milik lead. - Sesi berikutnya yang mengambil
teammateModedari pengaturan pengguna Anda juga memulai rekan tim secara in-process, karena/configmenyimpan pilihan tersebut di sana. Untuk kembali ke split pane di sesi berikutnya, setel Teammate mode keauto,tmux, atauiterm2, mana pun yang Anda gunakan sebelumnya.
Message too large for cross-session delivery
Pesan lintas sesi Claude ke salah satu sesi Anda yang lain di mesin ini terlalu panjang untuk dikirim. Claude Code menolaknya, dan sesi penerima tidak mendapatkan apa pun. Penolakan muncul di hasil tool sesi pengirim, bukan sebagai banner di terminal Anda. Penolakan tersebut menyebutkan kedua ukuran dan cara membuat pesan muat:- Minta Claude meringkas pesan, atau menaruh konten besar dalam file dan mengirim path file tersebut
- Minta Claude membagi konten menjadi beberapa pesan yang lebih pendek
Too many messages to this session just now
Claude mengirim rentetan cepat pesan lintas sesi ke salah satu sesi Anda di mesin ini, dan rentetan tersebut mencapai batas yang diterima inbox sesi itu. Claude Code menolak pengiriman berikutnya, dan sesi penerima tidak mendapatkan apa pun darinya. Penolakan muncul di hasil tool sesi pengirim, bukan sebagai banner di terminal Anda:- Biasanya tidak ada: Claude menggabungkan konten yang tersisa ke dalam satu pesan, atau menunggu sebelum mengirim lebih banyak
- Jika Anda sendiri yang memicu rentetan tersebut lewat prompt, minta Claude menggabungkan sisanya ke dalam satu pesan
Cross-session message was dropped at the recipient session’s inbox
Claude mengirim pesan lintas sesi ke salah satu sesi Anda yang lain di mesin ini, dan inbox sesi tersebut membuangnya sebelum Claude di sesi itu membacanya. Baris pesan menyebutkan penerima dan, ketika penerima memberikan alasan, menambahkan alasan tersebut setelah tanda pisah:Cross-session messages (12) were dropped. Untuk mengetahui sesi mana pemilik suatu alamat, bandingkan dengan baris Peer address yang ditampilkan /status di setiap sesi.
Setelah tanda pisah, baris tersebut memberikan satu atau beberapa alasan berikut:
its queue of undelivered peer messages was full: penerima sudah menampung pesan yang belum terkirim dari sesi lain sebanyak yang diizinkan antreannyayou sent faster than that session accepts: pesan dari sesi pengirim datang lebih cepat daripada yang diterima penerima dari satu pengirimit repeated your previous message: pesan tersebut identik dengan pesan yang dikirim sesi pengirim ke penerima ini tidak lama sebelumnyaa relay loop between sessions was cut: pesan tersebut melanjutkan rantai balasan yang dapat diputus yang panjang, seperti rantai yang mencakup sesi di luar mesin ini
- Anggap penerima tidak pernah melihat pesan yang dibuang. Claude Code memberi tahu Claude hal yang sama, dan memintanya untuk menyertakan apa pun yang masih penting dalam satu pesan berikutnya alih-alih langsung mengirim ulang
- Jika sesi Anda sering saling mengirim pembaruan, minta Claude mengirim pesan yang lebih sedikit tetapi lebih besar, seperti satu laporan ketika sebuah sesi menyelesaikan pekerjaannya
- Untuk
a relay loop between sessions was cut, ketik sendiri instruksi berikutnya di salah satu sesi. Pesan yang dikirim Claude sebagai respons terhadap prompt Anda sendiri memulai rantai baru
Menolak mengirim pesan lintas sesi
Sebelum Claude Code menulis pesan lintas sesi ke salah satu sesi Anda yang lain di mesin ini, Claude Code memeriksa bahwa socket inbox sesi target adalah endpoint yang dituju pesan tersebut. Ketika pemeriksaan gagal, Claude Code menolak pengiriman di sesi pengirim, dan sesi target tidak menerima apa pun. Untuk pesan yang dikirim Claude, penolakan muncul di hasil tool sesi pengirim:Refusing to send: menyebutkan pemeriksaan yang gagal:
reply target is a symlink: sebuah symlink berada di path socket sesi target. Claude Code tidak mengirim melaluinya, karena tautan di sana dapat mengalihkan pesan ke endpoint yang tidak dibuat oleh sesi target.cannot vet reply target: Claude Code sama sekali tidak dapat memeriksa path target, misalnya karena membacanya gagal dengan error permission.
- Biasanya tidak ada: pemeriksaan ini mencegah pesan mencapai endpoint selain sesi yang dituju, dan tidak ada yang dikirim
- Jika
reply target is a symlinkberulang untuk satu sesi, periksa apa yang membuat tautan di path socket sesi tersebut, yang ditampilkan di/statussesi itu di bawahPeer address
Menolak membaca, menulis, atau mencari sebuah path
Claude Code memeriksa aturan izin suatu path file, lalu mengonfirmasi resolusi tersebut lagi ketika tool membuka file atau memulai pencarian. Ketika Claude Code tidak dapat mengonfirmasi bahwa path tersebut masih mengarah ke lokasi yang disetujui oleh pemeriksaan, Claude Code menolak operasi tersebut alih-alih mengikutinya. Penolakan muncul di hasil tool:its symlink resolution changed after permission was checked: sebuah symlink di sepanjang path, atau pada root pencarian Grep atau Glob, diganti antara pemeriksaan izin dan operasi. Pada penolakan baca, frasa dalam tanda kurung menyebutkan perbandingan mana yang gagal.its parent-directory symlink resolution changed after permission was checked: direktori yang dilalui path penulisan tidak lagi di-resolve ke lokasi yang disetujuiwhere it leads on disk could not be determined (a link on the way could not be examined, or the links do not resolve): Claude Code tidak dapat mengikuti path tersebut hingga lokasi akhir di disk, misalnya karena symlink di dalamnya membentuk loopit is a symbolic link. Write to the link's target path instead: sebuah symlink berada tepat di lokasi penulisan yang diminta, misalnyaCLAUDE.mdyang merupakan symlink keAGENTS.md; pesan tersebut mengarahkan Claude ke target tautanRefusing to write through symlink: <path>. Resolve the symlink and pass the real target path explicitly.: kondisi yang sama yang terdeteksi ketika penulis lain membuka file, seperti penulisan ke.mcp.jsonyang merupakan symlinkRefusing to write into symlinked directory: <path>: direktori yang menampung file itu sendiri adalah symlink, misalnya direktori.claude/proyek yang ditautkan ke lokasi laina path one of its Read deny rules is written through changed while the search was being prepared. Retry.: aturan denyReaduntuk pencarian menyebutkan path yang melewati symlink, dan tautan tersebut berubah saat Claude Code sedang menyiapkan pencarianit could not be opened (EACCES) — it is unreadable, or is being replaced concurrently.: root pencarian ada tetapi tidak dapat dibuka; kode dalam tanda kurung adalah error sistem operasiits permission check expired before it ran (too many concurrent file operations). Retry.: Claude Code mengeluarkan catatan persetujuan karena banyaknya operasi file yang berjalan bersamaan sebelum tool menggunakannya; mencoba ulang akan menjalankan pemeriksaan izin yang baruripgrep 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 me-resolve binaryrgke path absolut, sehingga menolak pencarian di luar direktori kerja alih-alih menjalankan pencarian yang tidak tercakup oleh aturan deny Anda
- Biasanya tidak ada: penolakan sampai ke Claude sebagai hasil tool, dan operasi yang ditolak tidak berjalan
- Jika penolakan symlink berulang pada satu path, temukan apa yang terus menulis ulang tautan di sana, seperti tool build atau file watcher, atau minta Claude menggunakan path file yang sudah di-resolve alih-alih path yang ditautkan
- Jika penolakan ini muncul untuk setiap file saat Claude Code berjalan di Windows di dalam AppContainer atau sandbox restricted-token, tingkatkan ke v2.1.265 atau yang lebih baru
- Jika penolakan baca muncul di macOS untuk file yang tidak sedang ditulis ulang oleh apa pun, seperti tangkapan layar yang diseret ke prompt, tingkatkan ke v2.1.273 atau yang lebih baru
- Untuk penolakan ripgrep, instal ripgrep dengan package manager Anda agar
rgdi-resolve ke path absolut diPATH, atau tetap lakukan pencarian di bawah direktori kerja
where it leads on disk could not be determined tidak muncul.
The search failed, so this is not a “no matches” result
Pencarian Grep atau Glob yang dijalankan Claude gagal sebelum mengembalikan hasil apa pun, sehingga tidak diketahui apakah ada kecocokan. Pesan yang diterima Claude sebagai pengganti hasil dimulai dengan:- Saat pertama kali muncul: tidak ada. Pesan tersebut meminta Claude mencari lagi terlebih dahulu.
- Jika Claude mengatakan pencarian terus gagal: tangkap error ripgrep untuk laporan bug:
- Dari shell Anda, mulai sesi dengan flag yang sama seperti sesi tempat pencarian gagal, ditambah
--debug-file claude-debug.log - Kirim kepada Claude permintaan yang menyebabkan pencarian gagal
- Jika pencarian gagal lagi, temukan baris yang berisi
rg error (signal=diclaude-debug.log - Sertakan baris tersebut saat Anda melaporkan masalah
- Dari shell Anda, mulai sesi dengan flag yang sama seperti sesi tempat pencarian gagal, ditambah
Task output swap refused
Claude Code menyimpan output setiap perintah Bash ke file di bawah direktori temp-nya. Setiap kali membuka salah satu file ini, Claude Code memeriksa bahwa path tersebut masih mengarah ke file yang dibuatnya, tanpa symlink, hard link tambahan, atau direktori yang dipindahkan yang mengalihkannya. Pesan ini berarti pemeriksaan tersebut gagal, sehingga Claude Code menolak operasi alih-alih menulis atau membaca output melalui path tersebut. Pesan muncul di hasil tool Bash:output symlink was re-pointed, output file identity changed, dan not a regular file semuanya melaporkan kondisi yang sama: sesuatu di atau di sepanjang path output bukan lagi file yang dibuat Claude Code. Hanya sebagian alasan yang disertai kalimat To recover:.
Jika pemeriksaan gagal saat perintah masih berjalan, Claude Code menghentikan perintah tersebut, dan hasilnya melaporkan:
- Tingkatkan ke v2.1.260 atau yang lebih baru. Versi sebelumnya terkadang menampilkan pesan ini ketika tidak ada tautan atau direktori yang dipindahkan
- Mulai ulang Claude Code dengan
CLAUDE_CODE_TMPDIRdisetel ke direktori baru - Atau periksa direktori proyek Anda di bawah direktori temp Claude Code,
/private/tmp/claude-501/-Users-you-my-projectdalam contoh pesan. Jika path tersebut adalah symlink, atau direktori yang seharusnya tidak ada di sana, hapus tautan atau direktori itu sendiri, bukan target tautannya, lalu mulai ulang Claude Code - Jika penolakan berulang, ada proses yang mengganti, menautkan, atau menghapus entri di bawah direktori temp Claude Code saat sesi berjalan. Setel
CLAUDE_CODE_TMPDIRke direktori yang tidak dikelola oleh apa pun lainnya dan mulai ulang
Disk penuh atau kuota disk habis
Kosongkan ruang, inode, atau kuota disk pada volume yang menampung direktori sementara Claude Code. Baris dalam hasil perintah yang dimulai denganDisk full:, Disk quota used up:, atau Nearly out of inodes: menyebutkan direktori tersebut.
Claude Code menyimpan output setiap perintah Bash dan PowerShell ke file di bawah direktori tersebut. Jika Claude Code tidak dapat membuat file tersebut karena volume atau kuota Anda di volume tersebut penuh, perintah Anda tidak dimulai, dan hasil yang dibaca Claude adalah:
Disk full:, Disk quota used up:, dan Nearly out of inodes: mengikuti perintah yang berjalan dan keluar dengan kode bukan nol. Misalnya:
- Di macOS dan Linux, jalankan
df -h <dir>di shell Anda untuk melihat volume mana yang menampung direktori tersebut dan seberapa penuh volume itu.df -i <dir>menunjukkan berapa banyak inode yang kosong.<dir>adalah direktori yang disebutkan pesan Anda, seperti dalamdf -i /tmp/claude-501 Disk full: this computer's volumeataudisk is full (ENOSPC): di mana pun pada volume tersebut, hapus file yang tidak Anda perlukanDisk quota used up:,disk quota is used up (EDQUOT), atauDisk full: a test write: hapus file milik Anda sendiri pada volume tersebut, meskipun volume itu masih menunjukkan ruang kosongNearly out of inodes:: hapus banyak file pada volume tersebut. Setiap file menggunakan satu inode berapa pun ukurannya, sehingga yang penting adalah jumlahnya, bukan ukurannya- Atau mulai ulang Claude Code dengan
CLAUDE_CODE_TMPDIRdisetel ke direktori pada volume yang masih memiliki ruang - Lalu minta Claude menjalankan perintah tersebut lagi
Your disk quota is full on the filesystem with Claude Code's temp directory <dir> (EDQUOT)The filesystem with Claude Code's temp directory <dir>, or your disk quota on it, is full (ENOSPC)Command output was lost: the temp filesystem at <dir> is fullatau... is out of inodesThe command was not started: this computer's disk is full (ENOSPC), so the file that captures command output could not be created. Nothing ran., atau yang sama dengan(EDQUOT). Bentuk ini tidak menyebutkan direktori: periksa volume yang menampung direktori temp sistem Anda, seperti/tmp, atau direktori yang disetel diCLAUDE_CODE_TMPDIR
ENOSPC: no space left on device, open <path>.output.
git is not installed on this Mac
Pesan ini berarti sebuah langkah di Claude Code memerlukan git, dan git yang ditemukan adalah pengganti sementara milik Apple di/usr/bin/git. Developer tools yang menyediakan git belum terinstal.
Claude Code tidak menjalankan pengganti sementara tersebut dan menampilkan teks ini sebagai gantinya, misalnya di dalam pesan yang lebih panjang:
- Di Terminal, jalankan
xcode-select --install, selesaikan instalasi yang dimulainya, lalu coba lagi apa yang sedang Anda lakukan di Claude Code
File is not valid UTF-8
Claude menggunakan tool Edit atau NotebookEdit pada file yang byte-nya tidak dapat di-decode sebagai UTF-8, dan Claude Code menolak perubahan tersebut. Tidak ada yang ditulis, sehingga file tetap seperti semula. Tool tersebut menyimpan kembali seluruh file sebagai UTF-8, yang akan mengubah setiap byte yang tidak dapat di-decode menjadi karakter penggantiU+FFFD. Pesan muncul di hasil tool:
- Untuk mempertahankan file dalam encoding saat ini, biarkan Claude melakukan perubahan dengan perintah shell yang membaca dan menulis file dalam encoding tersebut, sebagaimana diperintahkan oleh pesan
- Untuk terus mengedit file dengan tool Edit, konversikan ke UTF-8, atau perbaiki byte yang tidak valid dalam file yang dimaksudkan sebagai UTF-8, lalu minta Claude melakukan pengeditan lagi
U+FFFD. Pada versi tersebut, perbarui Claude Code.
Refusing to apply edits: a hook is configured for file edits in this session
Claude mencoba memublikasikan artifact dengan pembaruan satu langkah, yaitu perubahan kecil pada file artifact yang disertakan dalam publikasi, dan Claude Code menolak. Tidak ada yang dipublikasikan dan file tidak berubah. Pesan muncul di hasil tool Artifact:PreToolUse atau mod pada Edit atau Write.
Yang harus dilakukan:
- Tidak ada, jika Claude melanjutkan dengan mengedit file dan memublikasikannya
- Jika Claude berhenti pada pesan tersebut, minta Claude mengedit file dan memublikasikannya
- Jika pesan terus muncul kembali, keluar dan luncurkan ulang Claude Code
- Jika pesan tetap muncul kembali bahkan setelah peluncuran ulang, matikan pembaruan satu langkah
The source file is not valid UTF-8 text
Claude mencoba memublikasikan artifact dari file yang byte-nya tidak dapat di-decode sebagai teks, atau yang teksnya sudah berisi karakter penggantiU+FFFD, sehingga Claude Code menolak publikasi sebelum mengunggah apa pun. Pesan muncul di hasil tool Artifact dan menyebutkan posisi pertama yang perlu diperbaiki:
UTF-16 dan tetap meminta Anda menulis ulang file sebagai UTF-8. Ketika ada posisi lain setelah posisi yang disebutkan, pesan menambahkan jumlah seperti (+2 more) setelah posisi tersebut.
Yang harus dilakukan:
- Biasanya tidak ada: Claude menulis ulang file dan memublikasikan lagi
- Jika file tersebut adalah file yang Anda tulis atau ekspor, simpan lagi sebagai UTF-8, dan ganti setiap
U+FFFDdengan karakter yang hilang karena pengeditan, penempelan, atau konversi sebelumnya - Untuk menampilkan
U+FFFDyang disengaja di halaman, tulis sebagai�dalam HTML alih-alih karakter literalnya
Not published: that file is on a network share
Claude mencoba memublikasikan artifact dari file pada path yang menyebutkan host jaringan:- Di Windows, path
\\server\shareyang tidak berada di bawah drive jaringan terpetakan yang Anda berikan saat peluncuran dengan--add-dir - Di macOS atau Linux, path automount seperti
/net/<host>/page.html
- Tidak ada, jika Anda tidak memerlukan file persis tersebut: pesan memberi tahu Claude untuk memublikasikan file dari folder sesi sendiri sebagai gantinya
- Untuk memublikasikan file persis tersebut, salin ke folder di disk lokal dan minta lagi
- Di Windows, untuk mengizinkan Claude memublikasikan langsung dari share, petakan share ke huruf drive dan berikan drive tersebut saat Anda memulai Claude Code. Di PowerShell, misalnya, jalankan
net use Z: \\server\sharelaluclaude --add-dir Z:\. Claude kemudian dapat memublikasikan file dari drive tersebut. Menambahkan drive di tengah sesi dengan/add-dirtidak cukup. - Di macOS atau Linux, mount share ke direktori seperti direktori di bawah
/mntatau/Volumes, dan publikasikan dari path tersebut alih-alih path automount
Not published: Claude sent the same content again after a newer version of the artifact turned it away
Baris merah di bawah panggilan Artifact ini berarti Claude Code menghentikan publikasi berulang: artifact tidak diperbarui, dan tidak ada yang ditulis ke file sumber publikasi Claude. Anda tidak perlu melakukan apa pun kecuali Claude berhenti tanpa memublikasikan. Sebelumnya dalam sesi, Claude Code menolak publikasi karena artifact memiliki versi yang lebih baru, misalnya versi yang dipublikasikan oleh editor atau salah satu sesi Anda yang lain. Akhir baris tersebut menyebutkan apa yang harus dilakukan Claude selanjutnya:- Diakhiri dengan
Claude needs to work from that newer version first: jika Claude berhenti di sana, minta Claude mengambil versi artifact saat ini, menggabungkan perubahannya, dan memublikasikan lagi - Diakhiri dengan
should go through: jika Claude berhenti di sana, minta Claude memublikasikan lagi
Membaca file lokal dari luar folder terhubung dalam sesi Cowork
Dalam sesi Cowork yang berjalan di mesin Anda pada aplikasi Claude Desktop, Claude menyebutkan file lokal untuk sebuah artifact. Claude Code tidak dapat mengonfirmasi bahwa file tersebut adalah file biasa di dalam folder terhubung sesi: path berada di luar folder tersebut, melewati symlink, atau dieja dengan cara yang dapat menunjuk file yang berbeda dari yang terlihat. Membaca file seperti itu memerlukan persetujuan Anda, dan dalam sesi yang tidak dapat menampilkan kartu persetujuan kepada Anda, seperti sesi yang disetel untuk melewati semua persetujuan, Claude Code menolak pembacaan tersebut. Penolakan muncul di hasil tool Artifact; ketika file sama sekali tidak dapat diperiksa, penolakan menyebutkan kegagalan tersebut sebagai gantinya:- Biasanya tidak ada: pesan memberi tahu Claude untuk menggunakan file biasa di dalam folder terhubung sebagai gantinya
- Untuk memasukkan file persis tersebut ke dalam artifact, salin ke salah satu folder terhubung sesi sebagai file biasa, bukan symlink, dan minta lagi
WebFetch cannot fetch localhost
Claude memanggil WebFetch dengan URL yang hostname-nya tidak memiliki titik, sepertihttp://localhost:3000 atau nama intranet tanpa domain seperti http://wiki/. WebFetch menolak URL ini sebelum membuat permintaan apa pun:
- Biasanya tidak ada: pesan mengarahkan Claude ke
curlmelalui tool Bash, yang dapat menjangkau server lokal dan intranet
Invalid URL.
Claude Code tidak dapat mengambil dari sebuah host
WebFetch mengirim hostname URL keapi.anthropic.com sebelum meminta halaman, untuk memeriksanya terhadap blocklist keamanan domain Anthropic. Pesan ini berarti pemeriksaan tersebut menjawab bahwa hostname tersebut tidak dapat diambil:
Pemeriksaan keamanan domain WebFetch gagal
Sebelum mengambil URL, WebFetch mengirim hostname URL tersebut keapi.anthropic.com untuk diperiksa terhadap blocklist keamanan domain Anthropic. Jika pemeriksaan tidak dapat diselesaikan, WebFetch tidak dapat mengonfirmasi bahwa domain tersebut aman, sehingga tidak mengambil halaman tersebut dan hasil tool berisi salah satu pesan berikut sebagai gantinya:
rate-limited: endpoint pemeriksaan menjawab dengan HTTP429. Pesan tersebut memberi tahu Claude untuk melanjutkan tanpa halaman itu dan mencoba lagi paling banyak satu kali nanti. Claude Code tidak menyimpan pemeriksaan yang gagal dalam cache, sehingga pengambilan domain tersebut berikutnya menjalankan pemeriksaan lagi. Jika sesi di jaringan Anda sering mengalami hal ini, Anda dapat melewati pemeriksaan denganskipWebFetchPreflight: truedi pengaturan.Unable to verify: permintaan pemeriksaan gagal, mengalami timeout, atau mendapat status error lain. Jika jaringan Anda memblokirapi.anthropic.com, tambahkan domain tersebut ke allowlist, atau lewati pemeriksaan denganskipWebFetchPreflight: truedi pengaturan.
The safety check for domain example.com is temporarily rate-limited (too many domain checks from this network). Retry after about a minute; retrying sooner will fail the same way..
Sebelum v2.1.285, pemeriksaan yang terkena rate limit dilaporkan dengan pesan Unable to verify sebagai gantinya.
Error sesi latar belakang
Sesi latar belakang berjalan tanpa terminal interaktif sendiri, sehingga perintah yang membutuhkannya berperilaku berbeda di sana. Pesan-pesan ini muncul di transkrip sesi latar belakang, di terminal yang terhubung ke sesi tersebut, di sesi atau shell tempat Anda melakukan dispatch, atau, untuk entri penjaga worktree di bawah, di sesi mana pun yang diisolasi dalam worktree atau yang menjalankan subagent yang diisolasi dalam worktree; jika sebuah pesan khusus untuk satu surface, entrinya menyebutkan hal tersebut.Perintah yang ditolak dalam sesi latar belakang
Perintah yang membuka dialog interaktif tidak dapat melakukannya selama tidak ada terminal yang terhubung ke sesi latar belakang./install-github-app, daftar pengaturan /mcp, dan tindakan autentikasi di menu server MCP merespons dengan sebuah pesan. Untuk /install-github-app dan daftar pengaturan /mcp, sesi juga muncul di bawah Needs input di agent view sehingga Anda dapat menemukannya, terhubung, dan menjalankan perintah tersebut lagi. Selama terminal terhubung, perintah-perintah ini berfungsi secara normal.
Sebelum v2.1.216, sesi tidak muncul di bawah Needs input setelah /install-github-app atau daftar pengaturan /mcp ditolak. Pada v2.1.213 hingga v2.1.215, perintah-perintah tersebut tetap berfungsi selama terminal terhubung, dan pesan penolakan meminta Anda untuk terhubung 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, atau lakukan upgrade. Sebelum v2.1.208, perintah-perintah tersebut membuka dialognya di dalam sesi latar belakang. Hanya pada v2.1.208, Claude Code juga menolak pemilih /model dalam sesi latar belakang, dan /upgrade mencetak URL upgrade alih-alih membuka browser.
Isi pesan menyebutkan nama perintahnya. Daftar pengaturan /mcp melaporkan:
- Hubungkan ke sesi dari agent view dan jalankan perintah lagi
- Atau gunakan bentuk yang disebutkan pesan, seperti
/mcp reconnect <server>,/mcp enable, atau/mcp disable, yang berfungsi tanpa perlu terhubung
Penulisan atau perintah diblokir karena path tidak dapat di-resolve dengan aman
Claude merujuk ke sebuah file atau direktori kerja melalui penulisan path yang tidak dapat di-resolve oleh penjaga isolasi worktree ke satu lokasi yang dapat diverifikasi. Penjaga ini memeriksa penulisan dan direktori kerja perintah di sesi mana pun yang diisolasi dalam worktree, baik interaktif maupun latar belakang, dan di subagent yang diisolasi dalam worktree. Penjaga me-resolve symlink sebelum memeriksa bahwa operasi tidak menjangkau checkout bersama, dan ketika resolusi gagal, penjaga memblokir operasi alih-alih membiarkannya mendarat di sana. Pesan menyebutkan bentuk path yang ditolaknya dan cara mencoba ulang:re-run the command from its direct symlink-free path. Sebelum v2.1.217, penjaga membandingkan penulisan path tanpa me-resolve symlink, sehingga penulisan path ini tidak diblokir dan penulisan yang diarahkan melalui symlink dapat mendarat di checkout bersama.
Yang harus dilakukan:
- Biasanya tidak ada: pesan lengkap dikirim ke Claude sebagai error tool, dan Claude mencoba ulang dengan path langsung yang disebutkannya. Untuk pengeditan file yang diblokir, tampilan percakapan hanya menampilkan baris singkat
Error editing file; pesan lengkap muncul di tampilan transkrip, yang Anda buka denganCtrl+O. Perintah yang diblokir mencetaknya di output perintahnya. - Jika pemblokiran berulang pada file yang sama, path tersebut kemungkinan melewati symlink yang di-commit yang targetnya mengandung
.., sepertidocs/current -> ../README.md; minta Claude untuk mengedit file target melalui path aslinya, bukan melalui tautan tersebut
Penulisan atau perintah diblokir karena path menunjuk ke lokasi jaringan
Claude merujuk ke sebuah file atau direktori kerja melalui path yang menunjuk ke drive yang tidak ada di mesin Anda, share UNC seperti\\server\share\file atau path automount /net, sementara checkout sesi berada di disk lokal. Penjaga isolasi worktree yang sama tidak dapat memverifikasi bahwa path seperti itu tetap berada di luar checkout bersama, sehingga penjaga memblokir operasi tersebut. Mengisolasi sesi dalam worktree tidak mencabut pemblokiran ini. Pesan menyebutkan bentuk path yang harus digunakan sebagai gantinya:
re-run the command from its local, plainly-spelled path. Sebelum v2.1.217, penjaga hanya membandingkan teks path, sehingga merujuk ke file di dalam checkout melalui path UNC atau /net tidak diblokir.
Yang harus dilakukan:
- Biasanya tidak ada: Claude mencoba ulang dengan penulisan path lokal yang diminta pesan
Perintah diblokir oleh pemeriksaan isolasi worktree
Claude menjalankan perintah Bash, PowerShell, atau Monitor di sesi yang diisolasi dalam worktree, dan Claude Code menolaknya karena salah satu alasan berikut:- Perintah akan berjalan di checkout utama atau di worktree lain. Pesan menyebutkan bahwa direktori kerjanya
resolved to the shared checkoutatauis in a different worktree. - Perintah Bash atau Monitor mengarahkan git ke checkout utama.
- Claude Code tidak dapat memverifikasi dari teks perintah Bash atau Monitor bahwa git apa pun yang dijalankan perintah tersebut tetap berada di dalam worktree. Perintah yang sama sekali tidak menyebut git tetap dapat ditolak karena alasan ini, karena mengekspansi indireksi variabel seperti
${!name}atau menjalankan substitusi fungsi Bash seperti${ command; }menghasilkan nilai saat runtime yang dapat berupa perintah.
is isolated in the worktree <path>, but this command, diikuti dengan alasannya, seperti perintah yang teksnya tidak dapat diverifikasi Claude Code:
- Git diarahkan ke checkout utama, atau teks perintah tidak dapat diverifikasi: tidak ada. Claude membaca pesan dan menulis ulang perintah sesuai yang diminta kalimat terakhirnya. Jika perintah yang Anda minta terus ditolak karena ekspansi dalam teksnya, tuliskan nilai yang ditandai secara literal dan jalankan git sebagai perintah tersendiri yang sederhana dari dalam worktree
- Untuk bertindak pada checkout utama secara sengaja, jalankan perintah tersebut sendiri di terminal di luar sesi
This session has no saved transcript
Anda terhubung ke sesi yang Anda pindahkan ke latar belakang dengan← atau /background dan yang berhenti sebelum menjalankan gilirannya sendiri. Claude Code tidak dapat menemukan percakapan tempat Anda memindahkannya, sehingga sesi tidak memiliki apa pun untuk dilanjutkan. Pesan diakhiri dengan perintah claude respawn untuk sesi ini:
Press enter again to restart this session fresh di bawah daftar, dan menekan Enter kedua kalinya pada baris tersebut memulai ulang sesi dengan percakapan kosong.
Yang harus dilakukan:
- Untuk memulai sesi yang berhenti dari awal, jalankan
claude respawn <id>dengan ID dari pesan, atau tekanEnterdua kali pada barisnya di agent view - Jika sesi sudah menyelesaikan sebuah respons dan Anda masih melihat penolakan ini pada versi sebelum v2.1.214, folder yang tidak dapat dibaca di
~/.claude/projectsdapat membuat pemindaian transkrip melewatkan percakapan yang tersimpan; perbarui ke v2.1.214 atau yang lebih baru, yang menoleransi folder yang tidak dapat dibaca selama pemindaian
This session is running in another terminal
Anda membuka baris sesi yang berhenti di agent view, dan percakapan tersimpannya sudah terbuka di proses Claude Code lain yang sedang berjalan di mesin ini, sehingga Claude Code menolak memulai proses kedua yang akan menulis ke transkrip yang sama. Pesan yang Anda lihat bergantung pada apa yang memegang percakapan tersebut:running in another terminal: proses selain sesi latar belakang memegang percakapan tersebut, misalnya eksekusiclaude -p, atau terminal tempat Anda melanjutkannya denganclaude --resumeatau/resume. Baris tersebut juga menampilkanOpen in a terminal.already open in another running Claude session: sesi latar belakang lain memegangnya.
- Untuk
running in another terminal: lanjutkan di terminal tersebut, atau keluar dari proses tersebut atau biarkan hingga selesai, lalu coba lagi - Untuk
already open in another running Claude session: gunakan sesi tersebut, atau hentikan sesi itu, lalu coba lagi
already open in another running Claude session yang ada: percakapan yang dilanjutkan di terminal tidak dihitung sebagai terbuka, dan membuka baris tersebut memulai proses Claude Code kedua yang menulis ke percakapan yang sama.
This session’s saved conversation is no longer on disk
Anda membuka sesi latar belakang yang berakhir saat layanan latar belakang mati, dan pembersihan transkrip sejak itu telah menghapus percakapan tersimpannya, misalnya setelah mesin mati selama berminggu-minggu. Membuka baris seperti itu biasanya melanjutkan percakapan tersimpannya. Karena tidak ada yang tersisa untuk dilanjutkan, Claude Code menolak alih-alih menjalankan ulang prompt asli sesi tanpa bertanya:claude attach <id> mencetak teks ini. Di agent view, footer lebih pendek dan diakhiri dengan ctrl+x removes the row.
Yang harus dilakukan:
- Jalankan
claude rm <id>untuk menghapus baris. Ketika salah satu kasus yang dipertahankan berlaku,claude rmjustru mempertahankan baris dan worktree serta menyebutkan alasannya - Untuk menjalankan prompt asli sesi lagi sebagai percakapan baru, jalankan
claude respawn <id>
Worktree has commits that are not pushed anywhere
Anda mencoba menghapus sesi latar belakang yang worktree-nya menyimpan commit yang tidak dapat dipastikan Claude Code tersimpan di tempat lain.claude rm menyebutkan cara melanjutkan:
The worktree has unpushed commits. Di agent view, baris sesi menampilkan not removed dengan alasan yang sama.
Yang harus dilakukan:
- Untuk mempertahankan commit, push commit tersebut. Setelah push menempatkannya pada remote-tracking branch, seperti
origin/claude/fix-login, coba hapus sesi lagi. - Jika pesan menawarkan untuk membuang commit, pastikan terlebih dahulu bahwa Anda tidak membutuhkan worktree, commit, maupun perubahan apa pun yang belum di-commit. Lalu ambil langkah yang diberikan pesan: tekan
Ctrl+Xdua kali pada baris sesi di agent view, atau jalankan perintahclaude rm <id> --discard-unpushed <commit>@<worktree-id>yang dicetak olehclaude rm. Jika Claude Code menolak lagi, ikuti pesan yang baru. - Ketika pesan menyebutkan bahwa worktree juga dicatat oleh sesi lain yang sudah selesai, menghapus lagi tidak membuangnya: push commit tersebut, lalu coba hapus sesi lagi
claude rm menempatkan ringkasan commit pada baris kept itu sendiri. Ketika claude rm tidak dapat meringkas commit, baris kept berbunyi worktree has commits that are not pushed anywhere sebagai pengganti ringkasan.
Sebelum v2.1.260, pesan tidak menyebutkan branch atau commit, dan tidak ada cara untuk membuang. Anda tetap dapat menghapus sesi, dengan kehilangan perubahan yang belum di-commit tetapi mempertahankan branch dan commit. Jalankan git worktree remove --force --force <path> dengan path yang dicetak penolakan, lalu claude rm <id>. Git membutuhkan --force dua kali untuk worktree yang terkunci.
Terminal host process died
Terminal setiap sesi latar belakang berjalan dalam proses host di bawah layanan latar belakang, dan proses tersebut mati saat layanan masih memegang koneksinya, sehingga sesi tidak dapat dijangkau. Di Linux dan WSL, layanan latar belakang memeriksa setiap proses host setiap beberapa detik, menandai sesi sebagai gagal ketika proses telah keluar tetapi koneksinya ke layanan tidak pernah ditutup, dan menampilkan alasannya pada barisnya di agent view:claude attach <id> memulai ulang sesi yang sudah ditandai gagal karena host yang mati, dan jika tidak, mencetak penyebabnya lalu keluar:
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 ulang perintah tersebut untuk Anda.
Yang harus dilakukan:
- Di agent view, tekan
Enterpada baris yang gagal; sesi dimulai ulang pada proses host baru dan percakapan dilanjutkan - Dari shell, jalankan
claude attach <id>lagi. Claude Code mencetakSession <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; lakukan dispatch perintah lagi untuk menjalankannya ulang
opening… · esc to cancel tanpa batas waktu dan claude attach <id> menunggu tanpa melaporkan error.
Session isn’t responding
Anda membuka sesi latar belakang dan layanan latar belakang menerima permintaan pembukaan tersebut, tetapi tidak ada output yang tiba selama sekitar sepuluh detik, sehingga Claude Code menyimpulkan bahwa proses yang meneruskan terminal sesi tidak dapat mengirimkan output, dan mengakhiri upaya tersebut alih-alih menunggu. Di agent view, Claude Code menawarkan mulai ulang di footer:claude attach <id> mencetak penyebabnya lalu keluar:
- Di agent view, tekan
Enterlagi pada baris yang sama. Claude Code menghentikan proses yang tidak merespons dan memulai ulang sesi, dan percakapan dilanjutkan. Tidak ada yang dihentikan tanpa tekanan kedua tersebut - Dari shell, jalankan
claude stop <id>, laluclaude attach <id> - Untuk baris perintah shell, tekan
Ctrl+Xdi agent view atau jalankanclaude stop <id>untuk menghentikannya; lakukan dispatch perintah lagi untuk menjalankannya ulang
Session was stopped while the respawn was in flight
Anda membuka sesi latar belakang yang prosesnya tidak berjalan, dan saat Claude Code sedang memulainya ulang, proses Claude Code lain menghentikannya, misalnyaclaude stop di terminal lain. Claude Code membiarkan sesi tetap berhenti:
- Jika Anda tidak menghentikan sesi tersebut, buka barisnya lagi di agent view atau jalankan
claude respawn <id>untuk memulainya ulang - Jika Anda sendiri yang menghentikannya, tidak ada lagi yang perlu dilakukan: sesi tetap berhenti
Session agent no longer available
Anda melanjutkan sesi yang menjalankan agent kustom, yang dimulai dengan--agent atau pengaturan agent, dan Claude Code tidak menemukan agent dengan nama tersebut. Claude Code mencari di direktori asli sesi terlebih dahulu, jika Anda telah memercayai workspace tersebut, lalu di direktori tempat Anda melanjutkan. Sesi tetap dilanjutkan, tetapi dengan tool default, sehingga pembatasan tool agent tidak lagi berlaku:
/resume atau claude --resume, maupun melanjutkan dalam mode non-interaktif, di mana peringatan juga dikirim ke stderr. Sesi yang menggunakan --input-format stream-json tidak menampilkannya, karena Agent SDK menyediakan agent setelah startup.
Claude Code tidak menyimpan fallback tersebut ke sesi, sehingga peringatan berulang pada setiap kali dilanjutkan hingga Anda bertindak. Agent bawaan claude tidak memicu peringatan, karena fallback ke set tool default tidak mengubah apa pun baginya. Sebelum v2.1.216, Claude Code diam-diam melanjutkan sebagai agent default, dan pencarian hanya mencakup direktori tempat Anda melanjutkan, sehingga agent dengan cakupan proyek hilang setiap kali dilanjutkan dari direktori lain.
Yang harus dilakukan:
- Buat ulang file agent di
.claude/agents/<name>.mddi proyek sesi, atau di~/.claude/agents/<name>.mduntuk agent pribadi, lalu lanjutkan lagi - Atau lanjutkan dengan
--agent <name>yang menyebutkan agent yang memang ada, untuk menjalankan sesi sebagai agent tersebut - Jika agent memiliki cakupan proyek dan Anda belum memercayai direktori asli sesi, jalankan Claude Code di sana sekali, terima dialog kepercayaan, lalu lanjutkan lagi
This session restarted after its next /loop wakeup was due
/loop dengan tempo sendiri dalam sesi latar belakang telah berhenti. Proses sesi berakhir saat loop sedang menunggu wakeup berikutnya, dan wakeup tersebut jatuh tempo sebelum proses berikutnya sesi dimulai. Wakeup yang terlewat tidak dijalankan terlambat. Pemberitahuan menyebutkan seberapa lama wakeup tersebut terlambat saat sesi dimulai ulang:
- Untuk melanjutkan loop, balas ke sesi dan nyatakan hal tersebut, misalnya
keep the loop running. Claude membaca pemberitahuan bersama balasan Anda dan dapat menjadwalkan wakeup berikutnya - Jika Anda sudah selesai dengan loop, jangan lakukan apa pun. Loop sudah berhenti
No LLM gateway: a gateway set in your shell isn’t passed to a session opened from another folder
Sesi latar belakang yang menampilkan pesan ini tidak menggunakan LLM gateway Anda: sesi tersebut tidak mendapatkan alamat gateway, sehingga permintaannya gagal. Pesan muncul di percakapan sebagai pengganti balasan Claude, dengan ID dan folder sesi Anda terisi:No LLM gateway: opened from another folder · respawn from ~/project.
Anda melakukan dispatch, membangunkan, atau memulai ulang sesi dari folder selain yang disebutkan pesan, saat ANTHROPIC_BASE_URL diatur ke gateway Anda. Untuk kasus di mana gateway yang diekspor di shell memang mencapai sesi latar belakang, lihat LLM gateway.
Yang harus dilakukan:
- Anda menggunakan agent view di proyek yang pengaturannya menetapkan gateway: masukkan
ANTHROPIC_BASE_URLbeserta kunci API atau token-nya di blokenvfile pengaturan. Gunakan~/.claude/settings.json, atau.claude/settings.local.jsondi proyek sesi itu sendiri, yang keduanya dibaca oleh sesi yang di-respawn. Lalu jalankanclaude respawn <id>di shell Anda dari folder mana pun. - Anda mengekspor gateway di terminal Anda: di terminal tempat Anda telah mengekspor variabel gateway,
cdke folder yang disebutkan pesan dan jalankan perintahclaude respawn <id>dari pesan tersebut. Sesi dimulai ulang dari percakapan tersimpannya.- Gateway mencapai sesi hanya ketika supervisor itu sendiri dimulai dari shell yang mengekspor gateway yang sama. Jika supervisor tidak dimulai dengan cara itu, mulai ulang dari terminal tersebut seperti yang dijelaskan di Dispatch gagal dengan
Could not resolve authentication method, lalu jalankan perintah respawn lagi.
- Gateway mencapai sesi hanya ketika supervisor itu sendiri dimulai dari shell yang mengekspor gateway yang sama. Jika supervisor tidak dimulai dengan cara itu, mulai ulang dari terminal tersebut seperti yang dijelaskan di Dispatch gagal dengan
Not logged in · Please run /login, tanpa menyebutkan folder.
Error launcher CLAUDE_CODE_PROCESS_WRAPPER
CLAUDE_CODE_PROCESS_WRAPPER diatur, dan nilainya tidak dapat digunakan, sehingga Claude Code menolak memulai proses yang terdampak alih-alih menjalankannya tanpa launcher. Masalah konfigurasi dilaporkan dengan pesan yang diawali nama variabel dan menyebutkan alasannya, misalnya:
must exec, not daemonize, diikuti apa pun yang dicetak launcher. Sesi yang tidak dapat dimulai atau menjangkau layanan latar belakang karena launcher melaporkan masalah launcher sebagai alasan di dalam Couldn't reach the background service (...).
Yang harus dilakukan:
- Atur variabel ke path absolut dari executable yang diakhiri dengan memanggil
exec "$@". Lihat kontrak launcher untuk kontrak lengkapnya - Periksa
/status, yang menampilkan perintah peluncuran yang telah di-resolve di entri Self-exec-nya dan memperingatkan ketika layanan latar belakang yang berjalan tidak cocok dengannya, atau jalankanclaude daemon statusdari shell - Setelah memperbaiki nilai di blok
envpengaturan, mulai ulang layanan latar belakang denganclaude daemon stop --anysehingga dispatch berikutnya memulai layanan yang dibungkus
EUNKNOWN saat memulai sesi latar belakang
Windows menolak memulai program dengan kode error yang tidak memiliki nama standar, sehingga kegagalan muncul sebagaiEUNKNOWN. Pemicu yang umum adalah kebijakan pembatasan perangkat lunak, seperti Group Policy atau AppLocker, yang memblokir program yang sedang dimulai. Error muncul saat Anda memulai sesi latar belakang dengan /background atau claude --bg:
daemon sebagai pengganti background service.
Pada instalasi npm, EUNKNOWN yang muncul saat npm install -g @anthropic-ai/claude-code sedang mengganti binary memiliki penyebab yang sama dengan EACCES selama instalasi ulang dan hilang ketika Anda mencoba ulang setelah instalasi selesai.
Claude Code memulai layanan latar belakang melalui PowerShell agar layanan tetap bertahan saat terminal ditutup, menggunakan PowerShell 7 jika terinstal dan Windows PowerShell 5.1 jika tidak. Ketika kedua PowerShell tidak dapat berjalan, Claude Code justru memulai layanan secara langsung, sehingga kebijakan yang hanya memblokir PowerShell tidak menyebabkan error ini.
Sebelum v2.1.212, Claude Code hanya menggunakan Windows PowerShell 5.1 untuk memulai layanan, sehingga mesin mana pun yang Group Policy-nya memblokir PowerShell 5.1 gagal dengan Couldn't start the session — EUNKNOWN: unknown error, uv_spawn, bahkan dengan PowerShell 7 terinstal.
Yang harus dilakukan:
- Jika pesan berbunyi
Couldn't start the session, upgrade ke v2.1.212 atau yang lebih baru. Pada versi sebelumnya, Anda juga dapat menjalankanclaude daemon rundi terminal terpisah terlebih dahulu, lalu memulai sesi latar belakang lagi. Perintah tersebut menjalankan layanan latar belakang di latar depan terminal, sehingga layanan hanya bertahan selama terminal tersebut tetap terbuka. - Jika instalasi npm sedang mengganti binary, tunggu hingga selesai, lalu mulai sesi latar belakang lagi
- Jika error muncul pada v2.1.212 atau yang lebih baru saat tidak ada instalasi npm yang berjalan, tanyakan kepada administrator Windows Anda apakah kebijakan pembatasan memblokir executable Claude Code
- Jika layanan latar belakang berhenti saat Anda menutup terminal, Claude Code memulainya tanpa PowerShell. Instal PowerShell 7, atau minta administrator Anda untuk membuka blokir PowerShell, agar layanan dapat bertahan lebih lama dari terminal.
EACCES saat memulai sesi latar belakang
Claude Code tidak dapat menjalankan binary-nya sendiri untuk memulai layanan latar belakang yang menjadi host sesi latar belakang. Pada instalasi npm, ini biasanya berartinpm install -g @anthropic-ai/claude-code sedang mengganti binary pada saat itu, baik Anda yang menjalankannya maupun auto-updater. Error muncul saat Anda membuka sesi dari agent view:
/background atau claude --bg, alasan yang sama muncul di dalam Couldn't reach the background service (...). Selama jendela instalasi ulang yang sama, error dapat menyebutkan kode lain, seperti ENOENT atau ENOEXEC, atau EUNKNOWN atau EPERM di Windows; EUNKNOWN yang tetap muncul setelah beberapa kali retry memiliki penyebab yang berbeda.
Pada instalasi npm, Claude Code menunggu instalasi ulang selesai dan mencoba ulang dengan sendirinya: hingga sepuluh detik, dan hingga dua menit selama instalasi npm Claude Code terlihat masih berjalan di mesin, yang mencakup proses Claude Code lain yang sedang mengunduh pembaruan. Ketika instalasi berlangsung lebih lama dari waktu tunggu tersebut, kegagalan menyebutkan pembaruan alih-alih hanya kode error:
- Tunggu beberapa detik, lalu buka sesi atau lakukan dispatch lagi. Ketika pesan menyebutkan bahwa Claude Code sedang diperbarui, coba lagi setelah pembaruan selesai.
- Jika error tetap ada saat tidak ada instalasi npm yang berjalan, pengguna Anda tidak dapat menjalankan binary yang terinstal. Periksa hak aksesnya dan hak akses direktorinya, atau instal ulang Claude Code.
Background service exited before it became reachable
Proses yang dimulai Claude Code sebagai layanan latar belakang keluar sebelum menerima koneksi, sehingga Claude Code tidak dapat membuka sesi Anda. Ketika layanan mencetak error sebelum keluar, alasan dalam tanda kurung memberikan exit code atau sinyal dan baris pertama yang dicetak layanan, yang menyebutkan apa yang menghentikannya:Couldn't start the background service —. Ketika layanan tidak mencetak apa pun sebelum keluar, pesan justru menyebutkan nothing on stderr.
Claude Code melaporkan kegagalan dengan baris error layanan. Sebelum v2.1.246, kegagalan baru muncul setelah penantian 45 detik, sebagai background service did not become reachable within 45s, tanpa baris error layanan.
Dua alasan yang dikutip memiliki penyebab yang diketahui:
Error: claude native binary not installed.: instalasi npm sedang mengganti binary Claude Code pada saat itu, sehingga layanan menjalankan placeholder npm. Coba lagi setelah instalasi selesai; jika baris tersebut tetap ada tanpa instalasi yang berjalan, selesaikan instalasi npm. Sebelum v2.1.257, pembaruan mandiri npm di macOS menghasilkan kegagalan ini pada setiap start selama jendela instalasi.nothing on stderrdengan exit code 1, pada setiap start, di Windows:daemon.lockmenyebutkan proses yang tidak dapat diberi sinyal oleh Claude Code maupun dibuktikan sudah tidak ada, sehingga setiap layanan baru menyimpulkan bahwa layanan lain memegang kunci tersebut dan keluar. Kunci yang penulisnya dapat dibuktikan Claude Code sudah tidak ada akan diganti dengan sendirinya dan tidak menghasilkan kegagalan ini. Ketika kegagalan berulang pada setiap start, hapus~/.claude/daemon.lock, lalu buka sesi atau lakukan dispatch lagi. Sebelum v2.1.257, kunci seperti itu memblokir setiap start hingga Anda menghapus file tersebut.
- Jika pesan mengutip sebuah baris, perbaiki apa yang disebutkannya, lalu buka sesi atau lakukan dispatch lagi. Upaya berikutnya memulai layanan lagi
- Jalankan
claude daemon statusuntuk memeriksa apakah ada layanan yang sedang berjalan saat ini
Direktori kerja tidak lagi ada saat memulai sesi latar belakang
Direktori tempat Anda memulai sesi latar belakang dihapus saat sesi sedang dimulai. Claude Code tidak memulai sesi, dan pesan menyebutkan direktori yang hilang:could not be resolved on disk.
Yang harus dilakukan:
- Buat ulang direktori yang disebutkan pesan, atau lakukan dispatch dari direktori yang ada, lalu coba lagi
This forked session could not be started
Anda melakukan fork sesi Remote Control dari claude.ai, dan Claude Code tidak dapat menyelesaikan pemulaian sesi latar belakang yang menjalankan fork di mesin Anda. Pemberitahuan ini muncul di transkrip sesi hasil fork:- Kembali ke sesi yang Anda fork dan fork lagi setelah sesi tersebut idle
Workspace tidak dipercaya saat melakukan dispatch sesi latar belakang
Anda memulai atau memulai ulang sesi latar belakang di direktori yang belum Anda percayai, dan dialog kepercayaan workspace tidak dapat muncul untuk menanyakannya kepada Anda. Claude Code tidak memulai sesi:The home directory is trusted one session at a time: direktori sesi adalah direktori home Anda. Claude Code tidak pernah menyimpan kepercayaan untuk direktori home, sehingga menerima dialog di sana pada sesi sebelumnya tidak dihitung.<path> could not be resolved on disk: Claude Code tidak dapat menemukan direktori sesi di disk.
- Jalankan
claudedi direktori yang disebutkan pesan dan terima dialog kepercayaan, lalu jalankan perintah lagi - Untuk pesan direktori home, jalankan perintah dari terminal di direktori home Anda agar dialog dapat muncul, atau mulai sesi dari direktori proyek sebagai gantinya
- Untuk pesan
could not be resolved on disk, buat ulang direktori tersebut, atau mulai sesi baru dari direktori yang ada
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.Subprocess initialization did not complete within 60000ms
Kesalahan ini berarti proses Claude Code yang diluncurkan oleh ekstensi VS Code atau aplikasi Agent SDK tidak melaporkan tepat waktu bahwa proses tersebut sudah siap. Ekstensi atau aplikasi kemudian menghentikannya. Dalam percakapan VS Code, kesalahan ini diawali denganClaude Code did not finish starting, misalnya:
Subprocess initialization did not complete within dan batas waktunya, lalu memberikan apa yang dilaporkan Claude Code, misalnya:
- Untuk mencoba lagi di VS Code, kirim sebuah pesan. Jika kesalahan muncul saat Anda sedang masuk, pilih kembali metode masuk sebagai gantinya.
- Untuk melihat sejauh mana Claude Code berjalan, klik View output logs di bawah kesalahan dalam percakapan, atau jalankan Claude Code: Show Logs dari Command Palette. Sertakan entri di sekitar baris
Subprocess initializationsaat melaporkan masalah. - Untuk memeriksa jaringan Anda, lihat Konfigurasi jaringan. Jika pesan meminta Anda memeriksa proses masuk atau autentikasi, lihat Login dan autentikasi.
- Jika pesan menyebutkan bahwa hook SessionStart atau Setup belum selesai, periksa berapa lama hook Anda berjalan. Di VS Code, 10 menit pertama saat Claude Code melaporkan hook ini sedang berjalan tidak dihitung terhadap batas 60 detik. Buat hook yang lambat selesai lebih cepat, turunkan
timeoutdari hook non-async, atau hapus hook tersebut. - Jika aplikasi Agent SDK Anda memanggil
startup(), aturinitializeTimeoutMscukup lama untuk seluruh proses mulai, atau biarkan tidak diatur sehingga waktu hook yang dilaporkan hingga 10 menit tidak dihitung.
Subprocess initialization did not complete within 60000ms — check authentication and network connectivity. Jika Anda melihat kata-kata tersebut, perbarui ekstensi atau SDK.
Proses Claude Code keluar dengan kode N
Prosesclaude 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.
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
claudedi terminal dalam proyek yang sama. Kegagalan biasanya direproduksi di sana dengan pesan kesalahan sebenarnya, yang kemudian dapat Anda cari di halaman ini. - Jalankan
claude doctordi 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 executableclaude yang terinstal di PATH. Ekstensi menolak untuk meluncurkan Claude Code sampai menemukan claude yang terinstal di PATH.
- 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 Verifikasi PATH Anda. 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.
The Claude Code program for this computer could not be found
Ekstensi VS Code mencari salinan Claude Code yang dibundel di dalamnya dan tidak menemukan satu pun yang di-build untuk komputer Anda. Pesan tersebut menyebutkan build yang dibutuhkan komputer Anda:- Jika pesan menyebutkan build mana yang dimiliki ekstensi, Anda memiliki paket ekstensi untuk platform lain: instal paket yang dibuat untuk build yang disebutkan dalam pesan
- Jika pesan tidak menyebutkan build mana yang dimiliki ekstensi, instal ulang ekstensi Claude Code dari tampilan Extensions di editor Anda
- Atau, dalam kedua kasus, atur
claudeCode.claudeProcessWrapperke binaryclaudeyang diinstal secara terpisah
Unsupported platform: <platform>-<arch>. No compatible Claude Code binary found.
Koneksi ke Claude Code berakhir sebelum pesan ini selesai
Ekstensi VS Code mengirim pesan Anda ke prosesclaude, dan koneksi berakhir tanpa kesalahan sebelum proses mengakui atau menyelesaikannya. Ekstensi tidak dapat mengatakan apakah pesan diproses, jadi meminta Anda untuk mengirimnya lagi:
- Kirim pesan lagi. Pesan berikutnya memulai proses
claudesegar yang melanjutkan percakapan. - Jika terulang, jalankan
claudedi 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
/rewind menulis dan menghapus melalui link di jalur terlacak, dan tidak melaporkan pemulihan sebagian.
- 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>.txtmenamai setiap jalur yang dilewati saat pemulihan berjalan, jadi aktifkan logging debug dengan/debugsebelum pemulihan berikutnya Anda. Di macOS atau Linux, Anda dapat menemukan link secara langsung:find . -type luntuk symlink danfind . -type f -links +1untuk 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
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.
/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
/rewindlagi gagal dengan cara yang sama. - Jika Claude Code tidak dapat menulis atau menghapus file, perbaiki apa yang memblokir penulisan, seperti izin file, kemudian jalankan
/rewindlagi. - Untuk menyimpan backup lebih lama di sesi mendatang, naikkan
cleanupPeriodDays.
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:- 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
--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 untukEDQUOT; pulihkan akses tulis ke lokasi transkrip untukEACCES,EPERM, atauEROFS - 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 denganCLAUDE_CODE_SKIP_PROMPT_HISTORY diatur, jadi Claude Code tidak menulis transkrip atau riwayat prompt untuk sesi ini:
- 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 mengaturCLAUDE_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:
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=1diatur. 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_SESSIONdari lingkungannya
Peringatan konfigurasi
Untuk menemukan peringatan yang diberikan Claude Code saat startup dalam sesi interaktif, periksa terlebih dahulu di bawah banner startup, lalu di log debug:- Baris di bawah banner startup: beberapa peringatan tentang aturan izin, seperti
⚠ Deny rule Bsh matches no tool · check for typos - Log debug: Claude Code menyimpan log ini hanya dalam mode debug. Untuk membaca peringatan di dalamnya, mulai Claude Code dari shell Anda dengan
claude --debug-file <path>, lalu buka file pada path tersebut.
Claude Code exited after an unrecoverable interface error
Claude Code mencetak pesan ini ketika keluar karena antarmuka terminalnya mengalami error yang tidak dapat dipulihkan, pada renderer mana pun. Kalimat kedua hanya muncul ketika error terjadi saat renderer layar penuh sedang dimulai:- Mulai Claude Code lagi. Untuk melanjutkan percakapan, jalankan
claude --resumedi direktori yang sama. - Jika pesan menyebut renderer layar penuh, Rendering layar penuh menjelaskan apa yang dilakukan peluncuran berikutnya, yang bergantung pada cara Anda mengaktifkan layar penuh, serta cara mencoba layar penuh lagi atau tetap menggunakan renderer klasik.
Agent descriptions are over the 15.0k-token limit
Claude Code menampilkan peringatan ini sebagai pemberitahuan startup di tampilan percakapan, bukan di stderr. Gabungan deskripsi subagent Anda, kecuali yang bawaan, melebihi 15.000 token menurut perkiraan Claude Code. Setiap agent menghitung namanya ditambah frontmatterdescription-nya. Claude Code memuat setiap agent terlepas dari apakah totalnya melebihi batas atau tidak, sehingga peringatan ini tidak mengubah apa yang dimuat.
- Persingkat frontmatter
descriptionpada file agent Anda, atau minta Claude untuk memangkasnya untuk Anda. - Hapus file agent yang tidak lagi Anda gunakan.
Hook needs quotes around a path with a space
Notifikasi di tampilan percakapan ini berarti skrip sebuah hook tidak berjalan karena path-nya mengandung spasi dan tidak diberi tanda kutip. Hook tersebut adalah hookasyncRewake dalam bentuk shell. Dalam command-nya, sebuah interpreter seperti python3 diikuti oleh placeholder path tanpa tanda kutip, dan path yang di-resolve mengandung spasi.
Notifikasi dimulai dengan nama event hook dan menyebut nama skripnya:
- Dalam
commandhook yang menjalankan skrip yang disebut notifikasi, bungkus path dengan tanda kutip ganda. Dalam file JSON, tuliskan sebagai"command": "python3 \"${CLAUDE_PLUGIN_ROOT}/hooks/check.py\"".
Instruction file not loaded
Pemberitahuan di tampilan percakapan sesi interaktif ini berarti sebuah file memori yang ada tidak dimuat. Sebuah pembatasan baca sedang berlaku.a Read deny rule covers it: sebuah aturan denyReadcocok dengan path file sebagaimana tertulis atau dengan tujuan yang ditunjuk oleh tautan pada file tersebutit's read from outside your working directories, where reads are blocked: file di-resolve ke luar direktori kerja sementarapermissions.blockReadsOutsideWorkingDirectoriesaktifwhere it leads couldn't be worked out: misalnya, file tersebut adalah tautan yang mengarah kembali ke dirinya sendiri, secara langsung atau melalui tautan lain
and 3 more instruction files not loaded.
Yang perlu dilakukan:
- Tidak ada, jika pembatasan tersebut memang disengaja: sesi berjalan tanpa instruksi dari file tersebut.
- Untuk memuat file yang ditahan karena
a Read deny rule covers it, hapus atau persempit aturan tersebut. Lalu mulai sesi baru. - Untuk memuat file yang ditahan karena
it's read from outside your working directories, where reads are blocked, pindahkan file tersebut atau target tautannya ke dalam direktori kerja. Lalu mulai sesi baru. - Untuk memuat file yang ditahan karena
where it leads couldn't be worked out, periksa apakah file tersebut adalah tautan yang mengarah kembali ke dirinya sendiri. Jika ya, arahkan tautan ke file yang ada atau letakkan file biasa di tempatnya. Lalu mulai sesi baru.
Skill, perintah, atau workflow tidak dimuat karena namanya dicadangkan
Sebuah folder skill,name frontmatter, file atau subfolder di .claude/commands/, atau workflow yang disimpan menggunakan nama anthropic-skills atau nama yang diawali dengan anthropic-skills:. Claude Code mencadangkan nama tersebut untuk skill yang disinkronkan dari claude.ai dan tidak memuat item tersebut.
Claude Code menampilkan peringatan ini sebagai pemberitahuan startup di tampilan percakapan, bukan di stderr:
name: yang harus diedit, atau workflow yang harus diganti namanya. Ketika lebih dari satu item ditolak, pemberitahuan diakhiri dengan hitungan seperti · 2 more, dan log debug menyebutkan masing-masing item.
Yang perlu dilakukan:
- Ganti nama item yang disebut pemberitahuan, atau edit baris
name:yang ditunjuknya, lalu mulai ulang sesi.
Skill or command name refused
Pemberitahuan startup ini berarti Claude Code menolak nama setidaknya satu skill atau perintah kustom, sehingga item tersebut tidak dimuat atau dimuat tanpa fieldname-nya:
- Tidak dimuat: Claude Code menolak nama yang digunakan oleh sebuah skill atau perintah, seperti nama direktorinya atau nama file perintah atau subfoldernya. Item tersebut tidak ada di menu
/dan Claude tidak dapat memanggilnya. Barisnya di log debug berbunyi<name> is not offered. - Field
namediabaikan: Claude Code menolaknamefrontmatter sebuah skill. Skill tetap dimuat, tetapi menu/tidak menampilkan nilainamedan mengetiknya tidak memanggil skill tersebut. Barisnya di log debug berbunyi<name value> is not shown for <skill>.
- Mulai Claude Code dengan
claude --debugdari shell Anda dan cari[names]di log debug. Setiap nama yang dihitung oleh pemberitahuan memiliki satu baris di sana. Baris tersebut menuliskan beberapa karakter tersembunyi sebagai kode, seperti\u{200B}untuk spasi nol-lebar, sehingga Anda dapat melihat letaknya. - Hapus karakter yang tidak boleh ada dalam nama skill dengan mengganti nama folder atau file atau mengedit baris
name:, atau persingkat nama yang lebih dari 256 karakter. Lalu mulai ulang sesi, kecuali jika file berada di direktori yang dipantau perubahannya oleh Claude Code. Untuk skill dari plugin yang tidak Anda tulis, minta penulis plugin untuk mengganti namanya.
Workspace has not been trusted
Claude Code menemukan aturanpermissions.allow atau entri permissions.additionalDirectories di .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 disebut dalam pesan bervariasi sesuai konfigurasi Anda. Aturan deny dan ask tidak terpengaruh.
- Jalankan
claudedi direktori tersebut dan terima dialog kepercayaan. Aturan allow proyek dan kepercayaan workspace menjelaskan folder mana yang dicakup oleh penerimaan tersebut. - Dalam mode non-interaktif dengan
-p, tidak ada dialog yang ditampilkan. Atur entrihasTrustDialogAccepteddi~/.claude.jsonmenggunakan keyprojectspersis seperti yang dicetak pesan. - Jika pesan menyebut
.claude/settings.local.jsondan Anda memulai Claude Code di luar repositori git atau di direktori home Anda, perbarui ke v2.1.200 atau yang lebih baru. Versi 2.1.196 hingga 2.1.199 memperlakukan.claude/settings.local.jsonmilik Anda sendiri sebagai disediakan oleh repositori di workspace tersebut. Pada v2.1.207 dan yang lebih baru, memperbarui saja tidak cukup di luar repositori git jika Anda belum memercayai folder tersebut: menentukan bahwa sebuah folder tidak berada di dalam repositori menjalankan git, dan Claude Code menjalankan pemeriksaan tersebut hanya setelah Anda menerima dialog kepercayaan, jadi gunakan langkah pertama. Direktori home Anda dan home konfigurasi lainnya dikecualikan dan tidak menunggu dialog. Lihat Aturan allow proyek dan kepercayaan workspace.
Direktori kerja adalah path jaringan
Claude Code tidak menambahkan path jaringan sebagai direktori kerja. Mencari path jaringan dapat menghubungi host yang disebutkannya, dan di Windows kontak tersebut dapat mengirimkan kredensial Anda ke host. Oleh karena itu, Claude Code menolak path tersebut tanpa mencarinya. Anda melihat pesan ini ketika menjalankan/add-dir dengan path jaringan:
--add-dir atau di permissions.additionalDirectories, Claude Code dimulai tanpa direktori tersebut. Dalam sesi interaktif, Anda tidak melihat pesan tersebut saat startup, karena pesan masuk ke log debug bersama peringatan startup lainnya.
Path yang ditolak Claude Code dengan cara ini meliputi:
- Share UNC seperti
\\server\share - Path automount seperti
/net/<host>, kecuali jika Anda meluncurkan Claude Code dari direktori di bawah automount host tersebut. Pembacaan di bawah automount tersebut tetap melalui pemeriksaan path jaringan. - Path lokal yang menjangkau lokasi jaringan melalui tautan simbolik atau junction
\\wsl$ tidak dihitung sebagai path jaringan.
Yang perlu dilakukan:
- Di Windows, petakan share ke huruf drive dan teruskan drive tersebut saat peluncuran. Di PowerShell, misalnya, jalankan
net use Z: \\server\sharelaluclaude --add-dir Z:\. - Di macOS atau Linux, mount share di path lokal dan tambahkan path tersebut.
- Jika path ada di
permissions.additionalDirectories, hapus dari file pengaturan yang mencantumkannya.
Remote managed settings failed to load
Sesi Anda memenuhi syarat untuk pengaturan yang dikelola server, tetapi Claude Code tidak dapat mengambilnya atau tidak dapat menerapkan apa yang dikembalikan server, sehingga menampilkan peringatan ini dalam sesi interaktif dan di tab Code Claude Desktop. Penyebab dalam tanda kurung menyebutkan apa yang gagal, sepertinetwork error, request timed out, atau authentication rejected (401). Penyebab no setting in the server response could be applied as written berarti server menjawab tetapi tidak ada pengaturan yang dikembalikannya yang lolos validasi. Sebelum v2.1.282, penyebab ini berbunyi server returned invalid settings.
Sisa baris menyebutkan kebijakan mana yang digunakan sesi:
- Pengaturan yang di-cache dari pengambilan sukses sebelumnya: Claude Code menjalankan sesi dengan kebijakan yang di-cache tersebut, kecuali environment variable yang ditahan, dan baris berbunyi
using cached policy. - Tidak ada pengaturan yang di-cache untuk diterapkan: Claude Code menjalankan sesi tanpa pengaturan yang dikelola server, dan baris berbunyi
no remote policy applied. Misalnya, mesin belum pernah mengambil pengaturan, atau terakhir mengambilnya lebih dari 24 jam yang lalu.
Remote managed settings are still loading: pengambilan masih berjalan saat sesi dilanjutkanRemote managed settings did not load: pengambilan berakhir tanpa jawabanRemote managed settings have now loaded: pengaturan dimuat setelah salah satu peringatan ini, dan sisa baris menyebutkan apakah kebijakan jarak jauh berlaku
- Tindak lanjuti penyebab yang disebut pesan: untuk penyebab jaringan, periksa bahwa mesin ini dapat menjangkau
api.anthropic.com; untuk penyebab autentikasi, periksa status masuk Anda dengan/status - Untuk
no setting in the server response could be applied as written, minta admin Anda untuk memperbaiki pengaturan di server - Jalankan
/statusatauclaude doctoruntuk diagnostik lengkap
Claude Code tidak dapat memuat pengaturan organisasi Anda
Sesi Anda belum dimulai karena pengaturan organisasi Anda, termasuk pengaturan yang dikelola server, harus dimuat terlebih dahulu dan Claude Code tidak dapat memuatnya. Misalnya:Claude Code can't start this session yet, dialog akan tertutup dan sesi dimulai segera setelah pengaturan dimuat.
Dalam mode non-interaktif dan dalam sesi latar belakang, Claude Code sebagai gantinya mencetak pesan dan keluar dengan status 1.
Yang perlu dilakukan:
could not connect, atauthe reply came from a network proxy, not Anthropic: periksa koneksi jaringan Anda, dan pada jaringan perusahaan minta tim IT untuk mengizinkan HTTPS keapi.anthropic.com/api/claude_code/policy_limitsdanapi.anthropic.com/api/claude_code/settings. Lalu pilih Retry now, atau jalankan perintah Anda lagi.timed out,Anthropic returned an error, atauAnthropic asked it to retry shortly: biarkan dialog mencoba ulang, atau jalankan perintah Anda lagi nanti. Periksa status.anthropic.com jika terus terjadi.still loading, ataucouldn't verify your sign-in with Anthropic yet: biarkan dialog mencoba ulang, atau jalankan perintah Anda lagi. Jika pesan masuk terus muncul kembali, masuk lagi dengan menjalankanclaude auth logindi shell Anda.Your Claude session has expired: status masuk yang tersimpan di mesin ini tidak lagi valid, sehingga mencoba ulang tidak akan membantu. Di dialog, pilih Sign in again untuk menutup Claude Code; lalu, di shell Anda, jalankanclaude auth login, yang tetap berfungsi meskipun sesi tidak dapat dimulai.none of the settings the server returned could be applied as written: minta admin Anda untuk memperbaiki pengaturan yang dikelola server organisasi, lalu coba lagi.
Managed settings were not approved
Pengaturan yang dikelola server organisasi Anda mencakup pengaturan yang memerlukan persetujuan Anda, dan Anda menolak dialog persetujuan keamanan, sehingga Claude Code keluar tanpa menerapkannya:- Mulai Claude Code lagi dan setujui dialog untuk melanjutkan dengan pengaturan organisasi Anda. Dialog yang ditolak tidak diingat, sehingga muncul lagi pada startup berikutnya.
- Jika Anda ragu tentang pengaturan yang tercantum di dialog, tanyakan kepada siapa pun yang memelihara pengaturan terkelola organisasi Anda sebelum menyetujuinya
Managed settings need your approval
Pengaturan yang dikelola server organisasi Anda mencakup pengaturan yang memerlukan persetujuan Anda di dialog persetujuan keamanan. Perintahclaude plugin yang Anda jalankan tidak dapat membaca dari keyboard, sehingga tidak dapat menampilkan dialog tersebut. Hal itu terjadi ketika Anda melakukan pipe atau redirect pada inputnya dan, di macOS dan Linux, perintah tersebut juga tidak dapat membuka /dev/tty. Perintah berhenti sebelum membuat perubahan apa pun:
- Jalankan
claudedi terminal dan setujui pengaturan ketika dialog muncul, lalu jalankan perintahclaude pluginyang sama lagi. Claude Code menyimpan persetujuan dan pengaturan yang disetujui di direktori konfigurasi Anda. Jika perintah yang berhenti dijalankan sebagai pengguna lain atau denganCLAUDE_CONFIG_DIRdiatur, jalankanclaudedengan cara yang sama agar keduanya menggunakan direktori yang sama.
Managed settings block the default model
Pengaturan terkelola organisasi Anda memblokir model yang di-resolve oleh opsi Default dan setiap model yang dapat menjadi turunannya. Sesi yang akan dimulai dengan opsi Default keluar saat startup alih-alih menjalankan model yang diblokir. Pesan yang Anda lihat bergantung pada pengaturan yang memblokirnya. Ketika daftardeniedModels memblokirnya, pesannya berbunyi:
availableModels dengan availableModelsMatch diatur ke "exact" tidak mencantumkannya, pesannya berbunyi:
- Jika Anda mengelola pengaturan tersebut, tambahkan model yang dapat dijalankan pengguna Anda ke
availableModels, atau persempit entrideniedModelsyang memblokir setiap fallback. Blokir model atau versi tertentu menjelaskan bagaimana opsi Default turun ke model lain - Jika Anda tidak mengelolanya, kirim pesan tersebut ke admin Anda. File pengaturan Anda sendiri tidak dapat memperluas daftar
availableModelsataudeniedModelsyang terkelola
Pengaturan terkelola tidak mengizinkan penyedia API ini
Pengaturan terkelola organisasi Anda menetapkan daftarallowedProviders, dan penyedia API sesi tidak ada di dalamnya atau sesi menggunakan endpoint yang tidak dipatok sesuai yang disyaratkan entri tersebut. Claude Code menolak saat startup, sebelum login, atau saat sesi berikutnya menghubungi API. Pesan dimulai dengan penyedia yang diizinkan:
(allowedProviders lists only unrecognized entries).
Yang perlu dilakukan:
- Ikuti langkah-langkah
To continue:dalam pesan - Jika Anda mengelola pengaturan tersebut, baris pesan yang diawali
Admins:menyebutkan entri yang harus ditambahkan atau nilai yang harus dipatok, dan entriallowedProvidersmenjelaskan blokenvdari sumber mana yang dapat mematoknya
MCP server is blocked by enterprise managed policy
Anda memilih Reconnect pada sebuah server di/mcp, atau mengaktifkan kembali server yang dinonaktifkan di sana, dan sebuah pengaturan yang membatasi server MCP memblokir server tersebut. Claude Code menolak untuk menghubungkannya dan menampilkan:
- Entri
deniedMcpServersyang cocok dengan server, termasuk yang ada di~/.claude/settings.jsonmilik Anda sendiri atau.claude/settings.jsonproyek - Daftar
allowedMcpServersyang tidak cocok dengan server strictPluginOnlyCustomizationdenganmcpdikunci, yang memblokir server yang dikonfigurasi di~/.claude.jsondan.mcp.jsondisableClaudeAiConnectors, ketika server adalah konektor claude.ai
- 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 pemblokiran tersebut, tanyakan kepada admin Anda pengaturan terkelola mana yang memblokir server
/mcp dapat menghubungkan server yang diblokir oleh pembaruan kebijakan di tengah sesi.
Nama server MCP dicadangkan
Pesan ini menyebut salah satu server MCP Anda, yang namanya termasuk dalam nama yang dicadangkan Claude Code, seperti nama server bawaannya:- Ganti nama server di tempat Anda mendefinisikannya, misalnya dari
workspacemenjadimy-workspace - Untuk nama lain yang dicadangkan dan harus dihindari, lihat Peringatan konfigurasi MCP
Managed settings document could not be parsed
Organisasi Anda men-deploy pengaturan terkelola, dan salah satu dokumen yang di-deploy ada tetapi tidak dapat di-parse sebagai objek JSON, sehingga Claude Code keluar dengan kode 1 saat startup alih-alih berjalan tanpa kebijakan yang dibawa dokumen tersebut. Baris menyebutkan sumber yang gagal sebelum pesan:- Path file
managed-settings.jsonatau file drop-in di bawahmanaged-settings.d - Profil preferensi terkelola macOS,
per-user managed preferencesataudevice-level managed preferences - Nilai registry Windows,
Registry: HKLM\SOFTWARE\Policies\ClaudeCode\Settings
claude -p, sesi Agent SDK, sesi latar belakang, dan sebagian besar subperintah, termasuk claude doctor. Penolakan ini sengaja dibuat gagal secara tertutup: pengaturan dalam dokumen yang tidak dapat di-parse Claude Code tidak dapat ditegakkan, dan tetap memulai akan menjalankan sesi tanpa kontrol organisasi.
Masalah skema dalam dokumen yang dapat di-parse tidak menghasilkan error ini. Temukan entri yang dihapus Claude Code menjelaskan apa yang dilakukan Claude Code terhadapnya.
Ketika direktori managed-settings.d/ ada tetapi tidak dapat dicantumkan isinya, Claude Code sebagai gantinya melaporkan Managed settings drop-in directory could not be read: diikuti oleh error yang mendasarinya. Temukan entri yang dihapus Claude Code menjelaskan kapan kegagalan baca menyebabkan keluar saat startup.
Yang perlu dilakukan:
- Jika Anda mengelola mesin tersebut, perbaiki dokumen yang disebutkan agar dapat di-parse sebagai objek JSON, atau hapus file, profil, atau nilai registry tersebut.
managed-settings.jsonyang kosong dihitung sebagai{}dan tidak memblokir peluncuran. - Jika tidak, minta admin Anda untuk memperbaiki dokumen yang di-deploy. Tidak ada apa pun dalam file pengaturan Anda sendiri yang menyebabkan atau menghilangkan error ini.
Unable to read managed policy settings
Organisasi Anda men-deploy pengaturan terkelola, dan salah satu sumber yang di-deploy ada tetapi tidak dapat dibaca, karena alasan seperti error I/O dan bukan karena sistem operasi menolak pembacaan. Jika tidak ada sumber admin lain yang menyediakan kebijakan, Claude Code keluar saat startup alih-alih berjalan tanpa kebijakan yang mungkin dibawa sumber tersebut:claude gateway ditolak dengan varian baris pertama yang menyebutkan allowedProviders.
Pembacaan yang ditolak oleh sistem operasi, seperti pada file yang hanya dapat diakses root, tidak menyebabkan keluar ini: sesi dimulai tanpa kebijakan dari sumber tersebut. Untuk sumber yang tidak dapat di-parse, Claude Code keluar dengan pesan berbeda yang menyebutkan sumbernya.
Yang perlu dilakukan:
- Jika Anda mengelola mesin tersebut, perbaiki masalah yang disebut baris
Detail:agar sumber yang di-deploy dapat dibaca, atau hapus sumber tersebut - Jika tidak, kirim pesan tersebut ke admin Anda. Tidak ada apa pun dalam file pengaturan Anda sendiri yang menyebabkan atau menghilangkan error ini
Managed settings contain invalid entries, including PreToolUse/PermissionRequest hooks that are NOT loaded
Blok stderr dari eksekusi-p ini berarti sebuah sumber pengaturan terkelola memuat entri hook yang tidak dapat dimuat Claude Code. Hook tersebut tidak berjalan, dan ketika sebuah baris mencantumkan field hooks sumber tersebut sebagai diabaikan, tidak ada hook dari sumber tersebut yang berjalan.
Setiap baris menyebutkan sumber, field jika ada, dan masalahnya, seperti type hook yang tidak dikenal atau hook yang dideklarasikan di luar key hooks:
- Jika Anda mengelola sumber tersebut, perbaiki atau hapus setiap entri yang dicantumkan blok. Konfigurasi hook menunjukkan bentuk yang diharapkan Claude Code di bawah
hooks. - Jika sumber sebuah baris adalah
parent managed settings, aplikasi yang meluncurkan Claude Code meneruskan entri tersebut sebagai pengaturan induk, jadi laporkan ke pengembang aplikasi tersebut - Jika tidak, kirim blok tersebut ke admin Anda
-p mencantumkan kasus ini di bawah header Managed settings failed to load; policies from the failed source are NOT in effect:.
otelHeadersHelper failed
Claude Code menampilkan peringatan ini sebagai notifikasi di antarmuka terminal, sekali per sesi interaktif, ketika skripotelHeadersHelper gagal atau mencetak output yang tidak memenuhi persyaratan skrip.
Selama skrip terus gagal, ekspor gagal dan backend telemetri Anda tidak menerima apa pun dari sesi tersebut.
Teks setelah See /status: menyebutkan apa yang gagal, seperti exit code skrip diikuti oleh output error-nya:
- Jalankan
/statusuntuk membaca detail kegagalan. - Perbaiki skrip agar keluar dengan 0 dalam 30 detik dan mencetak objek JSON berisi nilai header berupa string di stdout. Lihat persyaratan skrip.
- Jika organisasi Anda men-deploy skrip melalui pengaturan terkelola, minta siapa pun yang memeliharanya untuk memperbaikinya.
-p, kegagalan yang sama muncul di stderr sebagai otelHeadersHelper failed (OpenTelemetry export headers unavailable): <error>.
headersHelper not run
Claude Code menghubungkan server MCP hanya denganheaders statisnya dan melewati headersHelper server tersebut, karena helper adalah perintah shell dan folder tersebut tidak memiliki kepercayaan yang tersimpan. Sebuah folder mendapatkan kepercayaan yang tersimpan ketika Anda mengatur entrinya di ~/.claude.json secara manual atau, di luar direktori home Anda, ketika Anda menerima dialog kepercayaan untuknya dalam sesi interaktif. Lihat Percayai folder sebelum headersHelper-nya berjalan untuk server mana saja yang dikenai pemeriksaan ini.
Claude Code menulis baris ini hanya dalam mode non-interaktif, sekali per server. Dalam sesi interaktif, Claude Code menulis penolakan yang sama ke log debug.
projects yang dicetak pesan adalah folder yang menurut Aturan allow proyek dan kepercayaan workspace menjadi acuan kepercayaan Claude Code. Menerima dialog kepercayaan untuk folder induk tidak memenuhi pemeriksaan, begitu pula sesi -p atau SDK.
Yang perlu dilakukan:
- Jalankan
claudedi folder yang disebut pesan, terima dialog kepercayaan, lalu jalankan perintah-patau SDK Anda lagi - Atur sendiri entri
hasTrustDialogAccepteddi~/.claude.json, menggunakan keyprojectspersis seperti yang dicetak pesan - Jika Anda memulai sesi di direktori home Anda, bekerjalah dari direktori proyek yang telah Anda percayai. Ketika Anda menerima dialog kepercayaan di direktori home Anda, Claude Code mempertahankan kepercayaan tersebut hanya untuk sesi saat ini.
Malformed Tool(content) rule
Sebuah aturan izin di salah satu file pengaturan Anda tidak memiliki bentukTool atau Tool(content), misalnya karena ada teks setelah tanda kurung tutup atau salah satu tanda kurung hilang. Claude Code melewati aturan tersebut dan mencantumkannya di dialog pengaturan tidak valid ketika sesi interaktif dimulai, serta di output claude doctor:
- Di file pengaturan yang tercantum bersama pesan, tulis ulang aturan agar berakhir pada tanda kurung tutupnya, misalnya
Bash(ls *)sebagai penggantiBash(ls) x - Biarkan tanda kurung di dalam konten apa adanya. Tanda kurung tersebut bersifat literal, sehingga aturan seperti
Edit(./Finance (2024)/**)valid tanpa escape
Mismatched parentheses.
Matches no tool · check for typos
Baris di bawah banner startup ini menyebutkan aturan izin deny atau ask yang nama tool-nya tidak dikenali Claude Code, sehingga aturan tersebut tidak berlaku untuk tool yang Anda maksud. Aturan deny yang ditulis sebagaiBsh tidak diterapkan ke Bash, begitu pula aturan yang menggunakan label yang ditampilkan tool di transkrip alih-alih nama kanoniknya. Baris tersebut mengulang aturan sebagaimana Anda menuliskannya:
- Perbaiki nama tool dalam aturan, misalnya
Bashsebagai penggantiBsh. Cari nama kanonik di referensi tool. - Untuk menemukan tempat aturan didefinisikan, jalankan
/permissionsdi sesi dan pilih aturan tersebut. Detailnya menyebutkan asalnya, sepertiFrom project local settings, atauFrom CLI argumentuntuk nilai--disallowedTools. - Jika detailnya berbunyi
From enterprise managed settings, teruskan baris tersebut kepada siapa pun yang memelihara pengaturan terkelola Anda, karena Anda tidak dapat mengubah aturan tersebut sendiri.
--output-format json atau stream-json, Claude Code menulis peringatan ke log debug alih-alih stderr. Jalankan dengan --debug untuk merekamnya di ~/.claude/debug/<session-id>.txt.
Sebelum v2.1.305, sesi interaktif mencetak bentuk yang lebih panjang di stderr saat startup alih-alih menampilkan baris tersebut.
Is not matched by file permission checks
Claude Code menemukan aturan izinWrite, NotebookEdit, MultiEdit, atau Glob dengan path di salah satu file pengaturan Anda, di pengaturan terkelola, atau di nilai flag --allowedTools, --disallowedTools, atau --settings. Claude Code memeriksa izin file hanya terhadap aturan Edit dan Read, sehingga tidak pernah merujuk aturan path yang menyebutkan salah satu tool file lainnya. Claude Code mempertahankan aturan tersebut dan tidak mengubah apa pun lainnya.
-
Sesi interaktif: peringatan lengkap masuk ke log debug, dan aturan deny atau ask dengan bentuk ini juga ditampilkan sebagai baris ini di bawah banner startup:
Aturan allow dengan bentuk ini tidak mendapatkan baris. Untuk menemukan tempat aturan didefinisikan, jalankan
/permissionsdi sesi dan pilih aturan tersebut. -
Mode non-interaktif dengan output teks: peringatan lengkap di stderr menyebutkan aturan, sumbernya dalam tanda kurung, dan pengganti yang harus ditulis:
-
Sesi latar belakang, atau
--output-format jsonataustream-json: peringatan lengkap masuk ke log debug alih-alih stderr, sehingga output yang dibaca mesin tetap bersih. Jalankan dengan--debuguntuk merekamnya di~/.claude/debug/<session-id>.txt.
- Ganti aturan
Write(path),NotebookEdit(path), danMultiEdit(path)lama denganEdit(path). AturanEditmencakup semua tool pengeditan file. - Kecuali di
--allowedTools, tempat Claude Code menerima aturanGlobtanpa peringatan, ganti aturanGlob(path)denganRead(path). - Perbaiki aturan di sumbernya, yang disebutkan peringatan lengkap dalam tanda kurung: path file pengaturan, atau flag itu sendiri untuk
--allowed-toolsdan--disallowed-tools. Pathclaude-settings-<hash>.jsonyang tidak ada di disk mewakili nilai--settingsinline. Perbaiki JSON yang Anda teruskan ke flag tersebut. - Biarkan aturan berupa nama tool saja seperti
WriteatauGlob. Claude Code mencocokkannya di tingkat tool dan tidak memberi peringatan tentangnya. - Untuk aturan dari pengaturan terkelola, tanda kurung pada peringatan lengkap berbunyi
managed policy settingsdan detail aturan di/permissionsberbunyiFrom enterprise managed settings. Teruskan peringatan tersebut kepada siapa pun yang memelihara pengaturan terkelola Anda, karena Anda tidak dapat menghilangkannya sendiri.
Has a wildcard before the rest of the command
Claude Code menemukan aturan allowBash yang *-nya muncul sebelum kata berikutnya yang menentukan perintah apa itu, seperti Bash(git * main) atau Bash(git -C * status *), di salah satu file pengaturan Anda, di pengaturan terkelola, atau di nilai flag --allowedTools atau --settings. * cocok dengan teks apa pun, termasuk opsi yang disisipkan di posisi tersebut: Bash(git * main) juga menyetujui git -c core.fsmonitor=<script> diff main, di mana -c membuat git menjalankan program yang disebutkan perintah. Pola wildcard menunjukkan aturan pencocokannya.
Peringatan ini ada agar Anda dapat mempersempit aturan yang wildcard-nya lebih luas dari yang Anda maksudkan. Claude Code mempertahankan aturan tersebut dan tidak mengubah apa pun tentang cara pencocokannya. Dalam mode non-interaktif dengan output teks, peringatan di stderr menyebutkan aturan dan sumbernya dalam tanda kurung:
/permissions di sesi dan pilih aturan tersebut.
Yang perlu dilakukan:
- Ganti
*sebelum subperintah dengan nilai persis yang Anda maksud:Bash(git checkout main)sebagai penggantiBash(git * main). - Pindahkan setiap
*ke setelah subperintah:Bash(git status *)sebagai penggantiBash(git -C * status *). Tulis satu aturan per subperintah yang ingin Anda izinkan. - Perbaiki aturan di sumbernya, yang disebutkan peringatan lengkap dalam tanda kurung: path file pengaturan, atau flag
--allowed-toolsitu sendiri. Pathclaude-settings-<hash>.jsonyang tidak ada di disk mewakili nilai--settingsinline. Perbaiki JSON yang Anda teruskan ke flag tersebut. - Untuk aturan dari pengaturan terkelola, tanda kurung pada peringatan lengkap berbunyi
managed policy settingsdan detail aturan di/permissionsberbunyiFrom enterprise managed settings. Teruskan peringatan tersebut kepada siapa pun yang memelihara pengaturan terkelola Anda, karena Anda tidak dapat menghilangkannya sendiri.
--output-format json atau stream-json, Claude Code menulis peringatan ke log debug alih-alih stderr, sehingga output yang dibaca mesin tetap bersih. Jalankan dengan --debug untuk merekamnya di ~/.claude/debug/<session-id>.txt. Sebelum v2.1.246, Claude Code menerima aturan-aturan ini tanpa peringatan.
Sebelum v2.1.305, sesi interaktif mencetak peringatan lengkap di stderr alih-alih menampilkan baris.
Denying Bash also turns off the PowerShell tool
Anda menghapus seluruh tool Bash, misalnya dengan--disallowedTools Bash atau dengan aturan deny Bash atau Bash(*) polos di salah satu file pengaturan Anda. Di Windows dengan Git Bash terpasang, menolak Bash juga mematikan tool PowerShell, sehingga sesi dimulai tanpa tool shell.
Dalam mode non-interaktif dengan output teks, Claude Code mencetak peringatan ini di stderr saat startup, dan sesi interaktif menulisnya hanya ke log debug:
- Agar Claude menggunakan PowerShell, atur
CLAUDE_CODE_USE_POWERSHELL_TOOLke1di environment Anda atau di blokenvsebuah file pengaturan, seperti yang ditunjukkan Aktifkan tool PowerShell. Tool PowerShell kemudian tetap aktif berdampingan dengan aturan deny Bash Anda. - Untuk memblokir perintah tertentu alih-alih seluruh tool, ganti entri
Bashpolos dengan aturan yang dibatasi sepertiBash(git push *)di file pengaturan atau flag yang sama. Claude tetap memiliki tool Bash, dan tool PowerShell tetap mati sampai Anda juga mengatur variabel tersebut atau menambahkan aturan izinPowerShellyang dibatasi.
--output-format json atau stream-json, Claude Code menulis peringatan ke log debug alih-alih stderr. Jalankan dengan --debug untuk merekamnya di ~/.claude/debug/<session-id>.txt. Sebelum v2.1.287, Claude Code mematikan tool PowerShell dengan cara yang sama tanpa mencetak peringatan.
Sebelum v2.1.305, sesi interaktif juga mencetak peringatan di stderr saat startup.
crossSessionInbound must be one of accept, hold, refuse
Sebuah file pengaturan mengaturcrossSessionInbound ke nilai yang tidak dikenali Claude Code, seperti salah ketik "reject". Kalimat kedua peringatan bergantung pada file mana yang memuat nilai tersebut; di file pengguna, proyek, lokal, atau --settings, bunyinya:
refuse, nilai paling ketat, dan peringatan menyatakan pesan lintas sesi ditolak sampai admin memperbaikinya. Untuk cara penahanan ini digabungkan dengan nilai di file pengaturan Anda lainnya, lihat crossSessionInbound.
Yang perlu dilakukan:
- Atur key ke
"accept","hold", atau"refuse", atau hapus - Ketika peringatan menyebut pengaturan terkelola, minta admin untuk memperbaiki nilainya
ANTHROPIC_FOUNDRY_RESOURCE must be a Foundry resource name
Anda mengaturANTHROPIC_FOUNDRY_RESOURCE ke sesuatu selain nama resource Microsoft Foundry saja, seperti URL endpoint atau nama host-nya. Claude Code menolak nilai tersebut sebelum mengirim permintaan. Pesan muncul di tempat balasan Claude, bukan sebagai peringatan startup:
- Atur
ANTHROPIC_FOUNDRY_RESOURCEke nama resource saja dan mulai ulang Claude Code. Untuk endpointhttps://my-resource.services.ai.azure.com/anthropic, namanya adalahmy-resource. - Untuk memberikan URL endpoint lengkap sebagai gantinya, atur
ANTHROPIC_FOUNDRY_BASE_URLke URL tersebut dan hapusANTHROPIC_FOUNDRY_RESOURCE, lalu mulai ulang Claude Code. Claude Code hanya menerima salah satu dari kedua variabel tersebut.
The 200K limit isn’t enforced
Anda mengaturCLAUDE_CODE_DISABLE_1M_CONTEXT=1, yang biasanya membuat auto-compaction membatasi sesi pada model dengan konteks 1M ke jendela 200K, tetapi tidak ada ambang compaction yang membatasi sesi ini pada atau di bawah 200K, sehingga percakapan dapat tumbuh melampauinya.
- ID model bukan yang dikenali Claude Code, seperti alias LLM gateway, dan Anda mengatur
CLAUDE_CODE_DISABLE_UNKNOWN_MODEL_WINDOW_ENFORCEMENT=1atau menaikkan jendela yang diasumsikan melampaui 200K denganCLAUDE_CODE_MAX_CONTEXT_TOKENS. Dalam kasus ini, pesan juga menawarkanor update to a Claude Code version that recognizes <model>sebagai solusi. - Beta
context-1myang diminta melaluiANTHROPIC_BETASatau flag--betastetap meminta jendela 1M dari API pada model yang menerima beta tersebut, sementara tidak ada yang melakukan compaction pada sesi di 200K
- Atur
CLAUDE_CODE_AUTO_COMPACT_WINDOW=200000, atau pengaturanautoCompactWindowke200000, agar auto-compaction melakukan compaction pada batas 200K - Jika pesan menyebut ID model yang tidak dikenali versi ini, jalankan
claude update. Versi yang mengenali ID tersebut sebagai model dengan konteks 1M menegakkan batas tanpa konfigurasi tambahan. - Jika Anda ingin sesi menggunakan jendela penuh model, hapus pengaturan
CLAUDE_CODE_DISABLE_1M_CONTEXT; peringatan hanya melaporkan bahwa batas 200K tidak ditegakkan
--output-format json atau stream-json, peringatan masuk ke log debug. Jalankan dengan --debug untuk merekamnya di ~/.claude/debug/<session-id>.txt.
Sebelum v2.1.305, sesi interaktif mencetak peringatan di stderr saat startup.
ID model tidak dikenali pada permintaan
Claude Code mengirim permintaan untuk ID model yang tidak dikenali oleh versi Claude Code Anda, dan tidak menemukan entrimodelOverrides yang memetakan ID tersebut ke model yang dikenalinya. Claude Code tetap mengirim permintaan dengan ID sebagaimana Anda konfigurasikan, dan tidak keluar atau berganti model.
[claude-code:unrecognized_model]. Setelah prefiks dan satu spasi, Claude Code menulis objek JSON satu baris. Claude Code dapat menambahkan field ke objek tersebut di versi mendatang, jadi abaikan field apa pun yang tidak Anda harapkan. Claude Code menulis setidaknya dua field berikut:
model: string model sebagaimana Anda konfigurasikanquery_source: jalur permintaan yang menggunakan model. Misalnya, nilainya adalahsdkuntuk percakapan utama eksekusi-pdan diawali denganagent:untuk subagent.
- Dalam mode non-interaktif dengan
-p, Claude Code menulisnya ke stderr di setiap--output-format, sehingga Anda dapat mem-parse stdout tanpa menyaring baris tersebut - Dalam sesi interaktif atau sesi latar belakang, Claude Code menulisnya ke log debug; jalankan dengan
--debuguntuk merekamnya di~/.claude/debug/<session-id>.txt
us.anthropic.claude-..., ID Agent Platform Google Cloud dengan sufiks versi @, dan nama deployment Microsoft Foundry yang berisi ID model Claude. Claude Code memeriksa model di balik ARN application inference profile Amazon Bedrock, bukan ARN itu sendiri. Claude Code tidak menulis baris untuk ARN yang tidak dapat di-resolve-nya, seperti ARN yang salah ketik.
Yang perlu dilakukan:
-
Jika Anda mengatur ID tersebut dengan sengaja, seperti alias LLM gateway, tambahkan entri
modelOverrideske file pengaturan Anda dengan ID tersebut sebagai nilainya. Gunakan ID model Anthropic sebagai key, bukan alias keluarga sepertiopus. Untukmy-proxy-modeldari contoh baris, tambahkan entri ini:Claude Code kemudian memperlakukanmy-proxy-modelsebagaiclaude-opus-4-6dan berhenti menulis baris tersebut. -
Jika ID menyebut model yang lebih baru dari versi Claude Code Anda, jalankan
claude update -
Jika ID salah ketik, perbaiki di mana pun ID tersebut berada di antara tempat Anda dapat mengatur model atau variabel alias. Jika
query_sourcediawali denganagent:, perbaiki di tempat Anda mengatur model subagent.
Entri allow sandbox diabaikan di bawah kunci terkelola
Peringatan di/status dan claude doctor ini berarti pengaturan terkelola mengatur allowManagedReadPathsOnly atau allowManagedDomainsOnly, sehingga entri allowRead atau allowedDomains di file yang disebutkannya tidak berlaku:
sandbox.network.allowedDomains dan allowManagedDomainsOnly, dan menyatakan only allowed domains (and WebFetch domain rules) from managed settings are honored.
Yang perlu dilakukan:
- Anda tidak perlu menindaklanjuti peringatan ini
- Jika Anda memerlukan path atau domain tersebut dan pengaturan terkelola organisasi Anda mengatur kunci tersebut, minta admin Anda untuk menambahkannya ke pengaturan tersebut. Peringatan tetap ada sampai Anda juga menghapus entri dari file yang disebutkan.
- Untuk menghilangkan peringatan, hapus entri dari file yang disebutkan. Untuk file yang Anda bagikan, seperti
.claude/settings.jsonproyek, Anda dapat membiarkan entri tersebut untuk rekan tim tanpa kunci dan membiarkan peringatan tetap tampil.
Sandbox mask files left behind at write-deny paths
Peringatan diclaude doctor dan /status ini mencantumkan file mask: file placeholder read-only berukuran 0 byte di path yang ditolak penulisannya oleh sandbox. Peringatan ini muncul di Linux dan WSL2 ketika sandboxing diaktifkan dengan isolasi filesystem menyala. Hapus file-file tersebut dari shell Anda setelah tidak ada sesi Claude Code yang terbuka di proyek yang memuatnya.
Sandbox membuat placeholder saat perintah yang di-sandbox berjalan dan menghapusnya ketika perintah berakhir. Placeholder tertinggal dalam kasus seperti berikut:
- Sesi dihentikan paksa sebelum perintah berakhir, misalnya oleh SIGKILL
- Anda keluar dari sesi saat perintah yang di-sandbox masih berjalan, seperti perintah di latar belakang
claude doctor, peringatan berbunyi:
- Keluar dari setiap sesi Claude Code yang terbuka di proyek yang memuat file yang tercantum, termasuk sesi mana pun tempat
/statusmenampilkan peringatan, lalu bekerjalah dari shell Anda. Placeholder yang masih digunakan oleh sandbox sesi lain adalah bagian aktif dari perlindungan penulisan sesi tersebut - Di shell Anda, hapus setiap file yang tercantum dengan
rm, dan konfirmasi jikarmbertanya tentang file yang dilindungi dari penulisan. Peringatan menyebutkan hingga tiga file dan menghitung sisanya, jadi jalankanclaude doctorlagi setelah menghapus sampai peringatan tidak lagi muncul - Jika pilihan izin yang Anda simpan dengan “Yes, and don’t ask again” tidak tersimpan, simpan lagi setelah menghapus placeholder
Stale sandbox mask files left by a killed session.
Sebelum v2.1.257, claude doctor tidak menandai file-file ini; versi sebelumnya meninggalkan placeholder yang sama ketika sesi dihentikan paksa.
Two Claude Code config files exist
Claude Code menggunakan file pertama yang disebutkan pesan ini, sehingga isi file kedua tidak berlaku. File pertama adalah.config.json, nama lama untuk .claude.json. Pesan menyertakan pemeriksaan untuk mengetahui file mana yang memuat setup Anda:
The one with hasCompletedOnboarding or mcpServers in it is usually yours. menggantikan kalimat yang berisi perintah grep.
Yang perlu dilakukan:
1
Temukan file yang memuat setup Anda
- Di Windows: buka kedua file dan lihat mana yang berisi
hasCompletedOnboardingataumcpServers - Di platform lain: di shell Anda, jalankan perintah
grepdari pesan dan lihat file mana yang memiliki hitungan lebih tinggi
2
Perbarui setiap host yang berbagi direktori home
Jika beberapa host berbagi direktori home ini, terlebih dahulu perbarui Claude Code di setiap host ke versi yang disebut pesan atau yang lebih baru.
3
Hentikan Claude Code
Hentikan proses Claude Code Anda di setiap host.
4
Pindahkan file yang tidak Anda inginkan
Pindahkan file yang tidak Anda inginkan keluar dari foldernya. Pindahkan alih-alih menghapusnya, agar Anda dapat mengembalikannya.
5
Tunggu sebelum Anda memulai Claude Code lagi
Jangan memulai Claude Code di host mana pun sampai tidak ada host yang masih mencantumkan file yang dipindahkan di path lamanya.
Make this change again later: ~/.claude.json could not be updated
Pemberitahuan di stderr ini berarti perubahan pada~/.claude.json, seperti proses masuk atau jawaban atas permintaan kepercayaan, tidak disimpan ke file:
- Lakukan perubahan tersebut lagi di sesi berikutnya. Misalnya, jalankan
/loginlagi atau jawab permintaan kepercayaan lagi.
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 kasus-kasus berikut:--fallback-modelyang 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, atau akun Anda kehilangan akses ke sana di tengah sesi
- Fallback model otomatis pada model Fable, Opus 5.5, Sonnet 5.5, dan Opus 5 memindahkan sesi ke model fallback kategori yang ditandai, ketika kategori itu memiliki satu. Pemberitahuan muncul dalam transkrip
/model. Model configuration menjelaskan kapan setiap fallback berlaku.
Periksa ini terlebih dahulu:
- Model selection: jalankan
/modeluntuk mengonfirmasi Anda berada di model yang Anda harapkan. Pilihan/modelsebelumnya atau variabel lingkunganANTHROPIC_MODELmungkin membuat Anda berada di model yang lebih kecil dari yang Anda maksudkan. - Effort level: jalankan
/effortuntuk 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 pintasanultrathink. - Context pressure: jalankan
/contextuntuk melihat seberapa penuh jendela itu. Jika mendekati kapasitas, jalankan/compactpada titik alami atau/clearuntuk memulai segar. Lihat Explore the context window untuk bagaimana auto-compact mempengaruhi giliran sebelumnya. - Stale instructions: file
CLAUDE.mdyang besar atau ketinggalan zaman dan definisi alat MCP mengonsumsi konteks dan dapat mengarahkan respons. Pemeriksaan/doctormenandai file memori yang berukuran besar dan ekstensi yang tidak digunakan, dan/contextmenampilkan penggunaan token alat MCP. Sebelum v2.1.205,/doctormembuka layar diagnostik yang menandai file memori yang berukuran besar dan definisi subagent.
/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
- Jalankan
/feedbackdi 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,/feedbackmenyimpan arsip lokal yang dapat Anda kirimkan ke perwakilan akun Anthropic Anda. - Jika
/feedbackmenjawab bahwa perintah tersebut dinonaktifkan oleh kebijakan organisasi Anda, lihat entri untuk pesan tersebut - Jalankan
claude doctordari shell Anda untuk diagnostik sistem file read-only dari instalasi Anda, atau jalankan pemeriksaan/doctordi dalam Claude Code untuk menemukan dan memperbaiki masalah pengaturan - Periksa status.claude.com untuk insiden aktif
- Cari existing issues di GitHub