CC Switch（桌面版）安装使用指南

bug制造者阿杜
12 阅读4分钟

CC Switch（桌面版）安装使用指南

工具简介

CC Switch 是开源跨平台桌面工具，核心功能是将 Claude Code、Codex、Gemini CLI 等 AI 编程 CLI 的 API 供应商配置统一管理。支持一键切换模型、全局管理 MCP 服务器、批量安装 Skills。

功能说明
供应商管理添加、编辑、删除多个 API 供应商，一键切换
系统托盘常驻右下角，右键菜单秒切模型
MCP 统一管理跨 CLI 统一管理 MCP 服务器（stdio/HTTP/SSE）
Skills 管理从 GitHub 一键安装 Claude Skills
Prompts 管理多套系统提示词预设，一键同步到 CLAUDE.md

目前支持的 CLI 工具：Claude Code、Codex、OpenCode、Gemini CLI、OpenClaw。

一、安装

macOS（推荐 Homebrew）

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

首次打开若提示无法验证开发者，前往「系统设置 → 隐私与安全性」点击「仍要打开」即可。

Windows

从 GitHub Releases 下载 .msi 安装包，双击安装。如遇 SmartScreen 提示，点「更多信息 → 仍要运行」。

Linux

# Ubuntu/Debian
wget https://github.com/farion1231/cc-switch/releases/latest/download/cc-switch_*.deb
sudo dpkg -i cc-switch_*.deb

# Arch Linux
paru -S cc-switch-bin

二、切换模型（添加供应商）

2.1 添加 API 供应商

  1. 启动 CC Switch，点击右上角 「+」 按钮
  2. 选择预设模板（内置 50+ 供应商，如 DeepSeek、GLM、MiniMax、Kimi 等），或创建自定义配置
  3. 填写配置：
    • Provider Name：自定义名称
    • Base URL：API 端点地址（末尾不要加斜杠）
    • API Key：你的密钥
  4. 点击「Add」保存

2.2 以 weecoding 为例

字段填写内容
Provider Nameweecoding
Base URLhttps://api.weecoding.com
API Keysk-你的密钥

2.3 启用配置

供应商列表中找到刚添加的配置，点击 「Enable」，状态变为「Active」即生效。工具会自动写入对应 CLI 的配置文件（如 ~/.claude/settings.json）。

2.4 验证生效

# 完全退出并重启 Claude Code 终端
claude

随便问一句话，能正常回复即配置成功。如有问题可点击供应商旁的「健康检查」按钮排查。

2.5 快速切换技巧

右键点击系统托盘图标，直接选择要使用的供应商，无需打开主窗口。

三、绑定/关联项目模型

CC Switch 本身不通过项目绑定模型，而是通过全局切换机制管理：

  1. 分组管理：主界面顶部可切换分组（Claude / Codex / Gemini），不同 CLI 工具可独立配置供应商
  2. 多工具共用：同一供应商配置可同时应用到多个 CLI 工具，无需重复设置
  3. 配置导入：若之前手动配置过 ~/.claude/settings.json，CC Switch 启动时会自动检测并导入

切换供应商后需重启对应 CLI 终端，配置才会完全生效。

四、全局安装 Skills

  1. 点击右上角 「Skills」 标签页
  2. 工具自动扫描 GitHub 上的公开 Skills 仓库（包括 Anthropic 官方、ComposioHQ、社区等）
  3. 找到需要的 Skill，勾选即可一键安装，自动同步到 ~/.claude/skills/
  4. 支持添加自定义 GitHub 仓库扫描

推荐 Skills：code-review（代码审查）、commit-commands（规范化提交）、frontend-design（前端界面设计）、playwright（浏览器自动化）

五、全局管理 MCP

  1. 点击右上角 「MCP」 标签页
  2. 点击 「导入已有」 可导入已通过 Claude 插件安装的 MCP
  3. 或点击 「添加」 新建 MCP 服务器，支持 stdio、HTTP、SSE 三种协议
  4. 内置模板包括：memory、filesystem、github、puppeteer、web-search、context7 等

关键特性：一次配置后，Claude Code、Codex、Gemini CLI 等多个工具可共用同一份 MCP 配置，无需分别设置。

六、常见问题与技巧

切换后模型不生效？

Claude Code 启动时读取配置，切换供应商后需完全退出并重启终端（建议 Ctrl+C 终止进程后重新运行 claude）。

Base URL 末尾不要加斜杠

错误：https://api.weecoding.com/ → 正确：https://api.weecoding.com 加斜杠会导致 API 路径拼接出现双斜杠，引发请求失败。

清除旧环境变量

使用第三方 API 供应商前，建议清除可能冲突的 Anthropic 官方环境变量：

unset ANTHROPIC_AUTH_TOKEN
unset ANTHROPIC_BASE_URL

Windows 用户名含中文

数据库文件路径为 %USERPROFILE%\.cc-switch\，中文路径可能引发启动报错。可使用便携版（.zip）绕开安装路径限制。

配置备份

所有供应商配置保存在 ~/.cc-switch/cc-switch.db，重装前建议备份此文件。

avatar
文章
阅读
粉丝