先判断你想看哪一种用量
| 你想知道 | 先用什么 | 要注意 |
|---|---|---|
| 当前这一次会话用了多少 Token、大约多少钱 | Claude Code 内的 /usage(/cost 是别名) | /clear 之后这些合计会归零,只覆盖当前会话。 |
| 订阅套餐还剩多少额度、什么时候重置 | 同一个 /usage 的套餐用量条,或 Claude 账号设置页 | 这是官方订阅额度,不是本机 Token 记录。 |
| 过去几天、几周每天用了多少,哪个模型、哪个会话最贵 | 读取本机会话日志的工具,例如 ccusage 或 Pax | 日志默认只保留 30 天,早于保留期的记录读不到。 |
| 同时用 Codex、DeepSeek Harness,想放在一起对照 | Pax | Pax 只读取本机记录,不连接账号。 |
| 想确认实际账单 | Claude 账号设置页、Console 的 Cost 页面 | 本机的费用数字都是估算。 |
用 Claude Code 自带命令怎么看用量
在会话里运行 /usage
它显示当前会话的 Token 合计、按模型拆分的输入、输出、缓存读取与缓存写入,以及按标价在本机算出的费用。/cost 和 /stats 是它的别名。
订阅用户同屏看套餐用量
Pro、Max、Ultra、Team 与 Enterprise 用户在同一屏能看到套餐用量条和近期用量归因(技能、子代理、插件、MCP 服务)。按 d 或 w 切换最近 24 小时与 7 天。
需要常驻显示时配置状态栏
官方状态栏可以持续显示上下文用量和费用字段,不必反复运行命令。
需要回顾工作方式时运行 /insights
它分析本机最近的会话并生成 HTML 报告,侧重工作习惯,不是 Token 账本,而且分析本身也消耗用量。
怎么用本机会话日志统计 Token 用量
Claude Code 把每个会话的对话记录以 jsonl 文件写在 ~/.claude/projects/<项目>/<会话>.jsonl,子代理的记录在对应会话目录的 subagents/ 下。每条助手回复附带该次请求的 Token 字段,所以任何能解析 jsonl 的工具都可以汇总。
ccusage 是常见的开源命令行工具,读取本机日志生成日报、月报和会话报告(MIT 许可)。自己写脚本也行。选哪个看你要的是命令行报表还是图形界面,两者读的是同一类文件。
这些文件按 cleanupPeriodDays 清理,默认 30 天,最小 1。想长期保留历史,需要在 settings.json 里调大这个值。日志是明文,读取工具都在本机运行;日志里可能包含工具输出里出现过的内容,处理时注意保密。
# 在终端查看日志目录(macOS 默认位置)
ls ~/.claude/projects/
# 用 ccusage 生成日报(需要 Node.js)
npx ccusage@latest daily用 Pax 在 Mac 上看 Claude Code 用量
打开「模型用量」
Pax 读取同一个 macOS 用户下 Claude Code 留在本机的记录,不需要先开启代理,也不需要先创建 API Profile。已有历史可能早于 Pax 的安装时间。
选一天,先看工具与模型分布
在客户端用量里找到 Claude Code,再看模型用量。没有今天的记录时,选择最近有使用的日期。
在 Token 与费用之间切换
对照输入、输出和缓存构成,确认是哪一类 Token 在增长。
怎么找出最费 Token 的那次会话
在「会话分析」的会话开销里,可以按名称或 ID 搜索,点进会话看详情。列表按最近活动排序,不是按费用排序,要找最贵的会话,需要自己按费用对照。
一次会话为什么变贵:上下文与缓存趋势
会话详情把主会话和子代理分开显示。逐请求的上下文与单次输入费用趋势只覆盖主会话,不能和包含子代理的会话总费用直接对等。
缓存 Token 与费用:数字怎么读
- 缓存读取与缓存写入
- Claude Code 会缓存重复出现的内容(如系统提示和历史对话)。缓存读取的单价低于普通输入,缓存写入单价另算。官方文档说明,长会话中每次请求都会带上完整历史,只是按缓存价读取。缓存读取占比按 Token 计算,不是命中缓存的请求次数占比。
- 费用是 API 等价估算
- Pax 的费用 = 本机记录的 Token × 本地价格表,是按 API 价格折算的估算金额,不等于账单。订阅用户按套餐计费,渠道或中转站有自己的倍率,实际扣费以对应服务商为准。
- 价格表会过期
- 新模型、改价之后,估算会与实际有差距。Pax 的价格配置可以调整;官方的 /usage 在配置了 modelPricing 时也会按企业价格显示。
Claude Code 用量限制怎么看:官方额度与本机用量的区别
用量限制指 Anthropic 对订阅套餐设的额度窗口(会话限制、每周限制),由官方服务器计量,在 Claude Code 的 /usage 套餐用量条和 claude.ai 设置页查看。本机日志里的 Token 数是另一回事,它不会告诉你离限制还有多远。
Pax 不显示订阅额度和限制,也不能预测什么时候触顶。看到“You’ve hit your session limit”之类的提示,请以官方说明为准。
DeepSeek Harness 的用量也能一起看
Pax 把 DeepSeek Harness 的本机日志当作一个只读的用量来源,与 Claude Code、Codex 放在同一个界面,可以对照不同工具在同一天用了多少 Token。
DeepSeek Harness 只读取用量,Pax 不会为它写入配置;API 配置切换只用于 Claude Code 和 Codex。
Pax 读了哪些本机数据
Pax 在本机读取 Claude Code、Codex 和 DeepSeek Harness 的日志,用量数据库存在本地,采集在本机完成,不增加 AI 转发网关。
对没有名称的 Claude 主会话,Pax 的会话列表会保存最近一条用户消息的预览,最多 160 个字符;不保存完整提示词和回复。线路检测、订阅更新、模型目录与诊断仍会联网,这不影响用量采集。
用量清楚之后:代理与中转配置
用量异常常和网络、中转配置有关。需要让 Claude Code 稳定走代理,或切换中转 API,看这两篇主线指南。
常见问题
Claude Code 怎么看用量?
在会话里运行 /usage(/cost、/stats 是别名),可看当前会话的 Token 和估算费用;要看历史,读取 ~/.claude/projects/ 下的会话日志,或用 Pax 这类读取本机日志的工具。
Claude Code token 用量怎么统计?
每条助手回复在 jsonl 日志里带有输入、输出和缓存的 Token 字段,把它们按日期、模型或会话汇总即可。注意日志默认只保留 30 天。
cli 怎么查看 Claude Code 用量?
终端里启动 claude,输入 /usage。想在终端外统计,可以用 npx ccusage@latest daily 之类读取本机日志的命令行工具。
Claude Code 的用量限制在哪里看?
订阅额度在 /usage 的套餐用量条和 claude.ai 的设置页查看,由官方计量。Pax 和本机日志统计不显示订阅额度。
Pax 显示的费用是账单吗?
不是。它是按本地价格表对本机 Token 记录算出的 API 等价估算,订阅套餐、中转倍率和价格变动都会让它与实际扣费不同。
Pax 会读取我的对话内容吗?
Pax 读取日志里的用量字段。为方便识别,会为没有名称的 Claude 主会话保存最近一条用户消息的预览,最多 160 个字符,不保存完整提示词和回复。


