カテゴリー / 利用制限・トークン

Claude Codeのトークン上限の見分け方|表示別に確認する手順

この記事の目次

Claude Codeの「トークン上限」は、表示で種類を分けて初手を選ぶ。

  • Context limit reached:会話の長さ。続きが必要なら /compact、不要なら /clear
  • セッション制限・週間制限の表示:プランの使用量。/usage で確認し、リセットまで待つ
  • (not your usage limit) 付きの表示:短時間のスロットル。少し待って再試行
  • Request rejected (429):APIキー等のレート制限。/status で認証情報を確認

Claude Codeの「トークン上限」は何を指すのか

公式ヘルプの「使用量と長さの制限はどのように機能しますか?」は、Claudeの制限を「使用量制限」と「長さ制限」の2種類に分けて説明している。これはClaude全体のヘルプによる整理で、Claude Codeのプラン別の固定枠や料金を示すものではない。使用量制限はすべての会話にまたがって期間内にどの程度使えるかを、長さ制限は単一の会話がどの程度長くなれるかを制御する。

Claude Codeでは、この2種類に加えて、プランの枠とは無関係な短時間のスロットルや、APIキー・クラウドプロバイダー側に設定されたレート制限の表示も出る。まず長さ・使用量・レートのどれに近いかを決めるとよい。

長さ・使用量・レートを先に分ける

種類 対象範囲 表示の手掛かり 初手
長さ制限 1つのチャットで処理できる情報量(コンテキストウィンドウ) Context limit reached /compact か /clear
使用量制限 全会話にまたがる期間内の「会話予算」 セッション制限・週間制限の表示 リセットを待つか、プラン変更を検討
短時間のスロットル プランの枠とは無関係 (not your usage limit) が付く 少し待って再試行
APIキー等のレート制限 APIキー、Amazon Bedrock、Google Cloudのプロジェクト Request rejected (429) /status で認証情報を確認

コンテキストウィンドウのサイズはモデルで異なり、一部は応答用に予約されるため、全体をそのまま会話に使えるわけではない。有料プランの使用量制限には、5時間ごとにリセットされるセッション制限と、週に1回リセットされる週間制限がある。長さ制限は待つだけでは解消せず、/clear でプランの使用量は戻らない。

Claude.aiとClaude Codeの使用量をどう扱うか

公式ヘルプは、claude.ai、Claude Code、Claude Desktopの使用量が同じ使用量制限にカウントされると説明している。対象はこの3つに限り、APIキーやサードパーティツールまで同じ枠だとは広げられない。

経路 公式に同じ使用量制限とされるか 注意
claude.ai、Claude Code、Claude Desktop される どれで使った分も同じ枠に数えられる
APIキー、クラウドプロバイダー 記載なし 使用量制限後の自動継続の対象外
サードパーティツール 記載なし 推奨接続はClaude Consoleか対応クラウドのAPIキー認証

表示と発生タイミングから上限の種類を判定する

公式のError referenceは、表示文言ごとに原因と対処を分けている。文言を照合すると、次の4区分に置ける。

  1. 会話の長さ(コンテキスト容量)
  2. セッション・週間の使用量制限(全モデル共有)
  3. Opus・Sonnetのモデル系統別の使用量制限
  4. 短時間のスロットル、またはAPIキー等の429

タイミングも手掛かりになる。会話と添付ファイルが大きくなった直後なら1を疑う。重い大量処理の直後なら2を疑う。使用量はセッション枠と週間枠に同時に数えられ、週間枠がセッション枠のリセットより先に尽きることもある。

会話の長さやコンテキスト容量が問題のとき

会話と添付ファイルがコンテキストウィンドウを超えると、対話セッションでは次の表示が出る。自動圧縮が無効な設定やBedrock・ゲートウェイ経由では文言が変わることがある。

表示・状態 意味 続きが必要な場合 続きが不要な場合
Context limit reached · /compact or /clear to continue コンテキストウィンドウを超えた /compact /clear
自動圧縮を無効にしている 既定でオンの自動圧縮が働かない 手動の /compact か設定を戻す /clear

自動圧縮は /config、DISABLE_AUTO_COMPACT、DISABLE_COMPACT、上位の設定スコープで無効になる場合がある。

セッション・週間・モデル別の使用量制限が問題のとき

使用量制限では、表示されたリセット時刻までリクエストが止まる。モデル変更が効くかは制限の種類で決まる。

表示 共有枠かモデル別枠か リセット・切り替え条件
セッション制限・週間制限 全モデルで共有 表示されたリセットまで待つ。モデル変更では戻らない
Opus制限・Sonnet制限 そのモデル系統だけ /model で系統外のモデルに切り替えると続けられる

使用量は会話の長さと複雑さ、機能、モデル、努力レベルで変わる。Pro・Max・Teamなどのプランでも許容量が異なるため、共通の「何回で上限」という数は無い。

claude.aiのサブスクリプションでサインインした対話セッションでは、開いたまま待てばリセット後に作業が自動で続く。この自動継続は既定でオンで、Claude Code v2.1.234以降が必要で、/config でオフにできる。APIキー、クラウドプロバイダー、使用量ベースの課金、バックグラウンドセッション、-p 実行は対象外である。

短時間の制限・429を疑うとき

表示 制限の所在 確認先 最初の操作
Server is temporarily limiting requests (not your usage limit) プラン枠と無関係な短時間のスロットル 続く場合はサービス状態 少し待って再試行
Request rejected (429) APIキー、Bedrock、Google Cloudのプロジェクトのレート制限 /status 有効な認証情報を確認

