Codex 还剩多少，一眼就知道。
Windows 上的 Codex 额度胶囊 · Codex usage monitor for Windows
下载 · 开始使用 · 日常操作 · 反馈 · English
把剩余额度留在眼前，把注意力留给工作。余量贴合 Codex 侧栏，根据接口返回优先显示 5 小时剩余百分比，只有周窗口时显示本周剩余；悬停展开本周剩余、重置时间和重置机会，不必切换页面。
软件界面目前为中文，支持冰澜 / 暖雾 / 跟随系统三个主题。
v0.3.6 · Windows 10 / 11 x64 · 正式发布版本
| 安装版 · 推荐 | 便携版 |
|---|---|
| 下载安装器 | 下载 ZIP |
| 按提示安装后运行 | 解压后运行 codex-badge-tauri.exe |
无需 .NET。需要 WebView2 Runtime、已登录的 Codex Windows 桌面客户端和可用的 Codex CLI；安装器可引导下载 WebView2。程序尚未签名，首次运行可能出现 Windows 安全提示，请确认来自本仓库。
双额度进度条帮助区分短期与每周限额；有可用详情时，点击“查看”展开重置机会到期时间。开启置顶模式后，胶囊可在 Codex 最小化时继续显示。
展示由 v0.3.6 前端界面渲染，使用演示数据。
默认冰澜提供柔白玻璃和交互水纹；暖雾采用米色至淡蓝渐变；跟随系统自动适配 Windows 浅色与深色外观。滚动鼠标滚轮即可切换，菜单和弹窗也随主题变化。
冰澜主题的水纹跟随鼠标输入，静止后逐渐衰减；进度条外管保持稳定，内部保留轻微反光。
悬停 → 水纹交互 → 收起 · 循环演示 · 工作区背景为示意
- 安装或解压，运行余量。
- 打开已登录的 Codex，胶囊自动出现。
- 右键胶囊或托盘图标开启置顶模式；在**设置 ›**中选择开机启动、临期用卡或检查更新。
余量在后台运行时，会随 Codex 打开而显示、退出而收起；从托盘选择“退出”后，需要手动重新启动余量。
| 操作 | 效果 |
|---|---|
| 悬停胶囊 | 展开 5 小时、本周剩余和重置时间 |
| 点击“查看” | 查看重置机会的到期时间（有可用详情时显示） |
| 滚动鼠标滚轮 | 循环切换冰澜 / 暖雾 / 跟随系统；系统主题自动适配明暗 |
| 拖动胶囊 | 调整位置，普通模式和置顶模式分别记忆 |
| 右键胶囊或托盘 | 置顶模式、设置 ›、退出；设置内包含开机启动、临期用卡和检查更新 |
| 双击胶囊 | 恢复当前模式的默认位置 |
普通模式随 Codex 最小化隐藏；置顶模式可在 Codex 最小化时继续显示。Codex 退出后，两种模式都会收起。
没有看到胶囊？ 确认余量正在运行、ChatGPT/Codex 主窗口已经打开。普通模式下，客户端最小化时不会显示。v0.3.3 已适配新版 ChatGPT 的布局变化；胶囊位置不合适时可双击恢复默认位置。
显示 --%？ 确认 Codex 已登录，且 Codex CLI 可用。找不到 CLI 时，可将环境变量 CODEX_BADGE_CLI 设置为 codex.exe 的完整路径。
更新或移动便携版？ 先关闭开机启动，再退出正在运行的版本；运行新版本后按需重新开启。开机启动会记住程序所在路径。从 v0.2.x 升级需重新设置主题与位置。
临期用卡授权与软件更新说明
临期用卡默认关闭。明确授权当前账号后，电脑和 CodexBadge 运行期间，会在免费卡到期前 30 分钟内按官方条件自动尝试，包含今后获得的卡，直到关闭。无需打开 Codex 窗口；关机、休眠或退出后不执行，不保证兑换成功。
自动用卡成功后，已有额度不会与重置后的额度叠加，重置时间可能改变，成功无法撤销。请勿在多台设备或工具同时为同一账号开启。关闭阻止新请求，但已发送请求不能保证撤销；结果不明确时暂停并保留记录。
安装版支持主动检查和一键更新；便携版通过发布页下载 ZIP 手动替换。不会自动检查、下载或安装更新。更新签名不等于 Windows Authenticode 代码签名。
自动检查和用户日常测试不等于多机、混合 DPI 或完整安装升级验收。完整版本说明
通过本机 codex app-server 读取额度；仅在明确授权临期用卡后，按条件提交官方兑换请求。不读取 auth.json、不发送模型请求，不上传登录凭据。设置和诊断日志保存在本机 %LOCALAPPDATA%\CodexBadge。
发现问题？提交反馈，附上复现步骤、显示缩放和主题即可。截图或日志请先检查隐私，不要上传凭据。
第三方开源工具，非 OpenAI 官方产品。
English overview · 如果余量对你有帮助，欢迎给项目一个 Star。