Agent HUD
指南

Token 都用在了哪里?

Agent HUD 读取 agents 本来就保存的记录,告诉你 Token 用在了哪里:哪些 agent、模型、会话和轮次用掉了它们,同样的工作按 API 标价大约要花多少。额度告诉你还剩多少,Token 用量告诉你是怎么用掉的。

更新于 2026-10-26

可以追踪哪些维度?

数字来自 agents 保存在你电脑上的记录,共九个维度。

维度可以追踪
时间过去 5 小时、24 小时、7 天或 30 天,柱宽从 15 分钟到 1 天。历史在你的电脑上保留 30 天。
Token 类别输入、输出、推理、缓存写入与缓存读取,可以全看,也可以任意组合。
Agent 与模型每个 agent 的占比、Token 与费用,以及用到的模型。
会话Token(含子 agent 的部分)、费用、轮数、调用数、上下文占用与缓存命中。子 agent 计入启动它的会话。
轮次与调用每一轮新增的 Token,以及每次调用的模型、上下文和它请求的工具。
缓存命中今天、近 7 天、近 30 天,每个会话,以及会话里的每个模型。
费用按各家的 API 标价估算(中国区或国际区价目),标 ≈,并非实际扣费。
活跃时段过去 7 天里,agents 在哪些钟点工作。
余额DeepSeek 每天的花费,以及余额预计用完的日期。

Token 是怎么计数的?

每次调用都拆成五类:输入、输出、推理、缓存写入与缓存读取。很多日志把推理算在输出里,把缓存的部分算在输入里;Agent HUD 把它们拆出来单独计数,五类相加正好是这次调用的全部,没有重复。

日志里重复记下的同一次响应,只计一次。

类别包含什么
输入没有经过缓存的新提示 Token
输出回复本身,不含推理
推理回复之前用于思考的输出
缓存写入写入缓存、供后续调用使用的提示 Token
缓存读取从缓存读回的提示 Token

图表为什么默认不含缓存读取?

缓存读取是 agent 每次调用都要读回的上下文。它随会话变长而增长,和这段会话做了多少事关系不大。

所以 Token 图表默认显示另外四类,也可以全看,或任意组合。比较两个总数时,先让它们包含相同的类别。

会话、轮次与调用能看到什么?

一个会话的 Token 与费用包含它启动的子 agent,会话页会单独标出子 agent 的部分。跨 agent 的合计里,每个子 agent 的记录只算一次。

Claude Code、Codex 与 DeepSeek Harness 的会话还能按轮次拆开:每次提问带来的新 Token,以及随后的每次调用,各自的模型、上下文和它请求的工具。上下文占用告诉你这个会话离模型的上下文上限有多近。

缓存命中是提示 Token 中从缓存读取的比例。需要把上下文重新写入缓存的调用会被标出来。

费用代表什么?

费用是估算:同样的调用按该厂商的 API 标价计算,取它的中国区或国际区价目,标 ≈。它不是实际扣费,也不是订阅的账单。

每类 Token 按各自的单价计算,每次调用按它的提示长度所在的价格档位计算。人民币与美元分开累计。没有标价的模型不计入估算,估算的说明里会写出它的名字。

DeepSeek 按余额扣费,Agent HUD 还会显示它每天的花费,以及余额预计用完的日期。

Token 能说明额度还剩多少吗?

不能。额度百分比是厂商自己对你套餐的读数;Token 数来自你电脑上的记录。Token 总数大,不代表额度快用完;总数小,也不代表还剩很多。

额度能撑到重置吗?

在哪里看?

在 Mac 上,HUD 的悬停面板在额度旁边显示过去 24 小时的 Token。统计窗口里有图表、活跃时段,以及按 agent 和模型的拆分;每个会话也有自己的页面。

iPhone 与 Apple Watch 上可以查看 Token 统计、会话及其 Token。iPhone 和 Mac 上的发行版在同一网络时,免费使用;Agent HUD Remote 让你在任何网络下都能看到。

agent 也可以问。Agent HUD 内置的 MCP 服务能回答关于用量、会话与统计的问题,数据来自应用已有的记录。

展开的 iPhone Duo 上的 Agent HUD 统计页:折痕左侧是按模型堆叠的 Token,右侧是今天、近 7 天与近 30 天的用量
展开的 iPhone Duo 上的统计页

常见问题

推理 Token 会被算两次吗?

不会。很多日志把推理算在输出里,Agent HUD 把它从输出中拆出来,单独作为一类。

费用就是我要付的钱吗?

不是。它是按 API 标价的估算,标 ≈。订阅按套餐收费,实际付了多少,以厂商自己的账单为准。

哪些 agent 能看到轮次与调用?

Claude Code、Codex 与 DeepSeek Harness。所有支持的 agent 都能看到 Token 与会话;每个 agent 的其余能力见支持的 agent。

Token 历史保留多久?

30 天,保存在你的电脑上。