【经验分享】Claude Desktop通过CC Switch接入第三方模型,和模型为空排错经验

[jackcmd-dev]

Claude Desktop 接入自定义模型：CC Switch 配置与排错指南

Claude Desktop 接入 GLM、DeepSeek、Kimi 等自定义模型，可以使用 CC Switch 的模型映射与本地路由。配置后若仍无法连接，尤其是在 Windows 商店版中，需要检查：CC Switch 写入的配置文件，是否与 Claude Desktop 实际读取的文件一致。

本文基于 Windows 环境的一次实际排查整理。界面名称和配置位置可能随版本变化；文中的路径用于核对，不代表所有安装方式都使用相同目录。

一、理解连接方式

连接链路为：

Claude Desktop
    ↓ Claude 角色路由
CC Switch 本地网关
    ↓ 映射为真实模型 ID，必要时转换请求格式
自定义模型供应商

Desktop 看到的是可识别的 Claude 角色路由；实际调用的 GLM、DeepSeek 等模型名称保存在 CC Switch 中。直接在 Desktop 的模型列表里填写非 Claude 模型 ID，可能触发“Doesn’t look like an Anthropic model”校验错误。

这属于第三方工具提供的接入方案，不等同于 Anthropic 官方支持非 Claude 模型。

二、在 CC Switch 中配置供应商

1. 打开 CC Switch，选择 Claude Desktop 页面。

2. 添加自定义供应商，填写名称、上游接口地址和 API Key。

3. 根据供应商实际支持的协议选择上游格式，例如 Anthropic Messages 或 OpenAI Chat Completions。

4. 选择 模型映射，或打开“需要模型映射”。

接口地址必须与协议配套。例如供应商明确提供 Anthropic 兼容入口时，使用该入口；不要把 OpenAI 兼容地址与 Anthropic 协议混用。具体是否需要 /v1、/compatible 等路径，以供应商说明为准。

模型映射示例：

真实模型 ID 必须保持供应商要求的大小写和拼写。

“声明支持 1M”只在确认该供应商部署支持 1M 上下文时勾选。 它不会提升实际容量；例如部署只支持 262144 Token，就不要声明 1M。

保存后，在供应商卡片上点击 启用／切换，确认路由服务运行。完全退出并重新打开 Claude Desktop，使用期间保持 CC Switch 运行。

三、Cluade Desktop 配置，启用第三方模型

1、打开Cluade Desktop后再help菜单-》在Troubleshooting子菜单-》enable develop ，然后重启desktop就会出现develop菜单：

2、点击配置第三方模型，检查是否配置成了网关模式，网关地址是否配置成功，url要带claude-desktop后缀
如下图，如果不对就手动改一下，保存并应用

模型映射模式下，CC Switch 文档给出的默认网关地址为：

http://127.0.0.1:15721/claude-desktop

端口可能因本机设置不同而变化。应优先让 CC Switch 自动维护地址、模型列表和凭据。

注意区分两套密钥：

位置	使用的凭据
CC Switch 中的上游供应商	供应商 API Key
Desktop 连接 CC Switch 本地网关	CC Switch 生成的本地 token

不要把上游供应商的 API Key 手动填入 Desktop 的本地网关配置。

四、检查是否可用，如果不行，按第五章检查下配置，我就是这个坑导致的失败

五、如果启动报错说模型为空，那可能是calude desktop没有读取CC改的配置文件，需要手动拷贝复制一下配置目录

本次排查发现，CC Switch 写入的目录是：

%LOCALAPPDATA%\Claude-3p\configLibrary

而 Claude Desktop 实际读取的目录是：

%LOCALAPPDATA%\Packages\Claude_pzs8sxrjxfjjc\LocalCache\Local\Claude-3p\configLibrary

两份目录中可能同时存在同名文件，但内容不同。这会导致 CC Switch 显示已配置，Desktop 却仍使用旧地址、旧 token 或空模型列表。

重点核对两个文件：

00000000-0000-4000-8000-000000157210.json
_meta.json

前者是 CC Switch 管理的配置；后者记录配置库信息及当前应用的配置 ID。核对内容包括：

• inferenceGatewayBaseUrl 是否指向正确的本地网关。
• inferenceGatewayApiKey 是否与 CC Switch 当前 token 一致，只在本机比较，不要公开。
• inferenceModels 是否包含生成的角色模型。
• _meta.json 的 appliedId 是否指向 CC Switch 配置。

确认不一致后如何修复

1. 完全退出 Claude Desktop。
2. 在 CC Switch 中保存并重新启用模型映射供应商，确保源配置为最新内容。
3. 将 Desktop 实际目录中的上述两个文件备份到配置库以外的位置。
4. 将 CC Switch 源目录中的上述两个文件复制到 Desktop 实际目录，替换同名文件。
5. 重新启动 Desktop；如需选择配置，选择 CC Switch。
6. 测试连接，再新建 Code 会话验证实际模型调用。

参考：CC Switch 官方项目中的 Claude Desktop 使用文档。