CC-Switch保姆式使用教程｜安装+配置+实战案例(最新版)

yiren22

230人浏览 · 2026-06-24 22:49:36

yiren22 · 2026-06-24 22:49:36 发布

一个开源免费的跨平台桌面工具，把 Claude Code、Codex、Gemini CLI 的 API Key 和模型供应商管到一个界面里，一键切换。

文章目录

资源下载

步骤	CC Switch 做了什么
win	点击扫码下载（夸克网盘）
mac	点击扫码下载（夸克网盘）
Linux	点击扫码下载（夸克网盘）

在这里插入图片描述

一、这篇文章解决什么问题

当下 AI 编程工具层出不穷——Claude Code、Codex、Gemini CLI、OpenCode……每换一个工具，就要重新折腾一遍 API Key、Base URL 和模型配置。更别提当你同时使用多个工具、在不同模型供应商之间来回切换时，配置文件散落各处，改一个参数得翻好几个目录，稍不留神就串了。

CC Switch 就是为这个场景设计的：它是一个开源的可视化配置管理中心，支持 Windows、macOS、Linux，把多工具、多 API Key、多模型供应商的配置集中到一个图形界面里，点一下就能切换。

二、快速上手（3 步跑通）

Step 1：添加供应商

打开 CC Switch，切换到顶部的 「Claude Code」 标签页，点击右上角 「+」 新建供应商。在预设列表里选择你要用的模型服务商（比如 DeepSeek），填入你的 API Key 即可——接口地址、默认模型等参数官方已经预设好了。

添加供应商

Step 2：启动配置

需要用哪个模型就启动哪个配置，界面里一键操作。

启动配置

Step 3：重启 Claude

完全退出 Claude Code（不是只关窗口），然后重新打开。发一条消息测试一下——如果收到正常回复，说明对接成功。

重启Claude测试

三、关键配置说明

3.1 CC Switch 是怎么工作的

步骤	CC Switch 做了什么
1. 配置文件改写	自动将 Codex 的配置指向 `http://127.0.0.1:15721/v1`，并锁定 `wire_api = "responses"`，让 Codex 认为自己始终在和标准 Responses API 通信
2. 格式标记	Provider 配置中的 `meta.apiFormat = "openai_chat"` 告诉路由层：上游的真实接口是 Chat Completions
3. 请求转发与改写	路由拦截 `/responses` 路径，映射为 `/chat/completions`，同时把请求体从 Responses 格式转换成 Chat 格式
4. 响应回译	上游返回的 Chat 格式响应（JSON 或 SSE 流），由路由层重新组装成 Codex 能解析的 Responses 格式

3.2 配置生效后的 json 示例

{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "xxxxxxxxx",
    "ANTHROPIC_BASE_URL": "xxxxxx",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "deepseek-v4-pro(模型名)",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "deepseek-v4-pro",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "deepseek-v4-pro",
    "ANTHROPIC_MODEL": "deepseek-v4-pro",
    "ANTHROPIC_REASONING_MODEL": "deepseek-v4-pro",
    "CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS": 1
  },
  "model": "deepseek-v4-pro(模型名)"
}

⚠️ 注意：模型名要跟你的供应商实际支持的模型名称严格一致，建议先去供应商文档确认，不要自己编。

3.3 CC Switch 的核心优势

优势	说明
可视化配置	图形界面管理 MCP 服务器、环境变量和提示词模板，不需要手写配置
命令行 + MCP 生态	保留 CLI 的灵活性，同时享受图形化工具的便捷
配置备份与恢复	支持一键导出/导入配置，换电脑或团队共享都很方便
Skills 提效	可视化快速配置和使用 Claude Agent Skills