Claude Code 接入 DeepSeek V4 实战指南：Developer Mode、兼容接口和 1M Context 怎么配

Claude Code 接入 DeepSeek V4 实战指南

最近我把 DeepSeek V4 接进了 Claude Code 桌面版。

如果你搜的是“Claude Code 桌面版接入 DeepSeek”或“DeepSeek 版 Claude Code”，先看这句：这条路不需要先从代理入手，核心是 Developer Mode、Anthropic-compatible Gateway 和正确的 Model ID。

这件事的重点不是“换壳聊天”，也不是把 API Key 往某个输入框一贴就结束。

更准确地说，它是一条四步链路：

1. 打开 Claude Code 桌面版的 Developer Mode
2. 进入第三方推理 / Gateway 配置
3. 填好 Anthropic-compatible 接口、Base URL、API Key 和 bearer 认证
4. 加入 DeepSeek V4 的模型列表，并验证 Flash、Pro、Flash 1M、Pro 1M 是否可用

如果你已经用过 Claude Code，这条路径的意义很直接：继续使用熟悉的 Claude Code 工作流，同时把 DeepSeek V4 放进可选模型里。

先说结论：这不是代理问题，而是接入链路问题

很多 Windows 或 CLI 用户一遇到模型接不通，第一反应就是怀疑代理。

但这次 Claude Code 接入 DeepSeek V4，我更建议先按接入链路排：

Developer Mode
  -> Anthropic-compatible Gateway
  -> Base URL / API Key / bearer
  -> Model ID
  -> 1M context variant
  -> 模型菜单验证

也就是说，先确认 Claude Code 是否允许你配置第三方推理入口，再确认接口、认证方式和模型 ID 是否匹配。

只有这些都没问题、但请求仍然出不去时，才回头单独排网络。

第一步：打开 Claude Code 桌面版 Developer Mode

接入 DeepSeek V4 的第一步，不是先填 API Key。

你要先把 Claude Code 桌面版的 Developer Mode 打开。

路径可以按这个顺序找：

Help
  -> Troubleshooting
  -> Enable Developer Mode

打开之后，再进入第三方推理配置界面。

这一步很关键。因为没有 Developer Mode，你后面即使准备好了 Base URL 和 API Key，也不一定能把第三方模型接进 Claude Code 的工作流。

第二步：选择 Anthropic-compatible Gateway

进入配置界面后，选择 Gateway 或第三方推理入口。

这里要理解一个概念：Anthropic-compatible。

它的意思不是“后面仍然只能调用 Anthropic 模型”，而是 Claude Code 按兼容 Anthropic 的协议发请求，后端实际转到你配置的 DeepSeek V4 服务。

可以把它理解成：

Claude Code
  -> Anthropic-compatible request
  -> Gateway / compatible endpoint
  -> DeepSeek V4

这也是为什么这里不要只盯着模型名字，要同时看协议兼容层、认证方式和模型 ID。

第三步：填写 Base URL、API Key 和 bearer

核心配置通常包括三项：

配置项	作用	注意点
Base URL	DeepSeek V4 的 Anthropic 兼容接口地址	使用你实际服务端提供的地址，不要把普通聊天页面地址填进去
API Key	调用接口的密钥	不要写进公开文章、截图或仓库
Auth type	认证方式	这里选择 bearer

这一步最容易出错的是 Base URL。

浏览器能打开某个网站，不代表这个地址就是 Claude Code 需要的推理接口地址。你要填的是兼容 Anthropic 调用格式的接口地址。

API Key 也不要放进 claude.md、博客正文、GitHub issue 或截图里。实战里最稳的做法是只在本地配置界面或环境变量里保存。

第四步：添加 DeepSeek V4 模型列表

配置接口之后，还要把模型放进 Claude Code 可选菜单。

我会先按这个顺序加：

DeepSeek V4 Flash
DeepSeek V4 Pro
DeepSeek V4 Flash 1M
DeepSeek V4 Pro 1M

对应到真实配置时，名称可以写得易读一些，但 Model ID 要以你服务端实际要求为准。

这一步不要为了“看起来完整”乱填模型。菜单里能出现是一回事，真正调用能成功是另一回事。

