DeepSeek V4 接入 Claude Code 简易指南

Introduction

2026 年 4 月 24 日，DeepSeek v4 版本发布。官方提供了旗舰模型 DeepSeek v4 Pro 和小模型 DeepSeek v4 Flash 两个版本。在官方文档中，也提供了简易的 Claude Code 接入指南，但是这个指南个人认为并非最佳配置形式，所以在后文给出我的更加合理的配置方案。

1. DeepSeek 给出的配置以及此配置的相关问题

1.1. DeepSeek 配置方案

DeepSeek 给出的 Claude Code 配置方法与通过 Amazon Bedrock 配置 Claude 模型的方法有些相似，不过 DeepSeek 只给出了通过环境变量配置的方法。而且 DeepSeek 也分别在 4 月 24 日和 4 月 25 日更新了两版本配置内容，这两版内容均有相应的槽点。

4 月 24 日版配置：

 1export ANTHROPIC_BASE_URL=https://api.deepseek.com/anthropic
 2export ANTHROPIC_AUTH_TOKEN=${DEEPSEEK_API_KEY}
 3export ANTHROPIC_MODEL=deepseek-v4-pro[1m]
 4export ANTHROPIC_DEFAULT_OPUS_MODEL=deepseek-v4-pro
 5export ANTHROPIC_DEFAULT_SONNET_MODEL=deepseek-v4-pro
 6export ANTHROPIC_DEFAULT_HAIKU_MODEL=deepseek-v4-flash
 7export CLAUDE_CODE_SUBAGENT_MODEL=deepseek-v4-pro
 8export CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1
 9export CLAUDE_CODE_DISABLE_NONSTREAMING_FALLBACK=1
10export CLAUDE_CODE_EFFORT_LEVEL=max

4 月 25 日版配置：

1export ANTHROPIC_BASE_URL=https://api.deepseek.com/anthropic
2export ANTHROPIC_AUTH_TOKEN=<你的 DeepSeek API Key>
3export ANTHROPIC_MODEL=deepseek-v4-pro[1m]
4export ANTHROPIC_DEFAULT_OPUS_MODEL=deepseek-v4-pro[1m]
5export ANTHROPIC_DEFAULT_SONNET_MODEL=deepseek-v4-pro[1m]
6export ANTHROPIC_DEFAULT_HAIKU_MODEL=deepseek-v4-flash
7export CLAUDE_CODE_SUBAGENT_MODEL=deepseek-v4-flash
8export CLAUDE_CODE_EFFORT_LEVEL=max

1.2. 相关问题

第一个问题就是，如今更为推荐的 Claude Code 配置方法，是通过 ~/.claude/settings.json 进行配置（Windows 的 ～/ 对应当前用户文件夹）。这个配置文件可以被 CLI 和 VSCode Extension 共同消费使用，并且不会污染系统环境变量。

第二个问题在于，ANTHROPIC_MODEL 这个变量在配置了 DEFAULT OPUS/SONNET/HAIKU 模型之后，是无需配置的。最新版的 Claude Code 并不会从这个变量去读取当前需要使用的模型，而是通过 settings.json 中的 model 字段进行偏好记忆控制。在实际使用时，按需切换 OPUS/SONNET/HAIKU 模型即可（我配置公司的 Amazon Bedrock Claude Model 也是按此方式操作的，没有任何的使用问题）。

在实践中，将 OPUS/SONNET 映射为 DeepSeek-v4-Pro，而 HAIKU 映射为 DeepSeek-v4-Flash 的做法是正确的（因为这个 Flash 模型实在是很小，甚至比当年的 DeepSeek-R1（标准版，非蒸馏版）还要小的多……也只能将其映射为 HAIKU 的定位了……）

参考链接：Claude Code Docs - Model Configuration #setting-your-model

第三个问题，其实官方 4 月 25 的新版配置修正了一部分，即为 DEFAULT OPUS/SONNET 模型添加了 [1m] 参数。因为官方配置的方法非常类似于通过 Amazon Bedrock 配置 Claude 模型的方法，所以 [1m] 参数是最快速启用 1M 上下文的手段。这样在切换 Opus/Sonnet 模型时，其映射的 DeepSeek v4 Pro 模型可以开启 1M 上下文参数（而非默认的 200K）。

更进一步的，其实 DEFAULT HAIKU 模型的配置也可以添加 [1m] 参数。虽然 Claude Haiku 只有 200K 上下文，但是通过映射后的 DeepSeek v4 Flash 是可以开启 1M 上下文的（可以通过 /context 进行验证）。

参考链接：Claude Code Docs - Model Configuration #pin-models-for-third-party-deployments

最后一个问题，就是 CLAUDE_CODE_SUBAGENT_MODEL 不应该被配置。两个版本 DeepSeek 官方文档非常难绷的将 SubAgent 的模型强制锁定为了 Pro/Flash 二选一，但实际上，Claude Code 大量的 Build-in SubAgent 会根据任务的种类，使用不同的 Haiku/Sonnet/Inherit 模型进行工作负载的高低按需运行（更加具备经济性、省钱）。

在配置了 DEFAULT OPUS/SONNET/HAIKU 模型之后，CLAUDE_CODE_SUBAGENT_MODEL 更是无需被配置。

参考链接：Claude Code Docs - Create custom subAgents #built-in-subagents

至于 CLAUDE_CODE_EFFORT_LEVEL，按照官方的建议直接配置为 max 即可，Claude Code 会自行将 max 映射为 OPUS/SONNET/HAIKU 实际能用的 Effort，而 DeepSeek API 则可以正确将这些 Effort Level 映射为 High/MAX 级别，非常省心。

参考链接:
Claude Code Docs - Model Configuration #adjust-effort-level
DeepSeek API Docs - Thinking Mode

2. 更合理的配置方法

2.1. 配置位置

Posix（Linux/Mac）推荐在 ~/.claude/settings.json 中配置。

Windows 则推荐在 C:\Users\<你的实际用户名>\.claude\settings.json 中配置。

以上文件若不存在，自行创建即可。

2.2. 配置内容

 1{
 2  "$schema": "https://json.schemastore.org/claude-code-settings.json",
 3  "env": {
 4    "ANTHROPIC_BASE_URL": "https://api.deepseek.com/anthropic",
 5    "ANTHROPIC_AUTH_TOKEN": "<你的 DeepSeek API Key>",
 6    "ANTHROPIC_DEFAULT_OPUS_MODEL": "deepseek-v4-pro[1m]",
 7    "ANTHROPIC_DEFAULT_SONNET_MODEL": "deepseek-v4-pro[1m]",
 8    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "deepseek-v4-flash[1m]",
 9    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1",
10    "CLAUDE_CODE_DISABLE_NONSTREAMING_FALLBACK": "1",
11    "CLAUDE_CODE_EFFORT_LEVEL": "max"
12  },
13  "model": "opus"
14}

2.3. 使用

配置完成后，Claude Code CLI 和 VSCode Extension（需要 disable login，参考官方文档）中即可使用 DeepSeek v4 系列模型了。

版权声明：本文遵循 CC BY-SA 4.0 版权协议，转载请附上原文出处链接和本声明。
Copyright statement: This article follows the CC BY-SA 4.0 copyright agreement. For reprinting, please attach the original source link and this statement.