前言
OpenAI Codex CLI 是 OpenAI 推出的命令列 AI 程式開發助手，預設搭載 GPT-5.5 模型，可以在終端機中直接用自然語言跟 AI 互動，幫你寫程式、除錯、重構、分析程式碼。根據 OpenAI 官方說法，GPT-5.5 是目前最強的 agentic coding 模型，擅長理解大型程式碼架構、自主規劃並完成多步驟的開發任務。
Codex CLI 目前支援 ChatGPT Plus、Pro、Business、Enterprise、Edu 及 Go 方案的使用者，不需要另外申請 API Key，啟動後會透過你的 OpenAI 帳號直接驗證。
這篇文章會從一台全新的 Windows 電腦開始，手把手帶你完成安裝。
環境需求
- Windows 10 或 Windows 11
- 系統管理員權限（安裝過程中會用到）
- 網路連線
- OpenAI 帳號，且已訂閱 ChatGPT Plus、Pro、Business、Enterprise、Edu 或 Go 方案
安裝流程總覽
安裝 Node.js → 確認 npm 可用 → 全域安裝 @openai/codex → 登入 OpenAI 帳號 → 沙箱設定
整個流程大約 5～10 分鐘就能搞定。
第一步：安裝 Node.js
@openai/codex 是一個 npm 套件，而 npm 會跟著 Node.js 一起裝好，所以我們要先把 Node.js 裝起來。
方法一：用 winget 安裝（建議）
Windows 10（1709 以上版本）和 Windows 11 有內建 winget 套件管理工具，打開 PowerShell 或命令提示字元，輸入：
winget install OpenJS.NodeJS.LTS
系統會自動下載並安裝最新的 Node.js LTS（長期支援）版本。安裝過程中會跳出 UAC（使用者帳戶控制）視窗，請點「是」允許安裝。
什麼是 LTS？ LTS 是 Long Term Support（長期支援）的縮寫，代表這是最穩定、最適合一般使用的版本。
方法二：從官網手動下載
- 前往 Node.js 官方網站：https://nodejs.org
- 點選 LTS（建議大多數使用者）版本的下載按鈕
- 下載完成後，執行
.msi安裝檔 - 安裝精靈一路按「Next」，用預設設定就好
- 完成安裝
第二步：確認安裝結果
安裝好之後，請先關掉目前的終端機，再重新開一個新的 PowerShell 或命令提示字元。因為安裝程式會修改系統的 PATH 環境變數，舊的終端機視窗不會自動吃到新的 PATH。
輸入以下指令確認 Node.js 和 npm 都裝好了：
node --version
預期會看到類似這樣的輸出：
v24.16.0
npm --version
預期會看到類似這樣的輸出：
11.13.0
兩個指令都有正確顯示版本號的話，就代表安裝成功了。
常見問題：出現「不是可辨識的命令」
如果看到這樣的錯誤訊息：
'node' 不是內部或外部命令、可執行的程式或批次檔。
請確認以下幾點：
- 有沒有重新開啟終端機視窗
- 安裝過程有沒有順利完成（沒有跳錯誤訊息）
- 手動檢查 PATH 有沒有包含 Node.js 路徑：
C:\Program Files\nodejs\
如果不想重開終端機，也可以手動重新載入 PATH：
$env:Path = [System.Environment]::GetEnvironmentVariable("Path", "Machine") + ";" + [System.Environment]::GetEnvironmentVariable("Path", "User")
第三步：全域安裝 @openai/codex
確認 npm 可以用之後，執行以下指令：
npm install -g @openai/codex
參數說明：
– install：安裝套件
– -g：全域安裝，這樣在任何資料夾底下都能直接使用 codex 指令
安裝成功後會看到類似這樣的輸出：
added 2 packages in 14s
第四步：確認 Codex CLI 可以使用
安裝好之後，輸入以下指令確認：
codex --version
有出現版本號就代表安裝成功，可以開始使用 OpenAI Codex CLI 了。
第五步：登入 OpenAI 帳號
Codex CLI 不需要手動設定 API Key，而是直接用你的 ChatGPT 帳號登入。在終端機輸入：
codex login
執行後會出現類似這樣的訊息：
Starting local login server on http://localhost:1455.
If your browser did not open, navigate to this URL to authenticate:
https://auth.openai.com/oauth/authorize?...
瀏覽器會自動打開 OpenAI 的登入頁面。登入流程如下：
- 瀏覽器自動跳出 OpenAI 登入頁面（如果沒有自動打開，手動複製終端機裡的網址到瀏覽器）
- 用你的 ChatGPT 帳號登入
- 畫面會顯示「Sign in to Codex with ChatGPT」，說明 Codex 會連結你的帳號名稱、Email 和大頭照
- 點選「Continue」授權
- 回到終端機，會看到「Successfully logged in」，代表登入成功
提醒： 登入後 Codex CLI 會使用你 ChatGPT 方案的額度和速率限制。你的聊天記錄不會被分享給 Codex。
遠端或無畫面的機器？ 如果你是在沒有瀏覽器的環境（例如透過 SSH 連線的伺服器），可以用
codex login --device-auth改用裝置授權碼的方式登入。
常見問題：token 過期錯誤
使用一段時間後，如果啟動 codex 時看到類似這樣的錯誤訊息：
error: "Your authentication token has been invalidated. Please try signing in again."
這代表你的登入 token 已經過期或失效了。只要重新執行一次登入指令就能解決：
codex login
登入成功後再重新啟動 codex 即可正常使用。
第六步：首次啟動與沙箱設定
登入完成後，在終端機輸入 codex 啟動 Codex CLI。第一次啟動時會先看到沙箱（Sandbox）設定選單：
› 1. Set up default sandbox (requires Administrator permissions)
2. Use non-admin sandbox (higher risk if prompt injected)
3. Quit
什麼是沙箱？
沙箱是一層安全防護機制，用來隔離 Codex CLI 對你電腦檔案和網路的存取。簡單來說，就是讓 AI 在一個「受控的環境」裡面執行操作，避免它不小心動到你不想被改的檔案。
三個選項怎麼選？
| 選項 | 說明 | 建議 |
|---|---|---|
| 1. Set up default sandbox | 用系統管理員權限建立完整沙箱，安全性最高 | 建議選這個 |
| 2. Use non-admin sandbox | 不需管理員權限，但遇到 prompt injection 時風險較高 | 不建議 |
| 3. Quit | 離開，之後再設定 | — |
設定步驟
- 按下
1選擇「Set up default sandbox」 - 系統會跳出 UAC（使用者帳戶控制）視窗，點「是」授予管理員權限
- 畫面會顯示「Setting up sandbox…」，這時候需要耐心等待幾分鐘（實測約 1～2 分鐘），在這段期間輸入欄位會顯示「Input disabled until setup completes.」，這是正常的，不需要做任何操作
- 沙箱建立完成後，就會看到 Codex CLI 的主畫面：
╭───────────────────────────────────────╮
│ >_ OpenAI Codex (v0.136.0) │
│ │
│ model: gpt-5.5 /model to change │
│ directory: ~ │
╰───────────────────────────────────────╯
看到這個畫面就代表一切就緒，可以直接在下方輸入欄位用自然語言下指令了。
提醒： 沙箱只需要設定一次，之後每次啟動
codex都會自動套用。更多資訊： 關於 Windows 沙箱的詳細說明，可以參考 OpenAI 官方文件：https://developers.openai.com/codex/windows
完整指令速查
# 1. 安裝 Node.js
winget install OpenJS.NodeJS.LTS
# 2. 重開終端機後，確認安裝成功
node --version
npm --version
# 3. 全域安裝 Codex CLI
npm install -g @openai/codex
# 4. 確認 Codex CLI
codex --version
# 5. 登入 OpenAI 帳號（瀏覽器會自動打開）
codex login
# 6. 啟動 Codex CLI，首次啟動時選擇沙箱設定（等待 1～2 分鐘）
codex
總結
| 步驟 | 指令 | 用途 |
|---|---|---|
| 1 | winget install OpenJS.NodeJS.LTS |
安裝 Node.js 和 npm |
| 2 | node --version / npm --version |
確認安裝成功 |
| 3 | npm install -g @openai/codex |
安裝 Codex CLI |
| 4 | codex --version |
確認可以使用 |
| 5 | codex login |
用瀏覽器登入 OpenAI 帳號 |
| 6 | codex 啟動後選擇沙箱模式 |
建立安全防護環境 |
從乾淨的 Windows 到能用 Codex CLI，只要幾個安裝指令，整個過程大約 5～10 分鐘。不需要手動設定 API Key，透過 codex login 用你的 ChatGPT 帳號登入就能直接使用。