第五步：打开 1M context 变体

如果服务端支持 1M 超长上下文，再打开类似 Offer 1M-context variant 的开关。

打开以后，模型菜单里应该能看到类似：

Flash
Flash 1M
Pro
Pro 1M

我建议先验证普通 Flash / Pro，再验证 1M 版本。

原因很简单：如果基础模型还没跑通，就直接排 1M context，问题会混在一起。

第六步：用真实任务验证，而不是只看菜单

能看到模型菜单，只能说明配置链路初步接通。

真正要验证 Claude Code + DeepSeek V4 是否适合你，要用真实任务测试：

验证任务	看什么
小文件修改	是否能理解当前文件意图，不乱改无关内容
跨文件排障	是否能跟住调用链和错误日志
长文档总结	是否能保留证据，不编造不存在的结论
代码审查	是否能指出具体风险，而不是泛泛而谈
claude.md 协作	是否遵守项目边界、命令和禁止事项

如果你还没有给项目写过 claude.md，建议先看这篇：

claude.md 怎么写才有用：让 Claude Code 更懂项目的实战指南

接入模型只是第一步。真正让 Claude Code 稳定工作的，是项目边界、验证命令和交付标准。

Flash、Pro、1M 应该怎么分工

我的默认分工是：

场景	推荐入口
快速问答、轻量解释、小改动	Flash
跨文件分析、复杂修复、关键输出	Pro
长文档、长日志、较大上下文阅读	Flash 1M 或 Pro 1M
高风险长上下文决策	Pro 1M

不要把 1M context 理解成“什么都塞进去就会更好”。

更好的用法是：先整理输入边界，再用长上下文保留更多证据。

关于 DeepSeek V4 的模型路由和 1M context，我之前拆过三篇：

• DeepSeek V4 API 迁移实战
• DeepSeek V4 Pro 和 Flash 怎么选
• DeepSeek V4 的 1M context 怎么真正用起来

现在这篇文章把它们合回 Claude Code 使用场景里，方便你按一条链路执行。

Windows 用户还要注意什么

如果你是在 Windows 上使用 Claude Code，建议把问题拆成两层：

1. Claude Code 桌面版 Developer Mode 和模型配置是否正确
2. 终端里的 Claude Code、PowerShell、PATH、网络变量是否正确

这两层不要混着排。

如果你遇到的是 PowerShell 里 Claude Code 连不上网，可以看：

Claude Code 在 PowerShell 连不上网怎么办：Windows 用户先查这 6 步

如果你还在安装起步阶段，可以先看：

Claude Code 新手先看什么：下载、文档、Windows 安装与常见问题入口

我会怎样把它放进日常工作流

我不会把 Claude Code + DeepSeek V4 当成一个单独玩具。

更实用的做法是把它放进完整工程闭环：

claude.md 定义边界
  -> Claude Code 读取项目
  -> DeepSeek V4 承接部分模型调用
  -> 小步修改
  -> 本地验证
  -> 记录经验
  -> 回填到项目文档

这样用，模型接入才有价值。

否则你只是多了一个模型选项，但项目协作仍然会乱。

最小检查清单

正式使用前，我会按这个清单过一遍：

• Claude Code 桌面版能进入 Developer Mode
• 第三方推理入口选择 Anthropic-compatible Gateway
• Base URL 是真实兼容接口地址
• API Key 没有泄露到公开位置
• Auth type 选择 bearer
• 模型菜单能看到 Flash 和 Pro
• 服务端支持时再打开 1M context 变体
• 菜单能看到 Flash 1M 和 Pro 1M
• 用真实项目任务验证一次小改动
• 用真实项目任务验证一次跨文件分析
• claude.md 写清项目边界和验证命令

最后

Claude Code 接入 DeepSeek V4，最值得关注的不是“能不能连上”，而是连上之后能不能进入稳定的工程工作流。

如果你只是临时体验，配通模型菜单就够了。

如果你要长期用它改项目、排障、写文章、做工具和维护站点，那就继续把 claude.md、Windows 排障、模型路由和验证清单一起补齐。

这才是 Claude Code 真正进入实战的方式。