Windows 在 WSL2 裏安裝與運行 Codex:完整步驟、跨盤卡頓優化與 VS Code 聯動

在 Windows 上遇到原生沙箱權限受限、Bash 腳本斜槓報錯或軟連結失靈時,官方推薦切到 WSL2 環境運行 Codex。本文按官方文檔講清 WSL2 安裝要求(不支持 WSL1)、原生腳本安裝、避開 /mnt/c 慢速目錄以及聯動 VS Code 的標準步驟。

NNathaniel bigo··原創首發·AI 輔助撰寫
9 分鐘讀完
資料核對於 2026-11-18 · 依據官方文檔與公開資料整理 Plus 帳號

結論先說

  1. 必須用 WSL2,不能用舊版 WSL1:官方明確說明自 Codex 0.115 版本將 Linux 沙箱底層遷移到 bubblewrap 起,已徹底停止對 WSL1 的支持。
  2. 頭號性能鐵律:代碼倉庫一定要放在 Linux 原生目錄(如 ~/code/)下,千萬別直接 cd 進 /mnt/c/Users/... 跑大項目,否則跨文件系統 I/O 會讓搜尋和裝依賴慢上好幾倍。
  3. WSL 裏直接走 Linux 官方一行腳本安裝,不要去調宿主機 Windows 盤符裏裝的那份 .exe。
  4. 編輯器從 WSL 內部敲 code . 拉起:配合官方 WSL 擴展,讓 VS Code 窗口、集成終端和 Codex 全部處在同一個 Linux 上下文裏。

Windows 原生與 WSL2 運行對比

圖:本站根據 OpenAI Codex 官方文檔 WSL 整理的示意圖

本文根據 OpenAI Codex 官方文檔《WSL》整理,核對日期 2026-11-18。配圖為本站整理的示意圖,不是介面截圖。本站(bigolab.com)不是 OpenAI 官方網站。

適用於誰

  • 搜「codex wsl 安裝」「windows 用 wsl2 跑 codex」「codex 在 wsl 裏很慢」的 Windows 開發者;
  • 在原生 Windows 環境碰到沙箱初始化報錯(排查見 /guides/codex-windows-sandbox-setup-failed),或者項目本身重度依賴 Linux 編譯工具鏈、Shell 腳本與軟連結的人;
  • 在 VS Code 連接 WSL 後提示找不到 codex 命令,正在核對路徑配置的同學。

如果你只想安裝圖形介面的 Windows 桌面客戶端,可參考 /guides/codex-windows-app-download-install;本文專門講把開發環境和 Codex CLI 完整放進 WSL2 Linux 子系統的官方方案。

一、三步在 WSL2 內裝好並啟動 Codex

第一步:確認開啟 WSL2 發行版

以管理員身份打開 Windows PowerShell 或 Windows Terminal,安裝預設 Linux 發行版(通常為 Ubuntu)並檢查內核代數:

powershell
# 首次安裝 WSL2 與預設 Ubuntu 發行版
wsl --install

# 若早已裝過,確認 VERSION 列顯示為 2(若過舊可順手更新內核)
wsl --update
wsl -l -v

第二步:進入 Linux 子系統運行官方安裝腳本

輸入 wsl 進入 Linux Shell 後,直接使用官方安裝命令(通用升級方法見 /guides/codex-cli-install-update):

bash
curl -fsSL https://chatgpt.com/codex/install.sh | sh
codex

首次運行 codex 時按終端提示完成帳號登入授權即可。

第三步:把項目克隆進 Linux 主目錄(最關鍵的提速點)

很多剛從 Windows 切進 WSL 的開發者,習慣直接 cd /mnt/c/Project 接着改原來的文件夾,結果發現 git status、rg 全局搜尋和 pnpm install 卡得要命。這是因為 /mnt/c 需要經過跨系統文件橋接,不僅大量小文件讀寫極慢,還經常鬧出文件可執行權限與軟連結報錯。

官方推薦的標準姿勢是在 Linux 自己的主目錄下建工作區:

bash
mkdir -p ~/code && cd ~/code
git clone https://github.com/你的組織/你的倉庫.git
cd 你的倉庫

平時如果你需要在 Windows 文件資源管理器裏直接查看或拖入文件,只需在資源管理器地址列輸入 \\wsl$\Ubuntu\home\<你的Linux用戶名>\code 就能直接打開。

在 WSL2 安裝並提速 Codex 四步

圖:本站根據 OpenAI Codex 官方文檔 WSL 整理的示意圖

