🎆U-Claude Code一键接入国内大模型技术教程

admin 2026-08-11 2,558 阅读 收藏

🔌 CC-Switch 是什么?
CC-Switch 是一个大模型协议网关,它让 Claude Desktop 可以通过统一接口调用硅基流动、DeepSeek、Kimi 等国内 AI 平台的大模型。
简单来说:没有 CC-Switch,Claude Desktop 无法调用国内的大模型。


🚀 第一步:启动 CC-Switch

操作步骤:
  1. 双击运行U-Claude-Windows控制台.exe
  2. 在主菜单输入 3大模型配置接入)回车
  3. 自动启动 CC-Switch 网关并打开配置教程页面
💡 提示:CC-Switch 需要保持后台运行,关闭后 Claude 将无法调用大模型。
📸 截图1:控制台主菜单,输入 3 回车
📸 截图2:CC-Switch 主界面

➕ 第二步:添加供应商

操作步骤:
  1. 点击 CC-Switch 右上角 「+」 按钮
  2. 在弹出的窗口中,选择预设供应商,例如选择 「SiliconFlow」
  3. 硅基流动官方注册送16元新人券https://cloud.siliconflow.cn/i/vJeRma7K
  4. 如果没有预设,选择「自定义」手动填写
📸 截图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

🔄 第四步:设置模型映射(关键)

操作步骤:
  1. 在供应商编辑界面,找到 「模型映射」 表格
  2. 开启本地「路由映射」按钮
  3. 填写映射关系:菜单显示名 = 实际请求模型
菜单显示名 实际请求模型
Qwen/Qwen2.5-7B-Instruct Qwen/Qwen2.5-7B-Instruct
📸 截图6:模型映射设置

🌐 第五步:开启本地路由

操作步骤:
  1. 点击 CC-Switch 左上角 「设置」 齿轮图标
  2. 选择 「路由」 选项卡
  3. 开启 「本地路由」 开关
📸 截图7:设置 → 路由 → 开启本地路由

🔛 第六步:启用供应商

操作步骤:
  1. 返回供应商列表,确保供应商右侧的开关为开启状态
  2. 状态指示灯为绿色,表示连接正常
📸 截图8:供应商已启用(绿色指示灯)

🖥️ 第七步:在 Claude Desktop 内配置 3P 网关(关键步骤)

这是 U-Claude 独有的配置步骤:

CC-Switch 配好后,还需要在 Claude Desktop 内部开启开发者模式才能接入网关。

  1. 打开 Claude Desktop
  2. 点击菜单栏:帮助 → 故障排除 → 启用开发者模式
  3. 左侧菜单出现「开发者」选项,点击进入
  4. 找到 「配置第三方推理」(3P Gateway)
  5. 填写以下内容:
    Gateway base URL: http://127.0.0.1:15721
    API Key: 从 CC-Switch 获取的网关密钥
    模型列表: 逗号分隔,如 claude-sonnet-4-6, gpt-5.6-sol
  6. 点击「本地应用」,Claude 自动重启
  7. 重启后,在 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 重启,模型选择器出现配置的模型

✅ 第八步:验证配置

操作步骤:
  1. 在 Claude 对话界面,点击模型选择器
  2. 确认能看到配置的国内大模型
  3. 选择一个模型,发送测试消息如”你好”
  4. 确认收到 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 现在可以调用国内大模型了!

📢 如有其他问题,请联系技术支持