CodexBar 完全使用指南：免登录监控 OpenAI Codex 与 Claude Code 用量

CodexBar 完全使用指南：免登录监控 OpenAI Codex 与 Claude Code 用量

【免费下载链接】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 等 60 多个 AI 编码服务的配额、花费和重置时间集中挂在菜单栏上，全程复用你已有的登录态，不用为它重新登录任何平台。装好后，"额度还剩多少、几点重置"这类问题不用再切回网页找答案，扫一眼菜单栏就行。个人开发者用它盯账单，团队可以靠附带的 CLI 把配额和成本数据拉进脚本。

安装只需一条命令，首次配置跟着提示走

装完打开菜单栏就能看到

macOS 14 以上，一条命令装完：

brew install --cask codexbar

装完菜单栏会多一个小仪表图标。首次使用只做两件事：打开 Settings → Providers，勾选你在用的服务；然后确认对应来源已经登录——它会自动复用你机器上现成的 OAuth 会话、CLI 登录态、浏览器 cookie 或 API key，不存储任何密码，也不扫描你的文件系统，只读取功能明确需要的那几个位置（浏览器 cookie、provider 配置文件、本地 JSONL 日志）。不想走浏览器导入时，手动填 cookie 或 API key 也完全可以。

菜单卡片把每个 provider 的用量条和重置倒计时收在同一个弹层里

Linux 侧则是纯 CLI：brew install steipete/tap/codexbar或 AUR 的codexbar-cli，适合放进脚本和桌面插件。

装完第一眼看什么

CodexBar 目前接入的 provider 列表相当长：Codex、OpenAI、Claude、Cursor、Gemini、Copilot、Grok、OpenRouter、LiteLLM、AWS Bedrock、DeepSeek、Kimi、MiniMax、z.ai、Kiro、Zed、Vertex AI 等，每个服务都有自己的取数策略（OAuth、API key、浏览器会话或本地日志），全部在 docs/providers.md 里按家拆开写。

每个 provider 的卡片上你能看到三层信息：会话 / 周度 / 月度窗口的用量条，对应的重置倒计时，以及余额、支出和本地成本扫描。倒计时的价值在于排任务——比如 Codex 的 5 小时窗口快重置时，就知道该不该现在开一个长任务。另外它还会轮询各服务的状态页，出故障时图标会变暗或叠上故障标记；provider 多了之后可以开 Merge Icons 模式合并成一个状态项加切换器，避免占满菜单栏。

OpenAI、Claude Admin API 等 API 型 provider 支持内嵌成本图表，横轴按天展示花费

刷新策略默认是 Adaptive，也可以手动切成固定 1、2、5、15、30 分钟。

配置改在哪里：一个 JSON 文件加五类常用命令

配置文件的最小可用示例

新安装的配置文件在~/.config/codexbar/config.json（旧安装的~/.codexbar/config.json仍然有效），支持CODEXBAR_CONFIG环境变量改位置。最小结构长这样：

{ "version": 1, "providers": [ { "id": "codex", "enabled": true, "source": "auto" } ] }

所有字段（source 的取值、cookieSource、enterpriseHost、tokenAccounts 多账号等）都在 docs/configuration.md 里，数组顺序同时决定菜单和 CLI 里的显示顺序。手动改完记得先跑codexbar config validate再重载，文件权限会被自动保持为 0600，别提交进版本库。

CLI 最常用的五条命令

命令行工具与菜单栏共用同一套 provider 取数逻辑，完整参考在 docs/cli.md。日常真正会用到的就这几条：

codexbar usage # 查看所有已启用 provider 的用量 codexbar cost --provider both # 本地扫描 Codex + Claude 的 token 成本 codexbar config validate # 校验配置文件 codexbar cache clear # 清本地缓存（--cookies / --cost 可选） codexbar guard --provider codex --min-remaining 10 # 剩余低于 10% 时退出码非 0

guard这条是给自动化用的：退出码 0 表示安全，1 表示配额不足，69 表示查不到。把它放在脚本或 CI 的前置步骤，就能在额度见底时自动拦住批量任务。

用出进阶效果：预算、告警钩子和自动化导出

预算与告警阈值

两条进阶路径。一是 ClawRouter 路由集成：填上 API key（codexbar config set-api-key --provider clawrouter --stdin即可，key 走管道不落历史），菜单卡片会显示它的月度预算、本月花费、请求数、token 总量，以及按花费排序的前 5 个被路由供应商——路由优先级和预算都写在 ClawRouter 的策略里，CodexBar 只负责展示。

ClawRouter 卡片展示月度预算、花费与按供应商拆分的路由用量

另一条是事件钩子（Settings → Hooks）：quota_low事件支持给每条规则配 0~1 之间的阈值，越过时执行你指定的本地脚本；另有quota_reached、quota_reset、provider_unavailable/provider_recovered、refresh_failed等事件。命令以绝对路径直接执行、不经 shell，失败也不会阻塞后台刷新。配额快见底时自动发 Slack、写日志，全靠这一层。

把数据导进你自己的流水线

三个现成入口：

• codexbar usage --format json输出结构化用量，配合 cron 每天重定向到文件，就是一份自动归档的账单流水；
• codexbar serve起一个本地 HTTP 服务（默认 8080 端口、60 秒缓存），暴露/usage、/cost端点和内置 Web UI，适合喂给仪表盘或终端插件；
• codexbar dashboard一次性打印 dashboard-v1 JSON 快照，--pretty加--output <path>原子写文件，适合 CI 里直接归档。

Settings → Usage & Spend 视图对本地 7/30 天成本估算按原币分组展示

团队怎么管配额和成本

把codexbar cost --format json的输出按月存好，projects[]和daily[]字段能定位到具体项目每天的 token 成本，这就是最朴素的成本分摊和周报数据源。团队里用 ClawRouter 的统一 key 跑路由，菜单卡上的预算和按供应商拆分直接当分摊表用；配额侧则组合 guard 与 hooks：CI 里 guard 拦批量任务，本地 hooks 在quota_low时推通知。省钱的思路无非三条：用重置倒计时排长任务、用 30 天成本扫描找出 token 大户项目、把高花费窗口切到更便宜的 provider。

常见故障与解法

图标没有数据。九成是来源失效：检查该 provider 是否勾选、登录态是否还在，cookie 型来源过期的话，清一次codexbar cache clear --cookies或重新走 cookie 导入；API key 型则直接换 key。

数据显得不新鲜。默认 Adaptive 刷新会在菜单开着时更积极、闲置时降频。手动点一下菜单即可立即刷新；长期嫌慢就去刷新间隔里改固定档（1~30 分钟）。

权限弹窗反复出现。浏览器 cookie 导入需要 Keychain 授权，读 Safari 需要完全磁盘访问。不想授权就换路径：手动 cookie、API key 或 OAuth 都行；Settings → Advanced 里还能一键禁用 CodexBar 自己的 Keychain 操作，手动来源不受影响。

从你的场景挑一个入口就行：先brew install --cask codexbar装好，打开 Settings 勾上你每天在用的那个 provider，十分钟后看它报的会话窗口和重置时间，跟你实际体感对不对得上。对得上了，再慢慢把 hooks、serve 和成本归档接起来。

【免费下载链接】CodexBarShow usage stats for OpenAI Codex and Claude Code, without having to login.项目地址: https://gitcode.com/GitHub_Trending/co/CodexBar