Claude Code キャッシュ最適化プロキシ

claude-code-cache-fix はサードパーティのオープンソースの小さなツールで、Claude Code の残高節約を手伝う役割を持ちます。あなたのパソコンと上流の間に立つ「仲介役」のように働き、リクエストを毎回きれいに整え、正しいキャッシュマークを付けることで、上流がキャッシュをヒットしやすくし、消費する残高を減らします。AI が賢くなるわけではなく、あなたの残高をより長持ちさせるだけです。

サードパーティツールに関する注意

claude-code-cache-fix は天枢の公式が管理するツールではなく、リクエストはローカルのプロキシを経由します。インストール前に、そのソースコードと依存関係をご自身で精査してください。

誰に向いているか

✅ Claude Code をヘビーに使い、残高に敏感な人
✅ よく --resume で長い会話を続け、大量の MCP / Skills を有効にしている人
✅ コマンドラインを少し触ってもよい人
❌ 一切ターミナルを触りたくなく、すぐに使えることだけを望むユーザー(まずは使わなくてもかまいません)

Windows ユーザーは WSL を使ってください

本ツールを Windows ネイティブの CMD / PowerShell で使うことは推奨しません。Windows ユーザーは WSL の Linux 環境で、Node.js、Claude Code、天枢、本ツールの一連の設定を完了し、パス / 環境変数 / ポートの不一致による問題を避けてください。

最小限の検証フロー

Linux / macOS / WSL で、まずプロキシが正しく動作するか検証します(upstream は天枢を指します):

bash

npm install -g claude-code-cache-fix
CACHE_FIX_PROXY_UPSTREAM=https://tian-shu.org cache-fix-proxy server

直結回線を使う場合は、CACHE_FIX_PROXY_UPSTREAM を https://api.tian-shu.org に変更できます。

Claude Code をローカルプロキシ経由にする

プロキシを起動したら、Claude Code の settings.json の ANTHROPIC_BASE_URL をローカルプロキシのアドレスに変更し、ANTHROPIC_AUTH_TOKEN には引き続きあなたの天枢トークンを入力します:

json

{
  "env": {
    "ANTHROPIC_BASE_URL": "http://127.0.0.1:9801",
    "ANTHROPIC_AUTH_TOKEN": "xxx",
    "CLAUDE_CODE_ATTRIBUTION_HEADER": "0",
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1",
    "CLAUDE_CODE_DISABLE_TERMINAL_TITLE": "1"
  }
}

別のターミナルを開き、プロキシのヘルス状態を確認します:

bash

curl http://127.0.0.1:9801/health

{"status":"ok"} が返り、claude を再実行して正常に返信できれば、プロキシと天枢が接続できていることを意味します。

長期的に使う

プロキシを手動で起動するのは一時的な検証にのみ適しています。長期的に使う場合は、プロキシをバックグラウンドサービス(systemd / launchd など)として設定し、Claude Code を使うたびに手動で起動する手間を避けることをおすすめします。

AI による設定補助の活用

このツールはローカルプロキシ、環境変数、バックグラウンドサービスに関わるため、手動では項目を漏らしやすいです。あなたのシステム環境、天枢のインターフェースアドレス、このツールの GitHub プロジェクトのリンクをまとめて AI に渡し、あなたのマシンに合わせたコマンドを生成してもらうとよいでしょう。upstream を https://tian-shu.org に向け、トークンにはあなたの天枢トークンを使うことに注意してください。

すべての残高問題を解決できるわけではない

本ツールはローカルのリクエスト構造とキャッシュに関する問題のみを最適化します。モデル自体の価格、長いコンテキストの消費、誤ったモデル選択、頻繁な大きなファイルの読み込みなどは、別途切り分けが必要です。

Claude Code キャッシュ最適化プロキシ ​

誰に向いているか ​

最小限の検証フロー ​

Claude Code をローカルプロキシ経由にする ​

長期的に使う ​