Claude Codeのコンテキストを汚さないために作ったOSSツールの話

• URL: https://zenn.dev/shipscode/articles/3f7c3f103bcfe6
• 日付: 2026-06-25
• Tier: Tier 3
• 要旨: Sipcode（MIT版OSSツール）は、Claude Codeの4時間セッションで38%重複していたファイル読み込みを削減する。ツール出力（grep・npmログ・git log）の前処理と、セッション内の同じファイル再読み込み防止によって、中央値62%のツール出力削減を実現。リリース直前にドリフトレポートと統計カウンターの83倍乖離を発見し、設計上の誤った重複排除を排除する2つの独立した計算経路の重要性を学んだ。

詳細

Claude Codeセッション中、モデルは同じファイルを複数回読み返すため、トークンコストが再度発生する。Sipcodeは詳細ツール出力をPreToolUseフックで制限し、セッション内の同一ファイル読み込みをキャッシュでき、ベンチマークは20タスク中央値62%削減。初期リリースで、セッション途中インストール時のキャッシュ漏れ（開始前ファイルの比較対象不在）による83倍の計測誤差を検出。修正では、フック起動時にアクティブトランスクリプトを走査し、過去読み込み内容をバイト正規化（改行コード・BOM削除）後に遡及埋め込み。ファイル変更時は検出して読み込みを変更なく通す。教訓は「あらゆるメトリクスには独立経路の対立メトリクスが必要」。クリーンコンテキストは品質29%向上・エラー40%削減（Anthropic研究報告）をもたらし、コスト削減は副次効果。現在はClaude Codeのみ対応、セッション内のみで永続化なし、実際の再読み込み時だけトークン節約。