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