Token 与费用
Agent HUD 怎样统计各 agent 的 Token,怎样按 API 标价估算费用,以及在你的 Mac 上保留 30 天历史。
Agent HUD 读取各 agent 本来就保存的记录,告诉你 Token 用在了哪里:哪些 agent、模型、会话和轮次用掉了它们,同样的工作按 API 标价大约要花多少。额度告诉你还剩多少,Token 用量告诉你是怎么用掉的。
统计什么
每次调用都拆成互不重叠的五类,五类相加正好是这次调用的全部:
| 类别 | 包含什么 |
|---|---|
| 输入 | 没有经过缓存的新提示 Token |
| 输出 | 回复本身,不含思考 |
| 思考 | 回复之前用于思考的输出 |
| 缓存写入 | 写入缓存、供后续调用使用的提示 Token |
| 缓存读取 | 从缓存读回的提示 Token |
- 很多日志把思考算在输出里,把缓存的部分算在输入里。Agent HUD 把它们拆出来,每一类只算一次。
- 日志里重复记下的同一次响应,只计一次。
- 一个会话的 Token 包含它启动的子 agent。跨 agent 的合计里,每个子 agent 的记录只算一次。
- 缓存命中是提示 Token(输入、缓存写入与缓存读取)中从缓存读取的比例。
缓存读取是 agent 每次调用都要读回的上下文,它随会话变长而增长,和这段会话做了多少事关系不大。所以 Token 图表默认不含缓存读取。比较两个总数时,先让它们包含相同的类别。
在哪里看
- 悬停面板:过去 24 小时的 Token,显示在额度旁边。
- 统计窗口:点悬停面板底部的用量统计打开,有 Token 与会话两个标签页。
- 会话页:在会话标签页或悬停面板里点一个会话。
- iPhone 与 Apple Watch:Token 统计、会话及其 Token。见 iPhone。
- 你的 agent:内置 MCP 服务用同一份数据回答关于用量、会话与统计的问题。
Token 标签页
| 控件或区域 | 显示什么 |
|---|---|
| 统计范围 | 5 小时、24 小时、7 天或 30 天 |
| 时间粒度 | 5 小时与 24 小时可选 15 分钟、30 分钟或 1 小时;7 天可选 1 小时或 1 天;30 天按 1 天 |
| 类别 | 不含缓存读取(默认)、全部 Token,或五类中的任意组合 |
| 智能体与模型 | 只看部分 agent 或模型 |
| 按智能体 | 每个 agent 在所选范围里的 Token、占比与估算费用,以及用得最多的模型与会话 |
| API 余额 | DeepSeek 等余额,附每天的花费 |
| 近期用量 | 今天、近 7 天与近 30 天,各带缓存命中率与用得最多的模型 |
| 活跃热力图 · 近 7 天 | agent 在哪些钟点工作 |
会话页
会话页显示这个会话的 Token(含子 agent 的部分)、估算费用、上下文占用与缓存命中。Claude Code、Codex 与 DeepSeek Harness 的会话还会列出每一轮新增的 Token,以及这一轮里每次调用的模型、上下文和它请求的工具。需要把上下文重新发送一遍的调用,标有缓存过期,上下文重发。
费用
费用是估算:同样的调用按厂商的 API 标价计算,标 ≈。它不是实际扣费,也不是订阅的账单。
- 每类 Token 按各自的单价计算,每次调用按它的提示长度所在的价格档位计算。
- 中国区或国际区价目:DeepSeek、智谱 GLM、Kimi(月之暗面)、通义千问与小米 MiMo 都公布两套价格。Agent HUD 按 agent 所连的平台取价:看它配置的端点或套餐,DeepSeek 看余额的币种。看不出来,或者一个 agent 两边都连时,按国际区价目。
- 人民币与美元分开累计,从不换算。
- 没有标价的模型不计入估算,估算的说明里会写出它的名字。
- 经过中转站的调用,优先用中转站自己的价格表;没有时按官方价乘以你设置的倍率。你自己电脑上的模型服务按免费计算。
修正价格
设置 → 价格列出最近 30 天里 agent 用过的每个模型,附它的 Token、每百万 Token 的价格,以及价格来源:价目表、中转站价格表、倍率、自定义或本地。点设置价格填写你自己的价格,费用随即重算;点改回自动价格即可恢复。
历史与时间范围
- Token 历史保存在你 Mac 本机的数据库里,保留 30 天,更早的用量逐日清理。第一次启动 Agent HUD 时,它会读取 Mac 上已有的记录,最远回溯到这 30 天。
- 会话标签页列出近 7 天里活跃过的会话。按日期按最后活跃的日期分组;活跃只列近 24 小时里活跃过或仍在运行的会话。可以按来源和项目路径筛选,也可以按标题、来源、模型或路径搜索。
- 子 agent 不单独列出,从启动它的会话里进入。
- 归档或删除的会话:你在 agent 里归档或删除一个会话后,它的 Token 仍计入合计,会话本身从所有列表里消失。
数据从哪里来
Token 数来自各 agent 写在你 Mac 上的记录:它的日志或本地数据库,只读,不做改动。agent 写下新的用量后,统计随之更新。有两个 agent 不同:
- Cursor 不在本机保存 Token;从 Cursor 3.27 起,它的完成回调会报告每次生成的 Token,前提是客户端回调已打开。
- Grok Bot 的 Bot 运行在 Cursor 的服务器上,由服务器给出每个 Bot 每天的 Token。
Token 总数说明不了额度还剩多少:额度百分比是厂商自己对你套餐的读数。见额度与余额。
最后更新于