2026 年最新 Codex 安裝教學與使用指南：GPT-5.5-Codex 完整指南

2026 年，OpenAI 把 Codex 從「歷史上的程式碼補全模型」重新定義為完整的程式設計 Agent 平台：Codex CLI 跑在你本機終端機，能讀儲存庫、改檔案、跑命令；GPT-5.5-Codex 是面向軟體工程的專項模型變體。本文是繁體中文站的安裝 + 使用權威落地頁——涵蓋三種安裝方式、ChatGPT 登入、config.toml、核准沙箱、/model 切換與第一條可驗收任務。若你還在糾結和 Claude Code / Cursor 的關係，下文有結構化對照與選型矩陣。

1. 為什麼 2026 年還要單獨裝 Codex CLI？

ChatGPT 網頁能寫程式，但工程團隊的真實矛盾是：對話視窗裡的建議無法直接變成可審計的 git diff；無法穩定跑測試迴圈；無法接入 CI。Codex CLI 解決的是執行邊界——把 GPT-5.5 系列放進你選定的目錄，在沙箱與核准策略下改檔案、跑 shell。

與 2021 年「Codex 補全 API」不同，2026 年的 Codex 是Rust 撰寫的開源終端機 Agent（儲存庫 openai/codex），與 ChatGPT 訂閱打通，並擴展到 IDE 擴充功能、桌面 App 與 Codex Cloud 非同步任務。真正分水嶺不是「OpenAI vs Anthropic 誰更強」，而是你願不願意把任務委託給終端機 Agent。

2. Codex 四種入口怎麼分類？

安裝教學聚焦 Codex CLI，但完整平台有四個面，設定共用 ~/.codex/ 目錄：

本文主路徑是 CLI 先行：裝通 CLI 後，IDE 擴充功能與 App 通常只需同一帳號登入即可複用設定。

3. 核心對照：Codex vs Claude Code vs Cursor

先講白話版價格：三家入門都是大約 $20/月（約 NT$650），但買的不是同一種東西——

• Codex、Claude Code：像手機流量包，每過幾小時重置額度；讓 AI 一口氣改很多檔案，額度用得特別快。
• Cursor：像健身房月卡，每月固定 $20，天天打開 IDE 寫程式最划算，帳單最好估。

下表綠色高亮欄是「怎麼扣費、月底帳單會不會嚇一跳」——這才是選工具時最該看的。能力差異看左邊幾欄，價格差異重點看綠色欄。

更細的 IDE 對照見 Claude Code vs Cursor 2026；Anthropic 與 OpenAI Agent 路線之爭見 Claude Code 時代敘事。

4. 場景怎麼選？

5. 推薦組合（2026 工程技術棧）

• 個人開發者— Codex CLI（GPT-5.5-Codex）+ 現有 IDE 寫小改；大任務週末開 codex 委託。
• 全端 + iOS— 業務程式碼用 Codex/Cursor 本地寫；Xcode 建置與簽章放 Cloud Mac 或 GitHub Runner 執行節點。
• 團隊 CI— codex exec 或 Codex Cloud 出 patch → Actions 裡編譯測試 → 人工審 PR。Runner 用一 Job 一 Workspace 隔離。
• 知識密集型儲存庫— Codex MCP 接 Issue 追蹤 + 可選 CodeGraph；規則寫在專案 .codex/config.toml 與 AGENTS.md。

6. 安裝前準備

• 帳號— ChatGPT Plus / Pro / Business / Edu / Enterprise（含 Codex），或可用的 OpenAI API Key。
• 系統— macOS、Linux 為一等公民；Windows 可用 PowerShell 原生或 WSL2。
• Git 儲存庫— 建議在真實專案根目錄驗收，而非空資料夾。
• Node.js 18+— 僅在使用 npm install -g @openai/codex 時需要。

uname -a
git --version
node -v   # 走 npm 時檢查
which codex # 應無輸出（尚未安裝）

7. 三種安裝方式（2026 官方路徑）

# 非互動場景（CI 映像）可先設
export CODEX_NON_INTERACTIVE=1

curl -fsSL https://chatgpt.com/codex/install.sh | sh
codex --version

npm install -g @openai/codex@latest
codex --version
# 若 EACCES：npm config set prefix ~/.npm-global，並把 ~/.npm-global/bin 加入 PATH

8. 登入與驗證

首次執行 codex 會進入互動 TUI，選擇：

• Sign in with ChatGPT（推薦）— 瀏覽器 OAuth，訂閱額度計入 ChatGPT 方案。
• API Key— 適合自動化與按 token 精算；勿把 Key 提交進 git。

設定與憑證落在 ~/.codex/。團隊共用機器上注意檔案權限，CI 裡用密鑰管理注入 API Key，而不是寫進儲存庫。

9. GPT-5.5-Codex：模型切換與 config.toml

GPT-5.5 是通用旗艦；GPT-5.5-Codex 面向程式碼任務最佳化（讀儲存庫、套用 patch、工具鏈推理）。日常軟體工程建議預設 Codex 變體，通用問答可切回 gpt-5.5。

工作階段內切換：在 TUI 輸入 /model，選擇 gpt-5.5-codex 並調整 reasoning 檔位。

持久預設：編輯使用者級設定 ~/.codex/config.toml（專案級可放 .codex/config.toml，需信任該專案）：

# 預設程式設計模型
model = "gpt-5.5-codex"

# 核准：on-request = Agent 需要越權時詢問（推薦）
approval_policy = "on-request"

