Claude Code 怎么省 Token:几个值得调整的设置和习惯
Claude Code 每轮请求都会带上对话历史、读过的文件内容和项目规则。会话越长,这些内容越容易积累。排查 Token 为什么用得多,可以先从这里看起。
缓存折扣、换便宜模型也能省钱,但要把重试和返工算进去,看完成整个任务到底花了多少。
1. 给自动压缩设一个合适的窗口
Claude Code 已有自动压缩,会把较早的对话整理成摘要,腾出空间继续工作。即使模型支持很长的上下文,也可以让它提前压缩。
想把会话控制在 500K(约 50 万 Token)左右,可以在支持这些设置的版本中,将下面的内容合并到 ~/.claude/settings.json,保留原有配置:
{
"env": {
"CLAUDE_CODE_DISABLE_1M_CONTEXT": "1",
"CLAUDE_CODE_MAX_CONTEXT_TOKENS": "500000"
},
"autoCompactWindow": 500000
}
这里主要靠两项设置控制长度:CLAUDE_CODE_DISABLE_1M_CONTEXT 关闭 1M 上下文支持,让原生支持 1M 的模型按 200K 窗口使用;autoCompactWindow 设置自动压缩窗口。使用时保持自动压缩开启。
配置说明:
CLAUDE_CODE_MAX_CONTEXT_TOKENS主要用于中转或自定义模型,让客户端按指定容量处理上下文。对于客户端已识别的 Claude 模型,以及没有特殊后缀的claude-名称,开启压缩时这项设置不生效。保留自动压缩即可,具体适用规则见文末文档。模型专属设置或其他环境变量也可能覆盖上面的压缩窗口。
200K 只是一个起点,可以按任务调整。窗口太小会频繁生成摘要;压缩丢掉关键细节后,还得重新翻文件,这些都有开销。
2. 留意恢复会话和切换模型的缓存成本
缓存能让重复发送的内容按较低价格计费。按当前官方文档,Claude Code 使用 API Key、云服务或额外付费额度时,默认缓存有效期是五分钟;订阅套餐内的主会话默认是一小时,也可以通过配置修改有效期。
每次用到缓存,都会从这次请求开始重新计时。这部分内容仍然占用上下文,只是读取费用更低。
隔了很久再恢复会话
开完会或第二天用 claude --resume 接着工作,历史记录还在,缓存却可能已经过期。第一轮请求需要重新处理带上的系统指令和历史,再写入缓存。带上的内容越多,这笔费用就越高。
官方 API 的五分钟缓存写入价是普通输入价的 1.25 倍,一小时是 2 倍。使用中转平台时,看平台自己的计费规则。
频繁切换模型
不同模型各有自己的缓存。用 /model 换模型后,新模型需要重新处理会话,不能直接用旧模型的缓存。尽量做完一段任务再切换,别每句话都换一个模型。
比如“Opus 出方案、Sonnet 写代码”,除了比较模型价格,还要算上切换后的缓存写入费用。任务很短时,省下的差价可能还不够付这笔钱。
保持指令和工具配置稳定,有助于重复利用缓存。不用专门发消息保活,也不必为了缓存一直工作。如果经常中断五分钟以上、又在一小时内回来,可以比较一小时缓存多收的写入费和省下的重复写入费。
3. MCP 和 Skills 按项目启用
先运行 /context 看上下文被哪些内容占用,再用 /mcp 关闭当前不用的服务。只在某个项目用到的 MCP 和 Skills,尽量放在项目配置里。
当前 Claude Code 支持在需要时再加载 MCP 工具的完整说明。Skills 通常先提供名称和描述,用到时才加载正文。判断它们占了多少空间,要看实际加载内容,不能只数安装数量。
现成的命令行工具能方便完成的工作,也可以直接用,减少每轮携带工具说明的开销。
4. 给 CLAUDE.md 减负
CLAUDE.md 会进入上下文,保留必要的项目规则、常用命令和主要目录说明就好。专项操作流程可以移到 Skill,长篇背景资料放进文档,需要时再读。
自动更新的时间戳通常没必要放进去,内容变化还可能让后面的缓存失效。删减时保留那些能避免模型犯错的规则。
5. 搜索时先排除构建产物和依赖目录
比如让 Claude 查“登录过期的提示在哪里处理”,搜索结果除了源码,还命中了 dist/assets/index-a1b2.js。这是打包后的文件,可能混着多个页面和第三方库的代码。如果继续读取它,就会把与这次修改无关的内容一起带进上下文。
这类问题可以从搜索范围上减少。日常改业务代码时,优先搜源码目录,默认排除 node_modules、dist、.output 等依赖和构建目录。需要提交到仓库的生成代码,也可以在日常搜索中单独排除,不必为了省 Token 改变版本管理方式。
.gitignore 能帮上一部分忙,但不是禁止读取文件的开关。
可以在 CLAUDE.md 中约定:修改业务代码时先搜索源码,默认跳过依赖和构建目录;排查打包、依赖或接口问题时,再按需读取产物、锁文件和生成代码。定位后读清楚相关函数和调用关系,避免漏掉修改所需的信息。
6. 换任务时,把旧历史留在旧会话
继续同一个任务、历史又已经很长时,可以用 /compact,明确保留目标、已确认结论、修改位置和未完成事项。
换成独立任务,就新开会话或用 /clear。不用每隔几轮固定压缩,压缩本身也消耗 Token。
7. 按任务选模型
日常开发可以先用 Sonnet。改文案、整理格式等简单任务,可以试试价格更低的 Haiku,思考强度也不用拉满。选择时看具体版本和服务商价格,同一系列的不同版本也会有差别。
复杂改造可以让 Opus 负责方案、关键判断和最终验收,把能独立完成的小任务交给较低价格的子代理。例如 Sonnet 处理独立模块,Haiku 整理检索结果,完成后把结论交回主会话。