Claude rate limit(レート制限)エラーの対処 — 429とoverloadedの違いと回復

Claudeで止まったときに出るエラーは、大きく2種類に分かれます。429は送りすぎか枠を使い切ったことを意味し、待つか枠を足すかしか道がありません。overloadedは529で返るClaude側の一時的な混雑で、こちらは待てば戻りますし、別のモデルへ切り替えれば通ることもあります。同じ「止まった」でも打ち手がまったく違うため、まずどちらなのかを見分けるところから始めます。

429とoverloadedはどこが違うのか

エラーの正体は、HTTPのステータスコードとerror typeの組で判別できます。Claude Code上ではメッセージが整形されて出るため、生のJSONを読む場面は減りましたが、SDKやスクリプト経由なら次の対応で見分けられます。

見分けの実務的な近道は、時間をおいて再送したときの挙動です。数十秒から数分で通るようになるなら混雑側、何度試しても同じ文面が返るなら枠側と判断できます。枠側であれば、リセットの時刻まで待つか、枠そのものを足す話になります。

サブスクリプションの上限とAPIの制限は別物

「レート制限」という言葉が指す先は、契約の形で変わります。ここを混ぜたまま調べると、対処法が噛み合いません。

サブスクリプション側は、5時間ごとにリセットされるセッション枠と、週1回リセットされる週次上限の二層で管理されます。Maxには全モデル横断の週次上限に加えてOpus専用の週次上限もあり、セッション枠が戻っていても週次側に達していればそこで止まります。仕組みの詳細はClaude Pro制限の仕組みとClaude Maxプランとはで扱っています。

API側はTier制で、Tier 1からTier 4へ累計利用額に応じて自動的に引き上げられます。制限は分あたりのトークン数とリクエスト数で決まるため、同じ量を送るにしても、まとめて一気に投げるか時間で散らすかで到達しやすさが変わります。実数値はモデルとTierごとに違い、更新もされるので、Consoleの現在値を見るのが確実です。API全体の設計はAnthropic API完全ガイドにまとめてあります。

枠はいつ戻るのか

セッション枠は5時間ごとに巡ってくるため、最長でも数時間待てば戻ります。午前に集中して使い、昼過ぎに上限表示が出たが夕方には使えるようになっていた、という動き方は仕様どおりです。

週次上限は違います。リセットはアカウントごとに割り当てられた固定の曜日と時刻で毎週訪れ、使い始めた日や契約日とは関係しません。5時間待っても送れないなら、セッション枠ではなく週次側に達している可能性が高いと判断できます。この場合に待つ先は次の5時間ではなく、割り当てられた週次のリセット日時になります。

どちらに当たっているかは、Settings > Usageで確認できます。Claude Codeの中からなら/usageが同じ情報を出し、セッションのコストとプランの使用上限、利用統計をまとめて表示します。v2.1.149以降は利用枠の消費内訳も見られるようになり、Pro / Max / Team / Enterpriseではスキル・サブエージェント・プラグイン・MCPサーバー別の内訳まで確認できます。/costと/statsはどちらも/usageのエイリアスです。

枠そのものも一度広がっています。2026年5月6日に、Pro / Max / Team / Enterprise(seat)プランでClaude Codeの5時間ウィンドウ上限が2倍へ引き上げられ、OpusモデルのAPIレート制限も拡張されました。以前の体感で「Proではすぐ当たる」と判断していたなら、現在の枠は当時より広い前提です。

Claude Codeが自動で待ってくれる範囲

Claude Codeは、すべてのエラーを人が対処する前提にはなっていません。どこまでを自動で吸収するかには明確な線引きがあります。

使用量上限と無関係な一時的な429は、v2.1.199以降、待ち時間を段階的に延ばすbackoffを伴う自動リトライの対象になりました。それ以前はサブスクリプション利用のときにターンごと失敗していた挙動が変わっています。リトライの間隔はRetry-Afterヘッダーを見つつ、指数バックオフを下限として適用します。以前はRetry-Afterが小さいと全試行を10数秒で使い切ってしまう問題があり、v2.1.98で修正されました。

リトライの粘り自体は環境変数で変えられます。CLAUDE_CODE_MAX_RETRIESは再試行回数を指定する設定で、v2.1.186から15回が上限になっています。無人で長時間回す構成ではCLAUDE_CODE_RETRY_WATCHDOGを有効にすると、既定のリトライ回数が300へ上がり15回の上限も外れます。ただしこの引き上げの対象は容量系ではない一時エラーで、枠を使い切った429を粘って通す仕組みではありません。設定の書き方はClaude Code環境変数リファレンスにまとめています。

代替モデルへの切り替えにも同じ線引きがあります。fallbackModel設定では最大3つの代替モデルを順に試せて、主モデルが過負荷や利用不可の状態でも指定したモデルへ自動で切り替わります。一方で、認証・レート制限・リクエストサイズ・転送のエラーは対象外で、これらは即座に表面化します。混雑をよけるための仕組みであって、レート制限を迂回する仕組みではない、という設計になっています。

表示のされ方もリリースを追って整えられてきました。v2.1.101でレート制限時の表示が不透明な秒カウントダウンから、どの制限にかかっていて、いつ解除されるかを示す形へ変わっています。v2.1.105では、APIキー・Bedrock・Vertex AI利用時の429が生のJSONのまま出ていたのが整形されたメッセージになりました。古いバージョンを使い続けている場合、原因が同じでも読み取りにくい文面が出ている可能性があります。

