# Claude Code「Rate limit reached」の対処：どの上限か見分けて再開

> Claude Code の Rate limit reached は、サブスク上限・API の 429・1M 利用権・支出上限で対処が違います。原文と /usage で見分けます。

- URL: https://blog.laozhang.ai/ja/posts/claude-code-rate-limit-reached
- Published: 2026-02-04
- Updated: 2026-10-05
- Author: LaoZhang AI Team (https://blog.laozhang.ai/ja/about)
- Topic: Claude Code
- Tags: Claude Code, Rate Limit, Anthropic, AI Coding, Troubleshooting

---
`API Error: Rate limit reached` は、Claude Code のリクエストが何らかの上限で止められたことを示しますが、どの上限かは書いていません。2026年10月5日時点の Claude Code は、多くの場面でもっと具体的なメッセージを出します。サブスクのセッション上限・週間上限・モデル別上限、サーバー側の一時的な制限、API キーやクラウドの `429`、1M コンテキストの利用権、使用クレジットの支出上限で、取るべき対処はそれぞれ違います。

最初にやることは三つです。画面のメッセージを原文のまま控える、`/usage` で上限とリセット時刻を見る、`/status` でどのアカウントと認証情報で接続しているかを見る。エラーが画面に出た時点で、Claude Code は該当する自動リトライ（最大10回、間隔を広げながら）をすでに済ませています。同じ依頼を何度も送り直しても状況は変わりません。

## メッセージ原文で見分ける：Claude Code の上限メッセージと次の一手

Claude Code の[エラーリファレンス](https://code.claude.com/docs/en/errors)に載っている上限系のメッセージを、意味と次の一手に並べると次のとおりです。時刻は例です。

| 表示されるメッセージ | 意味 | 次の一手 |
| --- | --- | --- |
| `You've hit your session limit · resets 3:45pm` | 5時間ごとにリセットされるセッション上限。全モデル共通 | リセットを待つ。自動再開が使える。モデルを替えても戻らない |
| `You've hit your weekly limit · resets Mon 12:00am` | 週間上限。全モデル共通で、リセット日時はアカウントごとに固定 | リセットまで数日あることも。使用クレジットかリセット権を検討 |
| `You've hit your Opus limit` / `You've hit your Sonnet limit` | そのモデルファミリーだけの上限 | `/model` で別ファミリーのモデルに切り替えれば続行できる |
| `API Error: Server is temporarily limiting requests (not your usage limit)` | サーバー側の短時間の制限。プランの残量とは無関係 | 少し待って再試行。続くなら status.claude.com を確認 |
| `API Error: Request rejected (429) · this may be a temporary capacity issue. …` | API キー、Amazon Bedrock、Google Cloud のプロジェクトに設定されたレート制限 | `/status` で認証情報を確認し、事業者コンソールの上限と並列数を見直す |
| `API Error: Usage credits required for 1M context · …` | 1M コンテキストの利用権チェック。残量があっても出る | `/model` で `[1m]` の付かない版に戻す |
| `You've hit your monthly spend limit · raise it at claude.ai/settings/usage` など | 含まれる利用分では足りず、使用クレジットも支出上限に達した | 支出上限を上げる、管理者に頼む、またはリセットを待つ |
| `spend limit reached (…)` | Claude apps ゲートウェイの運営者が設けた上限 | 期間のリセットを待つか、運営者に引き上げを頼む |
| `API Error: Rate limit reached` だけ | どの上限かが表示されていない | 次の節の手順で特定する |

上限に届く前には、`You've used 85% of your session limit · resets 3:45pm` のような警告が出ることがあります。

無人で動かしているセッション（Remote Control、バックグラウンドセッション、エージェントチームのメンバー、Agent SDK で組み込んだアプリ）で `Fable limit reached · continuing on Fable 5.1 uses usage credits …` と出た場合は、上限そのものではありません。使用クレジットで続けるかの確認に誰も答えなかったという意味で、リクエストは送られていません。セッションが動いている端末で確認に答えるか、`/model` で切り替えます。

`API Error: Repeated 529 Overloaded errors` は API 全体の混雑で、あなたの上限には数えられません。こちらは [Claude Codeの529過負荷エラー：待つか切り替えるか](https://blog.laozhang.ai/ja/posts/claude-code-overloaded-error) と [Claude Code API Error 500・529の対処：作業を重複させずに再開](https://blog.laozhang.ai/ja/posts/claude-code-500-529-rate-limit) で扱っています。ブラウザの Claude.ai で止められた場合や、Claude.ai・Claude Code・API のどこで制限されたのかが分からない場合は、[Claude の Rate Exceeded: 再試行前に制限元を切り分ける](https://blog.laozhang.ai/ja/posts/claude-rate-exceeded-error) で経路から切り分けられます。

## Rate limit reached だけ表示されたとき：/usage と /status で特定

この短い文言は今も実際に表示されます。Claude Code の[フック](https://code.claude.com/docs/en/hooks)のドキュメントには、ターンが API エラーで終わったときの `StopFailure` イベントの例として、`"error": "rate_limit"`、`"error_details": "429 Too Many Requests"`、`"last_assistant_message": "API Error: Rate limit reached"` が載っています。ただし、どのバージョンや接続経路でこの短い形が出るのかは公開されていません。そこで、表示された文言ではなく画面の状態から上限を特定します。

```text
/usage
/status
/model
```

1. `/usage` でプランの上限と各枠のリセット時刻を見ます。`/cost` と `/stats` は同じ画面の別名です。Pro、Max、Team、Enterprise では、何が上限に数えられているかの内訳も出ます。セッション枠か週間枠が100%近いなら、サブスクの上限に当たっています。
2. `/status` でバージョン、モデル、アカウント、接続状態を見ます。残量の確認ではなく、どの経路で接続しているかの確認です。サブスクで使っているつもりなのに API キーで接続しているなら、環境変数の `ANTHROPIC_API_KEY` が原因のことがあります。このキーがあると、Claude Code はサブスクではなく API の従量課金を使います。
3. `/model` で選んでいるモデルを見ます。Opus 4.6 や Sonnet 4.6 の `[1m]` 版なら、1M コンテキストの利用権が関係している可能性があります。

判断は次のように分かれます。`/usage` の枠が上限に近ければ、リセット待ちか使用クレジットの話です。接続が API キーや Bedrock、Google Cloud なら、そのキーやプロジェクトのレート制限です。サブスクで接続していて枠にも余裕があるのに止まり続けるなら、後述の「使用量が残っているのに出るとき」に進みます。

![Claude Code の /usage、/status、/model で上限、認証情報、モデル設定を確認し、短いエラーメッセージの原因を切り分ける概念図](https://blog.laozhang.ai/posts/ja/claude-code-rate-limit-reached/img/diagnostic-flowchart.webp)

## 同じセッションで再開する：再送を重ねず、原因ごとに一手だけ打つ

止まったセッションは閉じずに残します。Claude Code は一時的な `429` を含む失敗を、エラー表示の前に最大10回、間隔を広げながら自動で再試行しています。スピナーに `Retrying in Ns · attempt x/y` と出ている間は待つだけで構いません。エラーが出たあとに同じ依頼を貼り直しても、上限が変わらない限り同じ結果になります。

作業途中のファイルが残っていることもあるので、`git diff` で編集がどこまで進んだかを確かめておくと、再開時の指示を正確に出せます。`/clear`、`/login` でのアカウント切り替え、`/resume` で別セッションに移る操作は、後述する自動再開の待機を終わらせます。

### セッション上限・週間上限：自動再開と /rate-limit-options

claude.ai のサブスクでログインした対話セッションなら、v2.1.234 以降の Claude Code は上限で止まったタスクをリセット後に自分で再開します。初期設定で有効です。待機中は画面下に次のように出ます。

```text
Usage limit reached · limit resets 3:45pm
Continuing automatically at 3:45pm · esc to cancel
```

リセットが来ると、Claude Code は止まったところからタスクを続けるよう Claude に促します。直前のメッセージを送り直すわけではありません。権限の確認はいつもどおり出るので、席を外している間にそこで止まることはあります。再開してもまた上限に当たった場合、待機の再設定は連続2回までで、その後は `Automatic continue stopped after repeated usage-limit hits · /rate-limit-options to try again` で止まります。

自動で待機が始まらないのは、リセットが24時間以上先の場合（週間上限ではよくあります）、Remote Control やエージェントチームのメンバーのセッション、別ファミリーのモデルを使っている最中のモデル別上限です。この場合は `/rate-limit-options` を開き、**Wait here, then continue automatically** で始まる行を選びます。このメニューには使用クレジットの追加とアップグレードの選択肢もあります。

- 待機中に `/usage-credits` で使用クレジットを追加し終えるか、`/model` でモデルを切り替えると、Claude Code はすぐに使えるかを確かめ、使えればその場で再開します。ブラウザで自分で購入やアップグレードをしただけでは確認されません。
- Esc キーで待機を取り消せます。Claude Code を終了すると待機も終わり、セッションを再開しても待機は戻りません。
- バックグラウンドセッションと `-p` の実行では待機を選べません。API キー、クラウド事業者、従量課金の組織はリクエストごとの課金なので、待つべきリセットがありません。
- 自動再開を止めたいときは、`/config` の **Continue automatically at usage limit** をオフにするか、ユーザー設定で `autoContinueAtUsageLimit` を `false` にします。Desktop アプリの Code タブでは、セッション上限のカードに別の **Auto-continue when limits reset** チェックボックスがあり、週間上限のカードにはありません。

### Opus・Sonnet の上限：/model で別ファミリーに切り替える

モデル別上限はそのファミリーへのリクエストにだけかかるので、`/model` で別ファミリーのモデルを選べば作業を続けられます。モデルごとにプロンプトキャッシュが別なので、切り替え直後のリクエストは会話全体をキャッシュなしで読み直します。長い会話ほど、その1回の消費が大きくなります。セッション上限と週間上限は全モデル共通なので、こちらはモデルを替えても戻りません。

### API キー・Bedrock・Google Cloud の 429：認証情報と並列数

`API Error: Request rejected (429)` は、API キーやクラウドのプロジェクトに設定された上限です。まず `/status` で、使っている認証情報が意図したものかを確かめます。その上で、事業者のコンソールで現在の上限を確認し、必要なら上位の利用ティアを申請します。並列を減らすには、`CLAUDE_CODE_MAX_TOOL_USE_CONCURRENCY` を下げる、サブエージェントを同時に多く走らせない、大量のスクリプト実行では `/model` で小さいモデルにする、といった方法があります。API のティアごとの上限値は [Claude の Rate Exceeded: 再試行前に制限元を切り分ける](https://blog.laozhang.ai/ja/posts/claude-rate-exceeded-error)、サブスクと API キーのどちらで払うべきかは [Claude CodeのAPIキーとサブスク課金: どちらを使うべきか](https://blog.laozhang.ai/ja/posts/claude-code-api-key-vs-subscription-billing) で扱っています。

CI のような無人実行では、`CLAUDE_CODE_RETRY_WATCHDOG=1` を設定すると、`429` と `529` の容量エラーを回数の上限なく再試行します。支出上限や使用クレジットの枯渇を示す `429` では、待っても解消しないため即座に失敗します。

### 1M コンテキストの利用権：Opus 4.6・Sonnet 4.6 の 1M 版をやめる

`Usage credits required for 1M context` は残量切れではなく利用権のチェックで、セッション枠と週間枠に余裕があっても出ます。関係するのは、`[1m]` 版で 1M コンテキストに届く Opus 4.6 と Sonnet 4.6 だけです。Fable 5.1、Fable 5、Sonnet 5 以降、Opus 4.7 以降は、Pro を含むすべてのプランで最初から 1M で動き、`[1m]` 版を選ぶ必要も使用クレジットも要りません（[モデル設定のドキュメント](https://code.claude.com/docs/en/model-config)）。

| プラン | Opus 4.6 の 1M 版 | Sonnet 4.6 の 1M 版 |
| --- | --- | --- |
| Max、Team、Enterprise | サブスクに含まれる | 使用クレジットが必要 |
| Pro | 使用クレジットが必要 | 使用クレジットが必要 |
| API・従量課金 | 利用可 | 利用可 |

対処は `/model` で `[1m]` の付かない版を選ぶことです。1M 版を使い続けたいなら `/usage-credits` で使用クレジットを有効にし、メッセージの指示どおり Claude Code を再起動するか新しいセッションを始めます。`/model` で戻しても続く場合は、設定ファイルなど別の場所で 1M のモデル ID が指定されている可能性があります。モデル選択画面から 1M 版を消すには `CLAUDE_CODE_DISABLE_1M_CONTEXT=1` を設定します。会話が200K トークンを超えた途中でこのエラーが出た場合は、Claude Code が標準の上限内まで自動で要約するので操作は不要です。v2.1.172 より前のバージョンでは `/compact` を含むすべてのリクエストで繰り返し出たため、`/clear` で抜けます。

### 支出上限：使用クレジットの上限を上げるか、枠のリセットを待つ

`You've hit your monthly spend limit` で始まる一連のメッセージは、プランに含まれる利用分で足りず、代わりに払う使用クレジットも支出上限に達したことを示します。誰の上限かはメッセージに書かれていて、個人、組織、チームの共有予算、Slack チャンネルで文言が変わります。この種類は自動で再試行されません。Pro と Max は claude.ai の **Settings > Usage** か `/usage-credits` で上限を上げ、Team と Enterprise は管理者に頼みます。プランの枠が切れたことが理由なら、`· your session limit resets 3:45pm` のようにリセット時刻も表示されるので、それを待てば上限を上げなくても戻ります。使用クレジットの料金の考え方は [Claude 追加利用の料金：クレジット、Max、Claude Code の見極め](https://blog.laozhang.ai/ja/posts/claude-extra-usage-cost) にあります。

サブエージェントが上限で止まると、`Agent terminated early due to an API error:` の後ろに原因が付きます。コロンの後ろの文言を上の表に当てはめて対処し、解消したら Claude にタスクのやり直しかサブエージェントの再開を頼みます。

## 使用量が残っているのに出るとき：再インストールや課金の前に確かめること

`/usage` の枠に余裕があるのに、すべてのリクエストが `API Error: Rate limit reached` で止まるという報告は GitHub にあります。2026年2月の [#29579](https://github.com/anthropics/claude-code/issues/29579) では、Max プランでセッション使用量16%の状態で毎回この文言が出たと報告され、コメントには翌日に自然に戻った人、モデルを替えて動いた人、`opus[1m]` を使っていて使用クレジットで課金されていたと気づいた人が並んでいます。2026年3月の [#33120](https://github.com/anthropics/claude-code/issues/33120) では、Cowork でだけ出て、同じマシンでも別アカウントなら動いたと報告されています。どちらも公式の原因説明はなく、ひとつの原因に決めつけることはできません。手元で確かめられるのは次の順番です。

1. **モデル**：`/model` の選択が Opus 4.6 か Sonnet 4.6 の `[1m]` 版なら、1M コンテキストの節に戻ります。
2. **認証情報**：`/status` のアカウントとログイン方法が想定どおりか、環境変数に `ANTHROPIC_API_KEY` が残っていないかを見ます。
3. **アカウント側かどうか**：同じアカウントの Claude.ai や Desktop アプリ、別アカウントで同じ操作が通るかを試します。別アカウントだけ通るなら手元の環境では直せないので、再インストールしても変わりません。
4. **インストール**：シェルで `claude --version` と `claude doctor` を実行します。`claude doctor` はセッションを開かずにインストール状態を読み取り専用で診断し、重複や古いインストールの残り、`PATH` の問題を見つけます。古い npm 版の CLI が先に呼ばれていたという報告もあります。
5. **障害情報**：status.claude.com に進行中の障害がないかを見ます。

アップグレードや使用クレジットの購入が効くのは、`/usage` が実際に上限に達しているときと、1M 版を使い続けたいときです。残量があるのに全リクエストが止まる状態を解消するとは限りません。

報告するときは、次の情報を手元に残しておきます。

- メッセージの原文と、発生した日時（タイムゾーン付き）
- `claude --version` の出力
- `/status` の画面（アカウント、ログイン方法、モデル）と `/usage` の画面
- 別のモデル、別アカウント、Claude.ai で試した結果
- その時点の status.claude.com の表示

Claude Code の中で `/feedback` を実行すると、説明と会話の記録を Anthropic に送れて、GitHub に issue を立てる下書きも作れます。送る前の確認画面で、含める会話の範囲を選べます。Bedrock、Google Cloud、Microsoft Foundry などの経路では、送信の代わりにローカルにアーカイブが保存されるので、それをアカウント担当者に渡します。同じ症状が繰り返すなら、`StopFailure` フックで `error` と `error_details` を記録しておくと、いつどの種類のエラーで止まったかを報告に添えられます。このフックは記録や通知のためのもので、動作を変えることはできません。

## 次に上限で止まらないために：会話とツール出力を軽くする

Pro と Max のセッション枠は5時間ごとにリセットされ、週間枠はアカウントごとに決まった曜日と時刻にリセットされます。使用量は claude.ai、Claude Code、Desktop アプリ、IDE で共通です。何時間・何回使えるかという数字は公開されていません。

Claude Code の1回の依頼は、会話の履歴、読み込んだファイル、ツールの出力を抱えたまま次のリクエストに進むので、同じ1行の指示でもセッションが長いほど消費が増えます。基本は、関係ないタスクの間で `/clear` する、長い会話は `/compact` に残したい焦点を添えて要約する、たいていのコーディングは Sonnet で済ませる、使っていない MCP サーバーを外す、の四つです。サブエージェントに回した作業も同じ上限に数えられます。残量を常に見ておきたいなら、カスタムステータスラインに `rate_limits` の項目を加えるか、Desktop アプリのモデル選択の横にある使用量リングを見ます。

![短い指示にも会話履歴、読み込んだファイル、ツール出力が加わり、Claude Code の消費量が増えることを示す概念図](https://blog.laozhang.ai/posts/ja/claude-code-rate-limit-reached/img/token-consumption.webp)

使用量の内訳の読み方や減らし方は [Claude Code トークン使用量確認・監査：5時間・週間制限と減らし方](https://blog.laozhang.ai/ja/posts/claude-code-usage-limit-issues)、いまのプランで足りるかの判断は [Claude ProとMaxを比較 2026年版：料金、Claude Code制限、Maxの損益分岐点](https://blog.laozhang.ai/ja/posts/claude-code-pro-vs-max) で扱っています。

## よくある質問

### Claude Code のレートリミットの残りはどこで確認できますか？

Claude Code の中で `/usage` を実行します。プランの上限、各枠の使用率、リセット時刻が出ます。`/status` はバージョン、アカウント、接続経路を見る画面で、残量の確認には使いません。週間枠のリセット日時は claude.ai の **Settings > Usage** でも見られます。作業中に残量を見続けたい場合は、ステータスラインの `rate_limits` か Desktop アプリの使用量リングが使えます。

### Claude Code を再インストールすれば Rate limit reached は直りますか？

ほとんどの場合は直りません。サブスクの上限、API キーの `429`、1M コンテキストの利用権、支出上限は、どれもアカウントや設定の側で決まっていて、インストールし直しても変わらないからです。再インストールが意味を持つのは、`claude doctor` が重複インストールや `PATH` の問題を示したときだけです。先に `/usage`、`/status`、`/model` を確認してください。

### Claude Max でも足りないとき、Rate limit reached の回避策はありますか？

正規の選択肢は次のとおりです。リセットを待つ（自動再開を使えば作業は自動で続きます）。モデル別上限ならファミリーを切り替える。使用クレジットを有効にして、標準の API 料金で上限の先まで続ける。リセット権がアカウントにあれば、Web 版か Desktop アプリから5時間枠か週間枠を満タンに戻す（ターミナルや IDE からは使えません）。上位プランに変える、または API キーの従量課金に移る。

使用クレジットには注意点が二つあります。使用クレジットで払っている間は、プロンプトキャッシュの保持時間が5分に短くなります。また日本では、2026年9月10日から、使用クレジットが購入後6か月で失効するようになりました。使用クレジットとリセット権の違いは [Claudeクラウドクレジット・使用クレジット・リセット権の違い](https://blog.laozhang.ai/ja/posts/claude-cloud-session-credit-vs-usage-credits)、料金の見積もりは [Claude 追加利用の料金：クレジット、Max、Claude Code の見極め](https://blog.laozhang.ai/ja/posts/claude-extra-usage-cost) で扱っています。

## 参考資料

本文で参照している外部ページを、登場順に並べています。最終更新日：2026-10-05。

- [エラーリファレンス](https://code.claude.com/docs/en/errors) (code.claude.com)
- [フック](https://code.claude.com/docs/en/hooks) (code.claude.com)
- [モデル設定のドキュメント](https://code.claude.com/docs/en/model-config) (code.claude.com)
- [#29579](https://github.com/anthropics/claude-code/issues/29579) (github.com)
- [#33120](https://github.com/anthropics/claude-code/issues/33120) (github.com)