Windows 完整安裝
從零開始,在 Windows 完成 Codex CLI 安裝,讓你可以在終端機使用會動手做事的 AI coding agent;也可以搭配 ChatGPT 桌面 App 當圖形介面。
系統需求
| 項目 | 最低需求 | 建議配置 |
|---|---|---|
| 作業系統 | Windows 10 | Windows 11 |
| 記憶體 | 4 GB | 8 GB 或以上 |
| Node.js | 用 npm 安裝時需 Node 22 以上 | 用官方 installer 可免裝 Node |
如果電腦太舊無法安裝,可直接用瀏覽器開啟 chatgpt.com 使用網頁版。
Step 1:安裝 Node.js(前置步驟)
- 在工作列搜尋欄輸入
PowerShell,開啟終端機 貼上以下指令安裝 Node.js LTS,按 Enter:
winget install OpenJS.NodeJS.LTS- 安裝完重新開啟終端機,輸入
node -v確認版本
▲ 在 PowerShell 執行 winget 安裝 Node.js,裝完用 node -v 確認
Step 2:安裝 ChatGPT 桌面應用程式(可選)
- 前往 chatgpt.com/download
- 選擇 Windows,下載安裝檔
- 開啟安裝檔,按指示完成安裝
- 開啟 App,用你的 ChatGPT 帳號登入
▲ ChatGPT 桌面 App 下載頁面 — 選擇你的作業系統
⚠️ 這步是選配——桌面 App 是圖形介面。本課程主線是終端機的 Codex CLI;就算不裝桌面 App,只要完成 Step 3 一樣能用完整功能。桌面 App 與 CLI 共用同一個 ChatGPT 帳號。
Step 3:安裝 Codex CLI
- 回到
PowerShell 貼上以下指令,按 Enter:
npm install -g @openai/codex- 等待安裝完成
▲ 用 npm 全域安裝 Codex CLI(務必打 @openai/codex)
⚠️ 務必打
@openai/codex——不要打成沒有 scope 的 npm i -g codex。無 scope 的 codex 是一個無關的舊套件,會裝錯東西。
替代方法(免先裝 Node):如果不想先裝 Node.js,可以改用官方一鍵 installer:
powershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex"
這種方式會自帶執行檔,裝完重新開啟終端機讓 PATH 生效。
Step 4:驗證安裝
在 PowerShell 輸入:
codex
看到歡迎畫面就代表安裝成功。第一次執行時選擇 Sign in with ChatGPT,會開瀏覽器用你的 ChatGPT 帳號完成登入。
▲ 安裝成功!終端機出現 Codex CLI 歡迎畫面
兩種使用方式
| 方式 | 指令 | 適合場景 |
|---|---|---|
| 互動模式 | codex | 進入對話,來回討論、逐步做事 |
| 一次性執行 | codex exec "…" | 一句提示直接跑完,適合單一任務 |
互動模式中按 / 會跳出斜線指令選單,常用的有 /init(產生 AGENTS.md 專案守則)、/model(切換模型)、/diff(看變更)、/review(請它審查)。
核可模式
第一次使用時,Codex 會依你設定的核可模式決定自己能做多少事、什麼時候先問你:
| 核可模式 | 說明 | 建議 |
|---|---|---|
| 要求核准 | 一律先詢問是否要編輯外部檔案及使用網際網路 | 最保守,新手可用 |
| 代我核准(預設) | 僅對偵測為可能不安全的操作要求核准 | ⭐ 日常主力,多數人用這個 |
| 完整存取權 | 可無限制存取網際網路和您電腦上的任何檔案 | ⚠️ 不建議,只適合拋棄式沙箱 / CI |
▲ Codex 問你「動作應如何核准」時的選單 — 預設是「代我核准」
使用中隨時輸入 /approvals 就能叫出這個選單切換核可模式。
最後更新:2026/07/11 | SANOC 聖威光電