# Token 与费用

[Agent HUD 文档](https://agenthud.app/docs/zh/)

Agent HUD 怎样统计各 agent 的 Token，怎样按 API 标价估算费用，以及在你的 Mac 上保留 30 天历史。

更新于 2026-10-28

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](https://agenthud.app/docs/zh/phone/iphone/)。
- **你的 agent**：[内置 MCP 服务](https://agenthud.app/docs/zh/mcp/)用同一份数据回答关于用量、会话与统计的问题。

{/* figure: 统计窗口的 Token 标签页：图表、按智能体的卡片与近期用量，示例数据 */}

### 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，前提是[客户端回调](https://agenthud.app/docs/zh/agents/hooks/)已打开。
- **Grok Bot** 的 Bot 运行在 Cursor 的服务器上，由服务器给出每个 Bot 每天的 Token。

Token 总数说明不了额度还剩多少：额度百分比是厂商自己对你套餐的读数。见[额度与余额](https://agenthud.app/docs/zh/agents/quotas/)。

---

English: https://agenthud.app/docs/en/agents/tokens/