Context Inspector：Claude Code のコンテキスト浪費を見つける

Context Inspector は、Claude Code のコンテキスト浪費を探すコミュニティ Mod で、作者は YeonwooSung（my-claude-code-mods）です。会話に入ってくるすべて（プロンプト、返信、ツール結果、添付）の台帳を付け、次の三つに答えます。いま何がウィンドウを埋めているか、同じ情報がなぜ何度も戻ってくるか、コンパクトで何が残り何が失われたか。

ctx 62% · waste≈8.1k のようなステータス行を追加します。パーセントは実測値、浪費は推定値です。コマンドも三つ追加されます。/context-inspect は、概要、占有物、再読み込み、類似出力、コンパクト、効率、アドバイスの各セクションを持つテキストレポートを出力します。/context-pane はライブのペインを開きます。/context-export は台帳をメタデータのみの JSONL として保存します。

分析は具体的です。ファイルの再読み込みは、以前のコピーがまだウィンドウに残っている場合（純粋な無駄）、編集後、コンパクト後などに分類されます。近い重複のツール出力は意味ではなく語の SimHash でグループ化されます。コンパクトのあとは、編集・読み込みしたファイル、エラー、ユーザー識別子が要約にまだ現れるかを確認します。作者の README は Claude Code 2.1.287 以降を必要とします。

録画では、小さなデモプロジェクトでこの Mod を読み込んだ Claude Code を起動し、README.md を読んでプロジェクトを一文で説明するよう Claude に頼みます。ターンが終わると、フッターに context-inspector: ctx 4% · waste≈0 が表示されます。続けて /context-inspect を実行します。レポートには、有効なトークン（17 項目で約 6.2k）、カテゴリ別の主な占有物（スキル一覧、MCP の説明、遅延ロードされるツールの添付）、再読み込み、類似出力、コンパクト、効率、アドバイスが並びます。この短いセッションでは二度読まれたファイルがないため、浪費はゼロで、アドバイスは目立つ点なしと表示されます。

インストールブロックのいずれかの方法を使ってください。どれも作者自身のマーケットプレイスから直接インストールします。ステータス行は、次のセッション開始後、最初のターンが完了すると表示されます。

モジュールは hooks/register.tsx の register 関数ひとつで、イベントをラップしてそのまま次へ渡します。記録の各ステップは自身のエラーを握りつぶすヘルパーを通るため、インスペクターがセッションを壊すことはありません。ツール呼び出しは実行の前後に記録され、結果はそのまま返されます。

on('tool.call', async ($, e, next) => {
  const id = e.tool_use_id
  if (id !== undefined) safe(() => ingestToolCall(ledger, id, String(e.tool), e.agentId, e as unknown as Record<string, unknown>))
  const answer = await next(e)
  if (id !== undefined) safe(() => ingestToolResult(ledger, id, answer))
  return answer
}).catch(($, e, next) => next(e))

この抜粋は hooks/register.tsx からのものです。行は session.append から、実測のリクエストサイズは turn.step から、コンパクトは session.compact から届きます。各ターンのあと、turn.complete が再描画を一件キューに入れ、$.session.usage() を読んでステータス行を書き込みます。hooks/core/ の分析コードはローカルのインポートだけを使う素の TypeScript で、台帳の上限は 20,000 項目です。

/config にはオプションが二つあります。outputDir は /context-export の書き込み先で、空なら ~/.claude/context-inspector です。toastAdvice（既定でオン）は、重大度の高い推奨が初めて現れたときにセッションごとに一度トーストを表示します。コマンドは引数を受け付けます。/context-inspect advice は一つのセクションだけを表示し、--agents はサブエージェントも含めます。

実行する前に、プラグインが実行できるすべてのファイルを読みました。マニフェスト、hooks/hooks.json、hooks/register.tsx、そしてマスキング規則を含む hooks/core/ のすべてです。package.json、インストールスクリプト、バイナリ、バンドルされたコードはなく、インポートはローカルファイルだけです。

• ネットワーク、プロセス、デーモン、テレメトリ： いずれもありません。fetch もシェルコマンドも、Claude Code の終了後に動き続けるものもありません。
• UI の変更： ステータス行、トースト、ペイン。コマンドの追加： 上の三つ。
• すべてのツール呼び出しと行を観察します（tool.call、session.append、turn.step、session.compact）。これらはゲート型フックですが、いずれも次のハンドラーの結果をそのまま返し、.catch のフォールバックがあります。何かをブロックしたり書き換えたりはしません。また validate は、組織が Claude Code を管理している環境では、個人がインストールしたプラグインの session.compact フックは、組織が管理設定に載せない限り動かないと伝えています。
• ファイルの書き込み： /context-export のときだけ、$.fs.write で <outputDir>/<セッション ID>/context-<load>-<n>.jsonl に書き込みます。既定の場所は ~/.claude 内のプラグイン専用サブフォルダです。~ を展開するために HOME を読みます。ファイルパスはそのまま書き出され、それ以外の対象は可能な範囲でマスクされます。作者は共有する前にエクスポートを確認するよう述べています。
• プロンプトへの影響： 見つかりませんでした。プロンプトやツール結果にテキストを注入せず、アドバイスはあなたにだけ表示されます。
• 外部要件： なし。ライセンス： Apache-2.0、リポジトリのルートに LICENSE ファイルがあります。

claude plugin validate はエラーも警告も報告せず、上記の注記のみでした。作者の 102 件のテストは Claude Code 2.1.303 で合格しました。

macOS 上の Claude Code 2.1.303 で確認しました（validate とテスト）。ステータス行が表示されない場合：

• claude --version が 2.1.287 以降であること。
• ターンが一度完了していること。ステータス行は turn.complete のあとに描画されます。
• ステータス行がなくても /context-inspect はレポートを出力するので、Mod が読み込まれているかの確認に使えます。
• VS Code のチャットパネルではフックとコマンドのテキストだけが使えるため、/context-inspect を使ってください。

README にある既知の制限：リロード、再開、/clear のあとは台帳が最初からになり、コンパクト後の生存は部分文字列の一致で判定されるため、言い換えられた内容は失われたと数えられます。