跳到主要内容

安装 CC-Switch

CC-Switch 是什么？​

CC-Switch 是 Claude Code / Codex / Gemini CLI 的可视化管理工具。 从「供应商切换器」演进为 AI CLI 一体化管理平台，可统一管理：

  • 多供应商 API 配置（一键切换）
  • MCP 服务器
  • Skills / 系统提示词
  • 系统托盘快捷操作

对鹊桥用户来说：你只需要在 CC-Switch 里添加一次鹊桥地址 + 令牌，即可同时服务 Claude Code 与 Codex。

软件下载​

官方仓库： https://github.com/farion1231/cc-switch/releases

Windows​

  1. 打开 GitHub Releases
  2. 滚动到 Assets，下载 .msi 安装包（推荐）
  3. 双击安装，运行 CC-Switch 主程序

macOS​

推荐 Homebrew：

brew tap farion1231/ccswitch
brew install --cask cc-switch

安装后在「启动台 / 应用程序」中打开。

macOS 首次打开

作者可能未使用苹果开发者签名。若提示「未知开发者」：

  1. 先关闭提示
  2. 打开 系统设置 → 隐私与安全性
  3. 点击 仍要打开

Linux​

到 Releases 下载对应包（版本号以页面为准）：

  • .deb（Debian / Ubuntu）
  • .rpm（Fedora / RHEL）
  • .AppImage / .flatpak

Debian / Ubuntu 示例：

# 把 x.x.x 换成 Releases 上的实际版本
wget https://github.com/farion1231/cc-switch/releases/latest/download/cc-switch_x.x.x_amd64.deb
sudo dpkg -i cc-switch_x.x.x_amd64.deb

环境检查（建议）​

配置前请确认：

  1. Node.js 已安装（如需用 npm 装 CLI）
  2. 已创建 鹊桥令牌
  3. 已安装要使用的 CLI（Claude Code / Codex），见后续章节

确认无误后进入：配置鹊桥