SpyBara
Go Premium

errors.md 2026-07-09 23:58 UTC to 2026-07-10 17:00 UTC

417 added, 197 removed.

2026
Sat 11 19:03 Fri 10 17:00 Thu 9 23:58 Wed 8 16:02 Tue 7 16:02 Mon 6 23:57 Sat 4 03:01 Fri 3 23:00 Thu 2 23:59 Wed 1 21:01

Referensi kesalahan

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

Halaman ini mencantumkan kesalahan runtime yang ditampilkan Claude Code dan cara memulihkan dari masing-masing, ditambah apa yang harus diperiksa ketika respons tampak tidak normal tanpa kesalahan. Untuk kesalahan instalasi seperti command not found atau kegagalan TLS selama penyiapan, lihat Troubleshoot installation and login.

Kesalahan dan perintah pemulihan ini berlaku di seluruh CLI, aplikasi Desktop, dan Claude Code di web, karena ketiganya membungkus CLI Claude Code yang sama. Untuk masalah khusus permukaan, lihat bagian troubleshooting di halaman permukaan tersebut.

Temukan kesalahan Anda

Cocokkan pesan yang Anda lihat di terminal dengan bagian di bawah ini.

Pesan Bagian
API Error: 500 Internal server error Kesalahan server
API Error: Repeated 529 Overloaded errors Kesalahan server
Request timed out Kesalahan server, atau Jaringan jika pesan menyebutkan koneksi internet Anda
Server error mid-response. The response above may be incomplete. Kesalahan server
Connection closed mid-response / Response stalled mid-stream Kesalahan server
<model> is temporarily unavailable, so auto mode cannot determine the safety of... Kesalahan server
Auto mode could not evaluate this action and is blocking it for safety Kesalahan server
Auto mode classifier transcript exceeded context window Kesalahan server
Agent terminated early due to an API error Kesalahan server
You've hit your session limit / You've hit your weekly limit Batas penggunaan
Usage credits required for 1M context Batas penggunaan
Server is temporarily limiting requests Batas penggunaan
Request rejected (429) Batas penggunaan
Credit balance is too low Batas penggunaan
Not logged in · Please run /login Autentikasi
Could not resolve authentication method Autentikasi
Invalid API key Autentikasi
This organization has been disabled Autentikasi
Your organization has disabled API key authentication Autentikasi
Your organization has disabled Claude subscription access Autentikasi
Routines are disabled by your organization's policy Autentikasi
Remote Control is only available when using Claude via api.anthropic.com Autentikasi
OAuth token revoked / OAuth token has expired Autentikasi
does not meet scope requirement user:profile Autentikasi
AWS credentials expired or invalid Autentikasi
AWS authentication failed Autentikasi
Unable to connect to API Jaringan
Waiting for API response · will retry in Percobaan ulang otomatis, atau Jaringan jika terus berlanjut
SSL certificate verification failed Jaringan
SSL certificate error (...) during login or startup Jaringan
403 with x-deny-reason: host_not_allowed in a cloud or routine session Jaringan
Couldn't reconnect to your Remote Control session Jaringan
Prompt is too long Kesalahan permintaan
Error during compaction: Conversation too long Kesalahan permintaan
Request too large Kesalahan permintaan
Image was too large Kesalahan permintaan
Unable to resize image Kesalahan permintaan
PDF too large / PDF is password protected Kesalahan permintaan
Extra inputs are not permitted Kesalahan permintaan
There's an issue with the selected model Kesalahan permintaan
Model ... is not a recognized model id Kesalahan permintaan
Claude Opus is not available with the Claude Pro plan Kesalahan permintaan
Model ... is restricted by your organization's settings Kesalahan permintaan
thinking.type.enabled is not supported for this model Kesalahan permintaan
max_tokens must be greater than thinking.budget_tokens Kesalahan permintaan
API Error: 400 due to tool use concurrency issues Kesalahan permintaan
Claude Code is unable to respond to this request, which appears to violate our Usage Policy Kesalahan permintaan
<model> has safety measures that flagged this message for a cybersecurity topic Kesalahan permintaan
Installation was killed before it could finish (exit code 137) Kesalahan instalasi
The connection dropped while downloading the update Kesalahan instalasi
Download timed out: exceeded the total deadline Kesalahan instalasi
--bg and --print conflict Kesalahan baris perintah
Error: --json-schema is not a valid JSON Schema Kesalahan baris perintah
Could not import <server>: <reason> Kesalahan baris perintah
Marketplace "<name>" is registered from an untrusted source Kesalahan plugin
Ignoring N permissions.allow entries from ... this workspace has not been trusted Peringatan konfigurasi
Responses seem lower quality than usual Kualitas respons

Percobaan ulang otomatis

Claude Code mencoba ulang kegagalan transien sebelum menampilkan kesalahan kepada Anda. Kesalahan server, respons kelebihan beban, waktu tunggu permintaan, throttle 429 sementara, dan koneksi yang terputus semuanya dicoba ulang hingga 10 kali dengan backoff eksponensial. {/* min-version: 2.1.198 /}Mulai dari v2.1.198, ini mencakup koneksi yang terputus di tengah respons sebelum output yang terlihat telah dialirkan: Claude Code mengeluarkan kembali permintaan dengan backoff yang sama dan giliran berlanjut daripada berhenti dengan kesalahan koneksi. {/ min-version: 2.1.199 */}Mulai dari v2.1.199, throttle 429 sementara yang tidak membawa header kuota paket Anda juga dicoba ulang ketika Anda masuk dengan langganan claude.ai; versi sebelumnya hanya mencoba ulang untuk autentikasi kunci API dan Enterprise.

Dua kelas kegagalan tidak dicoba ulang, karena percobaan ulang tidak dapat berhasil:

  • {/* min-version: 2.1.199 */}Mulai dari v2.1.199, kegagalan validasi sertifikat TLS, seperti proxy yang menginspeksi TLS, bundel NODE_EXTRA_CA_CERTS yang hilang, atau sertifikat yang kedaluwarsa, gagal pada percobaan pertama sehingga perbaikan muncul segera daripada setelah anggaran percobaan ulang penuh. Lihat Kesalahan sertifikat SSL. Kondisi TLS transien seperti timeout handshake masih mencoba ulang.
  • {/* min-version: 2.1.199 */}Mulai dari v2.1.199, kesalahan server yang tiba setelah Claude telah dialirkan output yang terlihat menjaga respons parsial dan menambahkan pemberitahuan respons tidak lengkap daripada mencoba ulang, karena menjalankan kembali permintaan dapat menjalankan panggilan alat yang sama dua kali. Versi sebelumnya membuang output parsial dan melaporkan giliran sebagai kesalahan.

