CodexBar

macOS 菜单栏应用，实时显示 57+ 种 AI 编程工具的配额、用量和重置倒计时，无需登录即可查看。亮点是隐私优先设计，支持 OAuth、API Key、浏览器 Cookie 等多种认证方式，合并图标模式让多个提供商一目了然。开源且社区活跃，已有 Linux/Windows 移植版本。

README

CodexBar 🎚️ — 愿你的 Token 永不枯竭。

所有 AI 编程限制，尽在你的菜单栏。

一款微型的 macOS 14+ 菜单栏应用，实时显示 AI 编程提供商的限制，并标明每个窗口的刷新时间。支持 Codex、OpenAI、Claude、Cursor、Gemini、Copilot、Grok、GroqCloud、ElevenLabs、Deepgram、z.ai、MiniMax、Kiro、Zed、Vertex AI、Augment、OpenRouter、LiteLLM、LLM Proxy、Codebuff、Command Code、AWS Bedrock 以及众多更新的编程提供商。每个提供商一个状态项，或使用合并图标模式配合提供商切换器。无 Dock 图标，极简 UI，动态菜单栏图标。

为什么

围绕刷新时间做计划。 每个提供商设有会话、每周和每月窗口，并显示下次刷新的倒计时——不必再猜测是否该开始那个长任务。
积分、消费与成本扫描。 积分余额、Admin API 消费仪表盘、提供商账单摘要，以及（当数据源提供足够详情时的）本地成本扫描。
实时状态。 提供商状态轮询会在菜单中显示故障徽章，并在菜单栏图标上叠加指示器。
隐私至上。 复用现有的提供商会话——使用 OAuth、设备流、API 密钥、浏览器 cookie、本地文件——因此不存储任何密码。

安装

系统要求

macOS 14+ (Sonoma)

GitHub Releases

下载：https://github.com/steipete/CodexBar/releases

Homebrew

brew install --cask codexbar

CLI 压缩包 (macOS/Linux)

Homebrew 公式（目前支持 Linux）：

brew install steipete/tap/codexbar

Arch Linux AUR 包：

yay -S codexbar-cli

或者从 GitHub Releases 下载发布压缩包：

macOS：CodexBarCLI-v<tag>-macos-arm64.tar.gz、CodexBarCLI-v<tag>-macos-x86_64.tar.gz
Linux (glibc)：CodexBarCLI-v<tag>-linux-aarch64.tar.gz、CodexBarCLI-v<tag>-linux-x86_64.tar.gz
Linux (静态 musl)：CodexBarCLI-v<tag>-linux-musl-aarch64.tar.gz、CodexBarCLI-v<tag>-linux-musl-x86_64.tar.gz

首次运行

打开“设置”→“提供商”，启用你使用的那些。
安装/登录到你依赖的提供商来源：CLI、浏览器会话、OAuth/设备流、API 密钥、本地应用文件或提供商应用（取决于具体提供商）。
可选：设置→提供商的Codex→OpenAI cookies（自动或手动）以添加仪表盘扩展功能。

从 CLI 设置 API 密钥

提供商的开关和 API 密钥保存在已解析的 CodexBar 配置文件中。新安装使用 ~/.config/codexbar/config.json；已有 ~/.codexbar/config.json 的安装仍会从旧路径加载。你可以使用与“设置→提供商”相同的提供商列表编写脚本：

codexbar config providers
codexbar config enable --provider grok
codexbar config disable --provider cursor

对于 API 密钥类型的提供商，无需打开“设置”即可存储密钥：

printf '%s' "$ELEVENLABS_API_KEY" | codexbar config set-api-key --provider elevenlabs --stdin

set-api-key 会修剪通过管道传入的值，以严格的配置文件权限存储，并默认启用该提供商。使用 --no-enable 仅保存密钥，或使用 --api-key <key> 进行一次性本地脚本操作（若不担心 shell 历史记录）。参见 CLI 配置了解完整流程。

提供商

