在 CC Switch 中配置 Claude Desktop

2026-05-18 2026-05-18 约 2492 字预计阅读 11 分钟

前面聊过 cc switch 的基础用法，今天单独说一下 CC Switch 里 Claude Desktop 面板的配置。在 3.15.0 中加入的功能，专门用来给 Claude Desktop 这个官方桌面客户端接入第三方供应商。

CC Switch 中的「Claude」和「Claude Desktop」是两个不同的面板，分别对应 Claude Code（CLI）和 Claude Desktop（桌面客户端）。区别在于 Claude Desktop 用的是自己的 3P profile 配置，而不是 ~/.claude/settings.json，两个面板在图标右下角会有小标记区分。

功能说明

Claude Desktop 面板能做的事情很简单：

给 Claude Desktop 接入 Anthropic 兼容的第三方供应商
为 DeepSeek、Kimi、DouBao、OpenAI、Gemini 等非 Claude 模型配置模型映射
在 Claude Desktop 官方模式和第三方供应商之间一键切换

支持 macOS 和 Windows。Linux 暂时不能写入 Claude Desktop 的 3P 配置。切换供应商后需要重启 Claude Desktop 才能生效，它不会像 Claude Code 那样热加载。

另外有一点需要注意：Claude Desktop 的 3P profile 不走 CC Switch 的 MCP / Skills 同步，这些功能在桌面端是独立管理的。

快速上手

1. 切到 Claude Desktop 面板

左侧应用切换器里选择 Claude Desktop。

Claude Desktop 面板

如果没看到入口，去 设置 → 通用 → 应用可见性 里确认没有被隐藏。

2. 导入或添加供应商

从 Claude Code 一键导入（推荐）

大部分用户是先在 Claude Code 里配好了一堆供应商，然后才想把这些配置带到 Claude Desktop 里。第一次进入 Claude Desktop 面板时，如果这里还没有供应商，直接点 将 Claude Code 中已有的供应商导入 就行。

从 Claude Code 导入供应商

这个功能会帮你把 Claude Code 那边的供应商配置一键搬过来，不用重新填接口地址、API Key 和默认模型。导入逻辑大概是：

已存在同 ID 供应商时不会覆盖
能直连且模型名安全的供应商会导入为直连模式
需要模型转换的供应商会尝试导入为模型映射模式
ANTHROPIC_DEFAULT_SONNET_MODEL、ANTHROPIC_DEFAULT_OPUS_MODEL、ANTHROPIC_DEFAULT_HAIKU_MODEL 会自动转成 Desktop 的 Sonnet / Opus / Haiku 映射
旧的 [1M] 后缀会转成 Desktop profile 中的 supports1m 标记
无法判断模型映射关系的供应商会跳过

导入之后建议逐个检查一下模型映射是否正确，尤其是 Kimi、DeepSeek、GLM、DouBao 这类非 Claude 模型，通常需要用模型映射模式。

手动添加

如果没有可导入的配置，或者想专门给 Claude Desktop 加一个不同的供应商，点右上角 + 添加即可。

三种选择：

预设供应商：从内置预设里选，只填 API Key
自定义供应商：手动写名称、接口地址、API Key 和模型设置
Claude Desktop Official：恢复 Claude Desktop 官方登录模式

对于普通的 Anthropic Messages API 兼容供应商，流程很简单：选预设或自定义 → 填 API Key → 确认接口地址 → 关掉「需要模型映射」→ 添加。

3. 切换并重启 Claude Desktop

在供应商卡片上点「启用」，然后完全退出并重启 Claude Desktop。

注意：Claude Desktop 不会热重载配置，只关聊天窗口不够，要从托盘里退出或者确保进程完全结束。

两种工作模式

直连模式

适合供应商本身提供了原生 Anthropic Messages API 的情况。CC Switch 会把 Claude Desktop 的 3P profile 直接指到供应商接口：

{
  "inferenceProvider": "gateway",
  "inferenceGatewayBaseUrl": "https://api.example.com",
  "inferenceGatewayAuthScheme": "bearer",
  "inferenceGatewayApiKey": "你的 API Key"
}

适用条件：供应商暴露的是原生 Anthropic Messages API，模型 ID 是 claude-* 或 anthropic/claude-* 格式，不需要格式转换。直连模式下不需要 CC Switch 一直开着本地路由。

「手动指定 Claude Desktop 模型列表」是个高级选项，大部分原生 Claude 模型供应商不需要填，Claude Desktop 会自动读 /v1/models。只有供应商的 /v1/models 不可用，或者返回的模型名 Claude Desktop 不认识时才需要手动添加。

模型映射模式