Saat mencoba ulang, spinner menampilkan hitungan mundur Retrying in Ns · attempt x/y setelah label kesalahan. Label menyebutkan alasan spesifik dari percobaan pertama untuk kegagalan yang dapat Anda tindaklanjuti segera: jaringan tidak aktif, handshake TLS gagal, atau Anda mencapai batas laju. Untuk kesalahan lainnya, itu berbunyi API error pada awalnya. {/* min-version: 2.1.198 */}Mulai dari v2.1.198, itu beralih ke alasan spesifik dari percobaan ketiga, atau pada percobaan terakhir ketika CLAUDE_CODE_MAX_RETRIES memungkinkan lebih sedikit dari tiga; versi sebelumnya hanya beralih pada percobaan terakhir.

{/* min-version: 2.1.198 */}Mulai dari v2.1.198, tip spinner biasa ditekan selama percobaan ulang. Setelah alasan kesalahan terungkap, jika kegagalan adalah kelebihan beban 529, baris di bawah hitungan mundur juga menyebutkan di mana memeriksa status layanan: status.claude.com di API Anthropic, atau host penyedia atau gateway yang disebutkan dalam pesan pada konfigurasi lain.

{/* min-version: 2.1.185 */}Jika tidak ada data yang tiba di aliran respons selama 20 detik sementara permintaan masih tertunda, spinner menampilkan Waiting for API response · will retry in … · check your network sebelum percobaan ulang apa pun dimulai. Permintaan belum gagal: hitungan mundur berjalan ke titik di mana Claude Code membatalkan koneksi yang macet dan mencoba ulang, sehingga banner hilang dengan sendirinya setelah data dilanjutkan atau percobaan ulang berhasil. Mulai dari v2.1.185 ambang batasnya adalah 20 detik; versi sebelumnya menampilkan banner setelah 10 detik dengan wording yang berbeda. Jika muncul kembali pada setiap percobaan, perlakukan sebagai masalah jaringan.

Ketika Anda melihat salah satu kesalahan di halaman ini, percobaan ulang tersebut telah habis, kecuali jika itu termasuk kelas yang tidak dicoba ulang, seperti kegagalan validasi sertifikat. Anda dapat menyesuaikan perilaku dengan variabel lingkungan ini:

Variabel Default Efek
CLAUDE_CODE_MAX_RETRIES 10 Jumlah percobaan ulang. {/* min-version: 2.1.186 /}Dibatasi pada 15 mulai dari v2.1.186; {/ min-version: 2.1.199 */}mulai dari v2.1.199 CLAUDE_CODE_RETRY_WATCHDOG menaikkan default dan menghapus batas. Turunkan untuk menampilkan kegagalan lebih cepat dalam skrip.
CLAUDE_CODE_RETRY_WATCHDOG unset Atur ke 1 dalam sesi tanpa pengawasan seperti pekerjaan CI untuk mencoba ulang kesalahan kapasitas 429 dan 529 tanpa batas daripada gagal setelah percobaan CLAUDE_CODE_MAX_RETRIES. {/* min-version: 2.1.199 */}Mulai dari v2.1.199, itu juga menaikkan jumlah percobaan ulang default untuk kesalahan transien lainnya, seperti kesalahan server, timeout, dan koneksi yang terputus, menjadi 300, kira-kira tiga jam backoff, dan menghapus batas 15 pada CLAUDE_CODE_MAX_RETRIES jika Anda menetapkan variabel itu secara eksplisit.
API_TIMEOUT_MS 600000 Waktu tunggu per permintaan dalam milidetik. Naikkan untuk jaringan lambat atau proxy.

Kesalahan server

Kesalahan ini berasal dari penyedia inferensi daripada akun atau permintaan Anda. Pada Anthropic API itu berarti infrastruktur Anthropic. Pada Amazon Bedrock, Agent Platform Google Cloud, Microsoft Foundry, atau gateway khusus itu berarti infrastruktur penyedia tersebut.

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 pada Anthropic API:

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

Kalimat terakhir menyebutkan tempat untuk memeriksa kesehatan layanan dan bervariasi menurut penyedia. Konfigurasi Amazon Bedrock, Agent Platform Google Cloud, dan Microsoft Foundry menyebutkan status layanan penyedia tersebut. ANTHROPIC_BASE_URL khusus menyebutkan host gateway.

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

Yang harus dilakukan:

  • Periksa status.claude.com, atau halaman status penyedia yang disebutkan dalam pesan, untuk insiden aktif
  • Tunggu satu menit, kemudian kirim pesan Anda lagi. Pesan asli Anda masih ada dalam percakapan, jadi untuk prompt yang panjang Anda dapat mengetik try again daripada menempel seluruh hal tersebut.
  • Jika kesalahan berlanjut tanpa ada insiden yang diposting, jalankan /feedback sehingga Anthropic dapat menyelidiki dengan detail permintaan Anda. Lihat Report an error jika /feedback tidak tersedia di lingkungan Anda.

API Error: Repeated 529 Overloaded errors

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

API Error: Repeated 529 Overloaded errors. The API is at capacity — this is usually temporary. Try again in a moment. If it persists, check https://status.claude.com.

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

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

Yang harus dilakukan:

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

Request timed out

API tidak merespons sebelum batas waktu koneksi.

Request timed out

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

Yang harus dilakukan:

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

The response above may be incomplete

Respons streaming gagal setelah Claude telah menghasilkan output yang terlihat. Mengirim ulang permintaan dapat menjalankan panggilan alat yang sama dua kali, jadi Claude Code menyimpan apa yang sudah streaming dan menambahkan pemberitahuan ini sebagai gantinya dari membuang giliran. Varian mana yang Anda lihat menyebutkan penyebabnya:

API Error: Server error mid-response. The response above may be incomplete.
API Error: Connection closed mid-response. The response above may be incomplete.
API Error: Response stalled mid-stream. The response above may be incomplete.
  • {/* min-version: 2.1.199 */}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 closed mid-response: koneksi terputus.
  • Response stalled mid-stream: aliran berhenti mengirim data.

Yang harus dilakukan:

  • Baca respons yang streaming. Tidak ada yang hilang, tetapi kalimat atau panggilan alat terakhir mungkin hilang.
  • Balas dengan continue untuk membuat Claude melanjutkan dari tempat ia berhenti
  • Jika kesalahan yang sama muncul sebelum output yang terlihat, Claude Code mencoba ulang permintaan daripada menyelesaikannya. Lihat Automatic retries.

Auto mode cannot determine the safety of an action

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

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

Ketika model pengklasifikasi kelebihan beban:

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

Yang harus dilakukan:

  • Coba ulang setelah beberapa detik; Claude melihat pesan yang sama dan biasanya mencoba ulang sendiri
  • Jika percobaan ulang terus gagal, lanjutkan dengan tugas baca-saja dan kembali ke tindakan yang diblokir nanti
  • Ini bersifat sementara dan tidak terkait dengan auto mode eligibility; Anda tidak perlu mengubah pengaturan

