Claude Code 配置 DeepSeek V4 攻略

从零开始，用 DeepSeek 最新 V4 模型驱动 Claude Code。约 10 分钟搞定。

---

1. 安装 Claude Code

先装 Node.js（LTS 版本）：https://nodejs.org/zh-cn —— 下载安装包一路 Next 即可。

然后打开终端，安装 Claude Code：

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

验证：

claude --version   # 看到版本号即成功

Windows 备选：访问 https://claude.ai/download 下载 .exe 安装包，双击安装，无需 Node.js。

---

2. 获取 DeepSeek API Key

1. 打开 https://platform.deepseek.com → 注册/登录
2. 左侧菜单 → API Keys → 创建 API Key
3. 起个名字（如 claude-code），点击创建
4. 立刻复制保存！ Key 只显示一次，格式为 sk-xxxxxxxxxxxxxxxx

目前（截止至5.31）调用API价格25折，性价比超高！！！

---

3. 配置 Claude Code 使用 DeepSeek V4

3.1 创建配置文件

Windows： 打开 PowerShell 或命令提示符，输入：

mkdir "%USERPROFILE%\.claude"
notepad "%USERPROFILE%\.claude\settings.json"

macOS / Linux：

mkdir -p ~/.claude && nano ~/.claude/settings.json

3.2 填入配置（核心）

将以下内容完整复制到编辑器中，然后替换 API Key：

{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "sk-替换为你的DeepSeek-API-Key",
    "ANTHROPIC_BASE_URL": "https://api.deepseek.com/anthropic",
    "ANTHROPIC_MODEL": "deepseek-v4-pro",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "deepseek-v4-pro",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "deepseek-v4-pro",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "deepseek-v4-flash",
    "CLAUDE_CODE_SUBAGENT_MODEL": "deepseek-v4-flash",
    "CLAUDE_CODE_MAX_OUTPUT_TOKENS": "32000"
  }
}

3.3 配置项说明

配置项	作用
ANTHROPIC_AUTH_TOKEN	你的 DeepSeek API Key
ANTHROPIC_BASE_URL	指向 DeepSeek 的 Anthropic 兼容接口
ANTHROPIC_MODEL / OPUS / SONNET	主对话用 V4 Pro（最强模型）
HAIKU / SUBAGENT	子任务用 V4 Flash（更快更省）
MAX_OUTPUT_TOKENS	单次回复上限

为什么 Haiku 和 Subagent 用 V4 Flash？ 子任务通常是简单操作，用轻量模型更快更省钱；复杂任务会自动走 Pro。

3.4 保存并验证

• 记事本：Ctrl+S 保存 → 关闭
• nano：Ctrl+O → 回车 → Ctrl+X

在终端运行 claude --version，没报错说明配置正确。

---

4. 启动并验证

在终端输入 claude 启动，首次需同意条款（输入 y）。

进入对话后测试：

你好，请如实告诉我你是什么模型？

回复中出现 DeepSeek V4 Pro 即配置成功。

---

5. 常用命令

命令	作用
/help	查看所有命令
/clear	清空对话，开始新话题
/cost	查看当前会话费用
/doctor	诊断配置问题
claude "问题"	单次问答（不进入对话模式）

---

6. 常见错误排查

claude 命令找不到

npm 全局路径未加入 PATH。关掉终端重开，或重启电脑即可。

JSON 配置格式错误

把配置内容粘贴到 https://jsonlint.com 校验，会指出具体哪里多了逗号、少了引号。

401 Unauthorized / 403 Forbidden

• Key 是否以 sk- 开头？
• 是否忘记替换占位文字？
• DeepSeek 平台上 Key 还在吗？余额还有吗？

404 Not Found

ANTHROPIC_BASE_URL 必须是 https://api.deepseek.com/anthropic，末尾是 /anthropic，别写成 /v1。

429 Too Many Requests

调用太频繁，等几分钟再试。

子任务执行失败

确认 CLAUDE_CODE_SUBAGENT_MODEL 已设为 deepseek-v4-flash。

回答被截断

把 CLAUDE_CODE_MAX_OUTPUT_TOKENS 改大，如 "64000"。

---

7. DeepSeek 与官方 Claude 的功能差异

功能	DeepSeek V4	官方 Claude
对话 / 代码生成	✅	✅
文件读写 / 终端命令 / Git	✅	✅
MCP 服务器 / Hooks	✅	✅
工具调用（function calling）	⚠️ 基本可用	✅
图片理解 / PDF	❌	✅
深度思考（Extended Thinking）	❌	✅
Prompt Caching	❌	✅

结论： 写代码、改 bug、文件操作等日常开发完全够用。图片理解和深度思考需要官方 Claude。

---

附：纯 V4 Flash 轻量配置（更快更省）

如果追求速度和低成本，可以全部用 Flash：

{
  "env": {
    "ANTHROPIC_AUTH_TOKEN": "sk-你的Key",
    "ANTHROPIC_BASE_URL": "https://api.deepseek.com/anthropic",
    "ANTHROPIC_MODEL": "deepseek-v4-flash",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "deepseek-v4-flash",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "deepseek-v4-flash",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "deepseek-v4-flash",
    "CLAUDE_CODE_SUBAGENT_MODEL": "deepseek-v4-flash",
    "CLAUDE_CODE_MAX_OUTPUT_TOKENS": "32000"
  }
}

---