二、怎麼和 VS Code 無縫配合

  1. 在宿主機 Windows 的 VS Code 裏裝好微軟官方的 WSL 擴展(ms-vscode-remote.remote-wsl);
  2. 回到剛才的 WSL 終端,進入 ~/code/你的倉庫 後敲 code .;
  3. 確認新彈出的 VS Code 左下角綠色狀態欄顯示 WSL: Ubuntu——這代表集成終端和擴展(插件加載排錯見 /guides/codex-vscode-extension-install-not-loading)現在全部原生跑在 Linux 環境內。

如果在集成終端裏報找不到 codex,在 WSL Shell 裏敲 which codex 檢查 ~/.local/bin(或 npm 全局 bin 目錄)是否已寫入 ~/.bashrc 或 ~/.zshrc 的 PATH 環境變量。在 Windows 工作站通過 ChatGPT 訂閱帳號日常高頻使用 Codex 開發時,官方套餐說明也可參考 /chongzhi/chatgpt-plus。

常見問題

Q:代碼已經挪到了 ~/code/ 下,跑超大單體倉庫構建時還是覺得內存吃緊怎麼辦?

WSL2 預設分配的內存上限取決於宿主機物理內存比例。先在 PowerShell 運行 wsl --update 與 wsl --shutdown 重啟清爽實例;若編譯重型項目仍報內存不足,可在 Windows 用戶目錄下的 .wslconfig 文件中適度調高分配給 WSL2 虛擬機的 memory 和 processors 配額。

Q:在 WSL2 裏登入一次帳號後,Windows 原生終端裏還要重新登嗎?

WSL2 內部擁有獨立的 Linux 用戶主目錄(~/.codex/),與宿主機 Windows 的 %USERPROFILE%\.codex\ 是兩套互不干擾的文件系統,因此兩邊如果都要用,各自登入和維護獨立配置最乾淨,也避免了跨系統換行符(CRLF 與 LF)把配置文件改亂。

Q:在 WSL2 終端敲 codex 登入時,彈不出宿主機 Windows 瀏覽器授權頁怎麼辦?

正常情況下 WSL2 支持自動調用宿主機預設瀏覽器打開回調地址;若你的精簡發行版未裝瀏覽器橋接組件導致未自動彈窗,直接按住 Ctrl 點擊終端裏打印出的完整認證連結(或複製貼進 Windows 瀏覽器)完成登入,本地迴環端口同樣能正常接住授權回調。

Q:克隆代碼進 ~/code/ 後,怎麼複用我平時在 Windows 上已經配好的 Git 憑據?

可以在 WSL2 內的 ~/.gitconfig 將 credential.helper 指向宿主機 Git 自帶的 Windows 憑據管理器(Git Credential Manager),或者為 WSL2 單獨生成一對 SSH 公鑰登記到代碼託管平台,這樣 Codex 在子系統內拉取分支時就不會因為卡在密碼輸入提示上而超時。

相關教學

參考資料

  • OpenAI Codex 官方文檔:WSL — https://learn.chatgpt.com/docs/windows/wsl
  • OpenAI Codex 開發者中心 — https://developers.openai.com/codex

