Windows通过WSL安装Claude Code完整指南

微软专家

Claude Code 是 Anthropic 推出的 AI 编程助手，支持在 Windows 上运行。官方推荐两种方式：通过 WSL（Windows Subsystem for Linux）或通过 PowerShell 直接安装。其中 WSL 方式最为稳定，本文将基于 WSL 详细介绍完整的安装流程，涵盖环境准备、网络问题排查、Node.js 安装、Claude Code 配置及常见错误处理。

一、启用并安装 WSL

以管理员身份打开 PowerShell，依次执行以下两条命令启用必须的 Windows 功能：

2. dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart
3. dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart

复制代码

重启电脑后，再次以管理员身份打开 PowerShell，执行：

2. wsl --install

复制代码

默认安装 Ubuntu 发行版。如果下载速度过慢，可改用：

2. wsl --install --web-download

复制代码

若遇到如下错误（DNS 解析失败）：
无法从“raw.githubusercontent.com/microsoft/W… 提取列表分发。无法解析服务器的名称或地址
错误代码: Wsl/InstallDistro/WININET_E_NAME_NOT_RESOLVED
则需要手动修复网络问题。

二、修复 WSL 安装时的网络问题

在命令行中执行 ping raw.githubusercontent.com 获取该域名的 IP 地址，例如 185.199.110.133。然后以管理员权限编辑 Hosts 文件（路径：C:\Windows\System32\drivers\etc\hosts），添加：
185.199.110.133 raw.githubusercontent.com
保存后，在 PowerShell 中执行 ipconfig /flushdns 刷新 DNS 缓存，之后重新运行 wsl --install。安装过程中会提示设置 Linux 用户名和密码，按需配置即可。

三、在 WSL 中安装 Node.js

从开始菜单打开 Ubuntu 终端，首先更新系统包并安装 Node.js（这里以 Node.js 20.x 为例）：

2. sudo apt update && sudo apt upgrade -y
3. curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -
4. sudo apt-get install -y nodejs

复制代码

验证安装：node --version，应输出 v20.19.5 或类似版本号。

四、安装 Claude Code

执行全局安装命令：

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

复制代码

如果出现权限错误，建议不要直接使用 sudo，而是配置 npm 的全局安装目录到当前用户目录下：

2. mkdir ~/.npm-global
3. npm config set prefix '~/.npm-global'
4. echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.bashrc
5. source ~/.bashrc

复制代码

之后再次执行 npm install -g @anthropic-ai/claude-code 即可。

五、配置环境变量

需要将 ANTHROPIC_AUTH_TOKEN 和 ANTHROPIC_BASE_URL 写入 ~/.bashrc 文件。例如使用 vim 编辑：

2. vim ~/.bashrc

复制代码

在文件末尾添加（将 xxxx 替换为实际的 token 和 base URL）：
export ANTHROPIC_AUTH_TOKEN=xxxx
export ANTHROPIC_BASE_URL=xxx
保存后执行 source ~/.bashrc 使其立即生效。如果后续遇到需要 login 的提示，重新 source 一次即可。

六、启动与常见问题

在 Ubuntu 终端中输入 claude 即可启动 Claude Code。如果启动后遇到接口返回 400 错误，按下 Ctrl+C 两次退出，再次进入后按 Tab 键关闭 think mode 即可正常使用。

通过以上步骤，你便能在 Windows 上借助 WSL 稳定运行 Claude Code，享受 AI 辅助编程的便利。

热心网友4

感谢楼主提供的详细教程，步骤非常清晰，尤其是网络问题排查和npm权限配置那两块，对新手特别友好。我自己之前装WSL时就卡在DNS解析上，按你说的加Hosts再刷新DNS确实能解决。另外建议大家在配置ANTHROPIC_AUTH_TOKEN时注意别把token明文留在公共环境中，有需要的话可以设置仅在当前会话生效。总之这份指南很实用，准备按步骤再部署一台机器试试。