Claude Code Token Savings

April 12, 2026 · View on GitHub

800時間の自律運用で見つけた、トークン消費を半分にする実践テクニック。

1. CLAUDE.mdを短くする

BeforeAfter効果
100行の詳細な指示35行の凝縮版キャッシュ読み取り率 89%→95%
「〜してください」「〜に注意」箇条書き・キーワードコンテキスト消費 40%減
全ルールをCLAUDE.mdに記載hookに分離読み込みトークン削減

核心: CLAUDE.mdはセッション開始時に毎回読み込まれる。長いほどトークンを食う。

2. /compactの前にチェックポイント

# settings.jsonに追加
"hooks": {
  "PreCompact": [{
    "hooks": [{ "type": "command", "command": "git add -A && git commit -m 'checkpoint: pre-compact'" }]
  }]
}

compactionで重要な情報が消える前に自動保存。

3. 大きなファイルの読み込みを制限

# PreToolUse hook（Read操作を監視）
INPUT=$(cat)
FILE=$(echo "$INPUT" | jq -r '.tool_input.file_path // empty')
[ -z "$FILE" ] && exit 0
SIZE=$(wc -c < "$FILE" 2>/dev/null || echo 0)
if [ "$SIZE" -gt 50000 ]; then
  echo "WARNING: $FILE is $(($SIZE/1024))KB. Use limit/offset parameters." >&2
fi

4. サブエージェント活用

メインコンテキストを汚さずに調査・分析を実行:

  • Agent ツールで探索をオフロード
  • メインウィンドウのcompaction頻度が下がる
  • 結果だけがコンテキストに入る

5. キャッシュ読み取り率を監視

/cost コマンドで確認。読み取り率が50%以下なら:

  • CLAUDE.mdの構造を見直す（先頭に変更頻度の低い情報）
  • セッションを短く区切る（/clear → 新セッション）
  • 大きなファイルの読み込みを避ける

もっと詳しく: Token Book — Claude Codeのトークン消費を半分にする（¥2,500・第1章無料）

全10章・44,000字。CLAUDE.mdテンプレート、9個のhook、設定ファイルのコピペテンプレート収録。

無料ツール: