WSL 开发环境:Claude Code 安装与使用#

终端选择(可选)#

不想用 Rust 方案就直接选 WezTerm。

启用 WSL#

推荐用 WSL Dashboard 一键装发行版;或管理员 PowerShell:

wsl --install -d Ubuntu
wsl --set-default-version 2
wsl -l -v

手动兜底:从 WSL Releases 下载 wsl.x64.msi 安装,再执行 wsl --version

装好后进 Ubuntu 补基础包:

sudo apt update && sudo apt upgrade -y
sudo apt install git python3-pip curl unzip zip -y

Dashboard 下载(v0.7.0): wsldashboard.v0.7.0.exe · 中文说明

2026 值得知道的变化#

微软 2026 年持续推 WSL 大更新,对开发者最有用的几点:

方向 你能感知到什么
跨盘性能 /mnt/c 等 Windows 分区访问提速(小文件 / npm 等场景更明显)
网络统一 本地服务多可直接 localhost:<端口>,少手动端口转发
安装简化 wsl --install / Store 装发行版更顺;默认偏 WSL 2
WSL Containers 2.9.3 预览起可用 wslc(或 container),Docker 兼容 CLI,不必装 Docker Desktop

预览容器能力:

wsl --update --pre-release
wslc --version   # 或 container --version
wslc pull ubuntu && wslc run -it ubuntu bash

Public Preview,正式版预计 2026 秋季。文档: WSL container · 反馈: microsoft/WSL Issues

近期版本速览:2.9.3(WSLC + VirtioFS)→ 2.7.1(目录挂载、DNS 隧道、CVE 修复)→ 2.7.0(内核 6.6 LTS)。

安装 Claude Code#

在 WSL 里按顺序执行:

sudo apt update && sudo apt install -y nodejs npm

# 推荐:npx zcf 一站式初始化(装 Claude Code、工作流、代理/MCP 等)
npx zcf i

claude --version

进入项目目录#

WSL 里 Windows 盘挂在 /mnt/<盘符>//mnt/c = C:\/mnt/d = D:\

# 建议项目放在 Linux 家目录(性能更好)
cd ~/projects/your-project && claude

# 若项目在 Windows 盘
cd /mnt/c/Users/<你的Windows用户名>/projects

常见问题#

  1. claude: command not found:全局 bin 未进 PATH,先确认 claude --version
  2. EACCES:别反复 sudo npm install -g;走 npx zcf i 让它装/修。
  3. Node 太旧:用 nvm 换新版再试。

安全建议#

日常开发用普通用户跑 WSL,不要用 root。