把 Codex 的剩余额度放到 Windows 侧栏里

把 Codex 的剩余额度放到 Windows 侧栏里

平时用 Codex 写代码时,我经常想确认一下额度还剩多少。但每次都要点开才能看,用得多了就觉得不太方便。我想把额度直接放到侧栏里,随时能看到。

于是在 GitHub 上找到了 Codex Usage Card。它把剩余额度做成了小圆环,放在 Codex 的左侧导航栏,显示效果正好符合我的想法。不过,当时公开发布的版本只支持 macOS,我用的是 Windows,于是打算在它的基础上做一次二开。

改到一半,又发现原项目的 PR #1 里已经有 SimonTan95 做的 Windows 适配。后面就沿用这份实现继续修改,处理了本机启动时遇到的问题,把原来的圆环效果在 Windows 上跑通了。

现在的效果

整理后的项目叫 Codex Usage Card Windows,主要作用就是在 Codex 侧栏显示账号的剩余额度。

Windows 实测截图:5 小时额度剩余 64%,每周额度剩余 28%

这是我在 Windows 上实际运行后的截图。上面的圆环显示 5 小时额度,下面显示每周额度,截图时分别剩余 64% 和 28%。数值会根据账号的实际额度更新。

它保留了原项目的显示样式,圆环占用的空间很小,放在侧栏里也比较自然。鼠标悬停时可以查看重置时间等详情,平时看一眼百分比,就能知道大概还剩多少额度。

  • 在侧栏直接查看 5 小时和每周剩余额度,具体显示取决于账号提供的数据。
  • 保留原版圆环、配色、提示框和深浅主题适配。
  • 从本地 Codex CLI 获取额度,并自动刷新显示。
  • 提供启动、状态检查和停止入口,不修改 Codex 安装包。

目前使用的是 Microsoft Store 版 Codex,需要 Node.js 24 或更新版本。启动前先完全退出 Codex,再通过项目里的 Start.cmd 打开即可。

我把这次整理的 Windows 运行代码、实测图片和中英文 README 都放到了 GitHub,保留了原项目与 Windows 移植作者的来源说明和 MIT 许可证。

项目地址:zssz666/codex-usage-card-windows

← 返回文章列表