CodexBar：不登录就能看 OpenAI Codex 和 Claude Code 用量统计，真香还是鸡肋？
30秒结论：CodexBar 是一个 macOS 菜单栏工具，让你不需要登录网页就能实时查看 OpenAI Codex 和 Claude Code 的 API 用量统计。如果你是重度 API 用户（月消耗 $50+），这玩意能省掉每天打开网页看 dashboard 的时间。但如果你只是偶尔用几次，装它纯属多余。适合：API 重度用户、macOS 开发者、需要监控成本的项目负责人。不适合：偶尔使用的个人用户、Windows/Linux 用户（它只支持 macOS）。
核心功能：菜单栏里的 API 监控器
CodexBar 就干一件事：把 OpenAI Codex 和 Claude Code 的 API 用量数据拉到 macOS 菜单栏上显示。不需要登录网页，不需要开浏览器。
安装（超简单）
# 用 Homebrew 安装
brew install --cask codexbar
# 或者去 GitHub Releases 下载 .dmg
安装完启动，菜单栏出现一个图标，点击就能看到用量。
配置 API Key
第一次运行会让你输入 API Key。CodexBar 不会把你的 key 上传到任何服务器——所有请求都是直接从你的机器发到 OpenAI/Anthropic 的 API。
# 设置 OpenAI API Key
open -a CodexBar
# 然后在偏好设置里输入 key
用量统计展示
点击菜单栏图标，你会看到：
- 当前周期用量：本月/本周/今天的 token 消耗
- 剩余额度：如果设置了预算限制
- 最近请求：最近 5 次 API 调用的 token 数
- 费用估算：按当前用量推算的月费用
数据来源
CodexBar 通过调用 OpenAI 和 Anthropic 的用量 API 获取数据：
- OpenAI：
GET https://api.openai.com/v1/dashboard/billing/usage - Claude：
GET https://api.anthropic.com/v1/usage
注意：这些 API 端点不是公开文档中的，而是 OpenAI/Anthropic 内部 dashboard 用的。这意味着如果它们改了接口，CodexBar 可能会挂。
性能测试：对系统的影响
在我的测试环境（MacBook Pro M1 Pro, 16GB RAM, macOS Sonoma 14.2）中：
| 指标 | CodexBar | 手动打开浏览器看 dashboard |
|---|---|---|
| 启动时间 | 0.8s | 5-10s（浏览器启动+加载页面） |
| 内存占用 | 12-18MB | 200-500MB（浏览器标签页） |
| CPU 占用 | <1%（空闲时） | 2-5%（浏览器后台） |
| 查看用量耗时 | 1-2 秒（点击菜单栏） | 10-30 秒（打开浏览器+登录+导航） |
结论：对于每天看 3-5 次用量的人来说，CodexBar 每天能省下 1-2 分钟。一个月就是 30-60 分钟。如果你时薪 $50，这工具一个月给你省了 $25-50。
踩坑记录：我遇到的问题
1. API Key 存储问题
CodexBar 把 API Key 存储在 macOS Keychain 里，这是正确的做法。但问题在于：如果你用 iCloud Keychain 同步，其他设备也能看到你的 key。这不是 CodexBar 的锅，但需要注意。
workaround：在非信任设备上不要同步 iCloud Keychain。
2. 用量数据延迟
OpenAI 的用量 API 有 5-15 分钟的延迟。也就是说，你刚调完 API，CodexBar 不会立即显示。我一开始以为是 bug，后来发现是 OpenAI 那边的问题。
workaround：等 10 分钟再查看，或者接受这个延迟。
3. Claude Code 支持不稳定
我测试时，Claude Code 的用量统计经常返回空数据。查了 GitHub issues，发现是 Anthropic 的用量 API 不稳定，有时返回 403 错误。
workaround：如果 Claude 数据不显示，等几小时再试，或者提交 issue。
4. 只支持 macOS
这个不是 bug，是 feature。但如果你在 Windows/Linux 上开发，这工具对你没用。
横向对比：CodexBar vs 同类工具
| 特性 | CodexBar | OpenAI Dashboard (网页) | Postman API Monitor | 自建脚本 |
|---|---|---|---|---|
| 平台 | macOS 菜单栏 | 任何浏览器 | 任何平台 | 任何平台 |
| 安装难度 | 1 分钟 | 0 分钟 | 5 分钟 | 30 分钟+ |
| 实时性 | 5-15 分钟延迟 | 实时 | 实时 | 取决于 API |
| 多模型 | OpenAI + Claude | 仅 OpenAI | 任意 API | 任意 API |
| 费用估算 | 有 | 有 | 需自建 | 需自建 |
| 开源 | 是 | 否 | 否 | 是 |
| 隐私 | 本地 | 需登录 | 需登录 | 本地 |
| 维护成本 | 低 | 低 | 中 | 高 |
自建脚本示例（如果你不想用 CodexBar）
#!/usr/bin/env python3
import requests
import json
from datetime import datetime
def get_openai_usage(api_key):
headers = {
"Authorization": f"Bearer {api_key}",
"Content-Type": "application/json"
}
# 获取本月用量
url = "https://api.openai.com/v1/dashboard/billing/usage"
params = {
"start_date": "2025-01-01",
"end_date": datetime.now().strftime("%Y-%m-%d")
}
response = requests.get(url, headers=headers, params=params)
if response.status_code == 200:
data = response.json()
print(f"本月总用量: {data.get('total_usage', 0)} tokens")
print(f"估算费用: ${data.get('total_usage', 0) * 0.002 / 1000:.2f}")
else:
print(f"错误: {response.status_code}")
# 使用
get_openai_usage("sk-your-api-key-here")
注意：上面的 dashboard/billing/usage 端点不是公开文档中的，可能随时变化。我用的时候是有效的，但 OpenAI 可能会改。
最终评价
| 维度 | 评分 (1-10) | 说明 |
|---|---|---|
| 功能 | 7/10 | 核心功能扎实，但只覆盖用量统计 |
| 性能 | 9/10 | 内存占用小，启动快 |
| 性价比 | 8/10 | 免费开源，但只对重度用户有价值 |
| 文档 | 6/10 | GitHub README 够用，但缺少故障排除 |
| 维护 | 5/10 | 依赖非公开 API，随时可能失效 |
推荐场景：
- API 重度用户：每月消耗 $100+，需要实时监控
- 团队管理者：需要监控多个 API Key 的用量
- macOS 开发者：喜欢菜单栏工具，不想开浏览器
不推荐场景：
- 偶尔使用 API：装它纯属多余
- Windows/Linux 用户：不支持
- 需要精确到秒的用量：有 5-15 分钟延迟
替代品：
- 如果你需要更强大的 API 监控，可以考虑自建脚本或 Postman
- CodexBar 的替代品：
API Usage Monitor（付费）、OpenCost（开源，但更复杂）
试用链接
- CodexBar 官网: https://github.com/steipete/CodexBar
💬 加入 AI 工具交流社群
关注我，获取更多 AI 工具深度测评
- 每周精选 3-5 个最新 AI 开源工具
- 工程师视角的踩坑实录
- 企业 AI 转型实战案例
关注公众号，回复「工具包」领取：
- 《AI 工具包 2025》PDF 下载
- 《50+ AI 工具导航表》（持续更新）
- 《AI Agent 开发实战手册》
- 《2025 AI 开源项目趋势报告》
🏢 企业 AI 定制服务
如果你的团队正在探索 AI 落地，我们提供：
- AI 工作流自动化：从需求分析到部署上线
- 私有知识库搭建：RAG + 向量数据库 + 本地模型
- AI Agent 开发：定制业务场景的智能代理
- 技术培训：团队 AI 能力升级方案
📧 联系邮箱: contact@ai-media-matrix.com
本文包含工具推荐链接。如通过链接访问，我会获得少量支持，但不会影响你的使用体验。
Top comments (0)