CC-Switch 是一款跨平台开源桌面工具，用于统一管理 Claude Code、Codex、Gemini CLI、OpenCode 及 OpenClaw 等 AI 编程 CLI 的配置与切换。以下从下载、安装、使用及常见问题等方面进行详细介绍：

下载

访问 CC-Switch | 下载 |： https://pan.quark.cn/s/d6152047213b

安装

• Windows
  • MSI 安装版（推荐）：双击下载的 .msi 文件，若遇系统验证，点击「更多信息」-「仍要运行」，按向导默认路径安装，完成后可选择启动软件。
  • 便携版：下载 .zip 压缩包，解压到无中文、无空格路径，运行 cc-switch.exe 即可。
• macOS

  • DMG 镜像（推荐）：打开 .dmg 文件，将 CC-Switch.app 拖入「Applications」文件夹。首次打开若提示无法验证开发者，前往「系统设置」-「隐私与安全性」，点击「仍然打开」。

  • Homebrew 安装：打开终端，执行命令：

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

• Linux
  • Debian/Ubuntu 系列：下载 .deb 包，终端进入安装包目录，执行：

  sudo dpkg -i CC-Switch-v{版本}-Linux-x86_64.deb
  sudo apt -f install -y
  

  • AppImage 通用版：下载 .AppImage 文件，终端进入目录，执行：

  chmod +x CC-Switch-v{版本}-Linux-x86_64.AppImage
  ./CC-Switch-v{版本}-Linux-x86_64.AppImage
  

使用方法

• 首次启动：启动后软件会自动扫描本地已安装的 AI CLI 工具配置，若有已存在的配置，可点击「导入」。主界面顶部为 CLI 工具标签页，中间是供应商列表，右上角有「+」添加按钮。

• 添加供应商

  • 预设供应商（推荐）：点击右上角「+」-「Add Provider」，在「Preset（预设）」下拉框选择供应商，填入 API Key，自定义供应商名称，点击「Add」。
  • 自定义供应商：点击「+」-「Custom（自定义）」，填写供应商名称、API 端点、API 密钥、模型等信息，点击「Add」。

• 切换与启用供应商：在供应商列表中，点击目标供应商右侧的「Enable（启用）」按钮，状态变为「Active（活跃）」即切换成功。Claude Code 支持热切换，其他工具需重启终端生效。也可通过系统托盘右键快速切换。

• 配置验证：切换供应商后，在 CLI 工具中输入测试指令，如 hello, please introduce yourself，若能正常返回响应，则配置成功。

高级功能

• 多工具独立配置：通过顶部标签页，可为 Claude、Codex、Gemini 等不同工具单独添加供应商，配置互不冲突。
• MCP 服务器统一管理：进入「MCP」标签页，可导入已有或新建 MCP 服务器，支持 stdio、HTTP、SSE 三种协议，一次配置可同步到所有支持的 CLI 工具。
• Skills 一键安装：切换到「Skills」标签页，软件自动扫描公开 Skills 仓库，勾选需要的 Skills 点击「安装」，可自动同步到 Claude Code 的 Skills 目录。
• Prompts 管理：用 Markdown 编辑系统提示词模板，按不同 CLI 工具绑定对应提示词，一键切换启用。
• API 测速与配置备份：供应商列表中可查看节点延迟，自动优选最低延迟节点；软件自动保留最近 10 个版本的配置文件，支持手动导出/导入。

常见问题及解决方案

• 切换供应商后配置不生效：重启对应 CLI 工具的终端（Claude Code 除外）；检查 Base URL 末尾无多余斜杠。
• Windows 软件启动失败、白屏：更换便携版，解压到无中文、无空格的路径；删除 cc-switch.db 文件，重启软件重新配置。
• 配置损坏、丢失：从 ~/.cc-switch/backups/ 目录恢复备份；或删除 cc-switch.db 文件，重启软件重新添加配置。