Claude Codeでトークンはどこへ行くのか：9つの損失パターンと2026年の修正方法

ある例では、新しいClaude Codeセッションで/contextを実行すると、最初のメッセージを送る前に200K中60Kトークンが使用済みと表示されました。プロジェクトのリポジトリで起動したのはclaudeだけでした。60Kトークン、つまり会話の「準備」に予算の3分の1を使っていたのです。

2週間後、どこに使われていたのかを正確に突き止めました。以下では、入力を始める前にトークンを消費する9つのパターンすべてと、その修正方法を説明します。数値の出典はAnthropicの公式ドキュメントと実セッションの測定値です。

「プロンプトの前にトークンの73%が失われる」とはどういう意味？#

以下の9つのパターンを、実セッションの測定値とAnthropicの公式コスト管理ページの数値とともに、1つの表にまとめました。

「73」という数字が絶対に正しいとは言いません。設定によって60%かもしれないし、80%かもしれません。ただし全体像は正しく、それぞれのパターンは個別に修正できます。以下では3つずつ取り上げます。

リクエストを読む前にClaudeはどうやってコンテキストを構築する？#

ウィンドウのサイズはモデルによって異なります。Anthropicのモデルドキュメントによると、2026年9月時点では、Opus 4.7以降、Sonnet 5、Fableモデルは、Proを含むすべてのプランで1Mトークンのウィンドウに対応しています。拡張コンテキストを使わないOpus 4.6とSonnet 4.6、およびCLAUDE_CODE_DISABLE_1M_CONTEXT=1変数で1Mを無効にしたセッションでは、引き続き200Kです。ウィンドウが大きくなっても、コンテキストの肥大化は解決しません。最初のメッセージを送る前に読み込まれたものは、リクエストごとにモデルへ送られ、コストに関するドキュメントも、コンテキストが大きいほど消費トークンが増えると明記しています。サブスクリプションでも変わりません。どのプランでも、トークンが1つ増えるたびに上限を消費します。

コンテキストの最初の3分の1はどこへ行く？ CLAUDE.md、履歴、MCP#

パターン1. すべてのメッセージの前に読み込まれるCLAUDE.md

CLAUDE.mdは、各セッションで一度だけでなく、送信するすべてのメッセージの前に読み込まれます。5,000トークンのCLAUDE.mdは、それを含む要求で同じ文脈量を占めますが、新規入力、キャッシュ書き込み、読み取りは別に計上します。繰り返す部分が必ず未キャッシュの全額単価になるわけではありません。

Anthropicのドキュメントには、次のように直接書かれています。

ある例では、プロジェクトのCLAUDE.mdは180行です。ワークショップの手順、TG投稿の形式、法務チェックリストなどの専門的な内容はすべてSkillsとbusiness/内のMarkdownファイルに移されており、Claudeはそこを明示的に参照するときだけ読み込みます。その結果、2か月前と比べてベースラインが60-70%減少しました。

パターン2. 返信のたびに読み直される会話履歴

これは外から最も見えにくいパターンです。表面には現れません。後続の要求には保持した会話文脈を渡します。安定した接頭辞はプロンプトキャッシュで再利用でき、圧縮やクリアで保持文も変わります。料金が下がっても、繰り返す文脈はウィンドウを占めます。

対策は、関係のないタスクに移るときに/clearを使うことです。私のルールは、タスクが変わるたびに新しいチャットを始めることです。長いタスクで履歴を残したい場合は、/compactで過去を短い要約にしてから続けてください。

このルールについては、私のセッションの例を使ったガイド「1日でClaude Codeの利用上限を使い切らない方法：トークンを節約する8つのルール」で詳しく説明しています。

パターン3. MCPサーバーはすべてのツールをコンテキストに登録する

Anthropicは2025年12月から2026年1月にかけて、この問題の半分を解決するTool Search機能をリリースしました。

Anthropicのドキュメントでは、現在次のように説明されています。

本番環境で行うこと：

1. Tool Searchに対応したバージョンへClaude Codeを更新する（2025年12月以降の現行バージョンはすべて対応）。
2. /mcpを開き、現在のセッションで不要なサーバーを無効にします。ここで紹介する例では、Playwrightとshadcnの2つだけを常時接続しています。ほかのサーバーはタスクごとに有効化し、終わったらすぐに/mcp disconnectを実行します。
3. 可能ならMCPをCLIに置き換える。GitHubにはMCPサーバーの代わりにghを使います。Google Calendar MCPの代わりに、ブラウザーでカレンダーを使います。

MCPサーバーの基本と適切な設定方法は、「2026年のClaude Code MCPサーバー：すぐに使える7つの設定と段階的なインストール方法」で解説しました。

