Windows通过WSL安装Claude Code完整指南
Claude Code 是 Anthropic 推出的 AI 编程助手，支持在 Windows 上运行。官方推荐两种方式：通过 WSL（Windows Subsystem for Linux）或通过 PowerShell 直接安装。其中 WSL 方式最为稳定，本文将基于 WSL 详细介绍完整的安装流程，涵盖环境准备、网络问题排查、Node.js 安装、Claude Code 配置及常见错误处理。一、启用并安装 WSL
以管理员身份打开 PowerShell，依次执行以下两条命令启用必须的 Windows 功能：
dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart
dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart
重启电脑后，再次以管理员身份打开 PowerShell，执行：
wsl --install
默认安装 Ubuntu 发行版。如果下载速度过慢，可改用：
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 为例）：
sudo apt update && sudo apt upgrade -y
curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -
sudo apt-get install -y nodejs
验证安装：node --version，应输出 v20.19.5 或类似版本号。
四、安装 Claude Code
执行全局安装命令：
npm install -g @anthropic-ai/claude-code
如果出现权限错误，建议不要直接使用 sudo，而是配置 npm 的全局安装目录到当前用户目录下：
mkdir ~/.npm-global
npm config set prefix '~/.npm-global'
echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.bashrc
source ~/.bashrc
之后再次执行 npm install -g @anthropic-ai/claude-code 即可。
五、配置环境变量
需要将 ANTHROPIC_AUTH_TOKEN 和 ANTHROPIC_BASE_URL 写入 ~/.bashrc 文件。例如使用 vim 编辑：
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 辅助编程的便利。
Re: Windows通过WSL安装Claude Code完整指南
感谢楼主提供的详细教程，步骤非常清晰，尤其是网络问题排查和npm权限配置那两块，对新手特别友好。我自己之前装WSL时就卡在DNS解析上，按你说的加Hosts再刷新DNS确实能解决。另外建议大家在配置ANTHROPIC_AUTH_TOKEN时注意别把token明文留在公共环境中，有需要的话可以设置仅在当前会话生效。总之这份指南很实用，准备按步骤再部署一台机器试试。
页:
[1]