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 走本機代理 ​