Claude Codeでトークン消費が大きいと感じたときに確認したいポイント
Claude Codeを使っていると、「いつもよりトークン消費が大きい」「思った以上にコストがかかっている」と感じることがあります。
特に長時間のセッションや、大きなファイル・ログを扱う作業では、コンテキストが大きくなり、1回のリクエストで処理するトークン量も増えます。
ここでは、トークン消費が大きいと感じたときに確認したいポイントをまとめます。
1. /context でコンテキスト使用量を確認する
まずは以下を実行します。
/context/context では、現在のセッションで何がコンテキストを消費しているのかを確認できます。
Claude Codeのコンテキストには、以下のような情報が含まれます。
- 会話履歴
- 読み込んだファイル
- コマンドの実行結果
CLAUDE.md- MCP関連の情報
- Skillsやシステム関連の情報
そのため、単純に「会話が長い」だけでなく、巨大なログやファイル、MCPなどが原因になっている場合もあります。
/context を見て、特定のファイルやツール出力などが極端に大きくなっていないかを確認します。
2. /usage でトークン使用量を確認する
次に、現在のセッションの使用量を確認します。
/usage/cost は /usage のエイリアスとして利用できます。
/cost/usage では、セッションのAPIトークン使用量やコストの推定値などを確認できます。
特に確認したいのは、以下の項目です。
- Input Tokens
- Output Tokens
- Cache関連の使用量
- セッション全体の使用量
「いつもよりInput Tokensが極端に増えている」といった場合は、巨大なファイルやログ、長い会話履歴などがコンテキストに含まれていないか確認します。
表示されるコストは推定値であり、実際の請求額とは異なる場合があります。あくまでセッションの利用傾向を確認するための目安として見るのがよさそうです。
3. 「○％を超えたら危険」とは考えない
コンテキスト使用率について、次のような固定値を決めたくなることがあります。
- 50％なら注意
- 70％なら危険
- 90％なら即リセット
ただし、これらはClaude Codeの公式な危険ラインではありません。
重要なのは、現在どの程度コンテキストを使用していて、何がその容量を消費しているのかです。
例えば、/context で大きなファイルやツール出力が大量に表示されている場合は、コンテキスト使用率そのものよりも「なぜそこまで増えたのか」を確認します。
また、Claude Codeにはコンテキストが上限に近づいた際に、自動的にコンパクションする仕組みもあります。
「70％だから危険」と判断するより、
/context を使って、何がコンテキストを占有しているのかを確認するほうが重要です。
4. トークン消費が大きいときの対処方法
/compact を実行する
現在の会話を要約して、コンテキストを整理できます。
/compact必要に応じて、残したい情報を指定することもできます。
/compact コード変更内容とテスト結果を中心に残してください長いセッションでは、タスクの区切りで /compact を実行する方法も有効です。
/clear で新しいセッションを開始する
別の作業に移る場合は、以下を実行します。
/clear関係のない作業を同じセッションで続けると、過去のコンテキストが後続の処理にも影響します。
タスクが変わったタイミングでセッションを分けるのも有効です。
巨大なファイルやログを必要以上に読み込ませない
大きなログやファイルを毎回読み込ませると、その分コンテキストを消費します。
/context で特定のファイルやツール出力が大きな割合を占めていないか確認し、必要な範囲だけを読み込ませるようにします。
例えば、大量のログを丸ごと渡すのではなく、エラー周辺だけを切り出して渡す、といった方法です。
不要なMCPサーバーを無効化する
MCPサーバーの情報もコンテキストに影響します。
常に必要ではないMCPサーバーを多数有効化している場合は、利用頻度の低いものを無効にすることでコンテキスト削減につながる場合があります。
5. Opusを使う必要があるかも確認する
Claude Code公式ドキュメントでは、Sonnetは多くのコーディング作業に適しており、Opusは複雑なアーキテクチャ設計や複数ステップの推論などに利用することが推奨されています。
そのため、すべての作業でOpusを使用するのではなく、タスクに応じてモデルを使い分けることもコスト削減につながります。
モデルは /model で変更できます。
/model日常的な実装や修正で十分ならSonnet、複雑な設計や長い推論が必要な場面ではOpus、というように使い分けることで、必要以上に重いモデルを常用するのを避けられます。
まとめ
Claude Codeで「トークンを使いすぎている」と感じた場合は、まず以下を確認すると原因を切り分けやすくなります。
| 確認項目 | コマンド | 確認するポイント |
|---|---|---|
| コンテキスト | /context |
何がコンテキストを消費しているか |
| 使用量・コスト | /usage |
Input / Outputなどの使用量 |
| コスト確認 | /cost |
/usage と同様の情報を確認 |
| コンテキスト整理 | /compact |
会話履歴を要約して整理 |
| セッション切り替え | /clear |
不要な過去コンテキストを切り離す |
| モデル変更 | /model |
タスクに適したモデルを選択 |
「70％を超えたら危険」のような固定値で判断するより、/context と /usage を使って、何がトークンを消費しているのかを確認することが重要です。
特に、長時間のセッション、大きなログ・ファイルの読み込み、MCPや CLAUDE.md などのコンテキスト量が大きくなっていないかを確認すると、トークン消費の原因を見つけやすくなります。
トークン消費が気になったら、いきなりセッションを捨てるのではなく、まず
/context で原因を確認する。そのうえで /compact、/clear、モデル変更などを選ぶ、という順番で考えると切り分けやすくなります。
ここまで読んでいただき、ありがとうございます。もしこの記事の技術や考え方に少しでも興味を持っていただけたら、ネクストのエンジニアと気軽に話してみませんか。
- 選考ではありません
- 履歴書不要
- 技術の話が中心
- 所要時間30分程度
- オンラインOK
