Langsung ke konten utama
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.
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 referensi kesalahan Platform Claude.

​
Temukan kesalahan Anda

Cocokkan pesan yang Anda lihat di terminal dengan bagian di bawah ini.
PesanBagian
API Error: 500 Internal server errorKesalahan server
API Error: Repeated 529 Overloaded errorsKesalahan server
Request timed outKesalahan server, atau Jaringan jika pesan menyebutkan koneksi internet Anda
<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 safetyKesalahan server
Auto mode classifier transcript exceeded context windowKesalahan server
You've hit your session limit / You've hit your weekly limitBatas penggunaan
Server is temporarily limiting requestsBatas penggunaan
Request rejected (429)Batas penggunaan
Credit balance is too lowBatas penggunaan
Not logged in · Please run /loginAutentikasi
Invalid API keyAutentikasi
This organization has been disabledAutentikasi
Your organization has disabled Claude subscription accessAutentikasi
Routines are disabled by your organization's policyAutentikasi
OAuth token revoked / OAuth token has expiredAutentikasi
does not meet scope requirement user:profileAutentikasi
Unable to connect to APIJaringan
SSL certificate verification failedJaringan
403 with x-deny-reason: host_not_allowed in a cloud or routine sessionJaringan
Prompt is too longKesalahan permintaan
Error during compaction: Conversation too longKesalahan permintaan
Request too largeKesalahan permintaan
Image was too largeKesalahan permintaan
Unable to resize imageKesalahan permintaan
PDF too large / PDF is password protectedKesalahan permintaan
Extra inputs are not permittedKesalahan permintaan
There's an issue with the selected modelKesalahan permintaan
Claude Opus is not available with the Claude Pro planKesalahan permintaan
thinking.type.enabled is not supported for this modelKesalahan permintaan
max_tokens must be greater than thinking.budget_tokensKesalahan permintaan
API Error: 400 due to tool use concurrency issuesKesalahan permintaan
Claude Code is unable to respond to this request, which appears to violate our Usage PolicyKesalahan permintaan
Respons tampak berkualitas lebih rendah dari biasanyaKualitas 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. Saat mencoba ulang, spinner menampilkan hitungan mundur Retrying in Ns · attempt x/y. Ketika Anda melihat salah satu kesalahan di halaman ini, percobaan ulang tersebut telah habis. Anda dapat menyesuaikan perilaku dengan dua variabel lingkungan:
VariabelDefaultEfek
CLAUDE_CODE_MAX_RETRIES10Jumlah percobaan ulang. Turunkan untuk menampilkan kegagalan lebih cepat dalam skrip; naikkan untuk menunggu insiden yang lebih lama.
API_TIMEOUT_MS600000Waktu 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 API Anthropic itu berarti infrastruktur Anthropic. Pada Bedrock, Vertex AI, 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 API Anthropic: 
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 Bedrock, Vertex AI, dan 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 panjang Anda dapat mengetik try again daripada menempel seluruh hal.
  • Jika kesalahan berlanjut tanpa insiden yang diposting, jalankan /feedback sehingga Anthropic dapat menyelidiki dengan detail permintaan Anda. Lihat Laporkan kesalahan jika /feedback tidak 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: 
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 berbeda untuk terus bekerja, karena kapasitas dilacak per model. Claude Code meminta Anda 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 respons yang sangat besar sedang dihasilkan. 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 Percobaan ulang otomatis
  • Jika waktu tunggu sering terjadi dan jaringan Anda sehat, lihat Kesalahan jaringan dan koneksi di bawah

​
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 kelayakan auto mode; Anda tidak perlu mengubah pengaturan
Ketika pengklasifikasi mengembalikan respons yang tidak dapat diurai: 
Auto mode could not evaluate this action and is blocking it for safety — run with --debug for details
Yang harus dilakukan:
  • Coba ulang tindakan; ini biasanya berhasil pada percobaan berikutnya
  • Jalankan claude --debug dan ulangi tindakan untuk melihat respons pengklasifikasi yang mendasar dalam log debug
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 mode non-interaktif 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

​
Batas penggunaan

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

​
You’ve hit your session limit