Ketika pengklasifikasi mengembalikan respons yang tidak dapat diuraikan:

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

Yang harus dilakukan:

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

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

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

Yang harus dilakukan:

  • Ini bukan keputusan tentang tindakan Anda. Konten yang sudah ada dalam percakapan Anda memicu filter keamanan pada API ketika auto mode mengirim percakapan ke pengklasifikasi
  • Mencoba ulang tidak akan membantu; konten percakapan yang sama akan memicu filter lagi
  • Beralih ke permission mode yang berbeda sehingga Anda dapat menyetujui tindakan ketika diminta, atau mulai percakapan baru tanpa konten pemicu

Ketika percakapan telah tumbuh lebih besar dari jendela konteks pengklasifikasi:

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

Dalam sesi interaktif, auto mode kembali ke prompt izin normal untuk tindakan itu sehingga Anda dapat menyetujui atau menolaknya secara manual. Dalam non-interactive mode jalankan dibatalkan karena transkrip hanya tumbuh dan mencoba ulang tidak dapat berhasil.

Yang harus dilakukan:

  • Setujui atau tolak tindakan dalam prompt yang muncul
  • Jalankan /compact untuk mengurangi ukuran percakapan sehingga tindakan berikutnya sesuai dengan jendela pengklasifikasi lagi

Agent terminated early due to an API error

{/* min-version: 2.1.199 */}Permintaan API subagent gagal secara terminal, misalnya karena batas penggunaan tercapai atau percobaan ulang untuk kesalahan server habis, jadi subagent berhenti sebelum menyelesaikan tugasnya. Pesan ini memerlukan Claude Code v2.1.199 atau lebih baru; sebelumnya teks kesalahan API dikembalikan ke Claude seolah-olah itu adalah hasil subagent.

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

Yang harus dilakukan:

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

Ketika batas laju, overload, atau kesalahan server mengganggu subagent latar depan yang sudah menghasilkan output teks, Claude menerima output parsial itu ditandai sebagai tidak lengkap daripada kesalahan ini. {/* min-version: 2.1.200 */}Subagent yang satu-satunya output adalah panggilan alat juga mendapatkan kesalahan ini; dalam v2.1.199 bentuk itu mengembalikan hasil parsial kosong sebagai gantinya. Lihat API errors in subagents.

Batas penggunaan

Kesalahan ini berarti kuota yang terikat pada akun atau paket Anda telah tercapai. Kesalahan ini berbeda dari kesalahan server, yang mempengaruhi semua orang.

Anda telah mencapai batas sesi

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

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

Claude Code memblokir permintaan lebih lanjut hingga waktu reset yang ditunjukkan dalam pesan.

Yang harus dilakukan:

  • Tunggu waktu reset yang ditunjukkan dalam kesalahan
  • Jalankan /usage untuk melihat batas paket dan kapan mereka direset
  • Jalankan /usage-credits untuk membeli penggunaan tambahan pada Pro dan Max, atau untuk memintanya dari admin Anda pada Team dan Enterprise. Lihat usage credits untuk paket berbayar untuk cara penagihan ini.
  • Untuk meningkatkan paket Anda untuk batas dasar yang lebih tinggi, lihat claude.com/pricing

Untuk memantau tunjangan sisa Anda sebelum mencapai batas, tambahkan bidang rate_limits ke baris status kustom, atau di aplikasi Desktop klik cincin penggunaan di sebelah pemilih model.

Kredit penggunaan diperlukan untuk konteks 1M

Model yang dipilih menggunakan jendela konteks diperpanjang 1M-token, dan paket Anda hanya mencakupnya melalui kredit penggunaan.

API Error: Usage credits required for 1M context · run /usage-credits to turn them on, or /model to switch to standard context

Ini adalah pemeriksaan hak, bukan kelelahan kuota. Ini terjadi bahkan ketika tunjangan sesi dan mingguan Anda memiliki kapasitas yang tersisa. Lihat Extended context untuk paket mana yang mencakup konteks 1M secara langsung dan mana yang memerlukan kredit penggunaan.

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

Yang harus dilakukan:

  • Jalankan /model dan pilih varian tanpa akhiran [1m] untuk kembali ke jendela konteks standar
  • Jalankan /usage-credits untuk mengaktifkan penagihan terukur untuk varian 1M pada Pro dan Max, atau untuk memintanya dari admin Anda pada Team dan Enterprise
  • Jika kesalahan berlanjut setelah /model, ID model 1M mungkin diatur di tempat lain. Lihat There's an issue with the selected 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

Server sedang membatasi permintaan sementara

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

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

Claude Code membedakan ini dari batas paket Anda dengan tidak adanya header kuota terpadu yang dibawa respons batas nyata. {/* min-version: 2.1.199 */}Mulai dari v2.1.199 ini dicoba ulang secara otomatis dengan backoff sebelum ditampilkan, cara apa pun Anda melakukan autentikasi. Pada versi sebelumnya, sesi yang masuk dengan langganan claude.ai gagal giliran pada kemunculan pertama; hanya API key dan Enterprise sign-ins yang mencoba ulangnya.

Yang harus dilakukan:

Permintaan ditolak (429)

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

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

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

Yang harus dilakukan:

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

Saldo kredit terlalu rendah

Organisasi Console Anda telah kehabisan kredit prabayar.

Credit balance is too low

Yang harus dilakukan:

  • Tambahkan kredit di platform.claude.com/settings/billing, dan pertimbangkan untuk mengaktifkan auto-reload di sana sehingga saldo terisi ulang sebelum mencapai nol
  • Beralih ke autentikasi langganan dengan /login jika Anda memiliki paket Pro, Max, Team, atau Enterprise
  • Atur batas pengeluaran per-workspace di Console untuk mencegah satu proyek menguras saldo org. Lihat Manage costs effectively.

Kesalahan autentikasi

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

Belum masuk

Tidak ada kredensial yang valid tersedia untuk sesi ini.

Not logged in · Please run /login

Yang harus dilakukan:

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

Jika Anda diminta untuk masuk berulang kali, lihat Belum masuk atau token kedaluwarsa untuk perbaikan jam sistem dan Keychain macOS.

Tidak dapat menyelesaikan metode autentikasi

Sesi mencapai klien API tanpa kredensial apa pun. Ini muncul di sesi latar belakang, sesi cloud, dan konteks Agent SDK di mana pemeriksaan login interaktif tidak berjalan sebelum permintaan pertama.

Could not resolve authentication method. Expected one of apiKey, authToken, credentials, config, or profile to be set. Or for one of the "X-Api-Key" or "Authorization" headers to be explicitly omitted

{/* min-version: 2.1.174 */}Sebelum v2.1.174, sesi latar belakang atau cloud yang ditugaskan ke pekerja yang sudah diinisialisasi sebelumnya yang menganggur dapat gagal dengan cara ini bahkan ketika kredensial yang valid dikonfigurasi. Tingkatkan untuk memulihkan. Pada versi saat ini, kesalahan berarti tidak ada kredensial yang tersedia untuk proses pekerja.

