Claude Code の常駐コンテキストを 62% 削減した話 — prompt caching 時代のハーネス設計

• URL: https://zenn.dev/tarowhitey/articles/claude-code-resident-context-diet
• 日付: 2026-06-14
• Tier: Tier 3
• 要旨: CLAUDE.md + .claude/rules/ の常駐コンテキストを 635 行から 239 行（62% 削減）、65KB から 16KB（75% 削減）に圧縮した実践報告。prompt caching の仕組みと組み合わせ、高頻度で更新されるミスログを常駐外に出すことでキャッシュの安定性と固定費の削減を両立した。

詳細

個人事業主（1 人 + AI COO 体制）による Claude Code ハーネス設計記事。

Anthropic 公式ブログ「Prompt caching is everything」の原則（静的→動的の順序、編集するとその位置以降のキャッシュが破壊される）を実務に適用した事例。ミスログは更新頻度が最も高いのに常駐ルールの最大ファイルという最悪のアンチパターンだったと分析している。

改善策は 4 つ。ミスログは knowledge アーカイブに移動して常駐側に 1 行ルールのみ残す。月次チェックリストはスキル化して呼ばれた時のみロードする。解説文は knowledge に退避する。コマンド一覧は /help で足りる部分を削除して複合タスクの判定表のみ残す。

おまけとして、スキル化で決定論スクリプトに置き換えた週次報告の事前チェックで「空出力 = ゼロ件と解釈していたバグ」を発見した事例も記録。gh CLI の 401 エラーを 2>/dev/null で握りつぶしていたという典型的な実装ミスで、リトライと失敗時の明示出力で修正した。