Paket langganan mencakup tunjangan penggunaan bergulir. Ketika habis Anda melihat salah satu pesan ini: 
You've hit your session limit · resets 3:45pm
You've hit your weekly limit · resets Mon 12:00am
You've hit your Opus limit · resets 3:45pm
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 Anda dan kapan mereka direset
  • Jalankan /usage-credits untuk membeli penggunaan tambahan di Pro dan Max, atau untuk 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
Untuk menonton tunjangan sisa Anda sebelum Anda mencapai batas, tambahkan bidang rate_limits ke baris status kustom, atau di aplikasi Desktop klik cincin penggunaan di sebelah pemilih model.

​
Server is temporarily limiting requests

API menerapkan throttle berumur pendek yang tidak terkait dengan kuota paket Anda. 
API Error: Server is temporarily limiting requests (not your usage limit)
Ini dicoba ulang secara otomatis sebelum ditampilkan. Yang harus dilakukan:

​
Request rejected (429)

Anda telah mencapai batas laju yang dikonfigurasi untuk kunci API, proyek Amazon Bedrock, atau proyek Google Vertex AI Anda. 
API Error: Request rejected (429) · this may be a temporary capacity issue. If it persists, check https://status.claude.com.
Kalimat di akhir menyebutkan di mana memeriksa kesehatan layanan dan bervariasi menurut penyedia. Konfigurasi Bedrock, Vertex AI, dan Foundry menyebutkan status layanan penyedia itu daripada halaman status Anthropic. ANTHROPIC_BASE_URL kustom menyebutkan host gateway. Yang harus dilakukan:
  • Jalankan /status dan konfirmasi kredensial aktif adalah yang Anda harapkan. ANTHROPIC_API_KEY yang tersesat di lingkungan Anda dapat merutekan permintaan melalui kunci tingkat rendah daripada langganan Anda.
  • Periksa konsol penyedia Anda untuk batas aktif dan minta tingkat yang lebih tinggi jika diperlukan
  • Untuk kunci API Anthropic, lihat referensi batas laju untuk cara kerja tingkat dan cara menetapkan batas per-workspace
  • Kurangi konkurensi: 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

​
Credit balance is too low

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
  • Tetapkan 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 siapa Anda kepada API. Jalankan /status kapan saja untuk melihat kredensial mana yang saat ini aktif.

​
Not logged in

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 atau akun Console Anda
  • Jika Anda mengharapkan variabel lingkungan untuk mengautentikasi Anda, konfirmasi 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 Authentication precedence untuk memahami kredensial mana yang menang ketika beberapa ada
Jika Anda diminta untuk masuk berulang kali, lihat Not logged in or token expired untuk perbaikan jam sistem dan macOS Keychain.

​
Invalid API key

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 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 basi dari file .env di proyek Anda tanpa Anda menetapkannya 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 itu mencetak kunci yang valid di stdout
  • Jalankan /status untuk mengonfirmasi sumber kredensial mana yang sebenarnya digunakan Claude Code

​
This organization has been disabled

ANTHROPIC_API_KEY basi 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 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 ulang claude
  • Jalankan /status setelahnya untuk mengonfirmasi kredensial aktif adalah langganan Anda
  • Jika tidak ada variabel lingkungan yang diatur dan kesalahan berlanjut, organisasi yang dinonaktifkan adalah yang terikat pada /login Anda. Hubungi dukungan atau masuk dengan akun berbeda.

​
Your organization has disabled Claude subscription access

Organisasi Claude Anda tidak memungkinkan masuk ke Claude Code dengan login langganan. Menjalankan /login lagi dengan akun yang sama mengembalikan kesalahan yang sama. 
Your organization has disabled Claude subscription access for Claude Code · Use an Anthropic API key instead, or ask your admin to enable access
Ini adalah pengaturan organisasi sisi server, jadi tidak dapat ditimpa dari pengaturan lokal, variabel lingkungan, atau flag CLI. Agent SDK dan mode non-interaktif -p menampilkan ini sebagai kode kesalahan oauth_org_not_allowed. Yang harus dilakukan:
  • Minta admin Anda untuk mengaktifkan akses Claude Code untuk organisasi Anda
  • Autentikasi dengan kunci API Console sebagai gantinya dari langganan Anda. Lihat Claude Console authentication untuk setup.
  • Jika Anda adalah admin dan tidak melihat opsi untuk mengaktifkan akses, hubungi Anthropic support

​
Routines are disabled by your organization’s policy

