Codex 额度用完不再干等：Hermes 新增 /usage reset 一键重置

对经常用 Codex 写代码的开发者来说，最让人抓狂的不是模型答错，而是额度突然用光，只能干等。尤其在长任务跑了一半、上下文已经堆起来的时候，被迫停下来去网页或 Codex CLI 里重置额度，非常打断心流。

Hermes Agent 最近合并了 PR #64280，新增 /usage reset 命令。现在你可以直接在 Hermes 里兑换 Codex 已积攒的 usage-limit 重置次数，不用切换工具，不用打开网页，一条命令续上。

这个新功能解决了什么

OpenAI 给 ChatGPT-plan 的 Codex 用户提供了 rate-limit reset credits（额度重置次数）。

这些次数本质上像是“续命药水”：当你触发了 5 小时或每周的额度上限后，可以用一次 banked credit 把额度直接回满。但以前这个兑换动作只能去：

  • Codex CLI 里操作
  • Codex 桌面 App
  • OpenAI 网页后台

对把 Hermes 当主入口的开发者来说，这意味着多一次工具切换，多一层上下文丢失。/usage reset 把这套流程直接接到 Hermes 里。

核心用法：三步续上额度

1. 更新 Hermes 到最新版

hermes update

2. 确认 ChatGPT 账号已登录

hermes auth

确保你用的是支持 Codex 的 ChatGPT-plan 账号。

3. 查看当前使用状态

/usage

如果你还有 banked resets，Hermes 现在会提示类似：

You have 2 resets banked - use /usage reset to activate

4. 重置额度

/usage reset

如果当前有某个窗口的额度已完全耗尽，系统会兑换一次 banked credit，恢复完整的 5 小时 + 每周额度。

hero

强制重置与常见保护机制

这个命令设计得比你想象的更谨慎。因为一次 banked reset 会把 整个 5 小时和每周额度全部回满，所以如果你在额度还没真正用完的时候就用了，会浪费这次珍贵的 credit。

因此 Hermes 默认会拒绝提前重置，并提示当前最忙的窗口还剩多少额度。你可以用 --force 跳过这个保护：

/usage reset --force

常见返回结果：

状态 含义
reset 成功兑换，额度已恢复
nothing_to_reset 没有窗口被完全耗尽，credit 未被消耗
no_credit 没有 banked resets 可用
already_redeemed 这个 credit 已经被兑换过（幂等 UUID 保护）
reset_wrong_provider 当前 provider 不是 openai-codex

为什么对码农特别实用

写代码的时候最怕两种中断：

  1. 思路被打断：正在排一个复杂逻辑，突然模型不动了。
  2. 上下文被打断：Codex 已经读了项目、跑过命令、生成过中间文件，一旦切换工具，前面的心流和状态都要重新建立。

/usage reset 把“重置额度”这种原本要跨工具完成的操作，收进了你本来就在用的聊天界面。对于以下几类场景尤其省心：

  • 长时间代码重构：任务已经跑了几百行，突然命中额度上限。
  • 多文件分析：Codex 已经加载了项目上下文，切换工具意味着要重新解释需求。
  • Cron 或后台任务：无人值守执行时，额度耗尽会导致整个任务失败，有了重置命令就多一条兜底路径。
  • 高频调试循环：反复调用 Codex 时更容易快速耗尽额度，手动重置能省很多等待时间。

技术实现要点

根据 PR #64280 的改动，/usage reset 的底层对接方式很清晰：

  • 复用 Hermes 里已有的三层 Codex 凭据解析逻辑。
  • 调用 OpenAI 的 /rate-limit-reset-credits/consume 端点，并生成 UUID 作为幂等 key，和官方 Codex 客户端行为一致。
  • 支持 PathStyle 差异（/wham vs /api/codex）和 ChatGPT-Account-Id header。
  • 在 CLI 和 Gateway 双端都可用，也就是说命令行和 Telegram/Discord 等消息平台都能用。
  • 所有 16 个语言 locale 都新增了对应的 i18n key，文档也同步更新到 cli.md 和 messaging 索引。

测试覆盖也很扎实：包括 unit tests、gateway 命令测试、i18n parity tests，以及用本地 fake Codex backend 做的真实 socket E2E 测试，验证了 hint 渲染、guard 拦截、--force 兑换、幂等 key 上送和 CLI 双入口。

劳模级团队的又一次日常更新

如果你持续关注 Hermes 的 commit 历史，会发现这个项目几乎每天都在迭代。这个 PR 两天前合并，而仓库里同时还有大量 4 小时、7 小时、19 小时前的提交。Nous Research 团队对 Hermes 的维护频率，说是“劳模级”一点也不夸张。

/usage reset 不是那种 flashy 的大功能，而是解决实际痛点的小而美的改进。对真正把 Hermes 当生产力工具的人来说，这种细节往往比炫技更重要。

干货提炼

  • /usage reset 让你在 Hermes 里直接兑换 Codex 的额度重置次数，无需跳去 Codex CLI 或网页。
  • 先运行 hermes update，确认 hermes auth 已登录，然后 /usage reset 即可。
  • 默认会保护你不浪费 credit：只有某个窗口完全耗尽时才会重置；--force 可覆盖。
  • 返回状态包括 reset、nothing_to_reset、no_credit、already_redeemed、reset_wrong_provider。
  • 同时支持 CLI 和 Gateway，即命令行和消息平台都能用。

参考：