Claude Code usage limit reachedを解く｜再開の手順

Claude Codeで「Claude usage limit reached」と表示されるのは、通信エラーやバグではなく、契約プランの利用上限（セッション枠・週次枠）に達したサインです。結論から言えば、まず/usageで何がその枠を消費したかを確認し、メッセージに出るリセット時刻まで待つかusage creditsで続行し、そのうえで長時間セッションのlong contextやモデル選択を見直すと再発を抑えられます。この記事では、筆者が毎日記事を自動publishする運用で実際に上限に当たった経験もふまえ、原因の切り分けから今すぐ再開する手順、消費を減らすコマンドと設定値までまとめます。

01Claude Code usage limit reachedとは？まず確認すること

Claude Codeの「usage limit reached」とは、契約しているプランに割り当てられた利用枠を使い切り、モデルへのリクエストが一時的に止まった状態です。ネットワークの不調やインストールの失敗ではないため、再インストールや再ログインを繰り返しても解決しません。最初にやることは、上限メッセージに表示されるリセット時刻を読むことと、/usageで自分の消費状況を確認することの2点です。

これは通信エラーではないのか？

通信エラーではありません。公式ドキュメントでも、この表示はサブスクリプションプランのseat単位の利用ウィンドウに達したことを示すものとされています。したがって対処の方向性は「エラーを直す」ではなく「枠が回復するのを待つ」または「枠を増やす・消費を減らす」になります。ここを取り違えて設定をいじると、かえって原因の特定が遠回りになります。

3つの上限メッセージの違いは？

Claude Codeが出す上限系のメッセージは主に3種類あり、意味が異なります。「You’ve hit your session limit」「You’ve hit your weekly limit」はプランのseat枠に達したもので、全モデルで共有される枠です。一方「You’ve hit your Opus limit」はOpusというモデル個別の枠で、こちらは/modelで別モデルに切り替えれば作業を続けられます。さらに、文脈が長くなったときに出る「context / auto-compact」の警告は利用上限ではなく、会話が入力の上限に近づいたので古い履歴を要約している合図です。

02なぜusage limit reachedが出るのか？主な原因

上限に達する背景には、プラン側の「枠の仕組み」と、使い方側の「消費の増え方」の2つがあります。まず枠の仕組みから押さえると、どこを調整すべきかが見えてきます。

セッション枠と週次枠はどういう仕組み？

公式ドキュメントによると、Claude Codeの利用枠はローリングの5時間ウィンドウと週次ウィンドウで管理されます。TeamやEnterpriseではseatごとの割り当てから消費され、この枠はClaudeのチャットやCoworkとも共有されます。つまりチャットで大量に使った日は、その分Claude Code側の枠も少なくなる、という関係です。枠の大きさはプランやseatのティアで変わり、Pro・Max・Team・Enterpriseで上限が異なります。

長時間のセッションで消費が跳ねるのはなぜ？

一日中開いたままのセッションは、体感の作業量よりずっと多く枠を使うことがあります。Claude Codeは毎回のリクエストで会話全体を送るため、履歴が長いほど1回のやり取りが重くなります。加えて、キャッシュの有効期間（サブスクリプションでは1時間）を超えて放置したあとの最初のメッセージはcache missになり、文脈全体を再処理します。定期実行タスクやエージェントのチームメイトも、待機中や並列実行のあいだ枠を消費し続けます。次の表は、代表的な消費源と兆候の対応です。

03usage limit reachedの対処法｜今すぐ再開する手順

上限に当たったときの動きは、大きく「待って回復させる」「枠を増やして続ける」「消費を減らして次に備える」の3択です。まずは今すぐ再開したい人向けに、順序立てて説明します。

いつリセットされる？

リセットの時刻は、上限メッセージ自体に表示されます。週次ウィンドウはアカウントごとに固定の曜日・時刻でリセットされ、作業を始めた時刻や契約開始日に関係なく一定です。claude.aiの設定＞使用状況（Usage）でも、自分の正確なリセット時刻を確認できます。5時間のセッション枠であれば、数時間で回復するのが一般的です。

上限を超えて続けるには？

納期が迫っていて待てない場合は、usage credits（追加利用枠）を使う方法があります。/loginでclaude.aiのサブスクリプションにサインインしたうえで/usage-creditsを実行すると、Pro・Maxでは請求設定が開き、枠を超えた利用を有効にできます。ただしAPIキー認証では使えません。手順を整理すると次のとおりです。

• 上限メッセージのリセット時刻を読む（週次か5時間セッションかを判別する）。
• 「Opus limit」の表示なら/modelでSonnet等へ切り替え、そのまま作業を続ける。
• 今すぐ枠を増やしたい場合は/usage-creditsでusage creditsを有効化する。
• 急がないなら/clearで不要な履歴を捨て、リセット後に軽い状態で再開する。

04/usageコマンドで消費の内訳を確認する方法

やみくもに待つ前に、/usageで「何が枠を食っているか」を確かめると、対処の精度が上がります。Pro・Max・Team・Enterpriseのプランでは、/usageが枠に対する消費の内訳を表示し、スキル・サブエージェント・プラグイン・個々のMCPサーバーごとに、それぞれ全体の何パーセントかを示します。long contextやcache missのように、ひとつで最近の消費の10%以上を占める挙動には注意フラグが付きます。

24時間と7日の内訳を切り替える

画面でdを押すと直近24時間、wを押すと直近7日の内訳に切り替わります。数値はこのマシンのローカルなセッション履歴から概算したもので、別の端末やclaude.aiでの利用は含まれません。VS Code拡張でも、Account & usageダイアログにDay/Weekの切り替えとして同じ内訳が出ます（Claude Code v2.1.174以降）。