Yang harus dilakukan:

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

Kunci API tidak valid

Variabel lingkungan ANTHROPIC_API_KEY atau skrip apiKeyHelper mengembalikan kunci yang ditolak API.

Invalid API key · Fix external API key

Yang harus dilakukan:

  • Periksa kesalahan ketik dan konfirmasi bahwa kunci belum dicabut di Console
  • Jalankan env | grep ANTHROPIC di shell yang sama. Alat seperti direnv, plugin shell dotenv, dan terminal IDE dapat memuat kunci yang sudah usang dari file .env di proyek Anda tanpa Anda mengaturnya secara eksplisit.
  • Batalkan pengaturan ANTHROPIC_API_KEY dan jalankan /login untuk menggunakan autentikasi langganan sebagai gantinya
  • Jika kunci berasal dari skrip apiKeyHelper, jalankan skrip secara langsung untuk mengonfirmasi bahwa skrip mencetak kunci yang valid di stdout
  • Jalankan /status untuk mengonfirmasi sumber kredensial mana yang sebenarnya digunakan Claude Code

Organisasi ini telah dinonaktifkan

Kunci ANTHROPIC_API_KEY yang sudah usang dari organisasi Console yang dinonaktifkan menimpa login langganan Anda.

Your ANTHROPIC_API_KEY belongs to a disabled organization · Unset the environment variable to use your other credentials
API Error: 400 ... This organization has been disabled.

Variabel lingkungan memiliki prioritas lebih tinggi daripada /login, jadi kunci yang diekspor di profil shell Anda atau dimuat dari file .env digunakan bahkan ketika Anda memiliki langganan Pro atau Max yang berfungsi. Dalam mode non-interaktif (-p), kunci selalu digunakan saat ada.

Yang harus dilakukan:

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

Organisasi Anda telah menonaktifkan autentikasi kunci API

Pesan ini memerlukan Claude Code v2.1.169 atau lebih baru. Admin organisasi Console Anda telah mematikan autentikasi kunci API, jadi API menolak kunci yang dikirim Claude Code. Petunjuk pemulihan setelah · bervariasi tergantung di mana kunci berasal:

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

Variabel lingkungan dan apiKeyHelper memiliki prioritas lebih tinggi daripada /login, jadi menjalankan /login saja tidak membantu sementara salah satu masih menyuplai kunci. Lihat Prioritas autentikasi.

Yang harus dilakukan:

  • Jika pesan menyebutkan ANTHROPIC_API_KEY, batalkan pengaturannya di shell saat ini dan hapus dari profil shell Anda atau file .env, kemudian luncurkan kembali claude
  • Jika pesan menyebutkan apiKeyHelper, hapus pengaturan apiKeyHelper dari settings.json Anda
  • Jalankan /login untuk masuk dengan akun claude.ai Anda
  • Jalankan /status setelahnya untuk mengonfirmasi bahwa kredensial aktif adalah langganan Anda daripada kunci API
  • Jika Anda memerlukan autentikasi kunci API untuk otomasi, minta admin organisasi Anda untuk mengaktifkannya kembali di Console

Organisasi Anda telah menonaktifkan akses langganan Claude

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

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

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

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

Yang harus dilakukan:

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

Rutinitas dinonaktifkan oleh kebijakan organisasi Anda

Pemilik di organisasi Tim atau Enterprise Anda telah mematikan rutinitas di tingkat organisasi. Kesalahan muncul ketika Anda mencoba membuat atau menjalankan rutinitas, termasuk dari /schedule dan UI Rutinitas di claude.ai/code.

Routines are disabled by your organization's policy.

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

Yang harus dilakukan:

Remote Control memerlukan API Anthropic

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

Remote Control is only available when using Claude via api.anthropic.com.

Ini muncul di Amazon Bedrock, Platform Agen Google Cloud, dan Microsoft Foundry. {/* min-version: 2.1.196 */}Mulai dari v2.1.196, ini juga muncul ketika ANTHROPIC_BASE_URL menunjuk ke host selain api.anthropic.com, seperti gateway LLM atau proxy, bahkan ketika Anda masuk dengan claude.ai.

Yang harus dilakukan:

  • Batalkan pengaturan ANTHROPIC_BASE_URL dan mulai ulang sesi, atau mulai Remote Control dari sesi yang berbicara langsung ke API Anthropic
  • Untuk pesan startup Remote Control ini dan lainnya, lihat Troubleshoot Remote Control

Token OAuth dicabut atau kedaluwarsa

Login yang disimpan Anda tidak lagi valid. Token yang dicabut berarti Anda keluar di mana-mana atau admin menghapus akses; token yang kedaluwarsa berarti penyegaran otomatis gagal di tengah sesi.

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

Yang harus dilakukan:

  • Jalankan /login untuk masuk lagi
  • Jika kesalahan kembali dalam sesi yang sama setelah autentikasi ulang, jalankan /logout terlebih dahulu untuk sepenuhnya menghapus token yang disimpan, kemudian /login
  • Untuk prompt login berulang di seluruh peluncuran, lihat pemeriksaan jam sistem dan Keychain macOS di Troubleshooting
  • Untuk kegagalan lainnya termasuk 403 Forbidden dan masalah browser OAuth, lihat Login dan autentikasi

Persyaratan cakupan OAuth

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

OAuth token does not meet scope requirement: user:profile

Yang harus dilakukan:

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

Kredensial AWS kedaluwarsa atau tidak valid

{/* min-version: 2.1.198 */}Pesan ini memerlukan Claude Code v2.1.198 atau lebih baru dan hanya muncul ketika awsAuthRefresh diatur dalam file pengaturan Anda. Token sesi AWS Anda kedaluwarsa atau ditolak, dan penyegaran otomatis yang sudah dijalankan Claude Code tidak menghasilkan kredensial yang diterima API. 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 tengah menyebutkan perintah awsAuthRefresh dari pengaturan Anda, jadi bervariasi. Bagian yang stabil adalah AWS credentials expired or invalid di awal:

AWS credentials expired or invalid · run /login and select "Claude Platform on AWS · refresh credentials", or run `aws sso login --profile myprofile` in another terminal · API Error: 401 ...

Tanpa awsAuthRefresh yang dikonfigurasi, 401 yang sama menunjukkan pesan generik Please run /login sebagai gantinya, yang tidak dapat menyegarkan kredensial AWS.

Yang harus dilakukan:

  • Jalankan perintah awsAuthRefresh yang disebutkan dalam pesan, seperti aws sso login --profile myprofile, di terminal lain dan selesaikan masuk browser, kemudian coba lagi
  • Dalam sesi interaktif, jalankan /login, pilih platform pihak ketiga, kemudian pilih Claude Platform on AWS · refresh credentials di bawah Menggunakan platform pihak ketiga untuk menjalankan perintah yang sama tanpa memulai ulang Claude Code. Lihat Konfigurasi kredensial AWS
  • Jika kesalahan berulang setelah perintah penyegaran berhasil, konfirmasi identitas valid di luar Claude Code dengan aws sts get-caller-identity di shell dan profil yang sama

