系统　·　2026.10.19

把 Claude Code 接到 DeepSeek：一次真实的配置与踩坑记录

从模型发现 404、模型名称校验，到 Flash 和 V4 Pro 实际跑通。记录这次接入过程中真正有用的步骤。

最近想给 Claude Code 多接一个模型入口。原因很简单：平时开发有大量重复性工作，没必要每次都消耗高价模型的额度。DeepSeek 提供 Anthropic 兼容接口，正好可以试试。

这次用的是 Mac 上的 Claude Code Desktop，不是终端里单独安装的 Claude Code。折腾了一阵，最后 Flash 和 V4 Pro 都跑通了，连文件创建、命令执行和单元测试也验证了一遍。中间有两个坑，值得记下来。

先找到配置入口

在桌面客户端的 Developer 菜单里打开 Configure Third Party Inference，连接方式选 Gateway。

我填的是：

Gateway base URL: https://api.deepseek.com/anthropic
Credential kind: Static API key
Gateway auth scheme: x-api-key

API Key 用自己在 DeepSeek 开放平台创建的密钥。这里不需要把密钥写进项目仓库，更不要贴在截图里。

最开始我以为填完地址和 Key，点一下测试就能结束。结果直接报错：

Model discovery — Gateway /v1/models returned HTTP 404
https://api.deepseek.com/anthropic/v1/models

这不是密钥错误。客户端想自动获取模型列表，但这个兼容接口没有按它预期的路径返回列表。界面其实已经提示了处理办法：手动添加 Models，跳过 discovery。

我先手动加了 deepseek-chat，保存按钮还是不让点。

报错是：

Doesn't look like an Anthropic model
Invalid: Model list

原来这套 Gateway 配置还会检查模型名称。直接填 DeepSeek 的原生名称，并不一定能通过桌面客户端的校验。

后来改成 Claude 风格的模型 ID，让 DeepSeek 的兼容接口做映射，问题就解决了。我的配置思路是：

客户端使用的模型路由	实际希望调用的模型	用途
`claude-sonnet-*`	DeepSeek Flash	日常开发
`claude-opus-*`	DeepSeek V4 Pro	复杂任务

这里有个容易误会的地方：界面里出现 Opus 或 Sonnet 路由，不代表请求真的发给了 Anthropic。 它只是兼容层使用的模型名称。具体映射要看 DeepSeek 当前接口的支持情况，不能只凭客户端的显示名称判断。

手动配置好模型后，应用本地配置并重启客户端。重新打开，模型下拉框里已经可以选择 DeepSeek Flash 和 DeepSeek V4 Pro。

我没有直接拿正式项目做测试，而是新建了一个空目录 deepseek-test。

先选 Flash，发了一条最简单的消息：

请回复 OK，不要执行任何工具，不要创建或修改文件。

返回了 OK。

然后切换 V4 Pro，重复同样的测试，也正常返回。

单看这两条回复还不够。我又去 DeepSeek 开放平台看 API Key 的用量记录。专门给 Claude Code 创建的 Key 出现了费用，测试前不足 0.01 元，第二次测试后累计显示约 0.05 元。说明这次请求确实走到了 DeepSeek 的计费侧。

这只是两次极小的测试，不是成本基准。拿它推算一整天开发费用，没有意义。

能聊天不等于能开发。Claude Code 真正有用的地方，是能读写文件、调用命令、跑测试。

我继续在空目录里给 V4 Pro 一个小任务：写一个 Python 计算器，实现加减乘除、处理除零异常，再用 unittest 写测试并运行。

它创建了两个文件：

calculator.py
test_calculator.py

客户端报告创建了两个文件，执行了一条命令，新增 45 行代码，5 个单元测试全部通过。

这一步至少证明，在这个简单任务里，兼容接口不仅能回复文字，还能配合 Claude Code Desktop 完成文件操作和测试执行。不过这还不能说明它对大型代码库、长上下文、复杂工具链也同样稳定。正式项目仍然需要按任务验收。

日常改代码、整理文档、小功能和简单排错，先用 Flash。碰到需要更多推理的任务，再切到 V4 Pro。

但我不会因为这次测试通过，就让它直接碰生产环境。涉及权限、密钥、数据库迁移、资金或正式发布的操作，仍然走独立分支、代码审查和明确的发布门控。

还有两件事要分清。

第一，Claude 的订阅费和 DeepSeek API 费用不是一回事。接入第三方模型后，DeepSeek 依然按 API 使用量收费。

第二，桌面客户端的 Gateway 设置和终端版 Claude Code 的环境变量配置不是同一套入口。本文记录的是 Desktop 的操作，不要直接照搬到终端环境里。

这次最大的收获不是省下几分钱，而是多了一个能实际干活的选择。模型是否划算，最终还是看真实项目里的返工率、耗时和账单。配置跑通只是开始。

记录时间：2026 年 10 月 19 日。客户端界面和模型映射可能随版本变化；如遇不同报错，以当前服务端文档和实际请求结果为准。

本文记录作者在特定时间、信息条件和经营背景下形成的个人判断，不构成投资、法律、财务或其他专业建议。

如果你有不同的实践或想交流这次决策，可以给我写邮件。