misswell
CCRBar 是一款 macOS 原生 SwiftUI 菜单栏应用，专为 Claude Code Router（CCR）提供轻量、直观的日常管理入口：不用反复打开终端，就能查看服务状态、启动或停止 CCR，并快速进入 Dashboard。
为什么需要一个菜单栏控制器？
Claude Code Router 负责连接和管理 Claude Code 的路由服务，但在日常使用中，启动、停止、确认端口是否正常等操作仍然经常需要回到终端完成。CCRBar 把这些高频操作收进 macOS 菜单栏，让 CCR 更像一个随时可用的桌面服务。
CCRBar 不重写 CCR，也不替代 CCR 官方 CLI；它只负责启停、状态监控和快捷入口，核心逻辑仍然来自 Claude Code Router 官方项目。这样的定位让它保持简单，也方便继续使用 CCR 原有的配置和工作方式。
一眼看清 CCR 是否正常运行
打开菜单栏图标，就能看到 CCR 当前处于 Running、Stopped、Starting 还是 Error 状态。CCRBar 会分别检查 Gateway 和 Management 服务，帮助你快速判断是整个 CCR 没有启动，还是只有某个服务端口尚未就绪。
默认情况下，Gateway 使用 127.0.0.1:3456，Management 使用 127.0.0.1:3458。如果你的环境使用了不同的 Management 端口，也可以直接在设置中修改；保存后 CCRBar 会自动重启 CCR 使配置生效。
常用操作都在菜单栏里
CCRBar 提供了几项适合日常使用的快捷操作：
- 启动、停止或重启 CCR
- 打开 CCR Dashboard（对应
ccr ui） - 打开 CCR 数据目录
~/.claude-code-router - 设置是否登录时启动 CCRBar
- 设置应用启动时是否自动启动 CCR
- 手动检查在线更新
启动和停止操作会根据当前状态自动互斥，避免在服务尚未稳定时重复执行命令。
自动识别 CLI、桌面版和 Node.js
CCRBar 会优先查找官方 ccr CLI；如果系统中没有，也会尝试使用 Claude Code Router 桌面版提供的 ccr-app。桌面版自带 Node.js，因此不要求用户额外配置系统 Node.js。
在普通 CLI 模式下，CCRBar 会扫描 PATH 以及 nvm、fnm、asdf、mise、Volta 等常见安装位置，并选择满足要求的 Node.js 22+ 版本。这个运行环境只对 CCR 进程临时生效，不会修改你的 shell 配置。
安装与开始使用
CCRBar 需要 macOS 14 或更高版本。使用官方 CLI 的用户可以先安装 Claude Code Router：
npm install -g @musistudio/claude-code-router然后从 CCRBar GitHub Releases 下载并打开应用。启动后，CCRBar 会出现在 macOS 菜单栏中；你可以根据需要开启登录启动和自动启动 CCR。
如果你已经安装了 Claude Code Router 桌面版，CCRBar 也会尝试识别其 ccr-app 运行入口，不必为了使用菜单栏控制器重复安装一套 CLI。
适合谁？
如果你经常使用 Claude Code Router，希望把 CCR 当作一个稳定的本地服务运行，CCRBar 可以减少终端操作和状态确认的来回切换。它尤其适合希望保留 CCR 官方 CLI 能力、同时又想拥有一个原生 macOS 菜单栏入口的用户。
CCRBar 是一个开源项目，欢迎通过 GitHub 仓库 查看源码、提交反馈，或根据自己的工作流提出改进建议。