Codex — OAuth API 或本地 Codex CLI，外加可选的 OpenAI 网页仪表盘扩展。
OpenAI — Admin API 密钥用量/成本图表，并降级到旧版积分余额。
Claude — OAuth API、浏览器 cookies 或 CLI PTY 降级；支持会话和周度用量（如果有）。
Cursor — 浏览器会话 cookies，用于方案 + 用量 + 账单刷新。
OpenCode — 浏览器 cookies，用于工作区订阅用量。
OpenCode Go — 浏览器或本地 SQLite 数据，用于 Go 用量窗口。
Alibaba Coding Plan — Web cookies 或 API 密钥，用于编码计划配额。
Alibaba Token Plan — 百炼浏览器/手动 cookies，用于令牌计划积分。
Gemini — 基于 OAuth 的配额 API，使用 Gemini CLI 凭据（无需浏览器 cookies）。
Antigravity — 本地语言服务器探测（实验性）；无需外部认证。
Droid — 浏览器 cookies + WorkOS token 流程，用于 Factory 用量 + 账单。
Copilot — GitHub 设备流 + Copilot 内部用量 API。
Devin — Chrome localStorage 会话或手动 Bearer token，用于日度和周度配额。
z.ai — API token，用于个人/团队配额、MCP、5 小时及每小时用量窗口。
Manus — 浏览器 session_id 认证，用于积分余额、月度积分及每日刷新跟踪。
MiniMax — API token、cookie 头或浏览器 cookies，用于编码计划用量。
T3 Chat — 浏览器 cookies 捕获，用于 Base 和 Overage 用量桶。
Kimi — 认证 token（来自 kimi-auth cookie 的 JWT），用于周度配额 + 5 小时速率限制。
Kimi K2 (非官方) — 旧版 API 密钥流程，用于基于积分的总用量。
Kilo — API token，带 CLI 认证降级，用于 Kilo Pass 用量。
Kiro — 基于 CLI 的用量；月度积分 + 奖励积分。
Vertex AI — Google Cloud gcloud OAuth，通过本地 Claude 日志跟踪 token 成本。
Augment — Augment CLI 或浏览器 cookies，用于积分跟踪和用量监控。
Amp — 基于浏览器 cookie 的认证，跟踪 Amp Free 用量。
Ollama — API 密钥访问 + 浏览器 cookies，用于 Ollama Cloud 用量窗口。
JetBrains AI — 来自 JetBrains IDE 配置的本地 XML 配额；月度积分跟踪。
Warp — API token，用于 GraphQL 请求限制和月度积分。
ElevenLabs — API 密钥，用于字符积分和语音槽用量。
OpenRouter — API token，用于跨多家 AI 提供商的基于积分的用量跟踪。
Windsurf — 浏览器 localStorage 会话导入或本地 SQLite 缓存，用于方案用量。
Zed — Zed 编辑器 Keychain 会话，用于方案、编辑预测配额、计费周期及逾期发票。
Perplexity — 来自 Perplexity 用量数据的账户使用积分。
Xiaomi MiMo — 浏览器 cookies，用于余额和令牌方案用量。
Doubao — API 密钥，用于火山引擎方舟请求限制探测。
Sakana AI — 手动 Cookie 头，用于 5 小时和周度配额窗口。
Abacus AI — 浏览器 cookie 认证，用于 ChatLLM/RouteLLM 计算积分跟踪。
Mistral — 浏览器 cookies，用于 API 消费、积分余额和月度方案用量。
DeepSeek — API 密钥，用于积分余额跟踪（付费与赠送积分明细）。
Moonshot / Kimi API — API 密钥，用于 Moonshot/Kimi API 账户余额跟踪。
Venice — API 密钥，用于 DIEM 或 USD 余额跟踪。
Codebuff — API token（或 ~/.config/manicode/credentials.json），用于积分余额 + 周度速率限制。
Crof — API 密钥，用于美元积分余额和请求配额跟踪。
Command Code — 浏览器或手动 cookies，用于 Command Code 账单的月度美元积分。
StepFun — 用户名 + 密码登录，用于 Step Plan 速率限制（5 小时 + 周度窗口）和订阅方案名称。
AWS Bedrock — AWS 访问密钥或命名 AWS 配置文件（通过 AWS CLI 的 SSO/assume-role），用于 Cost Explorer 消费、月度预算及可选的 CloudWatch Claude 活动。
Grok — Grok CLI 计费 RPC 外加 grok.com 浏览器会话降级。
GroqCloud — API 密钥，用于企业版 Prometheus 请求/令牌/缓存命中指标。
LLM Proxy — API 密钥 + 基础 URL，用于聚合代理配额统计和提供商明细。
ClawRouter — API 密钥，用于月度预算、消费、请求、令牌及路由提供商用量。
LiteLLM — 虚拟密钥 + 代理 URL，用于个人和团队预算/消费跟踪。
Deepgram — API 密钥用量摘要，涵盖语音、agent、token 和 TTS 指标。
Poe — API 密钥，用于当前点数余额和近期点数历史。
Chutes — API 密钥，用于订阅用量、滚动和月度配额窗口，以及按量付费配额。
欢迎新增提供商：提供商编写指南。

