# 賽門鐵克端點防護誤擋 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 ``` -----------------------------------------------------------------------