CC Switch 配置 Claude Desktop

用 CC Switch 配置 Claude Desktop 接入第三方 API,支持模型名字映射。

Claude Desktop 只接受 Claude 风格的模型名,用第三方 API 必须做模型映射。CC Switch 帮你自动完成这一步。

开始前先准备好

  • 下载 CC Switch
  • Dogzee API密钥(如果还没有,先去看 创建API密钥)
  • 已安装 Claude Desktop(下载地址,点击 Get Claude Code 旁的下拉图标选择桌面端)

关键地址: https://ergouzi.life(不需要加 /v1)

配置流程

  1. 添加供应商,填写基本信息
  2. 填写 API Key 和请求地址
  3. 开启模型映射并配置模型
  4. 测试并启用
  5. 在 Claude Desktop 中验证

第一步:添加供应商

进入 CC Switch,点击右上角 +,选择 自定义配置,供应商名称填 dogzee(或其他你方便识别的名字)。

CC Switch 添加新供应商 - 自定义配置与供应商名称

第二步:填写 API Key 和请求地址

最关键的三项:

  • API Key:你的 Dogzee API密钥
  • 请求地址:https://ergouzi.life
  • API 格式:保持默认的 Anthropic Messages(原生)

地址不要加 /v1,CC Switch 会自动拼接。

填完后点击 获取模型列表,看到绿色提示「获取到 N 个模型」说明地址和 Key 都没问题。

填写 API Key 和请求地址,获取模型列表

第三步:配置模型映射

如果要使用Claude之外的模型,这一步必须做。 Claude Desktop 只认 Claude 自家模型名,CC Switch 会把你选的模型映射过去。

打开 需要模型映射 开关,然后按下面的方式配置三个角色:

模型角色菜单显示名实际请求模型
Sonnetgpt-5.4gpt-5.4
Opusgpt-5.5gpt-5.5
Haikugpt-5.4-minigpt-5.4-mini

菜单显示名可以自由改,实际请求模型从下拉列表里选你想用的。

配置 Claude 模型,可跳过映射这一步,直接选择模型列表中的 Claude 模型即可。

模型映射配置 - 选择实际请求模型

第四步:测试并启用

回到供应商列表,先点 测试,再点 启用。

如果是使用 Claude 之外的模型,确认左上角的 本地路由开关 已打开(绿色状态),这个不开模型映射不生效。

测试与启用,确保本地路由开启

第五步:验证

打开 Claude Desktop,发一条消息,确认能正常回复。右下角可以切换模型,显示的就是你配置的映射名。

Claude Desktop 成功对话与模型切换

排错

  • 获取模型列表失败 → 检查 API Key 是否完整,地址是否为 https://ergouzi.life
  • 模型映射不生效 → 确认本地路由开关已打开
  • 测试通过但 Claude Desktop 不能用 → 检查 CC Switch 是否为最新版本,或回退到稳定版
  • 对话报模型名错误 → 回到供应商编辑页,重新配置模型映射
  • 模型返回 503 → 模型广场确认当前API密钥分组是否支持该模型