Buck Blog · 博客正文

返回技术分享首页
DeepSeek-v4-pro 在 Claude Code 中调用配置（Windows 中 WSL）

DeepSeek-v4-pro 在 Claude Code 中调用配置（Windows 中 WSL）

本指南详细介绍在 Windows 的 WSL（Windows Subsystem for Linux）环境中，从零开始搭建 Ubuntu 子系统、安装 Claude Code，并配置 DeepSeek-v4-pro 作为后端模型的完整过程。

> **适用环境：** Windows 10/11，Claude Code v2.x > **最后更新：** 2026-05-19 > **当前配置版本参考：** Ubuntu 24.04.2 LTS + Node.js 22 + Claude Code 2.1.144

目录

1. 前置准备

1.1 系统要求

项目 要求
操作系统 Windows 10（版本 2004+）或 Windows 11
CPU 须支持虚拟化，并在 BIOS 中开启
内存 建议 8 GB 以上
磁盘空间 至少 10 GB 可用空间

1.2 检查虚拟化是否开启

打开 **任务管理器** → **性能** 标签页 → 右下角查看 **"虚拟化"** 状态是否为 **"已启用"**。

若未启用，需重启进入 BIOS 开启 **Intel VT-x**（Intel CPU）或 **AMD SVM**（AMD CPU）。

2. 安装 WSL 及 Ubuntu

2.1 启用 WSL 功能

以**管理员身份**打开 PowerShell（右键开始菜单 → Windows PowerShell（管理员）/ 终端（管理员）），执行：

wsl --install

此命令会自动完成以下步骤：

  • 启用 "适用于 Linux 的 Windows 子系统" 功能
  • 启用 "虚拟机平台" 功能
  • 安装默认的 Ubuntu 发行版

> **说明：** `wsl --install` 默认安装 Ubuntu。若需指定其他发行版，可用 `wsl --install -d <发行版名>` 查看可安装列表用 `wsl --list --online`。

安装完成后**重启电脑**。

2.2 完成 Ubuntu 初始化

重启后系统会自动弹出 Ubuntu 窗口，首次启动会提示创建用户名和密码：

Installing, this may take a few minutes...
Please create a default UNIX user account. The username does not need to match your Windows username.
For more information visit: https://aka.ms/wslusers
Enter new UNIX username: [输入你的用户名，例如 huamingh]
New password: [输入密码]
Retype new password: [再次确认密码]

2.3 检查 WSL 版本

在 **PowerShell** 中执行：

wsl -l -v

确保输出中 Version 列为 `2`：

  NAME      STATE           VERSION
* Ubuntu    Running         2

如果 version 不是 2，用以下命令升级：

wsl --set-version Ubuntu 2

3. Ubuntu 基础配置

3.1 更新系统包

在 Ubuntu 终端中执行：

sudo apt update && sudo apt upgrade -y

3.2 安装基础工具

sudo apt install -y curl wget git unzip build-essential

3.3 配置代理（中国大陆用户）

如果你在国内且需要代理才能访问外网，可在 `~/.bashrc` 末尾添加代理配置：

# 打开配置文件
nano ~/.bashrc

在文件末尾添加（请将 IP 和端口替换为你的实际代理地址）：

export HTTP_PROXY=http://<代理IP>:<端口>
export HTTPS_PROXY=http://<代理IP>:<端口>
export http_proxy=http://<代理IP>:<端口>
export https_proxy=http://<代理IP>:<端口>
export NO_PROXY=localhost,127.0.0.1,::1
export no_proxy=localhost,127.0.0.1,::1

示例：

export HTTP_PROXY=http://192.168.0.100:7897
export HTTPS_PROXY=http://192.168.0.100:7897
export http_proxy=http://192.168.0.100:7897
export https_proxy=http://192.168.0.100:7897
export NO_PROXY=localhost,127.0.0.1,::1
export no_proxy=localhost,127.0.0.1,::1

