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 設定說明 操作。