Claude Code × DeepSeek V4：从零开始配置与调用实战

Quz

883人浏览 · 2026-05-19 07:00:00

Quz · 2026-05-19 07:00:00 发布

准备工作

在开始之前，请确保你已经具备以下条件：

已安装 Claude Code（可直接让Trae、Cursor、CodeBuddy这类AI工具帮你下载和配置环境）
知道如何在命令行中输入命令
Windows Claude命令行工具一般在 C:\Users\你的用户名\.local\bin 目录下，如果遇到Claude命令无法识别，知道如何配置环境变量

第一阶段：获取 DeepSeek API Key

获取 API Key 是所有流程中最重要的，不然 Claude Code 会反复报 401 错误。

1.1 注册/登录 DeepSeek

访问 DeepSeek 官方网站 https://www.deepseek.com/，选择进入 API 开放平台。

在这里插入图片描述

1.2 创建 API Key

选择页面【API keys】：

在这里插入图片描述

进入 API 管理页面，创建一个新的 API Key：

在这里插入图片描述

⚠️ 重要提示：创建 API Key 后，请立即复制并妥善保存，因为页面关闭后将无法再次查看完整的 Key。建议先粘贴到一个临时文本文件中，下一步会用到。

第二阶段：配置 Claude Code 连接 DeepSeek

2.1 找到配置文件

Claude Code 的配置文件位于用户目录下的 .claude 文件夹中：

在这里插入图片描述

在 Windows 系统中，路径为：C:\Users\你的用户名\.claude\

在该文件夹下找到或新建 settings.json 文件。

2.2 写入最小可用配置

打开 settings.json，写入以下配置。这是最简配置，保证你能先跑起来：

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.deepseek.com/anthropic",
    "ANTHROPIC_AUTH_TOKEN": "sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx",
    "ANTHROPIC_MODEL": "deepseek-v4-flash"
  }
}

操作说明：

将 "sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx" 替换为你刚才从 DeepSeek 官网复制的真实 API Key
注意保留两边的双引号 "
ANTHROPIC_MODEL 默认使用 deepseek-v4-flash（高速响应模型，适合日常对话）

为什么配置项叫 ANTHROPIC_XXX？
因为 Claude Code 是为 Anthropic 官方服务设计的，DeepSeek 提供了兼容 Anthropic API 格式的接口，所以配置项名称保持不变，只需把地址指向 DeepSeek 即可。

2.3 可选：添加进阶配置（可先跳过）

如果你希望 Claude Code 更少打扰、更自动化，可以追加以下配置：

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.deepseek.com/anthropic",
    "ANTHROPIC_AUTH_TOKEN": "你的DeepSeek API KEY",
    "ANTHROPIC_MODEL": "deepseek-v4-flash",
    "ANTHROPIC_DEFAULT_HAIKU_MODEL": "deepseek-v4-flash",
    "ANTHROPIC_DEFAULT_SONNET_MODEL": "deepseek-v4-pro[1m]",
    "ANTHROPIC_DEFAULT_OPUS_MODEL": "deepseek-v4-pro[1m]",
    "CLAUDE_CODE_SUBAGENT_MODEL": "deepseek-v4-flash",
    "API_TIMEOUT_MS": "600000",
    "CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC": "1",
    "CLAUDE_CODE_EFFORT_LEVEL": "medium"
  },
  "skipDangerousModePermissionPrompt": true,
  "bypassPermissions": true
}

参数说明：

配置项	作用
ANTHROPIC_MODEL	默认模型，claude 命令启动时直接使用
ANTHROPIC_DEFAULT_HAIKU_MODEL	轻量级任务模型（快速响应、低成本）
ANTHROPIC_DEFAULT_SONNET_MODEL	中等复杂度任务模型（平衡性能与速度）
ANTHROPIC_DEFAULT_OPUS_MODEL	复杂任务/代码生成模型（最强性能）
CLAUDE_CODE_SUBAGENT_MODEL	子代理/后台任务模型（自动执行时调用）
CLAUDE_CODE_EFFORT_LEVEL	推理档位，控制模型思考深度（见下方详解）
API_TIMEOUT_MS	请求超时时间，单位毫秒。600000 = 10分钟
CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC	关闭非必要网络请求，减少报错
skipDangerousModePermissionPrompt	跳过危险操作确认提示
bypassPermissions	自动授权文件读写等权限

💡 新手建议：第一次配置先用最简版本，等能正常对话了，再回来加这些进阶配置。

模型映射策略说明

Claude Code 内置了 Anthropic 的三档模型体系（Haiku / Sonnet / Opus），上述配置项用于把 DeepSeek 模型映射到对应档位：

推荐配置策略：

任务类型	推荐模型	理由
日常交互、快速问答	deepseek-v4-flash	响应快、成本低
代码生成、大文件分析	deepseek-v4-pro[1m]	能力强、支持长上下文
后台自动执行、子任务	deepseek-v4-flash	不阻塞、效率高

关于 1M 上下文

deepseek-v4-pro[1m] 中的 [1m] 是 DeepSeek 的上下文窗口标识：

后缀	含义	上下文长度
无后缀 / [128k]	标准版	128K tokens
[1m]	长上下文版	1M tokens（100万）

⚠️ 注意：1M 上下文模型通常价格更高、响应更慢。

关于 CLAUDE_CODE_EFFORT_LEVEL（推理档位）

CLAUDE_CODE_EFFORT_LEVEL 用于控制模型的思考深度——即每次响应时分配的"推理预算"（考虑多少方案、验证多少边界情况）。

支持的档位：

档位	说明	适用场景
low	最小推理预算，响应最快	简单重命名、格式化、单行修改
medium	中等预算，均衡成本与质量	日常开发任务、写函数、改 bug
high	大预算，追踪复杂逻辑	复杂重构、多文件改动、难以定位的 bug
xhigh	超高预算（Opus 4.7 独有）	长时间 agent 任务、复杂架构设计
max	无上限，全力推理	最复杂的任务，慎用（可能过度思考）

配置示例：

{
  "env": {
    "CLAUDE_CODE_EFFORT_LEVEL": "high"
  }
}

可在Claude Code会话内动态切换：（先进入Claude Code，然后输入 /effort 命令）

在这里插入图片描述

第三阶段：启动并验证连接

3.1 首次启动 Claude Code

Win11 可以在目录中点击右键菜单：

在这里插入图片描述

在终端中输入：

claude

如果提示 claude 命令未找到，请检查【环境变量】是否包含 C:\Users\你的用户名\.local\bin。

3.2 选择界面样式

首次启动时，系统会让你选择界面样式：

在这里插入图片描述

你可以根据个人喜好选择命令行主题，这不会影响核心功能。

3.3 信任工作目录

接下来，Claude Code 会询问是否信任当前工作目录：

在这里插入图片描述

选择 Yes, I trust this folder 以允许 Claude Code 在当前目录中读取和写入文件。

3.4 首次提问验证

现在，尝试向 Claude Code 提问，验证连接是否成功：

在这里插入图片描述

输入一个问题，比如"你是什么模型？"。

如果看到类似以下的成功响应，说明配置完成：

在这里插入图片描述

第四阶段：切换模型（按需使用）

4.1 了解 DeepSeek V4 模型

原有的 deepseek-chat 和 deepseek-reasoner 模型名将于 2026/07/24 弃用，建议升级使用新版 V4 系列模型：

模型名	特点	适用场景
`deepseek-v4-flash`	高速响应，非思考模式	日常对话、简单问答、快速迭代
`deepseek-v4-pro`	高性能，支持思考模式	复杂代码生成、深度推理、数学问题