cnighswonger/claude-code-cache-fix

Fixes prompt cache regression in Claude Code that causes up to 20x cost increase on resumed sessions

What it solves

claude-code-cache-fix は Claude Code 用に設計されたキャッシュ最適化プロキシです。プロンプトキャッシュのバグを解消し、過剰なクオータ消費やリクエストプレフィックスの不安定さを防ぎます。これによりキャッシュミスが頻発し、コストが増大する問題を解決します。

How it works

このツールは Claude Code と Anthropic API の間に位置するローカル HTTP プロキシとして動作します。すべての /v1/messages リクエストに対して、プロンプトを安定化しキャッシュを最適化するためのコンポーザブルな拡張パイプラインを適用します。以下の 2 つの動作モードをサポートします。

  • Reverse-proxy mode：ユーザーが ANTHROPIC_BASE_URL をプロキシに向けます。
  • Forward-proxy mode：プロキシが HTTPS_PROXY として機能し、ローカルで生成した CA 証明書を使用して上流ホスト (api.anthropic.com) のみを MITM します。これにより Remote Control などの機能を維持できます。

Who it’s for

Claude Code を使用し、API クオータの消費を抑え、キャッシュヒット率を上げ、キャッシュテレメトリを監視したい開発者向けです。

Highlights

  • Cache Stabilization：不安定なフィンガープリントの除去、ツール/MCP 定義順序の安定化、メッセージ ID フィールドの正規化などの拡張を含みます。
  • Thinking-Desync Mitigation：空の thinking ブロックを自動的に除去し、400 エラー（thinking-desync）を防止します。
  • Observability：レスポンスヘッダーからキャッシュ統計を抽出し、ローカルの JSON ファイルに記録します。
  • Flexible Deployment：単体の Node.js プロセス、管理されたシステムサービス（systemd/launchd）、または Docker で実行可能です。
  • Performance：A/B テストでキャッシュヒット率が 82.3% から 95.5% に向上したことが実証されています。