Claude ProやMaxプランの残量が十分にあるにもかかわらず、Claude Codeで「API Error: Server is temporarily limiting requests (not your usage limit)」やHTTP 429エラーが頻発するケースが報告されている。

Anthropicの公式エラーリファレンスによると、このメッセージはプラン全体の利用枠枯渇ではなく、認証キーの競合や短時間の同時実行数過多によって引き起こされる。以下の5ステップで順に切り分けを行うことで解消できる。

図:Claude Code の HTTP 429(not your usage limit)5ステップ切り分け・監視設定一覧
図:Claude Code の HTTP 429(not your usage limit)5ステップ切り分け・監視設定一覧

5ステップの切り分けと修復手順

ステップ1:/status で環境変数 ANTHROPIC_API_KEY の上書きを確認:最も見落としやすい原因が、シェル環境に残っている古い ANTHROPIC_API_KEY だ。この変数が設定されていると、claude.aiのサブスクリプションではなく低ティアのAPIキー経由でリクエストが送信され、即座にレート制限(429)に達する。/status で有効な認証経路を確認し、APIキーが優先されている場合は unset ANTHROPIC_API_KEY(Windows PowerShellでは Remove-Item Env:ANTHROPIC_API_KEY)を実行してから /login で再認証する。

ステップ2:エラー文言から429・529・プラン上限を区別する:リセット時刻(resets at ...)が明記されている場合は5時間枠または週間枠の上限到達を意味する。HTTP 529(Overloaded)はサーバー側の高負荷であり、/model で別モデルへ切り替えることで回避できる場合がある。「not your usage limit」と表示される429は一時的なレート制御のため、連打してリトライ回数を増やさず1分ほど待機する。

ステップ3:並列セッションとサブエージェントの同時実行を減らす:デスクトップアプリで6つ以上のCodeタブを同時に開いたり、並列サブエージェントを大量に起動したりすると、1分あたりのリクエスト上限(RPM)を瞬時に超過しやすい。稼働中のメインセッションは1〜2個に絞るのが安全だ。

ステップ4:Claude Code を最新安定版へアップデート:v2.1.199以降(最新はv2.1.323)では、一時的な429に対して最大10回の指数バックオフ自動リトライが組み込まれている。claude update を実行して最新版へ更新しておく。

ステップ5:無人バッチ実行時はリトライ監視(Watchdog)を有効化:claude -p による非対話スクリプトや夜間ジョブでは、既定の10回リトライを超えると停止してしまう。環境変数 CLAUDE_CODE_RETRY_WATCHDOG=1 を設定すると、429および529が解消するまで粘り強く再試行を継続できる(待機上限を設ける場合は CLAUDE_CODE_RETRY_WATCHDOG_MAX_WAIT_MS=3600000 などを併用)。