待つ以外に取れる4つの選択肢

上限に達したときの選択肢は4つで、当たる頻度によって向き不向きが変わります。

使用量クレジットは、プランの枠に達したあとの利用をAPI標準料金の従量課金へ切り替えて続ける仕組みです。Pro / Max 5x / Max 20xが対象で、月額はそのままに超過分だけを払う形になります。有効化はSettings > Usageの使用量クレジット欄で行い、月間の支出上限、残高の自動リロード、使用量アラートを設定できます。Claude Codeの中からは/usage-creditsで設定へ入れます。なお、モバイルアプリ経由で契約している場合、有効化はWeb版でのみ可能です。

プラン変更とクレジットの使い分けは、当たる頻度で判断すると迷いにくくなります。恒常的に足りないなら段階を上げ、繁忙期だけ足りないならクレジットで埋める。費用面ではこの使い分けが収まりのよい形です。定額と従量の損益分岐まで含めた費用設計はClaude Codeの料金判断ガイドで扱っています。

上限に当たりにくくする使い方

枠の消費は「メッセージ何通」という単純なカウントではありません。同じ1通でも、会話の長さ・添付ファイルの大きさ・使うモデル・思考の深さで消費量が変わります。なかでも効きが大きいのが会話の長さです。長いやり取りを続けると、新しい質問を1つ送るだけで、それまでの全体を毎回処理し直すことになります。

そのため、消費を抑える手として効果が出やすいのは次の3つです。話題が変わったら新しい会話に切り替える、Claude Codeなら/clearや/compactでコンテキストを畳む、軽い作業はSonnetやHaiku系のモデルへ振り分ける。Claude Codeでは/modelでその場に切り替えられます。

自動実行の設計側でも打てる手があります。サブエージェントを多数並べる構成やWeb検索を多用する構成は消費が伸びやすいため、セッションあたりの上限を明示的に置いておくと、想定外の消費で枠を溶かす事故が減ります。バッチ処理をAPIで回すときは、同じ量でも時間で散らすほうが分あたりの制限に届きにくい形です。

Bedrock・Vertex AI経由で429が出たとき

Amazon BedrockやGoogle Vertex AI、Microsoft Foundry経由で使っている場合、429の出どころがAnthropic側とは限りません。制限はプロバイダーのクォータ側で掛かっていることがあり、その場合の引き上げ申請先もプロバイダーになります。

この取り違えは、以前はエラーメッセージ自体が誘発していました。v2.1.111より前は、これら3プロバイダーで429が出たときにAnthropicの稼働状況ページを参照するよう案内していましたが、そのページはAnthropicが運営するプロバイダーだけを対象にしています。現在は誤った案内が出ない形に修正されています。企業のLLMゲートウェイを挟んでいる構成なら、ゲートウェイ側にも独自の制限が設定されていることがあるため、そちらの設定も確認範囲に入ります。

よくある質問

429エラーはどのくらい待てば解消しますか

送りすぎによる一時的な429なら、数十秒から数分で戻ります。サブスクリプションの枠を使い切った場合は、5時間ごとのセッション枠なら最長で5時間、週次上限なら割り当てられた曜日と時刻のリセットまで戻りません。どちらに当たっているかはSettings > Usage、またはClaude Code内の/usageで確認できます。

overloadedが続くときはどうしますか

overloadedはClaude側の一時的な混雑を示すため、時間をおいて再送するのが基本の対処になります。Claude CodeではfallbackModel設定で代替モデルを最大3つ指定しておくと、過負荷や利用不可の状態で自動的に切り替わります。混雑は時間帯によって差が出るので、重い処理をずらす選択肢もあります。

Claude Codeの使用量は別枠ですか

同じ枠です。Pro / Maxのセッション枠と週次上限は、claude.aiのチャット、Claude Desktop、Claude Codeで共有されます。日中のコーディング作業がそのまま夜のチャット利用の枠を削る形になるため、片方だけ節約しても効きにくい構造になっています。

上限をすぐ解除する設定はありますか

上限そのものを直接解除する設定やボタンは用意されていません。今すぐ続けたい場合に取れるのは、使用量クレジットを有効にして超過分を従量課金へ切り替える方法か、上位プランへ変更する方法になります。どちらもSettings > Usageから設定できます。

リトライ回数を増やせば通りますか

枠を使い切った429には効きません。CLAUDE_CODE_MAX_RETRIESとCLAUDE_CODE_RETRY_WATCHDOGが粘りを引き上げる対象は、ネットワーク断のような容量系ではない一時エラーです。使用量上限に達している状態でリトライ回数を増やしても、同じエラーを繰り返すだけになります。

まとめ

Claudeで止まったときは、まず429かoverloadedかを見分けるところから始まります。overloadedは待てば戻り、代替モデルの指定でも回避できます。429はさらに二分され、送りすぎによる一時的なものはClaude Codeが自動でリトライしますが、使用量の枠を使い切ったものはリセットを待つか枠を足すかしかありません。

枠側だった場合の判断材料は、当たる頻度です。まれなら待つ、月に数回なら使用量クレジット、ほぼ毎日ならプランの段階を上げる、という切り分けになります。あわせて、長い会話を畳む・軽い作業を下位モデルへ振る・自動実行に上限を置くという使い方の調整も、同じ作業量あたりの消費を確実に下げます。どちらの上限に当たっているかは/usageとSettings > Usageで見えるので、止まってから調べるより、重い作業を始める前に残量とリセット時刻を見ておくほうが計画は立てやすくなります。