news 2026/8/20 19:11:16

如何不登录监控 Codex 与 Claude 的用量费用?一份 CodexBar 上手指南

作者头像

张小明

前端开发工程师

1.2k 24
文章封面图
如何不登录监控 Codex 与 Claude 的用量费用?一份 CodexBar 上手指南

如何不登录监控 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 图标。首次配置分两步走:

  1. 打开 Settings → Providers,把你在用的服务开关打开;
  2. 为每个服务选择接入方式——大多数字段保持 "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_lowquota_reachedquota_resetprovider_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),仅供参考

版权声明: 本文来自互联网用户投稿,该文观点仅代表作者本人,不代表本站立场。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如若内容造成侵权/违法违规/事实不符,请联系邮箱:809451989@qq.com进行投诉反馈,一经查实,立即删除!