CC-Switch 安装与使用完全指南

一款帮你轻松切换 Claude Code / Codex / Gemini API 配置的桌面工具

一、前置知识

在阅读本文之前，你需要了解以下背景：

• Claude Code：Anthropic 推出的 AI 编程助手
• Codex：OpenAI 的编程辅助工具
• Gemini CLI：Google 的 AI 命令行工具
• API Key：调用这些 AI 服务的凭证

本文面向需要在多平台或多账号间切换 AI 服务的开发者。

二、核心概念

什么是 CC-Switch？

CC-Switch 是一款开源桌面应用程序（基于 Tauri + React 开发），用于管理 Claude Code、Codex 和 Gemini CLI 的 API 配置。它的核心功能是：

• 一键切换：在不同 AI 服务商之间快速切换
• MCP 服务器管理：统一管理多个 MCP 扩展
• Skills 管理：安装和管理 Claude Code 技能
• Prompts 管理：自定义系统提示词预设
• 云同步：支持跨设备配置同步

三、工作原理

配置文件位置

CC-Switch 通过修改各客户端的配置文件来实现切换：

graph TD
    A[CC-Switch 应用] --> B[修改配置文件]
    B --> C[Claude Code: ~/.claude/settings.json]
    B --> D[Codex: ~/.codex/auth.json]
    B --> E[Gemini: ~/.gemini/.env]
    F[用户重启终端] --> G[新配置生效]
    C --> G
    D --> G
    E --> G

支持的 API 配置字段

四、安装步骤（Windows 傻瓜式流程）

第一步：下载安装包

1. 打开浏览器，访问 GitHub Releases 页面：

   https://github.com/farion1231/cc-switch/releases
   

2. 找到最新版本（当前 v3.10.2）

3. 下载 CC-Switch-v{版本号}-Windows.msi 或 CC-Switch-v{版本号}-Windows-Portable.zip

第二步：运行安装

安装版（.msi）：

1. 双击 .msi 文件
2. 点击"下一步" → "我同意" → "下一步"
3. 选择安装路径（默认即可）
4. 点击"安装" → "完成"

绿色版（.zip）：

1. 右键 .zip 文件 → "解压到当前文件夹"
2. 双击 CC-Switch.exe 启动

第三步：首次启动

1. 启动 CC Switch
2. 程序自动检测电脑上已安装的 Claude Code / Codex / Gemini 配置
3. 首次启动会自动导入现有配置作为默认供应商

五、基本使用

添加供应商

1. 点击"添加供应商"
2. 选择预设（如 OpenAI、Anthropic 等）或创建自定义配置
3. 填写 API Key 和其他必要信息

切换供应商

• 主界面：选择供应商 → 点击"启用"
• 系统托盘：直接点击供应商名称（立即生效）

重启终端

切换后需要重启终端或对应的 AI 客户端，新配置才会生效。

恢复官方登录

选择"官方登录"预设（Claude/Codex）或"Google 官方"预设（Gemini），重启后按照官方登录流程操作。

六、MCP 管理

功能位置

点击右上角"MCP"按钮

添加 MCP 服务器

1. 使用内置模板（mcp-fetch、mcp-filesystem 等）
2. 支持三种传输类型：stdio / http / sse

管理方式

• 启用/禁用：切换开关控制同步
• 同步：启用的服务器自动同步到 live 配置
• 导入/导出：支持从现有配置文件导入

七、Skills 管理（v3.7.0+）

功能位置

点击右上角"Skills"按钮

操作流程

1. 发现技能：自动扫描预配置 GitHub 仓库
2. 添加仓库：支持自定义仓库（可扫描子目录）
3. 安装：点击"安装"一键安装到 ~/.claude/skills/
4. 卸载：点击"卸载"安全移除

八、Prompts 管理（v3.7.0+）

功能位置

点击右上角"Prompts"按钮

使用方式

1. 创建预设：使用 Markdown 编辑器（语法高亮 + 实时预览）
2. 激活预设：选择预设 → 点击"激活"
3. 同步目标：
   • Claude：~/.claude/CLAUDE.md
   • Codex：~/.codex/AGENTS.md
   • Gemini：~/.gemini/GEMINI.md

保护机制

切换前自动保存当前提示词内容，保留手动修改。

九、云同步设置

1. 前往设置 → "自定义配置目录"
2. 选择云同步文件夹（Dropbox、OneDrive、iCloud、坚果云等）
3. 重启应用
4. 在其他设备上重复操作

十、数据存储

总结要点

1. 安装简单：下载 .msi 或 .zip 即可使用
2. 多平台支持：Claude Code、Codex、Gemini CLI
3. 功能丰富：MCP 管理、Skills 管理、Prompts 管理
4. 云同步：支持主流云盘跨设备同步
5. 免费开源：基于 Tauri + React + Rust 开发

官方 GitHub：https://github.com/farion1231/cc-switch