5分钟上手 CodexBar

快速在 macOS 菜单栏安装并配置 CodexBar,实时监控你使用的 AI 编程助手额度

操作步骤

1

下载并安装应用

通过 Homebrew 快速安装 CodexBar(推荐),或从 GitHub Releases 下载

使用 Homebrew 安装(最简单的方式)
brew install --cask codexbar

预期结果:应用自动安装到 /Applications 目录

如果不用 Homebrew,可从 GitHub Releases 页面下载 .dmg 文件手动安装

2

启动应用

在应用程序文件夹中找到 CodexBar 并打开

通过终端启动,或在 Finder 中双击启动
open /Applications/CodexBar.app

预期结果:菜单栏出现 CodexBar 图标(两个小横条),应用设置窗口自动打开

首次启动时,macOS 可能会询问 Keychain 访问权限,这是正常现象

3

启用你使用的 AI 服务

在设置中勾选你实际使用的 AI 编程助手

预期结果:菜单栏图标旁出现对应服务的状态指示

建议只启用你真正使用的服务,避免不必要的权限请求

4

配置服务源(可选但推荐)

根据启用的服务,确保对应的 CLI 工具已安装或浏览器已登录

预期结果:CodexBar 能正确读取各服务的额度信息

例如:启用 Codex 需要安装 Codex CLI;启用 Claude 需要 Claude CLI 或浏览器登录;大部分服务支持浏览器 cookies 方式

验证成功运行

点击菜单栏的 CodexBar 图标,查看已启用服务的额度信息

菜单栏显示 CodexBar 图标(两个小横条)
点击图标能看到启用的服务列表
服务旁显示剩余额度/使用量
能看到重置倒计时

快速提示

配置

如果不想给 Full Disk Access 权限,可使用 Chrome/Firefox 的 cookies 或 CLI 方式

配置

在设置中可调整刷新频率(默认 2 分钟),根据需求选择

配置

使用 Merge Icons 模式可将所有服务合并到一个图标显示

常见问题

1

Keychain 频繁弹出访问请求

打开 Keychain Access.app → 登录钥匙串 → 找到相关条目(如 'Chrome Safe Storage')→ 打开项目 → 访问控制 → 添加 CodexBar.app 到允许列表 → 重启 CodexBar

2

某些服务显示为灰色或没有数据

1. 确保已安装对应 CLI 工具 2. 或确保浏览器已登录该服务 3. 检查设置中该服务是否已启用

3

菜单栏没有显示 CodexBar 图标

1. 检查应用是否正在运行 2. 检查菜单栏是否有空间(可能被其他图标挤掉)3. 重启应用

下一步

探索高级功能

尝试 Merge Icons 模式、调整刷新频率、查看本地使用成本统计

配置更多服务

根据你的工作流,启用更多 AI 编程助手进行统一监控

了解 CLI 版本

如果你使用 Linux 或需要在脚本中集成,可尝试 CodexBar CLI

助手