别再反复点左下角了:Codex 剩余用量,现在可以常驻显示
你是否也有过这样的动作:
Codex 正在执行一个长任务,你突然有点不放心,于是把鼠标移到左下角,点开个人区域,再点进「剩余用量」,看看 5 小时额度还剩多少、周额度还能撑多久。
过一会儿,又点一次。
准备启动第二个 Agent 之前,再点一次。
这个动作并不难,但一天重复十几次,就像开车时总要低头翻菜单才能看油量——真正打断你的,不是那两次点击,而是那一点持续存在的不确定感:
这轮任务跑完,我还剩多少额度?
为什么我们会如此在意“剩余用量”
Codex 的消耗并不是简单的“一次对话扣一次”。
OpenAI 官方说明中提到,实际消耗会受到任务规模、代码库大小、运行时长和上下文长度等因素影响。简单脚本可能只用掉很小一部分额度,而大型代码库、长时间任务和持续保留大量上下文的会话,消耗会明显更高。
也就是说,同样是“发一条消息”,背后的成本可能完全不同。
于是,剩余用量就不再只是一个好看的数字,而会直接影响你的工作安排:
- 要不要现在启动一个长任务;
- 是否适合并行开启多个线程;
- 复杂任务要不要留到额度重置后;
- 临近周限额时,是否应该把简单工作切到更轻量的模型或工具。
这种需求并非个例。
在 OpenAI Codex 的 GitHub Issue 中,有用户反馈 VS Code 状态栏里的
Rate limits remaining 消失后,只能反复进入 Settings → Usage 查看,而且那个位置有时还不同步;用户特别提到,快速看到剩余额度有助于安排和协调使用。在另一条用量讨论里,也有人抱怨缺少接近限额前的明确提醒,直到任务突然无法继续,才发现周额度已经见底。大家真正想要的,其实很朴素:
别把“油量表”藏起来。
Codex Rate Monitor:把额度贴在 Codex 旁边
GitHub 上的开源项目 D1NOOO/codex-usage-monitor,做的就是这件事。
它是一款面向 Windows 10/11 的原生托盘小工具。运行后,可以把 Codex 的两组核心用量直接显示在窗口旁:
- 5 小时用量窗口;
- 7 天用量窗口;
- 剩余百分比或已用百分比;
- 每组额度的重置时间。