图标与截图

菜单栏图标是一个微型的用量指示条。条形的含义因提供商而异，错误或过期数据会使图标变暗或显示故障指示器。

特性

多提供商菜单栏，每个提供商可单独开关（设置→提供商）。
提供商特定的用量仪表，附带刷新倒计时。
可选的 Codex 网页仪表盘增强（代码审查剩余量、用量明细、积分历史）。
针对 API 支持提供商的内联消费和用量图表，例如 OpenAI、Claude Admin API、OpenRouter、LiteLLM、z.ai、MiniMax、Mistral 和 AWS Bedrock。
可配置的成本用量扫描（Codex + Claude），以及针对支持提供商历史的复用图表 UI。
提供商状态轮询，菜单中显示故障徽章，图标上叠加指示器。
合并图标模式：将多个提供商合并为一个状态项 + 切换器。
显示控制：提供商图标、标签、指示条、刷新时间样式以及最高用量自动选择。
刷新频率预设（手动、1 分钟、2 分钟、5 分钟、15 分钟）。
捆绑 CLI (codexbar)，适用于脚本和 CI（包括 codexbar cost --provider codex、claude 或 both 进行本地成本用量）；提供 macOS 和 Linux CLI 构建。
支持提供商的 WidgetKit 小组件。
本地化的应用和网站，共享 21 语言目录，自动检测网站语言，持久的语言选择器，以及 RTL 支持。
可选的会话配额通知和周度刷新彩纸动画。
隐私至上：默认在设备端解析；浏览器 cookies 为可选项并复用（不存储密码）。

隐私说明

想知道 CodexBar 是否会扫描你的磁盘？它不会爬取你的文件系统；当相关功能启用时，它只会读取少量的已知位置（浏览器 cookies/本地存储、提供商配置文件、本地 JSONL 日志）。提供商 token 和 token 账户设置保存在 CodexBar 配置文件中，并具有严格的文件权限。详见 issue #12 中的讨论和审计说明。

macOS 权限（需要的原因）

完全磁盘访问（可选）：仅当需要读取基于 Web 的提供商的 Safari cookies/本地存储时才需要。若不授予，可使用其他受支持的浏览器、手动 cookies/API 密钥、OAuth 或 CLI/本地来源（如果该提供商支持）。
Keychain 访问（由 macOS 提示）：
- Chromium cookie 导入需要浏览器的“Safe Storage”密钥来解密 cookies。
- Claude OAuth 启动时可能会读取 Claude CLI Keychain 项（当 CodexBar 没有可用的缓存凭据时）。
- CodexBar 可能会使用 Keychain 进行浏览器 cookie 解密、缓存的 cookie 头以及 OAuth/设备流凭据（如果这些来源需要）。
- 如何阻止这些钥匙串提示？
  - 打开 钥匙串访问.app → 登录钥匙串 → 搜索提示的项目（对于 Claude OAuth，通常是“Claude Code-credentials”）。
  - 打开该项目 → 访问控制 → 在“始终允许这些应用程序访问”下添加 CodexBar.app。
  - 最好只添加 CodexBar（除非你想完全开放，否则避免选择“允许所有应用程序”）。
  - 保存后重新启动 CodexBar。
  - 参考截图：
- 如何对浏览器做相同操作？
  - 找到浏览器的“Safe Storage”密钥（例如“Chrome Safe Storage”、“Brave Safe Storage”、“Microsoft Edge Safe Storage”）。
  - 打开该项目 → 访问控制 → 在“始终允许这些应用程序访问”下添加 CodexBar.app。
  - 这将在 CodexBar 解密该浏览器的 cookies 时消除提示。
