Claude Code Token Savings Cheat Card — 800時間の運用データから（Token Book preview）

gist-token-savings-cheatcard.md

Claude Code Token Savings — 1ページチートカード

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

1. CLAUDE.mdを短くする

Before	After	効果
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、設定ファイルのコピペテンプレート収録。

無料ツール:

• Token Checkup — 5問でトークン消費を診断
• CLAUDE.md Analyzer — CLAUDE.mdのトークン効率を分析
• Hook Selector — 最適なhookセットを選択