---
# System prepended metadata

title: '# Windows 11 使用 WSL2 執行 Codex CLI 完整指南'

---

# 賽門鐵克端點防護誤擋 codex 解決方法 在Win 11 使用 WSL2 執行 Codex CLI 完整教學

本文件說明如何在 **Windows 11 家用版**上安裝 **WSL2 + Ubuntu + Node.js +
Codex CLI**， 以避免 Symantec Endpoint Protection 的
**ACM.Ps-Base64!g1** PowerShell 偵測問題。

當 Codex CLI 在 Windows 原生環境執行時，可能會透過 **PowerShell
EncodedCommand (Base64)** 來執行指令，
而這正是許多惡意程式常用技巧，因此可能被 Symantec SONAR 阻擋。

透過 **WSL2 (Linux 環境)** 執行 Codex CLI，可以避免使用 Windows
PowerShell， 因此通常不會觸發該偵測。

------------------------------------------------------------------------

# 1. 安裝 WSL2

1.  以 **系統管理員**開啟 Windows Terminal 或 PowerShell
2.  執行：

``` powershell
wsl --install
```

系統會自動：

-   啟用 WSL
-   安裝 WSL2 核心
-   安裝 Ubuntu

安裝完成後 **重新開機** (或重新開一個powershell視窗) 。

------------------------------------------------------------------------

# 2. 啟動 Ubuntu (WSL)

重新開機後開啟 powershell ，輸入：

``` powershell
wsl
```

第一次啟動 Ubuntu 會要求設定：

-   Linux 使用者名稱
-   Linux 密碼

完成後會看到類似：

    username@PCName:~$

代表已成功進入 Linux shell。

------------------------------------------------------------------------

# 3. 更新 Ubuntu 套件

建議先更新系統：

``` bash
sudo apt update
sudo apt upgrade -y
```

如果沒有 curl：

``` bash
sudo apt install -y curl
```

------------------------------------------------------------------------

# 4. 安裝 Node.js（使用 nvm）

安裝 nvm：

``` bash
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/master/install.sh | bash
```

關閉 Terminal，重新開啟 WSL：

``` powershell
wsl
```

安裝 Node.js：

``` bash
nvm install 22
```

確認版本：

``` bash
node -v
npm -v
```

------------------------------------------------------------------------

# 5. 安裝 Codex CLI

在 WSL 內執行：

``` bash
npm install -g @openai/codex
```

確認安裝成功：

``` bash
codex --version
```

啟動 Codex：

``` bash
codex
```

------------------------------------------------------------------------

# 6. 建立專案資料夾（建議）

建議將專案放在 **WSL Linux 檔案系統**，不要放在 `/mnt/c`。

``` bash
mkdir -p ~/code
cd ~/code
```

例如 clone repo：

``` bash
git clone <your_repo>
cd your_repo
```

------------------------------------------------------------------------

# 7. 從 Windows 存取 WSL 檔案

Windows 檔案總管輸入：

    \\wsl$\Ubuntu\home\<你的Linux使用者名稱>

即可看到 Linux 內的檔案。

------------------------------------------------------------------------

# 8. 使用 VS Code 開啟 WSL 專案（推薦）

在 WSL 專案目錄中執行：

``` bash
code .
```

VS Code 會自動使用 **Remote WSL** 模式。

左下角會顯示：

    WSL: Ubuntu

------------------------------------------------------------------------

# 9. 常見問題排除

## Codex 找不到

``` bash
which codex
```

如果沒有結果：

``` bash
npm install -g @openai/codex
```

------------------------------------------------------------------------

## WSL 很慢

確保專案在：

    ~/code

不要在：

    /mnt/c/Users/...

------------------------------------------------------------------------

## 更新 WSL

在 PowerShell 執行：

``` powershell
wsl --update
wsl --shutdown
```

------------------------------------------------------------------------

# 10. 完成

現在你可以在 **WSL Linux 環境**中使用 Codex CLI， 而不會觸發 Symantec 的
**PowerShell Base64 行為偵測**。

啟動方式：

``` bash
wsl
cd ~/code/your-project
codex
```

-----------------------------------------------------------------------