CodexBar 🎚️ — 愿你的 tokens 永不耗尽。

所有 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、ClinePass、AWS Bedrock 以及众多较新的编码服务商。每个服务商对应一个状态项，或启用合并图标模式并配合服务商切换器。无 Dock 图标，界面极简，支持动态栏图标。

CodexBar menu popover with provider tiles, usage bars, and reset countdowns

为什么选择它

围绕重置时间规划。 针对每个服务商的会话、每周和每月窗口，并显示距离下次重置的倒计时——不再需要猜测是否应该开始那个长任务。
额度、支出与成本扫描。 显示额度余额、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 (static 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 会修剪管道值，以受限的配置文件权限存储它，并默认启用该 provider。使用 --no-enable 仅保存密钥，或使用 --api-key <key> 用于一次性本地脚本，且无需担心 shell 历史记录。请参阅 CLI 配置了解完整流程。

Providers

Codex — OAuth API 或本地 Codex CLI，外加可选的 OpenAI 网页仪表盘附加功能。
OpenAI — 管理员 API 密钥的使用量/成本图表，并带有旧版信用余额回退机制。
Azure OpenAI — API 密钥、端点和部署验证探针。
Claude — OAuth API、浏览器 Cookie 或 CLI PTY 回退；在可用时显示会话和每周使用情况。
Cursor — 用于套餐 + 使用情况 + 账单重置的浏览器会话 Cookie。
OpenCode — 用于工作区订阅使用情况的浏览器 Cookie。
OpenCode Go — 用于 Go 使用窗口的浏览器或本地 SQLite 数据。
Alibaba Coding Plan — 用于编码计划配额的 Web Cookie 或 API 密钥。
Alibaba Token Plan — 用于令牌计划信用的 Bailian 浏览器/手动 Cookie。
Qwen Cloud — 通过浏览器/手动 Cookie 获取的 5 小时和每周个人 Token Plan 使用情况。
Gemini — 使用 Gemini CLI 凭据的 OAuth 支持的配额 API（无浏览器 Cookie）。
Antigravity — 本地语言服务器探针、agy CLI HTTPS 源以及 Google OAuth 回退（实验性）。
Droid — 用于 Factory 使用情况 + 账单的浏览器 Cookie + WorkOS 令牌流。
Copilot — GitHub 设备流 + Copilot 内部使用 API。
Devin — 用于每日和每周配额的 Chrome localStorage 会话或手动 Bearer 令牌。
z.ai — 用于个人/团队配额、MCP、5 小时和每小时使用窗口的 API 令牌。
Manus — 用于信用余额、月度信用和每日刷新跟踪的浏览器 session_id 身份验证。
MiniMax — API token、cookie header 或用于 coding-plan 使用的浏览器 cookies。
T3 Chat — 用于 Base 和 Overage 使用桶的浏览器 cookies 捕获。
ZoomMate — 用于 credits 使用的 Chrome cookie 自动导入或手动 cURL 捕获。
Kimi — 用于每周配额 + 5 小时速率限制的 Auth token（来自 kimi-auth cookie 的 JWT）。
Kilo — 用于 Kilo Pass 使用的 API token，带有 CLI-auth 回退机制。
Kiro — 基于 CLI 的使用；月度 credits + 奖励 credits。
Vertex AI — Google Cloud gcloud OAuth，并跟踪来自本地 Claude 日志的 token 成本。
Augment — 用于 credits 跟踪和使用监控的 Augment CLI 或浏览器 cookies。
Amp — 基于浏览器 cookie 的身份验证，并跟踪 Amp Free 使用情况。
Ollama — 用于 Ollama Cloud 使用窗口的 API key 访问加上浏览器 cookies。
Synthetic — 用于滚动五小时、每周 token 和搜索每小时使用的 API key 配额端点。
JetBrains AI — 来自 JetBrains IDE 配置的本地 XML 配额；月度 credits 跟踪。
Warp — 用于 GraphQL 请求限制和月度 credits 的 API token。
ElevenLabs — 用于字符 credits 和语音槽位使用的 API key。
OpenRouter — 用于跨多个 AI 提供商的基于 credits 的使用跟踪的 API token。
Windsurf — 用于计划使用的浏览器 localStorage 会话导入或本地 SQLite 缓存。
Zed — Zed 编辑器 Keychain 会话，用于计划、编辑预测配额、计费周期和逾期发票。
Perplexity — 来自 Perplexity 使用数据的账户使用额度。
Xiaomi MiMo — 用于余额和令牌计划使用的浏览器 Cookie。
Doubao — 用于 Volcengine Ark 请求限制探测的 API 密钥。
Sakana AI — 用于 5 小时和每周配额窗口的手动 Cookie 头。
Abacus AI — 用于 ChatLLM/RouteLLM 计算额度跟踪的浏览器 Cookie 认证。
Mistral — 用于 API 支出、信用余额和月度计划使用的浏览器 Cookie。
DeepSeek — 用于信用余额跟踪（付费与赠送明细）的 API 密钥。
DeepInfra — 用于预付费余额、当月支出和支出限额跟踪的 API 密钥。
Moonshot / Kimi API — 用于 Moonshot/Kimi API 账户余额跟踪的 API 密钥。
Venice — 用于 DIEM 或 USD 余额跟踪的 API 密钥。
Codebuff — 用于信用余额 + 每周速率限制的 API 令牌（或 ~/.config/manicode/credentials.json）。
Crof — 用于美元信用余额和可选请求配额跟踪的 API 密钥。
Command Code — 用于 Command Code 账单月度 USD 额度的浏览器或手动 Cookie。
Qoder — 用于 Qoder 大模型信用使用的浏览器或手动 Cookie。
StepFun — 用于 Step Plan 速率限制（5 小时 + 每周窗口）和订阅计划名称的用户名 + 密码登录。
AWS Bedrock — 用于 Cost Explorer 支出、月度预算和可选 CloudWatch Claude 活动的 AWS 访问密钥或命名 AWS 配置文件（通过 AWS CLI 进行 SSO/assume-role）。
Grok — Grok CLI 计费 RPC 以及 grok.com 浏览器会话回退。
GroqCloud — 用于企业级 Prometheus 请求/令牌/缓存命中指标的 API 密钥。
LLM Proxy — 用于聚合代理配额统计和提供商细分的 API 密钥 + 基础 URL。
ClawRouter — 用于月度预算、支出、请求、令牌和路由提供商用量的 API 密钥。
sub2api — 自托管网关密钥配额、订阅限制、钱包余额和按密钥用量。
Wayfinder — 本地路由网关轮询，用于健康状态、按路由细分、节省额度和决策延迟。
LiteLLM — 用于个人和团队预算/支出跟踪的虚拟密钥 + 代理 URL。
Deepgram — 跨语音、代理、令牌和 TTS 指标的 API 密钥使用摘要。
Poe — 用于当前积分余额和近期积分历史的 API 密钥。
Chutes — 用于订阅用量、滚动和月度配额窗口以及按量付费配额的 API 密钥。
Neuralwatt — 用于订阅千瓦时用量和预付费信用余额的 API 密钥。
ZenMux — 用于滚动五小时和七天配额窗口以及 PAYG 余额的管理 API 密钥。
xAI — 用于预付费信用余额和每日平台支出的管理 API 密钥 + 团队 ID。
对新提供商持开放态度：提供商编写指南。

图标与截图

菜单栏图标是一个小型用量计。条形含义因提供商而异，错误或过期数据可能会使图标变暗或显示事件指示器。

功能

多提供商菜单栏，支持按提供商切换（设置 → 提供商）。
提供商专属用量计量器，附带重置倒计时。
可选的 Codex Web 仪表盘增强功能（剩余代码审查次数、用量明细、积分历史）。
针对 OpenAI、Claude Admin API、OpenRouter、LiteLLM、z.ai、MiniMax、Mistral 和 AWS Bedrock 等基于 API 的提供商，提供内联支出和用量图表。
可配置的 Codex + Claude 成本用量扫描，以及用于支持提供商历史数据的复用图表 UI。
持久化的设置 → 用量与支出视图，用于本地 7/30 天估算，按原生货币分组，且仅限于暴露成本历史的提供商。
提供商状态轮询，在菜单和图标覆盖层中显示事件徽章。
合并图标模式，将提供商合并为一个状态项 + 切换器。
提供商图标、标签、进度条、重置时间样式以及最高用量自动选择的显示控制。
新安装默认使用自适应刷新。现有用户保留所有有效的存储选择，而遗留的未设置或无效偏好将解析为 5 分钟。手动和固定的 1m、2m、5m、15m 和 30m 替代选项仍然可用。
捆绑的 CLI（codexbar），用于脚本和 CI（包括 codexbar cost --provider codex、claude 或 both 用于本地成本用量）；提供 macOS 和 Linux CLI 构建版本。
支持提供商的 WidgetKit 小组件。
本地化的应用和网站，共享 21 种语言目录，自动网站检测，持久化选择器，以及 RTL 支持。
可选的会话配额通知和每周重置彩带。
隐私优先：默认在设备上进行解析；浏览器 Cookie 为可选启用并复用（不存储密码）。

隐私说明

想知道 CodexBar 是否扫描你的磁盘？它不会遍历你的文件系统；仅在相关功能启用时，读取一组已知位置（浏览器 cookies/本地存储、提供商配置文件、本地 JSONL 日志）。普通的 Adaptive 刷新从不检查本地代理活动。独立的 Adaptive（代理感知）选项会在检查运行进程列表（包括命令行）以识别 Codex/Claude 并读取有界的已知会话元数据之前进行询问。拒绝将返回到普通 Adaptive。当允许且 Agent Sessions 隐藏时，CodexBar 仅保留最新的活动时间，并丢弃会话路径和身份。提供商令牌和令牌账户设置存储在具有严格文件权限的 CodexBar 配置文件中。请参阅 issue #12 中的讨论和审计说明。

macOS 权限（为何需要）

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

文档

提供商概览: 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、浏览器 Cookie、OAuth/设备流、API 密钥，或本地应用/配置文件）。
可选：为 Codex 仪表板附加功能设置 OpenAI Cookie（自动或手动）。

从源码构建

需要 macOS 14+ 和 Swift 6.2+。

./Scripts/package_app.sh        # builds CodexBar.app in-place with ad-hoc signing
open CodexBar.app

开发循环：

./Scripts/compile_and_run.sh
./Scripts/compile_and_run.sh --test  # also run the sharded test suite before packaging/relaunching
make check                           # SwiftFormat + SwiftLint
make docs-list                       # list docs with frontmatter summaries

CLI 安装：

# after installing CodexBar.app in /Applications
./bin/install-codexbar-cli.sh

寻找 Windows 版本？

Win-CodexBar

Linux 桌面集成？

codexbar-waybar — 基于捆绑的 Linux CLI 构建的 Waybar 自定义模块 + GTK4 弹出窗口，适用于 Hyprland / Sway / 其他 Wayland 合成器。
Codexbar GNOME — 将 CodexBar 使用体验带入桌面面板的 GNOME Shell 扩展。
codexbar-cinnamon-applet — 由 CodexBar 的 JSON 输出驱动的 Linux Mint Cinnamon 面板小部件。
noctalia-codex-usage — 基于捆绑的 Linux CLI 构建的 Noctalia/Quickshell 插件，显示 Codex 5 小时和每周使用限制。
KodexBar — 基于捆绑的 Linux CLI 构建的 KDE Plasma 小部件，在 Plasma 面板中显示 CodexBar 使用情况。
codexbar-plasmoid — 用于 CodexBar 的仪表图标、提供商切换器、配额窗口、节奏、积分、本地成本和状态的 KDE Plasma 6 小部件，由捆绑的 Linux CLI 提供支持。
CodexBar Meter — 显示所有已启用提供商的配额窗口、积分和节奏的 Noctalia v5 栏小部件和面板，可从 Noctalia 插件商店安装，基于捆绑的 Linux CLI 构建。

状态栏与终端集成

showy-quota — 为 SketchyBar、tmux 和 Zellij（独立 WASM 插件）提供常驻的 AI 计划配额条，基于 codexbar serve / 捆绑的 CLI 构建。

致谢

灵感来自 ccusage (MIT)，特别是其成本使用跟踪功能。

许可证

MIT • Peter Steinberger (steipete)