Claude Desktop 接入指南：用 CC Switch 连接 DeepSeek

Claude Desktop 默认连接 Anthropic 服务，而接入 DeepSeek 时，两端使用的模型名称和调用方式并不完全一致。要让桌面客户端正常发送请求，需要借助 CC Switch 配置供应商、启动本地路由并完成模型角色映射。下面从准备环境开始，逐步说明配置、验证和日常切换中的关键环节。

适用系统：macOS（Windows 用户看各步骤中的备注） 信息核实日期：2026-09（依据 DeepSeek 官方文档与 cc-switch 官方用户手册）

引言

这是一套「国内可直接用、按量付费、成本可控」的 AI 桌面助手组合：

• Claude Desktop（桌面端）：Anthropic 官方的图形界面客户端。它有漂亮的聊天界面、MCP 工具、Skills、Artifacts 等能力。但它默认只连 Anthropic 官方服务——国内直连不便，订阅也贵。
• DeepSeek：国内模型服务商，提供 Anthropic API 兼容端点，所以可以被 Claude 桌面端当「大脑」使用。按量计费（充多少用多少），没有月费。
• cc-switch：桌面小工具，把「改配置文件切换供应商」变成图形界面里的一键切换，并负责把 DeepSeek 的模型名「翻译」成 Claude 桌面端认识的模型名。

一、准备工作

1. 安装 Claude Desktop：到 claude.ai/download 下载 macOS 版（Windows 版也在同一页面），装完先不要登录。

如果你已经登录了官方账号也没关系，后面可以用 cc-switch 一键切到第三方模式。

2. 一个可用的 DeepSeek 账号（见下一步）。

二、注册 DeepSeek，拿到 API Key

1. 打开 DeepSeek 开放平台，注册并登录。
2. 进入 API Keys 页面（platform.deepseek.com/api_keys），点击「创建 API Key」，复制并妥善保存。
3. 如需使用，先在「充值」页充一点余额（DeepSeek 是按量付费，用量小时开销很低；具体价格以官网定价页为准）。

⚠️ API Key 等同于密码——不要发到群里、不要硬编码进代码、不要提交到 git 仓库。

三、安装 cc-switch

# macOS（推荐）
brew install --cask cc-switch
# 或者到 https://github.com/farion1231/cc-switch/releases 下载 .dmg

Windows 用户：到 Releases 页面下载 .exe / .msi 安装包。

四、理解原理：为什么必须用「模型映射」

这是本指南最容易卡住的一环，先花一分钟理解：

Claude 桌面端只认识三种模型角色，模型菜单里也只有这三档：

角色	定位
Sonnet	日常主力
Opus	高强度/复杂任务
Haiku	快速、轻量、省 token

而 DeepSeek 的模型名是 deepseek-v4-pro、deepseek-flash 这样的名字，不属于这三档角色。新版 Claude 桌面端会直接拒绝不认识的非三档模型名。

所以需要 cc-switch 在中间做一轮「模型映射」：本地起一个网关（127.0.0.1:15721），把桌面端发出的「Sonnet / Opus / Haiku」角色请求，翻译成 DeepSeek 的真实模型名再转发出去。这就是「模型映射」模式。

DeepSeek 目前两个主力模型（2026-09 起）：

模型名	定位	建议映射到
deepseek-v4-pro	强推理、复杂任务	Sonnet / Opus
deepseek-flash	快、便宜	Haiku

⚠️ 注意模型名：快模型的官方名是 deepseek-flash。旧的 deepseek-chat / deepseek-reasoner 已于 2026-07-24 停用，deepseek-v4-flash 也已退役（仍可请求但已被 Flash 引擎接管）。不要再把 deepseek-v4-flash 当新名字填进去。

五、配置 cc-switch（核心步骤）

第 1 步：切换到「Claude Desktop」面板

打开 cc-switch，在左侧应用切换器里选择 Claude Desktop。

⚠️ 一定要分清两个入口：

• 「Claude」 = 命令行版 Claude Code（改 ~/.claude/settings.json）
• 「Claude Desktop」 = 桌面客户端（本文要配的）

选错面板会导致配置写错地方，桌面端不生效。

如果没看到「Claude Desktop」入口：到 设置 → 通用 → 应用可见性，确认它没有被隐藏。

第 2 步：添加 DeepSeek 供应商

点击右上角 +，添加供应商（如果有 DeepSeek 预设就直接选预设，只需填 API Key；否则选自定义供应商手动填）：