Admin Tim atau Enterprise Anda telah mematikan routines di tingkat organisasi. Kesalahan muncul ketika Anda mencoba membuat atau menjalankan routine, termasuk dari /schedule dan UI Routines 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 flag CLI. Yang harus dilakukan:

​
OAuth token revoked or expired

Login yang disimpan tidak lagi valid. Token yang dicabut berarti Anda keluar di mana-mana atau admin menghapus akses; token yang kedaluwarsa berarti penyegaran otomatis gagal di tengah sesi. 
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 berulang untuk masuk di seluruh peluncuran, lihat pemeriksaan jam sistem dan macOS Keychain di Troubleshooting
  • Untuk kegagalan lainnya termasuk 403 Forbidden dan masalah browser OAuth, lihat Login and authentication

​
OAuth scope requirement

Token yang disimpan mendahului cakupan izin yang diperlukan fitur yang lebih baru. Anda melihat ini paling sering dari /usage dan indikator penggunaan baris status: 
OAuth token does not meet scope requirement: user:profile
Yang harus dilakukan:
  • Jalankan /login untuk membuat token baru dengan cakupan saat ini. Anda tidak perlu keluar terlebih dahulu.

​
Kesalahan jaringan dan koneksi

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

​
Unable to connect to 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 yang tidak dikonfigurasi. Yang harus dilakukan:
  • Konfirmasi Anda dapat menjangkau host API dari shell yang sama dengan menjalankan curl -I https://api.anthropic.com. Di Windows PowerShell gunakan curl.exe -I https://api.anthropic.com sehingga alias Invoke-WebRequest bawaan tidak digunakan.
  • Jika Anda berada di belakang proxy perusahaan, atur HTTPS_PROXY sebelum meluncurkan Claude Code dan lihat Network configuration
  • Jika Anda merutekan melalui gateway LLM atau relay, atur ANTHROPIC_BASE_URL ke alamatnya. Lihat LLM gateway configuration untuk penyiapan.
  • Pastikan firewall Anda memungkinkan host yang tercantum dalam Network access requirements
  • Kegagalan intermiten dicoba ulang secara otomatis; kegagalan persisten menunjukkan masalah jaringan lokal
Jika curl berhasil tetapi Claude Code masih gagal, penyebabnya biasanya sesuatu antara runtime dan jaringan daripada jaringan itu sendiri:
  • Di Linux dan WSL, periksa /etc/resolv.conf untuk nameserver yang tidak dapat dijangkau. WSL khususnya dapat mewarisi resolver yang rusak dari host.
  • Di macOS, klien VPN yang terputus atau dihapus dapat meninggalkan antarmuka terowongan atau aturan perutean. Periksa ifconfig untuk antarmuka utun basi dan hapus ekstensi jaringan VPN di System Settings.
  • Docker Desktop dan runtime kontainer serupa dapat mencegat lalu lintas keluar. Keluar dari mereka dan coba ulang untuk mengesampingkan ini.

​
SSL certificate errors

Proxy atau perangkat keamanan di jaringan Anda mencegat 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
Yang harus dilakukan:
  • Ekspor bundel CA organisasi Anda dan arahkan Claude Code ke sana dengan NODE_EXTRA_CA_CERTS=/path/to/ca-bundle.pem
  • Lihat Network configuration untuk instruksi penyiapan lengkap
  • Jangan atur NODE_TLS_REJECT_UNAUTHORIZED=0, yang menonaktifkan validasi sertifikat sepenuhnya

​
Host not allowed in a cloud session

Permintaan HTTP keluar dari sesi cloud atau routine diblokir oleh kebijakan jaringan lingkungan. 
HTTP 403
x-deny-reason: host_not_allowed
Anda mungkin juga 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 kontainer, 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.

​
Kesalahan permintaan

Kesalahan ini berarti API menerima permintaan Anda tetapi menolak kontennya.

​
Prompt is too long

