实战SOP｜2 个环境变量，用 DeepSeek-V4-Pro 跑通 Claude Code

DeepSeek-V4-Pro-0813 原生支持 Anthropic API 兼容，意味着你原来跑 Claude Code 的终端，改两个核心环境变量就能切到 DeepSeek--用 DeepSeek 的价跑 Claude Code 的体验。有两条路：一条是官方 Claude Code CLI + 环境变量（DeepSeek 官方给了接入指南），一条是开源 Cline 扩展 + 自定义 base URL。选错变量或混用 key 类型等于白配--Claude Code 要 ANTHROPIC_AUTH_TOKEN，Anthropic SDK 要 ANTHROPIC_API_KEY，两者不是一回事。

这套 SOP 走完五步：装工具 -> 取 key -> 配环境变量 -> 跑起来 -> 验证。与本批 Cline 接 DeepSeek 开源解析（开源 agent 深入）、前沿编码模型横评（为什么选 DeepSeek）互补：那两篇解决「选什么、为什么」，这篇解决「怎么动手接」。环境变量与安装命令据 DeepSeek 官方「接入 Claude Code」指南核实，Cline 步骤据其官方文档核实，以官网为准。与本站 Claude Code vs Cursor vs Codex 划清地盘--那篇比工具，这篇讲接 DeepSeek 的实操。

一、两条路线：Claude Code CLI vs 开源 Cline

核心决策在动手前就定了：你要官方终端流，还是开源编辑器内 agent。

一句话：要终端流走 Claude Code CLI；要在编辑器里可视化操作走 Cline。两条路底层都指向 https://api.deepseek.com/anthropic，只是配置入口不同。

二、SOP 五步流程

Step 1：装工具

Claude Code CLI 路线。 先装依赖：Node.js 18+；Windows 用户需装 Git for Windows。然后装 Claude Code：

npm install -g @anthropic-ai/claude-code

验证安装：

claude --version

显示版本号即成功。

Cline 路线。 在 VS Code 扩展市场搜「Cline」安装，或从 GitHub Releases 下 vsix。装好侧边栏出现 Cline 面板。无需 Node 环境。

Step 2：取 DeepSeek API Key

到 DeepSeek Platform 注册并创建 API Key，复制保存（创建后只显示一次）。这个 key 是接 DeepSeek 的凭证，Claude Code 和 Cline 用的都是它。

Step 3：配环境变量 / base URL

Claude Code CLI 路线（核心两变量 + 推荐补齐）。 DeepSeek 官方接入指南给的环境变量如下。

Linux / Mac（终端直接执行）：

export ANTHROPIC_BASE_URL=https://api.deepseek.com/anthropic
export ANTHROPIC_AUTH_TOKEN=<你的 DeepSeek API Key>
export ANTHROPIC_MODEL=deepseek-v4-pro[1m]
export ANTHROPIC_DEFAULT_OPUS_MODEL=deepseek-v4-pro[1m]
export ANTHROPIC_DEFAULT_SONNET_MODEL=deepseek-v4-pro[1m]
export ANTHROPIC_DEFAULT_HAIKU_MODEL=deepseek-v4-flash
export CLAUDE_CODE_SUBAGENT_MODEL=deepseek-v4-flash
export CLAUDE_CODE_EFFORT_LEVEL=max
export CLAUDE_CODE_AUTO_COMPACT_WINDOW=786432

Windows（PowerShell 执行）：

$env:ANTHROPIC_BASE_URL="https://api.deepseek.com/anthropic"
$env:ANTHROPIC_AUTH_TOKEN="<你的 DeepSeek API Key>"
$env:ANTHROPIC_MODEL="deepseek-v4-pro[1m]"
$env:ANTHROPIC_DEFAULT_OPUS_MODEL="deepseek-v4-pro[1m]"
$env:ANTHROPIC_DEFAULT_SONNET_MODEL="deepseek-v4-pro[1m]"
$env:ANTHROPIC_DEFAULT_HAIKU_MODEL="deepseek-v4-flash"
$env:CLAUDE_CODE_SUBAGENT_MODEL="deepseek-v4-flash"
$env:CLAUDE_CODE_EFFORT_LEVEL="max"
$env:CLAUDE_CODE_AUTO_COMPACT_WINDOW="786432"

