CodexBar：把 AI 编码额度挂进 macOS 菜单栏

用 Codex、Claude Code、Cursor 这类工具写代码，额度是最容易被忽略又最容易踩到的东西。同一份订阅里塞着五小时窗口、每周额度、每月额度，重置时间各不一样。想知道还剩多少，通常得挨个打开网页后台翻一遍，多数人干脆不看，直到任务跑到一半被限流。

CodexBar 是一款用 Swift 写的 macOS 14+ 菜单栏应用，读取你已有的 AI 编码服务会话，把额度与重置倒计时直接显示在菜单栏上。

它不需要你重新登录任何服务，也不保存密码。数据来源是你机器上本来就有的 OAuth 令牌、设备码流程、API key、浏览器 cookie 或本地应用文件。同一个仓库里还带了 Linux 桌面版和一套命令行工具，菜单栏应用只是其中一个入口。

仓库地址是 https://github.com/steipete/CodexBar，许可证为 MIT，主要语言 Swift，占代码量 89.1%。事实表抓取时 Star 21966、Fork 2014、开放 Issue 150。

第一次用它需要知道的事

装之前先确认这几件事，能省掉一轮排查。

• 平台门槛：macOS 应用要求 macOS 14+（Sonoma）。Linux 桌面版是 Qt 6 应用，已发布的归档面向 x86_64 和 ARM64，要求 glibc 2.39+、Qt 6.4+，并且需要单独安装 CodexBar CLI。仓库没有说明 Windows 支持。
• 凭据得先有：应用不提供登录入口，它读的是你已经存在的会话。用 Codex 得先登录过 Codex CLI 或 OAuth，用 Cursor 得浏览器里有登录态，用 API key 类型的 provider 得先把 key 准备好。
• 钥匙串权限：macOS 上它会请求访问钥匙串条目，例如 Chrome Safe storage，用来读浏览器 cookie。这是它设计的正常路径，但你会看到系统弹窗。
• 安装方式：普通用户走 Homebrew 或 Release 包，别从源码编译。仓库体积 208677 KB，Swift 占 89.1%，自己构建要装完整 Swift 工具链。
• 需要联网：额度数据来自各家接口，断网就只能看上次的值。CLI 的 config 子命令是本地读写配置文件，不联网也能用。

最短上手路径

1. 安装 macOS 应用：终端执行 brew install --cask codexbar，或从 GitHub Releases 下载对应版本。
2. 打开 Settings → Providers，把你实际在用的 provider 逐个启用。
3. 补齐凭据：在该 provider 的 CLI 里登录，或者准备好浏览器登录态、API key。
4. 用一条命令确认配置内容：codexbar config providers。
5. 回到菜单栏看结果，图标和点开后的下拉面板就是最终输出。

它实际上能做哪些事

额度与重置追踪

• 每个启用的 provider 在菜单栏占一个状态项，显示 session、weekly、monthly 窗口的用量和下一次重置的倒计时。README 对多数 provider 用的是 where available，拿不到细分窗口时只显示能拿到的部分。
• Merge Icons 模式把多个 provider 叠进一个菜单栏图标，配一个 provider 切换器，避免图标排成长队。
• 服务状态轮询：上游出故障时菜单里出现 incident 徽标，图标上叠加一个指示。

花费、余额与成本

• 额度余额、Admin API 花费面板、provider 账单摘要，以及来源暴露足够细节时的本地成本扫描。
• Codex 可以额外填 OpenAI cookie（Automatic 或 Manual），用来补齐网页后台才有的数据。
• 不少 provider 支持多账号并存：Kimi 可以保存网页会话并选 China 或 International 区域，Doubao Ark 可以存 API key。

CLI 与 Linux 端

• CLI 以 tarball 分发，macOS 有 arm64 与 x86_64，Linux 有 glibc 与静态 musl 两套，另有 Homebrew formula 和 Arch 的 codexbar-cli AUR 包。
• Linux 桌面版带用量与花费窗口、独立设置、桌面通知和可选托盘图标；Omarchy 上有原生 bar widget，共享桌面版数据并跟随主题。GNOME 可能需要装托盘扩展，应用窗口本身不依赖托盘。
• Linux 与 macOS 的功能差距写在 Integrations/Linux/MAC_COMPARISON.md 里，细节以那份文档为准。

