Claude 桌面端入门：Claude Desktop + cc-switch + DeepSeek

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

引言

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

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

一、准备工作

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

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

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

二、注册 DeepSeek，拿到 API Key

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

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

三、安装 cc-switch

bash 复制代码

# 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 供应商卡片上点击 「启用」，然后：

完全退出 Claude Desktop（macOS 按 ⌘Q，不是关窗口）。
重新打开 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