用量与账单

Claude Code 费用:订阅、API 与 ccusage

Claude Code 会话里的美元数、ccusage 报表和付款账单,可能分别描述不同的东西。先确认账户与计费路径,再比较同一时间段、同一范围的数据。

Quota Monitor 团队发布于

先确定是谁为这次会话付费

订阅访问和直连 API 计费是两种预算。订阅用户看到按 Token 换算的会话费用,并不表示会单独收到这笔账单。如果启用了额外使用或使用积分,则需要按照对应套餐条款核对额外收费。

直连 Claude API 应与对应 Claude Console 组织及 Workspace 的账单核对。如果请求经过云平台或网关,应使用该服务的账单和价格,而不是默认套用直连 API 公开价。

比较工具前,记录登录账户、请求路径、模型、统计时间和币种。这个简单步骤能避免把一台电脑的会话合计,与另一组织的本月累计费用混在一起。

把会话估算用作排查线索

当前 Claude Code 文档通过 /usage 查看会话 Token 统计和套餐信息。会话金额由本地 Token 数及公开单价计算,也可能采用组织配置的价格。它属于估算,实际费用仍以计费方记录为准。

会话数据适合观察行为变化:输出是否变多、上下文是否重复传入、缓存是否重建。要稳定比较,可用同一模型执行两次边界清楚的任务,记录各类 Token,并比较有效结果,而不只比较耗时。

/usage

用 ccusage 分析本地历史记录

ccusage 可以把已有本地记录汇总为日度或月度报表。安装 ccusage 后,下列命令可以查看自动模式与按 Token 重新计算的结果。建议从确定的日期范围开始,比较不同时段时保持模式一致。

auto 模式优先使用记录中的费用,缺失时再估算;calculate 模式按 Token 重新计算;display 模式只使用记录中的费用,缺失时可能显示零。因此,看到零元并不能证明没有发生消费。

跨设备、已删除的会话或不同请求路径,可能让本地记录不完整。先用报表解释已有活动,再与计费来源核对差异。无需为了获得成本汇总而上传会话日志,日志可能包含项目内容。

ccusage daily --mode auto
ccusage monthly --mode calculate --breakdown

从代表性任务建立预算

选择一个有意义的单位,例如完成一个经过审查的 PR,或解决一个客服任务。记录整个任务的费用,包括失败尝试、追问和并行工作。单次调用便宜,不代表每个合格结果便宜。

先把平均输入、输出、请求次数和缓存 Token 比例填入 LLM 成本计算器,再逐项改变输出长度、重试次数或复用率。订阅费用与非 Token 费用应单独列入预算,避免重复计算。

  • 抽样多个任务,包含至少一个困难案例。
  • 为每次估算记录模型和价格日期。
  • 记录每个合格结果所需的尝试次数,而不只看单次 Token。
  • 等待账单数据到达后,按同一时间范围核对。

Quota Monitor 能核对什么

Quota Monitor 的 Anthropic 接入通过 Admin API Key 读取已报告的 API 费用和官方消费限额信息,不读取 Claude Pro/Max 订阅剩余额度、预付 Credits 余额或本地 Claude Code 会话文件。

本地任务分析可使用 ccusage 或 Claude Code;情景预算使用价格计算器;支持范围内的组织费用使用供应商接入。连接前请阅读 Anthropic 教程,确认权限、Workspace 范围、账务延迟与当前验证状态。

常见问题

会话显示 100 美元,就表示订阅还要付 100 美元吗?
不能仅凭这个数字判断。先确认认证路径、套餐包含的用量,以及是否开启额外计费。按 Token 折算的金额不是订阅账单。
为什么 ccusage 与供应商控制台不一致?
检查本地记录覆盖范围、费用模式、模型单价、日期与时区、组织范围及账务延迟。先确保比较的是同一批活动,再判断是否存在错误。

参考来源