Agent HUD · 指南

在 Mac 查看 AI 编程 Token 用量与费用估算

先选时段,找到总量背后的会话,再查看消耗较高的轮次。Agent HUD 的免费 Mac 统计窗口展示已记录的 Token 与费用估算:按量计费使用账户价格,其余用量按公开 API 价折合。

1. 先选时段与统计口径

打开统计窗口并选择「Token」,通过时段和分桶大小查看用量何时上升。需要查看某个模型时,展开模型筛选;筛选会改变图表、总量及费用估算。

默认 Token 选择不含缓存读取。想查看多次调用读回的全部上下文时,选择全部类别。比较不同客户端或日期时,保持类别与时段一致。

Agent HUD Mac 统计窗口,包含 Token 图表、客户端明细与近期用量
原生 Mac 截图,使用示例数据。此图不含缓存读取,模型名称与数字用于展示界面。

2. 找到总量背后的会话

切换到「会话」,按客户端、项目或标题缩小范围。每行显示会话的 Token 总量,有价格时也显示费用估算:按量计费用量使用账户价格,其余用量按公开 API 价折合。日期分组按最后活跃日划分,运行中的会话归入今天;活跃视图显示运行中及近 24 小时活跃过的会话。

会话统计全部五类 Token,包含缓存读取,列表范围也独立于 Token 页。会话数字更大不代表图表漏记,先确认比较的是相同类别与范围。

Mac 会话列表,包含 Token 总量、费用估算和逐轮缩略图
示例会话列表。标有 ≈ 的金额是按 API 价估算的金额,不是订阅扣费。

3. 打开会话再判断消耗

选择一个会话,查看模型、Token 总量、费用估算,以及客户端记录中可用的上下文和缓存命中率。能读取到的子 agent 日志也会计入明细。较大的 Token 总量可能包含多次读回的缓存上下文,要同时查看类别与总数。

额度占比与 Token 折合金额回答的是不同问题。Claude Code 的会话额度占比使用当前额度窗口,并不是所有客户端通用的 Token 转额度算法。

Claude Code 会话汇总,显示 Token、API 价费用估算、额度占比、轮次、上下文与缓存命中率
示例 Claude Code 会话。≈ 金额、额度占比与缓存命中率是三种不同的读数。

4. 查看每轮、每次调用与缓存过期

Claude Code、Codex 和 DeepSeek Harness 支持逐轮明细。一轮包含一个 prompt 之后、下一个 prompt 之前的调用,也包含可读取的子 agent 调用。选择一轮可查看其中的调用;每轮都有价格时,可切换为费用图表,比较按 API 价折合的金额。

对照较高的柱子、上下文与缓存标记。下图高亮的轮次标注缓存过期后重新发送上下文。它解释记录到的缓存行为,单凭这个标记不能证明发生了上下文压缩或无效工作。

逐轮 Token 柱状图和上下文图,标记缓存过期后重新发送上下文的轮次
示例逐轮图表。高亮轮次是缓存过期后的上下文重发,淡化部分标识子 agent 贡献。

5. 按实际口径理解费用估算

订阅账户的 ≈ 金额表示已记录调用按公开 API 价大约值多少钱。它不是账单、额外扣费,也不表示订阅剩余额度。按量计费账户还可能提供自己的余额与账户费用估算。

Token 页按时段内所选类别与模型、各客户端连接的平台计价,不同币种分别合计。非 API 计费会话的公开价估算使用国际价,并可按单次调用的长提示词档位计价;按量计费会话则使用账户价格。因此不同口径的总额可能不同。

短横线或无价格模型表示数据不可用,不代表免费。这些截图使用示例数据,没有展示所有可用的价格视图。

查看 Token 统计与计价规则

离开 Mac 后继续查看

Mac 统计功能免费。Agent HUD Remote 提供 iPhone 与 Apple Watch 的跨设备查看,iPhone 会话列表也显示会话总量与费用估算。同一网络上的 iPhone 还可使用免费的局域网配对 Beta。

设置 iPhone 与 Apple Watch 查看

常见问题

可以一起跟踪 Claude Code 与 Codex 的 Token 吗?
可以。Agent HUD 读取它们的本机用量记录并在 Mac 统计窗口展示。Claude Code、Codex 和 DeepSeek Harness 还支持逐轮明细,其他客户端可显示的字段取决于其记录。
为什么会话总量比 Token 图表大?
会话包含全部五类 Token,含缓存读取。Token 图表默认不含缓存读取,并使用自己所选的时段与模型。先确认比较的是相同类别与范围。
费用估算能判断 Claude Max 值不值吗?
它显示已记录用量按 API 价折合的预计金额,不是订阅省下的钱或实际账单。需要同时看实际套餐费用、额度限制和工作的价值,单凭估算不能判断是否值得购买。
没有费用估算就代表模型免费吗?
不代表。模型或调用渠道可能没有可用价格,记录不完整也可能让会话缺少估算。实际扣费应以厂商的账单记录为准。

相关任务与工具

获取 Mac 版 Agent HUD

下载 Mac 正式版。本地监控、额度、Token 与受支持的批准功能免费,需要 macOS 14 或更新版本;可查看的数据因客户端而异。

获取 Mac 版 Agent HUD

查看源码与构建说明 · Mac 与 iPhone

最近更新: 2026-10-12 · 这里描述的行为,在 Agent HUD Open 的文档里有完整说明,并附有对应代码。 github.com/jazzenchen/agent-hud-open