ClaudeBar

菜单栏一眼看清所有 AI 编程助手剩余额度

ClaudeBar 是一款 macOS 菜单栏小工具，用于集中监控多个 AI 编程助手的用量配额。它把 Claude、Codex、Antigravity、Gemini、GitHub Copilot、GLM、Kimi 等服务的剩余额度直接显示在系统菜单栏，无需逐个打开网页后台或命令行查询。核心能力包括：实时读取并展示各服务的用量与剩余百分比，支持多账号/多服务并行监控，用量接近上限时给出视觉提醒，帮助开发者避免在写代码中途被限流打断。项目用 Swift 编写，原生适配 macOS，常驻菜单栏、资源占用低，点击即可展开详情。适合同时订阅多个 AI 编码工具、需要控制成本或按额度规划工作的开发者，尤其是重度使用 Claude Code、Codex 的用户。

开源 free 办公效率

访问官网 ↗ GitHub ↗ 文档 ↗

GitHub 星标 ★ 1495

维护状态活跃

是否开源是

定价模式 free

项目数据

分类办公效率

开发团队tddworks

所属国家

官网地址https://tddworks.github.io/ClaudeBar

GitHubhttps://github.com/tddworks/ClaudeBar

定价模式free

价格说明开源免费工具，定价信息待确认

访问状态

是否开源是

开源协议

主要语言Swift

技术栈/模型antigravity,claude,claude-code,codex,gemini,githubcopilot,glm5,kimi

GitHub 星标★ 1495

30天Star增速

HF 下载量

上线时间2025-12-20 00:00:00

最近更新2026-09-18 00:00:00

维护状态活跃

中文支持

访问方式

移动端支持

综合评分

收录时间2026-09-13

浏览次数0

使用教程

难度：进阶约 20 分钟部署方式：本地安装 7 步

环境要求

macOS 系统（原生菜单栏应用）
已安装 Xcode（需要打开 .xcworkspace 并在其中运行）
已安装 Homebrew（用于安装 Tuist）
Tuist（`brew install tuist`）
可选：uv 或 pip（用于安装 kimi-cli / kiro-cli 探针）

安装与启动步骤

1安装 Tuist

用 Homebrew 安装 Tuist 构建工具，若已安装可跳过此步。
```
brew install tuist
```
2安装项目依赖

在 ClaudeBar 仓库根目录执行，拉取工程所需的依赖。
```
tuist install
```
3构建 Release 版本

编译 ClaudeBar 的 Release 配置，确认本地工具链可正常构建。
```
tuist build ClaudeBar -C Release
```
4生成 Xcode 工程

生成 ClaudeBar.xcworkspace，供后续在 Xcode 中打开运行。
```
tuist generate
```
5打开工程运行

打开工作区后按 Cmd+R 运行，应用会出现在菜单栏中。
```
open ClaudeBar.xcworkspace
```
6可选：跑测试

如需验证构建，可运行全部测试；加参数可开启代码覆盖率。
```
tuist test
```
7可选：安装探针 CLI

要监控 Kimi 或 AWS Kiro，需先安装对应的 CLI 探针。
```
uv tool install kimi-cli
uv tool install kiro-cli
```

关键配置

配置项	必填	说明	示例
`KIMI_AUTH_TOKEN`	否	Kimi API 模式下的认证令牌，可替代 Full Disk Access 授权	`sk-xxxxxxxx`
`Device ID`	否	Notify! 设备 ID，用于把配额状态推送到 iPhone/iPad	`粘贴 Notify! 中的设备 ID 或整条通知 URL`
`Token`	否	Notify! 设备令牌，与 Device ID 配对后点击 Save Link 保存	`eyJhbGciOi...xxxxxxxx`
`AWS 配置`	否	Bedrock 监控需配置 AWS SSO profile 或环境变量	`AWS_PROFILE=default`
`推理区域`	否	Bedrock 监控的目标推理区域，在 Settings > Bedrock 中选择	`us-east-1`

如何确认成功

Xcode 中按 Cmd+R 运行后，菜单栏出现 ClaudeBar 图标，点击可展开查看各服务的配额与剩余百分比。

常见问题

Q：Kimi 提示需要完全磁盘访问权限怎么办？

A：这是 Kimi 的 API 模式要求。可在系统设置 > 隐私与安全性 > 完全磁盘访问中授权 ClaudeBar，或设置 KIMI_AUTH_TOKEN；改用推荐的 CLI 模式则不需要该权限。

Q：本地不装 Xcode 能安装吗？

A：README 只提供源码构建方式：用 Tuist 构建并生成工作区，再在 Xcode 中打开运行，因此需要 macOS 上的 Xcode 环境。

Q：推送到 iPhone 的通知是必须开启的吗？

A：不是。Publish to Notify! 默认关闭，属可选功能，需先在 Notify! 获取设备 ID 和 token 并保存链接后再开启。

Q：iOS 上收不到实时活动（Live Activity）？

A：实时活动需要 iPhone 或 iPad 的 ID，且必须先在目标设备上打开一次 Notify! 以注册推送凭证；Mac 和浏览器 ID 只能显示小组件。

Q：AWS Kiro 一直读不到用量？

A：需先安装 kiro-cli，并运行 kiro-cli 完成登录提示（或使用 Kiro IDE 登录）后，ClaudeBar 才能读取用量。

注意事项

Notify! 功能会把服务名称、配额窗口标签和剩余百分比发送到第三方服务，请自行评估隐私影响。
设备令牌存放在 Keychain 中，而非 ~/.claudebar/settings.json。
自行编译的版本为 ad-hoc 签名，Keychain 会拒绝，此时令牌回退使用 ClaudeBar 的应用凭据。
Kimi 推荐使用 CLI 模式，需先安装 kimi-cli；API 模式依赖浏览器 cookie 或 KIMI_AUTH_TOKEN。

核心亮点

原生 Swift 菜单栏应用，常驻后台、点击即看，不占 Dock 和窗口
一次覆盖 Claude、Codex、Gemini、Copilot、GLM、Kimi 等多个主流 AI 编码服务
用量接近上限时可提前预警，避免写代码中途被限流打断

不足之处

仅支持 macOS，Windows 和 Linux 用户无法使用
依赖各服务非公开接口，上游改动可能导致某项监控失效，需跟随更新

适用场景

同时订阅 Claude 和 Codex，想随时知道哪个额度还够用
团队按 AI 用量做成本控制，需要快速查看剩余配额
重度使用 AI 编程助手，担心写到一半被限流，提前预警

替代项目

ccusage、OpenUsage、AIUsageMonitor

项目介绍

ClaudeBar 是一个办公效率领域的开源项目，官方简介：A macOS menu bar application that monitors AI coding assistant usage quotas. Keep track of your Claude, Codex, Antigravity ,and Gemini usage at a glance.。项目使用 Swift 开发，在 GitHub 上获得 1482 星标。

上一篇：docmind-ai-llm

下一篇：tokens