steipete/CodexBar 源代码：https://github.com/steipete/CodexBar # CodexBar 🎚️ —— 愿你的 Token 永不枯竭。 > 每个 AI 编程限制，都在你的菜单栏里。 最新发布版 (https://github.com/steipete/CodexBar/releases/latest) macOS 14+ (https://github.com/steipete/CodexBar/releases/latest) Homebrew (https://github.com/steipete/homebrew-tap) AUR (https://aur.archlinux.org/packages/codexbar-cli) 许可证：MIT 网站 (https://codexbar.app) 一款小巧的 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，动态条形图标。 ## 为什么用？ - 围绕重置时间做规划。 每个服务商有会话、每周、每月窗口，并显示下次重置倒计时——不再纠结是否要开始那个长任务。 - 额度、支出与费用扫描。 信用余额、管理 API 支出仪表盘、服务商账单摘要，以及在数据源足够详细时进行的本地费用扫描。 - 实时状态。 服务商状态轮询会在菜单中显示故障徽章，并在条形图标上叠加指示器。 - 隐私优先。 复用现有服务商会话——OAuth、设备流程、API 密钥、浏览器 Cookie、本地文件——因此不存储密码。 ## 安装 ### 系统要求 - macOS 14+ (Sonoma) ### GitHub Releases 下载： ### Homebrew bash brew install --cask codexbar ### CLI 压缩包 (macOS/Linux) Homebrew 公式（目前支持 Linux）： bash brew install steipete/tap/codexbar Arch Linux AUR 包： bash yay -S codexbar-cli 或从 GitHub Releases 下载发布版压缩包： - macOS：CodexBarCLI-v-macos-arm64.tar.gz、CodexBarCLI-v-macos-x86_64.tar.gz - Linux (glibc)：CodexBarCLI-v-linux-aarch64.tar.gz、CodexBarCLI-v-linux-x86_64.tar.gz - Linux (static musl)：CodexBarCLI-v-linux-musl-aarch64.tar.gz、CodexBarCLI-v-linux-musl-x86_64.tar.gz ### 首次运行 - 打开设置 → 服务商，启用你使用的服务。 - 安装/登录到你依赖的服务商数据源：CLI、浏览器会话、OAuth/设备流程、API 密钥、本地应用文件或服务商应用（视服务商而定）。 - 可选：设置 → 服务商 → Codex → OpenAI Cookie（自动或手动）以添加仪表盘扩展内容。 ### 从 CLI 设置 API 密钥 服务商开关和 API 密钥存在于解析后的 CodexBar 配置文件中。新安装使用 ~/.config/codexbar/config.json；原有的 ~/.codexbar/config.json 安装仍会从旧路径加载。你可以用脚本调用与设置 → 服务商相同的服务商列表： bash codexbar config providers codexbar config enable --provider grok codexbar config disable --provider cursor 对于 API 密钥服务商，无需打开设置即可存储密钥： bash printf '%s' "$ELEVENLABS_API_KEY" | codexbar config set-api-key --provider elevenlabs --stdin set-api-key 会修剪管道传入的值，以限制性配置文件权限存储，并默认启用该服务商。使用 --no-enable 仅保存密钥，或对于一次性本地脚本（当 shell 历史记录不是问题时）使用 --api-key <key>。 完整流程请参见 CLI 配置。 ## 服务商 - Codex —— OAuth API 或本地 Codex CLI，外加可选的 OpenAI Web 仪表盘扩展。 - OpenAI —— 管理 API 密钥使用/费用图表，带有旧版信用余额回退。 - Claude —— OAuth API、浏览器 Cookie 或 CLI PTY 回退；会话和周使用量（如可用）。 - Cursor —— 浏览器会话 Cookie，用于计划 + 使用量 + 账单重置。 - OpenCode —— 浏览器 Cookie，用于工作区订阅使用量。 - OpenCode Go —— 浏览器或本地 SQLite 数据，用于 Go 使用窗口。 - Alibaba Coding Plan —— Web Cookie 或 API 密钥，用于编程计划配额。 - Alibaba Token Plan —— 百炼浏览器/手动 Cookie，用于 Token 计划额度。 - Gemini —— 基于 OAuth 的配额 API，使用 Gemini CLI 凭据（无需浏览器 Cookie）。 - Antigravity —— 本地语言服务器探测（实验性）；无需外部认证。 - Droid —— 浏览器 Cookie + 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 标头或浏览器 Cookie，用于编程计划使用量。 - T3 Chat —— 浏览器 Cookie 捕获，用于基础使用量和超额使用量桶。 - Kimi —— 认证 Token（来自 kimi-auth Cookie 的 JWT），用于每周配额 + 5 小时速率限制。 - Kimi K2（非官方） —— 旧版 API Key 流程，用于基于额度的使用总量。 - Kilo —— API Token，带有 CLI 认证回退，用于 Kilo Pass 使用量。 - Kiro —— 基于 CLI 的使用量；每月信用 + 奖励信用。 - Vertex AI —— Google Cloud gcloud OAuth，从本地 Claude 日志跟踪 Token 成本。 - Augment —— Augment CLI 或浏览器 Cookie，用于信用跟踪和使用量监控。 - Amp —— 基于浏览器 Cookie 的认证，跟踪 Amp Free 使用量。 - Ollama —— API Key 访问 + 浏览器 Cookie，用于 Ollama Cloud 使用窗口。 - JetBrains AI —— 来自 JetBrains IDE 配置的本地 XML 配额；每月信用跟踪。 - Warp —— API Token，用于 GraphQL 请求限制和每月信用。 - ElevenLabs —— API Key，用于字符信用和语音槽位使用量。 - OpenRouter —— API Token，用于跨多个 AI 服务商的基于信用的使用量跟踪。 - Windsurf —— 浏览器 localStorage 会话导入或本地 SQLite 缓存，用于计划使用量。 - Zed —— Zed 编辑器 Keychain 会话，用于计划、编辑预测配额、账单周期和逾期发票。 - Perplexity —— 来自 Perplexity 使用数据的账户使用信用。 - Xiaomi MiMo —— 浏览器 Cookie，用于余额和 Token 计划使用量。 - Doubao —— API Key，用于火山引擎 Ark 请求限制探测。 - Sakana AI —— 手动 Cookie 标头，用于 5 小时和每周配额窗口。 - Abacus AI —— 浏览器 Cookie 认证，用于 ChatLLM/RouteLLM 计算信用跟踪。 - Mistral —— 浏览器 Cookie，用于 API 支出、信用余额和月度计划使用量。 - DeepSeek —— API Key，用于信用余额跟踪（付费与赠送分解）。 - Moonshot / Kimi API —— API Key，用于 Moonshot/Kimi API 账户余额跟踪。 - Venice —— API Key，用于 DIEM 或 USD 余额跟踪。 - Codebuff —— API Token（或 ~/.config/manicode/credentials.json），用于信用余额 + 每周速率限制。 - Crof —— API Key，用于美元信用余额和请求配额跟踪。 - Command Code —— 浏览器或手动 Cookie，用于 Command Code 账单的每月 USD 信用。 - 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 Key，用于 Enterprise Prometheus 请求/Token/缓存命中指标。 - LLM Proxy —— API Key + 基础 URL，用于聚合代理配额统计和服务商分解。 - ClawRouter —— API Key，用于月度预算、支出、请求、Token 和路由服务商使用量。 - LiteLLM —— 虚拟密钥 + 代理 URL，用于个人和团队预算/支出跟踪。 - Deepgram —— API Key 使用摘要，涵盖语音、Agent、Token 和 TTS 指标。 - Poe —— API Key，用于当前积分余额和近期积分历史。 - Chutes —— API Key，用于订阅使用量、滚动和月度配额窗口以及按需付费配额。 - 欢迎新增服务商：服务商编写指南。 ## 图标与截图 菜单栏图标是一个微型使用量仪表。条形图的含义随服务商而异，错误/过期数据会使图标变暗或显示故障指示器。 ## 功能特性 - 多服务商菜单栏，可逐个服务商切换（设置 → 服务商）。 - 服务商特定使用量仪表，附带重置倒计时。 - 可选的 Codex Web 仪表盘增强（代码审查剩余量、使用量分解、信用历史）。 - 内联支出和使用量图表，适用于基于 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 语言目录，自动网站检测，持久选择器，并支持从右到左布局。 - 可选的会话配额通知和每周重置彩纸动画。 - 隐私优先：默认在设备上进行解析；浏览器 Cookie 为可选加入（不存储密码）。 ## 隐私说明 担心 CodexBar 扫描你的磁盘？它不会遍历你的文件系统；它只会读取少量已知位置（浏览器 Cookie/本地存储、服务商配置文件、本地 JSONL 日志），当相关功能启用时。服务商 Token 和 Token 账户设置存储在 CodexBar 配置文件中，并具有限制性文件权限。请参阅 issue #12 (https://github.com/steipete/CodexBar/issues/12) 中的讨论和审计说明。 ## macOS 权限（为何需要） - 完全磁盘访问权限（可选）：仅当需要读取 Safari Cookie/本地存储以用于基于 Web 的服务商时才需要。如果不授予，请使用其他受支持的浏览器、手动 Cookie/API 密钥、OAuth 或该服务商支持的 CLI/本地数据源。 - 钥匙串访问（macOS 会弹出提示）： - Chromium Cookie 导入需要浏览器的“Safe Storage”密钥来解密 Cookie。 - Claude OAuth 引导可能会在 CodexBar 没有可用的缓存凭据时读取 Claude CLI 的钥匙串项。 - CodexBar 可能使用钥匙串进行浏览器 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 解密该浏览器 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 - Issue 标签指南：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+。 bash ./Scripts/package_app.sh # 原地构建 CodexBar.app，使用 ad-hoc 签名 open CodexBar.app 开发循环： bash ./Scripts/compile_and_run.sh ./Scripts/compile_and_run.sh --test # 在打包/重启前同时运行分片测试套件 make check # SwiftFormat + SwiftLint make docs-list # 列出带有 frontmatter 摘要的文档 CLI 安装： bash # 在 /Applications 中安装 CodexBar.app 后 ./bin/install-codexbar-cli.sh ## 相关项目 - ✂️ Trimmy (https://github.com/steipete/Trimmy) —— “一次粘贴，一次运行。”将多行 shell 片段扁平化，以便粘贴并运行。 - 🧳 MCPorter (https://mcporter.dev) —— 用于模型上下文协议服务器的 TypeScript 工具包 + CLI。 - 🧿 oracle (https://askoracle.dev) —— 卡壳时问 oracle。使用自定义上下文和文件调用 GPT-5 Pro。 ## 寻找 Windows 版本？ - Win-Co