Claude Code のレート制限、500、529 過負荷、API キーの疑問を解決
API キー設定、Pro・Max と API 請求の違い、Messages 互換エンドポイント、レート制限、サーバーエラー、経路の過負荷を扱う調査ガイドです。
エラー調査で確認したい問い
コミュニティの議論は調査の手掛かりです。実際の制限、アカウント状態、エラーの意味は公式資料とリクエストログで確認してください。
開発中にレート制限へ到達
制限の発生元はアカウント、ワークスペース、モデル経路、ゲートウェイのどれですか？
アカウントの制限を確認し、並列数とコンテキストを減らして再試行します。API キーと Pro・Max のサブスクリプション
現在の認証はサブスクリプションの利用枠ですか、それとも API 請求ですか？
提供元が明示的に関連付けていない限り、利用枠と API 請求を別々に確認します。エージェントのループ中に 500・529 が発生
提供元の過負荷、ゲートウェイ経路の問題、再試行ループのどれですか？
変更前に状態コード、リクエスト ID、経路、モデル、トークン数、再試行回数を記録します。状態コードから調べる
キー・権限の問題、利用枠の制限、サーバーエラー、過負荷を分けて対処を選びます。
レート制限に到達
アカウント、ワークスペース、モデル、経路のリクエスト数またはトークン数の上限を超えています。
- 並列エージェントを減らす
- 長いコンテキストを短縮
- 間隔を空けて再試行
- 利用枠とモデル制限を確認
API サーバーエラー
提供元または経路がサーバー側の障害を返しています。繰り返す場合は経路の記録が必要です。
- リクエスト ID を記録
- 間隔を空けて一度再試行
- 続く場合は別の経路と比較
- 最初からプロンプトを書き直さない
過負荷
上流サービスの負荷が高い状態です。API キーの交換だけでは通常解決しません。
- 待って間隔を空ける
- 代替モデルを試す
- リクエストを小さくする
- 稼働状況とサポートを確認
API キー・権限の問題
有効なキーが違うか、モデルや接続先の利用権限がない可能性があります。
- ANTHROPIC_API_KEY を確認
- ベース URL を確認
- モデルの利用権限を確認
- 実際の請求元を確認
コードを変える前に事実を集める
- 正確なエラー、HTTP 状態、モデル、接続先、時刻を記録します。
- Anthropic の直接キーか互換ゲートウェイかを確認します。
- API 請求と利用枠を Pro・Max の契約状態とは別に調べます。
- 429 ではまず並列数とコンテキストを減らします。
- 500・529 では間隔を空けて一度再試行し、別経路や代替モデルと比較します。
- ゲートウェイでは Messages 接続先、モデル経路、キャッシュ挙動、サポート情報を確認します。
Pro・Max の利用枠と API 請求は別です
有効なキー、ベース URL、請求元を確認してください。サブスクリプションと API 残高が同じとは限りません。
API の利用を開始ゲートウェイ利用時は Messages 接続先を確認
Claude 互換クライアントには、正しい Messages 接続先、有効なキー、タスクに対応するモデル経路が必要です。
資料を確認Claude Code API のエラー
レート制限に到達したと表示されるのはなぜ？
リクエスト、トークン、モデル経路の上限を超えています。有効なキー、ワークスペース、経路、コンテキスト、並列実行数を確認します。
Pro・Max に API キーは含まれますか？
公式のアカウントページで別途説明されていない限り、契約の利用枠と API 請求を分けて確認します。現在の認証方式と請求元を確認してください。
API Error 500 が出たら？
リクエスト ID を記録し、間隔を空けて一度再試行します。続く場合は別経路と比較するか、時刻、モデル、ID を添えてサポートへ連絡します。
529 overloaded の意味は？
上流サービスの過負荷です。待機、再試行間隔の延長、リクエストの縮小、代替経路を試します。キー交換だけでは通常解決しません。
現在の規則を確認する場所
制限とエラーの意味は公式資料を基準にします。コミュニティの議論は調査の手掛かりであり、検証済みの事実の代わりではありません。