CodexBar:开源的 AI编程工具用量监控软件(支持 Cursor / Claude 等50+ 个服务)

CodexBar 是一款 macOS 菜单栏工具，把你正在付费使用的各种 AI 编码/AI 服务（Codex、Claude、Cursor、Gemini 等共 53 个提供商）的"用量窗口、信用余额、重置倒计时"统一聚合显示在菜单栏中，让你不再需要逐个打开网页/控制台去查使用配额。

AI 编码助手/AI 服务越来越多（Codex、Claude Code、Cursor、Copilot、各类国产/海外大模型 API 等），但每家的计费模式、限额刷新周期（按会话/按周/按月）都不一样。
开发者如果同时用了好几个工具（比如订阅了 Claude Code，又用 Cursor，又接了几个 API key），就要在好几个浏览器标签页或 App 之间来回切换查看"我还剩多少额度""什么时候重置"。
作者 Peter Steinberger（知名 macOS 独立开发者）做了这个小工具来解决这个"多处查额度"的琐碎痛点。

痛点	说明
多平台割裂	每个 AI 服务商都有自己的用量页面，需要逐一登录查看
限额类型不统一	有的按会话窗口、有的按周、有的按月重置，难以心算"还能不能再跑一个长任务"
缺乏预警	不知道额度是否快用完，容易在长任务跑到一半时被限流打断
成本不透明	部分 API（如 Codex、Claude）按 token 计费，但官方未必直接展示"本地花费估算"
状态突发故障难发现	服务商偶发宕机/限流事件，用户往往是任务失败了才知道

核心概念

状态项（Status Item）
：每个被识别的 AI 提供商在菜单栏可以是独立的一个图标条目，显示用量、倒计时、迷你图表；也可以合并成一个统一入口，节省菜单栏空间。
多种认证复用机制
：OAuth、Cookies、API Key、Device Flow、CLI、Local（本地凭证）、gcloud 等——CodexBar 并不创建新账号体系，而是"借用"你本机已有的登录态去读取用量数据。
重置窗口（Reset Window）
：会话级 / 每周 / 每月窗口及其倒计时，是该工具的核心展示单元。
本地成本扫描（Local Cost Scan）
：针对 Codex、Claude 这类按 token 计费的场景，做可配置的本地用量估算（不仅依赖官方展示的余额）。
状态轮询 + 事件徽章
：定期探测服务商状态页，有异常就在菜单栏图标上叠加提示。

功能要点

✅ 53 个提供商支持，覆盖主流编码助手（Codex、Claude、Cursor、Copilot、Gemini、Kiro、Devin…）、国内外大模型 API（DeepSeek、MiniMax、z.ai、Kimi、Alibaba 等）、聚合/路由平台（OpenRouter、LiteLLM）、甚至非编码类的 ElevenLabs、Perplexity。
✅ 可计划重置：清楚展示下次刷新时间，方便安排长任务。
✅ 信用余额 + 支出 + 成本扫描三重维度。
✅ 事件/状态徽章：服务商出问题时直接在图标上提示。
✅ CLI 工具 + WidgetKit 小组件：支持脚本化/CI 场景，也支持 macOS 桌面小组件。
✅ 跨平台 CLI：除了 macOS App，CLI 二进制还支持 Linux。
✅ 支持自定义提供商（"+ 您的提供商"），具备扩展性，并有"创作指南"引导社区贡献。

使用方法 / 安装步骤

macOS App：

brew install --cask steipete/tap/codexbar

或从 GitHub Releases 下载通用二进制（支持 Sparkle 自动更新）。更新：

brew upgrade

CLI（适合脚本/CI）：

brew install steipete/tap/codexbar

brew install steipete/tap/codexbar

或下载每次 Release 附带的 macOS / Linux 独立 tarball。

典型使用流程：

真正解决了什么问题

不是"帮你省钱"，也不是"帮你管理 API Key"，而是消除了"查额度"这件事的认知负担和操作摩擦：

本质上它解决的是 多 AI 服务并发使用下的"可观测性（observability）"缺失问题，而不是定价或额度本身的问题。