Codex on Windows 現在已經不是「只能勉強用 WSL 跑 CLI」的狀態。OpenAI 官方文件已經把 Windows 列為 Codex 的正式使用場景：你可以用原生 Windows Codex app、Codex CLI、IDE extension，也可以在 WSL2 裡跑 Linux 版工作流。這篇會用 2026 年 6 月 3 日的最新官方文件整理：Windows 要怎麼裝、native sandbox 和 WSL2 怎麼選、第一次啟動要注意什麼，以及常見錯誤怎麼排查。
如果你之前看過我寫的 OpenAI Codex CLI 安裝教學 或 OpenAI Codex 桌機版介紹，這篇可以當成 Windows 版的更新補充。重點是：Windows 11 優先用原生 Codex；需要 Linux 工具鏈時再選 WSL2。
Codex on Windows 目前有哪些用法？
依 OpenAI 官方 Codex Windows 文件，Codex 在 Windows 上主要有三種表面可以用：Codex app、CLI、IDE extension。實際執行環境則有三種路線：Windows 原生 elevated sandbox、Windows 原生 unelevated sandbox，以及 WSL2。
| 使用方式 | 適合情境 | 建議 |
|---|---|---|
| Codex app on Windows | 多 agent、worktrees、review diffs、artifact previews、in-app browser | Windows 11 使用者優先嘗試 |
| Codex CLI on Windows | 終端機工作流、快速修 bug、跑測試、改檔案 | PowerShell / Windows Terminal 皆可 |
| IDE extension | 習慣 VS Code 或 IDE 裡做開發的人 | 搭配本機 repo 或 WSL remote 使用 |
| WSL2 | Node.js、Python、PHP、Linux server、Docker-like 工作流 | repo 建議放在 ~/code，不要放 /mnt/c |
我的建議很簡單：如果你是一般 Windows 11 開發者，先用原生 Codex app 或 CLI；如果你本來就用 Ubuntu、Linux shell、nvm、pyenv、PHP CLI、Docker 工具鏈，再用 WSL2。
安裝前檢查：Windows 11、winget、管理員權限
官方文件把 Windows 11 列為推薦基準。更新過的 Windows 10 可以 best effort 使用，但可靠性不如 Windows 11，而且 Windows 10 至少需要 1809 以上，因為 Codex 依賴現代 console 支援，例如 ConPTY。舊版 Windows 10 不建議使用。
- Windows 11：最推薦，尤其企業部署或長期使用。
- 最新 Windows 10：可以嘗試，但穩定性較差。
- 舊 Windows 10：不建議，容易缺少必要 console 元件。
- winget：官方文件提到 Windows 環境應該要有 winget；如果沒有，先更新 Windows 或安裝 Windows Package Manager。
- 管理員權限：原生 Windows sandbox 的推薦模式需要 administrator-approved setup。
路線一：用原生 Windows Codex app
如果你想要接近「桌面端 AI coding command center」的體驗，先用 Codex app。官方 Codex 頁面也明確寫到 Codex 可用於 macOS 與 Windows。Windows app 適合需要多個 agent 同時工作、用 worktrees 隔離任務、看 diff、跑本機 app server 或預覽 artifact 的人。
- 到 OpenAI Codex 官方頁面取得 Windows 版 Codex app。
- 安裝後登入 ChatGPT / OpenAI 帳號。
- 打開你的專案資料夾。
- 先選一個小任務測試，例如「讀 README，整理啟動與測試方式」。
- 確認 diff、terminal、preview 都正常後，再交給 Codex 修 bug 或補測試。
第一次使用不要直接讓它改大型專案。你可以先請它「只讀不改」，確認它理解 repo 結構，再逐步放手。
路線二：用 Codex CLI 跑在 Windows 原生環境
Codex CLI 是 OpenAI 的本機終端 coding agent，可以讀取、修改、執行你選定資料夾裡的程式碼。官方 CLI 文件也指出 Codex CLI 支援 macOS、Windows、Linux；Windows 上可以原生跑 PowerShell 的 Windows sandbox，也可以在需要 Linux-native 環境時使用 WSL2。
安裝方式請以官方 Codex CLI 頁面顯示為準。舊版文章常見的 npm install -g @openai/codex 曾經是主要路線，但現在官方文件已把 standalone installer、Windows 原生 sandbox、app/CLI/IDE extension 放在同一套 Codex 文件中，所以不要只照舊文章死背 npm 指令。
# 安裝後在專案資料夾啟動
cd C:\Users\你的帳號\code\your-project
codex第一次啟動會要求登入，可以使用 ChatGPT 帳號或 API key。登入後，先用保守任務測試：
請先閱讀這個專案，整理技術棧、啟動方式、測試方式。
先不要修改任何檔案。Windows sandbox：elevated 與 unelevated 怎麼選？
這是 Codex on Windows 最新文件裡最重要的更新之一。當你在 Windows 原生環境跑 Codex agent mode，Codex 會用 Windows sandbox 限制檔案寫入範圍，並在沒有你明確允許時阻擋網路存取。官方目前把 Windows sandbox 分成兩種模式：
| 模式 | 特色 | 何時使用 |
|---|---|---|
elevated | 推薦模式，使用專用低權限 sandbox users、檔案系統邊界、firewall rules 與本機 policy 設定 | 你的 Windows 允許管理員核准設定時 |
unelevated | fallback 模式，使用目前使用者衍生的 restricted token 與 ACL 邊界，網路隔離較弱 | 公司電腦或政策擋住 elevated setup 時暫用 |
設定檔可以使用：
[windows]
sandbox = "elevated" # 或 "unelevated"如果兩種模式都可用，官方建議用 elevated。如果預設 sandbox 在你的企業電腦上不能跑，可以先改用 unelevated 繼續工作，再和 IT 確認本機使用者/群組建立、firewall 設定與 logon rights 是否被政策擋住。
路線三：用 WSL2 跑 Codex CLI
如果你的專案本來就偏 Linux，例如 Node.js、Python、PHP、Ruby、Laravel、WordPress CLI、Linux server 腳本，WSL2 仍然是很穩的選擇。官方文件也明確提醒：Codex 0.115 起 Linux sandbox 改用 bubblewrap，因此 WSL1 不再支援，請使用 WSL2。
在系統管理員 PowerShell 或 Windows Terminal 裡安裝 WSL：
wsl --install
wsl進入 WSL shell 後，再安裝並執行 Codex：
curl -fsSL https://chatgpt.com/codex/install.sh | sh
codex專案位置很重要。不要把 repo 放在 /mnt/c/... 底下長期開發，I/O 會慢，也容易碰到 symlink 和權限問題。建議放在 WSL 的 Linux home 目錄：
mkdir -p ~/code
cd ~/code
git clone https://github.com/your/repo.git
cd repo
codexVS Code 搭配 WSL：確認你真的在 Linux 環境
如果你用 VS Code，建議從 WSL shell 裡開啟專案：
cd ~/code/your-project
code .打開後確認 VS Code 左下角是否顯示 WSL: <distro>，整合終端機路徑應該像 /home/...，而不是 C:\。也可以在 terminal 裡跑：
echo $WSL_DISTRO_NAME
which codex || echo "codex not found"如果 VS Code 找不到 Codex，通常代表你在 Windows 裡裝了 Codex，但 WSL 裡沒有；Windows 和 WSL 是兩個環境，CLI 要分開安裝。
常見錯誤排查
1. native sandbox setup failed
常見原因是 UAC 或管理員提示被拒絕、公司電腦不允許建立本機 user/group、不能改 firewall rules，或政策擋住 sandbox users 需要的 logon rights。先重新跑 elevated setup；如果公司政策不允許，暫時改用 unelevated，並請 IT 協助確認政策。
2. Windows error 1385
官方文件指出，這通常代表 Windows policy 不允許 sandbox user 用需要的 logon type 啟動命令。短期可改用 unelevated sandbox；長期要請 IT 檢查 group policy 或 OU 差異。
3. sandbox 讀不到某個資料夾
如果是 Windows 原生 sandbox 讀不到目錄，可以用官方提供的 slash command 加上讀取權限：
/sandbox-add-read-dir C:\absolute\directory\path4. WSL 大型 repo 很慢
不要在 /mnt/c 底下開發，把 repo 移到 WSL 裡的 ~/code。另外更新 WSL：
wsl --update
wsl --shutdown5. IDE extension 沒反應
官方 troubleshooting 提到，某些 native dependencies 需要 C++ 開發工具。可以用 winget 安裝 Visual Studio Build Tools：
winget install --id Microsoft.VisualStudio.2022.BuildTools -e裝完後完整重啟 VS Code。
我建議的 Windows Codex 工作流
- Windows 11：先用原生 Codex app 或 CLI。
- 第一次啟動：先讓 Codex 只讀專案，不要改檔案。
- 確認 sandbox：優先 elevated，失敗再用 unelevated。
- Linux 工具鏈：專案搬到 WSL2 的
~/code。 - 重要專案：一定用 Git，改完看 diff，再讓 Codex 跑測試。
- 需要比較工具時，可延伸看 Claude Code vs Codex 與 GitHub Copilot CLI Windows 安裝教學。
結論：2026 的 Codex on Windows，先原生，再 WSL2
2026 年的 Codex on Windows 已經可以分成兩條穩定路線：一般 Windows 11 使用者優先用原生 Codex app / CLI / IDE extension，享受 Windows sandbox、worktrees、多 agent 和本機預覽；Linux 工具鏈重度使用者則用 WSL2，並把 repo 放在 ~/code。不要再把 Windows 當成「只能用 WSL 勉強跑 Codex」的平台，現在真正要判斷的是：你的專案是 Windows-native，還是 Linux-native。
常見問題 FAQ
Codex 現在可以在 Windows 原生執行嗎？
可以。OpenAI 官方 Windows 文件已列出 Codex app、CLI、IDE extension 都可在 Windows 使用，並提供 Windows 原生 sandbox 模式。Windows 11 是最推薦的基準。
Codex on Windows 要用 WSL2 嗎？
不一定。一般 Windows 11 開發者可先用原生 Codex；如果你的工具鏈本來就在 Linux，例如 Node.js、Python、PHP、server 腳本或 Linux CLI，才建議用 WSL2。
WSL1 還能跑 Codex 嗎？
不建議。官方文件指出 WSL1 支援到 Codex 0.114；從 Codex 0.115 起，Linux sandbox 改用 bubblewrap，因此 WSL1 不再支援，請改用 WSL2。
elevated sandbox 和 unelevated sandbox 差在哪？
elevated 是推薦模式，使用專用低權限 sandbox users、檔案邊界和 firewall rules；unelevated 是 fallback，使用目前使用者衍生的 restricted token，隔離較弱，但可在企業政策擋住 elevated 時暫時使用。
VS Code 在 WSL 裡找不到 codex 怎麼辦？
先確認 VS Code 左下角顯示 WSL，再在整合終端機執行 which codex。如果找不到，代表 WSL 裡沒有安裝 Codex；Windows 和 WSL 是不同環境，需要在 WSL 裡再安裝一次。
