Agent HUD

Agent HUD · 指南

怎么查 Codex 还剩多少额度

Codex 按主、次两个使用额度计量,同时还显示一个上下文百分比——那不是其中任何一个。

有哪些额度

Codex 把限流上报成带各自时长的窗口——七天的读作每周,其余按小时或分钟。一个套餐通常有一个主窗口和一个次窗口,任何一个都可能是先把你拦下的那个。

旁边还有服务上报的、还剩几次可用的重置,那是个次数而不是百分比。

在哪看

  • 会话里的 /status。Codex 自己给出的当前会话与额度明细;快到上限时 Codex 会提示你去看它。
  • 状态栏。Codex 可以把主、次额度的剩余量常驻显示在会话底部,前提是你把这两项加进状态栏。
  • 屏幕上的监控。把窗口和重置倒计时放在任何单个会话之外,还能同时看到其他 agent。

上下文百分比不是你的使用额度

Codex 还会显示这次对话用掉了多少上下文窗口。那说的是这次对话有多满,压缩或者新开一个会话就会重置它。你的使用额度不受这两件事影响。

两个都往 100% 走的数字很容易混。真正会拦下你的是使用额度。

Agent HUD 显示什么

Codex 返回的每个窗口,按各自时长标注,给出已用百分比和重置时间,外加服务上报的可用重置次数。

Codex Desktop 和 Codex CLI 登录同一个账号,所以共用一组窗口,不会出现两份。一边的用量不会被复制进另一边。

它读 rollout 日志和引擎已有的登录态,从不读取存储的凭据文件。

窗口用完了怎么办

  • 等重置,或者用掉一次可用的重置次数(如果你的套餐有)。
  • 把推理强度调低。Codex 自己提示更高的推理强度会更快消耗额度。
  • 把活交给别的 agent。它们的额度是分开的。

常见问题

Codex Desktop 和 CLI 的额度是分开的吗?
不是。在同一个 Codex home 下它们登录同一个账号、共用一组窗口。不同的 home 才分开。
重置次数是什么?
服务上报的、还剩几次可用的重置。Agent HUD 按原样显示这个数字,而不是从旁边那份到期清单反推。
上下文快满了但额度还没满,该看哪个?
两回事。上下文说的是这次对话有多满,压缩就能清掉;使用额度是你套餐的配额,只有重置才会清。
人不在 Mac 前面能看吗?
用 Agent HUD Remote,它把一台 Mac 的用量同步到免费的 iPhone、小组件与 Apple Watch 应用。

指南

最近更新: 2026-09-20 · 这里描述的行为,在 Agent HUD Open 的文档里有完整说明,并附有对应代码。 github.com/jazzenchen/agent-hud-open