Codex 下載、安裝、配置基礎教學

最後更新：2026-08-12· 14 分鐘閱讀

🚀 快速通道

ChatGPT 國內版：點擊直達↗
穩定鏡像站：開啟鏡像↗
官方 ChatGPT：chatgpt.com ↗

Codex 下載、安裝、配置基礎教學

更新時間：2026-08-12

導讀

Codex 是 OpenAI 面向開發者的編碼 Agent：在終端 CLI、IDE 外掛或桌面應用中讀取倉庫、編輯檔案、執行命令並解釋結果。它與 ChatGPT 網頁聊天的定位不同——前者是「結對程式設計師」，後者更適合單次問答與文件草稿。

OpenAI 同時提供 Codex CLI、Codex Web 與 VS Code / Cursor 等 IDE 擴充功能。本文以 CLI 為主線；IDE 側共用同一套配置層級。若你已在用 Anthropic 生態，可先對照 Claude Code 程式助手指南理解 Agent 程式設計共性，再按本文完成 Codex 安裝。

Codex 解決什麼問題？

網頁 ChatGPT	Codex CLI / IDE
貼上程式碼片段問答	直接索引專案目錄與 Git 狀態
人工複製 diff 到編輯器	授權範圍內改檔案、跑測試
適合解釋概念、寫草稿	多步修 bug、重構、腳手架

適合： 有 Git 工作流、能在本機執行測試的開發者。
不適合： 無版本控制、無法跑命令的純文件環境。

安裝前：環境與帳戶

項目	最低建議	說明
系統	macOS 13+、Ubuntu 22.04+、Windows 11	Windows 上 WSL2 沙箱支援更完整
Git	2.30+	在已 `git init` 的專案根目錄啟動體驗最佳
帳戶	ChatGPT Plus/Pro/Team 或 OpenAI API Key	方案是否含 Codex 以 Platform 帳戶頁為準
Node.js	18+（僅 npm 路徑需要）	官方腳本 / Homebrew 可不依賴 Node
資源	~200 MB 磁碟；建議 8 GB 可用記憶體	大倉庫索引會占用更多

安全提醒： 不要在不可信第三方站下載所謂「Codex 破解版」。CLI 具備讀改檔案與執行 shell 的能力，來源不明的二進位風險極高。

下載與安裝（三條路徑）

命令會隨版本更新，執行前請對照 Codex CLI 官方文件。

路徑 A：官方腳本（macOS / Linux，推薦）

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

路徑 B：Windows PowerShell

powershell -ExecutionPolicy ByPass -c "irm https://chatgpt.com/codex/install.ps1 | iex"

路徑 C：npm 或 Homebrew

npm install -g @openai/codex          # 需 Node.js 18+
brew install --cask codex               # 僅 macOS

安裝完成後執行 codex --version 確認可用。若提示命令不存在，檢查 PATH 並重啟終端；也可從 Codex GitHub Releases 下載二進位檔。

首次登入與授權

cd 到專案根目錄（建議已是 Git 倉庫）。
執行 codex 進入互動介面。
選擇授權方式：
- Sign in with ChatGPT：綁定訂閱，額度隨方案變化。
- API Key：走 OpenAI Platform 按量計費，適合 CI 或自動化。
確認沙箱模式與命令審批策略——預設應在改動檔案或執行 shell 前詢問你。

國內使用者若登入頁或下載受限，可先閱讀 ChatGPT 國內存取完整指南；授權與帳單仍以 OpenAI 官方帳戶為準。

config.toml：從預設到可控

Codex 配置按優先順序生效：CLI 參數 > 專案配置 > Profile > 使用者配置 > 內建預設值。

層級	路徑	典型用途
使用者級	`~/.codex/config.toml`（Windows：`%USERPROFILE%\.codex\config.toml`）	預設模型、全域沙箱、自訂 provider
專案級	`.codex/config.toml`	團隊共享的非敏感預設值（僅已信任專案載入）
Profile	`~/.codex/.config.toml` 或 config 內 `[profiles.]`	多模型 / 多後端切換