字段	填写内容
名称	DeepSeek（随意）
接口地址 / Base URL	https://api.deepseek.com/anthropic
API Key	第二步创建的那串 sk-...
API 格式	Anthropic
需要模型映射	开启（关键！）

。

第 3 步：配置模型映射

在供应商的「模型映射」区域填三行（角色 + 显示名 + 实际请求模型）：

模型角色	菜单显示名	实际请求模型
Sonnet	DeepSeek V4 Pro	deepseek-v4-pro
Opus	DeepSeek V4 Pro	deepseek-v4-pro
Haiku	DeepSeek Flash	deepseek-flash

「菜单显示名」会出现在 Claude 桌面端的模型菜单里，写什么都可以，方便你自己认就行。

DeepSeek 支持 1M 上下文，可以在映射里勾选「1M」标记（按供应商能力选择）。

第 4 步：开启本地路由开关

模型映射模式需要 cc-switch 的本地网关参与转发。首次使用要先把这个开关显示出来：

设置 → 路由 → 本地路由 → 开启 「在主页面显示本地路由开关」

然后回到 Claude Desktop 面板，打开右上角的 Claude Desktop 本地路由开关，确认网关地址是 127.0.0.1:15721。

第 5 步：启用供应商并重启桌面端

在 DeepSeek 供应商卡片上点击 「启用」，然后：

1. 完全退出 Claude Desktop（macOS 按 ⌘Q，不是关窗口）。
2. 重新打开 Claude Desktop。

⚠️ Claude Desktop 不会热重载配置。每次切换供应商后都必须完全退出再重开，否则不生效。

六、验证是否成功

打开 Claude Desktop，看模型选择菜单里是否出现了你在「菜单显示名」里填的名字（比如 DeepSeek V4 Pro）：

然后随便发一句话测试，能正常回复就说明整条链路跑通了。

七、日常使用与供应商切换

• 切回官方 Anthropic：在 cc-switch 里选择 Claude Desktop Official → 启用 → 重启桌面端。
• 多供应商切换：按第五步添加更多供应商，切换时点「启用」再重启桌面端即可。
• 直连 vs 模型映射：只有模型名本身就是 claude-sonnet-* / claude-opus-* / claude-haiku-* 三档角色的供应商才能用「直连」模式（不需要本地路由）。DeepSeek、Kimi、GLM、豆包等非 Claude 模型，一律走模型映射。

一个使用时的注意点：模型映射模式使用期间必须保持 cc-switch 运行、本地路由开启。因为请求要经过它本地网关转发；cc-switch 退出了，桌面端就连不上 DeepSeek 了。

八、常见问题

现象	处理办法
切换成功但桌面端没变化	完全退出（⌘Q）再重开 Claude Desktop，它不会热重载配置
报 401 / 鉴权失败	检查 API Key 是否复制完整；确认没有在 sk- 前后粘进空格
报「模型不存在」	检查映射里填的模型名：快模型用 deepseek-flash，不是 deepseek-v4-flash；强模型用 deepseek-v4-pro
模型菜单里看不到我填的显示名	编辑供应商，在映射里填「菜单显示名」，重新启用并重启桌面端
桌面端一直转圈 / 连不上	确认 cc-switch 在运行、本地路由开关已打开；再看本地网关 127.0.0.1:15721 状态
想把配置给别人 / 备份	cc-switch 自动维护配置（macOS 在 ~/Library/Application Support/Claude/ 和 Claude-3p/ 目录下），不建议手动编辑，直接换供应商重新启用即可

九、进阶方向

入门跑通之后，可以继续深入：

• MCP / Skills：给 Claude 桌面端接外部工具。注意：cc-switch 的 3P profile 不同步 MCP / Skills，需要你在 Claude 桌面端里单独配置。
• 多个供应商并用：把 DeepSeek（便宜）和官方 Anthropic（功能最全）都配好，按任务类型一键切换。
• DeepSeek 官方集成文档：官方也维护了一份「Agent Integrations」指南（含 Claude Code / 桌面端），见 api-docs.deepseek.com。

参考链接

• DeepSeek API 文档（模型名、端点、定价）：api-docs.deepseek.com/
• DeepSeek Anthropic 端点说明：api-docs.deepseek.com/guides/anth…
• DeepSeek API Key 管理：platform.deepseek.com/api_keys
• cc-switch 项目主页：github.com/farion1231/…
• cc-switch 用户手册（Claude Desktop 章节）：github.com/farion1231/…
• Claude 桌面端下载：claude.ai/download