它到底是什么

/usage(别名 /cost、/stats)在 Claude Code 会话内打印当前 session 的 token 消耗与成本快照。命令本身不需要参数,也不产生任何持久副作用。

注意: 可访问的官方文档(support.claude.com)明确只收录了 /cost——原文描述为 "Show this session's token and dollar usage (API billing)",并注明 /usage 与 /stats 未出现在该文档中。三者指向相同功能的别名关系来自社区实测,并非官方文档直接表述。

平台支持: Claude Code CLI、VS Code / JetBrains 插件、桌面应用均可使用(只要处于活跃会话内)。

怎么触发 / 怎么使用

会话内任意时刻,在消息栏第一个字符处输入命令即可。命令后不接参数。

/usage

/cost

/stats

三者触发相同的输出面板。

输出字段说明

以下字段来自对 /cost 实测报告的核查：

示例输出(字段示意,具体数值因会话而异):

Total cost: $0.4832
Total duration (API): 3 mins 12 secs
Total duration (wall): ...
Code changes: ...
Usage by model:
  <model>: <input> input, <output> output, <cache read>, <cache write>

上方 Usage by model 行的 token 数值仅为占位示意,非任何来源给出的真实数字。

运行约束 / 限制

订阅用户触发时,输出通常为类似：

You are currently using your subscription to power your Claude Code usage.

跟同类"用量/计费"命令对比

/usage(看用量)经常和"配置超额"的 /usage-credits、看订阅配额的入口混淆,职责不同:

记忆法:看这次会话花了多少用 /usage;配置花完之后怎么办用 /usage-credits。注意 /usage//cost//stats 是社区实测的别名关系,官方文档只明确收录 /cost;命令无参数、无持久副作用,随时可查。

经典使用场景

• 成本审计: 长任务结束后立即运行,确认本次操作花费是否在预期范围。
• Token 热点定位: 对比多次任务的 Usage by model 输出,识别哪类任务消耗最多 token。
• Cache 效果验证: 查看 cache read token 占比,判断 CLAUDE.md 和上下文复用是否有效。
• 模型切换决策: 确认 Opus 任务是否真的比 Sonnet 贵出预期的比例,辅助 /model 切换决策。

常见坑

1. 订阅用户误以为命令"坏了": 看到订阅提示而非美元数字是正常行为,不是 bug。若需精确 token 统计,可使用第三方工具(如 claude-usage 开源 dashboard)。
2. /clear 与上下文: 官方 sessions 文档说明 /clear 会「保存当前对话并开始空的上下文」(previous conversation is saved and resumable)。命令打印的是当前 session 快照,跨任务汇总时建议在切换前自行记录输出。(官方文档未逐字说明 /clear 会把 /usage//cost 计数重置为零,此为合理推断。)
3. Wall duration ≠ API duration: Total duration (API) 是 Claude 模型推理耗时,Wall duration 是真实经过时长,两者差值代表工具执行、用户等待等非模型时间。(Total cost 与 API duration 的对应关系为推断,非来源原文断言。)

来源

• Commands — code.claude.com 官方文档
• Models, usage, and limits in Claude Code — support.claude.com
• Claude Code /cost: Track Every Dollar Your AI Spends — blog.vincentqiao.com