2026-05-03

在 Claude 桌面端中使用 DeepSeek：图形化配置，两分钟搞定

Claude 桌面端内置了一个隐藏的开发者模式，里面有图形化的 Gateway 配置面板。你不需要编辑 JSON 文件、不需要碰终端、不需要设环境变量。这篇教程以 GUI 方法为主路径，settings.json 作为备选方案。两条路都是把 Claude 桌面端指到 DeepSeek 的 Anthropic 兼容端点，让你保留熟悉的桌面体验，模型请求走 DeepSeek。

1. 开始之前：打开 Claude 桌面端但不要登录

这是最关键的一步，也是最容易被漏掉的。开发者模式的开关只在登录界面可见——在你登录任何 Anthropic 账户之前。如果你已经登录了，先退出登录。

启动 Claude 桌面端。如果你看到登录提示，就对了。不要输入 Anthropic 凭据，停在登录界面，然后看菜单栏。

2. 启用开发者模式（一次性设置）

macOS 上，点菜单栏：Help → Troubleshooting → Enable Developer Mode。Windows 路径相同。App 会弹出确认对话框，然后自动重启。

重启后，菜单栏里会出现一个新的 Developer 菜单。这一步只需要做一次——开发者模式会一直保持开启，除非你手动关掉。

如果没看到 Troubleshooting 子菜单，检查两件事：你是不是还在登录界面（没登录）、你的 Claude 桌面端是不是最新版本。旧版本可能没有这个功能。

3. 在 Gateway 图形界面中配置 DeepSeek

点击 Developer → Configure Third-Party Inference。你会看到四个提供商选项：Gateway、Bedrock、Vertex、Foundry。选 Gateway——它适用于任何 Anthropic 兼容 API，包括 DeepSeek。

按下面的表格填写表单。每个字段都不能写错——一个字符的偏差可能导致静默回退到默认模型。

填完表单后，点击底部的 Apply locally，然后 Relaunch now。App 重启后会再次出现启动界面——这次选 Local，不要点登录。

Local 配置模式告诉 Claude 桌面端用你刚填的 Gateway 设置，而不是 Anthropic 的默认服务器。之后所有对话都会走 DeepSeek。

DeepSeek 的 Gateway 配置
字段	填写值	说明
Gateway base URL	https://api.deepseek.com/anthropic	DeepSeek 的 Anthropic 兼容端点，必须是 HTTPS。
Gateway API key	<你的 DeepSeek API Key>	在 DeepSeek 官方控制台获取，或在 /zh/pricing 买折扣版。
Auth scheme	bearer	默认值。DeepSeek 这条路走 Bearer Token 认证。
Extra headers	（留空）	标准 DeepSeek 接入不需要额外 header。

Sources checked

DeepSeek 官方 Claude Code 接入文档 - 正确的 DeepSeek 端点 URL（api.deepseek.com/anthropic）来源。

4. 验证连接是否真的生效

不要看到 App 打开了就以为成功了。Gateway 配错了 App 照样能启动——它会静默回退到 Anthropic 默认模型。

最简单的验证方式：直接问 Claude 桌面端。「你现在跑在哪个模型上？」或「你当前的模型提供商和模型名是什么？」如果回答提到了 DeepSeek V4，路由就是对的。

另一种验证：问一个只有 DeepSeek 才能准确回答的问题，比如「DeepSeek V4 Pro 的上下文窗口多大？」正确答案（1M tokens，包含 DeepSeek 相关细节）可以确认你在正确的后端上。

DeepSeek 官方文档里的一个坑：如果你手动指定了端点不认识的模型名，它会静默映射到 deepseek-v4-flash。这意味着你可能以为在跑 Pro、实际在跑 Flash。Gateway GUI 应该会自动处理模型选择——如果你用的是 GUI，可以先直接问 App 它在跑哪个模型来确认。

Sources checked

DeepSeek Anthropic API 文档 - 说明不支持的模型名会回退到 deepseek-v4-flash。

5. 备用方案：settings.json（如果 GUI 不可用）

如果你的 Claude 桌面端版本没有开发者模式开关，或者你更习惯用文件配置，可以通过 settings.json 来实现。这是备用方案——上面的 GUI 方法更简单。

Claude 桌面端在 `~/.claude/settings.json` 读取配置。macOS 完整路径是 `/Users/<你的用户名>/.claude/settings.json`，Windows 是 `C:\Users\<你的用户名>\.claude\settings.json`。文件不存在就新建。

保存文件，完全退出 Claude 桌面端（macOS 用 Cmd+Q，不是只关窗口），重新打开。App 只在启动时读取 settings.json。

