Codex 用量监控：一个 Windows 桌面版 Codex 的任务栏常驻小工具

GitHub 仓库：DiMY-CN/CodexQuotaMonitor
当前推荐版本：C# WPF 原生版
适用场景：Windows 桌面版 Codex

为什么做这个工具

日常使用 Windows 桌面版 Codex 时，经常需要知道当前账号的短周期额度和一周额度还剩多少。官方界面可以看到一些状态，但如果频繁在多个窗口、多个任务之间切换，还是希望有一个轻量的常驻浮窗，直接贴在任务栏附近显示当前剩余额度。

于是做了这个小工具：Codex 用量监控。它会常驻在 Windows 任务栏左侧，以一个很小的无边框浮窗显示当前 Codex 额度状态。

项目主要为个人自用，开发过程由 OpenAI Codex 协助完成。它不是 OpenAI 官方项目。

界面效果

浮窗默认约 260x48，分为三个区域：

• 5H：Codex 返回的短周期额度窗口，圆环中显示剩余额度百分比，下方显示距离重置的大致时间。
• WK：Codex 返回的一周额度窗口，同样显示剩余额度百分比和重置倒计时。
• REF：刷新状态区，显示 上次成功刷新时间 / 当前时间。正常状态下只显示时间；读取中、等待首次读数、旧数据或错误时，会显示 SYNC、WAIT、OLD、ERR 或 STALE。

右键菜单提供手动刷新、重新贴靠任务栏、刷新间隔调整和退出：

主要功能

• Windows 原生 WPF 浮窗。
• 默认贴靠任务栏左侧，窗口置顶且不显示在任务栏按钮区。
• 显示 5H 和 WK 两个额度窗口的剩余百分比。
• 用 REF 显示最近一次成功刷新时间和当前时间。
• 支持托盘图标和右键菜单。
• 支持手动刷新和调整 quota 刷新间隔。
• 支持单实例，重复启动时不会生成多个浮窗。
• 运行日志保存在本地，不主动上传数据。

下载和运行

仓库地址：

https://github.com/DiMY-CN/CodexQuotaMonitor

建议从 GitHub Releases 下载原生 WPF 版的压缩包。解压后运行：

CodexQuotaMonitor.Wpf.exe

如果从源码运行，可以在 native-wpf 分支根目录执行：

Start-CodexQuotaMonitorNative.cmd

诊断命令：

Start-CodexQuotaMonitorNative.cmd --check --no-tray

单次读取命令：

Start-CodexQuotaMonitorNative.cmd --once --no-tray

运行要求

• Windows 系统。
• 已安装 .NET 8 Desktop Runtime，或者安装 .NET 8 SDK。
• Windows 桌面版 Codex 已安装，并且本机能够找到 codex.exe。

如果自动查找失败，可以用参数显式指定：

CodexQuotaMonitor.Wpf.exe --codex-exe "C:\Path\To\codex.exe"

查询原理

额度查询依赖本机 Codex 程序。工具会启动：

codex.exe app-server --listen stdio://

然后通过 JSON-RPC 调用：

account/rateLimits/read

程序会读取返回结果里的 primary 和 secondary 两组额度窗口，并换算成剩余百分比显示在浮窗里。

REF 不读取额外的 Codex 数据。它只显示本组件最近一次成功完成额度读取的本地时间，以及当前系统时间，用来判断浮窗是否仍在正常刷新。

风险和限制

这个工具不是 OpenAI 官方项目，也不是官方额度接口。需要注意：

• codex.exe app-server 的接口和字段可能随着 Codex 更新而变化。
• 额度读取依赖本机 Codex 登录状态。账号切换、登录失效或网络问题都可能导致读取失败。
• REF 使用本机系统时间；如果系统时间不准，显示也会不准。
• 程序运行日志可能包含本机路径或错误信息，不建议公开自己的 logs/ 或 settings.json。
• 读数适合日常参考，不适合当作严格计费、审计或服务端状态依据。

关于 Python/Tk 版本

仓库中还保留了 python-tk 分支。它是较早的 Python/Tk 实现，优点是源码更容易阅读和修改；缺点是需要用户自己准备 Python 环境，不如 WPF 版本适合日常常驻。

日常使用我更推荐原生 WPF 版。

维护说明

本项目主要为个人自用。除严重或破坏性 bug 外，不承诺后续维护、兼容性支持或功能请求响应。