Claude 429エラーの原因と対処 — rate limitとoverloadedの違い

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

429とoverloadedはどこが違うのか

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

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

Claude Codeの429メッセージ別の原因と対処

API Error: Request rejected (429)と出る場合と、You've hit your ...で始まる場合では、原因が違います。メッセージの文面から、どの枠に当たったかを先に特定できます。

Request rejected (429)は、サブスクリプションではなくAPIキー、Amazon Bedrock、Google Cloudのプロジェクト側の制限を指します。サブスクリプションで使っているつもりなのにこの文面が出るなら、環境変数のANTHROPIC_API_KEYが残っていて、低いTierのキーで送っている可能性があります。/statusで、実際に使われている認証情報を確かめてください。

プロキシやゲートウェイが独自の429ページを返す構成では、·の後ろにそのページのタイトル(Too Many Requestsなど)が出ます。この場合の制限はAnthropicではなく、経路上の機器の設定です。

並列実行が原因の疑いがあるときは、CLAUDE_CODE_MAX_TOOL_USE_CONCURRENCYを下げる、並列のサブエージェントを減らす、といった手でリクエストの集中を抑えられます。

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

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

サブスクリプション側は、5時間ごとにリセットされるセッション枠と、週1回リセットされる週次上限の二層で管理されます。全モデル共通の週次上限に加えて、OpusやSonnetの系統ごとの上限もあり、セッション枠が戻っていても週次側に達していればそこで止まります。系統ごとの上限は、その系統のモデルへのリクエストだけが止まるため、/modelで別の系統に切り替えれば作業を続けられます。仕組みの詳細はClaude Pro制限の仕組みとClaude Maxプランとはで扱っています。

API側はStart / Build / Scaleの3ティア制で、利用実績に応じて引き上げられます(さらに上はCustom)。制限は分あたりのトークン数とリクエスト数で決まるため、同じ量を送るにしても、まとめて一気に投げるか時間で散らすかで到達しやすさが変わります。実数値はモデルとティアごとに違い、更新もされるので、Consoleの現在値を見るのが確実です。API全体の設計はAnthropic API完全ガイドにまとめてあります。Managed Agentsを使う場合は、この標準ティアとは別のレート制限とMCP対応状況が定められており、Managed Agentsのレート制限とMCP対応・ブランディング規定にまとめています。

枠はいつ戻るのか

セッション枠は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で修正されました。

リトライ待ちの間、画面にはWaiting for API responseという表示が出ます。この表示自体の意味とエラーではない理由は「Waiting for API response」の意味と対処にまとめています。

リトライの粘り自体は環境変数で変えられます。CLAUDE_CODE_MAX_RETRIESは再試行回数を指定する設定で、v2.1.186から15回が上限になっています。無人で長時間回す構成ではCLAUDE_CODE_RETRY_WATCHDOGを有効にします。一時的な429・529は回数無制限で再試行され、それ以外の一時エラーは既定回数が300に上がり、15回の上限も外れます。ただし支出上限やクレジット枯渇の429は、v2.1.239以降は即座に失敗します。設定の書き方はClaude Code環境変数リファレンスにまとめています。529だけが続くときの待ち時間の伸ばし方は、Claude Codeの529 Overloadedが続くときの記事で扱っています。

代替モデルへの切り替えにも同じ線引きがあります。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障害の確認方法で公式ステータスページの見方を確認してください。

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

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

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

対象プランに不定期で配られる「Reset for free」(Settings > Usage、WebかClaude Desktop)を除けば、上限を解除する手段はありません。このボタンはモバイルアプリと、ターミナル・IDEのClaude Codeには出ません。対象プランなら、上限到達時のメッセージにも同じボタンが出ます。今すぐ続けたい場合に取れるのは、使用量クレジットを有効にして超過分を従量課金へ切り替える方法か、上位プランへ変更する方法です。どちらもSettings > Usageから設定できます。

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

CLAUDE_CODE_RETRY_WATCHDOGは一時的な429・529を無制限に再試行しますが、支出上限やクレジット枯渇の429はv2.1.239以降、即座に失敗します。CLAUDE_CODE_MAX_RETRIESを増やしても、使い切った枠は戻りません。CLAUDE_CODE_RETRY_WATCHDOGを有効にしている場合、5時間や週の使用量上限に達したセッションは、リセットまで待ってから再開します。

まとめ

Claudeで止まったときは、まず429かoverloadedかを見分けるところから始まります。overloadedは待てば戻り、代替モデルの指定でも回避できます。429はさらに二分され、送りすぎによる一時的なものはClaude Codeが自動でリトライしますが、使用量の枠を使い切ったものは、リセットを待つか枠を足すのが基本です。OpusやSonnetの系統ごとの上限なら、/modelで別の系統へ切り替えれば続けられます。

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