WSL

使用 WSL2 时，Codex 在 Linux 环境中运行，而不使用原生 Windows 沙箱。如果你需要 Linux 原生工具、仓库和开发工作流已在 WSL2 中，或两种原生 Windows 沙箱模式都不适用于你的环境，可以选择 WSL2。

Codex 对 WSL1 的支持截至 0.114 版本。从 Codex 0.115 开始，Linux 沙箱改用 bubblewrap，因此不再支持 WSL1。

从 WSL 内部启动 VS Code

有关分步说明，请参阅官方 VS Code WSL 教程。

前提条件

• 安装了 WSL 的 Windows。要安装 WSL，请以管理员身份打开 PowerShell，然后运行 wsl --install（Ubuntu 是常见选择）。
• 安装了 WSL 扩展 的 VS Code。

从 WSL 终端打开 VS Code

# From your WSL shell
cd ~/code/your-project
code .

这会打开 WSL 远程窗口，在需要时安装 VS Code Server，并确保集成终端在 Linux 中运行。

确认你已连接到 WSL

• 查找显示 WSL: <distro> 的绿色状态栏。
• 集成终端应显示 Linux 路径（例如 /home/...），而不是 C:\。
• 你可以通过以下方式验证：

  echo $WSL_DISTRO_NAME

这将打印你的发行版名称。

将 Codex CLI 与 WSL 结合使用

以管理员身份打开 PowerShell 或 Windows 终端，运行以下命令：

# Install default Linux distribution (like Ubuntu)
wsl --install

# Start a shell inside Windows Subsystem for Linux
wsl

然后从 WSL shell 运行这些命令：

# Install and run Codex in WSL
curl -fsSL https://chatgpt.com/codex/install.sh | sh
codex

在 WSL 中处理代码

• 在 /mnt/c/... 这样的 Windows 挂载路径中工作，可能比直接使用 Windows 原生路径更慢。将仓库放在 Linux 主目录中（例如 ~/code/my-app），可提高 I/O 速度，并减少符号链接和权限问题：

  mkdir -p ~/code && cd ~/code
  git clone https://github.com/your/repo.git
  cd repo

• 如果你需要 Windows 访问文件，它们位于资源管理器中的 \\wsl$\Ubuntu\home\<user> 下。

故障排除和常见问题解答

大型仓库在 WSL 中运行缓慢

• 确保你不在 /mnt/c 下工作。将仓库移至 WSL（例如，~/code/...）。
• 如果需要，增加 WSL 的内存和 CPU；将 WSL 更新到最新版本：

  wsl --update
  wsl --shutdown

WSL 中的 VS Code 找不到 codex

验证二进制文件是否存在并且位于 WSL 内的 PATH 上：

which codex || echo "codex not found"

如果找不到该二进制文件，请按照 Codex CLI 设置说明 操作。