CLAUDE.mdとSkillsの問題は、単にサイズだけではなく、構造にもあります。中核となる指示ファイルがCLAUDE.mdです。対象読者、製品、法務文書、日ごとの指示など、追加のプロジェクト知識はbusiness/フォルダーに置きます。これが私の方法論でいうSecond Brainです。Claudeは必要なものだけを読み込み、この段階ですでにコンテキスト圧縮が行われます。全体の説明は「Claude CodeのSecond Brain」にあります。

セッション中に蓄積されるもの、削減できないものは？#

パターン4. セッション中に蓄積するツール出力

あまり語られない点があります。Claudeがbash cat huge-file.logを実行すると、そのコマンドの出力全体がコンテキストに入り、セッション終了または/clearまで残ります。大きなファイルをReadした場合も同じです。10,000行すべてが残り、以降のすべてのメッセージでトークンを消費します（パターン2を参照）。

対策：

1. すべて読む代わりにhead、tail、grepを使う。Read deploy.logの代わりにbash tail -100 deploy.logを使います。出力をすぐに10-100分の1に減らせます。
2. 前処理用のフックを使う。~/.claude/hooksにスクリプトを置き、Claudeが見る前にbashの出力をフィルタリングします。Anthropicのドキュメントにある例は、テスト結果をすべて表示する代わりに、npm test 2>&1 | grep -A 5 -E 'FAIL|ERROR'を実行するPreToolUseフックです。出力を50-100分の1に圧縮できます。詳しくは「2026年のClaude Code Hooks：段階的な設定方法とすぐに使える7つの例」を参照してください。
3. 大きなファイルを読んだ後は/clearを実行する。特定のタスクで大きなファイルを読んだ後、もう必要がないなら「念のため」にコンテキストへ残さず、新しいチャットを始めます。

パターン5. システムプロンプト + システムツール = 恒常的なベースライン

ほとんど何もできないため、このパターンは変更できません。Claude Codeはシステムプロンプト（約3 200トークン）と、組み込みツールの説明（Read、Edit、Write、Bash、Glob、Grep、WebSearch、WebFetch、TodoWrite、約16 100トークン）を読み込んで始まります。合計で19 300トークンの恒常的なベースラインがあり、削減できません。

実際にできること：

• 把握する。恒常的なベースラインとして19Kの「負担」があると知っておきます。200Kのウィンドウなら、200K - 19K = 181Kが、その他すべてに使える容量です（CLAUDE.md、MCP、自動圧縮用バッファを除く）。1Mのウィンドウにはもっと余裕がありますが、その「負担」はリクエストのたびについてきます。
• 繰り返す処理を測る。基礎文脈はウィンドウを占め、後続要求でも処理されえます。セッションごとの1回払いではありません。費用は入力、キャッシュ書き込み・読み取り、出力を分けて計算します。

スキル、プラグイン、エージェントチームでトークンはどこへ行く？#

パターン6. スキルとプラグインが二重登録されることがある

この問題は、Claude Codeにプラグインが導入された2025年後半に現れました。スキルを追加するプラグインをインストールすると、そのスキルがコンテキストに入ります。同様のユーザースキルを~/.claude/skills/にもインストールしていれば、そちらも読み込まれます。そして、重複することもあります。

VercelはAIスタックの調査で数値を公表しました。セッション中にスキルの56%が一度も呼び出されないのに、その説明は常にコンテキストに読み込まれます。1つあたり100トークンなら、スキルが100個あると最大5 600トークンの「荷物」になります。

対策：

1. 実際に何が使用されているかは/contextで確認する。Skillsの項目が3Kを超えていたら整理します。
2. ls ~/.claude/skills/を実行し、インストール済みのスキルを確認します。1か月以上使っていないものは削除します。
3. /plugin removeを使い、「試すため」にインストールして忘れていたプラグインを削除します。

Skillsの適切な構造とCLAUDE.mdとの違いについては、「2026年のClaude Code Skills：個人用スキルライブラリの構築方法」で解説しています。

パターン7. Plan Modeではエージェントチームが7倍のトークンを消費する

エージェントチームとは、Claude Codeがそれぞれ独自のコンテキストを持つ複数のモデルインスタンスを並列で立ち上げる機能です。Anthropicのドキュメントには、次のように直接書かれています。

つまり、Plan Modeで5人のチームを組むと、それぞれが独自のシステムベースライン、CLAUDE.mdのコピー、MCPツールを読み込む5つの並列セッションになります。トークンの総消費量は非線形に増加します。

対策：

