中/EN
实战 SOP
实战 SOP

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

DeepSeek-V4-Pro 接 Claude Code 实战 SOP：2 个核心环境变量（ANTHROPIC_BASE_URL + ANTHROPIC_AUTH_TOKEN）+ Cline 自定义 base URL 双路线。5 步：装工具->取key->配变量->跑->验证。含官方核实命令+5 踩坑（AUTH_TOKEN≠API_KEY/兼容≠等价/思考计费/涨价预警/Win会话变量）+5 FAQ。

发布于 2026年8月13日8 分钟阅读
<!-- deepseek-v4-pro-claude-code-sop | sop | 实战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 扩展路线
代表工具Claude Code（Anthropic 官方 CLI）Cline（6.6 万星开源 VS Code 扩展，Apache-2.0）
接 DeepSeek 方式环境变量（ANTHROPIC_BASE_URL + AUTH_TOKEN）设置里自定义 base URL
形态终端VS Code 侧边栏
开源闭源开源
适合纯终端流、要官方体验在 VS Code 里干活、要 provider 可换

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

二、SOP 五步流程

Step 1：装工具

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

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

验证安装：

bash
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（终端直接执行）：

bash
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 执行）：

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 路线。 配完环境变量后，进项目目录启动：

bash
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 的纸面价。

参考来源

本文由 AI 辅助生成，经人工审核编辑。最后更新：2026-08-13

常见问题

Claude Code 接 DeepSeek 最少要设哪几个变量？
核心两个：`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`。
`deepseek-v4-pro[1m]` 里的 [1m] 是什么？
1M 上下文变体标识。DeepSeek-V4-Pro 上下文 1M、最大输出 384K，`[1m]` 后缀指定走 1M 上下文档。不加可能走默认档。配 Claude Code 时官方指南就是用 `deepseek-v4-pro[1m]`。
Cline 和 Claude Code 接 DeepSeek 有什么区别？
配置入口不同。Claude Code（终端 CLI）走环境变量；Cline（VS Code 扩展）在设置里选 Anthropic provider、勾自定义 base URL 填 `https://api.deepseek.com/anthropic`。底层都指向同一个 DeepSeek 兼容接口。要终端流选 Claude Code，要编辑器内可视化操作选 Cline。
接通后怎么确认真的走 DeepSeek 而不是 Anthropic？
两个办法。一是只留 DeepSeek 的 `ANTHROPIC_AUTH_TOKEN`、不设官方 Anthropic key，能跑通说明走 DeepSeek。二是发问询后看 DeepSeek Platform 后台 token 用量是否增加。确认接通后再开正式任务，避免在官方服务上意外烧钱。
思考模式默认开会多花钱吗？
会。思考模式先输出推理 token 再给答案，思考 token 也计费，`CLAUDE_CODE_EFFORT_LEVEL=max` 进一步拉满推理深度。长任务实际消耗比纸面单价高。要省钱把 effort 调低或切非思考模式，子任务用 `deepseek-v4-flash` 控成本。按真实任务测实际账单，别只看 6 元/M 的纸面价。

相关文章

实战 SOP

Claude Code 接 DeepSeek：官方九变量，别抄旧教程