「rate limited」で内訳が出ないときは？

使用状況の取得先が混雑していると、/usageは直近60分以内に読み込んだ最後の内訳を「Showing last-known usage」と添えて表示します。rを押すと再取得を試み、成功すれば最新の内訳に置き換わります。60分以内のスナップショットが無い場合は、使用状況エンドポイントが混雑している旨と再試行のショートカットが表示されます。

05トークン消費を減らして上限に当たりにくくする設定

上限に当たる回数そのものを減らすには、文脈を小さく保つのが基本です。トークンは処理する文脈の大きさに比例して増えるため、次の設定を組み合わせると、同じ作業量でも消費を抑えられます。

文脈を小さく保つコマンドを使う

作業のテーマを切り替えるときは/clearでセッションを仕切り直します。/clearは履歴を捨てるだけなので、それ自体はトークンを消費しません。要約して残したいときは/compactを使い、残す観点を指定できます。プロジェクト直下のCLAUDE.mdに要約の方針を書いておくと、圧縮のたびに反映されます。

# Compact instructions

When you are using compact, please focus on test output and code changes

モデルと拡張思考はどう調整する？

多くのコーディング作業はSonnetで十分で、Opusより消費を抑えられます。/modelでセッション中に切り替えるか、/configで既定を設定します。サブエージェントにはmodel: haikuを指定すると軽くなります。拡張思考は既定で有効ですが、単純な作業では/effortで努力レベルを下げるか、MAX_THINKING_TOKENS環境変数で思考の予算を絞ると、出力トークンを節約できます。

# 単純作業では思考の予算を絞る
export MAX_THINKING_TOKENS=8000

MCPサーバーの負荷はどう下げる？

MCPのツール定義は既定で遅延読み込みされ、実際に使うまでは名前だけが文脈に入ります。それでも接続数が多いと積み上がるため、/contextで何が容量を使っているかを確認し、/mcpで使っていないサーバーを無効化します。ghやaws、gcloudのようにCLIで済むものは、MCPより文脈効率が良いので優先します。詳しい選び方はweb制作におすすめのMCPサーバー厳選5選でも整理しています。

06従来の対処と何が変わったか【比較表】

以前は「上限に当たったらとにかく待つ」しか手がありませんでした。/usageの内訳表示やusage credits、要約からの再開が入ったことで、対処の考え方そのものが変わっています。違いを表にまとめます。

この内訳表示という仕様差から、アウトプットにも差が出ると想定されます。これまで「とりあえず待つ」で終わっていた対処が、たとえばlong contextが消費の6割を占めるなら/clear、MCPが上位なら/mcpで無効化、というように、原因を名指しして減らす対処へ変わると考えられます。※ここは公式が示す機能仕様からの想定で、削減量を保証するものではありません。

07サイト制作・自社ツール開発で上限に当たらない運用【実践】

筆者はLP・サイト制作のコーディングと、記事を毎日自動publishする社内ツールの両方でClaude Codeを使っています。どちらも放っておくと枠を早く使い切るため、次の設定で消費を平準化しています。すべて設定ファイルに書けるので、そのまま流用できます。

サイト制作：テスト出力を間引くフックを入れる

コーディングでは、テストやビルドの長いログをそのまま読ませると文脈が一気に膨らみます。settings.jsonにPreToolUseフックを入れて、テスト実行時は失敗行だけを返すようにすると、数万トークンぶんの出力を数百トークンに圧縮できます。次はフックの登録部分です。

{
  "hooks": {
    "PreToolUse": [
      {
        "matcher": "Bash",
        "hooks": [
          { "type": "command",
            "command": "~/.claude/hooks/filter-test-output.sh" }
        ]
      }
    ]
  }
}

フックの中身は、コマンドがテストランナーのときだけgrepで失敗行に絞るスクリプトにします。登録後は/hooksでPreToolUseに出ているかを確認し、claude --debugでmodified tool input keysが出れば動いています。実装前の探索はClaude Codeプランモードの使い方でまず方針を固めると、手戻りぶんの消費も避けられます。

自社ツール開発：定期実行と自動化の消費を抑える

記事の自動publishのような定期実行では、セッションを開いたままにすると、待機中でも定期タスクが文脈を送り続けて枠を削ります。ジョブごとに処理を短く区切り、テーマが変わるところで/clearを挟むのが基本です。読み込ませる指示はCLAUDE.mdに全部書かず、使うときだけ読み込むスキルへ逃がすと、無関係な作業のあいだも抱えるトークンを減らせます（CLAUDE.mdは200行以内が目安）。単純な整形やログ抽出は、フックで前処理してから渡すと本体の消費を抑えられます。よく使うコマンドの整理は非エンジニアのClaude Codeスラッシュコマンド12選も参考になります。

FAQよくある質問

09まとめ：原因を特定して減らす

「usage limit reached」に振り回されるかどうかは、上限を「待つもの」と捉えるか「内訳から減らすもの」と捉えるかで変わります。まずは/usageで消費の上位を見て、long contextなら/clear、Opus既定ならSonnetへ、MCP過多なら/mcpで無効化、と一つずつ当てていくのが失敗しない進め方です。急ぐときはusage creditsで超過分を続け、日常はモデルと文脈の管理で枠を平準化します。関連する詰まりはClaude Codeの文字化けを直す方法やClaude Codeチェックポイントとは？巻き戻しの使い方でもまとめています。

10出典

・Anthropic 公式ドキュメント「Manage costs effectively」（Claude Code Docs, code.claude.com/docs/en/costs）
・Anthropic 公式ドキュメント「Usage limit errors / When a developer asks about a limit」（Claude Code Docs）
・claude.com/pricing（プラン別の料金・上限）