
CodexBar是一款轻量级macOS菜单栏应用,专为开发者设计,用于实时监控AI编码助手的使用配额和限额。无需登录浏览器,即可在菜单栏直接查看OpenAI Codex和Claude Code的session使用情况、每周限额和剩余额度。支持macOS 14+(兼容Apple Silicon和Intel),采用Swift编写,界面简洁无打扰。适合频繁使用AI编码助手的开发者、团队管理员监控配额使用情况,以及需要实时掌握API使用状态的专业用户。
CodexBar由知名iOS/macOS开发者Peter Steinberger(steipete)开发并开源,采用MIT许可证免费发布。优势在于开源免费、零登录设计保护隐私、本地API获取数据不上传云端、轻量级无打扰、支持多提供商和灵活显示模式、内置CLI工具支持自动化、提供桌面小组件。不足在于仅支持macOS 14+(不支持旧版macOS)、需要手动配置API密钥(对新手有一定门槛)、目前仅支持OpenAI Codex和Claude Code两个提供商。适合需要实时监控AI配额且注重隐私的macOS用户。
CodexBar官网与下载
点击访问CodexBar官网 | GitHub仓库 | 下载最新版
CodexBar核心功能
- 菜单栏实时监控:在macOS菜单栏直接显示AI编码助手的使用状态,无需打开浏览器或登录
- 多提供商支持:支持OpenAI Codex、Claude Code等主流AI编码助手,可自定义启用
- 灵活显示模式:支持独立图标模式(每个提供商一个状态项)或合并图标模式(带提供商切换器和概览标签)
- 动态图标提醒:菜单栏图标根据使用配额动态变化,直观显示剩余额度和限额状态
- CLI工具集成:内置命令行工具,支持脚本自动化和CI/CD工作流集成
- 桌面小组件:WidgetKit支持,可在macOS桌面添加小组件,镜像菜单栏显示
- 提供商状态监控:实时跟踪AI服务提供商的状态和事件,及时获取服务中断信息
- 零登录设计:无需浏览器登录,通过本地API直接获取配额信息,保护隐私
CodexBar安装方式
方式一:Homebrew安装(推荐)
brew install --cask steipete/tap/codexbar
方式二:GitHub Releases下载
1. 访问 GitHub Releases页面
2. 下载最新版本 CodexBar-x.x.x.dmg
3. 拖拽安装到Applications文件夹
系统要求
- 操作系统:macOS 14+ (Sonoma)
- 芯片架构:Apple Silicon (M1/M2/M3) 或 Intel
- 内存:最低4GB RAM
- 存储:约50MB可用空间
CodexBar使用指南
首次设置
1. 启动CodexBar后,点击菜单栏图标
2. 进入Settings,启用需要监控的AI提供商
3. 根据提示配置API密钥(本地存储,不上传云端)
4. 选择显示模式:独立图标或合并图标
日常使用
• 菜单栏图标实时显示当前session使用情况和每周限额
• 点击图标查看详细配额信息和提供商状态
• 限额接近时图标动态变化提醒
• 支持快捷键快速查看
CLI工具使用
# 查看当前配额状态 codexbar status # 查看特定提供商状态 codexbar status --provider openai codexbar status --provider claude # 导出配额报告 codexbar export --format json
CodexBar版本更新
最新版本:v0.18.0(2025年2月发布)
v0.18.0 更新内容:
- 改进配额检测算法,支持更多AI服务提供商
- 新增WidgetKit桌面小组件支持
- 优化菜单栏图标动态显示效果
- 修复Claude Code配额显示问题
- 增强CLI工具功能,支持CI/CD集成
- 改进提供商状态监控和事件提醒
CodexBar常见问题FAQ
Q1:CodexBar是什么类型的工具?
A:CodexBar是一款macOS菜单栏应用,用于监控AI编码助手(如OpenAI Codex、Claude Code)的使用配额和限额,无需浏览器登录即可在菜单栏实时查看。
Q2:CodexBar支持哪些AI服务提供商?
A:目前支持OpenAI Codex和Claude Code,开发者计划添加更多AI编码助手支持。用户可在Settings中自定义启用需要的提供商。
Q3:CodexBar需要登录吗?数据安全吗?
A:CodexBar采用零登录设计,API密钥本地存储不上传云端。工具通过本地API直接获取配额信息,保护用户隐私。
Q4:CodexBar免费吗?开源吗?
A:是的,CodexBar完全免费且开源,采用MIT许可证。源代码托管在GitHub,任何人可查看、 fork 和贡献。
Q5:CodexBar支持Intel Mac吗?
A:支持。CodexBar兼容macOS 14+,同时支持Apple Silicon (M1/M2/M3) 和 Intel 芯片的Mac设备。
未经允许不得转载:主机格调 » CodexBar macOS 菜单栏免费开源工具,免登录监控OpenAI Codex和Claude Code使用配额
主机格调