1. チームメンバーにはSonnetかHaikuを使う。指揮するチームリーダーだけにOpusを使います。単価は低い場合がありますが、一定の節約を仮定せず、各メンバーのタスク全体の費用と品質を測ってください。
2. チームは小さくする。10人ではなく、2人か3人にします。
3. 動いていないチームメンバーを終了する。タスクが終わってもメンバーが動いたままだと、バックグラウンドでトークンを消費し続けます。

Plan Modeと、いつ本当に役立つかについては、「Claude CodeのPlan Mode：2026年の段階的ガイドと4つのステージ」で詳しく説明しています。

見ていない間にClaudeがトークンを消費するのはどんなとき？#

パターン8. 関与していない間にも使われる拡張思考のトークン

拡張思考は、Claudeが回答前に非表示の思考ブロックで解決策を「考える」モードです。計算上、これらは通常の返信と同じように数えられる出力トークンですが、チャット上には表示されません。

Anthropicのドキュメントには、次のように書かれています。

つまり、複雑なリクエスト1件で10-30Kの思考トークンを使い、「予算を食いつぶす」ことがありますが、チャットに表示されるのは短い要約だけです。

対策：

1. 単純なタスクでは /effort low を使います。思考の予算を最小限に抑えられます。
2. MAX_THINKING_TOKENS=8000を環境に設定し、上限を設けます。
3. Claudeが「考える」必要のないごく定型的なタスクでは、/config → thinkingを無効にする。

複雑なアーキテクチャや多段階の推論など、思考が役立つ場面とそうでない場面については、「Claude CodeでSonnetかOpus 4.7か：2026年のモデルと/effortの選び方」で解説しています。

パターン9. アイドル中のバックグラウンド要約

これはとても小さいものの、興味深いパターンです。Claude Codeは、claude --resumeコマンド用に以前のセッションを要約するバックグラウンドプロセスを実行します。入力していないときも動きます。

Anthropicは関連ドキュメントで、次のように明記しています。

セッションあたり4セントなら大したことはありません。しかし1日に10セッションを開いていれば、受動的な消費は1日ですでに$0.40、1か月で$12です。今すぐ必要のないセッションは閉じてください。インデックスから/resumeを使えば、セッションを復元できます。開いたままにしておく必要はありません。

損失を測る方法：/contextコマンドと注意点#

まずはコマンドから。Claude Codeで/context（計算には/usage）を開くと、次のような表示が得られます。

コンテキストウィンドウ: 200 000 tokens

システムプロンプト:        3 200 (1.6%)
システムツール:           16 100 (8.0%)
MCPツール:              12 600 (6.3%)
CLAUDE.md:                4 800 (2.4%)
メモリファイル:            3 000 (1.5%)
会話:                     18 400 (9.2%)
空き領域:               141 900 (71.0%)

これは初回のクリーンアップ後にできる、標準的な恒常的ベースラインです。よい状態です。ウィンドウの71%が空いています。

既知の/contextのバグ：MCPを3倍に過大表示

最近の更新までは、/contextは実際のMCPによる損失を約3倍に表示していました。ツールごとのオーバーヘッドが個別に数えられていたためです。

Cameronによると、Anthropicはこれを現行バージョンで修正し、同じXcodeBuildMCPについて12 600と表示するようになりました。したがって：

1. /contextでMCPツールが50K以上と表示される場合—Claude Codeの古いバージョンを使っている可能性があります。更新してください。
2. MCPが8-15Kの場合—正常です。Tool Searchを使った場合の実コストです。
3. 新しいバージョンでMCPが30-50Kの場合—未使用のサーバーが多数接続されています。/mcpを開いて切断してください。

/context以外に確認すること

/usage—過去24時間または7日間のプラン使用量を表示します。ProとMaxでは、スキル、サブエージェント、プラグイン、個々のMCPサーバーごとの内訳も表示されます。どのスキルが最も消費しているかを特定するのに便利です。

/cost—APIユーザー向けです。現在のセッションの按分コストをドルで表示します。Pro/Maxの加入者には不要です。

/usage-credits—Pro/Maxで月間の支出上限を設定できます。スクリプトで動くエージェントチームが誤ってクレジットカードの上限まで使い切るのを防ぎたい場合に便利です。

15分でClaude Codeのコンテキストを整理する方法#

Claude Codeでプロジェクトを開き、次の手順を進めてください。

