OpenAI API 學習筆記 : 在 Win11 安裝 Codex CLI

前陣子 OpenAI 推出 Codex 後看到網路上有非常多討論文章, 感覺似乎其 Coding 能力不輸 Claude Code, 但我一直沒時間試用, 今天抽空來安裝 Codex CLI 玩玩看. 

最近在市圖新書架上看到洪錦魁老師新書 "Vibe Coding - Python超級入門 : ChatGPT x Codex", 在末尾章節有介紹如何安裝 Codex CLI, 但須先安裝 WSL, 用 Windows 附的 Linux 環境來安裝, 但我詢問 Gemini, 發現其實可以利用 Git Bash 介面來跑 Codex CLI, 不需要透過 WSL, 與 Claude Code 類似, 但 Codex CLI 是用 npm 安裝的, 與 Claude Code 用 PS 指令稿不同, 參考 : 

# MSI 桌機安裝 Claude Code

1. 安裝 Scoop, Git, Nvm 與 Node.js : 

首先用一般使用者身份開啟 PS 視窗, 安裝 scoop 後再利用它來安裝 git 與 node, 只要在 PS 視窗依序輸入下列指令安裝即可 :

• 設定 PowerShell 視窗腳本執行原則 : 
  Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser
• 安裝 scoop : 
  Invoke-RestMethod -Uri https://get.scoop.sh | Invoke-Expression
• 安裝 git :
  scoop install git  
• 安裝 nvm : 
  scoop install nvm
• 用 nvm 安裝 node.js : 
  nvm install node 
  

我的 LG Gram 筆電之前安裝 Claude Code 就已安裝好 : 

PS C:\Users\tony1> scoop --version  

Current Scoop version:

b588a06e (HEAD -> master, tag: v0.5.3, origin/master, origin/HEAD) chore(release): Bump to version 0.5.3 (resync) (#6436)

'main' bucket:

408b426f8c (HEAD -> master, origin/master, origin/HEAD) sqruff: Update to version 0.34.1

PS C:\Users\tony1> git version  

git version 2.52.0.windows.1

用 where.exe 檢視 Git Bash 指令檔位置 :

PS C:\Users\tony1> where.exe bash   

C:\Users\tony1\scoop\shims\bash.exe

PS C:\Users\tony1> nvm --version  

1.2.2

檢查 nvm 附帶的 npm 工具版本 :

PS C:\Users\tony1> npm --version  

11.13.0

Node.js 之前在安裝 Gemini CLI 時也用 Scoop 安裝好了 :

PS C:\Users\tony1> node --version  

v25.2.1

參考 :

# MSI 桌機安裝 Gemini CLI

2. 安裝 Codex CLI : 

當以上環境準備好後, 即可用 nvm 附帶的 npm 工具安裝 Codex CLI 了 : 

npm install -g @openai/codex 

PS C:\Users\tony1> npm install -g @openai/codex    

added 2 packages in 1m

npm notice

npm notice New minor version of npm available! 11.13.0 -> 11.19.0

npm notice Changelog: https://github.com/npm/cli/releases/tag/v11.19.0

npm notice To update run: npm install -g npm@11.19.0

npm notice

顯示 "added 2 packages in 1m" 表示 Codex 已安裝成功, 其餘 notice 訊息只是提醒 npm 已有新版可更新而已. 檢查 Codex CLI 版本 : 

PS C:\Users\tony1> codex --version   

codex-cli 0.147.0

3. 執行 Codex CLI : 

在 PS 視窗下 codex 指令即可進入 Codex CLI 介面, 首先會要求登入 ChatGPT 或提供 API Key 才能使用 Codex, 我之前有儲值 API Key, 移動至 3. Provide your own API Key, 按 Enter :

貼上 API Key 後按 Enter :

按 Yes, continue : 

選 2. Use non-admin sandbox :

這時會花幾分鐘去設定沙箱 : 

請耐心等待設定, 完成後即可進行專案開發 :

其實比較正確的做法是要先建立一個專案資料夾, 然後用 cd 進入專案資料夾後再下 codex 指令.