Nathaniel 的更多內容

  1. 01

    LangGraph 流式輸出(Streaming)詳解:逐字 Token 流、節點進度與自定義事件寫法

    多步智能體如果等全部節點跑完才返回,網頁前端就會白屏乾等十幾秒。本文按 LangGraph 官方文檔講清 updates、messages、custom 與 values 四種 stream_mode 的區別,以及組合訂閱逐字打字機輸出加工具內部實時進度的完整代碼。

    其他 AI 工具0
  2. 02

    LangGraph 持久化與長期記憶怎麼配:Checkpointer、Store 與 PostgreSQL 實戰

    在生產環境跑 LangGraph,單靠 InMemorySaver 一重啟就會丟失全部對話。本文按官方文檔講清線程內短期檢查點(Checkpointer)與跨線程長期記憶(Store)的分工,以及用 langgraph-checkpoint-postgres 對接 PostgreSQL 的完整步驟。

    其他 AI 工具0
  3. 03

    LangGraph 多智能體怎麼寫:Supervisor 主管包與 Subgraph 隔離子圖實戰

    在 LangGraph 裏把單個圖擴展成多智能體協作有兩條官方路線:快速原型用預置包 langgraph-supervisor,大型生產系統用原生子圖(Subgraph)嵌套。本文講清兩種寫法的完整代碼、私有狀態隔離防 Token 膨脹技巧以及檢查點傳播規則。

    其他 AI 工具0
  4. 04

    LangGraph 人工介入審批怎麼寫:interrupt 暫停圖運行與 Command 恢復實戰

    企業之所以選 LangGraph,很大程度看中它能安全掛起等待人工審批(Human-in-the-Loop)。本文按官方最新規範講清 interrupt() 動態暫停、Checkpointer 必備條件、Command(resume=...) 恢復執行,以及防止副作用重複運行的重入規則。

    其他 AI 工具0
  5. 05

    多 Agent 協作平台怎麼選:Dify、釦子(Coze)、n8n 與 LangGraph 多智能體機制對比

    搜「多agent協作平台」時,Dify、釦子、n8n 和 LangGraph 都宣稱支持多智能體,但底層的調度方式完全不同。本文跳過基礎安裝,專門從多 Agent 角色跳轉、子代理工具調用、上下文隔離與私有化部署四個維度幫你一次選準。

    其他 AI 工具0
  6. 06

    企業微信有官方 MCP 和 CLI 嗎:@wecom/cli 安裝初始化、長連接機器人與接入教學

    搜「企業 微信 有 mcp 嗎」不用再東拼西湊民間群機器人腳本了:企業微信官方已推出 @wecom/cli 命令行工具並內置 stdio 模式的 MCP Server。本文按官方開發者文檔講清安裝、智能機器人長連接初始化、業務命令與接入 Claude Code 步驟。

    Claude其他 AI 工具0

同產品的其他教學

  1. 01

    多 Agent 協同開發怎麼落地:「一個寫、一個審」雙代理工作流搭建指南

    多 Agent 協同開發裏投入產出比最高的模式就是「一個寫、一個審」。本文依據 Anthropic 與 OpenAI 官方編碼最佳實踐,講清為什麼同會話自審容易漏問題,以及用只讀子代理、跨模型交叉審查(Claude Code + Codex)和自動化閉環落地的具體方法。

    ClaudeCodex0
  2. 02

    codebase-memory 類 MCP 是什麼、怎麼用:基於語法樹圖譜的本地代碼索引原理與配置

    codebase-memory-mcp(DeusData/codebase-memory-mcp)是一類本地代碼圖譜 MCP 伺服器:用 Tree-sitter 把倉庫解析成函數與調用關係的 SQLite 圖庫,幫編碼助手查調用鏈並省下讀整份文件的額度。

    ClaudeCodex0
  3. 03

    Chrome DevTools MCP 怎麼用、怎麼保留登入態:安裝配置、獨立目錄與遠程調試端口連接

    Chrome DevTools MCP 本身免費且無需註冊帳號,大家搜「登入」通常是為了讓 AI 調試需要登入的網頁後台。本文按官方倉庫文檔講清安裝命令,以及用 --userDataDir 持久化獨立配置目錄、用 --browserUrl 掛載已登入瀏覽器的兩種標準做法。

    ClaudeCodex0
  4. 04

    Codex 接入 Amazon Bedrock 與 Google Cloud Vertex AI 教學:企業雲託管配置

    企業合規要求模型流量統一走自家 AWS 或 GCP 雲帳單時,不需要硬拼第三方代理。本文根據 OpenAI Codex 官方文檔,講清原生接入 Amazon Bedrock(四種 AWS 憑證方式)與 Google Cloud Vertex AI(ADC 認證與區域駐留)的完整步驟。

    Codex0
  5. 05

    Codex 自動審查 GitLab Merge Request 怎麼配:公有云與自託管實例接入指南

    代碼託管在 GitLab 的團隊同樣可以用上 OpenAI 官方的雲端代碼審查。本文根據官方文檔講清 GitLab.com 與企業自託管實例的服務帳號配置、Developer 權限、Webhook 開啟與 AGENTS.md 規則約束。

    ChatGPTCodex0
  6. 06

    Codex 接入 Linear 怎麼用:指派 Issue、評論 @Codex 自動改碼與 Triage 分流教學

    用 Linear 管研發任務單的團隊,可以直接把 Issue 指派給 Codex 或在評論區 @Codex 自動拉起雲端環境改代碼。本文按 OpenAI 官方文檔講清雲端環境前置準備、連接器安裝、多倉庫指定技巧以及 Triage 規則自動派單配置。

    ChatGPTCodex0

0 條評論

登入 後參與評論

還沒有評論,來搶沙發~