529は、あなたのプログラムが原因ではない唯一のClaudeエラーです。過負荷なのはAnthropic側です。修正はできませんが、指数バックオフ付きの辛抱強いリトライ、遅延に敏感な経路のフォールバックモデル、そして障害を拡大する即時リトライの連打を避けることで、適切に受け止められます。
エラー
{
"type": "error",
"error": { "type": "overloaded_error",
"message": "Overloaded" }
}原因と対処法の概要
| 原因 | 対処法 |
|---|---|
| プロバイダー側の過負荷（新モデルの発表日、地域障害）。すべての顧客が同時に影響を受けます。 | ジッター付きのバックオフ待機を使いましょう。自分のアプリケーションを再デプロイするのではなく、Anthropicのステータスページを確認します。 |
| 自分のピーク時トラフィックが、すでに逼迫している容量にちょうど衝突しています。 | バッチ処理を時間的に分散させましょう。通常は10分遅らせれば解消します。 |
| 429と混同することです。ログ上では両者がよく似ていますが、原因はまったく異なります。 | 429は自分の上限を超えた状態（サーバーは正常）です。529はサーバー自体が過負荷の状態（あなたの利用枠は問題なし）です。Retry-Afterが付くのは429だけです。 |
| フォールバックを定義していないため、プロバイダーの問題がそのままエンドユーザーに届いてしまいます。 | あらかじめフォールバックの順序を決めておきましょう。同じ系列（Sonnet → Haiku）なら挙動が近く、プロバイダーをまたぐ構成（Claude → GPT）なら、プロバイダー全体の障害にも耐えられます。 |
リトライで障害を拡大させない
529は「Retry-Afterのない429」として扱います。約2秒から始める指数バックオフにジッターを加え、上限を30〜60秒に設定し、約5回で諦めて処理をキューに入れます。本当に効果があるのはジッターの部分です。これがないと、すべてのクライアントが同じ瞬間に戻ってきて、逃れようとしていた輻輳をそのまま長引かせます。
倒れずに、迂回する
遅延に敏感な経路では、フォールバックチェーンを先に定義しておきます。OpenAI互換エンドポイントなら、文字列を1つ変更するだけです。別のSDKを接続する必要も、別のアカウントを開く必要もありません。
PREFERRED = ["claude-sonnet-5", "claude-haiku-4-5", "gpt-5-6-terra"]
def complete(messages):
last = None
for model in PREFERRED:
try:
return client.chat.completions.create(
model=model, messages=messages, max_tokens=800)
except APIStatusError as e:
if e.status_code not in (429, 500, 529):
raise
last = e # 過載 —— 試下一個
raise last最後に自分のプログラムを疑う
特定の種類のリクエストだけが529になり、同じ時間帯の他の呼び出しが成功しているなら、全面的な障害ではありません。その経路が異常に大きなプロンプトを送っていないか、短いループ内で連続送信していないかを確認します。逆に、すべての呼び出しが同時に529になり、しばらくすると自然に回復するなら、原因は容量です。変更すべきなのはリトライとフォールバックであり、リファクタリングではありません。
Kunavo経由で呼び出している場合
KunavoはClaudeを複数の上流経路に分散し、マルチモデルディレクトリによって、プロバイダーをまたぐフォールバックを「同じキー、同じ残高で、モデル名だけを変更する」形にします。上記のコードに2つ目のアカウントは必要ありません。529が手元まで届いた場合でも、いずれも課金されません。 容量と価格は別の問題です。後者については、各モデルの単価が Claude API料金表.
よくある質問
529は私の問題ですか？
いいえ。これはプロバイダー側の容量問題です。あなたの責任は2つだけです。障害を拡大しないこと（バックオフとジッター）、そして障害が自分の遅延予算を超えて続いたときに迂回できる場所を用意することです。
529と429の違いは何ですか？
429は自分の上限を超えた状態で、サーバーは正常です。529はサーバー自体が過負荷で、あなたの利用枠は問題ありません。どちらもリトライできますが、Retry-Afterが付くのは429だけです。
529は通常どのくらい続きますか？
予測できず、保証もできません。そのため、正しい答えは、プログラムに待機時間を固定することではなく、「上限付きのバックオフとキュー」です。その経路に遅延予算があるなら、待つのではなくフォールバックが引き継ぐべきです。
529で失敗した呼び出しは課金されますか？
Kunavo経由なら課金されません。エラーで終了したリクエストは課金対象外です。プロバイダーと直接契約している場合は、各社の課金ルールに従います。