コンテキスト予算

Claude Code セッション内の各読み込み済みコンポーネントのトークンオーバーヘッドを分析し、コンテキスト空間を回復するための実行可能な最適化提案を提供します。

使用時期

• セッションのパフォーマンスが遅く感じられるか、出力品質が低下している
• 最近多くのスキル、エージェント、または MCP サーバーを追加した
• 実際にどのくらいのコンテキストマージンが残っているか知りたい
• より多くのコンポーネントを追加することを計画しており、スペースがあるかどうかを確認する必要がある
• /context-budget コマンドを実行する（このスキルはこれをサポートします）

動作方法

ステップ 1：インベントリ

すべてのコンポーネントディレクトリをスキャンしてトークン消費を見積もります：

エージェント (agents/*.md)

• 各ファイルの行数とトークン数を計算（単語数 × 1.3）
• description フロントマターの長さを抽出
• フラグ：ファイル >200 行（重い）、説明 >30 語（膨張したフロントマター）

スキル (skills/*/SKILL.md)

• SKILL.md のトークン数を計算
• フラグ：ファイル >400 行
• .agents/skills/ の重複コピーを確認 — 重複カウントを避けるために同一コピーをスキップ

ルール (rules/**/*.md)

• 各ファイルのトークン数を計算
• フラグ：ファイル >100 行
• 同じ言語モジュール内のルールファイル間のコンテンツ重複を検出

MCP サーバー (.mcp.json またはアクティブな MCP 設定)

• 設定されたサーバー数とツール総数を計算
• スキーマオーバーヘッドを約ツールあたり 500 トークンで見積もる
• フラグ：>20 個のツールを持つサーバー、シンプルな CLI コマンドをラップするサーバー (gh, git, npm, supabase, vercel)

CLAUDE.md（プロジェクトレベル + ユーザーレベル）

• CLAUDE.md チェーン内の各ファイルのトークン数を計算
• フラグ：マージ済み合計 >300 行

ステップ 2：分類

各コンポーネントをカテゴリに分類します：

カテゴリ	基準	アクション
常に必要	CLAUDE.md で参照されている、アクティブなコマンドをサポートしている、または現在のプロジェクトタイプに一致している	保持
時々必要	特定のドメイン（言語パターンなど）、CLAUDE.md で参照されていない	オンデマンド有効化を検討
ほとんど必要ない	コマンド参照がない、コンテンツ重複、またはプロジェクトマッチが明らかでない	削除またはレイジーロード

ステップ 3：問題検出

次の問題パターンを識別します：

• 膨張したエージェント説明 — フロントマターの説明 >30 語、各タスクツール呼び出しで読み込まれる
• 重いエージェント — ファイル >200 行、各生成時にタスクツールコンテキストに追加
• 冗長コンポーネント — エージェントロジックを複製するスキル、CLAUDE.md を複製するルール
• MCP 過度購読 — >10 個のサーバー、または無料で利用可能な CLI ツールをラップするサーバー
• CLAUDE.md 膨張 — 冗長な説明、古いセクション、ルールになるべき指示

ステップ 4：レポート生成

コンテキスト予算レポートを生成します：

コンテキスト予算レポート
═══════════════════════════════════════

推定総オーバーヘッド：約 XX,XXX トークン
コンテキストモデル：Claude Sonnet (200K ウィンドウ)
有効利用可能コンテキスト：約 XXX,XXX トークン (XX%)

コンポーネント内訳：
┌─────────────────┬────────┬───────────┐
│ コンポーネント  │ 数量   │ トークン  │
├─────────────────┼────────┼───────────┤
│ エージェント    │ N      │ ~X,XXX    │
│ スキル          │ N      │ ~X,XXX    │
│ ルール          │ N      │ ~X,XXX    │
│ MCP ツール      │ N      │ ~XX,XXX   │
│ CLAUDE.md       │ N      │ ~X,XXX    │
└─────────────────┴────────┴───────────┘

警告：検出された問題 (N)：
[節約できるトークン数でソート]

トップ 3 最適化推奨事項：
1. [アクション] → 約 X,XXX トークンを節約
2. [アクション] → 約 X,XXX トークンを節約
3. [アクション] → 約 X,XXX トークンを節約

潜在的な節約：約 XX,XXX トークン（現在のオーバーヘッドの XX%）

詳細モードでは、各ファイルのトークン数、最も重いファイルの行レベルの内訳、オーバーラップするコンポーネント間の具体的な冗長行、および MCP ツールリストと各ツールスキーマサイズの推定をさらに出力します。

例

基本監査

/context-budget
スキル：セットアップのスキャン → 16 個のエージェント（12,400 トークン）、28 個のスキル（6,200）、87 個の MCP ツール（43,500）、2 個の CLAUDE.md（1,200）
      フラグ：3 個の重いエージェント、14 個の MCP サーバー（3 個は CLI で置き換え可能）
      最大節約：3 個の MCP サーバーを削除 → -27,500 トークン（オーバーヘッドの 47% 削減）

詳細モード

/context-budget --verbose
スキル：完全なレポート + ファイルごとの内訳 planner.md（213 行、1,840 トークン）、
      MCP ツールリストと各ツールのサイズ、重複ルール行を並べて表示

拡張前チェック

ユーザー：5 個の MCP サーバーをさらに追加したいのですが、スペースはありますか？
スキル：現在のオーバーヘッド 33% → 5 個のサーバー（約 50 個のツール）を追加すると約 25,000 トークン増加 → オーバーヘッドは 45% に上昇
      推奨事項：まず、利用可能な CLI 代替のある 2 個のサーバーを削除して、40% 以下に保つ

ベストプラクティス

• トークン推定：散文には 単語数 × 1.3、コード密集ファイルには 文字数 / 4 を使用
• MCP が最大のレバレッジ：各ツールスキーマは約 500 トークンを消費；30 個のツールを持つサーバーはすべてのスキルの合計よりもコストがかかります
• エージェント説明は常に読み込まれます：エージェントが呼び出されなくても、その description フィールドはすべてのタスクツールコンテキストに存在します
• 詳細モードはデバッグ用：定期的な監査ではなく、オーバーヘッドを引き起こしている正確なファイルを特定する必要がある場合に使用
• 変更後に監査する：エージェント、スキル、または MCP サーバーを追加した後に実行して、増分を早期に検出