CCRBar — Development skill for Claude Code

CCRBar

**原生 macOS 菜单栏控制器，管理 [Claude Code Router (CCR)](https://github.com/musistudio/claude-code-router)。**

CCRBar 主要解决一个很具体的问题：只想查看状态、启停 CCR 时，不必为此常驻一套 WebView/Electron 渲染器。它本身无 Electron、无 Tauri、无 WebView，使用纯 SwiftUI 把 CCR 的启停、状态监控和常用入口收进菜单栏。已通过 Apple 公证，支持 Sparkle 自动更新，界面跟随系统语言（中文 / English）。

[](https://github.com/misswell/CCRBar/releases/latest)  

为什么要 CCRBar

如果只是查看 CCR 状态或重启服务，常驻一个 WebView 控制界面会带来不必要的内存开销。CCRBar 用原生 SwiftUI 提供菜单栏控制层，不加载 WebView，也不嵌入 CCR Dashboard；需要完整管理界面时，再按需打开 CCR 原有 Dashboard。

下载安装

1. 从 Releases 下载 CCRBar-x.y.z-macos.zip；
2. 解压后将 CCRBar.app 拖入「应用程序」；
3. 启动后菜单栏出现状态图标，CCR 正常运行时显示绿色圆点。

已安装的版本会自动检查更新（每天一次），也可以在菜单里点「检查更新」。

功能

• 菜单栏实时状态指示（Running / Stopped / Starting / Error）+ Gateway / Management 双端口指示灯
• 启动 / 停止 / 重启 CCR，一键打开 CCR Dashboard（ccr ui）
• 打开 CCR 数据目录（~/.claude-code-router）
• 登录启动（SMAppService）+ App 启动时自动拉起 CCR
• 在线更新（Sparkle，每天自动检查一次，可手动检查）
• 检测 CCR 本体更新：CLI 从 npm 查询最新版并一键更新（执行前需确认），桌面版读取已安装 Claude Code Router.app 的版本并与官方发布对比后提供下载入口
• 自动识别桌面版 ccr-app 自带的 Node.js，或从本机已安装版本中选择 Node.js 22+
• 修改 CCR Management 端口（默认 3458，提交后自动重启 CCR）
• 修改 Gateway 监听地址（默认 127.0.0.1，提交后自动重启 CCR）

环境要求

• macOS 14+
• `@musistudio/claude-code-router`（全局安装，或使用其桌面版）

npm install -g @musistudio/claude-code-router

设计原则

• 不使用 Electron / Tauri / Chromium / WKWebView
• 控制层保持原生、轻量，避免为菜单栏入口常驻 WebView 渲染器
• 不重写 Claude Code Router，只做启停 + 状态监控 + 快捷入口
• CCR 官方 CLI 是唯一的核心逻辑来源

自动识别与端口

启动时会优先检测官方 `ccr` CLI；如果没有，则检测 Claude Code Router 桌面版提供的 `~/.claude-