使用指南 · Claude Code 用量

Claude Code 用量怎么看

Claude Code 的用量有两个来源:命令行里的 /usage,和留在本机的会话日志。前者看当前会话,后者能回头看历史。下面先讲通用做法,再讲怎么用 Pax 在 Mac 上按日期和会话查看。

简短回答

在 Claude Code 里运行 /usage(/cost、/stats 是别名),可看当前会话的 Token 与费用估算;会话记录以 jsonl 文件保存在 ~/.claude/projects/,可以读取统计历史用量。

出处Claude Code 官方文档:CommandsClaude Code 官方文档:Manage costsClaude Code 官方文档:.claude directory

先判断你想看哪一种用量

按问题选择入口
你想知道先用什么要注意
当前这一次会话用了多少 Token、大约多少钱Claude Code 内的 /usage(/cost 是别名)/clear 之后这些合计会归零,只覆盖当前会话。
订阅套餐还剩多少额度、什么时候重置同一个 /usage 的套餐用量条,或 Claude 账号设置页这是官方订阅额度,不是本机 Token 记录。
过去几天、几周每天用了多少,哪个模型、哪个会话最贵读取本机会话日志的工具,例如 ccusage 或 Pax日志默认只保留 30 天,早于保留期的记录读不到。
同时用 Codex、DeepSeek Harness,想放在一起对照PaxPax 只读取本机记录,不连接账号。
想确认实际账单Claude 账号设置页、Console 的 Cost 页面本机的费用数字都是估算。

用 Claude Code 自带命令怎么看用量

  1. 在会话里运行 /usage

    它显示当前会话的 Token 合计、按模型拆分的输入、输出、缓存读取与缓存写入,以及按标价在本机算出的费用。/cost 和 /stats 是它的别名。

  2. 订阅用户同屏看套餐用量

    Pro、Max、Ultra、Team 与 Enterprise 用户在同一屏能看到套餐用量条和近期用量归因(技能、子代理、插件、MCP 服务)。按 d 或 w 切换最近 24 小时与 7 天。

  3. 需要常驻显示时配置状态栏

    官方状态栏可以持续显示上下文用量和费用字段,不必反复运行命令。

  4. 需要回顾工作方式时运行 /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 用量

  1. 打开「模型用量」

    Pax 读取同一个 macOS 用户下 Claude Code 留在本机的记录,不需要先开启代理,也不需要先创建 API Profile。已有历史可能早于 Pax 的安装时间。

  2. 选一天,先看工具与模型分布

    在客户端用量里找到 Claude Code,再看模型用量。没有今天的记录时,选择最近有使用的日期。

  3. 在 Token 与费用之间切换

    对照输入、输出和缓存构成,确认是哪一类 Token 在增长。

模型用量概览:估算费用、Token、请求数、缓存、用量趋势与客户端分布。
打开「模型用量 → 概览」,选择日期,再对照费用、Token 与缓存。真实 Pax Demo 界面 · 内存模拟数据 · 中文 UI · 2026-11-11 截图
  1. 先选日期

    右上角选本周、本月或自定日期。截图使用本月模拟记录。

  2. 再看构成

    顶部看总量,中间对照输入、输出、缓存与各工具的分布。

  3. 继续下钻

    需要解释某段成本时,切到「会话分析」,而不是只看总 Token。

怎么找出最费 Token 的那次会话

在「会话分析」的会话开销里,可以按名称或 ID 搜索,点进会话看详情。列表按最近活动排序,不是按费用排序,要找最贵的会话,需要自己按费用对照。

会话分析的汇总卡和会话开销列表,含三段输入费比例、倍率与估算增费。
打开「模型用量 → 会话分析」,在会话开销中选择要复盘的任务。真实 Pax Demo 界面 · 内存模拟数据 · 中文 UI · 2026-11-11 截图
  1. 先看统计范围

    日期决定汇总范围;主会话与子代理的费用应结合页面口径阅读。

  2. 找到会话

    按名称或 ID 搜索,点击会话名称进入详情。

  3. 读懂比例条

    三段表示输入费用占比。红色是经济参考区间,不等于模型无法继续。

一次会话为什么变贵:上下文与缓存趋势

会话详情把主会话和子代理分开显示。逐请求的上下文与单次输入费用趋势只覆盖主会话,不能和包含子代理的会话总费用直接对等。

单会话详情,区分主会话、子代理和模型行,并显示费用倍率与估算增费。
点击一段会话后,主会话与子代理分开看;向下滚动查看逐请求趋势。真实 Pax Demo 界面 · 内存模拟数据 · 中文 UI · 2026-11-11 截图
  1. 确认所选任务

    返回按钮右侧是当前会话名称,避免把多段任务的汇总当成单会话。

  2. 分开看子代理

    右侧「主会话 / 子代理」切换分布。不要把汇总和子代理再加一遍。

  3. 再看趋势

    下方沿请求看上下文和单次输入费用。估算增费不代表保证能省下的金额。

缓存 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 个字符,不保存完整提示词和回复。

让 Pax,来到你的 Mac。

获取 Mac 安装包。安装前请查看系统要求和首次打开说明。

macOS 26+ · Apple Silicon

让 Pax,来到你的 Mac。

获取 Mac 安装包。安装前请查看系统要求和首次打开说明。

下载 Mac 版

macOS 26+ · Apple Silicon

系统要求与安装说明 ↗
真实 Pax Demo 界面 · 内存模拟数据

2026-11-11 截图,App 为中文界面。示例数字不代表实测或账单,点开放大。