阿延哥
人工智能

Claude Desktop 配置 DeepSeek API：第三方推理与模型映射实录

作者：吴英延（阿延哥）

从 Codex 模型容量提示出发，记录在 Claude Desktop 中接入 DeepSeek API 的过程，以及 DeepSeek V4.1 Flash 在编码任务中的实际体验。

Claude DesktopDeepSeekAPI人工智能开发工具

最近使用 Codex 时，我经常遇到下面这条提示：

Claude Desktop 提示：Selected model is at capacity. Please try a different model.

这通常说明当前选择的 Codex 模型在当时容量不足，并不一定代表项目或请求本身有问题。频繁切换模型会打断编码节奏，所以我开始尝试另一条路径：在 Claude Desktop 的开发模式中配置 DeepSeek API，把 Claude Desktop 作为交互入口，把 DeepSeek 作为实际的推理服务。

配置完成后，我重点体验了 DeepSeek V4.1 Flash。它给我的第一印象是响应稳定，日常编码、代码阅读、重构、问题定位和方案讨论都比较顺手。在一些编码任务中，它的完成质量和速度都不错，足以成为 Codex 暂时不可用时的备用选择。这里记录的是我的实际配置过程和使用感受，供遇到类似模型容量问题的开发者参考。

为什么选择 Claude Desktop + DeepSeek

这次配置并不是把 Claude Desktop 的模型名称简单替换成 DeepSeek，而是利用 DeepSeek 提供的 Anthropic 兼容接口。Claude Desktop 继续负责项目、对话和开发体验，DeepSeek API 负责模型推理。

本文中的字段和模型名称都来自实际配置截图，适合 Windows 桌面端作为操作参考。

一、准备工作

开始前需要准备三样东西：

  • 已安装支持第三方推理配置的 Claude Desktop（本文基于 Claude for Windows 2.110.0 编写）。
  • 在客户端中开启开发者模式，否则看不到第三方推理入口。
  • 一个 DeepSeek API Key。
  • DeepSeek 账户中有可用余额。

DeepSeek 同时提供 OpenAI 和 Anthropic 两种接口格式。Claude Desktop 走的是 Anthropic Messages API，因此本文使用 Anthropic 兼容地址：

https://api.deepseek.com/anthropic

二、打开 Configure third-party inference

Configure third-party inference 默认是隐藏的，普通模式下根本找不到，必须先把开发者模式打开才会暴露出来。

1. 开启开发者模式

  1. 点击窗口左上角菜单的 Help → Troubleshooting → Enable developer mode。
  2. 启用后菜单里会多出一个 Developer 选项。如果没看到，完全退出客户端重启一次，再看一次菜单。

2. 进入配置页面

  1. 从菜单的 Developer 进入 Configure third-party inference。
  2. 页面左侧选择 Connection，连接类型选择 Gateway。

Claude Desktop 第三方推理连接配置

3. 填写 Gateway credentials

在 Gateway credentials 区域填写以下内容：

  • Credential kind：选择 Static API key。
  • Gateway base URL：填写 https://api.deepseek.com/anthropic。
  • Gateway API key：填入 DeepSeek API Key。
  • Gateway auth scheme：选择 x-api-key。

这里最容易填错的是网关地址和认证方式。不要把 OpenAI 格式地址 https://api.deepseek.com 直接填到 Claude Desktop 中，也不要随意改成 Bearer 认证。DeepSeek 的 Anthropic 兼容接口使用 /anthropic 路径，截图中的认证方式是 x-api-key。

填写完成后，可以点击 Test connection 测试连接。如果返回 401，优先检查 API Key；如果返回 404，优先检查 URL 是否漏掉了 /anthropic。

三、为什么模型 ID 仍然使用 claude- 开头

Claude Desktop 的模型选择器对模型 ID 有自己的校验规则，部分版本不接受直接填写 deepseek-v4-pro 或 deepseek-flash。解决方式是保留 Claude 风格的模型 ID，再通过显示名称标注真正使用的 DeepSeek 模型。

截图中配置了两个模型：

claude-opus-4
claude-sonnet-4

DeepSeek 官方提供了模型映射规则：以 claude-opus 开头的模型会映射到 DeepSeek V4 Pro；以 claude-sonnet 或 claude-haiku 开头的模型会映射到 DeepSeek Flash。因此，模型 ID 是给 Claude Desktop 识别的别名，Display name 才是给使用者看的模型名称。

