Claude Code 529 Overloaded: penyebab, pengaturan percobaan ulang, dan cara mengatasinya

Wokey Team · 2026-09-24

Jawaban singkat: 529 berarti model upstream sedang kehabisan kapasitas saat ini ("overloaded", kelebihan beban). Ini tidak ada hubungannya dengan saldo, kuota, atau API key Anda. Claude Code sudah mencoba ulang beberapa kali sebelum menampilkan error ini. Cara tercepat adalah berganti model dengan /model, karena kapasitas dihitung per model. Jika tidak terburu-buru, tunggu beberapa menit lalu kirim lagi.

Teks error persisnya

Di Claude Code Anda melihat:

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.

Dokumentasi Claude Code menyebutkan tiga hal tentang error ini:

  • Ini masalah kapasitas sementara yang dialami semua pengguna.
  • Claude Code sudah mencoba ulang beberapa kali sebelum menampilkannya.
  • 529 bukan batas penggunaan Anda dan tidak mengurangi kuota Anda.

Jika Anda terhubung lewat gateway dengan ANTHROPIC_BASE_URL, kalimat terakhir menyebut host gateway, bukan status.claude.com.

Dari mana 529 berasal di Wokey

Wokey tidak pernah menghasilkan 529 sendiri; status ini selalu berasal dari model upstream. Wokey menanganinya dalam tiga langkah:

  1. Saat upstream melaporkan kelebihan beban (misalnya overloaded_error dari Anthropic), Wokey lebih dulu mencoba ulang permintaan Anda lewat rute upstream lain untuk model yang sama. Anda tidak melihat proses ini.

  2. Hanya jika percobaan ulang itu juga kelebihan beban, Wokey meneruskan status upstream. Status HTTP tetap 529. Body memakai format error standar Wokey, dengan kalimat asli upstream di message:

    {"error":{"code":"upstream_overloaded","message":"Overloaded","type":"invalid_request_error"}}

  3. Jika kelebihan beban terjadi setelah balasan mulai di-streaming, ia datang sebagai event error di dalam stream, bukan sebagai HTTP 529.

Jadi 529 lewat Wokey berarti beberapa rute upstream untuk model yang sama kelebihan beban sekaligus, biasanya saat jam sibuk di sisi penyedia model. Respons ini tidak membawa header Retry-After; klien Anda mencoba ulang dengan jadwal backoff-nya sendiri.

Membedakannya dari error lain

Status code Wokey Arti Yang perlu dilakukan
529 upstream_overloaded Model upstream kelebihan beban Tunggu beberapa menit atau ganti model
503 upstream_unavailable, model_unavailable, dan lainnya Saat ini tidak ada rute upstream yang tersedia Coba lagi nanti atau ganti model
429 rate_limit_exceeded dan lainnya Terlalu banyak permintaan; Anda terkena rate limit Turunkan konkurensi Anda
402 insufficient_balance Saldo akun Anda habis Isi saldo
402 api_key_usage_limit_exceeded Batas pengeluaran API key ini sudah habis Naikkan atau hapus batas key di konsol
401 invalid_api_key Key tidak ada atau salah Periksa key

Hanya 529 dan 503 yang berarti "upstream sedang sibuk". Yang lain butuh tindakan dari sisi Anda.

Yang perlu dilakukan

1. Tunggu lalu kirim ulang. Kelebihan beban biasanya hilang dalam hitungan menit, dan percobaan ulang otomatis Claude Code sudah menutup lonjakan singkat.

2. Ganti model dengan /model. Kapasitas dihitung per model, jadi saat Opus kelebihan beban, Sonnet sering kali masih berjalan. Jalankan /model di sesi dan pilih model lain; tidak perlu memulai ulang.

3. Untuk pekerjaan panjang tanpa pengawasan, perbanyak percobaan ulang. Tambahkan ini ke blok env di ~/.claude/settings.json:

{
  "env": {
    "CLAUDE_CODE_RETRY_WATCHDOG": "1"
  }
}
  • CLAUDE_CODE_RETRY_WATCHDOG=1 membuat Claude Code mencoba ulang error 429 dan 529 tanpa batas, dengan jeda backoff hingga 5 menit di antara percobaan. Cocok untuk pekerjaan yang dibiarkan berjalan semalaman.
  • Jika hanya butuh beberapa percobaan tambahan, atur CLAUDE_CODE_MAX_RETRIES saja. Nilai bawaannya 10 dan maksimalnya 15.

4. Di kode Anda sendiri, sediakan ruang untuk mencoba ulang 529. SDK resmi Anthropic secara bawaan mencoba ulang error 5xx, termasuk 529, sebanyak dua kali. Untuk pekerjaan batch, naikkan max_retries dan tambahkan exponential backoff di sekitar pemanggilan.

Melihat 529 di Codex

Codex memperlakukan error 5xx, termasuk 529, sebagai error yang bisa dicoba ulang:

  • Lapisan HTTP secara bawaan mencoba ulang 4 kali (request_max_retries milik provider).
  • Lapisan stream kemudian mencoba ulang hingga 5 kali lagi (stream_max_retries).
  • Jika semuanya gagal, error diawali unexpected status 529, diikuti body respons.

code bernilai upstream_overloaded di body itu berarti kelebihan beban upstream seperti dijelaskan di atas. Solusinya sama: tunggu, atau ganti model di config.toml. Untuk penyiapan Codex selengkapnya, lihat panduan Codex config.toml.

Pertanyaan umum

Apakah 529 berarti kuota saya habis?

Tidak. 529 berarti model upstream sedang kelebihan beban saat ini; tidak ada hubungannya dengan saldo atau kuota Anda dan biasanya bersifat sementara. Di Wokey, saldo tidak cukup adalah 402 insufficient_balance dan rate limit adalah 429.

Apakah Claude Code mencoba ulang 529 secara otomatis?

Ya, secara bawaan hingga 10 kali; Anda baru melihat Repeated 529 Overloaded errors setelah semuanya gagal. Ubah jumlahnya dengan CLAUDE_CODE_MAX_RETRIES (maksimal 15), atau atur CLAUDE_CODE_RETRY_WATCHDOG=1 agar 429 dan 529 dicoba ulang tanpa batas.

Apakah Wokey mengembalikan 529?

Wokey tidak pernah menghasilkan 529 sendiri. Saat upstream melaporkan kelebihan beban, gateway lebih dulu mencoba ulang dengan kredensial lain, dan hanya jika semuanya gagal status upstream diteruskan, dengan code bernilai upstream_overloaded.

Bagaimana jika saya terus mendapat 529?

Tunggu sebentar lalu coba lagi. Jika mendesak, ganti model dengan /model; kelebihan beban biasanya hanya mengenai satu model pada satu waktu. Dengan SDK, naikkan max_retries.