Autentikasi AWS gagal

{/* min-version: 2.1.198 */}Pesan ini memerlukan Claude Code v2.1.198 atau lebih baru dan hanya muncul ketika awsAuthRefresh diatur dalam file pengaturan Anda. Penyedia AWS Anda mengembalikan 403, atau Amazon Bedrock mengembalikan 401.

Claude Code tidak dapat mengetahui penyebab mana yang Anda alami. Amazon Bedrock melaporkan token keamanan yang kedaluwarsa sebagai 403, tetapi 403 juga merupakan cara melaporkan penolakan otorisasi, seperti AccessDeniedException dari izin IAM yang hilang atau model yang tidak diaktifkan untuk akun Anda.

401 dari Amazon Bedrock juga mendarat di sini daripada di bawah Kredensial AWS kedaluwarsa atau tidak valid, karena Amazon Bedrock tidak melaporkan token yang kedaluwarsa sebagai 401. 401 dari endpoint tersebut biasanya berasal dari sesuatu yang lain di jalur permintaan, seperti proxy perusahaan.

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

AWS authentication failed · run /login and select "Claude Platform on AWS · refresh credentials", or run `aws sso login --profile myprofile` in another terminal · if credentials are current, check AWS permissions and model access · API Error: 403 ...

Petunjuk tindakan di tengah menyebutkan perintah awsAuthRefresh dari pengaturan Anda, jadi bervariasi. Bagian yang stabil adalah AWS authentication failed di awal.

Yang harus dilakukan:

  • Jalankan perintah awsAuthRefresh yang disebutkan dalam pesan, atau aws sso login, untuk berjaga-jaga jika kredensial yang kedaluwarsa adalah penyebabnya
  • Jika kredensial Anda saat ini, konfirmasi izin IAM di Konfigurasi IAM terlampir pada identitas yang Anda gunakan dan bahwa model yang dipilih diaktifkan untuk akun dan wilayah Anda
  • Jalankan aws sts get-caller-identity untuk mengonfirmasi identitas mana yang digunakan permintaan Anda; AWS_PROFILE yang sudah usang atau profil default adalah penyebab umum ketidakcocokan izin

Kesalahan jaringan dan koneksi

Kesalahan ini berarti permintaan jaringan dari Claude Code gagal mencapai tujuannya. Biasanya berasal dari jaringan lokal Anda, proxy, atau firewall, atau dari kebijakan jaringan lingkungan cloud.

Tidak dapat terhubung ke API

Koneksi TCP ke API gagal atau tidak pernah selesai.

Unable to connect to API. Check your internet connection
Unable to connect to API (ECONNREFUSED)
Unable to connect to API (ECONNRESET)
Unable to connect to API (ETIMEDOUT)
fetch failed
Request timed out. Check your internet connection and proxy settings

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

Yang harus dilakukan:

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

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

  • Di Linux dan WSL, periksa /etc/resolv.conf untuk nameserver yang tidak dapat dijangkau. WSL khususnya dapat mewarisi resolver yang rusak dari host.
  • Di macOS, klien VPN yang terputus atau dihapus dapat meninggalkan antarmuka tunnel atau aturan routing. Periksa ifconfig untuk antarmuka utun yang sudah usang dan hapus ekstensi jaringan VPN di System Settings.
  • Docker Desktop dan runtime container serupa dapat mengintersepsi lalu lintas keluar. Tutup mereka dan coba lagi untuk mengesampingkan ini.

Kesalahan sertifikat SSL

Proxy atau perangkat keamanan di jaringan Anda mengintersepsi lalu lintas TLS dengan sertifikatnya sendiri, dan Claude Code tidak mempercayainya.

Unable to connect to API: SSL certificate verification failed. Check your proxy or corporate SSL certificates
Unable to connect to API: Self-signed certificate detected

{/* min-version: 2.1.199 */}Mulai dari v2.1.199, kegagalan validasi sertifikat tidak diulang, jadi kesalahan ini muncul pada percobaan pertama daripada setelah anggaran retry penuh. Versi sebelumnya menghabiskan beberapa menit untuk mencoba ulang sebelum menampilkannya. Kondisi TLS sementara, seperti timeout handshake, masih mencoba ulang.

Selama /login dan pemeriksaan konektivitas startup, kegagalan yang sama dilaporkan dengan kode OpenSSL dan perbaikan inline:

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

Yang harus dilakukan:

  • Ekspor bundle 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 tidak diizinkan dalam sesi cloud

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

HTTP 403
x-deny-reason: host_not_allowed

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

Ini bukan masalah jaringan sisi klien. Sesi cloud dan routines berjalan di dalam lingkungan sandbox yang lalu lintas keluarnya disaring ke daftar izin lingkungan. Lingkungan Default menggunakan akses Trusted, yang memungkinkan daftar izin default dari registri paket, API penyedia cloud, registri container, dan domain pengembangan umum tetapi memblokir semuanya.

Yang harus dilakukan:

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

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

Tidak dapat terhubung kembali ke sesi Remote Control Anda

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

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

Yang harus dilakukan:

  • Jalankan /remote-control untuk mencoba ulang koneksi
  • Mulai Claude Code tanpa --resume untuk membuat sesi Remote Control baru
  • Untuk pesan startup Remote Control lainnya, lihat Troubleshoot Remote Control

Anda tidak akan melihat pesan ini ketika server mengkonfirmasi sesi sebelumnya tidak lagi ada; Claude Code membuat yang baru dalam hal itu. {/* min-version: 2.1.200 */}Sebelum v2.1.200, kegagalan reconnection apa pun membuat sesi Remote Control baru, yang meninggalkan sesi ekstra dalam daftar sesi di claude.ai/code.

Kesalahan permintaan

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

Prompt terlalu panjang

Percakapan ditambah file terlampir melebihi jendela konteks model.

Prompt is too long

Yang harus dilakukan:

  • Jalankan /compact untuk merangkum giliran sebelumnya dan membebaskan ruang, atau /clear untuk memulai dari awal
  • Jalankan /context untuk melihat rincian apa yang mengonsumsi jendela: prompt sistem, alat, file memori, dan pesan
  • Nonaktifkan server MCP yang tidak Anda gunakan dengan /mcp disable <name> untuk menghapus definisi alat mereka dari konteks
  • Pangkas file memori CLAUDE.md yang besar, atau pindahkan instruksi ke aturan yang dibatasi jalur yang dimuat hanya ketika relevan
  • Subagen mewarisi setiap definisi alat MCP dari sesi induk, yang dapat mengisi jendela konteks mereka sebelum giliran pertama. Nonaktifkan server MCP yang tidak Anda gunakan sebelum menelurkan subagen.
  • Auto-compact diaktifkan secara default dan biasanya mencegah kesalahan ini. Jika Anda telah menetapkan DISABLE_AUTO_COMPACT, aktifkan kembali atau jalankan /compact secara manual sebelum jendela penuh.

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

