Claude Code 529 Overloaded: nedenleri, yeniden deneme ayarları ve çözümleri

Wokey Team · 2026-09-24

Kısa cevap: 529, upstream modelin şu anda kapasitesinin dolduğu ("overloaded", aşırı yüklü) anlamına gelir. Bakiyenizle, kotanızla veya API anahtarınızla ilgisi yoktur. Claude Code bu hatayı göstermeden önce zaten birkaç kez yeniden denemiştir. En hızlı çözüm /model ile model değiştirmektir, çünkü kapasite model bazında izlenir. Aceleniz yoksa birkaç dakika bekleyip yeniden gönderin.

Hatanın tam metni

Claude Code'da şunu görürsünüz:

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.

Claude Code dokümantasyonu bu hata hakkında üç noktaya değinir:

• Tüm kullanıcıları etkileyen geçici bir kapasite sorunudur.
• Claude Code hatayı göstermeden önce birkaç kez yeniden denemiştir.
• 529 sizin kullanım limitiniz değildir ve kotanızdan düşmez.

ANTHROPIC_BASE_URL ile bir gateway üzerinden bağlandığınızda son cümlede status.claude.com yerine gateway'in host adı yazar.

Wokey'de 529 nereden gelir

Wokey kendisi asla 529 üretmez; bu durum kodu her zaman upstream modelden gelir. Wokey bunu üç adımda ele alır:

1. Upstream aşırı yük bildirdiğinde (örneğin Anthropic'in overloaded_error hatası), Wokey önce isteğinizi aynı model için başka bir upstream rotasında yeniden dener. Bunu siz görmezsiniz.

2. Wokey upstream durum kodunu ancak yeniden deneme de aşırı yüklüyse iletir. HTTP durumu 529 olarak kalır. Gövde, Wokey'nin standart hata biçimini kullanır ve upstream'in kendi ifadesi message alanında yer alır:

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

3. Aşırı yük, yanıtın streaming'i başladıktan sonra oluşursa HTTP 529 olarak değil, akış içinde bir error olayı olarak gelir.

Yani Wokey üzerinden gelen bir 529, aynı model için birkaç upstream rotasının aynı anda aşırı yüklü olduğu anlamına gelir; bu genellikle model sağlayıcısının yoğun saatlerinde olur. Bu yanıtlarda Retry-After başlığı bulunmaz; istemciniz kendi backoff takvimine göre yeniden dener.

Diğer hatalardan ayırt etmek

Yalnızca 529 ve 503 "upstream meşgul" anlamına gelir. Diğerleri sizin tarafınızda bir işlem gerektirir.

Ne yapmalı

1. Bekleyip yeniden gönderin. Aşırı yük genellikle dakikalar içinde geçer ve Claude Code'un otomatik yeniden denemeleri kısa süreli sıçramaları zaten karşılar.

2. /model ile model değiştirin. Kapasite model bazında izlenir; bu yüzden Opus aşırı yüklüyken Sonnet çoğu zaman çalışmaya devam eder. Oturumda /model komutunu çalıştırıp başka bir model seçin; yeniden başlatmaya gerek yoktur.

3. Gözetimsiz uzun işlerde daha ısrarlı yeniden deneyin. ~/.claude/settings.json dosyasındaki env bloğuna şunu ekleyin:

{
  "env": {
    "CLAUDE_CODE_RETRY_WATCHDOG": "1"
  }
}

• CLAUDE_CODE_RETRY_WATCHDOG=1, Claude Code'un 429 ve 529 hatalarını süresiz olarak yeniden denemesini sağlar; denemeler arasındaki bekleme 5 dakikaya kadar çıkar. Gece boyunca çalışmaya bırakılan işler için uygundur.
• Yalnızca birkaç deneme daha istiyorsanız bunun yerine CLAUDE_CODE_MAX_RETRIES değerini ayarlayın. Varsayılanı 10, üst sınırı 15'tir.

4. Kendi kodunuzda 529'ları yeniden denemek için pay bırakın. Resmi Anthropic SDK'ları 529 dahil 5xx hatalarını varsayılan olarak iki kez yeniden dener. Toplu işlerde max_retries değerini yükseltin ve çağrının etrafına exponential backoff ekleyin.

Codex'te 529 görmek

Codex, 529 dahil 5xx hatalarını yeniden denenebilir sayar:

• HTTP katmanı varsayılan olarak 4 kez yeniden dener (provider'ın request_max_retries değeri).
• Ardından akış katmanı 5 kez daha yeniden dener (stream_max_retries).
• Hepsi başarısız olursa hata unexpected status 529 ile başlar ve ardından yanıt gövdesi gelir.

Bu gövdedeki upstream_overloaded değerli code, yukarıda anlatılan upstream aşırı yükü demektir. Çözüm aynıdır: bekleyin veya config.toml içinde modeli değiştirin. Codex kurulumunun tamamı için Codex config.toml rehberine bakın.