CC Status Bar：Claude Code 会话监控

项目简介

CC Status Bar 是一款原生 macOS 菜单栏应用，用于实时监控 Claude Code（以及 OpenAI Codex CLI）的会话状态。它通过 Claude Code hooks 跟踪会话的运行、等待与结束，用菜单栏图标的颜色提示哪一端需要你处理，点击后可直接跳转到对应的终端标签页或编辑器窗口。

主要功能

菜单栏状态色

• 🟢 绿色：会话运行中
• 🔴 红色：等待权限确认（最高优先级）
• 🟡 黄色：命令执行完成，等待下一步
• ⚪ 白色：空闲，没有活跃会话

会话列表：点击菜单查看会话详情（项目目录、状态、时间），子菜单可执行 Open in Finder、复制路径 / TTY、复制 attach 命令（针对 detach 的 tmux 会话）。

全局快捷键 ⌘⇧C：聚焦优先级最高的等待会话（红 > 黄）；没有等待会话时聚焦最近会话；完全没有会话时打开菜单。

自动聚焦：开启后，当 Claude 需要权限或命令结束时自动把对应终端窗口带到前台。带 500ms 防抖、30s 单会话冷却、输入时抑制（3s 冷却），并跳过 detach 的 tmux 会话。

通知操作：通知中附带 Focus Terminal 按钮，可立即跳转。

自定义

• 会话显示模式：项目名（默认）、tmux 窗口名、tmux 会话名、会话/窗口组合，非 tmux 环境一律回退为项目名
• 置顶窗口：把会话列表作为浮动窗口常驻显示
• 配色主题：Vibrant（默认）、Muted、Warm、Cool
• 会话超时：1h、3h、6h、12h、24h 或永不隐藏

集成

• Codex 支持：OpenAI Codex CLI 会话与 Claude Code 一样显示状态、通知与自动聚焦
• Stream Deck 插件：DMG 中附带 CC Status Bar.streamDeckPlugin，双击安装，可显示/聚焦会话、发送方向键、Enter、Esc、切换听写
• iOS 远程监控：配合 vibeterm App，在设置中开启 Web Server，再通过二维码连接（支持局域网、Tailscale IP 或主机名）
• CCSB Events 协议：外部 CLI 可通过 CCStatusBar emit 上报 session.start、session.stop、session.waiting、session.running、artifact.link 等事件

安装与使用

从 Releases 下载 CCStatusBar.dmg，打开后将 CCStatusBar.app 拖入 Applications，启动并按提示授予辅助功能权限，然后跟随设置向导完成初始化。应用首次启动会自动配置 Claude Code hooks，无需手动设置。

从源码进行本地部署使用统一脚本：

./scripts/dev-deploy.sh --check
./scripts/dev-deploy.sh

在 VS Code / Cursor 等编辑器中使用 Claude Code 扩展时，需要开启终端模式：

{
  "claudeCode.useTerminal": true
}

也可以在编辑器内置终端里直接运行 claude。注意扩展的原生侧边栏 UI 不支持 hooks，无法被检测。

常用命令行：

CCStatusBar list
CCStatusBar setup --force
CCStatusBar setup --uninstall
CCStatusBar emit --tool aider --event session.start --session-id abc123

卸载时会移除 CC Status Bar 自己的 hook 命令，同时保留共享 hook 组中的其他命令与 matcher 设置。

支持环境

• 完整支持：Ghostty + tmux（标签切换与 pane 聚焦）、iTerm2（按 TTY 切换标签）、VS Code / Cursor / Windsurf（按项目名匹配窗口）
• 部分支持：Terminal.app + tmux（仅 pane 聚焦）
• 不支持：Warp、非 tmux 的多标签环境

注意事项

• 需要 macOS 13.0+，支持 Apple Silicon 与 Intel Mac
• 需要安装 Claude Code CLI
• Ghostty 标签切换需要授予辅助功能权限（系统设置 → 隐私与安全性 → 辅助功能）
• 应用已通过 Apple 公证，打开时不会出现 Gatekeeper 警告
• 会话数据保存在本地 ~/Library/Application Support/CCStatusBar/sessions.json，调试日志位于 ~/Library/Logs/CCStatusBar/debug.log

---

本作品整理自 GitHub 开源项目 usedhonda/cc-status-bar，原作者 @usedhonda，许可证 MIT。中文介绍由 AI 根据项目 README 整理，以原仓库为准。