参数速查

provider 开关和 API key 都存在解析后的配置文件里。新安装用 ~/.config/codexbar/config.json，老安装的 ~/.codexbar/config.json 仍然会被加载。Settings → Providers 里那份清单可以用命令脚本化：

codexbar config providers
codexbar config enable --provider grok
codexbar config disable --provider cursor

存 API key 不必打开设置界面：

printf '%s' "$ELEVENLABS_API_KEY" | codexbar config set-api-key --provider elevenlabs --stdin

set-api-key 会去掉管道传入值两端的空白，以受限的文件权限写入配置，并默认启用该 provider。加 --no-enable 只保存 key 不启用；加 --api-key <key> 可以直接在命令行传值，适合一次性本地脚本，代价是 key 会进 shell 历史。

输出与结果位置

最直接的输出是菜单栏图标和点开后的下拉面板。v0.67.0 之后报告周期统一成一套模型，日历月至今和全部可用历史可以在菜单、Usage & Spend、CLI、HTTP cost 输出和 widget 里选，滚动窗口和固定的成本时区会保留。同一版本还加了偏好设置的导出与导入。

Linux 端的结果在桌面应用的用量与花费窗口里，配合桌面通知。CLI 以 tarball 运行时输出在终端，也能给出 HTTP cost 结果。README 节选里没有列出查询额度数值的 CLI 子命令，想知道具体额度还是得看应用界面。

实际使用中的坑

Issue 区暴露的问题大多和资源占用、凭据读取有关，挑几个有代表性的。

• 钥匙串密码每隔几小时弹一次，即使每次都点了 Always Allow。这条有 32 条评论、35 个 reaction，已解决。
• 0.46.0 的主进程在正常使用中内存持续增长，超过 7 GiB 后需要每天退出重启，已解决。
• 0.32.x 期间出现过明显卡顿，鼠标从一个模型悬停到另一个时尤其严重，同时伴随下拉菜单无响应和界面冻结，已解决。
• v0.55.0 用满一整天后，token 与花费图表不再刷新，界面没有报错，点刷新显示 updated just now，但只有 session 和 weekly 用量会更新。这条到事实表抓取时仍然是待解决状态，有 24 条评论。
• 解析失败也出现过：Claude 用量报 Could not parse Claude usage. Missing Current session，或者提示 Claude OAuth credentials not found 但用户其实已登录，这些都已解决。

同类项目对比

覆盖面是 CodexBar 最难被替代的地方，80 多家 provider、CLI、Linux 端和 widget 都收在一个仓库里。代价是它比同类工具重：要读钥匙串、要跨多家接口轮询，历史上就出现过内存涨到 7 GiB 和反复弹钥匙串密码的问题。如果你只盯一家服务的额度，TokenEater 这类单一用途的原生应用更轻，出问题的面也更小，装它比装 CodexBar 划算。

合规边界

CodexBar 的工作方式是读取你自己账号在本机留下的凭据，包括钥匙串、浏览器 cookie、本地文件和 API key。使用范围限定为你本人拥有或已获明确授权的账号。拿它去查看别人的账号数据、或者用同事的 cookie 拉用量，都会踩到法律和平台规则的线。

浏览器 cookie 抓取这条路和部分服务的使用条款关系微妙，服务方可以随时改接口或改加密方式让这类读取失效。API key 以受限权限写进配置文件，但它终究是本地可读的明文文件，多用户机器上要注意目录权限。工具本身不做绕过鉴权或越权访问，风险全在你把谁的凭据喂给它。

什么时候值得用它

你的主力机器是 Mac，并且在用两家以上 AI 编码服务，CodexBar 省掉的重复登录和后台翻页最多。

你需要的不只是单个额度条，还想看花费、余额、账单摘要和服务故障状态，这个应用的覆盖面比多数同类工具宽。

你愿意接受一个会读钥匙串、会联网轮询的常驻菜单栏程序，也愿意在 Issue 彻底解决前偶尔手动重启它。