429はサブスクリプションのセッション・週間制限とは別物である。環境に残った ANTHROPIC_API_KEY があると、サブスクリプションではなく低いティアのキーで送られることがある。

上限に達したときの確認手順

表示を見た直後は、次の4段階で進めるとよい。各段で使うコマンドの役割は、公式のCommandsの説明に沿っている。

段階 記録・確認するもの 次の分岐
1 表示文言、リセット表示、直前の作業 2で照合
2 文言と判定表の対応 長さ・使用量・レート
3 /usage・/context・/status の結果 4で選択
4 確認結果に合う続け方 待機・/compact・/clear・/model

1. 表示文言と発生タイミングを記録する

  • 表示文言の全文((not your usage limit) のような末尾の語まで)
  • リセット時刻の表示があるか
  • 直前に長い会話・大きな添付・大量の処理のどれがあったか

2. 文言から種類を決める

一度きりの表示かどうかだけで決めず、文言を前の節の表に照合する。同じ「止まった」でも、長さ制限は単一の会話の長さ、使用量制限は全会話にまたがる期間内の量なので、戻し方が違う。not your usage limit が付く表示はプランの枠ではない。

3. /usage・/context・/statusを確認する

/usage はセッションのコスト、プランの使用量上限、活動統計を表示し、上限とリセット時期を確かめられる(内訳は対象プランで変わる)。/context は現在のコンテキスト使用量をグリッドで示すが、期間内の使用量や認証情報の確認には使えない。/status では有効な認証情報を確認する。/usage だけではAPIキーのレート制限は判定できない。

4. 待機・圧縮・新しい会話を選ぶ

長さ制限なら、続きが必要なときは /compact、不要なときは /clear を選ぶ。セッション・週間制限なら、表示されたリセットまで待つかプランのアップグレードを検討する。モデル変更では戻らない。Opus・Sonnetの系統別制限なら、/model で系統外のモデルに切り替える。自動継続の条件を満たす対話セッションなら、開いたまま待てばリセット後に作業が続く。

上限に近づく原因と最初の対処

公式のManage costs effectivelyは、処理するコンテキストが多いほどトークン使用量が増えると説明している。Claude Codeはリクエストごとに会話全体を送るため、長く開いた会話では短い質問でも使用量が増える要因になる。これは仕組みの説明で、個別の消費量を計算する式ではない。使用量は機能、モデル、努力レベルでも変わるため、会話、常に読み込まれる設定、MCP、モデルの順に見ると絞り込みやすい。

会話・入力・ファイルが大きい場合

会話と添付ファイルがコンテキストウィンドウを超えると長さ制限に当たる。超える前でも、コンテキストが大きいほど各リクエストの使用量は増える。

原因候補 /contextで見る項目 初手
長く続いた会話 現在のコンテキスト使用量 同じ作業の続きなら /compact
大きな添付ファイル 現在のコンテキスト使用量 不要になった会話は /clear で区切るとよい
別の作業への切り替え 現在のコンテキスト使用量 /clear で新しい会話を始める

CLAUDE.md・MCP・モデルの影響

原因候補 公式に確認できる動き 初手
CLAUDE.md セッション開始時にコンテキストへ読み込まれる 専門的な指示をSkillsに分け、呼び出し時だけ読み込ませるとよい
MCP ツール定義は既定で遅延読み込み。使うまではツール名とサーバーの指示だけが入る /context で消費箇所を見て、未使用のサーバーを /mcp で無効化
モデル・努力レベル 使用量に影響する要因に含まれる 作業に合うモデルと努力レベルを選び直すとよい

遅延読み込みは既定の動作で、すべてのMCP設定がコンテキストを消費しないという意味ではない。CLAUDE.md を分けたときの節約量に固定の値は無い。

続きが不要なら/clear、必要なら/compact

/compact はここまでの会話を要約してコンテキストを空ける操作、/clear は空のコンテキストで新しい会話を始める操作である。前の作業と関係のない作業に移るなら /clear、同じ作業の続きなら /compact を選ぶとよい。どちらもプランの使用量制限は戻さない。

詳細はテーマ別の記事へ進む

この記事は表示から種類を判定する入口で、各テーマの詳細は個別の記事にまとめている。

プラン・使用制限

プランの選択や枠の詳細はClaude Codeの料金プランとClaude Codeの使用制限、セッション枠と週単位の枠はセッション制限と週間制限の記事で扱う。

トークン・コンテキスト・残り枠

定義や残り枠の読み方はClaude Codeのトークン基礎、コンテキストウィンドウ、残りトークンの確認の記事で扱う。

節約・設定・レート制限

節約や設定、MCP、429の詳細はトークン節約、おすすめ設定、MCP、レート制限の記事で扱う。

まとめ

Claude Codeの「トークン上限」は、会話の長さ、プランの使用量、短時間のレートのどれかに分けて考える。表示文言で種類を決め、/usage・/context・/status で使用量、コンテキスト、認証情報を確かめてから、待機・/compact・/clear・/model を選ぶ。長さ制限は会話を区切れば続けられるが、/clear で使用量は戻らない。表示文言やコマンドの挙動は更新されることがあり、この記事は2026年10月19日に照合した公式資料に基づく。

上限の種類を見分けられるようになった次に出てくる問いは、「なぜ自分の使い方だとすぐ上限に当たるのか」という、より個別的な設計や運用の課題であることが多い。これは記事を読むだけで解決しきれる範囲を超えることもあるため、そうした問いを自分の手で扱えるようになりたい場合は、月額1,980円から参加できる学習コミュニティ「AI駆動ラボ」で、Claude Codeの使い方を体系的に学び直す場として活用してほしい。