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. {/* 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:

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.

Sebuah 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

The response above may be incomplete

Respons streaming gagal setelah Claude telah menghasilkan output yang terlihat. Mengirim kembali permintaan dapat menjalankan panggilan alat yang sama dua kali, jadi Claude Code menjaga apa yang sudah dialirkan dan menambahkan pemberitahuan ini daripada 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 kelebihan beban atau 5xx di tengah aliran. 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 dialirkan. Tidak ada yang hilang, tetapi kalimat atau panggilan alat terakhir mungkin hilang.
• Balas dengan continue untuk membuat Claude melanjutkan dari tempat itu berhenti
• Jika kesalahan yang sama muncul sebelum output yang terlihat, Claude Code mencoba ulang permintaan daripada menyelesaikannya. Lihat Percobaan ulang otomatis.

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

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 Batas penggunaan atau Kesalahan server, dan ikuti langkah-langkah bagian itu
• Setelah kesalahan yang mendasar hilang, minta Claude untuk mencoba ulang tugas atau resume subagent

Ketika batas laju, kelebihan beban, atau kesalahan server mengganggu subagent latar depan yang sudah menghasilkan output, Claude menerima output parsial itu ditandai sebagai tidak lengkap daripada kesalahan ini. Lihat Kesalahan API dalam subagent.

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.

Usage credits required for 1M context

Model yang dipilih menggunakan jendela konteks diperluas 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 mengompres 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 di Pro dan Max, atau untuk memintanya dari admin Anda di 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 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)

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

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

Could not resolve authentication method

Sesi mencapai klien API tanpa kredensial apa pun. Ini muncul di background sessions, 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 pra-inisialisasi 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 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 authentication setup
• Jalankan /status di sesi interaktif di lingkungan yang sama untuk mengonfirmasi sumber kredensial mana yang diselesaikan

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 API key authentication

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 dari 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 daripada /login, jadi menjalankan /login saja tidak membantu sementara salah satu masih menyuplai kunci. Lihat Authentication precedence.

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

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

Pemilik dalam organisasi 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 Pemilik dalam organisasi 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

Remote Control requires the Anthropic API

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

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

Ini muncul di Amazon Bedrock, Google Vertex AI, 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 LLM gateway 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 Anthropic API
• Untuk ini dan pesan startup Remote Control lainnya, lihat Troubleshoot Remote Control

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.

AWS credentials expired or invalid

{/* 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 itu bervariasi. Bagian stabil adalah AWS credentials expired or invalid di depan:

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 menampilkan pesan Please run /login generik 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 sign-in browser, kemudian coba ulang
• Dalam sesi interaktif, jalankan /login, pilih 3rd-party platform, kemudian pilih Claude Platform on AWS · refresh credentials di bawah Using 3rd-party platforms untuk menjalankan perintah yang sama tanpa memulai ulang Claude Code. Lihat Configure AWS credentials
• Jika kesalahan berulang setelah perintah refresh berhasil, konfirmasi identitas valid di luar Claude Code dengan aws sts get-caller-identity di shell dan profil yang sama

AWS authentication failed

{/* 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 mengatakan penyebab mana yang Anda alami. Amazon Bedrock melaporkan token keamanan yang kedaluwarsa sebagai 403, tetapi 403 juga merupakan cara itu melaporkan penolakan otorisasi, seperti AccessDeniedException dari izin IAM yang hilang atau model yang tidak diaktifkan untuk akun Anda.

401 dari Amazon Bedrock juga mendarat di sini daripada di bawah AWS credentials expired or invalid, karena Bedrock tidak melaporkan token yang kedaluwarsa sebagai 401. 401 dari endpoint itu biasanya berasal dari sesuatu yang lain dalam 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 itu bervariasi. Bagian stabil adalah AWS authentication failed di depan.

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 IAM configuration dilampirkan pada identitas yang Anda gunakan dan model yang dipilih diaktifkan untuk akun dan wilayah Anda
• Jalankan aws sts get-caller-identity untuk mengonfirmasi identitas mana yang digunakan permintaan Anda; AWS_PROFILE basi atau profil default adalah penyebab umum ketidakcocokan izin

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 Connect Claude Code to an LLM gateway 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

{/* min-version: 2.1.199 */}Mulai dari v2.1.199, kegagalan validasi sertifikat tidak dicoba ulang, jadi kesalahan ini muncul pada percobaan pertama daripada setelah anggaran percobaan ulang penuh. Versi sebelumnya menghabiskan beberapa menit mencoba ulang sebelum menampilkannya. Kondisi TLS transien, 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 /doctor for details.

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

{/* 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 putaran 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 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:

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

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 Model configuration.
• 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 Vertex AI troubleshooting.

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

Model is restricted by your organization's settings

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

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

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 dari file pengaturan, hapus atau perbarui nilai tersebut sehingga pemberitahuan tidak berulang pada setiap peluncuran
• Jika Anda memerlukan akses ke model yang dibatasi, minta admin organisasi Anda untuk mengaktifkannya. Lihat Organization model restrictions.

thinking.type.enabled is not supported for this model

Versi Claude Code Anda lebih lama dari minimum untuk Sonnet 5, Opus 4.8, atau 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 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 meningkatkan, 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, tingkatkan paket SDK sebagai gantinya. Opus 4.8 memerlukan TypeScript SDK v0.3.154 atau lebih baru dan Python SDK v0.2.88 atau lebih baru. Sonnet 5 memerlukan TypeScript SDK v0.3.197 atau lebih baru

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 Extended thinking 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:

• {/* 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 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. Pemeriksaan kebijakan bervariasi menurut model, jadi beralih ke model yang berbeda dengan --model juga dapat menyelesaikan penolakan dalam beberapa kasus.

Kesalahan baris perintah

Kesalahan ini berasal dari validasi Claude Code sendiri dari baris perintah claude. Claude Code mencetaknya segera, sebelum membuat sesi atau mengirim permintaan API apa pun.

Conflict between --bg and --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 background session yang Anda kemudian 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:

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

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 tiga kasus spesifik:

• Sebuah --fallback-model yang dikonfigurasi mengambil alih setelah kesalahan ketersediaan, untuk giliran itu saja, dengan pemberitahuan dalam transkrip
• Pemeriksaan startup Bedrock atau Vertex AI menemukan model default Anda tidak tersedia
• Automatic model fallback 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. Model configuration menjelaskan kapan setiap fallback berlaku.

Periksa ini terlebih dahulu:

• Model selection: jalankan /model untuk mengonfirmasi Anda berada di model yang Anda harapkan. Pilihan /model sebelumnya atau variabel lingkungan ANTHROPIC_MODEL mungkin membuat Anda 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

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

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

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

• Jalankan /feedback di dalam Claude Code untuk 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