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.

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:

Kesalahan server

Kesalahan ini berasal dari infrastruktur Anthropic daripada akun atau permintaan Anda.

API Error: 500 Internal server error

Claude Code menampilkan badan respons API mentah untuk status 5xx apa pun. Contoh di bawah menunjukkan respons 500:

API Error: 500 {"type":"error","error":{"type":"api_error","message":"Internal server error"}} · check status.claude.com

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 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 · check status.claude.com

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

Yang harus dilakukan:

• Periksa status.claude.com 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:

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

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 status.claude.com.

Kalimat di akhir menyebutkan di mana memeriksa kesehatan layanan dan bervariasi menurut penyedia. Konfigurasi Bedrock dan Vertex AI menyebutkan status layanan penyedia itu daripada halaman status Anthropic.

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.

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:

• Minta admin Anda untuk mengaktifkan toggle Routines di claude.ai/admin-settings/claude-code
• Untuk pekerjaan terjadwal sekali pakai yang tidak memerlukan routines tingkat organisasi, lihat scheduled tasks

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

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:

• Konfigurasikan gateway Anda untuk meneruskan header anthropic-beta. Lihat Konfigurasi gateway LLM.
• 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.

There's an issue with the selected model

Nama model yang dikonfigurasi tidak dikenali atau akun Anda tidak memiliki akses ke sana.

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

Yang harus dilakukan:

• Jalankan /model untuk memilih dari model yang tersedia untuk akun Anda
• 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, 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. 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 untuk meningkatkan ke v2.1.111 atau lebih baru, kemudian restart Claude Code
• 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:

• Turunkan MAX_THINKING_TOKENS, atau naikkan CLAUDE_CODE_MAX_OUTPUT_TOKENS di atas anggaran pemikiran
• Lihat Pemikiran yang diperluas untuk cara anggaran berinteraksi dengan panjang output

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:

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

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:

• Server MCP gagal terhubung atau autentikasi: MCP
• Skrip hook gagal atau memblokir alat: Debug hooks
• Izin ditolak atau kesalahan filesystem selama instalasi: Troubleshooting installation and login

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