【實戰教學】Windows 11 完美部署 OpenAI Codex

Josh-avatar-img
發佈於AI
更新 發佈閱讀 4 分鐘
raw-image

在 AI 輔助編程日益普及的今天,能夠在終端機(Terminal)環境中直接呼叫 AI 工具,是許多開發者夢寐以求的效率配置。本文將手把手教你如何在 Windows 11 環境下,透過微軟強大的 Linux 子系統(WSL2),搭建 Node.js 環境並成功安裝 Codex CLI。

不需要繁雜的虛擬機設定,只需幾個指令,我們就能打造一個輕量且強大的開發環境。

第一步:啟用 Windows 的 Linux 子系統 (WSL2)

Windows 11 對開發者最友善的功能之一就是 WSL2(Windows Subsystem for Linux 2)。它讓我們可以在 Windows 上原生執行 Linux 環境,這對於安裝各種開發工具來說至關重要。

操作步驟:

  1. 請點擊電腦下方的「開始」選單,搜尋 PowerShell
  2. 重要: 請務必按右鍵選擇「以系統管理員身分執行」。
  3. 在藍色的 PowerShell 視窗中輸入以下指令並按下 Enter:
wsl --install

💡 小提醒:

  • 如果你是第一次執行此指令,系統會自動下載 Ubuntu 並進行安裝。
  • 安裝完成後,請務必重新啟動電腦以讓設定生效。
  • 重啟後,系統會自動跳出 Ubuntu 的視窗,請依照畫面指示設定你的 Linux 使用者名稱與密碼。

第二步:建置 Node.js 開發環境

Codex CLI 是基於 Node.js 開發的工具,因此我們需要在剛剛安裝好的 Ubuntu (WSL) 環境中安裝 Node.js 與 npm(套件管理工具)。

1. 更新套件庫 為了確保下載到最新的軟體,請先執行更新指令:

sudo apt update

2. 安裝 Node.js 與 npm 接下來,透過 apt 套件管理員一次安裝這兩個核心元件:

sudo apt install -y nodejs npm

3. 驗證安裝結果 安裝完畢後,我們需要檢查版本以確認安裝成功。請依序輸入以下兩行指令:

node --version 
npm --version

若畫面出現類似 v16.x.xv18.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 試試看。

留言
avatar-img
Josh的沙龍
6會員
72內容數
分享知識
Josh的沙龍的其他內容
2026/01/05
本文介紹如何在 Google Antigravity IDE 中安裝 @leonardsellem/n8n-mcp-server,將 AI 助手轉變為 n8n 自動化平台的營運中心。包含核心功能介紹、關鍵的 API 路徑配置技巧,以及如何透過自然語言指令來管理、執行與除錯工作流,讓自動化開發更智能。
Thumbnail
2026/01/05
本文介紹如何在 Google Antigravity IDE 中安裝 @leonardsellem/n8n-mcp-server,將 AI 助手轉變為 n8n 自動化平台的營運中心。包含核心功能介紹、關鍵的 API 路徑配置技巧,以及如何透過自然語言指令來管理、執行與除錯工作流,讓自動化開發更智能。
Thumbnail
2026/01/02
厭倦了 AI 寫出過時或不存在的程式碼?Context7 是一個能將最新技術文件即時注入 AI 的 MCP 伺服器。本文提供在 Google Antigravity IDE 上的完整安裝教學,並深入分析設定檔差異,助你打造最強 AI 輔助開發環境。
Thumbnail
2026/01/02
厭倦了 AI 寫出過時或不存在的程式碼?Context7 是一個能將最新技術文件即時注入 AI 的 MCP 伺服器。本文提供在 Google Antigravity IDE 上的完整安裝教學,並深入分析設定檔差異,助你打造最強 AI 輔助開發環境。
Thumbnail
2026/01/02
本文介紹開源專案 n8n-skills,它能賦予 AI 模型關於 n8n 自動化工具的完整知識庫。文章將詳細解析如何透過 Antigravity 的 Global Rules 設定,將此技能包掛載給 AI Agent,讓 Claude 等模型能精準回答節點設定與流程設計問題,大幅提升開發效率。
Thumbnail
2026/01/02
本文介紹開源專案 n8n-skills,它能賦予 AI 模型關於 n8n 自動化工具的完整知識庫。文章將詳細解析如何透過 Antigravity 的 Global Rules 設定,將此技能包掛載給 AI Agent,讓 Claude 等模型能精準回答節點設定與流程設計問題,大幅提升開發效率。
Thumbnail
看更多