
如果你平时重度依赖 AI 写代码,肯定遇到过这种尴尬:手感正热,连敲了一堆需求,Cursor 或 Claude 突然弹窗提示高级模型额度用光了。现在的开发者往往会混用多个 AI 工具,各家的计费周期、重置时间和用量看板散落在不同后台里,每次想看还得专门打开浏览器登进去查——CodexBar 就是为了解决这个痛点而生的。
CodexBar 是什么?
CodexBar 是一款基于 MIT 协议开源的轻量级 macOS 菜单栏工具,能把 Cursor、Claude Code、GitHub Copilot、Gemini、OpenRouter、DeepSeek、Kimi 等 50+ 个 AI 服务的剩余额度、费用信息和重置倒计时,统一整理到系统菜单栏里。
它的核心思路是复用本机已有的登录状态:读取 OAuth、设备授权 Token、CLI 本地配置文件、浏览器 Cookie 或 API Key,在本机整理出用量和额度信息。不用把 API Key 交给第三方,数据不流向外部服务器。
核心功能一览
- 会话配额与重置倒计时:高级对话次数(Session / 周 / 月)还剩多少、多久刷新,一目了然。
- 账单与费用统计:支持 API 接口或本地用量扫描的服务,可查看费用、余额或用量趋势,避免跑超预算。
- 状态监控与预警:自动轮询服务商状态页,API 故障时菜单图标会显示提示标记。
- 本地凭证读取:通过 OAuth、Cookie、CLI 配置或 Keychain 读取,不依赖第三方中转。
怎么安装和使用?
macOS 用户可以从 GitHub Releases 下载应用,也可以用 Homebrew 一键安装:
brew install --cask steipete/tap/codexbar
Linux 用户可以使用官方提供的 CLI 命令行版本,配合 Waybar 或 GNOME 扩展实现桌面面板效果。
首次打开后,在设置里选择自己正在用的服务(Claude Code、Cursor、Copilot、Codex、OpenRouter、DeepSeek 等),按提示完成授权即可。不同服务的接入方式不同——有的走 OAuth,有的读取本地配置,有的需要浏览器 Cookie 或 API Key。
建议一开始只开启常用的几个服务,确认权限提示和数据显示正常后,再逐步添加更多平台。
适合哪些人用?
如果你只是偶尔用 AI 问个代码问题,或者只订阅一个工具,其实没必要专门装它。
CodexBar 更适合重度多工具混用的开发者:Cursor、Claude Code、Copilot、Codex 轮番上阵,还要接 OpenRouter、DeepSeek、AWS Bedrock 这类按量计费服务。对这类用户来说,提前知道额度还剩多少、什么时候重置、这个月花了多少钱,确实能少很多临时查后台的麻烦。
注意平台差异:目前 macOS 体验最完整(菜单栏图形界面,支持 macOS 14+);Linux 有官方 CLI;Windows 暂无官方版本,但有社区实现的 Win-CodexBar 项目。
相关链接
- 🌐 CodexBar 官方网站 — 查看 macOS 客户端下载入口、支持的 50+ 服务列表
- 🐙 CodexBar GitHub 项目主页 — MIT 开源协议、本地凭证读取原理、CLI 使用说明
本文基于 ahhhhfs 原文及 CodexBar 公开仓库与文档整理发布。