使配置生效：

source ~/.bashrc

验证代理是否生效：

curl -I https://www.google.com

4. 安装 Node.js（使用 nvm）

Claude Code 需要 Node.js 18+ 环境。推荐使用 **nvm**（Node Version Manager）管理 Node.js。

4.1 安装 nvm

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.1/install.sh | bash

安装完成后，**关闭终端并重新打开**，或执行：

source ~/.bashrc

验证安装：

nvm --version
# 输出示例：0.40.1

4.2 安装 Node.js

# 安装最新的 LTS 版本（推荐 22.x）
nvm install 22

# 设为默认版本
nvm alias default 22

# 验证
node --version
# 输出示例：v22.22.2
npm --version
# 输出示例：10.9.7

5. 安装 Claude Code

5.1 全局安装

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

5.2 创建快捷路径

为了方便使用，创建软链接到 `~/bin/`：

mkdir -p ~/bin
ln -s $(which claude) ~/bin/claude

确保 `~/bin` 在 PATH 中（通常已在 `.bashrc` 中配置，否则添加 `export PATH="$HOME/bin:$PATH"`）。

5.3 验证安装

claude --version
# 输出示例：2.1.144 (Claude Code)

6. 获取 DeepSeek API Key

6.1 注册 DeepSeek 账号

  1. 访问 DeepSeek 官网：https://platform.deepseek.com
  2. 注册并登录账号
  3. 进入 API Keys 页面
  4. 点击 "创建 API Key"，获取密钥

密钥格式通常为：`sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx`

> **注意：** API 调用会消耗余额，请确保账户有足够余额。DeepSeek API 定价请参见官方定价页面。

6.2 模型名称

DeepSeek-v4-pro 的模型标识符为：

deepseek-v4-pro

> DeepSeek 提供了 Anthropic 兼容的 API 端点，可直接通过 `ANTHROPIC_BASE_URL` 配置调用，无需额外适配。

7. 配置 DeepSeek-v4-pro

7.1 创建配置文件

推荐将环境变量存放在独立文件中，保持配置整洁。

mkdir -p ~/.config
nano ~/.config/claude-deepseek.env

文件内容如下（将 `sk-xxx` 替换为你的真实 API Key）：

# ================================================
# DeepSeek-v4-pro 在 Claude Code 中的配置
# ================================================

# ---- 代理配置（中国大陆用户按需配置）----
export HTTP_PROXY=http://<代理IP>:<端口>
export HTTPS_PROXY=http://<代理IP>:<端口>
export http_proxy=http://<代理IP>:<端口>
export https_proxy=http://<代理IP>:<端口>
export NO_PROXY=localhost,127.0.0.1,::1
export no_proxy=localhost,127.0.0.1,::1

# ---- DeepSeek API 配置 ----
# API 基础地址（DeepSeek 的 Anthropic 兼容端点）
export ANTHROPIC_BASE_URL=https://api.deepseek.com/anthropic

# API 认证 Token
export ANTHROPIC_AUTH_TOKEN=sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

# 默认模型
export ANTHROPIC_MODEL=deepseek-v4-pro

# Sub-agent 使用的模型（与主模型保持一致）
export CLAUDE_CODE_SUBAGENT_MODEL=deepseek-v4-pro

> **配置说明：** > > | 环境变量 | 作用 | > |----------|------| > | `ANTHROPIC_BASE_URL` | 将 API 请求转发到 DeepSeek 兼容端点，而非 Anthropic 官方 | > | `ANTHROPIC_AUTH_TOKEN` | DeepSeek 的 API Key，替代 Anthropic 的 Token | > | `ANTHROPIC_MODEL` | 默认使用的模型 ID | > | `CLAUDE_CODE_SUBAGENT_MODEL` | Sub-agent（子任务代理）使用的模型 |

7.2 在 .bashrc 中引入配置

