额度与余额
Agent HUD 怎样读取各厂商的额度窗口与余额，怎样按消耗速度做预测，并在窗口用完之前提醒你。
Agent HUD 把各 agent 的厂商报告的每一项额度都留在屏幕边缘：每个窗口用了多少、什么时候重置、这个周期用得多快，以及照这个速度会不会在重置前用完。DeepSeek 这类余额则显示为金额，附每天的花费。
什么是窗口
窗口是厂商在一段时间里计量的一份额度，有自己的名字、时长和重置时间：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 表里没有额度的 agent 不报告额度，Agent HUD 只显示它们的 Token 与会话。
怎样读一行
每一行显示窗口的已用比例与重置时间。
- 已用还是剩余：百分比默认表示已用比例。要改为显示剩余比例，打开设置 → 通用 → 用量显示，把额度百分比设为剩余（100% → 0%），已用 82% 的窗口就显示为 18%。颜色、消耗速度与提醒始终按已用比例计算。
--：这个窗口还没有读数，或者厂商不为你的账户报告它。它从不表示零。- 等待更新：重置时间已经过了，但还没有新读数确认重置。在那之前，这一行保留上一次读数。
- 已过期：上一次读取失败，这一行保留上一次读数并标为过期：「额度读数已过期，请刷新这个账户。」
新读数把重置时间往后推，或者显示窗口从至少高出 5 个百分点的用量回到零，重置才算确认。
要隐藏某个窗口或调整各行顺序，见光晕与面板。
消耗速度与预测
消耗速度是每小时用掉的窗口比例，按当前周期的读数计算。点分组旁的火焰按钮，就能把这一组的各行切换为消耗速度。每一行随后显示：
- 速度，比如 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 会在这些时候提醒你：
- 窗口有风险时提醒一次：预测显示它会在重置前用完，或者它越过了 90%。提醒写着「按最近的消耗速率，预计将在重置前耗尽。」或「已用额度达到危险阈值，请留意后续任务。」
- 窗口用完时：「当前窗口额度已耗尽，等待重置。」
- 新读数确认已重置时：「此窗口额度已重置。」同一个账户里还有其他窗口仍然用尽时，提醒会列出它们。
- 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 上的记录统计。各个账户依次读取，读取时不向模型发送任何消息。
最后更新于