两个核心变量是 ANTHROPIC_BASE_URL（指向 DeepSeek 兼容接口）和 ANTHROPIC_AUTH_TOKEN（你的 DeepSeek key）。其余是推荐补齐：ANTHROPIC_MODEL=deepseek-v4-pro[1m] 指定 1M 上下文档的 Pro 模型；*_HAIKU_MODEL 和 CLAUDE_CODE_SUBAGENT_MODEL 用便宜的 Flash 跑子任务控成本；CLAUDE_CODE_AUTO_COMPACT_WINDOW=786432（约 768K）配 1M 上下文用。[1m] 后缀是 1M 上下文变体标识。

Cline 路线。 打开 Cline 面板设置（齿轮图标），API Provider 选「Anthropic」，勾「Use custom base URL」，填 https://api.deepseek.com/anthropic，Anthropic API Key 填你的 DeepSeek key，Model 填 deepseek-v4-pro（或 deepseek-v4-flash 走轻量档）。保存即可。

Step 4：跑起来

Claude Code CLI 路线。 配完环境变量后，进项目目录启动：

cd /path/to/my-project
claude

此时 Claude Code 底层走的是 DeepSeek-V4-Pro，不是 Anthropic 官方服务。在终端里照常用 Claude Code 的交互（给任务、看它改代码、批操作）。

Cline 路线。 在 VS Code 打开项目，点开 Cline 侧边栏，给一个任务（如「给这个函数加错误处理并补单测」），它会自主拆步、改文件、跑命令，每步等你确认。

Step 5：验证接通了 DeepSeek

启动后先确认底层确实切到了 DeepSeek，别在 Anthropic 官方服务上烧钱。两个办法。第一，故意不设官方 Anthropic key、只留 DeepSeek 的 ANTHROPIC_AUTH_TOKEN，能正常跑通说明走的就是 DeepSeek。第二，发一句简单问询，看响应风格与速度是否符合 DeepSeek 表现，并在 DeepSeek Platform 后台看 token 用量是否增加。确认接通后再开干正式任务。

三、五个踩坑

坑 1：ANTHROPIC_AUTH_TOKEN 和 ANTHROPIC_API_KEY 不是一回事 DeepSeek 文档里两个名字都出现，容易混。「使用 Anthropic API」页（给 Python/Node SDK 用的）写的是 ANTHROPIC_API_KEY；「接入 Claude Code」页（给 Claude Code CLI 用的）写的是 ANTHROPIC_AUTH_TOKEN。Claude Code 认 ANTHROPIC_AUTH_TOKEN，你设成 ANTHROPIC_API_KEY 它可能不认。修法：Claude Code 一律用 ANTHROPIC_AUTH_TOKEN 装 DeepSeek key；SDK 调用用 ANTHROPIC_API_KEY。别张冠李戴。

坑 2：接口兼容不等于能力等价，复杂工作流要回归测试 DeepSeek 的 Anthropic 兼容层覆盖接口格式，但工具调用细节、prompt 缓存行为、长上下文稳定性跟原版 Claude 有差异。Claude Code 原为 Claude 优化的某些 tool call 流程迁过来可能偶发不稳。修法：正式项目前用你的真实任务跑一轮回归，别假设「能跑通就等于表现一致」。复杂 agent 工作流尤其要测工具调用和长上下文。

坑 3：思考模式默认开，token 消耗比纸面单价高 DeepSeek-V4-Pro 思考模式默认开，模型先吐推理 token 再出答案，思考 token 也计费。CLAUDE_CODE_EFFORT_LEVEL=max 进一步拉满推理深度，账单涨得更明显。修法：要省钱的场景把 effort 调低或显式切非思考模式；子任务用 deepseek-v4-flash（CLAUDE_CODE_SUBAGENT_MODEL）控成本。纸面 6 元/M 输出不等于实际账单。