如果供应商不是 Claude 系列模型（比如 deepseek、kimi 等），或者接口格式需要 CC Switch 做转换，就要开启「需要模型映射」。

开启后，Claude Desktop 会连到 CC Switch 的本地网关：

http://127.0.0.1:15721/claude-desktop

CC Switch 在中间负责：向 Claude Desktop 暴露安全的 claude-* 模型路由，把 Desktop 选的模型角色映射到真实上游模型，按供应商要求做 Anthropic / OpenAI / Gemini 格式转换，并用 CC Switch 里存的凭据访问上游。

支持的格式：

格式	用途
Anthropic Messages	原生或兼容 Anthropic 请求
OpenAI Chat Completions	`/chat/completions` 兼容接口
OpenAI Responses API	OpenAI Responses 兼容接口
Gemini Native generateContent	Gemini 原生接口

模型映射模式下，Claude Desktop 只能看到 claude-* 形式的路由模型名，真实的上游模型名不会写进 Claude Desktop profile。

配置模型映射

模型映射的核心思路是：Claude Desktop 现在会拒绝非 claude-* 的模型名，所以需要通过 CC Switch 做一轮角色映射。

字段	说明
模型角色	Claude Desktop 可识别的 Sonnet / Opus / Haiku 路由
菜单显示名	在 Claude Desktop 模型菜单里显示的名称
实际请求模型	发给上游供应商的真实模型 ID
1M	向 Claude Desktop 声明该模型支持 1M 上下文

举个例子，如果想在 Claude Desktop 里用 Kimi：

模型角色	菜单显示名	实际请求模型	1M
Sonnet	Kimi K2	`kimi-k2`	按供应商能力选择

想用 DeepSeek：

模型角色	菜单显示名	实际请求模型	1M
Sonnet	DeepSeek V4 Pro	`deepseek-v4-pro`	按供应商能力选择

三个角色的建议分工：

模型角色	用途
Sonnet	默认主力模型
Opus	高质量或复杂任务
Haiku	快速、低成本的场景

如果供应商只有一个模型，只配一个 Sonnet 也行。模型映射模式至少需要一条有效映射。

本地路由

模型映射模式必须依赖 CC Switch 的本地路由来做请求转换。这个开关默认在主界面是隐藏的，需要手动打开。

去 设置 → 路由 → 本地路由，开启 在主页面显示本地路由开关。

打开后回到 Claude Desktop 面板，右上角就能看到本地路由开关了。

Claude Desktop 本地路由开关

状态含义：

状态	说明
开启	本地网关运行中，地址是 `127.0.0.1:15721`
关闭	直连供应商仍可用，模型映射供应商无法工作
正在加载	路由服务在启动或停止中

只有开了「需要模型映射」的供应商才需要本地路由，直连的不用管。

如果其他应用正在用代理接管，关本地路由可能会被阻止。先去设置里的路由服务区域关掉对应应用接管，再停本地路由。

恢复官方 Claude Desktop

想切回官方登录模式的话：

选 Claude Desktop Official
点「启用」
重启 Claude Desktop

CC Switch 会恢复 Claude Desktop 的官方 1P 模式，把 3P profile 清理掉。官方模式不需要 API Key，也不需要本地路由。

从 Claude Code 导入供应商时，会自动加一条 Claude Desktop Official，方便随时切回去。

配置文件位置

CC Switch 写入的是 Claude Desktop 的 3P 配置目录：

macOS：

~/Library/Application Support/Claude/claude_desktop_config.json
~/Library/Application Support/Claude-3p/claude_desktop_config.json
~/Library/Application Support/Claude-3p/configLibrary/_meta.json
~/Library/Application Support/Claude-3p/configLibrary/00000000-0000-4000-8000-000000157210.json

Windows：

%LOCALAPPDATA%\Claude\claude_desktop_config.json
%LOCALAPPDATA%\Claude-3p\claude_desktop_config.json
%LOCALAPPDATA%\Claude-3p\configLibrary\_meta.json
%LOCALAPPDATA%\Claude-3p\configLibrary\00000000-0000-4000-8000-000000157210.json

配置文件由 CC Switch 自动维护，不建议手动改。如果出现配置不一致，重新启用一次当前供应商一般就能修好。

总结

CC Switch 的 Claude Desktop 面板本质上就是把原本只对 CLI 工具开放的供应商管理能力搬到了桌面端。对于已经在 CC Switch 里配置了一堆供应商的用户来说，从 Claude Code 一键导入是最快的路径。

直连模式省心，模型映射模式灵活。如果主力用 Claude 系列模型，直连就够了；如果想在 Claude Desktop 里用 Kimi、DeepSeek 等模型，模型映射模式配合本地路由就能搞定。

目录