额度窗口与重置
额度多少、什么时候刷新,都由厂商决定。Agent HUD 只显示服务真正上报的内容,不替它补充。
窗口是服务报什么就是什么
一个额度窗口,就是厂商返回的一行,各自带着自己的重置时间和周期。Agent HUD 不决定你的额度上限,也不按模板去填这些行:服务叫作 primary 的窗口不会被默认成五小时,按周期命名的窗口——分钟、7d、每周、每月、MCP——保留服务给的名字。
同一个账号的窗口只出现一次,哪怕两个程序共用这个账号。Codex Desktop 和 Codex CLI 登录的是同一处,所以它们的用量是一组行而不是两组,一个客户端记录的用量也不会被搬进另一个客户端的账号里。
百分比一律是「已用」
这沿用 Claude Code /usage 的习惯。厂商通常上报的是剩余比例,由应用换算,所以显示 82% 的窗口还剩 18%。
没拿到的读数显示为破折号,而不是 0。只有服务确实报了零,才会显示 0。
重置要靠新读数确认才算数
窗口的重置时间过去之后,那一行仍然保留最后一次读数和读到它的时刻,这个期限被当作「待确认」,而不是「已完成」。
只有当新读数把重置时间往后推,或者显示窗口重新满了,重置才算确认。在这之前,不会有任何地方声称额度已经回来。
这一条很重要,因为「时间点到了」并不等于「事情发生了」。厂商侧的时序、时钟差异、还没跑到的那次刷新,都会让表上的时刻先于额度真正恢复。
哪些东西从不推算
- Token 不会被换算成额度,拿不到的额度也不会从 Token 数量倒推。
- 只有 Claude Code 能显示当前会话的占比:它在进行中的五小时窗口里占的 Token 份额,乘以这个窗口的使用率。其他客户端一律显示破折号。
- 一次 API 响应只计一次,不管日志是什么排布。同一个事件在两个文件里、或者在两台 Mac 上的副本会合并;两个确实独立、只是数字恰好相同的请求则都保留。
重置次数和余额不是窗口
Codex 会上报还剩几次重置,这个数字按服务给的原样显示。旁边那份逐次到期清单只是补充,从不用来反推次数。
按请求计费的客户端(比如 DeepSeek)根本没有窗口,显示的是账户余额和近期用量的预计费用,预计值一律标注为预计。金额保留自己的币种:不跨币种换算,也不会变成百分比。
什么时候会提醒你
已用 70% 起为警告,90% 起为危险。这套策略是固定的——没有开关、不存储、也不在设备之间同步。
颜色描述的是单个读数的状态。不同窗口的读数从不合成一个健康分,颜色也从不表示任务进行得怎么样。
- 四件事各提醒一次:越过已用 90%、用尽归零、预计撑不到重置、以及一次确认的重置。
- 启动后每个窗口的第一次读数是静默基线,所以启动时就已经在屏幕上的状态永远不会触发提醒。
- 超过 30 分钟的旧读数仍然显示,但不再产生提醒。
常见问题
- 我的 Claude Code 额度什么时候重置?
- 由厂商决定。Agent HUD 显示随窗口一起返回的重置时间,并且只有新读数把重置时间往后推、或者显示窗口重新满了,才标记为已重置。同一个账号下的不同窗口,各自按自己的节奏重置。
- 百分比是已用还是剩余?
- 已用。显示 90% 的窗口还剩 10%。这沿用 Claude Code /usage 的习惯。
- 为什么有个窗口显示破折号而不是数字?
- 要么还没拿到读数,要么厂商对你的账号不提供这个数字。破折号和 0 不是一回事,Agent HUD 也不会拿 Token 数量去估这个值。
- Codex Desktop 和 Codex CLI 的额度是分开的吗?
- 不是。它们登录同一个账号,所以窗口是同一组行,一边的用量不会被重复算进另一边。
- 70% 和 90% 这两档能改吗?
- 不能。阈值是固定的,不存储也不同步,所以同一个读数在每台设备上显示的状态都一样。
指南
最近更新: 2026-09-20 · 这里描述的行为,在 Agent HUD Open 的文档里有完整说明,并附有对应代码。 github.com/jazzenchen/agent-hud-open