- 最后手段——完全停止所有 Keychain 读取：如果“始终允许”不起作用（例如，macOS 在 Chromium 更新或 partition_id 重置后重置了 ACL），请打开 CodexBar → 设置 → 高级 → Keychain 访问，然后启用 禁用 Keychain 访问。CodexBar 将不再访问钥匙串。基于浏览器 cookie 的提供商将被跳过，但通过 CLI 的 Claude/Codex OAuth 仍然有效（它读取 ~/.codex / ~/.claude 配置文件，而非钥匙串）。
- 卸载后仍有提示？ 删除应用可以阻止从该 bundle 启动新进程，但已运行的 CodexBar 进程在退出前可能会继续请求钥匙串访问。请检查该进程、登录项、其他已安装的副本，或提示中命名的不同请求二进制/路径。参见钥匙串提示故障排除进行安全检查，以及在不泄露秘密的前提下应在支持报告中包含哪些信息。
文件和文件夹提示（文件夹/卷访问）：对于某些提供商，CodexBar 会启动 CLI 和本地探测。如果这些辅助程序读取项目目录或外部驱动器，macOS 可能会要求 CodexBar 授予该文件夹/卷的访问权限（例如桌面或外部卷）。这是由辅助程序的工作目录驱动的，而非后台磁盘扫描。
我们不会在后台请求的内容：不请求屏幕录制或辅助功能权限；用户触发的辅助操作可能会请求 macOS 自动化权限以打开终端。不存储任何密码（浏览器 cookies 在你选择启用时被复用）。

文档

提供商总览：docs/providers.md
提供商编写指南：docs/provider.md
问题标签指南：docs/ISSUE_LABELING.md
UI 与图标说明：docs/ui.md
CLI 参考：docs/cli.md
配置：docs/configuration.md
钥匙串提示：docs/keychain-prompts.md
CLI 配置：docs/cli-configuration.md
小组件：docs/widgets.md
架构：docs/architecture.md
刷新循环：docs/refresh-loop.md
状态轮询：docs/status.md
Sparkle 更新：docs/sparkle.md
打包：docs/packaging.md
开发：docs/DEVELOPMENT.md
发布检查清单：docs/RELEASING.md
更新日志：CHANGELOG.md

快速开始（开发）

克隆仓库，在 Xcode 中打开或直接运行脚本。
启动一次后，在“设置”→“提供商”中切换提供商。
安装/登录到你依赖的提供商来源（CLI、浏览器 cookies、OAuth/设备流、API 密钥或本地应用/配置文件）。
可选：为 Codex 仪表盘扩展设置 OpenAI cookies（自动或手动）。

从源代码构建

需要 macOS 14+ 和 Swift 6.2+。

./Scripts/package_app.sh        # 原地构建 CodexBar.app，使用即席签名
open CodexBar.app

开发循环：

./Scripts/compile_and_run.sh
./Scripts/compile_and_run.sh --test  # 在打包/重新启动前也运行分片测试套件
make check                           # SwiftFormat + SwiftLint
make docs-list                       # 列出带前置摘要的文档

CLI 安装：

# 将 CodexBar.app 安装到 /Applications 后
./bin/install-codexbar-cli.sh

寻找 Windows 版本？

Win-CodexBar

Linux 桌面集成？

codexbar-waybar — Waybar 自定义模块 + GTK4 弹出面板，适用于 Hyprland / Sway / 其他 Wayland 合成器，基于捆绑的 Linux CLI 构建。
Codexbar GNOME — GNOME Shell 扩展，将 CodexBar 用量显示在桌面面板中。
noctalia-codex-usage — Noctalia/Quickshell 插件，显示 Codex 5 小时和周度用量限制，基于捆绑的 Linux CLI 构建。
KodexBar — KDE Plasma 小组件，在 Plasma 面板中显示 CodexBar 用量，基于捆绑的 Linux CLI 构建。

状态栏与终端集成

showy-quota — 随时可见的 AI 方案配额条，适用于 SketchyBar、tmux 和 Zellij（独立 WASM 插件），基于 codexbar serve / 捆绑 CLI 构建。

致谢

灵感来自 ccusage (MIT)，特别是成本用量跟踪部分。

许可证

MIT • Peter Steinberger (steipete)

开源项目steipete2026-07-05原文

打开互动版