Windows环境下的WSL+Claude Code安装配置

一、在Windows中安装WSL

Windows WSL（全称Windows Subsystem for Linux）是微软Windows系统推出的一项功能，它允许你在Windows系统中直接运行完整的Linux环境，而不需要安装虚拟机或进行双系统配置。

WSL必须运行在Windows 10版本2004及更高版本，安装步骤如下：

打开 PowerShell（或 Windows 命令提示符）并输入：

bash 复制代码

wsl --install

安装完成后，系统将要求你为当前Linux发行版设置Linux用户名和密码。但请注意，输入密码时，屏幕上不会显示任何内容。
这称为盲人键入。你不会看到你正在键入的内容，这是完全正常的。
安装完成后启动电脑。
在开始菜单或运行框中输入并运行 wsl即可启动默认的Linux发行版。默认情况下安装的Linux分发版为Ubuntu。可以在当前Linux环境下通过如下命令查看版本：

bash 复制代码

lsb_release -a

如：Ubuntu 26.04 LTS

二、迁移WSL默认安装目录

默认情况下，WSL的根文件系统会安装在C盘目录中，因系统盘磁盘空间有限，推荐迁移安装目录至其他盘符。

导出当前WSL发行版为tar包
在PowerShell中执行如下命令，导出的位置定义在F盘，也可以自行定义。

bash 复制代码

wsl --export Ubuntu F:\wsl-ubuntu26.04.tar

注销当前WSL发行版

在PowerShell中执行如下命令

bash 复制代码

wsl --unregister Ubuntu

如果想迁移到E盘的WSL目录下，需要先在E盘创建WSL目录，然后在PowerShell中执行：

bash 复制代码

wsl --import Ubuntu E:\WSL\wsl-ubuntu26.04 F:\wsl-ubuntu26.04.tar

重新启动WSL。

三、解决NAT模式下的WSL不支持localhost代理

如果宿主机Windows环境下开启了梯子等代理软件，通常在启动WSL的过程中，会提示如下信息：

wsl: 检测到 localhost 代理配置，但未镜像到 WSL。NAT 模式下的 WSL 不支持 localhost 代理。

这个错误提示的原因是WSL采用独立的NAT虚拟子网架构，Windows宿主机和Linux子系统相互独立，无法互通。

解决方案是通过镜像网络模式mirrored，让Windows与WSL共享网络，步骤如下：

创建 .wslconfig 文件

打开文件管理器，导航到用户目录，路径通常为C:\Users<your_username>。然后在该目录下创建一个文本文件，命名为 .wslconfig （注意文件名以点开头且没有文件扩展名）

编辑 .wslconfig 文件

用记事本打开.wslconfig文件，并输入以下内容：

bash 复制代码

[wsl2]
networkingMode=mirrored   # 启用镜像网络模式
dnsTunneling=true         # 启用 DNS 隧道，解决一些DNS问题
firewall=true             # 启用 Windows 防火墙集成
autoProxy=true            # 关键！自动同步 Windows 的代理设置

编辑完成后，保存并关闭文件。

打开PowerShell，输入以下命令关闭WSL的所有分发版

bash 复制代码

wsl --shutdown

重新启动WSL，验证问题是否已经解决。

四、安装Claude Code

启动WSL后进入Linux发行版环境。

安装Node.js和npm

通过下载二进制包进行安装的方式，首先通过如下指令下载指定版本安装包：

bash 复制代码

wget https://nodejs.org/dist/v18.16.1/node-v18.16.1-linux-x64.tar.xz

解压并移动到指定目录：

bash 复制代码

tar -xf node-v18.16.1-linux-x64.tar.xz
sudo mv node-v18.16.1-linux-x64 /usr/local/nodejs
rm node-v18.16.1-linux-x64.tar.xz   # 最后将下载的安装包进行删除

配置环境变量：

bash 复制代码

echo 'export PATH=/usr/local/nodejs/bin:$PATH' >> ~/.bashrc
source ~/.bashrc

验证版本，依次输入以下指令，验证node和npm的版本：

bash 复制代码

node -v
npm -v

安装Claude Code

通过npm安装Claude Code，执行命令如下：

bash 复制代码

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

安装完成后，通过如下命令验证安装的版本

bash 复制代码

Claude -v

五、配置国内模型

我们可以将Claude Code所调用的模型更改为国产大模型，Claude Code底层通过Anthropic Messages API 格式与模型通信。只要第三方服务兼容该API格式，就可以通过设置环境变量将请求转发到自定义站点。

提前获取国内模型的API Key，并确认模型厂商的接口地址。配置过程如下：

创建配置文件

Claude Code 刚安装完成后，还没有自动创建 .claude 目录。因此，我们可以先在终端中执行以下命令来创建.claude目录，创建并编辑配置文件settings.json。

bash 复制代码

mkdir -p ~/.claude
vim ~/.claude/settings.json

写入配置

以阿里通义Qwen按用量计费为例，其中sk-xxxxxxxxxxxxxxxxxxxx要换成你自己的API Key。

bash 复制代码

{
  "env": {
    "ANTHROPIC_BASE_URL": "https://dashscope.aliyuncs.com/apps/anthropic",
    "ANTHROPIC_AUTH_TOKEN": "sk-xxxxxxxxxxxxxxxxxxxx",
    "ANTHROPIC_MODEL": "qwen3.5-plus"  }
}

修改完成后:wq保存退出。

六、验证Claude

创建工作目录
首先我们创建一个工作目录，命名为workspace，然后进入该目录：

bash 复制代码

mkdir -p ~/workspace
cd workspace

运行Claude 命令

bash 复制代码

claude

初始运行会提示设置样式，默认Dark mode即可，也可以根据自己的喜好进行选择。

验证Claude 是否可用

可以通过如下命令查看当前模型是否为自己配置的国产模型

bash 复制代码

/model

也可以通过简单对话，测试Claude Code是否能正常回复。