主题
Claude Code 缓存优化代理
一句话介绍
简单理解:它像一个“中间人”,挡在你的电脑和 Claude 服务器之间,
它不会让 AI 变聪明,只是让你的额度更耐用。
为什么需要它?
Claude Code 用得越久,你可能会发现:
- 同样几句话,额度掉得比想象中快;
- 恢复一个旧对话(
--resume),像重新付了一次费; - 开了 MCP、Skills、Hooks 后,消耗莫名变高。
这些大多不是 bug,而是 Claude Code 的请求结构有点“不稳定”,
claude-code-cache-fix
干的事情就一件:
把请求洗干净、排好序、
,让 Claude 服务器一眼认出“这段我见过”,
它具体做了什么(看不懂可以跳过):
| 它做的事 | 对你的好处 |
|---|---|
| 修正恢复会话时的请求结构 | --resume 后不再被当成新对话重新计费 |
| 去掉版本号等不稳定标记 | Claude Code 升级后缓存不会突然失效 |
| 把工具、MCP 定义按固定顺序排列 | 同样的配置每次请求长得一样,缓存能命中 |
自动打好 cache_control 标记 | 主动告诉服务器“这段请缓存” |
| 记录每次缓存命中和额度情况 | 出问题时方便排查,文件存在 ~/.claude/quota-status/ |
不依赖老的 NODE_OPTIONS 注入 | 新版 Bun 版 Claude Code 也能用 |
适合谁用?
- ✅ 重度使用 Claude Code、对额度敏感的用户
- ✅ 经常
--resume长会话、开了一堆 MCP / Skills 的用户 - ✅ 愿意动一点命令行的用户
- ❌ 完全不想碰终端、只想开箱即用的用户(先不用上这个)
它不能解决所有额度问题
这个工具只能优化本地请求结构和缓存相关问题。模型本身价格、长上下文消耗、工具数量过多等因素仍然会影响额度消耗。
Windows 原生环境不适用
claude-code-cache-fix不建议在 Windows 原生 CMD / PowerShell 中配置使用。Windows 用户请优先在 WSL 的 Linux 环境 中完成 Node.js、Claude Code 和该工具的配置。
第三方工具提醒
claude-code-cache-fix不是 小K的AI站点 官方维护工具。它会经过本机 API 请求,请先确认你信任该项目并阅读其官方说明。
推荐使用 AI 辅助配置
这个工具涉及本地代理、环境变量和后台服务配置,手动配置容易漏项。
可以直接使用下面这段提示词:
text
请根据 https://github.com/cnighswonger/claude-code-cache-fix 的最新 README,
帮我在当前系统中配置 Claude Code 缓存优化代理。
要求:
1. 我使用 小K的AI站点,upstream 必须是 https://api.kkkk24juastin.asia
2. Claude Code 的 ANTHROPIC_BASE_URL 应指向本地代理 http://127.0.0.1:9801
3. 保留 ANTHROPIC_AUTH_TOKEN,用我的 小K的AI站点 `claude code` 分组令牌替换
4. Windows 用户请按 WSL Linux 环境来配置,不要使用 Windows 原生 CMD / PowerShell
5. 给出验证代理健康状态和 Claude Code 回复是否正常的命令
6. 长期使用时,请给出适合当前系统的后台服务配置方式最小验证流程
下面的命令适合在 Linux / macOS / WSL 中先验证代理是否能跑通:
bash
npm install -g claude-code-cache-fix
CACHE_FIX_PROXY_UPSTREAM=https://api.kkkk24juastin.asia cache-fix-proxy server配置 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_DISABLE_NONESSENTIAL_TRAFFIC": "1",
"CLAUDE_CODE_DISABLE_TERMINAL_TITLE": "1",
"CLAUDE_CODE_NEW_INIT": "1",
"CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS": "1",
"DISABLE_AUTOUPDATER": "1",
"DISABLE_TELEMETRY": "1",
"DISABLE_BUG_COMMAND": "1",
"DISABLE_ERROR_REPORTING": "1",
"ENABLE_TOOL_SEARCH": "false",
"CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS": "1",
"CLAUDE_CODE_DISABLE_GIT_INSTRUCTIONS": "1"
},
"includeCoAuthoredBy": false,
"language": "Chinese-simplified"
}验证代理
另开一个终端,检查代理健康状态:
bash
curl http://127.0.0.1:9801/health如果返回 {"status":"ok"},再重新打开终端运行:
bash
claude能正常进入 Claude Code 并收到回复,说明代理和 小K的AI站点 配置已经连通。
长期使用建议
手动启动代理只适合临时验证。长期使用时,建议继续让 AI 根据你的系统生成后台服务配置。
再次提醒:Windows 用户请在 WSL 里完成整套配置,不要使用 Windows 原生 CMD / PowerShell。