Percakapan ditambah file terlampir melebihi jendela konteks model. 
Prompt is too long
Yang harus dilakukan:
  • Jalankan /compact untuk merangkum putaran sebelumnya dan membebaskan ruang, atau /clear untuk memulai segar
  • Jalankan /context untuk melihat rincian apa yang mengonsumsi jendela: prompt sistem, alat, file memori, dan pesan
  • Nonaktifkan server MCP yang tidak Anda gunakan dengan /mcp disable <name> untuk menghapus definisi alat mereka dari konteks
  • Pangkas file memori CLAUDE.md besar, atau pindahkan instruksi ke aturan bersisir jalur yang dimuat hanya ketika relevan
  • Subagen mewarisi setiap definisi alat MCP dari sesi induk, yang dapat mengisi jendela konteks mereka sebelum putaran pertama. Nonaktifkan server MCP yang tidak Anda gunakan sebelum menghasilkan subagen.
  • Auto-compact aktif secara default dan biasanya mencegah kesalahan ini. Jika Anda telah menetapkan DISABLE_AUTO_COMPACT, aktifkan kembali atau jalankan /compact secara manual sebelum jendela terisi.
Lihat Jelajahi jendela konteks untuk tampilan interaktif tentang bagaimana konteks terisi.

​
Error during compaction: Conversation too long

/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 putaran. Ini menghapus pesan terbaru dari konteks. Kemudian jalankan /compact lagi.
  • Jika mundur tidak membebaskan cukup ruang, jalankan /clear untuk memulai sesi segar. Percakapan sebelumnya Anda dipertahankan dan dapat dibuka kembali dengan /resume.

​
Request too large

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 putaran yang menambahkan konten yang terlalu besar
  • Referensikan file besar berdasarkan jalur daripada menempel kontennya, sehingga Claude dapat membacanya dalam potongan
  • Untuk gambar, lihat Image was too large di bawah

​
Image was too large

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
Gambar tetap dalam riwayat percakapan setelah kesalahan, jadi setiap pesan berikutnya gagal dengan kesalahan yang sama sampai Anda menghapusnya. Yang harus dilakukan:
  • Tekan Esc dua kali dan mundur melewati putaran tempat gambar ditambahkan
  • Ubah ukuran gambar sebelum menempel. API menerima gambar hingga 8000 piksel di tepi terpanjang untuk satu gambar, atau 2000 piksel ketika banyak gambar ada dalam konteks.
  • Ambil tangkapan layar yang lebih ketat dari wilayah yang relevan daripada layar penuh

​
Unable to resize image

Claude Code tidak dapat memperkecil 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, jadi 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.

​
PDF errors

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 daripada 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

​
Extra inputs are not permitted

Proxy atau gateway LLM antara Claude Code dan API menghapus header permintaan anthropic-beta, jadi 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 alat input_examples bersama dengan header anthropic-beta yang mengaktifkannya. Ketika gateway meneruskan badan tetapi menghapus header, API melihat bidang yang tidak dikenalinya. Yang harus dilakukan:

​
There’s an issue with the selected model

Nama model yang dikonfigurasi tidak dikenali atau akun Anda tidak memiliki akses ke sana. Mulai dari v2.1.160, petunjuk trailing yang 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 pemilih ulang atau model Anda sendiri.
  • Gunakan alias seperti sonnet atau opus daripada ID versi lengkap. Alias melacak rilis terbaru sehingga tidak menjadi usang. Lihat Konfigurasi model.
  • Jika model yang salah terus kembali di CLI, ID basi 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 basi dan Claude Code kembali ke default akun Anda.
  • Untuk penyebaran Vertex AI, lihat Pemecahan masalah Vertex AI.

​
Claude Opus is not available with the Claude Pro plan

Paket langganan aktif Anda tidak menyertakan 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 meningkatkan di web tidak berlaku dalam sesi yang ada sampai Anda autentikasi ulang.
  • Lihat claude.com/pricing untuk model mana yang disertakan setiap paket

​
thinking.type.enabled is not supported for this model

Versi Claude Code Anda lebih lama dari minimum untuk Opus 4.7 atau Opus 4.8. CLI mengirim konfigurasi pemikiran yang tidak lagi diterima model. 
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
  • Jika Anda tidak dapat meningkatkan, jalankan /model dan pilih Opus 4.6 atau Sonnet sebagai gantinya
  • Jika Anda mengalami ini di Agent SDK, lihat Pemecahan masalah SDK

​
Thinking budget exceeds output limit

