跳转到内容
全部开发指南

AI 编程额度总不知道还剩多少?用 CodexBar 把用量和重置时间放进菜单栏

AIGoCode发布于 更新于

AI 编程额度总不知道还剩多少?用 CodexBar 把用量和重置时间放进菜单栏 封面

同时用好几个 AI 编程工具的人,大概都遇到过这种情况:任务跑到一半,突然提示额度用完,要等几个小时才能重置;或者想开一个大任务,却不知道这周的额度还够不够。每个工具的用量页面都藏在不同的网站和设置里,挨个去查很麻烦。

CodexBar(steipete/CodexBar,MIT 协议,GitHub 上超过 2 万 Star)就是为这个问题做的一个 macOS 菜单栏小工具。它把各家 AI 编程服务的额度和重置倒计时集中显示在菜单栏上,点开就能看到还剩多少、什么时候重置。

CodexBar 原文配图 1

CodexBar 能看到什么

按 README 的说法,CodexBar 想做的就是让 AI 编程服务的额度"一直看得见"。主要能力有这几项:

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

CodexBar 用量窗口 原文配图 2

安装

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 版可供参考。

第一次使用

装好打开之后:

  1. 打开 Settings → Providers,勾选你在用的服务;
  2. 按各服务的要求登录或提供数据来源,比如对应的命令行工具、浏览器登录状态、OAuth、API Key 或本地文件,不同服务用的方式不一样;
  3. 用 Codex 的话,还可以在 Settings → Providers → Codex 里开启 OpenAI cookies(自动或手动),在菜单里显示更多网页端控制台里的数据。

CodexBar 安装与配置流程 原文配图 3

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

CodexBar 支持的服务 原文配图 4

命令行和脚本

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 编程。

参考链接

AI 编程额度总不知道还剩多少?用 CodexBar 把用量和重置时间放进菜单栏