Claude Code 接 DeepSeek 的官方直连 SOP，全部命令与变量取自 DeepSeek 官方指南（api-docs.deepseek.com/quick_start/agent_integrations/claude_code），对应 1017 checkpoint 上线后的现役配置。主攻搜索词「Claude Code 接 DeepSeek」（S1=3/S2=1/S3=2/S4=3）。迁移路径九项环境变量：ANTHROPIC_BASE_URL 指向 https://api.deepseek.com/anthropic、ANTHROPIC_AUTH_TOKEN 填 DeepSeek API Key、ANTHROPIC_MODEL=deepseek-flash[1m]、DEFAULT_OPUS/SONNET 同为 deepseek-flash[1m]、DEFAULT_HAIKU=deepseek-flash、CLAUDE_CODE_SUBAGENT_MODEL=deepseek-flash、CLAUDE_CODE_EFFORT_LEVEL=max、CLAUDE_CODE_AUTO_COMPACT_WINDOW=786432；Windows PowerShell 与 Linux/Mac 两版写法都给。从零安装四步：Node.js 18+（Windows 另装 Git for Windows）、npm install -g @anthropic-ai/claude-code、claude --version 验证、配变量后进项目目录运行。模型映射：claude-opus 开头的请求映射到 deepseek-v4-pro（按 V4 Pro 价计费，比 Flash 贵，必读提醒）、claude-haiku/sonnet 映射到 deepseek-flash。Web Search 原生可用但两条计费线：搜索请求按 Search API 计费，对检索内容的摘要另产生 token 费。价格口径（官方定价页）：off-peak 每百万输入 0.15 美元（cache miss）、0.003 cache hit（约为 miss 的五十分之一）、输出 0.60 美元，peak（工作日 UTC 01:00-04:00 与 06:00-10:00）双倍，周末与中国法定节假日算 off-peak。常见坑五条：AUTH_TOKEN 与 API_KEY 不是一回事（混用等于白配）、新旧变量并存可能鉴权冲突（只留新变量，社区教程口径）、密钥不进 settings.json 不入 git（固化用 ~/.bashrc、~/.zshrc 或系统环境变量）、接好后先跑「读一个文件再改一个文件」最小任务验证工具调用链路、/status 查当前生效模型。市面旧教程多残留 deepseek-chat 等已退休模型名。与站内分工：deepseek-v4-pro-claude-code-sop 是 V4-Pro-0813 时代「2 个环境变量」最小配置（2026-09），本篇是 1017 后官方现役全量配置；Harness 本体入门见 deepseek-harness-quickstart-sop。

2026年10月19日10 分钟阅读
实战 SOP

Claude Code子代理实战：终端里养一支分身工程队

Claude Code 子代理实战 SOP（口径 2026-10-08，与站内 Haiku 5.5 热点篇联动）：从 /agents 命令到一支并行分身工程队。文件位置与优先级：.claude/agents/（项目级）压过 ~/.claude/agents/（用户级），markdown+YAML frontmatter 即生效。字段逐个讲透：name（小写连字符）、description（决定自动委派，教写 Use PROACTIVELY/MUST BE USED 触发语）、tools（省略即全继承——最小权限原则劝你显式列）、model（sonnet/opus/haiku/inherit，省略默认 sonnet）、permissionMode、skills（不继承父级）、hooks（PreToolUse/PostToolUse/Stop，once 不支持）。模型路由策略：查找/摘要/分类/抽取给 haiku，多文件改动给 sonnet，架构决策给 opus（社区生产口径的成本对比：单任务 0.03/0.24/1.20 美元，标注单源）。隔离机制：子代理独立上下文只回传摘要、不能再派子代理（Task 不下发）、实现类任务留在主代理（Anthropic 官方口径）。与 Haiku 5.5 联动：model: haiku 直接吃新模型，Claude Code v2.1.292 新增 Agent 工具 effort 参数与 claude plugin install --marketplace（release note 口径）。四个可直接抄的配置骨架（code-reviewer/security-reviewer/debugger/test-writer）与四类翻车清单。

2026年10月8日9 分钟阅读
实战 SOP

改一行 base_url 白嫖 500 万 tokens：1.6T 旗舰进 Agent

把 LongCat-2.5-Preview 接进现有 Agent 工具链的三条路线实操 SOP，按门槛递进：①网页直用（longcat.ai 官网登录，对话传图与简单 Agent 任务）；②OpenAI 协议接入（base_url 改 https://api.longcat.ai/openai，模型 ID LongCat-2.5-Preview，现有 OpenAI SDK 零迁移）；③Anthropic 协议接 Claude Code（ANTHROPIC_BASE_URL / ANTHROPIC_AUTH_TOKEN / ANTHROPIC_MODEL 三个环境变量），Codex、OpenClaw、OpenCode、Kilo Code 同理换 base_url 与模型名。附 1M 上下文与 128K 输出的用法提示、500 万免费 tokens 福利（转述口径）与 Preview 阶段局限（无公开 benchmark、权重未放出、接口可能调整），上线前先小流量验证价格延迟成功率。

2026年9月29日10 分钟阅读