Claude Codeで529エラーが繰り返されるときの対処法
Claude Codeに API Error: Repeated 529 Overloaded errors と表示された場合、Anthropic APIが一時的に過負荷になっています。APIキーやプロジェクトのコードに問題があるという意味ではありません。
認証情報や設定を変える前に、まず少し待ってください。利用可能な処理容量はモデルごとに異なるため、あるモデルが使えなくても別のモデルは応答する場合があります。
429、500、529は異なるエラーです
| コード | 名前 | 意味 |
|---|---|---|
| 429 | rate_limit_error | APIキーまたはプロジェクトからのリクエストが多すぎる状態。併記されたメッセージを確認してください |
| 500 | api_error | Anthropicの内部システムエラー |
| 529 | overloaded_error | 一時的なAPI過負荷 |
429エラーが、必ずしも有料プランの利用枠超過を意味するわけではありません。You've hit your session/weekly limit はサブスクリプションセッションや週間制限を指します。Request rejected (429) はAPIキーまたはプロジェクトのレート制限を指します。Server is temporarily limiting requests (not your usage limit) は、アカウントの利用枠ではなく、サービス側が一時的に通信量を抑えていることを示します。
500エラーおよび529エラーの標準的な対応策は、待って再試行することです。
Repeated 529 が示す情報
Claude Codeは、過負荷、サーバーエラー、タイムアウト、一時的な429レスポンスに対して自動で再試行します。既定では指数バックオフで間隔を延ばしながら最大10回試しますが、環境変数で回数を変更できます。Repeated 529が表示されたままなら、自動再試行をすでに使い切っています。数分待ってから最後のプロンプトを再送してください。
エラーが続く場合は、Claudeのステータスページ を確認してください。「Elevated errors（エラー増加）」などの障害が掲載されている場合は、サービス側の復旧を待つ必要があります。Claude CodeがAmazon Bedrock、Google Cloud、Microsoft Foundry、またはカスタムゲートウェイを通じて接続している場合は、エラーに記載されたプロバイダーのステータスも確認してください。
他のモデルを使用する
ステータスページに広範な障害が出ていないのに、特定のモデルだけが繰り返し529を返す場合は、/model を入力し、他のオプションを試してください。たとえば、Opusが応答しない場合にSonnetやHaikuが応答するかどうかをテストしてください。
ステータスページに問題がないのにエラーが続く場合は、Claude Code内で /feedback を実行し、該当リクエストの情報をレポートに含めてください。APIを直接呼び出している場合は、レスポンスの request_id をサポートへの問い合わせに添えます。それまでは設定を変えず、再試行の間隔を広げてください。