四、配置 DeepSeek V4 Pro

展开 claude-opus-4，可以按下面的方式填写：

Model ID: claude-opus-4
Display name: DeepSeek V4 Pro 0813
Tier alias: opus

DeepSeek V4 Pro 模型配置

截图中打开了 Offer 1M-context variant、Default to 1M context 和 Default for tier。这意味着模型选择器会提供一个 1M 上下文版本，并把它作为 opus 档位的默认模型。

是否打开 1M 上下文，应该根据实际网关和模型能力决定。DeepSeek 当前模型文档已经提供长上下文模型，但客户端展示的选项不等于每个自定义网关都一定支持相同的上下文上限。

五、配置 DeepSeek V4.1 Flash

展开 claude-sonnet-4，填写：

Model ID: claude-sonnet-4
Display name: DeepSeek V4.1 Flash
Tier alias: sonnet

DeepSeek V4.1 Flash 模型配置

Sonnet 档位更适合日常问答、代码修改和一般开发任务。截图中同样打开了 1M 上下文相关选项，并将这个模型设置为 sonnet 档位的默认模型。

配置完成后，模型选择器中显示的是 DeepSeek V4 Pro 0813 和 DeepSeek V4.1 Flash，但 Claude Desktop 内部仍然使用 claude-opus-4 和 claude-sonnet-4 这两个兼容名称。

Claude Desktop 中的 DeepSeek 模型选择器

六、网络代理怎么配置

如果本机访问 DeepSeek API 不稳定，可以在 Network Proxy 区域填写本地代理，例如：

http://127.0.0.1:7897

Claude Desktop 网络代理配置

只有在本机确实运行了对应代理软件，并且代理监听 7897 端口时，才需要填写这一项。如果没有本地代理服务，建议保持为空。错误的代理地址会让 Claude Desktop 看起来像是 API 配置失败，实际却是网络请求根本没有发出去。

七、应用配置并验证

完成所有字段后，点击右下角的 Apply Changes。随后完全退出 Claude Desktop，再重新打开应用。

重新进入模型选择器，确认能够看到：

DeepSeek V4 Pro 0813
DeepSeek V4.1 Flash

选择一个模型，发送一条简单的测试消息：

请介绍一下你当前使用的模型，以及这次请求经过了哪个 API 服务。

如果能正常返回结果，说明 Claude Desktop 已经通过 DeepSeek 的 Anthropic 兼容接口完成推理。

发送测试消息后的返回结果：客户端 composer 中显示的模型名为 DeepSeek V4.1 Flash

八、常见问题

1. 返回 401 Unauthorized

通常是 API Key 无效、复制时带入了空格，或者 DeepSeek 账户余额不足。重新生成或复制 API Key，并在 DeepSeek 控制台确认账户状态。

2. 返回 404 Not Found

检查 Gateway base URL 是否为：

https://api.deepseek.com/anthropic

Claude Desktop 使用 Anthropic 接口时不能漏掉 /anthropic。

3. 模型名称无法保存

不要直接填写 deepseek-v4-pro 或 deepseek-flash，先尝试使用：

claude-opus-4
claude-sonnet-4

然后在 Display name 中填写 DeepSeek 模型名称。

4. 配置后仍然连接 Anthropic

完全退出 Claude Desktop 后重新启动。部分第三方推理配置不会在当前会话中立即生效。

5. 1M 上下文选项是否必须打开

不是必须。它只是告诉 Claude Desktop 在模型选择器中展示长上下文变体。只有当当前 DeepSeek 模型和网关确实支持 1M 上下文时，才建议把它设置为默认选项。

写在最后

这套方案的工作链路可以概括为：

Claude Desktop
    ↓
Anthropic 兼容接口
    ↓
DeepSeek API
    ↓
DeepSeek V4 Pro / V4.1 Flash

Claude Desktop 负责界面、项目和开发体验，DeepSeek 负责实际模型推理。使用 Claude 风格的 Model ID，是为了适配客户端的模型校验；Display name 则负责把真实的 DeepSeek 模型名称展示出来。

需要注意的是，启用第三方推理后，输入内容会发送到 DeepSeek API。涉及公司源代码、客户资料、密码和个人隐私时，应先确认数据是否允许发送到第三方模型服务。

DeepSeek 官方文档：