# DeepSeek V4 接 Claude Code：从零到跑通配置教程

**副标题：** 官方 Anthropic 兼容端点、环境变量、`[1m]` 模型名、子 Agent 用 Flash——附 OpenClaw / OpenCode 与常见报错

---

上一篇《DeepSeek V4：1M 上下文 Agent 编码》讲了 **值不值得接**。

这篇直接 **手把手配**——按 DeepSeek 官方 [Claude Code 集成文档](https://api-docs.deepseek.com/quick_start/agent_integrations/claude_code) 整理，并补上持久化配置、子 Agent 省钱、验通步骤和踩坑清单。

**适用读者**：已有 Claude Code，想把后端从 Anthropic API 切到 DeepSeek V4，**保留** CLAUDE.md、Skills、MCP、终端工作流。

---

## 一、原理：为什么只改环境变量就能跑？

Claude Code 通过 **Anthropic Messages API** 调模型。DeepSeek 提供了 **格式兼容的代理端点**：

| 项目 | 值 |
|------|-----|
| Anthropic 兼容 Base URL | `https://api.deepseek.com/anthropic` |
| 鉴权变量 | `ANTHROPIC_AUTH_TOKEN`（填 DeepSeek API Key） |
| 主模型 | `deepseek-v4-pro[1m]` 或 `deepseek-v4-flash` |

Claude Code **UI 和命令不变**，变的是请求发往 DeepSeek 而非 Anthropic。

官方还提供 **模型名自动映射**（你不显式指定时）：

| Claude 模型前缀 | 映射到 |
|----------------|--------|
| `claude-opus-*` | `deepseek-v4-pro` |
| `claude-sonnet-*` / `claude-haiku-*` | `deepseek-v4-flash` |

**建议仍显式配置环境变量**，避免版本差异导致映射不符合预期。

---

## 二、准备清单（5 分钟）

| # | 项 | 说明 |
|---|-----|------|
| 1 | Node.js 18+ 或原生安装器 | `curl -fsSL https://claude.ai/install.sh \| bash` |
| 2 | Claude Code CLI | `claude --version` 能输出版本号 |
| 3 | DeepSeek API Key | [platform.deepseek.com/api_keys](https://platform.deepseek.com/api_keys) |
| 4 | 账户余额 | 按量计费，Agent 任务建议先充小额试跑 |
| 5 | 日历提醒 | `deepseek-chat` / `deepseek-reasoner` **2026-07-24** 退役 |

**不适用场景**：

- **Claude Pro/Max 订阅用户**：订阅不走这套 API 代理，本文针对 **API Key 计费**
- **Claude Desktop OAuth**：Desktop 不读 `ANTHROPIC_AUTH_TOKEN`，需在 **终端 / VS Code 插件** 配置

---

## 三、核心配置：环境变量（复制即用）

### macOS / Linux（当前终端会话）

```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
```

### 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"
```

### 各变量含义

| 变量 | 作用 |
|------|------|
| `ANTHROPIC_BASE_URL` | 指向 DeepSeek Anthropic 兼容端点 |
| `ANTHROPIC_AUTH_TOKEN` | DeepSeek API Key（不是 Anthropic Key） |
| `ANTHROPIC_MODEL` | 默认主模型 |
| `ANTHROPIC_DEFAULT_*_MODEL` | 对应 Claude 档位映射 |
| `CLAUDE_CODE_SUBAGENT_MODEL` | **子 Agent / Workflow 扇出** 用 Flash，大幅省钱 |
| `CLAUDE_CODE_EFFORT_LEVEL=max` | 复杂 Agent 任务开满推理深度（官方推荐） |

### `[1m]` 后缀别忘了

`deepseek-v4-pro[1m]` 显式请求 **1M 上下文**。不加后缀可能落到更短默认窗口——做全库分析时务必带上。

---

## 四、持久化：写入 `settings.json`（推荐）

每次开终端 `export` 太麻烦。写入 Claude Code 配置即可全局生效：

**路径**：`~/.claude/settings.json`（用户级）或项目内 `.claude/settings.json`

```json
{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.deepseek.com/anthropic",
    "ANTHROPIC_AUTH_TOKEN": "<你的 DeepSeek API Key>",
    "ANTHROPIC_MODEL": "deepseek-v4-pro[1m]",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "deepseek-v4-pro[1m]",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "deepseek-v4-pro[1m]",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "deepseek-v4-flash",
    "CLAUDE_CODE_SUBAGENT_MODEL": "deepseek-v4-flash",
    "CLAUDE_CODE_EFFORT_LEVEL": "max"
  }
}
```

**安全提示**：API Key 明文落盘有泄露风险。更稳妥做法是用 shell 的 `export` + 密钥管理工具，或项目级 `.claude/settings.local.json`（加入 `.gitignore`）。

### 写入 `~/.zshrc` / `~/.bashrc`（备选）

把第三节的 `export` 块追加到 shell 配置，新开终端自动加载。

---

## 五、验通三步（30 秒确认没配错）

```bash
cd /path/to/your-project
claude
```

在 Claude Code 会话内：

**1. 看状态**

```text
/status
```

确认 Base URL 含 `api.deepseek.com/anthropic`，模型为 `deepseek-v4-pro[1m]` 或你指定的型号。

**2. 跑只读小任务**

```text
Summarize the purpose of README.md in 3 bullet points.
```

**3. 测工具调用（Agent 必测）**

```text
List the top-level directories in this repo and count .md files.
```

若三步都正常，说明 **主模型 + 工具链** 基本可用。

### 用 curl 单独验 Key（可选）

```bash
curl https://api.deepseek.com/anthropic/v1/messages \
  -H "content-type: application/json" \
  -H "x-api-key: <你的 DeepSeek API Key>" \
  -H "anthropic-version: 2023-06-01" \
  -d '{
    "model": "deepseek-v4-flash",
    "max_tokens": 100,
    "messages": [{"role": "user", "content": "ping"}]
  }'
