利用上限・レート制限

「usage limit」エラーClaude Codeの上限メッセージと対処

Claude Codeで「You've hit your session limit」などの上限メッセージが出たときの原因と対処を、公式のエラー一覧で整理。待つ・モデルを切り替える・追加の利用分を使う、の判断手順を紹介します。

公的機関・公式資料などの一次情報と照合して作成しています。このサイトについて

「usage limit」エラーとは

Claude Code で、利用量の上限に達すると、次のようなメッセージが表示されます。公式のエラー一覧では、「You’ve hit your session limit」「You’ve hit your weekly limit」「You’ve hit your Opus limit」「You’ve hit your Sonnet limit」と記載され、いずれもリセット時刻(resets …)が付きます。

これらは、サブスクリプションの利用枠を使い切ったことを示します。故障ではなく、仕様上の制限です。この記事では、メッセージごとの意味と、取れる行動を、判断の順番で整理します。

基本(メッセージと意味)

公式のエラー一覧にある内容は次のとおりです。

メッセージ 意味 戻る時期
You’ve hit your session limit セッションの利用枠を使い切った 末尾に示される時刻
You’ve hit your weekly limit 週間の利用枠を使い切った 末尾に示される時刻
You’ve hit your Opus limit Opus 系モデルの枠を使い切った 末尾に示される時刻
You’ve hit your Sonnet limit Sonnet 系モデルの枠を使い切った 末尾に示される時刻
Server is temporarily limiting requests (not your usage limit) サーバー側の一時的な制限。自分の枠とは無関係 少し待って再送する。続くなら status.claude.com を確認

公式は、セッション上限と週間上限は、すべてのモデルで共有されると説明しています。したがって、これらの上限では、モデルを切り替えても使えるようになりません。

具体例(判断の流れ)

状況 取れる行動
数時間でリセットされる 待つ。自動で再開する機能を使う
週間上限で、リセットが数日先 追加の利用分(usage credits)を使う、プランを上げる、Console の API に切り替える
Opus 系の上限だけ /model で Opus 以外のモデルに切り替えて続ける
Sonnet 系の上限だけ /model で Sonnet 以外のモデルに切り替えて続ける
追加の利用分の費用上限 設定画面で上限を引き上げる、または次のリセットを待つ

公式ヘルプには、Pro で上限に達したときの選択肢として、Max 5x へ上げる、追加の利用分を有効にする、Console のアカウントに切り替えて API クレジットを買う、リセットを待つ、の4つが示されています。

「usage limit」エラーの実践ステップ

  1. メッセージの種類と、末尾のリセット時刻を読む。
  2. /usage を開き、各上限と、リセット時刻を確認する。
  3. モデル別の上限(Opus か Sonnet)なら、/model で別の系統に切り替える。
  4. 待つ場合は、Claude Code v2.1.234 以降の自動再開を使う。対話セッションを開いたままにしておくと、リセット後に作業が続きます。取りやめるときは Esc を押すか、/rate-limit-options で「Don’t continue automatically」を選びます。
  5. すぐ続けたい場合は、/usage-credits で追加の利用分を設定する。Pro と Max では、claude.ai の設定画面が開きます。
  6. 頻発するなら、使い方を見直す。

「usage limit」エラーの注意点

  • 自動再開は、claude.ai のサブスクリプションで使っている対話セッションが対象です。パソコンを30分以上スリープさせた場合は、再開時に Enter キーを押す必要があります。
  • 自動再開した作業でも、許可の確認は通常どおり求められます。席を外していると、確認待ちで止まることがあります。
  • 繰り返し上限に達すると、自動の待機は連続2回までで止まります。
  • 追加の利用分は、有効にすると費用が発生します。上限額を必ず設定してください。
  • 週間上限は、リセットが24時間以上先になることがあり、自動の待機は始まりません。

「usage limit」エラーでよくあるミス

  • 週間上限のメッセージに、/model で別のモデルを選んで解決しようとする。
  • 末尾のリセット時刻を読まず、すぐ戻ると期待する。
  • 追加の利用分を有効にしたまま、費用上限を設定しない。
  • API キーの環境変数を設定していて、サブスクリプションの上限と思い込む。/status で認証の種類を確認します。

「usage limit」エラーのチェックリスト

  • メッセージの種類(セッション、週間、モデル別、費用)を判断したか。
  • リセット時刻を確認したか。
  • /usage で、他の上限の残りも見たか。
  • モデル別の上限なら、切り替えを試したか。
  • 追加の利用分を使う場合、上限額を設定したか。

「usage limit」エラーのFAQ(よくある質問)

Q. 上限に達しても、データは失われませんか。
A. 会話そのものは残ります。リセット後に続けるか、claude --resume で再開できます。

Q. 「Server is temporarily limiting requests」は上限ですか。
A. 違います。公式は、プランの利用枠とは関係のない、短時間のサーバー側の制限と説明しています。Claude Code は一時的な制限を自動で再試行しますが、それでも表示された場合は、少し待ってから送り直し、続くようなら status.claude.com を確認します。

Q. 上限が頻繁に出る場合はどうすればよいですか。
A. 会話を区切る、不要な連携を外すなどで、消費を減らす方法があります。Claude Codeの使用量の節約 を参照してください。

筆者の見解(「usage limit」エラー)

私見では、上限メッセージが出たときに最初に見るべきは、文言の「session・weekly・Opus・Sonnet・spend」のどれかと、末尾のリセット時刻の2点だけです。モデル別の上限なら切り替えで続けられ、セッション上限なら数時間で戻るため、お金をかけずに済む場面は少なくないと考えます。見落としやすいのは、自動再開に任せて席を外すと、許可の確認で止まったままになることです。無人で進めたいなら、再開後に何をさせるかを事前に絞っておくほうが安全だと考えます。逆に、週間上限が月に何度も出るなら、その場しのぎの追加購入を重ねるより、使い方かプランを見直す時期だと考えます。

「usage limit」エラーの関連項目

出典(一次情報)

本記事は一般的な情報の提供を目的としています。Claude Code の料金・利用上限・機能・エラーメッセージ・コマンドは頻繁に更新されるため、最新の内容は Anthropic の公式ドキュメントとお使いのバージョンで必ずご確認ください。契約・請求・セキュリティに関する判断は、公式サポートや社内の担当部門にご相談ください。「筆者の見解」は一つの考え方です。