🔌 CC-Switch 是什么?
CC-Switch 是一个大模型协议网关,它让 Claude Desktop 可以通过统一接口调用硅基流动、DeepSeek、Kimi 等国内 AI 平台的大模型。
简单来说:没有 CC-Switch,Claude Desktop 无法调用国内的大模型。
CC-Switch 是一个大模型协议网关,它让 Claude Desktop 可以通过统一接口调用硅基流动、DeepSeek、Kimi 等国内 AI 平台的大模型。
简单来说:没有 CC-Switch,Claude Desktop 无法调用国内的大模型。
📑 本文目录
🚀 第一步:启动 CC-Switch
操作步骤:
- 双击运行
U-Claude-Windows控制台.exe - 在主菜单输入 3(大模型配置接入)回车
- 自动启动 CC-Switch 网关并打开配置教程页面
💡 提示:CC-Switch 需要保持后台运行,关闭后 Claude 将无法调用大模型。
📸 截图1:控制台主菜单,输入 3 回车
📸 截图2:CC-Switch 主界面
➕ 第二步:添加供应商
操作步骤:
- 点击 CC-Switch 右上角 「+」 按钮
- 在弹出的窗口中,选择预设供应商,例如选择 「SiliconFlow」
- 硅基流动官方注册送16元新人券:https://cloud.siliconflow.cn/i/vJeRma7K
- 如果没有预设,选择「自定义」手动填写
📸 截图3:点击 + 按钮添加供应商
📸 截图4:选择 SiliconFlow 等预设供应商
⚙️ 第三步:配置 API 信息
配置项说明(以硅基流动为例):
| 字段 | 内容 | 说明 |
|---|---|---|
| 供应商名称 | SiliconFlow |
可自定义 |
| API Key | sk-xxxxxxxxxxxxx |
登录对应大模型平台→API密钥页获取 |
| Base URL | https://api.siliconflow.cn/v1 |
末尾必须有 /v1 |
| 模型 | Qwen/Qwen2.5-7B-Instruct |
可点击「获取模型列表」自动拉取 |
💡 提示:API Key 在大模型平台官网(硅基流动/DeepSeek等)注册后,在控制台→API 密钥页面获取。
📸 截图5:配置界面 – 填写 API Key 和 Base URL
🔄 第四步:设置模型映射(关键)
操作步骤:
- 在供应商编辑界面,找到 「模型映射」 表格
- 开启本地「路由映射」按钮
- 填写映射关系:菜单显示名 = 实际请求模型
| 菜单显示名 | 实际请求模型 |
|---|---|
| Qwen/Qwen2.5-7B-Instruct | Qwen/Qwen2.5-7B-Instruct |
📸 截图6:模型映射设置
🌐 第五步:开启本地路由
操作步骤:
- 点击 CC-Switch 左上角 「设置」 齿轮图标
- 选择 「路由」 选项卡
- 开启 「本地路由」 开关
📸 截图7:设置 → 路由 → 开启本地路由
🔛 第六步:启用供应商
操作步骤:
- 返回供应商列表,确保供应商右侧的开关为开启状态
- 状态指示灯为绿色,表示连接正常
📸 截图8:供应商已启用(绿色指示灯)
🖥️ 第七步:在 Claude Desktop 内配置 3P 网关(关键步骤)
这是 U-Claude 独有的配置步骤:
CC-Switch 配好后,还需要在 Claude Desktop 内部开启开发者模式才能接入网关。
- 打开 Claude Desktop
- 点击菜单栏:帮助 → 故障排除 → 启用开发者模式
- 左侧菜单出现「开发者」选项,点击进入
- 找到 「配置第三方推理」(3P Gateway)
- 填写以下内容:
Gateway base URL:http://127.0.0.1:15721
API Key: 从 CC-Switch 获取的网关密钥
模型列表: 逗号分隔,如 claude-sonnet-4-6, gpt-5.6-sol - 点击「本地应用」,Claude 自动重启
- 重启后,在 Claude 对话页面的模型选择器中即可看到配置的模型
⚠️ 关键提示
• Gateway base URL 末尾不要带 /v1/chat/completions,只需填
• 确保 CC-Switch 处于运行状态,否则 Claude 无法连接
• 配置完后 Claude 会自动重启,配置持久保存
• Gateway base URL 末尾不要带 /v1/chat/completions,只需填
http://127.0.0.1:15721• 确保 CC-Switch 处于运行状态,否则 Claude 无法连接
• 配置完后 Claude 会自动重启,配置持久保存
📸 截图9:Claude Desktop → 帮助 → 故障排除 → 启用开发者模式
📸 截图10:开发者 → 配置第三方推理
📸 截图11:填写 Gateway 地址、API Key 和模型列表
📸 截图12:点击”本地应用”后 Claude 重启,模型选择器出现配置的模型
✅ 第八步:验证配置
操作步骤:
- 在 Claude 对话界面,点击模型选择器
- 确认能看到配置的国内大模型
- 选择一个模型,发送测试消息如”你好”
- 确认收到 AI 的正常回复
📸 截图13:模型选择器中出现国内大模型
📸 截图14:发送消息后成功收到回复
🎉 恭喜!大模型配置完成!现在可以自由切换国内外模型,畅享中文版 Claude Desktop AI 助手!
❓ 常见问题解答
CC-Switch 启动后 Claude 仍调不了模型?
➜ 确保 CC-Switch 在后台运行(系统托盘有图标)
➜ 检查供应商开关是否为绿色启用状态
➜ 确认本地路由已开启
➜ 在主菜单输入「5」重启服务再试
找不到”开发者”菜单?
➜ 先执行:帮助 → 故障排除 → 启用开发者模式
➜ 启用后左侧菜单底部会出现”开发者”选项
第三方推理配置后无法连接?
➜ 检查 Gateway 地址是否正确:http://127.0.0.1:15721
➜ 确认 CC-Switch 正在运行(任务管理器查看 CC-Switch.exe)
➜ Gateway 地址末尾不需要 /v1
API Key 在哪里获取?
➜ 例如访问硅基流动 https://siliconflow.cn → 注册 → 控制台 → API 密钥 → 创建新密钥
➜ 新用户通常有免费额度,无需充值即可测试
➜ 其他平台类似,在各自官网获取
如何更换或添加更多模型?
➜ 在 CC-Switch 中再添加一个供应商即可
➜ Claude 侧无需重新配置,新模型会自动出现在模型列表中
🎉 恭喜!你已经完成了大模型配置!
Claude Desktop 现在可以调用国内大模型了!
📢 如有其他问题,请联系技术支持