Penyelesaian masalah Claude Code API

Baiki had, ralat 500, beban lampau 529 dan kekeliruan API Key

Satu panduan untuk tetapan API Key, Pro atau Max berbanding pengebilan API, endpoint serasi Messages, had kadar, ralat pelayan dan laluan yang terlebih beban.

Pilih laluan Claude Code APIBaca dokumentasi endpoint
claude-code-diagnostics
$ claude-code run --model claude-sonnetRalat API: had kadar dicapaistatus=429 route=messages tokens=128k retries=3seterusnya: kurangkan serentak, sahkan key, cuba semula dengan backoff
4 keluarga ralat1 panduan0 halaman nipis
Isyarat komuniti

Perkara yang berulang kali ditanya oleh pembangun secara terbuka

Corak berulang dari Reddit dan X dijadikan petunjuk diagnosis yang stabil dan boleh disahkan.

Reddit

Had kadar dicapai semasa sesi kod

Akaun, workspace, model atau laluan menghantar lebih banyak permintaan atau token daripada yang dibenarkan.

Kurangkan ejen selari · Pendekkan konteks
Reddit

API Key berbanding langganan Pro atau Max

Semak key aktif, Base URL dan sumber pengebilan. Jangan anggap langganan dan kredit API berkongsi baki.

Semak akses model · Asingkan log masuk langganan dan pengebilan API
X / Reddit

Ralat 500 atau 529 dalam gelung ejen

Penyedia atau laluan mengembalikan kegagalan pelayan. Satu cubaan mungkin berjaya; kegagalan berulang memerlukan bukti laluan. Perkhidmatan upstream sedang menanggung beban tinggi. Menukar API Key biasanya tidak menyelesaikannya.

Catat request id · Gunakan backoff
Peta ralat

Mulakan dengan kod status, bukan khabar angin

Cara terpantas ialah memisahkan masalah key, kuota, pelayan dan beban lampau.

429

Had kadar dicapai

Akaun, workspace, model atau laluan menghantar lebih banyak permintaan atau token daripada yang dibenarkan.

  • Kurangkan ejen selari
  • Pendekkan konteks
  • Cuba semula dengan backoff
  • Semak kuota dan had model
500

Ralat pelayan API

Penyedia atau laluan mengembalikan kegagalan pelayan. Satu cubaan mungkin berjaya; kegagalan berulang memerlukan bukti laluan.

  • Catat request id
  • Cuba semula sekali
  • Tukar laluan jika berulang
  • Jangan mulakan dengan menulis semula prompt
529

Beban lampau

Perkhidmatan upstream sedang menanggung beban tinggi. Menukar API Key biasanya tidak menyelesaikannya.

  • Gunakan backoff
  • Guna model sandaran
  • Kecilkan permintaan
  • Semak saluran sokongan/status
401/403

Masalah API Key atau kebenaran

Claude Code tidak menggunakan key yang dijangka atau key tiada akses kepada model atau endpoint.

  • Sahkan ANTHROPIC_API_KEY
  • Semak Base URL
  • Semak akses model
  • Asingkan log masuk langganan dan pengebilan API
Panduan

Kumpulkan fakta ini sebelum mengubah kod

  1. Catat teks ralat tepat, status HTTP, model, endpoint dan masa.
  2. Sahkan sama ada Claude Code menggunakan key Anthropic terus atau Base URL gateway serasi.
  3. Semak pengebilan dan kuota API secara berasingan daripada status Claude Pro atau Max.
  4. Untuk 429, kurangkan serentak dan saiz konteks sebelum menukar penyedia.
  5. Untuk 500 atau 529, cuba semula sekali dengan backoff kemudian bandingkan laluan atau model sandaran.
  6. Jika menggunakan gateway, sahkan endpoint serasi Messages, laluan model, cache dan halaman sokongan.

Pro atau Max tidak sama dengan pengebilan API

Semak key aktif, Base URL dan sumber pengebilan. Jangan anggap langganan dan kredit API berkongsi baki.

Dapatkan akses API

Guna gateway? Sahkan endpoint Messages

Klien seperti Claude Code biasanya memerlukan endpoint serasi Messages, API Key sah dan laluan model yang menyokong beban kerja.

Semak dokumentasi
Soalan lazim

Ralat Claude Code API

Mengapa Claude Code menyatakan had kadar dicapai?

Akaun, workspace, model atau laluan menghantar lebih banyak permintaan atau token daripada yang dibenarkan. Kurangkan ejen selari · Pendekkan konteks · Cuba semula dengan backoff · Semak kuota dan had model

Adakah Claude Pro atau Max menyertakan API Key?

Semak key aktif, Base URL dan sumber pengebilan. Jangan anggap langganan dan kredit API berkongsi baki.

Apa perlu dibuat untuk ralat API 500?

Penyedia atau laluan mengembalikan kegagalan pelayan. Satu cubaan mungkin berjaya; kegagalan berulang memerlukan bukti laluan. Catat request id · Cuba semula sekali · Tukar laluan jika berulang · Jangan mulakan dengan menulis semula prompt

Apakah maksud beban lampau 529?

Perkhidmatan upstream sedang menanggung beban tinggi. Menukar API Key biasanya tidak menyelesaikannya. Gunakan backoff · Guna model sandaran · Kecilkan permintaan · Semak saluran sokongan/status

Sumber

Tempat mengesahkan peraturan semasa

Gunakan dokumentasi rasmi untuk had dan maksud ralat. Perbincangan komuniti menunjukkan permintaan, bukan sumber kebenaran.

Pengesahan Claude CodeRalat Anthropic APIHad Anthropic APIPerbincangan had Claude Code di RedditCarian had Claude Code di X