Kesalahan selama pemadatan: Percakapan terlalu panjang

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

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

Ini dapat terjadi ketika jendela sudah penuh pada saat auto-compact dipicu, atau ketika Anda menjalankan /compact setelah melihat Prompt is too long.

Yang harus dilakukan:

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

Permintaan terlalu besar

Badan permintaan mentah melebihi batas byte API sebelum tokenisasi, biasanya karena file atau lampiran besar yang ditempel.

Request too large (max 30 MB). Double press esc to go back and remove or shrink the attached content.

Ini adalah batas ukuran pada permintaan HTTP, terpisah dari batas jendela konteks.

Yang harus dilakukan:

  • Tekan Esc dua kali dan mundur melewati giliran yang menambahkan konten yang terlalu besar
  • Referensikan file besar berdasarkan jalur alih-alih menempel konten mereka, sehingga Claude dapat membacanya dalam potongan
  • Untuk gambar, lihat Gambar terlalu besar di bawah

Gambar terlalu besar

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

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

{/* min-version: 2.1.142 */}Claude Code mengganti gambar yang tidak dapat diproses dengan placeholder teks dan mencoba lagi, sehingga pesan berikutnya berhasil. Pada versi sebelum 2.1.142, gambar yang ditempel dapat tetap berada dalam percakapan dan mengulangi kesalahan yang sama pada setiap pesan berikutnya. Untuk pulih pada versi tersebut, tekan Esc dua kali dan mundur melewati giliran tempat gambar ditambahkan.

Yang harus dilakukan:

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

Tidak dapat mengubah ukuran gambar

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

Unable to resize image — image processing is unavailable and dimensions could not be read from the file header. Please convert the image to PNG, JPEG, GIF, or WebP.
Unable to resize image — dimensions exceed the 2000x2000px limit and image processing failed. Please resize the image to reduce its pixel dimensions.
Unable to resize image (… raw, … base64). The image exceeds the … API limit and compression failed. Please resize the image manually or use a smaller image.
Unable to resize image — could not verify image dimensions are within the 2000x2000px API limit.

Claude Code biasanya mengubah ukuran gambar besar secara otomatis. Kesalahan ini berarti pemroses gambar asli gagal dimuat atau mengembalikan kesalahan, sehingga gambar tidak dapat diubah ukurannya agar sesuai dengan batas API.

Yang harus dilakukan:

  • Jika pesan meminta Anda untuk mengonversi gambar, konversikan ke PNG, JPEG, GIF, atau WebP dan lampirkan lagi. Claude Code dapat memverifikasi dimensi untuk format ini tanpa pemroses gambar.
  • Jika pesan melaporkan batas dimensi atau ukuran, ubah ukuran atau kompres ulang gambar di bawah batas tersebut sebelum melampirkan.

Kesalahan PDF

PDF yang Anda lampirkan tidak dapat diproses.

PDF too large (max 100 pages, 32 MB). Try splitting it or extracting text first.
PDF is password protected. Try removing protection or extracting text first.
The PDF file was not valid. Try converting to a different format first.

Yang harus dilakukan:

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

Input tambahan tidak diizinkan

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

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

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

Yang harus dilakukan:

  • Konfigurasikan gateway Anda untuk meneruskan header anthropic-beta. Lihat feature pass-through untuk apa yang harus diteruskan gateway.
  • Sebagai fallback, atur CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS=1 sebelum meluncurkan. Ini menonaktifkan fitur yang memerlukan header beta sehingga permintaan berhasil melalui gateway yang tidak dapat meneruskannya.

Ada masalah dengan model yang dipilih

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

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

Yang harus dilakukan:

  • CLI Interaktif: jalankan /model untuk memilih dari model yang tersedia untuk akun Anda.
  • Mode non-interaktif (-p): teruskan --model dengan alias atau ID yang valid, atau atur ANTHROPIC_MODEL. Teks kesalahan menunjukkan Run --model di permukaan ini.
  • Agent SDK: teks kesalahan menghilangkan petunjuk karena model diatur secara terprogram. Atur model pada Options di TypeScript atau ClaudeAgentOptions(model=...) di Python, dan tangani kesalahan terstruktur model_not_found untuk menampilkan pengambil ulang atau pemilih model Anda sendiri.
  • Gunakan alias seperti sonnet atau opus alih-alih ID versi lengkap. Alias diselesaikan ke default yang dipertahankan sehingga tidak menjadi usang. Lihat Konfigurasi model.
  • Jika model yang salah terus kembali di CLI, ID yang usang diatur di suatu tempat. Periksa dalam urutan prioritas: flag --model, variabel lingkungan ANTHROPIC_MODEL, kemudian bidang model di .claude/settings.local.json, .claude/settings.json proyek Anda, dan ~/.claude/settings.json. Hapus nilai yang usang dan Claude Code kembali ke default akun Anda.
  • Untuk penyebaran Google Cloud's Agent Platform, lihat Pemecahan masalah Google Cloud's Agent Platform.

Model bukan ID model yang dikenali

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

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

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

Claude Code menghasilkan kesalahan ini secara lokal pada saat sakelar diminta, sebelum permintaan API apa pun dibuat. Ini berlaku ketika model diatur melalui metode Agent SDK setModel() atau oleh aplikasi seperti Desktop app yang menjalankan CLI Claude Code untuk Anda.

Yang harus dilakukan:

  • Jalankan /model tanpa argumen untuk membuka pemilih dan pilih dari model yang tersedia untuk akun Anda, kemudian teruskan alias atau ID yang ditampilkan di sana
  • Jika Anda menggunakan alias yang didukung versi Claude Code yang lebih baru, jalankan claude update. ID lengkap yang dimulai dengan claude- melewati pemeriksaan ini bahkan ketika model lebih baru dari versi Claude Code Anda, jadi upgrade tidak diperlukan untuk itu.
  • Model yang disimpan sebelum v2.1.200 tidak diperbaiki oleh pemeriksaan ini. Jika nilai yang usang terus kembali, hapus dari lokasi yang tercantum di bawah Ada masalah dengan model yang dipilih.
  • Pemeriksaan hanya berjalan di Anthropic API. Di Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry, Claude Platform on AWS, dan di belakang LLM gateway atau ANTHROPIC_BASE_URL kustom, penyedia atau gateway Anda menentukan nama model, jadi Claude Code menerima string apa pun dan meneruskannya.

Claude Opus tidak tersedia dengan paket Claude Pro

