Codex Quota Overlay

这是什么？

Codex Quota Overlay 是一款开源免费的桌面悬浮层工具，由独立开发者 cpys 维护，在 GitHub 上以 MIT 协议开源。它的功能非常聚焦：在 Codex Desktop（OpenAI 的桌面编程客户端）当前会话标题旁边，用一行小字实时显示剩余额度、下次重置时间和可用的重置额度（Reset Credits）。当 Codex 不在前台时，悬浮层会立即隐藏，不占用任何注意力。

需要说明的是，这是一个独立的社区项目，与 OpenAI 没有隶属或官方支持关系。项目 2026 年 8 月首次发布，迭代很快，一周内连发 v0.1.0 到 v0.3.0 三个版本，并配齐了 CI 自动构建、CodeQL 代码安全扫描、SHA256 校验文件和完整的隐私文档，工程规范相当认真。在 OpenAI Codex 官方仓库的社区讨论区也能看到对这个工具的介绍帖。

核心功能与亮点

• 配额一行显示：剩余额度、下次重置时间直接显示在会话标题旁，不用再点开账户菜单一层层找，写代码时余光一扫就知道还能跑多少任务。
• 重置额度（Reset Credits）可视化：如果你的订阅方案带重置卡，悬浮层会同时显示可用数量和各自的到期时间，避免攒着攒着过期浪费。
• 智能显隐，零打扰：只在 Codex Desktop 处于活跃状态时出现，切到别的应用、最小化或退出 Codex 时立即消失；悬浮层永不抢焦点，鼠标点击可以直接穿透到 Codex 窗口。
• 隐私优先的取数方式：只调用 Codex 官方文档公开的本地 App Server 接口（account/rateLimits/read）读取额度数据。不截屏、不读取会话标题和浏览器 Cookie、不消耗重置额度；额度数据只存在本地内存中，v0.2.0 起不再写任何运行日志。
• 细节打磨到位：支持高 DPI 屏幕、多显示器、单实例防重复启动、开机自启；悬浮窗位置可以按 2px/4px 微调；Windows 常驻通知区，macOS 常驻菜单栏（不占 Dock 位）。
• 短诊断码：遇到问题用「复制短诊断」生成不超过 200 字符的诊断码（如 E01 表示找不到 Codex CLI），码中不含用户名、路径、IP、token 等任何敏感信息，方便反馈问题。

谁适合用？使用场景

目标用户：订阅了 ChatGPT Plus/Pro 并在桌面端重度使用 Codex 的开发者，尤其是对「额度还剩多少」有焦虑的用户。

1. 额度焦虑场景：写着代码总忍不住点开账户菜单看剩余额度 → 悬浮层常驻一行显示，随时可见，不打断心流。
2. 重置卡管理场景：Plus/Pro 方案附赠的重置卡不知道还剩几张、什么时候过期 → 悬浮层直接列出到期时间，该用就用，不白白过期。
3. 多任务切屏场景：一边写文档、查浏览器，一边挂着 Codex 跑任务 → Codex 不在前台时悬浮层自动隐藏，回到 Codex 立刻出现，屏幕永远干净。

上手难度与体验

语言支持：应用界面为英文，项目提供完整的简体中文文档（README 中英双语）。
技术门槛：开发者向工具，会用 Codex Desktop 就会用它。
上手时间：约 5 分钟（下载安装包 → 安装 → 运行 → 自动显示）。
平台支持：Windows 10/11 x64（已在物理机验证，提供安装版 EXE 和便携版 ZIP）；macOS 12+（Intel 和 Apple Silicon 双架构 DMG，自动化构建已验证，真机验收仍在进行）。Linux 暂无官方 Codex Desktop 客户端，因此不提供 Linux 包。

安装注意事项：安装包没有商业代码签名，macOS 版未经 Apple 公证，首次打开需要在访达中右键选择「打开」；建议下载后用仓库提供的 SHA256SUMS 文件校验完整性。遇到 E01 诊断码时，在菜单里手动选择本地 codex 可执行文件路径即可。

定价方案

• 完全免费：MIT 协议开源，无付费版、无内购、无广告。可选的匿名每日心跳统计默认关闭，需要用户手动开启才会运行。

价格信息采集于 2026-08-20，以项目官方页面为准。

优缺点

✅ 功能聚焦，一个痛点做透，轻量不打扰
✅ 隐私设计认真：不截图、不读会话、数据不落盘、诊断码脱敏
✅ 工程规范完整：CI 双平台构建 + CodeQL + SHA256 校验 + 隐私/安全/路线图文档齐全
✅ MIT 开源，代码可自行审计，技术用户可放心
❌ 项目 2026 年 8 月刚发布，还非常小众，社区使用评价较少
❌ 安装包无商业代码签名，macOS 未公证，首次启动多一步右键确认
❌ 仅支持 ChatGPT 账户登录的 Codex（API-key 模式可能读不到配额数据）
❌ 依赖 Codex 本地接口，Codex 版本迭代快，极端情况下需要等项目跟进适配

同类工具对比

如果你对 Codex Quota Overlay 感兴趣，也可以看看这些 AI 编程相关工具：

• Codex：本工具的「宿主」——OpenAI 的编程智能体，悬浮层就是为它的桌面版服务的。
• Cursor：AI 代码编辑器的热门选择，自带订阅额度显示，适合想要一体化编辑器的用户。
• GitHub Copilot：资历最老的 AI 编程助手，深度集成 GitHub 生态。
• Windsurf Editor：Agent 能力突出的 AI 编辑器，与 Cursor 定位相近。

常见问题

Q：Codex Quota Overlay 免费吗？
A：完全免费，MIT 协议开源，可以直接从 GitHub Releases 下载使用。

Q：它安全吗？会读取我的代码或对话吗？
A：不会。它只读取 Codex 官方公开的本地额度接口，不截屏、不读会话标题和 Cookie，额度数据只存内存不落盘。源码公开，可自行审计。

Q：它和 OpenAI 是什么关系？
A：没有任何隶属关系。这是一个独立社区项目，OpenAI 既不背书也不支持它。

Q：为什么 macOS 首次打开提示「无法验证开发者」？
A：应用未经 Apple 公证（独立开源项目未购买开发者签名）。在访达中右键点击应用选「打开」并确认一次即可，之后正常启动。

Q：装了之后不显示额度，报 E01 怎么办？
A：E01 表示没找到 Codex CLI。在菜单中选「Codex CLI → 手动选择」，指定本地 codex 可执行文件即可。另外注意：只有用 ChatGPT 账户登录的 Codex 才能读到配额数据。