1. /context—現在の内訳を書き留めます。これが基準値です。
2. /clear—チャットに現在のタスクと関係ない履歴が蓄積している場合に実行します。新しいウィンドウにします。
3. ls -la ~/.claude/skills/—インストール済みのスキルを確認します。1か月使っていないものは削除します。コマンド：rm -rf ~/.claude/skills/[skill-name]（またはインターフェースからフォルダーを削除）。
4. /plugin list—プラグインも同様に確認します。使っていないものは/plugin remove <name>で削除します。
5. /mcp—接続中のMCPサーバーを確認します。現在のタスクに必要なものだけを残し、ほかは/mcp disconnect <name>で切断します。
6. エディターでCLAUDE.mdを開く。ファイルが200行を超えていたら、専門的な指示をSkills（~/.claude/skills/[topic]/SKILL.md）に移します。中核部分を100-200行、トピック別のSkillsを5-15個にすることを目指します。詳しいガイドは「2026年のCLAUDE.mdの設定方法：そのまま使えるテンプレートと6つのルール」を参照してください。
7. /effortを確認する。簡単なタスクでは/effort lowを使います。高い思考予算が必要なのは複雑なアーキテクチャだけです。
8. 最後に/contextを測定する。手順1の値と比較します。

紹介したセッションでは、整理後の占有文脈が60〜80Kから25〜30Kへ減りました。これは一時点の使用領域の変化で、総処理量や費用が一定率で下がった証拠ではありません。同じタスクの完了までを、キャッシュと出力も含めて比較してください。

トークンの理解にとどまらず、Claudeを使うための完全な方法論、つまりAIクローン、Second Brain（business/）、コンテキストエンジニアリングを構築したいなら、これらが方法論を構成する3つの要素です。

コンテキストの整理よりSonnetやHaikuへの切り替えが役立つのはどんなとき？#

Anthropicはドキュメントでモデルについて次のように説明しています。

入力トークン価格のおおまかな内訳（2026年5月27日時点）：

私の設定：

1. デフォルトはSonnet 4.5。/config → default modelで設定します。タスクの80%をカバーします。
2. 本当に難しいタスク（アーキテクチャの選択、不可解なバグの診断、新製品の開発）では、手動で/model opusを実行します。
3. テストと書式設定には/model haikuを使います。または、サブエージェントの設定にmodel: haikuを明示的に指定します。
4. /effortはモデルとは別に設定します。Opusでも/effort lowを使えます。複雑度が中程度のタスクにすばやく答える場合、少ない思考量で強力なモデルを使えます。

モデルの切り替えよりコンテキストの整理を優先する場合：

• コンテキストが50%を超えている—まず整理してください。
• コンテキストに問題はないが、タスクが複雑—通常の思考量でOpusを使います。
• コンテキストに問題がなく、タスクが定型的—Haikuを使います。

モデルとeffortの詳しい説明は、「Claude CodeでSonnetかOpus 4.7か：2026年のモデルと/effortの選び方」を参照してください。

使用量を節約するどころか増やしてしまうヒントは？#

反パターン1. 「トークンを消費するMCPはすべて削除する」

よくあるのは、手間を惜しむことです。確かに、MCPは以前コンテキストの最大49%を消費していましたが、Tool Search導入後は8-15%に減りました。また、MCPは、手作業で作らなければならない実用的なツールを提供します。MCPをすべて削除すると手作業に戻り、節約できるトークンよりも多くの時間を「食いつぶす」ことになります。

適切な方法は、定期的に実際に使うMCPサーバーだけを残すことです。私はランディングページのテスト用にPlaywright、インターフェースの生成用にshadcnを残しています。それ以外はタスクごとに使います。

反パターン2. 「CLAUDE.mdを使わず、すべてをプロンプトに直接書く」

一見「論理的」です。CLAUDE.mdがリクエストごとに読み込まれるなら、読み込まないようにしよう、と。しかし実際には、CLAUDE.mdを使わないと、毎回同じ指示を手入力で繰り返すことになり、Claudeはメッセージ間でコンテキストを忘れてしまいます。つまりトークンが減るどころか増えます。単に別の経路から送られるだけです。

適切な方法は、CLAUDE.mdを100-200行に抑えて中核情報を置き、専門的な内容をSkillsに移すことです。詳しくは「2026年のCLAUDE.mdの設定方法」を参照してください。

反パターン3. 「常にPlan Modeで作業する」

Plan Modeは、まずコードベースを調べて計画を立てる必要がある複雑なタスクには優れたツールです。しかしエージェントチームで作業すると、平均で7倍のトークンを使います（Anthropicのドキュメント）。「READMEの誤字を直す」のような単純なタスクでPlan Modeを使うと、直接編集する場合の7倍を消費します。

適切な方法は、30分以上かかる複雑なタスクにPlan Modeを使うことです。短いタスクでは、Plan Modeを使わずに直接依頼してください。それぞれのモードをいつ使うかは、「Claude CodeのPlan Mode：2026年の段階的ガイドと4つのステージ」で解説しています。

詳しい資料はAilootでご覧いただけます。