Paket langganan aktif Anda tidak mencakup model yang Anda pilih.

Claude Opus is not available with the Claude Pro plan · Select a different model in /model

Yang harus dilakukan:

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

Model dibatasi oleh pengaturan organisasi Anda

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

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

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

Yang harus dilakukan:

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

thinking.type.enabled tidak didukung untuk model ini

Versi Claude Code Anda lebih lama dari minimum untuk Sonnet 5, Opus 4.8, atau Opus 4.7. CLI mengirim konfigurasi pemikiran yang model tidak lagi terima.

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

Yang harus dilakukan:

  • Jalankan claude update dan restart Claude Code. Opus 4.7 memerlukan v2.1.111 atau lebih baru. Opus 4.8 memerlukan v2.1.154 atau lebih baru. Sonnet 5 memerlukan v2.1.197 atau lebih baru
  • Jika Anda tidak dapat upgrade, jalankan /model dan pilih Opus 4.6 atau Sonnet 4.6 sebagai gantinya
  • {/* min-version: agent-sdk@0.3.197 */}Jika Anda mengalami ini di Agent SDK, upgrade paket SDK sebagai gantinya. Opus 4.8 memerlukan TypeScript SDK v0.3.154 atau lebih baru dan Python SDK v0.2.88 atau lebih baru. Sonnet 5 memerlukan TypeScript SDK v0.3.197 atau lebih baru

Anggaran pemikiran melebihi batas output

Anggaran pemikiran yang diperpanjang yang dikonfigurasi melebihi panjang respons maksimum, sehingga tidak ada ruang yang tersisa untuk jawaban sebenarnya.

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

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

Yang harus dilakukan:

Ketidakcocokan blok penggunaan alat atau pemikiran

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

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

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

Yang harus dilakukan:

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

Penolakan Kebijakan Penggunaan

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

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

Pemeriksaan mengevaluasi percakapan lengkap, bukan hanya prompt terbaru Anda, jadi mengirim pesan baru dalam sesi yang sama biasanya memicu penolakan yang sama. Hal yang sama berlaku setelah keluar dan membuka kembali sesi dengan --continue atau --resume, karena transkrip di disk masih berisi konten pemicu. Di Amazon Bedrock, Google Cloud's Agent Platform, dan Microsoft Foundry, pesan ini juga mencakup permintaan yang ditandai oleh langkah-langkah keselamatan model sebagai topik keamanan siber. Lihat Langkah-langkah keselamatan menandai topik keamanan siber.

Yang harus dilakukan:

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

Langkah-langkah keselamatan menandai topik keamanan siber

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

API Error: Opus 4.8 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: https://support.claude.com/en/articles/14604842-real-time-cyber-safeguards-on-claude.

If you were not engaging in a cybersecurity topic, please send feedback via /feedback.

Pesan menghubungkan ke Program Verifikasi Siber, yang memberikan akses untuk pekerjaan keamanan siber yang sah. Penjaga itu sendiri adalah server-side dan mendahului v2.1.203; rilis ini hanya mengubah kata-kata pesan dan halaman yang ditautkannya.

Apa yang Anda lihat tergantung pada penyedia dan mode Anda:

{/* max-version: 2.1.202 */}Sebelum v2.1.203, pesan berbunyi <model>'s safeguards flagged this message for a cybersecurity topic. If your work requires this access, you can apply for an exemption: diikuti oleh tautan formulir pengecualian.

Yang harus dilakukan:

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

Kesalahan instalasi

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

Installation was killed before it could finish

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

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

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

Yang harus dilakukan:

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

The connection dropped while downloading the update

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

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

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

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

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

Yang harus dilakukan:

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

Kesalahan baris perintah

Kesalahan ini berasal dari baris perintah claude dan subperintahnya. Claude Code mencetaknya sebelum menjalankan prompt Anda atau mengirim permintaan API apa pun.

Konflik antara --bg dan --print

Pesan ini memerlukan Claude Code v2.1.198 atau lebih baru. Anda menggabungkan --bg dengan -p atau --print dalam invokasi claude yang sama. --bg memulai sesi latar belakang yang kemudian Anda lampirkan dengan claude agents, sementara --print berjalan non-interaktif dan tidak pernah memulai sesi interaktif yang claude agents lampirkan. Sebelum v2.1.198, kombinasi ini secara diam-diam membuat pekerjaan latar belakang yang tidak pernah dapat dilampirkan.

--bg and --print conflict: --print never starts the interactive session that `claude agents` attaches to, so the job would be unattachable. The prompt is the positional — drop --print: `claude --bg '<task>'`.

Yang harus dilakukan:

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

Nilai --json-schema bukan JSON Schema yang valid

Skema yang Anda berikan ke --json-schema dalam mode non-interaktif gagal kompilasi JSON Schema, jadi claude keluar dengan kode 1 alih-alih menjalankan prompt. Sebelum v2.1.205, skema yang tidak valid menghasilkan output tidak terstruktur tanpa kesalahan, dan skema apa pun yang menggunakan kata kunci format dianggap tidak valid.

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

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

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

Yang harus dilakukan:

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

Tidak dapat mengimpor server dari Claude Desktop

Claude Code tidak dapat menambahkan salah satu server yang Anda pilih dalam claude mcp add-from-claude-desktop. Perintah masih mengimpor server yang dipilih lainnya dan mencetak satu baris per server yang tidak dapat ditambahkan. Sebelum v2.1.205, server pertama yang gagal menghentikan impor dan tidak ada server yang dipilih yang ditambahkan.

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

Teks setelah nama server adalah alasannya. Yang paling umum adalah pemeriksaan nama: Claude Desktop memungkinkan karakter dalam nama server, seperti spasi dan titik, yang claude mcp batasi hanya untuk huruf, angka, tanda hubung, dan garis bawah. Alasan lain termasuk konfigurasi server yang gagal validasi dan server yang diblokir oleh kebijakan MCP organisasi Anda.

Yang harus dilakukan:

  • Ubah nama server di claude_desktop_config.json untuk hanya menggunakan huruf, angka, tanda hubung, dan garis bawah, kemudian jalankan claude mcp add-from-claude-desktop lagi
  • Tambahkan server itu secara langsung dengan claude mcp add atau claude mcp add-json dengan nama yang valid. Lihat Import MCP servers from Claude Desktop.

Kesalahan Plugin

Kesalahan ini berasal dari konfigurasi plugin dan marketplace. Untuk masalah plugin yang tidak menghasilkan salah satu pesan di halaman ini, seperti URL marketplace yang tidak memuat atau plugin yang terpasang tetapi tidak muncul, lihat Troubleshooting Plugin.

Marketplace terdaftar dari sumber yang tidak terpercaya

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

Marketplace "claude-community" is registered from an untrusted source: The name 'claude-community' is reserved for official Anthropic marketplaces. Only repositories from 'github.com/anthropics/' can use this name. To fix it, remove the marketplace and re-add it from the official source.

