CodexBar —— 菜单栏显示 OpenAI Codex 和 Claude Code 使用统计的工具

这是什么

CodexBar 是一个面向 macOS 14+（Sonoma）的菜单栏应用，专注展示 AI 编码服务的实时限额使用情况。它针对主流 AI 编码提供商（如 Codex、OpenAI、Claude、Cursor、Gemini、Copilot、Grok、GroqCloud、ElevenLabs、Deepgram、z.ai、MiniMax、Kiro、Zed、Vertex AI、Augment、OpenRouter、LiteLLM、LLM Proxy、Codebuff、Command Code、AWS Bedrock 等数十个）提供统一的用量监控界面。每个提供商在菜单栏中拥有独立的状态图标，也可以合并为单个图标并内置切换器。应用本身无 Dock 图标，界面极简，动态图标直观反映使用率。

解决的问题

开发者尤其在同时使用多个 AI 编码工具时，面临以下痛点：

• 限额信息分散：每个提供商（如 OpenAI 的 API 额度、Claude 的月度配额、Cursor 的订阅计划）的剩余用量和重置时间通常需要登录不同控制台或查看 CLI 输出，无法快速统一获取。
• 任务规划困难：不知道当前配额是否足够完成一个长任务，或者重置时间何时到来，导致中途超限中断或浪费未使用的额度。
• 认证方式多样：不同提供商支持 OAuth、API Key、浏览器 Cookie、设备流、本地文件等多种认证方式，手动管理繁琐且易泄露。
• 隐私与安全顾虑：许多同类工具要求存储服务密码或长期令牌，增加泄露风险。

CodexBar 将这些信息集中到菜单栏，提供实时状态、重置倒计时、用量图表，并复用已有会话（OAuth、Cookie、本地文件等），不存储任何密码。

核心功能

• 多提供商菜单栏监控：每个提供商独立状态项，显示使用率（如进度条）和下次重置倒计时（按会话、每周、每月窗口）。状态过期或出错时图标变暗并显示事故标记。
• 合并图标模式：将所有提供商合并为一个菜单栏图标，点击后弹出切换器，快速查看各提供商状态，减少菜单栏占用。
• 用量与费用扫描：支持信用余额、Admin API 花费仪表盘、提供商账单摘要，以及基于本地文件（如 Codex 和 Claude）的成本扫描，提供图表化历史数据。
• 实时状态轮询：提供商状态定期轮询，若出现服务事故，菜单中显示事故徽章，并在图标上叠加指示器。
• 隐私优先的认证：支持 OAuth、设备流、API Key、浏览器 Cookie、本地文件（如 CLI 配置文件、SQLite 数据库）等多种方式，不存储密码，仅复用已有会话环境。
• 命令行配置与管理：提供 codexbar config 命令，可列出、启用、禁用提供商，并通过 set-api-key 安全存储 API Key（权限严格，可禁用历史记录）。支持 --stdin 输入避免 Shell 历史泄露。
• 跨平台支持：除 macOS 原生应用外，还提供 Linux 版（glibc 和 musl 静态链接），以及 CLI 工具（可通过 Homebrew、Arch Linux AUR 安装）。
• 可扩展的提供商架构：开放提供商编写指南，社区可自行添加新提供商。

亮点 / 与同类相比

同类工具多聚焦于单一服务（如 OpenAI 用量监控）或通用 API 限额管理，但 CodexBar 的差异化优势包括：

• 专为 AI 编码生态设计：覆盖目前几乎所有主流 AI 编码提供商（Codex、OpenAI、Claude、Cursor、Gemini、Copilot、Grok、GroqCloud、ElevenLabs、Deepgram、z.ai、MiniMax、Kiro、Zed、Vertex AI、Augment、OpenRouter、LiteLLM、LLM Proxy、Codebuff、Command Code、AWS Bedrock 等），且持续更新新提供商。
• 认证方式灵活且安全：直接复用浏览器 Cookie、CLI 会话、OAuth 令牌等，无需存储密码或长期密钥，隐私性优于同类产品。
• 合并图标模式：减少菜单栏拥挤，同时保持快速切换，提升多服务用户的使用体验。
• 实时状态与事故通知：轮询提供商状态并显示事故标记，帮助用户提前规避服务不可用带来的影响。
• 开源且可定制：GitHub 开源，社区可贡献新提供商或修改 UI 行为，不受闭源软件限制。

适合谁用 / 上手

适合人群：

• 频繁使用多个 AI 编码工具的开发者（