# 沙箱：read-only 起步，確認流程後再開 workspace-write
sandbox_mode = "read-only"

# 推理力度（依任務調整）
model_reasoning_effort = "medium"

設定優先順序（後者覆蓋前者）：內建預設 → ~/.codex/config.toml → 專案 .codex/config.toml → Profile（codex --profile ci）→ CLI 參數。詳見 官方 Config basics。

10. 日常使用：TUI、核准、MCP 與指令碼化

互動模式

cd your-repo
codex
# 或單行任務
codex "執行 npm test 並修復失敗案例，不要改 package-lock"

核准模式（安全紅線）

涉及 rm、改正式環境設定、存取密鑰檔案時務必人工點核准。企業環境可能透過 requirements.toml 禁止 never 或 danger-full-access 沙箱。

MCP 擴充

Codex 支援 Model Context Protocol，在 config.toml 宣告 MCP Server 後可讀 GitHub、資料庫等外部上下文。與 Claude Code 的 MCP 設定思路類似，宿主不同——可參考我們的 MCP 安裝教學 理解 PAT 最小權限原則。

指令碼化 exec 與 Cloud

• codex exec "..." — 無頭執行，適合 cron / CI 預檢。
• Subagents — 大任務拆平行子 Agent（TUI 內開啟）。
• 本地 Code Review — 提交前讓獨立 Agent 審 diff。
• Codex Cloud — 終端機內發起雲端任務，拉回 patch 再本地套用。

11. 常見迷思

1. 把 Codex 當 ChatGPT 網頁 — 不裝 CLI、不審 diff，就無法形成工程閉環。
2. 一上來 sandbox_mode = danger-full-access — 省點擊，但誤刪檔案無法挽回；先 read-only 再放寬。
3. 在子目錄啟動 codex — Agent 只能看到 cwd 上下文；Monorepo 請在正確套件根目錄啟動。
4. 忽視 Windows 路徑差異 — 原生 PowerShell 與 WSL 的儲存庫路徑不是同一份；選一條路徑堅持。
5. 只比模型不比入口 — GPT-5.5-Codex 很強，但若你更需要 Tab 補全，應主用 Cursor + Codex 擴充功能，而非硬扛純 TUI。

12. 7 步落地清單

1. 安裝 CLI — 執行官方 install.sh 或 npm i -g @openai/codex，codex --version 通過。
2. 登入 — ChatGPT OAuth 或 API Key，確認 ~/.codex/ 已產生。
3. 寫 config.toml — model = "gpt-5.5-codex"，approval_policy = "on-request"，sandbox_mode = "read-only"。
4. 選儲存庫 — cd 到熟悉的中型專案，確保 git status 乾淨或已在功能分支。
5. 跑冒煙任務 — codex "解釋 src 目錄結構並畫樹狀圖"，檢查是否讀對檔案。
6. 跑閉環任務 — codex "執行測試命令 [你的 test cmd]，修復失敗案例"，觀察是否真跑 shell。
7. 接入團隊技術棧 — 需要 24/7 建置時，把 Runner 放 Cloud Mac；需要圖譜時接 MCP。

13. FAQ

Codex、Claude Code、Cursor 哪個最便宜？

表面都是 $20/月 起步，沒有絕對的「最便宜」。已經在用 ChatGPT 的人，Codex 等於白送；已經在用 Claude Pro 的人，Claude Code 同理。從零開始、只想每月固定一筆錢，Cursor 最好估。AI 幫你一口氣改很多檔案的重度用法，兩邊都可能要升到 $100–$200，詳見上文對照表。

Codex 需要單獨付費嗎？

一般不用。買了 ChatGPT Plus（$20/月）就包含 Codex。也可以用自己的 API Key 按用量付錢，但那樣沒有雲端審程式碼等會員功能。具體額度見 OpenAI 說明。

GPT-5.5 和 GPT-5.5-Codex 有什麼差別？

GPT-5.5 通用；GPT-5.5-Codex 為軟體工程微調，更適合讀程式碼、寫 patch、跟工具鏈。寫碼預設選 Codex 變體。

Codex 和 Claude Code 能同時裝嗎？

可以。兩者設定目錄不同（~/.codex/ vs ~/.claude.json），同一儲存庫可分場景使用；注意統一編碼規範，避免兩個 Agent 來回改格式。

安裝後 command not found？

指令碼安裝後重啟 shell，或把安裝路徑加入 PATH。Homebrew 使用者檢查 /opt/homebrew/bin；npm 使用者檢查 ~/.npm-global/bin。

如何升級 Codex？

npm install -g @openai/codex@latest 或重新執行官方 install 指令碼；Homebrew 用 brew upgrade codex。

14. 總結

2026 年的 Codex 安裝教學，本質是把 OpenAI 程式設計 Agent 接到你的檔案系統與終端機。 三條命令裝好 CLI，登入 ChatGPT，在 config.toml 裡預設 gpt-5.5-codex，用 on-request 核准守住安全線——你就有了可重現、可指令碼化、可上 Cloud 的編碼工作流。它與 Claude Code 爭的是「終端機 Agent 入口」，與 Cursor 爭的是「誰主駕寫碼」；多數團隊最終會雙持或三持，而不是押注單一品牌。

對需要真 macOS 建置的讀者：Agent 寫得再快，Xcode 與 Runner 仍要落在 Apple 硬體上。Cloud Mac 可與 Codex 本地改程式碼、遠端編譯的組合搭配，把「寫」與「驗」拆開，縮短上架路徑。