Codex Usage Bar

一款原生 macOS 菜单栏应用，用紧凑的双行数字显示 Codex 短周期与长周期剩余额度。点击菜单栏状态项即可查看预计重置时间、刷新状态和提醒设置，无需反复打开 Codex。

项目主页：github.com/yf-official/Codex-Usage-Bar

功能

• 28 pt 紧凑菜单栏状态项，上下两行显示短周期和长周期剩余额度，文字按字形边界居中
• 自动适配额度窗口：仅返回一个周期时切换为单行，无可用数据时显示 —
• Codex 桌面应用未运行时显示“Codex 未打开”，启动后自动恢复
• 点击菜单栏查看剩余额度、预计重置时间和数据更新时间
• 短周期与长周期分别设置提醒开关及 1–100% 阈值
• 用户可选择 1、2、5 或 10 分钟刷新间隔，电源状态不会覆盖设置
• 可调整大小的原生窗口，支持浅色、深色及“减少动态效果”设置
• 关闭窗口后继续在菜单栏运行，可从应用菜单或面板正常退出
• Dock 仅显示应用图标，也可在设置中隐藏
• 手动启动，不注册登录项或开机自启

系统要求

• 配备 Apple Silicon（M 系列芯片）的 Mac
• macOS 14 或更高版本
• 已安装并登录 Codex、ChatGPT macOS 应用或 Codex CLI
• 可读取 Codex 用量的 ChatGPT 账户

安装

从项目的 Releases 页面下载最新版本，解压后将 Codex Usage Bar.app 移到“应用程序”文件夹。

当前源码构建产物使用本地签名。自行分发时，请使用 Apple Developer ID 重新签名并完成公证。

使用

启动应用后，菜单栏会显示当前可用的额度窗口：

• 两个窗口可用：上方显示短周期，下方显示长周期
• 仅一个窗口可用：居中显示该周期额度
• 暂无额度窗口：显示 —，后续刷新成功后自动恢复

点击菜单栏状态项可打开详情面板。关闭独立窗口不会退出应用；使用 ⌘Q、应用菜单中的“退出”或面板底部的“退出”可以结束程序。按住 ⌘ 拖动菜单栏状态项，可以调整它在菜单栏中的位置。

额度提醒

短周期和长周期提醒相互独立。剩余额度小于或等于设定阈值时，应用会发送一次系统通知；同一周期和阈值不会重复提醒。额度窗口暂时缺失时，对应设置会保留，也不会误发通知。

通知权限只会在用户主动开启提醒时申请。通知是否展示还会受到 macOS 通知设置和专注模式影响。

数据与隐私

应用通过本机 Codex 运行时读取额度信息，认证和凭据刷新由 Codex 负责。

• 不读取或保存密码、访问令牌及浏览器 Cookie
• 不创建 Codex 对话，不发送模型任务
• 不上传遥测或使用数据
• 本地仅保存应用偏好、最近一次额度缓存和提醒去重记录
• 缓存不保存账户标识
• 不申请辅助功能、屏幕录制或键盘监听权限

服务器返回的是已用百分比，应用换算后显示剩余百分比。缺失值保持未知状态，不会推断为 0%、100% 或无限额度。预计重置时间到达后，应用会等待下一次成功读取，不会自行假定额度已经恢复。

从源码构建

需要 Xcode 或 Command Line Tools，以及 Swift 6.0 或更高版本。

git clone https://github.com/yf-official/Codex-Usage-Bar.git
cd Codex-Usage-Bar
swift test
./Scripts/build.sh
./Scripts/run.sh

构建结果位于 dist/CodexUsageBar-macOS-arm64.zip，仅包含 Apple Silicon（arm64）版本。

项目没有第三方包依赖。核心结构如下：

Codex-Usage-Bar/
├── Package.swift
├── Resources/              应用元数据
├── Scripts/                构建与运行脚本
├── Sources/UsageCore/      额度模型、刷新策略和 Codex 通信
├── Sources/CodexUsageBar/  菜单栏、窗口、设置与通知
├── Tests/UsageCoreTests/   核心逻辑测试
├── docs/previews/          界面预览
└── logo.png                应用图标源文件

常见问题

应用提示未找到 Codex

请先安装并登录 Codex、ChatGPT macOS 应用或 Codex CLI。应用兼容新版桌面应用内嵌的 CodexCLI.app 和旧版运行时位置，也可以在设置中手动选择 codex 可执行文件。

菜单栏只显示一个百分比

当前账户只返回了一个额度窗口。应用会隐藏缺失周期，并在它重新出现时自动恢复双行显示。

为什么显示“Codex 未打开”

应用正在使用 Codex 或 ChatGPT 桌面应用内置的运行时，但对应应用尚未启动。打开 Codex 后会自动读取额度；手动选择独立 Codex CLI 时不需要桌面应用常驻。

预计重置时间已到，但额度没有变化

请等待下一次成功刷新。应用只展示服务器返回的结果，不会预测重置后的额度。

打开时提示无法验证开发者

从源码构建的版本使用本地签名。面向其他用户发布时需要 Apple Developer ID 签名和公证。

开发

欢迎通过 Issues 报告问题，或通过 Pull Requests 提交改进。

Codex Usage Bar 是独立项目，与 OpenAI 没有隶属或背书关系。Codex、ChatGPT 和 OpenAI 是其各自权利人的商标。