nano ~/.bashrc

在文件末尾添加：

# 加载 DeepSeek Claude Code 配置
[ -f "$HOME/.config/claude-deepseek.env" ] && . "$HOME/.config/claude-deepseek.env"

使配置生效：

source ~/.bashrc

7.3 验证环境变量

echo $ANTHROPIC_BASE_URL
# 输出：https://api.deepseek.com/anthropic

echo $ANTHROPIC_MODEL
# 输出：deepseek-v4-pro

8. 验证配置

8.1 启动 Claude Code

在终端中直接运行：

claude

如果一切配置正确，你会看到类似如下启动界面：

Claude Code v2.1.144

> 系统提示中会显示 `You are powered by the model deepseek-v4-pro`，表示 DeepSeek-v4-pro 配置成功。

8.2 简单功能测试

启动后，在 Claude Code 中输入简单测试：

> 你好，请介绍一下你自己。

如果能正常收到回复，说明整个调用链路（WSL → Node.js → Claude Code → DeepSeek API）已经贯通。

8.3 检查模型信息

在 Claude Code 会话中输入：

> 当前使用的是什么模型？

确认回复中显示 `deepseek-v4-pro`。

9. 常见问题排查

9.1 claude 命令找不到

**原因：** npm 全局安装路径不在 PATH 中。

**解决：**

# 查找 claude 安装位置
npm list -g @anthropic-ai/claude-code

# 添加到 PATH（在 ~/.bashrc 中）
export PATH="$(npm config get prefix)/bin:$PATH"

# 或直接创建软链接
ln -s $(npm root -g)/@anthropic-ai/claude-code/bin/claude.exe ~/bin/claude

9.2 网络连接超时 / 无法访问 API

**原因：** 代理未配置、代理地址错误或网络不通。

**排查步骤：**

# 1. 检查代理环境变量
env | grep -i proxy

# 2. 测试 API 端点是否可达
curl -v https://api.deepseek.com/anthropic

# 3. 如果使用代理，确认代理服务正在运行
curl -I https://www.google.com -x http://<代理IP>:<端口>

9.3 API Key 验证失败

**原因：** API Key 错误或未生效。

**排查：**

# 检查 Token 是否正确加载
echo $ANTHROPIC_AUTH_TOKEN

# 如果为空，手动 source 配置文件
source ~/.config/claude-deepseek.env

确认 DeepSeek 平台上的 API Key 状态和余额。

9.4 模型返回异常或功能不完整

**说明：** DeepSeek-v4-pro 作为第三方模型，在工具调用、系统提示适配等细节上与 Claude 官方模型可能存在差异。如遇到：

  • 工具调用格式错误
  • 特定功能不可用
  • 响应质量不达预期

这些属于第三方兼容性问题，建议：

  1. 关注 DeepSeek API 的 Anthropic 兼容性更新
  2. 必要时切回 Anthropic 官方模型进行对比测试

9.5 WSL 版本不是 WSL 2

**排查：**

wsl -l -v

如果 Version 列显示 `1`：

wsl --set-version Ubuntu 2

9.6 Node.js 版本过低

Claude Code 要求 Node.js 18+。检查版本：

node --version

如果低于 18：

nvm install 22
nvm alias default 22

附录：文件结构参考

配置完成后，相关文件路径如下：

Windows 端:
  C:\Users\<用户名>\                   # Windows 用户目录

WSL/Ubuntu 端:
  ~/.bashrc                            # shell 配置（加载 env 文件）
  ~/.config/claude-deepseek.env        # DeepSeek 环境变量配置
  ~/.claude/settings.json              # Claude Code 全局设置
  ~/.claude/settings.local.json        # Claude Code 本地权限设置
  ~/bin/claude                         # claude 命令软链接

npm 全局安装:
  ~/.nvm/versions/node/v22.22.2/lib/node_modules/@anthropic-ai/claude-code/

参考链接