完整鍵名見 Codex 配置文件。

新手推薦的最小配置

model = "gpt-5.4"                      # 模型 ID 以官方文件為準
approval_policy = "on-request"         # 改檔案 / 跑命令前詢問
sandbox_mode = "workspace-write"       # 僅允許在工作區內寫入

常用鍵速查

鍵	典型值	作用
`model`	官方模型 ID	預設推理模型
`approval_policy`	`on-request` / `never`	工具呼叫是否需人工確認
`sandbox_mode`	`read-only` / `workspace-write`	檔案系統寫入範圍
`model_reasoning_effort`	`low` / `high`	推理深度（若模型支援）

安全建議： 新手保持 on-request + workspace-write；僅在隔離練習倉庫中嘗試更寬鬆策略。若希望改用 DeepSeek 作為後端，見 Codex 配置 DeepSeek 模型詳細教學。

IDE 擴充功能與桌面端

除 CLI 外，Codex 還可透過 VS Code、Cursor、Windsurf 等 IDE 擴充功能使用，或透過 codex app 啟動桌面應用。擴充功能與 CLI 共享同一套 config.toml 層級。

團隊若需統一規範，可把 .codex/config.toml 中非敏感預設值提交到倉庫；金鑰只放環境變數，絕不進 Git。

安裝後五步驗收

codex --version 有版本號輸出。
在小型練習倉庫根目錄執行 codex，能完成登入。
發起唯讀任務（例如「列出 src/ 下主要模組職責」），確認能索引檔案。
發起一次需寫檔案的小改動，確認審批彈窗與沙箱行為符合預期。
若走 API Key，在 Platform 確認專案餘額、模型權限與限流正常。

權限與安全（必讀）

Codex 能讀檔案、改檔案、跑 shell——權限過大等於把筆電交給第三方。

倉庫：只在可信專案啟用；貢獻開源專案前先 fork 到隔離目錄。
金鑰：確保 .env、credentials.json 在 .gitignore；啟用前確認工具是否會讀取 ignored 檔案。
命令：對 rm -rf、套件安裝、外網請求保持確認；公司環境遵循內部 AI 使用政策。
輸出：生成程式碼仍需 code review + CI，禁止未經審查直接合入 main。

常見問題

安裝腳本下載失敗怎麼辦？

先檢查網路與代理，再嘗試 npm 或 Homebrew 路徑；也可到 Codex GitHub Releases 下載二進位檔。Windows 使用者優先在 WSL2 內安裝 Linux 版以獲得完整沙箱。

ChatGPT 訂閱和 API Key 有什麼區別？

ChatGPT 登入通常綁定方案內 Codex 額度；API Key 走 Platform 獨立計費。兩者授權入口不同，不要混用金鑰。

`codex` 命令找不到？

重啟終端；檢查安裝程式輸出的 PATH 提示；npm 全域安裝時確認 npm prefix -g 目錄在 PATH 中。

專案級 config.toml 不生效？

.codex/config.toml 僅在被標記為信任的專案中載入；部分鍵（如 model_provider）只能寫在使用者級 ~/.codex/config.toml。

Windows 原生與 WSL2 該選哪個？

日常開發若在 WSL2 內進行，在 WSL 內安裝 Codex 體驗更一致；純 PowerShell 環境可用 Windows 安裝包，但沙箱與路徑行為可能與 Linux 文件描述略有差異。

裝好後第一條任務該做什麼？

建議先做唯讀問答（讀懂一個模組），再做單測修復——詳見 Codex 新手快速上手。

官方資源

下一步閱讀

行動路徑

今天：在練習倉庫完成安裝、登入與一次唯讀問答。本週：用真實 failing test 跑通「讀日誌 → 最小 patch → 本機驗證」閉環。長期：把團隊預設的 approval_policy、沙箱策略與 .gitignore 檢查寫進 CONTRIBUTING.md。

導讀