CCRBar 原生 macOS 菜单栏面板

如果你平时在用 Claude Code Router,可能经常需要打开终端启停服务。CCRBar 是一个原生 macOS 菜单栏应用,把这些操作和运行状态放到菜单栏里,随时可以查看和使用。

CCRBar 是什么

CCRBar 是 Claude Code Router 的菜单栏控制工具。它不替换 CCR,也不重新做一个 Dashboard,主要用来查看状态、启停服务和打开原有的管理页面。

需要详细配置时,还是可以打开 CCR 自带的 Dashboard。平时只看状态或重启服务,用菜单栏就够了。

为什么做 CCRBar

很多时候,我们只是想确认 CCR 是否在运行,或者重启一下服务。为了这些小操作一直开着一个完整的网页界面,多少有点麻烦。

CCRBar 用纯 SwiftUI 编写,不使用 Electron、Tauri 或 WebView。它只在菜单栏显示一个小面板,不会把完整的 CCR 管理界面一直放在后台运行。

它能做什么

CCRBar 提供了这些常用功能:

  • 查看 CCR 当前是运行中、已停止、启动中还是出错;
  • 分别查看 Gateway 和 Management 端口是否在线;
  • 一键启动、停止或重启 CCR;
  • 直接打开 CCR Dashboard;
  • 打开 CCR 数据目录 ~/.claude-code-router
  • 设置登录时启动,以及 CCRBar 启动后自动启动 CCR;
  • 修改 Management 端口和 Gateway 监听地址,保存后自动重启;
  • 查看并更新 CCR 本体的版本。

Gateway 默认使用 3456 端口,Management 默认使用 3458 端口。两个端口分别显示状态,遇到服务能启动但接口不能访问的情况时,比较容易判断问题出在哪里。

支持 CLI 和桌面版

CCRBar 会先查找官方 ccr CLI。如果没有找到,再查找 Claude Code Router 桌面版提供的 ccr-app

桌面版使用自带的 Node.js,不要求额外安装系统 Node.js。使用 CLI 时,CCRBar 会查找 PATH、nvm、fnm、asdf、mise、Volta 等常见位置里的 Node.js 22+,也不会修改你的 shell 配置。

更新和安装

CCRBar 使用 Sparkle 自动检查更新,默认每天检查一次,也可以手动检查。下载更新后需要用户确认安装,发布包经过 Apple 公证。

应用需要 macOS 14 或更高版本,并且电脑上已经安装 Claude Code Router CLI 或桌面版。

可以从 CCRBar GitHub Releases 下载最新版本,解压后把 CCRBar.app 拖到“应用程序”文件夹。

启动应用后,菜单栏会出现 CCRBar 图标。只要 CCR 已经安装,应用就会自动识别对应的 CLI 或桌面版并开始显示状态。

总结

CCRBar 没有把 CCR 的所有功能重新做一遍。它只提供一个简单的菜单栏入口,让你不用频繁打开终端,就能查看状态、启停 CCR,需要时再打开完整 Dashboard。

项目已经开源在 github.com/misswell/CCRBar,欢迎下载使用,也欢迎提交 Issue 和 PR。

发表回复

您的邮箱地址不会被公开。 必填项已用 * 标注