如何不登录监控 Codex 与 Claude 的用量费用?一份 CodexBar 上手指南
【免费下载链接】CodexBarShow usage stats for OpenAI Codex and Claude Code, without having to login.项目地址: https://gitcode.com/GitHub_Trending/co/CodexBar
CodexBar 是一款开源 macOS 菜单栏应用,专为使用 OpenAI Codex、Claude Code 等 AI 编程工具的开发者设计。无需登录,它就能把各家服务的用量、成本与重置时间实时显示在菜单栏,让你不用打开网页、不用输入密码,也能随时知道还剩多少额度。这篇文章从真实痛点讲起,带你一步步完成安装、配置和进阶自动化。
那个"任务做到一半"的瞬间
想象一个常见场景:你正让 Codex 重构一个模块,改到一半,终端突然弹出额度耗尽的提示——5 小时窗口用完了。你只能停下手里的事,打开浏览器,登录账户,翻找配额页面,确认到底什么时候重置,再决定是干等还是换工具。
如果你同时用 Codex 和 Claude,还得在两个网页之间来回切换;要是团队有人共用账户,连"额度到底被谁用掉的"都说不清楚。
这正是 CodexBar 想解决的痛点:把分散在多个平台、藏在登录页后面的用量数据,统一搬到菜单栏上,让你一抬眼就有答案。
一句话概括:每个 AI 编程服务的限额,都放在你的菜单栏里。
它做的其实是减法
先澄清一个误解:CodexBar 不是又一个"用量统计网页",而是一个极简的菜单栏应用。它没有 Dock 图标,不抢注意力,只在菜单栏占一小块地方,把每个已启用服务的用量画成微型计量条。
支持的服务覆盖了主流 AI 编程工具——OpenAI Codex、Claude、Cursor、Gemini、Copilot、Grok、OpenRouter、LiteLLM、AWS Bedrock、Vertex AI 等,目前已有 69 个提供商,还在持续新增。每个服务都能独立开关,你只启用真正在用的。
| 它能显示什么 | 具体含义 |
|---|---|
| 会话用量 | 当前会话窗口消耗了多少 token |
| 周度/月度窗口 | 距离下次重置还剩多久,带倒计时 |
| 额度与余额 | 订阅 credits、API 余额、充值包剩余 |
| 费用统计 | 按日/周/月的 token 成本与消费趋势 |
| 服务状态 | 提供商故障时菜单栏出现告警标记 |
对比一下"没有它"和"有了它"的差别:以前是登录 → 翻页 → 心算;现在是点开菜单栏图标,一行字给出答案。
五分钟配置:从安装到看到第一格用量
安装只需一条命令(需要 macOS 14 及以上):
brew install --cask codexbar装好后菜单栏会出现 CodexBar 图标。首次配置分两步走:
- 打开 Settings → Providers,把你在用的服务开关打开;
- 为每个服务选择接入方式——大多数字段保持 "auto" 即可。
所谓"不登录",指的是它不会要求你新建账号或保存密码,而是复用你已有的会话。根据服务不同,CodexBar 会优先走这些来源:本机已登录的 CLI(比如 codex、claude)、浏览器 cookie、OAuth 授权、API key,或直接读取本地应用文件。换句话说,你本来就已经登录了,它只是"借用"一下。
API key 也可以不打开界面,直接用命令行写入配置文件(新装默认位置是~/.config/codexbar/config.json):
codexbar config enable --provider grok printf '%s' "$ELEVENLABS_API_KEY" | codexbar config set-api-key --provider elevenlabs --stdin配置完成后,菜单栏图标会开始显示用量。你还能在设置里调整展示方式:每个服务一个图标,或者合并成一个图标配一个切换器(Merge Icons 模式),菜单栏再挤也不怕。
菜单栏里到底能看什么
日常使用中,你会高频接触到这几类信息:
- 用量计量条:菜单栏图标本身就是微型用量计,消耗越多条越满;
- 重置倒计时:会话、周、月三种窗口各剩多少时间,一眼判断"现在开长任务会不会撞上限";
- 配额告警:用量接近阈值时提前提醒,避免超额;
- 费用图表:点开菜单就能看近期成本趋势,不用再手动翻账单。
对重度用户,还有几个值得一试的功能:
- WidgetKit 小组件:把用量放到桌面或通知中心,连菜单栏都不用点;
- 多账户支持:Claude 多账户时可以在菜单里直接切换,分别查看每个账户的用量;
- 21 种语言:界面共享同一套本地化目录,自动跟随系统语言。
进阶玩法:把"盯额度"交给脚本
菜单栏适合人看,脚本更适合机器看。CodexBar 自带一个轻量 CLI(codexbar),和菜单栏共用同一套数据源,非常适合写进脚本、CI 或内部仪表盘。
常用命令就几条:
codexbar usage # 查看全部已启用服务的用量 codexbar usage --json # 输出 JSON,方便程序解析 codexbar cost # 查看 Codex / Claude 的本地成本估算 codexbar cards # 终端里渲染一屏用量卡片 codexbar serve # 起一个本地 HTTP 服务,供其他程序读取 JSON如果想让系统"主动"通知你,可以配置事件钩子(Hooks)。比如用量越过 90% 时自动执行一个脚本,或额度耗尽时弹出提醒。事件类型包括quota_low、quota_reached、quota_reset、provider_unavailable等,每条规则都能单独开关。钩子脚本以直接执行的方式运行,不经过 shell,也拿不到你的密钥——只收到事件相关的环境变量和 JSON 数据。
{ "hooks": { "enabled": true, "events": [ { "id": "quota-alert", "event": "quota_low", "provider": "codex", "threshold": 0.9, "executable": "/usr/local/bin/quota-alert" } ] } }这套组合很适合团队场景:管理员把codexbar serve跑在一台机器上,让内部面板定时拉取 JSON,就能统一监控多个账户的用量与花费,成本分摊也有了数据依据。
隐私问题:它到底"看"了什么
"不登录"的另一面,是大家最关心的问题:它会不会扫描我的磁盘、上传我的数据?
CodexBar 的设计原则是本地解析、按需读取:
- 默认的自适应刷新模式不检查任何本地代理活动;
- 只有当你启用特定功能时,它才读取一小批已知位置的文件(浏览器 cookie、提供商配置文件、本地 JSONL 日志);
- 浏览器 cookie 是可选项,不开也能用 API key、OAuth 或 CLI 来源;
- 不保存任何密码,密钥写进配置文件时权限设为 0600(仅当前用户可读)。
macOS 偶尔会弹出钥匙串访问或"完全磁盘访问"的授权请求,原因也解释得清楚:读取 Safari 的 cookie 需要完全磁盘访问(可选,改用 Chrome 或其他来源就不需要授权);导入 Chromium cookie 需要访问浏览器的 Safe Storage 钥匙串条目。这些请求只在用户主动触发时出现,后台路径只会跳过,不会偷偷要权限。
该不该用:按你的情况对号入座
如果你的工作流符合下面任意一条,CodexBar 大概率值得装:
| 你的情况 | CodexBar 的价值 |
|---|---|
| 重度使用 Codex / Claude,常被限额打断 | 提前看到剩余额度与重置时间,规划长任务 |
| 同时用多个 AI 编程服务 | 一个菜单栏聚合所有用量,不用来回登录 |
| 需要控制 AI 花费 | 成本图表 + 配额告警,防止意外超支 |
| 团队共用账户或统一管理 | CLI 输出 + serve 接口,可接入内部仪表盘 |
| 在意隐私 | 本地解析、复用现有会话、不存密码 |
反过来,如果你只是偶尔用一次 AI 编程工具,或者只用单一服务且从不关心配额,那这个工具对你就是可有可无——它解决的是"频繁被限额打断"的问题,而不只是"看看统计"。
下一步:装一个,把第一个服务打开
回到开头的场景:任务做到一半被限额打断,其实可以避免。装好 CodexBar、在设置里打开你常用的服务之后,下一次开工前瞄一眼菜单栏,你就知道"现在开始这个长任务,会不会撞上重置"。
一行命令,五分钟配置,之后它就安静地待在菜单栏里。想深入了解配置格式,可以翻看项目里的 docs/configuration.md 和 docs/cli.md;想从源码构建或参与贡献,也可以直接克隆仓库自己编译。
现在就试试:brew install --cask codexbar,然后打开 Settings → Providers,启用你正在用的第一个服务。🚀
【免费下载链接】CodexBarShow usage stats for OpenAI Codex and Claude Code, without having to login.项目地址: https://gitcode.com/GitHub_Trending/co/CodexBar
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考