`ANTHROPIC_DEFAULT_*` 变量防止内部模型别名回退到 Anthropic 默认值。模型字符串用的是 `deepseek-v4-pro[1m]`（带方括号后缀）——这是 DeepSeek 专门给 Claude Code 写的接入页里的精确值。写成 `deepseek-v4-pro` 不带 `[1m]` 可能触发静默回退到 Flash。

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.deepseek.com/anthropic",
    "ANTHROPIC_AUTH_TOKEN": "sk-...",
    "ANTHROPIC_MODEL": "deepseek-v4-pro[1m]",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "deepseek-v4-pro[1m]",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "deepseek-v4-pro[1m]",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "deepseek-v4-flash",
    "CLAUDE_CODE_SUBAGENT_MODEL": "deepseek-v4-flash",
    "CLAUDE_CODE_EFFORT_LEVEL": "max"
  }
}

Sources checked

Claude Code Desktop 文档 - 说明桌面端的配置文件和环境编辑器。
Claude Code 环境变量文档 - 确认 ANTHROPIC_BASE_URL 覆盖 API 端点。

6. 常见问题排查

开发者菜单没出来：你大概率已经登录了。退出登录，回到登录界面，再检查 Help → Troubleshooting。同时也确认一下 Claude 桌面端是不是最新版。

Gateway 配置保存了但 App 还是用的 Anthropic 模型：你可能在重启后的启动界面选了「登录」而不是「Local」。退出重开，选 Local 模式。

改了 settings.json 后 App 打不开：JSON 格式大概率有问题。检查有没有多余逗号、漏引号、多余字符。贴进任何 JSON 校验工具看一眼。

认证报错：确认 DeepSeek API Key 在有效期内且有额度。可以先在终端里用 curl 独立测试，排除 Key 本身的问题再排查桌面端。

想从头来过：GUI 方式的话，进 Developer → Configure Third-Party Inference，清空 Gateway 字段。settings.json 方式的话，删掉或改名文件。重启 App，正常登录即可。

# 快速测试 API Key（在终端里跑，不是在 Claude 桌面端里）
curl -s https://api.deepseek.com/anthropic/v1/messages \
  -H "x-api-key: sk-..." \
  -H "anthropic-version: 2023-06-01" \
  -H "content-type: application/json" \
  -d '{
    "model": "deepseek-v4-flash",
    "max_tokens": 64,
    "messages": [{"role": "user", "content": "Say hello in one word."}]
  }' | head -c 500

7. 哪些功能能平移、哪些不能

DeepSeek 的 Anthropic 兼容 API 刻意聚焦在最常用的功能上。文本聊天、代码生成、基础 tool use 都能稳定跑。但它不是 Anthropic 全部能力的镜像。

当前 DeepSeek 兼容性文档明确标了以下内容不支持或被忽略：image 块、document 块、search_result 块，以及部分 MCP 相关的消息和工具字段。如果你的工作流重度依赖图片分析、文档处理或高级 MCP 功能，切换前先单独测试这些路径。

Anthropic 自己的文档还有一个提示：当 base URL 指向非 Anthropic 第一方地址时，MCP tool search 可能默认关闭。如果需要这个功能，在你的具体环境里验证一下。

务实结论：日常编码、写作、研究、数据分析和工具辅助工作流完全够用。对最深的 Claude 独占能力，留一条回退路线。

Sources checked

DeepSeek Anthropic API 兼容性详情 - 列出支持、忽略和不支持的 Anthropic 字段。

FAQ

需要 Anthropic 账户才能用 DeepSeek 吗？

不需要。开发者模式 + Gateway 方案就是为此设计的：不需要 Anthropic 账户就能用 Claude 桌面端接第三方 API。不登录、开开发者模式、配 Gateway、选 Local 模式，就行了。

能用在 claude.ai 网页版上吗？

不能。开发者模式和 Gateway 是 Claude 桌面端（你装在电脑上的原生 App）的功能。claude.ai 网站没有这些选项。

GUI 方式 macOS 和 Windows 都能用吗？

都能。开发者模式开关和 Gateway 配置面板两个平台都有。菜单路径和填写值完全一样。

为什么我最后跑的是 Flash 而不是 Pro？

如果你用的是 settings.json 方式，检查模型名是否逐字符正确。DeepSeek 的 API 会把不认识的模型名静默映射到 deepseek-v4-flash。Gateway GUI 应该会自动处理——如果不确定，直接在 App 里问它跑的是哪个模型。

文件上传和图片分析还能用吗？

文本和代码文件正常。图片分析可能不行，因为 DeepSeek 兼容性页把 image 块标为不支持。正式依赖前先单独测试。

怎么切回 Anthropic 默认模型？

退出 Claude 桌面端，重新打开，在启动界面选登录 Anthropic 账户（不要选 Local）。Gateway 配置会留在磁盘上——只有选 Local 模式时才生效。

去哪里搞 DeepSeek API Key？

可以去 DeepSeek 官方平台注册，或者在 /zh/pricing 买官方折扣 Key——同接口、同端点、更低价格。

把 DeepSeek 接到 Claude 桌面端现在只需要两分钟，完全不用碰文件：打开登录界面、启用开发者模式、在 Gateway 表单里填入 DeepSeek 的端点和 API Key、重启、选 Local 模式。settings.json 备用方案也给你留着。无论走哪条路，一定要验证连接真的生效了。

查看官方折扣 DeepSeek API Key