跳转到正文
编程实战篇约 2 分钟
打开原图 ↗

WSL 开发环境: 安装与使用 ​

终端选择(可选) ​

  • Zellij:Rust 实现的 tmux 替代 - zellij.dev
  • WezTerm:跨平台终端,Windows 上更稳 - wezterm.org
  • CLI-Manager:Windows 侧 AI CLI 工作台,内置终端可直接开 WSL;Hook 通知、会话 Diff、用量看板、多项目 Worktree,对接 Claude Code / Codex

只想换终端用不想用 Rust 方案就选 WezTerm;要桌面工作台管 Claude Code / Codex(含 WSL 终端)再看 CLI-Manager。同类桌面工作台见 多 Agent 工作区。

启用 WSL ​

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

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

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

装好后进 Ubuntu 补基础包:

bash
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 Containers2.9.3 预览起可用 wslc(或 container),Docker 兼容 CLI,不必装 Docker Desktop

预览容器能力:

powershell
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 里按顺序执行:

bash
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:\。

bash
# 建议项目放在 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。

想要完整 Agent 原生 Linux? ​

WSL 够用日常开发;若想整机换成 Agent 优先的桌面 Linux,可看 Omarchy(DHH):Arch + Hyprland,开箱装好终端 / 编辑器 / Agent,也能在 Windows 虚拟机里先试用。安装与手册见官网。

发现问题或有实践经验想分享? 参与讨论 ↗

把 AI 从「会聊天」推进到「能稳定交付」