ClaudeBar
tddworks/ClaudeBar加载项目详情…
本应用为开源项目，仅供学习研究，请遵守其开源协议。
微信扫码咨询客服
POMOAI — 让开源 AI 即刻运行
加载项目详情…
本应用为开源项目，仅供学习研究，请遵守其开源协议。
凌晨两点，你正在用 Claude Code 调试一个棘手的并发 bug，眼看就要跑通了——菜单栏突然弹出一条刺眼的红线："Quota Depleted"。你猛地想起：这周已经用掉了 95%。剩下的 5%，够你今晚把代码提交吗？
这不是段子，而是每一个重度依赖 AI 编程工具的开发者每周末都会面对的真实困境。Claude、Codex、GitHub Copilot、Antigravity、Z.ai、Kimi……每家的配额体系、刷新周期、计算单位都不一样。想在编码间隙搞清楚自己还剩多少额度？通常只能一次次打开各个网站的控制台，登录、刷新、记忆。
ClaudeBar 正是为了终结这种混乱而生的：它把市面上主流 AI 编程工具的配额，全部聚合到一个 macOS 菜单栏图标里，抬头就看，一目了然。
2024 年到 2025 年，AI 编程工具进入爆发期。Claude Code、OpenAI Codex、GitHub Copilot、Google Gemini CLI 争相迭代，而 Antgravity、Z.ai、Kimi、Kiro、AmpCode、OpenCode Go 等新势力也迅速崛起。对于同时使用多个工具的开发者来说，配额管理成了一项被低估的"隐性负担"。
项目由独立开发者 tddworks 创建，2025 年 12 月上线 GitHub，短时间内积累超过 1200 颗星，105 个 fork，53 个 open issues——这个活跃度在 macOS 独立工具中相当可观。项目持续活跃（最近推送：2026-06-13），说明作者在认真维护，社区反馈也在驱动迭代。
ClaudeBar 采用了清晰的分层架构，项目配置通过 Tuist（Swift 项目管理工具）生成 Xcode 工程，这是一个对 Swift 开源项目而言相对轻量的方案，不需要 CocoaPods 或 SPM 的额外包袱。
项目的源码分为三个独立 Target（编译目标），各自职责清晰：
App 层（Sources/App/） — 负责应用入口、菜单栏渲染、设置界面、主题管理和自动更新（Sparkle）。值得注意的是，App 层没有 ViewModel，SwiftUI Views 直接消费 Domain 层数据，这是有意为之的极简设计选择。
Domain 层（Sources/Domain/） — 这是项目的核心业务层，包含了最关键的两个子系统：
AIProvider 协议、UsageQuota（配额模型）、QuotaStatus（红/黄/绿状态）、CostUsage（费用模型）、AccountTier（账户等级）等Infrastructure 层（Sources/Infrastructure/） — 包含了所有外部集成实现，每个 Provider 有独立子目录：
Claude/：ClaudeCLI 使用量探针（ClaudeUsageProbe）、会话 JSONL 解析器（SessionJSONLParser）、日使用量分析器Codex/：OpenAI Codex 集成Gemini/：Google Gemini CLI 集成Copilot/：GitHub Copilot 凭证管理Alibaba/：通义千问相关Kimi/：支持 CLI 模式和 API 模式两种探测方式（见下）Zai/：Z.ai 的 GLM Coding Plan 端点OpenCode/：OpenCode Go 本地 SQLite 数据库解析项目的核心设计模式是探针（Probe）：每个 Provider 的 UsageProbe 负责从本地 CLI 工具或 API 获取原始使用数据，返回结构化的 UsageSnapshot，再由 Domain 层统一处理。这使得添加新 Provider 的成本极低——只需实现 Probe 协议，开发者在 README 中甚至提供了"Tell Claude Code: 'I want to add a new provider'" 的极客式接入指南。
README 明确提到项目采用 Chicago School TDD（测试驱动开发），测试覆盖率高（codecov 集成），有三个测试模块：AcceptanceTests、DomainTests、InfrastructureTests。Debug 和 Release 构建分别启用了不同的编译条件，支持 Mocking，便于隔离测试。
外部依赖极少，只有两个：
这种"能自己写就不引入依赖"的策略，是 Swift 桌面应用开发的良好实践。
支持 10+ 主流 AI 编程工具：Claude、Codex、GitHub Copilot、Antigravity、Z.ai、Kimi、Kiro、AmpCode、OpenCode Go、MiniMax、Mistral。用户可以在设置中独立启用/禁用每个 Provider，按需定制监控范围。
每个 Provider 的数据获取方式各有不同，体现了项目的工程智慧：
claude，kimi），发送 /usage 等命令获取配额，最轻量，无需特殊权限菜单栏图标右侧显示百分比或剩余量，绿/黄/红/灰四色状态系统：
支持系统通知，在配额状态变化时主动推送给用户。
内置亮色、暗色、CLI 风格、圣诞主题，并支持导入任意 .itermcolors 终端配色文件。主题跟随 macOS 系统外观自动切换，圣诞期间自动启用节日主题。
支持多账号场景，每个 Provider 可以配置多个子账号。应用语言跟随系统 locale，但项目本身由全球贡献者共建（contributors 列表显示来自中国、美国、欧洲等多地开发者）。
三种安装路径，难度从低到高：
brew install --cask claudebar，一行命令完成.dmg，拖入 Applications，代码签名和公证均已通过 Gatekeepertuist install && tuist build每个 Provider 的配置方式不同，README 提供了详细的设置指南：
kimi-cli，API 模式需要授予完全磁盘访问权限kiro-cli 并完成登录整体来看，对于已有 AI 编程工具使用经验的开发者，配置时间不超过 5 分钟。
作为 macOS 专属应用，Linux 和 Windows 用户完全无法使用。这是商业选择，也是一大遗憾——Quota Monitor 本身是跨平台的刚需。如果项目能推出 CLI 版本或 Web 版本，受众将大幅扩展。
Kimi API 模式要求"完全磁盘访问权限"，这一 macOS 隐私门槛对普通用户有一定心理压力，容易引发隐私担忧。虽然这是读取特定 cookie 文件的技术需要，但项目需要在文档中更明确地解释这一需求的合理性。
支持 10+ Provider，每个 Provider 的 API/CLI 接口都可能随版本更新而变化。项目已有 53 个 open issues，维护者需要持续跟进各 Provider 的变化。这对一个个人开发者（或小团队）是相当大的工作量。
所有配额数据来自本地探测，无法在多设备间同步。用户在不同 Mac 上看到的配额状态可能不一致。
ClaudeBar 背后反映了一个更大的趋势：AI 编程工具从"单点使用"向"生态管理"演进。随着 Claude Code、Copilot、Cursor 等工具在开发者群体中普及，配额可视化、配额预警、多工具统一管理正在成为"开发者效率基础设施"的一部分。
项目能在半年内积累 1200+ stars，说明这个需求足够普遍且未被很好满足。类似的工具（如为单一 AI 工具设计的配额监控）已有一些，但能聚合如此多 Provider 的，目前 ClaudeBar 是较为突出的一个。
ClaudeBar 是一款专注于 macOS 平台的 AI 编程工具配额监控工具，通过菜单栏图标实时展示 Claude、Codex、Copilot、Gemini 等 10+ 主流工具的使用状态。它架构清晰（Domain-Driven + Probe Pattern）、代码质量较高（TDD + Mockable 协议）、依赖极简（仅 Sparkle + Mockable），支持多主题、多账号和灵活的探测方式。对于同时使用多个 AI 编程工具的 macOS 开发者而言，是一款能显著减少"配额焦虑"的实用工具。其主要局限在于 macOS 独占，以及多 Provider 维护带来的持续工程负担。
| 维度 | 评分 | 说明 |
|---|---|---|
| 功能完整性 | ⭐⭐⭐⭐ | 支持 10+ Provider，状态系统完整，告警机制健全 |
| 技术架构 | ⭐⭐⭐⭐⭐ | 清晰三层架构，Probe 模式优雅，TDD 驱动 |
| 代码质量 | ⭐⭐⭐⭐ | 协议抽象完善，Mocking 机制成熟，CI/CD 完整 |
| 文档质量 | ⭐⭐⭐⭐ | README 详尽，架构文档、发布流程均有覆盖 |
| 社区活跃度 | ⭐⭐⭐⭐ | 高 stars 增速，多国贡献者，持续迭代 |
| 跨平台性 | ⭐ | 仅 macOS，Linux/Win 用户无法使用 |