```

能返回 JSON 即 Key 和端点有效。

---

## 六、和系列方法论怎么配合？

| 你已搭建的 | 接 DeepSeek 后 |
|-----------|---------------|
| **Skills**（C01） | 完全保留；长 SKILL.md 受益于 1M 上下文 |
| **Dynamic Workflows**（C02） | 主 Agent Pro，扇出子 Agent 走 `CLAUDE_CODE_SUBAGENT_MODEL=flash` |
| **Bun 式大迁移**（C03） | 可行，但务必设 Token 预算 + 测试门禁 |
| **Cursor 组合**（已发文） | Cursor 仍可用；Claude Code 终端 Agent 换 DeepSeek 后端 |

**推荐混合栈**：

- **编排 / 关键决策**：V4-Pro `[1m]`
- **Reviewer / 子任务 / 批量扫文件**：V4-Flash
- **merge 责任**：仍在人手里，不因模型便宜就放松验收

---

## 七、省钱配置：三档方案

| 档位 | 主模型 | 子 Agent | effort | 适合 |
|------|--------|---------|--------|------|
| **性能档** | `deepseek-v4-pro[1m]` | `deepseek-v4-flash` | `max` | 复杂重构、长时 Workflow |
| **均衡档** | `deepseek-v4-pro[1m]` | `deepseek-v4-flash` | `high` | 日常开发 |
| **省钱档** | `deepseek-v4-flash` | `deepseek-v4-flash` | 默认 | 探索、小改动、练手 |

**Cache 提示**：重复 system prompt、稳定 CLAUDE.md 前缀会命中 DeepSeek **cache hit** 价（Flash 输入约 **$0.0028/M**），长会话越跑越省。

---

## 八、OpenClaw / OpenCode 快速接入

### OpenClaw（飞书 / 微信等 IM Agent）

```bash
curl -fsSL https://openclaw.ai/install.sh | bash
openclaw onboard --install-daemon
```

配置向导中选择：

- Provider → **DeepSeek**
- API Key → 你的 Key
- Default model → `deepseek-v4-pro` 或 `deepseek-v4-flash`

启动：

```bash
openclaw dashboard   # Web UI
openclaw tui         # 终端 TUI
```

### OpenCode（开源终端 / Web Agent）

1. 安装 OpenCode（版本建议 **≥ v1.14.24**）
2. 运行 `opencode`，输入 `/connect`
3. 选 `deepseek`，填入 API Key
4. 选 **DeepSeek-V4-Pro** 模型

---

## 九、常见报错与修复

| 现象 | 原因 | 修复 |
|------|------|------|
| `401 Unauthorized` | Key 错或未设 `ANTHROPIC_AUTH_TOKEN` | 确认用 DeepSeek Key；部分版本需同时设 `ANTHROPIC_API_KEY` |
| `404 model not found` | 旧模型名 `deepseek-chat` | 改为 `deepseek-v4-pro[1m]` / `deepseek-v4-flash` |
| `API streaming failed` | Base URL 写错 | 必须是 `https://api.deepseek.com/anthropic`，**无尾部斜杠** |
| 工具调用后 400 | thinking 模式未回传 reasoning | 确认用官方 Anthropic 端点；升级 Claude Code 到最新版 |
| 仍走 Anthropic 账单 | 环境变量未加载 | 检查 `settings.json` 路径；`echo $ANTHROPIC_BASE_URL` |
| 子 Agent 很贵 | 未设 SUBAGENT 变量 | 设 `CLAUDE_CODE_SUBAGENT_MODEL=deepseek-v4-flash` |

