WSL（Windows）
在 Windows 上用 WSL 运行 Claude Code、Codex 等 AI 终端
为什么用 WSL
WSL（Windows Subsystem for Linux）可以让你在 Windows 里直接运行 Linux 子系统，不需要虚拟机。不少 AI 终端在 Linux 下支持得更好，在 WSL 里运行通常比直接在 Windows 上更稳定。有些工具（例如 Hermes Agent）只能在 Linux 环境运行。
安装 WSL
以管理员身份打开 PowerShell 或 CMD，运行：
wsl --install按提示设置 Linux 用户名和密码，然后重启电脑。
运行后没有反应的话，把 wsl 换成 wsl.exe 再试。
重启后查看已安装的发行版：
wsl -l -v一般会看到默认安装了 Ubuntu。
在终端输入 wsl 即可进入 Linux 环境。
默认安装在 C 盘。想装到其他位置，先建好目录（例如 D:\wsl），再运行：
wsl --install Ubuntu-24.04 --location "D:\wsl"在 WSL 里安装 AI 终端
WSL 是一个全新的系统，需要在里面重新安装 Node.js 和 CLI。
用 nvm 安装 Node.js：
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash
source ~/.bashrc
nvm install 22
nvm use 22安装需要的 CLI：
npm i -g @anthropic-ai/claude-code@latest # Claude Code
npm i -g @openai/codex@latest # Codex
npm i -g @google/gemini-cli@latest # Gemini CLI同步配置文件
WSL 和 Windows 的配置文件是分开的，需要在 WSL 里也放一份配置。三种方式任选：
按 Claude Code、Codex、Gemini CLI 教程中 Linux 标签页的步骤，在 WSL 里重新配置一遍。
配合 VS Code 使用
以 Codex 插件为例：
在 Windows 目录下工作、只让 Codex 在 WSL 里运行：
- 在 Codex 插件右上角的设置里选择「在 WSL 中运行」，然后重新加载窗口；
- 如果没有这个选项：按
Ctrl + ,打开设置，搜索codex，勾选 Run Codex In Windows Subsystem For Linux。