WSL 开发环境:Claude Code 安装与使用#
终端选择(可选)#
- Zellij:Rust 实现的
tmux替代 - zellij.dev - WezTerm:跨平台终端,Windows 上更稳 - wezterm.org
不想用 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 -yDashboard 下载(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 bashPublic 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常见问题#
claude: command not found:全局 bin 未进 PATH,先确认claude --version。EACCES:别反复sudo npm install -g;走npx zcf i让它装/修。- Node 太旧:用
nvm换新版再试。
安全建议#
日常开发用普通用户跑 WSL,不要用 root。