Claude Codeで、次のようなメッセージが表示されて応答が返ってこないことがあります。
API Error: 500 Internal server error
API Error: Repeated 529 Overloaded errorsAPI本体が返す500は内部障害、Repeated 529は混雑による失敗です。ただし、独自のプロキシやゲートウェイが返す5xxは、その中継経路も切り分ける必要があります。
公式ドキュメントにもサーバー側の問題である旨が明記されています。
500 Internal server error
APIの内部で予期しないエラーが発生している状態です。
実際には、末尾に稼働状況の確認先URLが添えられて表示されます。
API Error: 500 Internal server error. This is a server-side issue, usually temporary
— try again in a moment. If it persists, check https://status.claude.com.この末尾に表示される案内先は、接続先のプロバイダによって異なります。
Amazon Bedrock、Google CloudのAgent Platform、Microsoft Foundryを利用している場合は、それぞれのステータスページが表示されます。
ANTHROPIC_BASE_URLで独自のプロキシやゲートウェイを指定している場合は、そのホスト名が表示されます。
529 Overloaded
リクエスト集中により、API全体の処理容量が一時的に上限へ達している状態です。
「Repeated 529」と表示された時点では、Claude Codeがすでに複数回再試行しています。単独の529表示を、必ず複数回試行した証拠とはみなさないでください。
自動再試行を繰り返しても応答を得られなかったことを意味します。
529では数分待ってから再送するか、CLIなら/model、Desktopアプリ内ならモデル選択欄で、利用できる別モデルへの変更を検討します。
変更先のモデルの利用権限や使用枠は、別途確認してください。
エラー発生時の対処法
- Claudeの稼働状況、またはメッセージに示されたサービス状態のページで障害情報を確認する
- 500なら1分ほど、529なら数分待ってから再送する
- 障害情報が出ていないのに繰り返す場合は /feedback で報告する
Claude Code上で再試行する際は、手入力の手間を省く方法があります。
直前の入力内容はセッション上に保持されているため、長いプロンプトを再度貼り直す必要はありません。
try again会話が保持された同じセッションでは、このように再試行を依頼できます。専用コマンドではありません。途中までツール操作が進んでいる場合は、外部更新やファイル変更が重複しないよう実行済み範囲を先に確認してください。
ブラウザ版の混雑エラーとの見分け方
Webブラウザ版Claudeで表示される「Due to unexpected capacity constraints」も混雑を示す警告ですが、公式には一時的な高負荷として扱われ、システム障害とはみなされません。
そのため、公式ステータスページにも障害情報としては掲載されません。
一方で、500系エラーはシステム側の不具合に起因するため、影響範囲が広い場合はステータスページに障害情報が掲載されます。
ステータスページに障害情報がなくてもサービス側の問題は否定できないため、接続先と中継経路を確認してください。
独自ゲートウェイで毎回5xxになる場合は、公式のTool Search切り分け手順に従い、シェルかsettings.jsonのenvでENABLE_TOOL_SEARCH=falseを設定して再試行します。
この設定ではMCPツールを最初から読み込むため、エラーが解消してもコンテキスト使用量が増える点を確認してください。
ほかのエラーメッセージの詳細はClaudeのエラーメッセージ一覧、利用制限の仕様についてはClaudeの利用制限まとめに詳しくまとめています。
この記事は2026年10月27日に、Claude Code公式ドキュメントのエラーリファレンスを再照合して更新しています。
Claude Codeのエラー対処は、ほかにも書いています。
よくある質問：500 Internal server errorと529 Overloaded
「500 Internal server error」が出たら、自分の設定が原因ですか？
API本体が返した内部障害と、プロキシやゲートウェイが返した応答を区別します。
API本体の5xxはサーバー内部の失敗として案内されています。ただし、独自ゲートウェイ経由で毎回失敗する場合は、接続先やTool Searchのフィールドへの対応も確認対象です。
500は、APIの内部で予期しないエラーが発生している状態です。
エラーの末尾に出るURLは、何ですか？
稼働状況の確認先URLです。
末尾の案内先は、接続先のプロバイダによって異なり、Amazon Bedrock、Google CloudのAgent Platform、Microsoft Foundryを利用している場合は、それぞれのステータスページが表示されます。
ANTHROPIC_BASE_URL で独自のプロキシやゲートウェイを指定している場合は、そのホスト名が表示されます。
「529 Overloaded」とは、何ですか？
リクエスト集中により、API全体の処理容量が一時的に上限へ達している状態です。
「Repeated 529」は、すでに複数回再試行しても成功しなかったという表示です。529は個人の利用枠を使い切ったエラーとは異なります。
529では数分待ってから再送するか、CLIなら/model、Desktopアプリ内ならモデル選択欄で、利用できる別モデルへの変更を検討します。
変更先のモデルの利用権限や使用枠は、別途確認してください。
エラーが出たときは、どう対処しますか？
メッセージに示された稼働状況を確認し、500なら1分ほど、529なら数分待ってから再送します。
障害情報が出ていないのに繰り返す場合は、/feedback で報告します。
再試行するとき、長いプロンプトを貼り直す必要がありますか？
ありません。
同じセッションに元の依頼が残っていれば、短い言葉で再試行を依頼できます。ただし実行済みのツール操作や外部更新を先に確認し、重複実行を避けます。
ブラウザ版の「Due to unexpected capacity constraints」とは、同じものですか？
同じではありません。
Webブラウザ版Claudeで表示されるこのメッセージも混雑を示す警告ですが、公式には一時的な高負荷として扱われ、システム障害とはみなされないため、公式ステータスページにも障害情報としては掲載されません。
一方で、500系エラーはシステム側の不具合に起因するため、影響範囲が広い場合は、ステータスページに障害情報が掲載されます。
ステータスページに障害が出ていないのに、エラーが続くときは？
接続先のAPI・プロバイダ・独自ゲートウェイを区別して調べます。ステータスページ未掲載だけでローカルの問題だとは判断しません。
それでも繰り返すなら、/feedback で報告します。
記事の確認時点と、関連情報は？
記事は、2026年10月27日に、Claude Code公式ドキュメントのエラーリファレンスを再照合して更新しています。
ほかのエラーメッセージの詳細は、Claudeのエラーメッセージ一覧、利用制限の仕様は、Claudeの利用制限まとめにあります。
表示や仕様は変わるため、最新は公式ドキュメントで確認してください。今回は本文と資料の照合であり、500・529の実機再現、各プロバイダ・ゲートウェイでの再試行、画面表示は検証していません。
