项目预览
项目数据
项目介绍
Star 增长趋势
本站每日记录该项目 GitHub 星标变化,观测越久曲线越完整
数据来源:GitHub API 逐日快照 · 收录于 2026-09-13 · 当前星标 ★ 1568
使用教程
环境要求
- 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
上一篇:docmind-ai-llm
下一篇:tokens
同类项目推荐
docling.rs
开源
用 Rust 把 PDF 秒变结构化 Markdown,喂给 RAG
Full Rust port of Python docling
Ze-Notes
开源
把 Zotero 里散落的笔记和标注集中可视化,读文献更省心
Zotero plugin for note management. Helping you visualize your notes and annotations ···
ai-ppt-generator
开源
输入主题或文档,几分钟生成可编辑的 AI PPT
2026 年编程导航 AI 编程实战新项目,基于 Python FastAPI + LangChain + LangGraph + Rea···
docling-Studio
开源
浏览器里调文档解析,边看边界框边入库建 RAG
Visual document analysis studio powered by Docling — configure the extraction pipel···
genoffice
开源
本地 AI 办公套件,让编程智能体直接改 Office 文件
Free, open-source AI Office suite: Docs, Sheets, Slides, PDF, Markdown and HTML edit···
meetcap
开源
会议录音本地转写,AI 自动出纪要还能对话驱动
Powerful, free, context-aware AI native meeting assistant that transcribes real-time···
univer-workspace
开源
一个工作空间里,人和 AI 一起写文档做表格
An open-source Office workspace where people and AI agents create, collaborate, and ···
word-GPT-Plus
开源
在 Word 里直接调用 AI,边写边生成,效率翻倍
Word GPT Plus is a word add-in which integrates the AI&Agent into Microsoft Word.
fly-island
开源
把手机灵动岛搬上 PC,通知、剪贴板、待办一岛搞定
A lightweight PC Dynamic Island that integrates QQ, WeChat, and email notifications,···
