# 额度与余额

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

Agent HUD 怎样读取各厂商的额度窗口与余额，怎样按消耗速度做预测，并在窗口用完之前提醒你。

更新于 2026-10-28

Agent HUD 把各 agent 的厂商报告的每一项额度都留在屏幕边缘：每个窗口用了多少、什么时候重置、这个周期用得多快，以及照这个速度会不会在重置前用完。DeepSeek 这类余额则显示为金额，附每天的花费。

![悬停面板：Claude 与 OpenAI 的额度窗口，各带已用比例与重置时间，以及 DeepSeek 的余额](https://agenthud.app/docs/images/hud/panel.zh.dark.webp)

## 什么是窗口

**窗口**是厂商在一段时间里计量的一份额度，有自己的名字、时长和重置时间：5 小时的会话窗口、每周额度、每月总额度。面板里的每一行就是厂商报告的一个窗口，原样显示。Agent HUD 不预设你的套餐包含哪些额度。

- 窗口从不加总。Claude 的每周额度和 Codex 的 5 小时额度按不同的时钟走，其中任何一个都可能先让你停下来。
- 额度属于账户。两个程序用同一个登录，比如 Codex 桌面版和 Codex CLI，只显示一组窗口。两台 Mac 登录同一个账户，从厂商读到的是同一组窗口。
- Token 从不换算成额度，缺失的额度也从不靠 Token 数推算。

## 各厂商的窗口

面板里的额度分组按厂商命名：Claude Code 的窗口在 **Claude** 下，Codex 的在 **OpenAI** 下。窗口名称沿用应用里显示的名字；空间不够时，一行可能显示较短的名字，比如 **Weekly**。

| Agent | 窗口（应用中显示的名字） |
| --- | --- |
| Claude Code | **Current session**（5 小时）、**Weekly limit · All models**，以及套餐对某个模型系列设的每周额度，比如 **Weekly limit · Opus** |
| Codex | 按时长命名，比如 **5h limit** 与 **Weekly limit**。Codex 报告的其他额度用它自己的名字显示。账户可用的重置次数显示在旁边 |
| Cursor | **Included usage**、**Cursor Models**、**Other Models**、**Individual spending limit**、**Pooled usage** 与 **On-demand usage**，以你的套餐报出的为准，重置时间以 Cursor 给出的为准 |
| GitHub Copilot CLI | **Premium requests**、**AI credits**、**Chat messages** 与 **Code completions** 中你的套餐计量的那些，各带重置日期 |
| Antigravity | 每个模型组的每个窗口一行，比如 **Gemini Models** 或 **Claude and GPT models** |
| Grok Bot | **Weekly usage limit**，试用期间是 **Trial usage limit**；为额外用量设了上限时，还有 **Extra usage** |
| Kimi | **5-hour quota**、**Weekly quota** 与 **Monthly total quota**，以你的 Kimi Code 套餐报出的为准 |
| OpenCode | OpenCode Go 套餐的 **5-hour limit**、**Weekly limit** 与 **Monthly limit** |
| GLM Coding Plan | **5-hour credits** 与 **Weekly credits**，较早的套餐是 **5-hour limit** 与 **Weekly limit**；GLM 报告时还有 **MCP usage** |
| Devin CLI | **每日额度**与**每周额度** |
| DeepSeek Harness | 余额，不是窗口 |
| Pi | 它所用的套餐：ChatGPT 登录归在 Codex 下，GLM 密钥归在 GLM 下 |
| WorkBuddy | 只在 WorkBuddy 记下某个模型达到套餐上限后显示这项上限，直到它给出的重置时间 |

[支持的 agent](https://agenthud.app/docs/zh/agents/supported/) 表里没有额度的 agent 不报告额度，Agent HUD 只显示它们的 Token 与会话。

## 怎样读一行

每一行显示窗口的已用比例与重置时间。

- **已用还是剩余**：百分比默认表示已用比例。要改为显示剩余比例，打开**设置 → 通用 → 用量显示**，把**额度百分比**设为**剩余（100% → 0%）**，已用 82% 的窗口就显示为 18%。颜色、消耗速度与提醒始终按已用比例计算。
- **`--`**：这个窗口还没有读数，或者厂商不为你的账户报告它。它从不表示零。
- **等待更新**：重置时间已经过了，但还没有新读数确认重置。在那之前，这一行保留上一次读数。
- **已过期**：上一次读取失败，这一行保留上一次读数并标为过期：「额度读数已过期，请刷新这个账户。」

新读数把重置时间往后推，或者显示窗口从至少高出 5 个百分点的用量回到零，重置才算确认。

要隐藏某个窗口或调整各行顺序，见[光晕与面板](https://agenthud.app/docs/zh/hud/glow-and-panel/)。

## 消耗速度与预测

**消耗速度**是每小时用掉的窗口比例，按当前周期的读数计算。点分组旁的火焰按钮，就能把这一组的各行切换为消耗速度。每一行随后显示：

- 速度，比如 **10.0%/h**；
- 照这个速度会在重置前用完时，显示用完的日期与时刻；
- 否则显示到重置时会用掉多少，比如**重置时 62%**。

预测需要当前周期里跨越至少 15 分钟的读数；时长一天及以上的窗口（比如每周额度）需要 1 小时。在那之前，这一行写着**采样中**；每次重置之后写着**重新采样**。

举个例子：剩余 40%，消耗速度每小时 10%，照这个速度大约还能用 4 小时。3 小时后重置，就撑得到；6 小时后才重置，就会先用完。

消耗速度衡量的是额度，不是每小时的 Token，也不是费用。

## 颜色与提醒

光晕和每一行的颜色都按已用比例决定。这几道线是固定的，所以同一个读数在 Mac、iPhone 与 Apple Watch 上颜色一致：

| 已用比例 | 颜色 |
| --- | --- |
| 不足 70% | 绿色 |
| 70% 及以上 | 黄色 |
| 90% 及以上 | 红色 |

剩余 0.5% 或更少时，窗口算作已用尽。

提醒显示在 HUD 上，从不使用 macOS 通知。Agent HUD 会在这些时候提醒你：

1. **窗口有风险时提醒一次**：预测显示它会在重置前用完，或者它越过了 90%。提醒写着「按最近的消耗速率，预计将在重置前耗尽。」或「已用额度达到危险阈值，请留意后续任务。」
2. **窗口用完时**：「当前窗口额度已耗尽，等待重置。」
3. **新读数确认已重置时**：「此窗口额度已重置。」同一个账户里还有其他窗口仍然用尽时，提醒会列出它们。
4. **Codex 为你的账户新增重置次数时**：「此账户新增了 1 次额度重置。」

Agent HUD 启动后的第一次读数只作为基准，超过 30 分钟的读数也不再触发提醒，所以重启应用不会重复提醒。有 Agent HUD Remote 时，越过 90%、窗口用完、确认重置与新增重置次数这几类提醒也会到 iPhone 与 Apple Watch 上；只来自预测的提醒留在 HUD 上。

## 余额

按余额计费的 agent 显示金额，而不是百分比。

- **DeepSeek Harness**：DeepSeek API 的余额，保留它自己的币种，附每天的花费，以及照这个速度余额用完的日期。花费是估算：按 DeepSeek 的标价，计算 Harness 在这台 Mac 上记录的调用。余额低于等于 10 元或 2 美元时变黄，降到零或 DeepSeek 拒绝调用时变红。
- **中转站**：你的 agent 经过中转站时，可以在**设置 → 中转站**里打开它，读取它还剩多少。打开之前，不会向中转站发送任何内容。

各币种保持原样，金额从不换算。

## 多个账户

每个账户显示在它的厂商下面，有自己的标签和窗口。同一个账户出现两次只算一次，比如两个 Antigravity CLI 报出同一个邮箱。

- **Claude Code** 与大多数 agent：这台 Mac 上 agent 当前登录的账户。
- **Codex**：同一个邮箱在两个工作区里算两个账户。在 Pi 里用 ChatGPT 登录的账户如果和某个 Codex 账户相同，只算一次。
- **GLM Coding Plan**：每个密钥算一个套餐，即使两个密钥属于同一个账户。

### 添加 Codex 账户

用 Codex 登录每个额外的账户，各自放在自己的 `CODEX_HOME` 文件夹里。

打开**设置 → 智能体 → Codex**，找到**更多 Codex 账户**。

每行填写一个文件夹，使用绝对路径或以 `~/` 开头，然后点**保存账户**。

默认账户会继续显示。额外的账户只添上额度，不添会话，Agent HUD 依次读取它们。某个文件夹读取失败时会显示一条说明，其他账户照常读取。清空列表即只保留默认账户。

### 添加 Antigravity CLI 账户

打开**设置 → 智能体 → Antigravity**，找到 **Antigravity CLI 账户**。

每行填写一个 CLI 的 `settings.json` 路径，或者点**添加默认配置**。

点**连接账户**，然后启动或重启每个 CLI。

连接会在 CLI 的状态栏旁添加一个本地额度回调，你原有的状态栏保持不变。用过的账户会陆续显示，在 CLI 里切换账户后也会保留。超过 5 分钟的读数标为过期，直到 CLI 再次报告。要恢复某个 CLI 原有的状态栏，删掉它的路径，再点一次**连接账户**。

## 退出登录或读取失败

某个 agent 没装、退出登录或读取失败，都不会遮住其他 agent。

- **退出登录**：这个 agent 的额度行会消失，分组里写明原因和重新登录的方法，比如「Claude Code 已退出登录，运行 claude 重新登录后恢复额度」或「Codex 尚未登录，运行 codex login 登录 ChatGPT 后即可读取额度」。
- **没有套餐额度**：API key、第三方平台或自定义模型服务没有套餐可读，分组会写明，比如「当前登录方式没有订阅额度（API key 或第三方平台）」。
- **读取失败**：上一次读数保留下来并标为过期，Agent HUD 会再次尝试。

无论哪种情况，这个 agent 的 Token 与会话都照常按 Mac 上的记录统计。各个账户依次读取，读取时不向模型发送任何消息。

---

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