
同时用好几个 AI 编程工具的人,大概都遇到过这种情况:任务跑到一半,突然提示额度用完,要等几个小时才能重置;或者想开一个大任务,却不知道这周的额度还够不够。每个工具的用量页面都藏在不同的网站和设置里,挨个去查很麻烦。
CodexBar(steipete/CodexBar,MIT 协议,GitHub 上超过 2 万 Star)就是为这个问题做的一个 macOS 菜单栏小工具。它把各家 AI 编程服务的额度和重置倒计时集中显示在菜单栏上,点开就能看到还剩多少、什么时候重置。

CodexBar 能看到什么
按 README 的说法,CodexBar 想做的就是让 AI 编程服务的额度"一直看得见"。主要能力有这几项:
- 按服务分别显示额度和重置倒计时。每个服务的会话、每周、每月额度窗口都有进度条,并显示距离下次重置还有多久。开长任务之前看一眼,就知道够不够用。
- 余额、花费和成本统计。能显示余额,对支持的服务展示花费图表;对 Codex 和 Claude 还能扫描本地日志,估算用了多少钱。
- 服务状态提醒。它会轮询各家服务的状态页,出故障时在菜单里显示事故标记,菜单栏图标上也会叠加提示。这样遇到报错,可以先判断是服务本身出了问题,还是自己的配置有问题。
- 支持的服务很多。除了 Codex 和 Claude,还支持 OpenAI、Cursor、Gemini、Copilot、z.ai、MiniMax、Kimi、Zed、Vertex AI、OpenRouter 等,README 里写的是 111 个服务。

安装
CodexBar 需要 macOS 14(Sonoma)及以上。可以从 GitHub Releases 下载,也可以用 Homebrew 安装:
brew install --cask codexbar
Linux 用户也有选择:官方提供基于 Qt 6 的 Linux 桌面应用,支持 Wayland 和 X11;命令行版本可以用 Homebrew 的 brew install steipete/tap/codexbar 安装,Arch Linux 上有 AUR 包 codexbar-cli。Windows 没有官方版本,README 里列了社区做的 Windows 版可供参考。
第一次使用
装好打开之后:
- 打开 Settings → Providers,勾选你在用的服务;
- 按各服务的要求登录或提供数据来源,比如对应的命令行工具、浏览器登录状态、OAuth、API Key 或本地文件,不同服务用的方式不一样;
- 用 Codex 的话,还可以在 Settings → Providers → Codex 里开启 OpenAI cookies(自动或手动),在菜单里显示更多网页端控制台里的数据。

CodexBar 没有 Dock 图标,默认每个服务在菜单栏占一个图标。服务开得多、菜单栏挤不下时,可以打开 Merge Icons 模式,把所有服务合并成一个图标,点开后再切换查看。

命令行和脚本
CodexBar 自带命令行工具 codexbar,macOS 和 Linux 都能用,适合写脚本或在 CI 里查用量。比如统计 Codex 和 Claude 的本地成本:
codexbar cost --provider codex
codexbar cost --provider claude
codexbar cost --provider both
在设置界面里开关服务的操作,也可以用命令完成:
codexbar config providers
codexbar config enable --provider codex
codexbar config disable --provider cursor
配置文件默认在 ~/.config/codexbar/config.json,保存服务开关和 API Key 时会设置严格的文件权限。
隐私和权限
一个要读浏览器 cookie 和本地日志的工具,大家最关心的自然是隐私。CodexBar 在 README 里专门做了说明:
- 不扫描整个磁盘。它只在你开启相关功能时,读取几个已知位置:浏览器 cookie 和本地存储、各服务的配置文件、本地 JSONL 日志。
- 不保存密码。它复用你已经登录的会话(OAuth、设备授权、API Key、浏览器 cookie 等),默认在本机解析数据。读取浏览器 cookie 需要你主动开启。
- 完全磁盘访问权限是可选的。只有读取 Safari 的 cookie 时才需要;不授权的话,可以改用其他浏览器、手动填 cookie 或 API Key。
- 可以关闭钥匙串访问。在 Settings → Advanced → Disable Keychain access 里能禁止 CodexBar 自己的钥匙串操作。
适合谁用
- 同时订阅好几个 AI 编程服务,经常要判断"先用哪个"的人;
- 习惯开长任务,需要提前知道额度够不够、什么时候重置的人;
- 想在脚本或团队看板里统计 AI 编程成本的人,可以用它的命令行工具。
如果你在 AIGoCode 上使用 Claude Code、Codex 等工具,想核对某次任务到底用了多少额度,可以参考 AIGoCode 额度消耗比预期快:如何核对一次任务的用量;想排查 Claude Code 额度为什么消耗快,可以看 Claude Code 配额为什么消耗这么快?
还没开始用的话,可以在 AIGoCode 接入 Claude Code 和 Codex,开始你的 AI 编程。
参考链接
- CodexBar GitHub:https://github.com/steipete/CodexBar
- CodexBar 官网:https://codexbar.app