一眼看清 Codex 本周还剩多少额度。
Codex Float 是一款原生 macOS 小工具。它把 Codex 本周剩余额度放在桌面悬浮窗中，需要更多信息时，点一下即可查看重置时间、当前套餐和重置机会。
- 额度一眼可见：菜单栏图标旁显示百分比；桌面悬浮胶囊同步展示本周剩余。
- 安静地待在桌面上：透明玻璃悬浮窗保持在桌面，也可以随时从菜单栏关闭。
- 需要时再展开：点击悬浮窗查看下次重置、当前套餐和可用重置机会。
- 自动保持更新：应用会自动刷新；数据过期或读取失败时会明确提示，不把旧数据伪装成最新状态。
- 常用操作集中在菜单栏：快速控制悬浮窗、开机自启、检查更新或退出应用。
- 前往 Releases，下载最新的
CodexFloat-*-macos-universal.zip。 - 解压后，将 Codex Float.app 拖入「应用程序」文件夹。
- 打开 Codex Float。应用会自动读取当前 Mac 上的 Codex 额度。
macos-universal.zip 是同时支持 Apple Silicon 和 Intel Mac 的统一安装包，无需区分处理器架构。
当前下载版本尚未经过 Apple 公证。请确认安装包来自本仓库的 Releases，然后：
- 先尝试打开一次 Codex Float.app。
- 打开「系统设置 → 隐私与安全性」。
- 向下滚动到「安全性」，点击 Codex Float 旁边的「仍要打开」。
- 在确认窗口中再次点击「打开」。
「仍要打开」通常只会在尝试启动应用后的一段时间内出现。详细说明可查看 Apple 官方指南。
- macOS 14 或更高版本
- Apple Silicon 或 Intel Mac
- 已安装并登录 Codex CLI
- 点击悬浮窗，展开额度详情。
- 点击详情右上角的收起按钮，返回紧凑悬浮窗（logo + 百分比）。
- 点击菜单栏中的 Codex Float 图标（含百分比），控制悬浮窗、开机自启、检查更新或退出应用。
首次启动时，菜单栏与悬浮窗默认都会显示。悬浮窗填充色：>50% 绿、>20%–50% 橙、≤20% 红。
- 额度通过这台 Mac 上已登录的 Codex CLI 获取。
- 登录凭证不会写入 Codex Float 的存储、日志或诊断信息。
- 重置机会的到期时间仅在需要时通过 ChatGPT 官方接口读取，相关登录信息只在请求期间保留于内存。
- 没有遥测，也不会向开发者发送额度或使用数据。
Codex Float 采用 MIT License 开源。问题和建议可以提交到 Issues，参与开发请先阅读 CONTRIBUTING.md。
Codex Float is not affiliated with OpenAI. Codex is a trademark of its respective owners.