显示位置可以放在 Codex 左下角头像区域旁,也可以放在顶部标题栏中间。浮层支持鼠标穿透,不会抢焦点,也不会挡住 Codex 原本的按钮。
它平时安静地待在 Windows 通知区域,没有多余的主窗口,也不会弹出一个新的仪表盘要求你管理。
你依旧在用 Codex,只是终于不用再反复点开「剩余用量」。
它不只显示数字,也允许你把它调顺眼
项目提供了一个可实时预览的外观编辑器,可以调整:
- 字体、字号与整体缩放;
- 透明度、圆角和进度条长度;
- 背景、文字、5 小时额度、7 天额度、警告与危险状态的颜色;
- 浅色与深色预设;
- 简体中文、繁体中文与英文界面;
- 是否跟随 Windows 自动启动。
默认显示“剩余百分比”,也可以切换为“已用百分比”;精度可以选择整数或一位小数。
这些功能听起来不惊天动地,但它们很符合一个常驻小工具应有的分寸感:信息足够清楚,同时尽量不打扰。
它是怎么获取数据的?
这也是很多人最关心的问题。
Codex Rate Monitor 不会自己实现一套 OpenAI 登录,也不要求你填写 API Key。
它会在 Windows 上找到 Codex CLI 随 npm 包安装的原生
codex.exe,并传入 app-server 参数启动。对应的命令行写法是:然后通过本地进程的标准输入与标准输出发送请求:
返回数据中包含已用百分比、窗口时长和重置时间等字段。工具把主要窗口显示为 5 小时额度,把次要窗口显示为 7 天额度。
换句话说,它更像是 Codex 本地能力旁边的一块“外接仪表盘”:
登录、令牌刷新和与 OpenAI 的网络通信仍由 Codex 自己负责,监视器只读取用量结果并显示。
安全性怎么样?
我重点看了项目说明、安全策略和相关源码。按照当前版本的实现,它的安全边界相当克制。
它会做的事情:
- 在本机启动 Codex CLI 的原生
codex.exe子进程,并传入app-server参数;
- 通过重定向的标准输入/输出与该进程通信;
- 在内存中保留当前用量,供浮层显示;
- 在
settings.json中保存外观偏好;
- 如果你主动开启“随 Windows 启动”,写入当前用户的启动项。
它明确不会做的事情:
- 不打开、解析、复制、上传或打印
auth.json;
- 不保存访问令牌和账号标识;
- 不保存历史用量;
- 不写应用日志;
- 不包含遥测或分析代码;
- 不要求 OpenAI API Key;
- 不把用量数据发送到开发者控制的服务器。
从源码看,程序会定位 Codex CLI 随 npm 包安装的原生
codex.exe,再以 app-server 作为启动参数;在终端中与之对应的命令写法是 codex app-server。它读取额度的方法是 account/rateLimits/read;可持久化的配置集中在同目录下的 settings.json,可选开机启动项写在当前用户的 HKCU\Software\Microsoft\Windows\CurrentVersion\Run。项目本身采用 MIT 许可证,代码完全公开;本地构建使用 Windows/.NET Framework 4.8 自带的编译能力,不下载 NuGet 依赖。发布流程还会生成 SHA-256 校验文件和 GitHub 构建来源证明,GitHub Actions 中使用的官方 Action 也固定到了完整 commit SHA。
不过,“开源”不等于可以闭眼安装。这里仍有三个边界需要说清楚:
- 这是非官方社区项目,与 OpenAI 没有关联,也没有获得 OpenAI 背书。
- 当前 Release 可执行文件没有代码签名,Windows SmartScreen 可能提示“未知发布者”。
- 它依赖仍可能变化的本地
codex app-server协议,也依赖当前 Codex 桌面界面的位置;未来 Codex 更新后,可能需要项目同步适配。
因此,比较稳妥的安装原则是:
只从项目 GitHub Releases 页面下载,不接收网盘或群聊中的二次打包版本;有条件的话校验 SHA-256,或者直接从源码构建。
安装只需要 5 步
目前项目支持 Windows 10/11,需要 .NET Framework 4.8,以及能够运行
codex app-server 的 Codex CLI。项目当前测试的 CLI 版本为 0.134.0。安装步骤:
- 打开项目的 Releases 页面;
- 下载
CodexRateMonitor-VERSION-windows-x64.zip;
- 对照
SHA256SUMS.txt校验压缩包;
- 将完整文件夹解压到一个固定位置;
- 双击
CodexRateMonitor.exe。
它没有传统意义上的主窗口。启动后,请在 Windows 右下角通知区域寻找信息图标;第一次运行时,图标可能被收进
^ 展开菜单。如果想在 PowerShell 中校验文件,可以运行:
把输出值与 Release 同页提供的
SHA256SUMS.txt 对照即可。它适合谁?
如果你符合下面任意一种情况,这个小工具会比较有用:
- 经常在 Codex App 里跑长任务;
- 会同时开多个线程或 Agent;
- 总担心任务跑到一半撞上额度上限;
- 每天多次点开左下角查看剩余用量;
- 希望在启动复杂任务前快速判断额度是否充足;
- 在意隐私,希望工具只在本地工作。
反过来,如果你使用的是 macOS 或 Linux,当前版本并不适用;如果你只偶尔使用 Codex,也未必需要再常驻一个托盘程序。
一个很小,却很对症的工具
Codex Rate Monitor 没有试图重新定义用量统计,也不会承诺算出“你还能发多少条消息”。
它只是把 Codex 已经提供的 5 小时与 7 天额度数据,放到一个更合理、更容易看到的位置。
但很多好工具,本来就不是靠功能堆砌取胜。
它们只是发现了一个每天都会发生、每次只让人烦一点点的问题,然后把那一点点摩擦拿走。
如果你也已经形成了“左下角 → 剩余用量 → 关闭 → 过会儿再看”的肌肉记忆,不妨试试它。
项目地址:


