macOS 菜单栏小工具 —— 一眼看清 Codex 与 Claude Code 的用量与花费。
- 用量显示 —— Codex 与 Claude Code 的 5 小时 / 周窗口剩余额度,实时同步
- 菜单栏 + 悬浮窗 —— 状态栏图标显示剩余百分比;可选桌面悬浮 HUD,可拖动、边缘吸附、置顶不抢焦
- 多 Codex 账号 —— 支持导入多个 Codex 账号,主副账号在 Popover 同屏展示;设置页可查看每个账号的额外重置次数与到期时间
- Token 与费用统计 —— 按今天 / 昨天 / 本周 / 本月 / 本年 / 7 天 / 30 天 / 全部 / 自定义切换;KPI、堆叠柱状图、按服务占比、按模型明细
- 丰富的设置 —— 账号开关、菜单栏显示项、悬浮窗、刷新间隔、重置时间显示、中英双语、开机自动启动
要求 macOS 14 Sonoma 或更新版本。已通过终端完成 codex login 与 claude 登录。
-
到 Releases 下载最新
CCBar.app.zip,解压后把CCBar.app拖入/Applications。 -
CCBar 未做 Apple 付费公证,首次启动会被 Gatekeeper 拦下,需手动放行一次。打开「终端」,粘贴回车:
xattr -dr com.apple.quarantine /Applications/CCBar.app
然后双击打开。若仍被拦,到 系统设置 → 隐私与安全性,下滑找到 CCBar 的提示,点**「仍要打开」**。 (macOS Sequoia 起,旧的「右键 → 打开」已失效,只能用上面这种方式。)
-
若本机无
~/.claude/.credentials.json,会弹出说明后请求 Keychain 授权,请选「始终允许」。
cc-bar 是 vibe coding 出来满足个人需求的小工具,并非商业化产品。为了显示额度,它需要读取本地的登录凭据:Codex 的 ~/.codex/auth.json、Claude Code 的 ~/.claude/.credentials.json 以及 macOS Keychain。
发布的 CCBar.app 未做 Apple 付费公证(详见上方「安装」)。如果你介意安全性,完全可以自己用 AI 审阅本仓库代码,确认无误后按下方教程自行构建,不依赖我发布的二进制包。
需要安装完整 Xcode(非仅 Command Line Tools)。
日常开发:双击 ccbar.xcodeproj,选 scheme ccbar 与「My Mac」,按 ⌘R 运行调试。
打包分发:用命令行不签名构建,产物为 ad-hoc 签名,可在任意 Mac 上运行,无需付费证书或公证。
-
首次需把命令行工具指向完整 Xcode(一次性):
sudo xcode-select -s /Applications/Xcode.app/Contents/Developer
-
在项目根目录执行构建脚本:
./scripts/build.sh
脚本会以
CODE_SIGNING_ALLOWED=NO做 Release 构建(工具链自动 ad-hoc 签名), 清理扩展属性并打包,产物输出到dist/CCBar.app.zip。 -
把
dist/CCBar.app.zip上传到 GitHub Release 即可。用户首次安装按上方「安装」一节手动放行一次。
不要用 Xcode 的 Archive 导出分发:那会引入 "Apple Development" 开发证书,只能在本机运行,拷给别人会打不开。
请到 Issues 留言。
cc-bar 在设计与实现上参考了以下优秀的开源项目,在此特别感谢:
- cc-switch —— 多 Provider 账号切换器,启发了本项目的多账号管理与导入流程
- cockpit-tools —— 多平台 AI 编码助手仪表盘,在额度与刷新策略上提供了参考
- CodexBar —— macOS 菜单栏 AI 用量监控,在菜单栏交互与本地解析思路上多有借鉴