コーディング中のレート制限
アカウント、ワークスペース、モデル、ルートが許可範囲を超えるリクエストまたは Token を送信しています。
並列 Agent の数を減らす · 長いコンテキストを短縮Claude Code API トラブルシューティング
Claude Code のレート制限、500、529 overload、API Key の混乱を解決
API Key 設定、Pro・Max と API 請求の違い、Messages 互換エンドポイント、レート制限、サーバーエラー、過負荷ルートを確認する統合手順です。
claude-code-diagnostics
$ claude-code run --model claude-sonnetAPI Error: レート制限に達しましたstatus=429 route=messages tokens=128k retries=3次の手順: 同時実行数を減らし、Key を確認してバックオフ再試行
4 エラー分類1 手順0 内容の薄いページ
コミュニティの情報
開発者が公開の場で繰り返し尋ねること
Reddit と X で繰り返される話題を、安定して検証できる診断手順に整理しています。
API Key と Pro・Max サブスクリプションの違い
使用中の Key、Base URL、請求元を確認してください。サブスクリプションと API クレジットが同じ残高だと判断しないでください。
モデルアクセスを確認 · サブスクリプションログインと API 請求を分けるAgent ループでの 500・529 エラー
プロバイダーまたはルートがサーバー側エラーを返しました。1回の再試行は有効ですが、繰り返す場合はルーティング情報が必要です。 上流サービスの負荷が高い状態です。通常、API Key の変更では解決しません。
request id を記録 · バックオフエラーマップ
噂ではなくステータスコードから確認
Key、クォータ、サーバーエラー、過負荷を切り分けることが最短の解決方法です。
429
レート制限に到達
アカウント、ワークスペース、モデル、ルートが許可範囲を超えるリクエストまたは Token を送信しています。
- 並列 Agent の数を減らす
- 長いコンテキストを短縮
- バックオフして再試行
- 現在のクォータとモデル制限を確認
500
API サーバーエラー
プロバイダーまたはルートがサーバー側エラーを返しました。1回の再試行は有効ですが、繰り返す場合はルーティング情報が必要です。
- request id を記録
- 1回だけ再試行
- 繰り返す場合はルートを変更
- 最初からプロンプトを書き換えない
529
過負荷
上流サービスの負荷が高い状態です。通常、API Key の変更では解決しません。
- バックオフ
- 代替モデルを使用
- リクエストサイズを削減
- サポートやステータス情報を確認
401/403
API Key または権限の問題
Claude Code が想定した Key を使用していないか、要求したモデルまたはエンドポイントへの権限がありません。
- ANTHROPIC_API_KEY を確認
- Base URL を確認
- モデルアクセスを確認
- サブスクリプションログインと API 請求を分ける
確認手順
コードを変更する前に情報を収集
- 正確なエラー文、HTTP ステータス、モデル、エンドポイント、時刻を記録します。
- Claude Code が Anthropic の直接 Key と互換ゲートウェイの Base URL のどちらを使っているか確認します。
- API Key の請求とクォータを Claude Pro・Max の状態とは別に確認します。
- 429 ではプロバイダーを変える前に同時実行数とコンテキスト量を減らします。
- 500 または 529 ではバックオフして1回再試行し、別ルートか代替モデルと比較します。
- ゲートウェイでは Messages 互換エンドポイント、モデルルート、キャッシュ、サポートページを確認します。
Pro・Max と API 請求は別です
使用中の Key、Base URL、請求元を確認してください。サブスクリプションと API クレジットが同じ残高だと判断しないでください。
API アクセスを取得ゲートウェイ利用時は Messages エンドポイントを確認
Claude Code 系クライアントには通常、Messages 互換エンドポイント、有効な API Key、対応モデルルートが必要です。
ドキュメントを開くFAQ
Claude Code API エラー
Claude Code がレート制限に達したと表示する理由は？
アカウント、ワークスペース、モデル、ルートが許可範囲を超えるリクエストまたは Token を送信しています。 並列 Agent の数を減らす · 長いコンテキストを短縮 · バックオフして再試行 · 現在のクォータとモデル制限を確認
Claude Pro・Max に API Key は含まれますか？
使用中の Key、Base URL、請求元を確認してください。サブスクリプションと API クレジットが同じ残高だと判断しないでください。
API Error 500 の対処方法は？
プロバイダーまたはルートがサーバー側エラーを返しました。1回の再試行は有効ですが、繰り返す場合はルーティング情報が必要です。 request id を記録 · 1回だけ再試行 · 繰り返す場合はルートを変更 · 最初からプロンプトを書き換えない
529 overloaded とは？
上流サービスの負荷が高い状態です。通常、API Key の変更では解決しません。 バックオフ · 代替モデルを使用 · リクエストサイズを削減 · サポートやステータス情報を確認
情報源
現在のルールを確認する場所
制限やエラーの意味は公式ドキュメントで確認してください。コミュニティの議論は需要を示しますが、正式な情報源ではありません。