Yang harus dilakukan:

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

Peringatan Konfigurasi

Claude Code menulis pesan-pesan ini ke stderr saat startup daripada menampilkan kesalahan dalam percakapan. Mereka melaporkan konfigurasi yang dibaca tetapi tidak diterapkan.

Workspace belum dipercaya

Claude Code menemukan aturan permissions.allow atau entri permissions.additionalDirectories dalam .claude/settings.json atau .claude/settings.local.json proyek dan tidak menerapkannya, karena aturan allow dari pengaturan proyek memerlukan kepercayaan workspace. Jumlah, nama pengaturan, dan file yang dinamai dalam pesan bervariasi dengan konfigurasi Anda. Aturan deny dan ask tidak terpengaruh.

Ignoring 2 permissions.allow entries from .claude/settings.local.json: this workspace has not been trusted. Run Claude Code interactively here once and accept the trust dialog, or set projects["/Users/you/project"].hasTrustDialogAccepted: true in /Users/you/.claude.json.

Yang harus dilakukan:

  • Jalankan claude di direktori dan terima dialog kepercayaan. {/* min-version: 2.1.200 */}Dialog muncul bahkan ketika direktori induk sudah dipercaya, mencantumkan aturan yang ditahan, dan memungkinkan Anda menolak dan terus bekerja tanpanya. Sebelum v2.1.200, tidak ada dialog yang muncul dalam situasi itu, jadi langkah ini tidak dapat diselesaikan di sana.
  • Dalam mode non-interaktif dengan -p tidak ada dialog yang ditampilkan. Atur entri hasTrustDialogAccepted dalam ~/.claude.json menggunakan kunci projects yang tepat yang dicetak pesan.
  • {/* min-version: 2.1.200 */}Jika pesan menyebutkan .claude/settings.local.json dan Anda memulai Claude Code di luar repositori git atau di direktori home Anda, perbarui ke v2.1.200 atau lebih baru. Versi 2.1.196 hingga 2.1.199 memperlakukan .claude/settings.local.json Anda sendiri sebagai yang disediakan repositori di workspace tersebut. Lihat Aturan allow proyek dan kepercayaan workspace.

Respons tampak berkualitas lebih rendah dari biasanya

Jika jawaban Claude tampak kurang mampu dari yang Anda harapkan tetapi tidak ada kesalahan yang ditampilkan, penyebabnya biasanya adalah status percakapan daripada model itu sendiri. Claude Code tidak secara diam-diam mengubah versi model. Ini dapat beralih ke model fallback dalam tiga kasus spesifik:

  • --fallback-model yang dikonfigurasi mengambil alih setelah kesalahan ketersediaan, hanya untuk giliran itu, dengan pemberitahuan dalam transkrip
  • Pemeriksaan startup Amazon Bedrock atau Google Cloud's Agent Platform menemukan model default Anda tidak tersedia
  • Fallback model otomatis pada Fable 5 memindahkan sesi ke model Opus default dan menampilkan pemberitahuan dalam transkrip

Pemeriksaan Model selection di bawah menangkap kasus kedua dan ketiga; kasus pertama muncul sebagai pemberitahuan transkrip daripada perubahan /model. Konfigurasi model menjelaskan kapan setiap fallback berlaku.

Periksa ini terlebih dahulu:

  • Model selection: jalankan /model untuk mengonfirmasi Anda berada di model yang Anda harapkan. Pilihan /model sebelumnya atau variabel lingkungan ANTHROPIC_MODEL mungkin membuat Anda berada di model yang lebih kecil dari yang Anda maksudkan.
  • Effort level: jalankan /effort untuk memeriksa tingkat reasoning saat ini dan naikkan untuk debugging atau pekerjaan desain yang sulit. Default bervariasi menurut model, jadi periksa sebelum menganggap Anda di bawah maksimum. Lihat Adjust effort level untuk default per-model dan pintasan ultrathink.
  • Context pressure: jalankan /context untuk melihat seberapa penuh jendela tersebut. Jika mendekati kapasitas, jalankan /compact pada titik alami atau /clear untuk memulai dari awal. Lihat Explore the context window untuk cara auto-compact mempengaruhi giliran sebelumnya.
  • Stale instructions: file CLAUDE.md yang besar atau ketinggalan zaman dan definisi alat MCP mengonsumsi konteks dan dapat mengarahkan respons. {/* min-version: 2.1.205 */}Pemeriksaan /doctor menandai file memori yang berukuran besar dan ekstensi yang tidak digunakan, dan /context menampilkan penggunaan token alat MCP. Sebelum v2.1.205, /doctor membuka layar diagnostik yang menandai file memori yang berukuran besar dan definisi subagent.

Ketika respons salah, rewinding biasanya bekerja lebih baik daripada membalas dengan koreksi. Tekan Esc dua kali atau jalankan /rewind untuk mundur ke sebelum giliran yang buruk, kemudian rephrase prompt dengan spesifik lebih lanjut. Mengoreksi dalam-thread menjaga upaya yang salah dalam konteks, yang dapat menambatkan jawaban nanti ke dalamnya. Lihat Checkpointing.

Jika kualitas masih tampak tidak sesuai setelah memeriksa di atas, jalankan /feedback dan jelaskan apa yang Anda harapkan versus apa yang Anda dapatkan. Feedback yang dikirimkan dengan cara ini mencakup transkrip percakapan, yang merupakan cara tercepat bagi Anthropic untuk mendiagnosis regresi nyata. Lihat Report an error jika /feedback tidak tersedia di lingkungan Anda.

{/* min-version: 2.1.201 */}Jika Sonnet 5 menolak permintaan dan mengutip injeksi prompt yang dicurigai pada Claude Code v2.1.200 atau lebih awal, jalankan claude update untuk mengambil perbaikan v2.1.201.

Laporkan kesalahan

Untuk kesalahan dari komponen yang tidak tercakup di halaman ini, lihat panduan yang relevan:

Jika kesalahan tidak tercantum di sini atau perbaikan yang disarankan tidak membantu:

  • Jalankan /feedback di dalam Claude Code untuk mengirimkan transkrip dan deskripsi ke Anthropic. Perintah ini juga menawarkan untuk membuka masalah GitHub yang sudah diisi sebelumnya. Di Amazon Bedrock, Google Cloud's Agent Platform, Microsoft Foundry, dan penyedia pihak ketiga lainnya, /feedback menyimpan arsip lokal yang dapat Anda kirimkan ke perwakilan akun Anthropic Anda.
  • Jalankan claude doctor dari shell Anda untuk diagnostik sistem file hanya-baca dari instalasi Anda, atau jalankan pemeriksaan /doctor di dalam Claude Code untuk menemukan dan memperbaiki masalah konfigurasi
  • Periksa status.claude.com untuk insiden aktif
  • Cari masalah yang ada di GitHub