估算 token 消耗之前,得先把计费口径弄清楚。因为同一套操作,在订阅模式和 API 模式下跑出来的费用可能差很多。
Claude Code 的账单并不总是按 API token 计费。如果你用的是 Pro 或 Max 订阅,它包含的用量配额会先被抵扣,超出部分才有额外费用;而如果直接通过 API Key 运行,则完全按 token 计费。判断当前属于哪种模式,最简单的方法是查看 claude 命令的启动提示:登录了订阅账号会显示订阅身份,用环境变量 ANTHROPIC_API_KEY 则走 API。这个区别决定了你后续估算消耗的口径。
启动 claude 命令时,留意顶部提示。如果显示的是订阅账号信息,说明当前走的是 Pro 或 Max 配额;如果启动时加载了 ANTHROPIC_API_KEY,走的就是 API。这个判断只需要几秒钟,但决定了后面所有估算的基准。订阅模式下,配额先扣,超了才有额外账单;API 模式下,每一轮对话、每次工具调用都按 token 累加。换句话说,同样 100 轮对话,订阅模式可能还在配额范围内,API 模式已经产生了费用。
从运行日志里读真实 token 消耗
估算 token 消耗可以从会话中直接读取。在交互界面输入 /status 会显示当前session的上下文占用和已用token数。更精确的办法是开启 debug 日志或使用 API 透传模式,从每次响应的 usage 字段拿到 input_tokens 和 output_tokens。把多次请求累加起来,加上每次轮询时系统自动附带的系统提示和工具定义,才是真实的消耗总量。别只计算你输入的文本。
/status 显示的是当前会话的上下文占用,数字是累计值,不是单次请求。如果你想精确到每次调用,需要开启 debug 日志或走 API 透传模式,在响应里找到 usage 字段。注意 input_tokens 和 output_tokens 这两个值,input 是发送给模型的全部内容,output 是模型回复的内容。但每次轮询时,Claude Code 还会附加系统提示、工具定义和已读取的文件片段,这些都会计入 input_tokens。所以不要只统计你手工输入的文本,否则实际账单会明显高于预估。
一个简单的做法:跑一个只有单个文件修改的任务,记录响应 usage,再对比 /status 显示的总累计值,你就能看出系统附加部分的占比。不用记具体数字,先建立感知。
长会话吞掉的是重复计费的上下文
最容易忽视的成本坑是长会话和历史文件内容。Claude Code 会把对话记录和已经读取过的文件内容都保留在上下文中,即便后续不再需要这些文件,只要不主动清理,它们就会一直占着 token。典型场景是连续询问多个文件问题后,上下文越来越长,之后的每次请求都是按最大长度计费。对策是每隔一段时间执行 /clear 开始新会话,或者用 /compact 压缩历史,把已经解决的部分沉淀到 git 中。
/clear 和 /compact 用途不同。/clear 会清空当前上下文,重新开始,代价是之前对话里提到的信息需要重新交代;/compact 则会把历史压缩成摘要,保留核心意图,但个别细节可能需要重新确认。两种情况都建议把暂时不用的文件从上下文中移走。如果项目里有尚未提交的改动,先 commit 到 git,再开新会话继续。这样既控制 token,也不会丢失进度。
先设预算,再排除吞 token 的大文件
设置预算的前提是知道自己的用量形态。API 计费用户,建议先在 Anthropic 控制台设置每月消费上限,并把环境变量里的 max_tokens 调低。订阅用户要留意配额剩余量,接近月底时如果消耗过快,会影响后续使用。无论走哪条路径,都要检查自动读取大文件的行为。锁文件、构建产物、node_modules 里的文件一旦被读进来,一次可能消耗成千上万个 token,而这些 token 通常没人真正需要。
项目根目录下加一个 .claudeignore 文件,内容按实际项目调整:
node_modules/
dist/
build/
package-lock.json
*.min.js
添加文件后,重新启动 claude 会话,再用 /status 看上下文占用有没有下降。这里需要结合项目结构和实际读取日志来确认,不一定所有文件都需要排除。
分任务拆解,建立自己的消耗基线
与其每次都凭感觉猜测,不如按功能拆解。先记录一次典型操作的 token 用量,比如“读取三个小文件并修改一个函数”用掉了多少 token,再乘以每周执行次数,就得到一个周消耗基线。之后针对高频操作做优化:把多个小改动合并成一次请求,用更精简的 prompt 指路,必要时切换成更轻量的模型。保持记录,预算才调得准。注意,不同模型、不同上下文环境下的 token 数量会有差异,所以基线要定期修正。
最后提醒一点: Claude Code 的计费细节会因为订阅类型、模型选择、网络配置等因素产生变化。上面这些方法不是为某一版本量身写的,只能作为通用判断路径。开始估算前先跑一遍 /status 和 debug 日志,确认自己的实际数据。按自己的项目调整后,再决定预算上限。