Anggaran pemikiran yang diperluas yang dikonfigurasi melebihi panjang respons maksimum, jadi tidak ada ruang yang tersisa untuk jawaban sebenarnya. 
API Error: 400 ... max_tokens must be greater than thinking.budget_tokens
Claude Code menyesuaikan nilai-nilai ini secara otomatis di Anthropic API. Anda biasanya melihat kesalahan ini di Amazon Bedrock atau Google Vertex AI ketika MAX_THINKING_TOKENS diatur lebih tinggi dari batas output penyedia, atau ketika mode rencana menaikkan anggaran pemikiran. Yang harus dilakukan:

​
Tool use or thinking block mismatch

Riwayat percakapan mencapai API dalam keadaan tidak konsisten, biasanya setelah panggilan alat terputus atau putaran 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:
  • 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 putaran yang rusak dan lanjutkan dari sana. Lihat Checkpointing untuk cara checkpoint dibuat dan dipulihkan.

​
Usage Policy refusal

API menolak untuk merespons karena konten dalam percakapan memicu pemeriksaan Usage Policy. Pesan tersebut menyertakan ID Permintaan yang dapat Anda kutip ke dukungan jika Anda percaya penolakan itu salah. 
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 seluruh percakapan, 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. Yang harus dilakukan:
  • Tekan Esc dua kali atau jalankan /rewind untuk mundur ke checkpoint sebelum putaran yang memicu penolakan, kemudian rephrase atau ambil pendekatan yang berbeda. Lihat Checkpointing.
  • Jika Anda tidak dapat mengidentifikasi putaran mana yang menyebabkannya, jalankan /clear untuk memulai percakapan segar dalam proyek yang sama. Percakapan sebelumnya Anda dipertahankan di disk dan tetap tersedia di /resume.
  • Dalam mode non-interaktif (-p), di mana rewind tidak tersedia, coba lagi dengan prompt yang diubah atau mulai sesi baru tanpa --continue.

​
Responses seem lower quality than usual

Jika jawaban Claude tampak kurang mampu dari yang Anda harapkan tetapi tidak ada kesalahan yang ditampilkan, penyebabnya biasanya keadaan percakapan daripada model itu sendiri. Claude Code tidak secara diam-diam mengubah versi model. Ini dapat beralih ke model fallback dalam kasus spesifik seperti kuota Opus tercapai atau Bedrock atau Vertex AI region tidak memiliki model Anda; pemeriksaan Model selection di bawah menangkap keduanya, dan Model configuration menjelaskan kapan 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 di model yang lebih kecil dari yang Anda maksudkan.
  • Effort level: jalankan /effort untuk memeriksa tingkat penalaran saat ini dan naikkan untuk debugging atau pekerjaan desain yang sulit. Default bervariasi menurut model, jadi periksa sebelum menganggap Anda di bawah maksimum. Lihat Adjust effort level untuk default per-model dan pintasan ultrathink.
  • Context pressure: jalankan /context untuk melihat seberapa penuh jendela. Jika mendekati kapasitas, jalankan /compact pada titik istirahat alami atau /clear untuk memulai segar. Lihat Explore the context window untuk cara auto-compact mempengaruhi putaran sebelumnya.
  • Stale instructions: file CLAUDE.md besar atau usang dan definisi alat MCP mengonsumsi konteks dan dapat mengarahkan respons. /doctor menandai file memori yang terlalu besar dan definisi subagen; /context menunjukkan penggunaan token alat MCP.
Ketika respons salah, mundur biasanya bekerja lebih baik daripada membalas dengan koreksi. Tekan Esc dua kali atau jalankan /rewind untuk mundur ke sebelum putaran yang 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 normal 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.

​
Laporkan kesalahan

Halaman ini mencakup kesalahan dari Claude API. Untuk kesalahan dari komponen Claude Code lainnya, lihat panduan yang relevan: Jika kesalahan tidak tercantum di sini atau perbaikan yang disarankan tidak membantu:
  • Jalankan /feedback di dalam Claude Code untuk mengirim transkrip dan deskripsi ke Anthropic. Perintah juga menawarkan untuk membuka masalah GitHub yang sudah diisi sebelumnya. Pada Bedrock, Vertex AI, Foundry, dan penyedia pihak ketiga lainnya, /feedback menyimpan arsip lokal yang dapat Anda kirim ke perwakilan akun Anthropic Anda.
  • Jalankan /doctor untuk memeriksa masalah konfigurasi lokal
  • Periksa status.claude.com untuk insiden aktif
  • Cari masalah yang ada di GitHub