claude-status-bar 是一个轻量级 macOS 菜单栏应用，用于显示 Claude Code 的实时运行状态。它可以在 Claude Code 思考、执行工具、等待权限确认或空闲时，通过菜单栏图标动画、状态标签和计时器进行提示。项目使用 Swift 开发，MIT 许可证，适合经常使用 Claude Code CLI、Claude Code Desktop Code Tab 或 Cursor Claude Code 扩展的开发者。
适用领域
macOS 工具 / AI 编程助手 / Claude Code 生态 / 开发者效率工具 / 菜单栏应用 / 状态监控
配置难度
低。普通 macOS 用户可通过 DMG 拖拽安装完成；开发者如果熟悉 Claude Code plugin 和 ~/.claude 配置，排查问题也较容易。复杂点主要在 hooks 配置、多会话行为和状态文件机制。
商业价值
该项目本身是免费的开源侧项目，直接商业化价值有限，但对重度 Claude Code 用户具有明显效率价值。它减少了开发者在长时间 AI 编程任务中反复切回终端查看状态的成本，适合个人开发者、AI 编程工作流用户和使用 Claude Code 的小团队作为生产力增强工具。对于围绕 Claude Code 构建工具链的团队，也可作为状态提示、hooks 集成和 macOS 菜单栏交互设计的参考实现。
01
技术亮点
- 非常轻量：无主窗口、无 Dock 图标、无复杂仪表盘
- 状态直观：动画图标表示思考或工作，黄色圆点表示等待权限
- 支持显示当前 turn 的耗时计时器
- 支持 Claude Code CLI、Claude Code Desktop 的 Code 标签页以及 Cursor Claude Code 扩展
- 提供多种动画样式：Claude Spark、Claude Code、Crab Walking
- 支持菜单中切换计时器、完成提示音、图标颜色和动画风格
- DMG 已签名并公证，macOS 安装体验较好
- 开源且 MIT 许可
- 隐私设计较简单：本地状态文件驱动，除每日 GitHub 更新检查外无额外网络行为
- 提供卸载脚本，可移除该项目添加的 Claude Code hooks
02
目标用户
- 使用 Claude Code CLI 的 macOS 开发者
- 使用 Claude Code Desktop Code 标签页的开发者
- 在 Cursor 中使用 Claude Code 扩展的用户
- 经常让 Claude Code 执行长时间任务、希望切换窗口后仍能看到状态的开发者
- 偏好轻量、无窗口、无 Dock 图标工具的 macOS 用户
03
配置要求
- macOS 12 或更高版本
- 已安装 Claude Code CLI 或 Claude Code Desktop App
- 需要 Node.js
- 首次启动会修改或合并 Claude Code 配置文件 ~/.claude/settings.json，并会先备份
- 运行状态文件位于 ~/.claude/statusbar/state.json
- 活跃会话文件位于 ~/.claude/statusbar/sessions.d/
- 应用会每 0.4 秒轮询状态文件
- 应用每天最多进行一次 GitHub Release 检查，用于检测更新
04
适用场景
- 在菜单栏查看 Claude Code 是否正在思考或执行工具
- Claude Code 等待用户授权时通过黄色圆点提醒
- 查看当前 Claude Code 回合已耗时多久
- Claude Code 完成长时间任务后播放提示音
- 在多个窗口间切换时无需回到终端即可判断 Claude Code 当前状态
- 通过不同动画样式区分 Claude 正在工作还是空闲
05
部署与配置
- 方式一：推荐使用 DMG 安装。
- 从 GitHub Releases 下载最新的 ClaudeStatusBar.dmg。
- 打开 DMG，将 Claude Status Bar 拖入 Applications 文件夹。
- 首次启动应用，它会自动配置 Claude Code hooks。
- 启动一个新的 Claude Code 会话，菜单栏图标会在 Claude Code 运行时显示。
- 更新时下载最新 DMG，拖入 Applications 并选择替换，启动一次后重启 Claude Code。
- 方式二：通过 Claude Code plugin 安装 hooks。
- 在 Claude Code 中执行：/plugin marketplace add m1ckc3s/claude-status-bar
- 继续执行：/plugin install claude-status-bar@claude-status-bar
- 注意插件只安装 hooks，不安装 macOS App 本体，仍需从 DMG 将应用拖入 Applications。
06
风险与注意事项
- 只适合 macOS，不支持 Windows 或 Linux
- 目前主要为单个活跃 Claude Code 会话设计，多会话并行时只跟踪最近活跃的会话
- 不支持 Claude Desktop 的 Chat 标签页
- 不支持 Cowork
- 依赖 Claude Code hooks 和 ~/.claude/settings.json，Claude Code 内部机制变化可能导致兼容性问题
- 需要 Node.js，虽然应用本体是 Swift，但 hooks 安装和卸载依赖 Node 脚本
- 使用 Claude 名称和图标存在商标相关敏感性，项目声明其非 Anthropic 官方项目
- 如果用户手动修改过 Claude Code hooks 配置，自动合并配置时仍可能产生冲突或需要排查
2026-06-28
第11名
新收录 · github_search
2026-06-27
第12名
新收录 · github_search
2026-06-26
第21名
新收录 · github_search
