什么是 CC-Switch
CC-Switch 是一款跨平台的桌面应用程序，专为管理 AI 编程助手而设计。它支持一键切换 Claude Code、Codex 和 Gemini CLI 三大 AI 编程工具的 API 配置。
简单来说，CC-Switch 解决了一个核心痛点：官方 Claude API 太贵，国产中转站点、公益站点稳定不高，需要在多个站点中频繁切换。有了 CC-Switch，你可以：
- 一键切换不同的 API 供应商，支持 Claude Code 运行中动态切换
- 可视化管理所有配置
- 统一管理 MCP 服务器、Skills 和系统提示词
- 支持 GLM、DeepSeek、Kimi 等国产模型
核心功能
1. 供应商管理
支持在多个 API 端点之间无缝切换：
- Claude Code：官方 API 或第三方中转服务
- Codex：OpenAI API 配置
- Gemini CLI：Google Gemini API 配置
每个供应商配置包括 API Key、Base URL 等信息，切换只需一键。
2. MCP 服务器管理
通过统一界面配置和管理 Model Context Protocol 服务器：
- 支持 stdio、HTTP、SSE 传输类型
- 跨应用统一配置
- 可视化管理界面
3. Skills 系统
自动扫描 GitHub 仓库发现 Claude Skills：
- 一键安装/卸载技能到
~/.claude/skills/ - 支持多仓库扫描
- 递归目录扫描
4. 提示词管理
创建和管理系统提示词预设：
- 内置 Markdown 编辑器
- 实时预览
- 快速切换不同场景预设
5. 系统集成
- 系统托盘快速切换
- 开机自启动
- 内置自动更新
- 原子写入与回滚保护
系统要求
| 平台 | 最低版本 |
|---|---|
| Windows | 10+ |
| macOS | 10.15+ |
| Linux | Ubuntu 22.04+ / Debian 11+ / Fedora 34+ |
安装方法
Windows
下载 MSI 安装包或便携版 ZIP：
1 | https://github.com/farion1231/cc-switch/releases |
macOS
推荐使用 Homebrew 安装：
1 | brew tap farion1231/ccswitch |
首次运行可能需要在「系统设置 > 隐私与安全性」中允许应用。
Linux
Arch Linux：
1 | paru -S cc-switch-bin |
Ubuntu/Debian：
下载 DEB 包或 AppImage 安装。
快速上手
第一步：添加供应商
- 启动 CC-Switch 应用
- 点击「添加供应商」按钮
- 选择预设模板或自定义配置
第二步：配置 API
以配置智谱 GLM 为例：
- 在供应商分组中选择「Claude」
- 填入从智谱开放平台获取的 API Key
- 设置 Base URL：
https://open.bigmodel.cn/api/paas/v4 - 点击「添加」保存配置
第三步：启用配置
- 在主界面右侧找到刚添加的配置
- 点击「启用」按钮
- 状态显示「使用中」即配置成功
第四步：验证
重启终端，运行 Claude Code：
1 | claude |
看到正常的对话界面并能回复，说明配置成功！
配置文件位置
CC-Switch 会修改以下配置文件：
| 应用 | 配置文件 | 关键变量 |
|---|---|---|
| Claude Code | ~/.claude/settings.json |
ANTHROPIC_AUTH_TOKEN |
| Codex | ~/.codex/auth.json |
OPENAI_API_KEY |
| Gemini | ~/.gemini/.env |
GEMINI_API_KEY |
应用数据存储在：~/.cc-switch/cc-switch.db（SQLite 格式），自动保留最近 10 个备份版本。
支持的国产模型
CC-Switch 内置了多个国产大模型的预设配置：
| 模型 | 供应商 | 特点 |
|---|---|---|
| GLM-4 | 智谱 AI | 性价比高，中文能力强 |
| DeepSeek | 深度求索 | 代码能力出色 |
| Kimi K2 | 月之暗面 | 长文本处理优秀 |
| MiniMax | MiniMax | 多模态支持 |
高级功能
深度链接协议
支持 ccswitch:// 协议进行配置分享，方便团队协作。
环境变量冲突检测
自动检测跨应用的环境变量冲突，避免配置混乱。
VS Code 插件集成
CC-Switch 的配置可以同步应用到 VS Code 的 Claude Code 插件：
- 安装 Claude Code for VS Code 插件
- 在 CC-Switch 中配置好 API
- 插件会自动读取相同的配置
常见问题
Q: 切换后不生效怎么办？
需要重启终端或 Claude Code 才能使配置生效。
Q: 如何备份配置？
CC-Switch 自动保留最近 10 个版本的配置备份，也可以手动导出配置。
Q: 支持哪些语言？
目前支持中文、英文、日文三种语言界面。
Q: 是否安全？
CC-Switch 采用原子写入机制，配置变更前会自动备份，支持一键回滚。API Key 等敏感信息仅存储在本地。
技术架构
CC-Switch 采用现代化技术栈：
- 前端：React 18 + TypeScript + Vite + TailwindCSS
- 后端：Tauri 2.8 + Rust + tokio
- 存储：SQLite + JSON 双层架构
- 测试：vitest + MSW + @testing-library/react