坑 4：DeepSeek 挂了涨价预警，别按现价做长期成本假设 官方在价格页明确说计划近期整体大幅上调定价。现在 Pro 输出 6 元/M、Flash 2 元/M、缓存命中 0.025 元/M 的低价窗口可能收窄。修法：趁现在压缓存命中率（系统提示和代码上下文复用率高，缓存命中价低到可忽略）；重度依赖别赌它一直便宜，关注官方调价通知。

坑 5：Windows 环境变量只对当前 PowerShell 会话生效 $env:VAR="..." 设的变量关掉 PowerShell 就没了，下次开终端又得重设，忘了就会回退到官方 Anthropic（报错或烧钱）。修法：要么写进 PowerShell Profile 持久化，要么用系统环境变量（系统属性->环境变量）永久设，要么用 .env 文件配合启动脚本。生产用建议系统环境变量，别依赖临时会话。

常见问题

Q1：Claude Code 接 DeepSeek 最少要设哪几个变量？ A1：核心两个：ANTHROPIC_BASE_URL=https://api.deepseek.com/anthropic 和 ANTHROPIC_AUTH_TOKEN=<DeepSeek key>。其余（ANTHROPIC_MODEL=deepseek-v4-pro[1m]、子任务用 Flash 等）是推荐补齐，用来指定 1M 上下文档和控成本。注意 Claude Code 认 ANTHROPIC_AUTH_TOKEN 不是 ANTHROPIC_API_KEY。

Q2：deepseek-v4-pro[1m] 里的 [1m] 是什么？ A2：1M 上下文变体标识。DeepSeek-V4-Pro 上下文 1M、最大输出 384K，[1m] 后缀指定走 1M 上下文档。不加可能走默认档。配 Claude Code 时官方指南就是用 deepseek-v4-pro[1m]。

Q3：Cline 和 Claude Code 接 DeepSeek 有什么区别？ A3：配置入口不同。Claude Code（终端 CLI）走环境变量；Cline（VS Code 扩展）在设置里选 Anthropic provider、勾自定义 base URL 填 https://api.deepseek.com/anthropic。底层都指向同一个 DeepSeek 兼容接口。要终端流选 Claude Code，要编辑器内可视化操作选 Cline。

Q4：接通后怎么确认真的走 DeepSeek 而不是 Anthropic？ A4：两个办法。一是只留 DeepSeek 的 ANTHROPIC_AUTH_TOKEN、不设官方 Anthropic key，能跑通说明走 DeepSeek。二是发问询后看 DeepSeek Platform 后台 token 用量是否增加。确认接通后再开正式任务，避免在官方服务上意外烧钱。

Q5：思考模式默认开会多花钱吗？ A5：会。思考模式先输出推理 token 再给答案，思考 token 也计费，CLAUDE_CODE_EFFORT_LEVEL=max 进一步拉满推理深度。长任务实际消耗比纸面单价高。要省钱把 effort 调低或切非思考模式，子任务用 deepseek-v4-flash 控成本。按真实任务测实际账单，别只看 6 元/M 的纸面价。

参考来源

• DeepSeek 官方 API 文档 · 接入 Claude Code（环境变量与安装步骤，核心依据）：https://api-docs.deepseek.com/zh-cn/quick_start/agent_integrations/claude_code
• DeepSeek 官方 API 文档 · 使用 Anthropic API（base_url 与 SDK 用 ANTHROPIC_API_KEY）：https://api-docs.deepseek.com/zh-cn/guides/anthropic_api
• DeepSeek 官方 API 文档 · 模型 & 价格（思考模式、上下文、定价、涨价预警）：https://api-docs.deepseek.com/zh-cn/quick_start/pricing
• Cline 官方文档 · Anthropic provider（自定义 base URL）：https://docs.cline.bot/provider-config/anthropic
• 本站《Cline 接 DeepSeek 开源解析》：https://aiwebcool.com/zh/cline-deepseek-coding-agent-resource
• 本站《DeepSeek-V4-Pro-0813 热点》：https://aiwebcool.com/zh/deepseek-v4-pro-0813-hotspot