**流式问题可加**（社区常用）：

```bash
export CLAUDE_CODE_DISABLE_NONSTREAMING_FALLBACK=1
```

---

## 十、能力边界：什么能用、什么不能

### ✅ 继续可用

- `CLAUDE.md` / `AGENTS.md`
- 项目 Skills（`.claude/skills`）
- MCP 服务器（stdio 传输）
- 会话历史、`/resume`
- Dynamic Workflows、`ultracode` 触发词
- DeepSeek 原生 **Web Search**（模型判断需要时会调搜索，**额外计费**）

### ❌ 不可用或受限

- 依赖 **Anthropic 后端基础设施** 的闭源功能（如部分 beta 特性）
- Anthropic 官方签名 Skills 的独占能力
- 图像 / 文档多模态输入（DeepSeek Anthropic API **不支持** image/document 类型）
- `mcp_tool_use` 等部分 Anthropic 新消息类型（见[兼容表](https://api-docs.deepseek.com/guides/anthropic_api)）

**结论**：日常编码 Agent **够用**；要 100% Anthropic 新特性首发，仍需原生 Claude API。

---

## 十一、切回 Anthropic（随时可逆）

```bash
unset ANTHROPIC_BASE_URL
unset ANTHROPIC_AUTH_TOKEN
unset ANTHROPIC_MODEL
unset CLAUDE_CODE_SUBAGENT_MODEL
unset CLAUDE_CODE_EFFORT_LEVEL
```

或临时注释 `settings.json` 里的 `env` 块，新开 `claude` 会话即回默认 Anthropic 路由。

---

## 十二、合规提醒（企业读者必读）

接 DeepSeek API 时，**代码、Prompt、工具输出会经 DeepSeek 服务器处理**，数据治理规则与 Anthropic 不同。

- 开源 / 个人项目：风险与使用任意云 API 类似
- 企业专有代码、客户数据、凭证：**先过合规评审**再接入
- 生产密钥、PII：**不要**放进 Agent 可读目录

---

## 十三、与系列衔接

| 前文 | 本文补上 |
|------|---------|
| D01 V4 能力解读 | 可复制的 Claude Code 配置 |
| C02 Dynamic Workflows | `SUBAGENT_MODEL=flash` 省钱扇出 |
| Cursor + Claude 成本控制 | 混合栈落地第一步 |

**下一篇**：**D04** Claude Code + V4 Flash **成本实测账本**（同样任务 Anthropic vs DeepSeek 账单对比）。

---

## 十四、结论

DeepSeek V4 接 Claude Code 的核心就四步：

1. Base URL 改到 `https://api.deepseek.com/anthropic`
2. `ANTHROPIC_AUTH_TOKEN` 填 DeepSeek Key
3. 主模型 `deepseek-v4-pro[1m]`，子 Agent `deepseek-v4-flash`
4. `/status` + 工具调用小任务验通

**工具链不换，算力层换国产**——这是 2026 上半年最务实的降本路径之一。配通之后，再把你在 C01/C02 沉淀的 Skills 和 Workflow 跑一遍，才算真正完成迁移。

---

## 资料来源

- DeepSeek Claude Code 集成（官方）：https://api-docs.deepseek.com/quick_start/agent_integrations/claude_code
- AI 工具集成总览：https://api-docs.deepseek.com/guides/coding_agents
- Anthropic API 兼容说明：https://api-docs.deepseek.com/guides/anthropic_api
- 模型与定价：https://api-docs.deepseek.com/quick_start/pricing
- 上一篇 D01：`content/deepseek-v4-agentic-coding/`

---

*环境变量以 DeepSeek 官方文档为准；Claude Code 版本更新可能导致变量名行为变化，遇问题请先 `claude --version` 对照官方文档。API Key 请勿提交到 Git 仓库。*

副标题： 官方 Anthropic 兼容端点、环境变量、[1m] 模型名、子 Agent 用 Flash——附 OpenClaw / OpenCode 与常见报错

DeepSeek V4 接 Claude Code：从零到跑通配置教程

软件研发

人工智能

开发工具

后端

"DeepSeekV4与ClaudeCode无缝对接教程：5分钟完成AnthropicAPI切换，保留原有工作流。详解环境变量配置、持久化设置及验通步骤，提供省钱方案与常见报错处理。适用于开发者将ClaudeCode后端迁移至DeepSeekV4，享受1M上下文与国产算力优势。"

数据治理

密钥管理

服务器

OpenClaw

路由

Linux

Agent

JSON

快速部署LLM、AI绘画等应用,助你玩转AIGC！


2026年中大促 | AI 领航 智绘未来

文章

问答

视频

教程

学习中心

腾讯云实验室

直播

竞赛

腾讯云代码分析专区

腾讯iOA零信任安全管理系统专区

腾讯云架构师技术同盟交流圈

腾讯云数据库专区

腾讯云智能顾问专区

腾讯云原生专区

腾讯混元专区

腾讯云TCE专区

腾讯云Lighthouse专区

腾讯云HAI专区

腾讯云Edgeone专区

腾讯云存储专区

腾讯云智能专区

腾讯轻联专区 

腾讯云开发专区

TAPD专区

腾讯轻量云游戏服专区

EdgeOne AI 安全实战专区

腾讯云最具价值专家

腾讯云架构师技术同盟

腾讯云创作之星

腾讯云开发者先锋

腾讯云代码助手

云原生构建

TAPD 敏捷项目管理

Cloud Studio

SDK中心

API中心

命令行工具

涵盖代码开发、场景应用、自动测试全流程，助你从零构建专属AI助手

一站式MCP教程库，解锁AI应用新玩法

聚焦“写作效率、视觉美观与运行性能”三方面进行全面升级，为您提供更高效、稳定的创作环境

社区富文本&Markdown编辑器全新改版上线，欢迎大家体验!

诚挚邀请您参与本次调研，分享您的真实使用感受与建议。您的反馈至关重要，感谢您的支持与参与！

社区新版编辑器体验调研

DeepSeek V4 接 Claude Code：从零到跑通配置教程-腾讯云开发者社区-腾讯云

DeepSeek V4 接 Claude Code：从零到跑通配置教程

DeepSeek V4 接 Claude Code：从零到跑通配置教程

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