世界SL

當你使用 WSL2 時，Codex 在 Linux 環境中執行，而不是使用 本機Windows沙箱。當你需要 Linux 原生時選擇 WSL2 工具、你的儲存庫和開發人員工作流程已存在於 WSL2 中，或者 本機 Windows 沙箱模式都不適用於你的環境。

WSL1 通過 Codex 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 伺服器，並確保整合終端在 Linux 中執行。

確認你已連線到 WSL

• 查詢顯示 WSL: <distro> 的綠色狀態列。
• 整合終端應顯示Linux路徑（例如/home/...）而不是C:\。
• 你可以通過以下方式驗證：

  echo $WSL_DISTRO_NAME

這將列印你的發行版名稱。

如果狀態列中沒有看到“WSL: ...”，請按 Ctrl+Shift+P，選擇 WSL: Reopen Folder in WSL，並將你的儲存庫儲存在 /home/... 下（不是 C:\) 以獲得最佳效能。

如果 Windows 應用或專案選擇器未顯示你的 WSL 儲存庫，請鍵入 \\wsl$ 進入檔案選擇器或資源管理器，然後導航到你的 發行版的主目錄。

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