Deep Analysis: Claude Codeトークン30-90%削減言説の検証
date: 2026-05-31 analyst: deep-analysis skill（壁打ち） sources: コミュニティ記事・GitHub README・公式docs（WebSearch経由、Tier 2-3主体） total_claims: 4件 total_counterargs: 採用3件 / 部分採用1件 / 却下0件
概要
「/clear・hooks PreToolUseフィルタ・context-mode MCPによるトークン30-90%削減が報告されている」という言説の真偽を検証し、当プロジェクト（waribashi_konbu）への取り込みメリットを評価した。
言説は部分的真実。数値の範囲（30-90%）は実例に基づくが、3つの重要な訂正が必要。
抽出クレーム（4件）
| ID | 主張 | Tier | status |
|---|---|---|---|
| 2026-05-31-W001 | /clearコマンドはタスク間コンテキストリセットで1セッションあたり15,000–40,000トークン節約できる（ただし絶対値であり削減率ではない） | 2（個人ブログ実測） | unverified |
| 2026-05-31-W002 | hooks PostToolUseフィルタ（RTK等）は特定コマンド出力（git status等）を60–90%圧縮できる（Caveman pluginは最大75%を主張） | 2（個人実装・非公式ベンチ） | unverified |
| 2026-05-31-W003 | context-mode MCPはツール出力をサンドボックス化し46–98%のトークン削減を達成する（315 KB→5.4 KBの実例あり） | 2（Medium記事・GitHub README） | unverified |
| 2026-05-31-W004 | 三技術を組み合わせると「30–90%削減」が達成可能という言説が複数の記事で流通している | 3（二次集約・測定基準不統一） | unverified |
スコープ未確認事項: 数値はすべて特定ワークフロー（大量ファイル読取・MCP多用・ロングセッション）のもの。「平均的なClaude Codeセッション」に対する統一測定値は存在しない。
各技術の概要
/clear コマンド
セッション全体の会話履歴をゼロにリセットする。「トークン削減」ではなくコンテキスト「汚染防止」が本来の機能。/compact（要約圧縮）とは別概念で、/compactが同一タスク継続時に有効なのに対し、/clearは完全に異なるタスクへ切り替える際に使う。
推定節約量：1セッションあたり15,000–40,000トークン（以前のコンテキストが膨らんでいた場合）。
hooks PostToolUseフィルタ
ツール実行後にその出力をClaudeに届ける前に書き換える機能（hookSpecificOutput.updatedToolOutput）。大量出力コマンドの結果をgrep/truncate/圧縮して渡すことでコンテキスト消費を抑える。RTK（Rust Token Killer）はgit status等の定型コマンドに対して60–90%圧縮を実測。Caveman pluginは最大75%削減を主張。
注意: 元言説の「PreToolUse」は誤り。PreToolUseはツール実行前の検証・ブロック・引数変更が用途で、出力フィルタはPostToolUse。
context-mode MCP
GitHub: mksglu/context-mode。MCPツールが返す大量出力をサンドボックス化し、要約に置き換えるMCPサーバー。315 KB→5.4 KBの実例（98%削減）が公開されている。Claude CodeがMCPツール全体のスキーマ定義を読み込む際の初期コンテキストを削減するToolSearch機能（約46.9%削減: 51K→8.5Kトークン）も近接する技術として存在する。
反論と判定
反論 C001: /clearはトークン「削減」ではなくコンテキスト「リセット」であり、カテゴリが異なる
- 判定: 採用
- 理由: 削減率が直前コンテキスト量に100%依存する以上、「30-90%削減技術」と同列に並べるのは測定単位の混同。5,000トークンのセッション後のリセットと200,000トークン後のリセットを同率で語れない。
- 採用時の処置: W001を「絶対量節約（文脈依存）」に修正。/clearの価値は「コスト最適化」より「新タスク開始時の汚染防止」として再分類。
反論 C002: 90%という上限値はcherry-pickedな最悪ケースから来ており代表値ではない
- 判定: 部分採用
- 理由: context-modeの98%削減は「315 KB出力を持つMCPツール」という極端な事例。RTKの60-90%は「git statusなどの繰り返し多い定型コマンド」に限定。通常のread/edit/bashの混在セッションでは同等の削減率は期待できない。90%達成を報じるMedium記事は「5ツール+カスタムhooks+強制設定」という高投資構成が前提。
- 採用時の処置: 「30-90%」の範囲は正確だが、下限30%が標準的なケース、上限90%が特定最適化シナリオ。平均的な実効削減は30-50%程度と見るのが妥当。
反論 C003: hooksはPreToolUseではなくPostToolUseが出力フィルタの正しいフック種別である
- 判定: 採用
- 理由: Anthropic公式docs（code.claude.com/docs/en/hooks）によれば、ツール出力をClaudeに届く前に書き換えるのはPostToolUse（
hookSpecificOutput.updatedToolOutput）。PreToolUseはツール実行前の検証・ブロック・引数変更が用途。RTKのアプローチ（rtk git statusへのコマンド置換）はPreToolUseで実装できるが、これは「出力フィルタ」ではなく「コマンド差し替え」。 - 採用時の処置: 言説の「PreToolUseフィルタ」を「PostToolUseフィルタ（+ PreToolUseコマンド差し替え）」に訂正。
反論 C004: このプロジェクトの典型的使用パターンでは削減メリットが限定的
- 判定: 部分採用
- 理由: waribashi_konbuの主要操作はnews-digest・deep-analysis等の短命スキル実行（自然なセッション境界あり）とfetch_articles.py（Python直接実行、Claude Codeセッション外）。ロングセッションや大量MCP呼び出しが少なく、context-mode MCPの価値が出るシナリオは稀。ただし深掘り分析時のwikiファイル多読・大型レポート生成では蓄積が起きる。
- 採用時の処置: プロジェクト適用優先度を下方修正（ただしPostToolUseフックは有効な場面あり）。
統合結論
「30-90%削減」の言説は部分的真実。採用反論: C001, C002, C003あり。
| 技術 | 真偽評価 | 実効削減（標準ケース） | 訂正事項 |
|---|---|---|---|
/clear | 真（ただし分類ミス） | 0-100%（前コンテキスト依存） | 「削減」ではなく「汚染防止・リセット」 |
| hooks フィルタ | 真（ただし種別ミス） | 10-40%（混在セッション） | PreToolUseではなくPostToolUseが正 |
| context-mode MCP | 真（ただし上限は極端ケース） | 30-60%（MCP多用時） | 98%は315KB出力という特殊ケース |
| 三技術合算「30-90%」 | 範囲として妥当 | 30-50%（標準構成） | 上限90%は高投資+極端入力時のみ |
不確実性: 公式Anthropicベンチマークは存在しない。すべての数値は個人・コミュニティ報告。統一測定基準がない。
当プロジェクトへの取り込み推奨度
| 技術 | 推奨度 | 具体的アクション |
|---|---|---|
| PostToolUse出力フィルタ | ★★★ 中-高 | deep-analysis実行時にwikiファイルを複数Read → コンテキスト蓄積が発生。大きなRead出力をgrep/truncateするPostToolUseフックで削減余地あり。特にwiki/themes/の大きなファイルが対象 |
| /clear の意識的使用 | ★★ 低 | 既にスキル境界で自然にセッションが分割されているため追加投資不要。意識すべき場面は「同一セッションで複数スキルをまたぐ場合」のみ |
| context-mode MCP | ★ 低 | 現時点でMCPサーバーが少なく費用対効果が出ない。MCPサーバーが5個を超えた時点で再検討する |
参考ソース（WebSearch経由・未一次確認）
- andrewpatterson.dev/posts/token-savings-rtk-headroom/ — RTKによるgitコマンド60-90%圧縮
- medium.com/@joe.njenga — Claude Code MCP context bloat 46.9%削減（Tool Search）
- github.com/mksglu/context-mode — context-mode MCP（98%削減主張）
- medium.com/@abdulgafoorabid — 5ツール+hooks+強制設定で90%+削減
- claudefa.st/blog/tools/hooks/hooks-guide — hooks種別ガイド
- code.claude.com/docs/en/hooks — Anthropic公式hooks reference（Tier 1）
- code.claude.com/docs/en/costs — Anthropic公式コスト管理ガイド（Tier 1）