
在 AI 輔助編程日益普及的今天,能夠在終端機(Terminal)環境中直接呼叫 AI 工具,是許多開發者夢寐以求的效率配置。本文將手把手教你如何在 Windows 11 環境下,透過微軟強大的 Linux 子系統(WSL2),搭建 Node.js 環境並成功安裝 Codex CLI。
不需要繁雜的虛擬機設定,只需幾個指令,我們就能打造一個輕量且強大的開發環境。
第一步:啟用 Windows 的 Linux 子系統 (WSL2)
Windows 11 對開發者最友善的功能之一就是 WSL2(Windows Subsystem for Linux 2)。它讓我們可以在 Windows 上原生執行 Linux 環境,這對於安裝各種開發工具來說至關重要。操作步驟:
- 請點擊電腦下方的「開始」選單,搜尋 PowerShell。
- 重要: 請務必按右鍵選擇「以系統管理員身分執行」。
- 在藍色的 PowerShell 視窗中輸入以下指令並按下 Enter:
wsl --install
💡 小提醒:
- 如果你是第一次執行此指令,系統會自動下載 Ubuntu 並進行安裝。
- 安裝完成後,請務必重新啟動電腦以讓設定生效。
- 重啟後,系統會自動跳出 Ubuntu 的視窗,請依照畫面指示設定你的 Linux 使用者名稱與密碼。
第二步:建置 Node.js 開發環境
Codex CLI 是基於 Node.js 開發的工具,因此我們需要在剛剛安裝好的 Ubuntu (WSL) 環境中安裝 Node.js 與 npm(套件管理工具)。
1. 更新套件庫 為了確保下載到最新的軟體,請先執行更新指令:
sudo apt update2. 安裝 Node.js 與 npm 接下來,透過 apt 套件管理員一次安裝這兩個核心元件:
sudo apt install -y nodejs npm
3. 驗證安裝結果 安裝完畢後,我們需要檢查版本以確認安裝成功。請依序輸入以下兩行指令:
node --version
npm --version
若畫面出現類似 v16.x.x 或 v18.x.x 的版號,代表你的基礎環境已經準備就緒!
第三步:安裝 Codex CLI
萬事俱備,現在我們可以透過 npm 來安裝 OpenAI 的 Codex 命令列工具。
操作步驟:
由於這是全域安裝(Global Install),我們需要使用 sudo 來取得系統管理員權限。請在終端機中輸入以下指令:
sudo npm install -g @openai/codex
💡 小提醒: 輸入上述指令後,系統可能會要求您輸入密碼。輸入密碼時螢幕上不會顯示任何字元(不會有星星或黑點),這是正常的 Linux 安全機制,請放心輸入完畢並按下 Enter 即可。
最終驗證:
安裝完成後,讓我們來確認 Codex 是否能正常啟動:
codex --version
如果終端機回傳了版本號,恭喜你!你已經成功在 Windows 11 的 WSL2 環境中部署了 Codex CLI。現在你可以開始探索如何在命令行中運用 AI 來加速你的開發工作流了。
後記與建議: 使用 WSL2 進行開發不僅能享受 Linux 強大的指令集,還能保持 Windows 系統的日常便利性。如果你在安裝過程中遇到權限問題(Permission denied),記得在指令前加上
sudo試試看。


