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 通过修改各客户端的配置文件来实现切换：
支持的 API 配置字段
客户端 | 配置文件 | API Key 字段 |
|---|---|---|
Claude Code | ~/.claude/settings.json | env.ANTHROPIC_AUTH_TOKEN / env.ANTHROPIC_API_KEY |
Codex | ~/.codex/auth.json | OPENAI_API_KEY |
Gemini | ~/.gemini/.env | GEMINI_API_KEY / GOOGLE_GEMINI_API_KEY |
四、安装步骤（Windows 傻瓜式流程）
第一步：下载安装包
打开浏览器，访问 GitHub Releases 页面：
BASHhttps://github.com/farion1231/cc-switch/releases COPY找到最新版本（当前 v3.10.2）
下载
CC-Switch-v{版本号}-Windows.msi或CC-Switch-v{版本号}-Windows-Portable.zip
第二步：运行安装
安装版（.msi）：
双击
.msi文件点击"下一步" → "我同意" → "下一步"
选择安装路径（默认即可）
点击"安装" → "完成"
绿色版（.zip）：
右键
.zip文件 → "解压到当前文件夹"双击
CC-Switch.exe启动
第三步：首次启动
启动 CC Switch
程序自动检测电脑上已安装的 Claude Code / Codex / Gemini 配置
首次启动会自动导入现有配置作为默认供应商
五、基本使用
添加供应商
点击"添加供应商"
选择预设（如 OpenAI、Anthropic 等）或创建自定义配置
填写 API Key 和其他必要信息
切换供应商
主界面：选择供应商 → 点击"启用"
系统托盘：直接点击供应商名称（立即生效）
重启终端
切换后需要重启终端或对应的 AI 客户端，新配置才会生效。
恢复官方登录
选择"官方登录"预设（Claude/Codex）或"Google 官方"预设（Gemini），重启后按照官方登录流程操作。
六、MCP 管理
功能位置
点击右上角"MCP"按钮
添加 MCP 服务器
使用内置模板（mcp-fetch、mcp-filesystem 等）
支持三种传输类型：stdio / http / sse
管理方式
启用/禁用：切换开关控制同步
同步：启用的服务器自动同步到 live 配置
导入/导出：支持从现有配置文件导入
七、Skills 管理（v3.7.0+）
功能位置
点击右上角"Skills"按钮
操作流程
发现技能：自动扫描预配置 GitHub 仓库
添加仓库：支持自定义仓库（可扫描子目录）
安装：点击"安装"一键安装到
~/.claude/skills/卸载：点击"卸载"安全移除
八、Prompts 管理（v3.7.0+）
功能位置
点击右上角"Prompts"按钮
使用方式
创建预设：使用 Markdown 编辑器（语法高亮 + 实时预览）
激活预设：选择预设 → 点击"激活"
同步目标：
Claude：
~/.claude/CLAUDE.mdCodex：
~/.codex/AGENTS.mdGemini：
~/.gemini/GEMINI.md
保护机制
切换前自动保存当前提示词内容，保留手动修改。
九、云同步设置
前往设置 → "自定义配置目录"
选择云同步文件夹（Dropbox、OneDrive、iCloud、坚果云等）
重启应用
在其他设备上重复操作
十、数据存储
类型 | 位置 |
|---|---|
数据库 | ~/.cc-switch/cc-switch.db（SQLite） |
本地设置 | ~/.cc-switch/settings.json |
自动备份 | ~/.cc-switch/backups/（保留10个） |
总结要点
安装简单：下载 .msi 或 .zip 即可使用
多平台支持：Claude Code、Codex、Gemini CLI
功能丰富：MCP 管理、Skills 管理、Prompts 管理
云同步：支持主流云盘跨设备同步
免费开源：基于 Tauri + React + Rust 开发
官方 GitHub：https://github.com/farion1231/cc-switch
