context-optimizer

コンテキストの最適化

コンテキストウィンドウとトークン予算を効率的に管理します。

すばやく診断する

1. /context を実行して現在の使用量を確認します
2. 70% 超の場合 → 品質が低下する前にすぐ圧縮します
3. 90% 超の場合 → 「低性能ゾーン」に入っているため、直ちに圧縮します

最適化の戦略

すぐにできること

アクション	節約量	タイミング
/compact	コンテキストを30～50%節約	タスクの区切り
使用していないMCPを無効化	MCPあたり約5%	分野を切り替えるとき
調査にサブエージェントを使う	メインコンテキストをクリーンに保つ	大規模な検索や読み取りタスク
/resume で新しいセッションを開始	100%リセット	無関係な作業を始めるとき

設定

積極的な自動圧縮を設定します：

{
  "env": {
    "CLAUDE_AUTOCOMPACT_PCT_OVERRIDE": "50"
  }
}

MCPの監査

有効にするMCPは10個未満、ツールは合計80個未満にします。MCPを追加するたびに、すべてのリクエストのオーバーヘッドが増えます。

/mcp          # List active servers
# Disable what you're not using

トークン効率を高めるプロンプトエンジニアリング

• プロンプトの範囲を指定します：「src/auth/ のログインバグを修正してください」
• 制約を示します：「ミドルウェアは変更しないでください」
• 受け入れ条件を示します：「5回試行した後は429を返してください」
• 曖昧なプロンプトは避けます：「コードを修正してください」（Claudeがすべてを読む必要が生じます）

サブエージェントへの委任

大量の出力が発生する重い処理は、サブエージェントに任せます。

• テストスイートの出力 → サブエージェント
• 大きなファイルの調査 → サブエージェント
• ドキュメントの生成 → サブエージェント
• ログの分析 → サブエージェント

サブエージェントが大量の処理を担当する間、メインセッションをクリーンに保てます。

コンテキスト予算の計画

フェーズ	使用量の目標	超過した場合のアクション
計画	< 20%	計画を簡潔に保つ
実装	< 60%	ファイルの切り替え時に圧縮する
テスト	< 80%	サブエージェントに委任する
レビュー	< 90%	新しいセッションを開始する

トークン効率

出力の削減（40～60%節約）

• 媚びるような書き出しはしない（「もちろんです！」「良い質問ですね！」）
• 余計な締めくくりはしない（「何かあればお知らせください！」）
• 回答の前にプロンプトを言い換えない
• コードを先に示し、説明は自明でない場合に限る
• 文章より構造化された出力（表、箇条書き）を使う
• ASCII文字のみを使う：emダッシュではなく --、スマートクォートではなく半角の引用符を使う

動作の効率化

• 1回でコーディングする：解決策を完成させ、一度テストし、成功したら終了する
• 書き込む前に読む：読んでいないファイルは変更しない
• 再読み込みしない：変更されていないファイルは読み直さない
• ツール呼び出しの予算：20回（簡単な修正）～80回（大きな機能）
• 同じ失敗に対して2回を超えて繰り返さない

タスクのプロファイル

状況に応じて応答スタイルを切り替えます。

• コーディング：コードを先に示し、説明は最小限にし、最もシンプルな解決策を使う
• エージェント／パイプライン：構造化された出力のみを使い、文章は加えず、解析可能にする
• 分析：結論を先に示し、段落より表を使い、出典付きの数値を示す

CLAUDE.md の最適化

• ルートの CLAUDE.md：理想は60行未満、最大でも150行未満
• パッケージ固有の情報は、パッケージレベルの CLAUDE.md に移す
• 個人の設定は CLAUDE.local.md に移す
• 明白な情報や頻繁に変わる情報は削除する

コンテキストの品質が低下したとき

兆候：

• Claudeが同じことを繰り返す、または以前のコンテキストを忘れる
• 応答が一般的になったり、プロジェクト固有の知識が失われたりする
• 以前は問題なく動作していた理由でツール呼び出しが失敗し始める

対処法：

1. 手動で /compact を実行する
2. まだ改善しない場合：/resume で新しいセッションを開始する
3. 問題が繰り返し発生する場合：CLAUDE.md のサイズを減らし、MCPを無効化する