Claude Code 接入 DeepSeek API （WSL配置）

把 Claude Code 装在 WSL 中使用。

这么做不仅可行，而且其实是官方比较推荐的方式。因为 Claude Code 原生需要 Linux 环境，WSL 刚好能提供一个完美的运行环境。

---

一、安装 WSL + Ubuntu

以管理员身份打开powershell，一般执行第一步一键安装即可，剩下的命令只是记录

# 一键安装
wsl --install

# 更新 WSL 内核
wsl --update

# 查看可用发行版
wsl --list --online

# 安装指定系统，如 Ubuntu（默认最新版）
wsl --install -d Ubuntu

# 设置用户名密码（不能数字开头），重启电脑

---

二、在 WSL (Ubuntu)中安装claude code

1.配置Ubuntu环境

需要先配置一下系统中的环境

# 先升级一下软件包
sudo apt update && sudo apt upgrade -y

# 安装git、ccurl、构建工具
sudo apt install git curl build-essential -y

# 配置git
git config --global user.name "Your Name"
git config --global user.email "your@email.com"
git config --global init.defaultBranch main

# Python依赖
sudo apt install python3-pip python3-venv -y

# 使用 pyenv 安装 Python（在 WSL 中）
sudo apt install make libssl-dev zlib1g-dev \
libbz2-dev libreadline-dev libsqlite3-dev wget llvm \
libncursesw5-dev xz-utils tk-dev libxml2-dev libxmlsec1-dev \
libffi-dev liblzma-dev -y

# 安装 pyenv
curl https://pyenv.run | bash

# 把pyenv 添加到 shell 并重新加载
shecho 'export PYENV_ROOT="$HOME/.pyenv"' >> ~/.bashrc
echo 'command -v pyenv >/dev/null || export PATH="$PYENV_ROOT/bin:$PATH"' >> ~/.bashrc
echo 'eval "$(pyenv init -)"' >> ~/.bashrc
source ~/.bashrc

# 安装 Python 版本并设置为默认版本
pyenv install 3.11.8
pyenv global 3.11.8

# 安装 nvm（Node管理工具）
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/master/install.sh | bash
# 重新加载 shell 以使 nvm 可用：
source ~/.bashrc

# 安装 Node，最新 LTS 版本
nvm install --lts
nvm use --lts

2.安装命令

这里容易出错，建议通过以下命令执行

npm config set os linux

npm install -g @anthropic-ai/claude-code --force --no-os-check # 注意不要用sudo

完成上述安装后，可以通过以下命令验证是否成功：

# 如果能显示版本号，说明安装成功！
claude --version

---

三、配置 Claude Code（使用 DeepSeek API）

目前国内无法直接登录Claude，所以此处推荐从deepseek官网开放平台中注册申请API key，并以此替换至Claude code中

# 1. 启动wsl的Ubuntu系统，创建配置目录
mkdir -p ~/.claude

# 2. 编辑配置文件
nano ~/.claude/settings.json

双击进入，右键粘贴以下内容（把 sk-xxxxxxxx 换成你的 DeepSeek API Key）：

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://api.deepseek.com/anthropic",
    "ANTHROPIC_AUTH_TOKEN": "sk-xxxxxxxx",
    "API_TIMEOUT_MS": "3000000",
    "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",
    "ANTHROPIC_SMALL_FAST_MODEL": "deepseek-v4-flash",
    "CLAUDE_CODE_AUTO_COMPACT_WINDOW": "800000",
    "CLAUDE_CODE_SUBAGENT_MODEL": "deepseek-v4-pro[1m]",
    "CLAUDE_CODE_EFFORT_LEVEL": "max",
    "DEEPSEEK_REASONING_EFFORT": "max",
    "temperature": "1.0",
    "top_p": "1.0"
  },
  "model": "deepseek-v4-pro[1m]"
}

保存退出：Ctrl + O → Enter → Ctrl + X

API Key 如何保密？
建议不要将配置文件提交到 Git。运行以下命令可避免意外：

echo ".claude/settings.json" >> .gitignore

# 启动 Claude Code
claude

---

四、配合 VS Code 使用

步骤	具体操作	说明
1. 安装 WSL 扩展插件	在 VS Code 插件市场安装 WSL 扩展	这是打通 VS Code 和 WSL 的基础
2. 打开项目	直接在vscode 终端里通过 wsl 命令启动 claude ，打开项目文件夹	直接在 VS Code 里利用Claude工作

---

参考：

• 知乎用户「咬定青松」文章：Windows 上安装和配置WSL教程
• 阿里云开发者社区「mozzie.」文章：Windows安装Claude Code