ClaudeBar

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

开源 🏷️完全免费 ✅ 目前可打开 办公效率 🍴 复刻 158 🐛 待处理 14 👀 关注 7
访问官网 ↗ GitHub ↗
GitHub 星标 ★ 1568
维护状态 活跃
是否开源 开源
定价模式 🏷️完全免费 开源免费工具,定价信息待确认

项目预览

ClaudeBar 项目界面预览图
图片来源:项目官网

项目数据

分类办公效率
开发团队tddworks
定价模式🏷️完全免费
价格说明开源免费工具,定价信息待确认
访问状态✅ 目前可打开
是否开源是
开源协议Apache-2.0
主要语言Swift
技术栈/模型antigravity,claude,claude-code,codex,gemini,githubcopilot,glm5,kimi
GitHub 星标★ 1568
上线时间2025-12-20 00:00:00
代码更新2026-11-03
仓库体积81.5 MB
本站数据更新2026-11-03
维护状态活跃
收录时间2026-09-13
浏览次数1

项目介绍

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

Star 增长趋势

本站每日记录该项目 GitHub 星标变化,观测越久曲线越完整

数据来源:GitHub API 逐日快照 · 收录于 2026-09-13 · 当前星标 ★ 1568

使用教程

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

环境要求

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

安装与启动步骤

  1. 1安装 Tuist

    用 Homebrew 安装 Tuist 构建工具,若已安装可跳过此步。

    brew install tuist
  2. 2安装项目依赖

    在 ClaudeBar 仓库根目录执行,拉取工程所需的依赖。

    tuist install
  3. 3构建 Release 版本

    编译 ClaudeBar 的 Release 配置,确认本地工具链可正常构建。

    tuist build ClaudeBar -C Release
  4. 4生成 Xcode 工程

    生成 ClaudeBar.xcworkspace,供后续在 Xcode 中打开运行。

    tuist generate
  5. 5打开工程运行

    打开工作区后按 Cmd+R 运行,应用会出现在菜单栏中。

    open ClaudeBar.xcworkspace
  6. 6可选:跑测试

    如需验证构建,可运行全部测试;加参数可开启代码覆盖率。

    tuist test
  7. 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

★ 125 2026-10-15
Ze-Notes 开源

把 Zotero 里散落的笔记和标注集中可视化,读文献更省心

Zotero plugin for note management. Helping you visualize your notes and annotations ···

★ 107 2026-10-18
ai-ppt-generator 开源

输入主题或文档,几分钟生成可编辑的 AI PPT

2026 年编程导航 AI 编程实战新项目,基于 Python FastAPI + LangChain + LangGraph + Rea···

★ 171 2026-09-12
docling-Studio 开源

浏览器里调文档解析,边看边界框边入库建 RAG

Visual document analysis studio powered by Docling — configure the extraction pipel···

★ 271 2026-09-12
genoffice 开源

本地 AI 办公套件,让编程智能体直接改 Office 文件

Free, open-source AI Office suite: Docs, Sheets, Slides, PDF, Markdown and HTML edit···

★ 11623 2026-10-12
meetcap 开源

会议录音本地转写,AI 自动出纪要还能对话驱动

Powerful, free, context-aware AI native meeting assistant that transcribes real-time···

★ 302 2026-10-21
univer-workspace 开源

一个工作空间里,人和 AI 一起写文档做表格

An open-source Office workspace where people and AI agents create, collaborate, and ···

★ 2269 2026-10-01
word-GPT-Plus 开源

在 Word 里直接调用 AI,边写边生成,效率翻倍

Word GPT Plus is a word add-in which integrates the AI&Agent into Microsoft Word.

★ 1377 2026-08-09
fly-island 开源

把手机灵动岛搬上 PC,通知、剪贴板、待办一岛搞定

A lightweight PC Dynamic Island that integrates QQ, WeChat, and email notifications,···

★ 411 2026-10-30