Codex 安裝與使用：新手快速上手
最後更新：2026-08-12· 15 分鐘閱讀
🚀 快速通道
- ChatGPT 國內版：點擊直達↗
- 穩定鏡像站：開啟鏡像↗
- 官方 ChatGPT：chatgpt.com ↗
更新時間：2026-08-12
導讀
本文假設你已完成 Codex 下載與基礎配置，目標是把 Agent 程式設計從「試玩」變成日常習慣。
Codex 是 OpenAI 的編碼 Agent，可在 CLI、IDE 擴充功能 或 Codex Web 中使用。下文以 CLI 為主，提示詞在 IDE 中同樣適用。命令與子命令以 Codex CLI 參考 與 ChatGPT 當前版本為準。
新手第一週：建議節奏
| 天數 | 任務類型 | 目標 |
|---|---|---|
| 第 1 天 | 唯讀 | 讓 Codex 解釋一個陌生模組，不寫檔案 |
| 第 2–3 天 | 單測修復 | 修一個 failing test，人工 review diff |
| 第 4–5 天 | 小範圍重構 | 限定目錄，保持行為不變 |
| 第 6–7 天 | 真實 bugfix | 記錄首次通過率與人工修改行數 |
不要一上來就「重寫認證模組」——30 分鐘內可驗證的小任務，才是建立信任的方式。
會話開頭：寫一份可執行的 brief
Agent 輸出品質取決於任務邊界是否清晰。每次會話盡量交代四件事：
| 要素 | 寫法要點 |
|---|---|
| 目標 | 一句話說明要達成什麼，附失敗堆疊或檔案路徑 |
| 環境 | 語言版本、套件管理器、測試框架 |
| 約束 | 禁止改動的目錄、禁止新增依賴 |
| 驗收 | 具體測試命令或 lint 規則 |
工作流一：修一個 failing test
測試 `tests/checkout.test.ts` 中 `coupon discount` 用例失敗。
請：1) 讀完整失敗堆疊與相關原始碼；2) 定位根因；3) 提出最小 patch；
4) 說明如何在本機用 `pnpm test checkout` 驗證。
不要修改與 coupon 無關的檔案；不要猜測未提供的環境變數值。操作節奏：
- 在專案根目錄啟動
codex。 - 保持預設審批策略，逐條確認檔案修改與測試命令。
- 模型給出 patch 後本機親自跑測試；失敗時把完整 stderr貼回，要求「只基於日誌修正」。
工作流二：小範圍重構
重構的前提是行為不變。先確認相關測試已綠，再動結構。
將 `src/orders/` 下所有日期格式化呼叫統一為 ISO8601 字串。
要求：
1) 僅修改 `src/orders/` 內檔案；
2) 保持對外匯出函式簽名不變；
3) 列出受影響測試並給出 `pnpm test orders` 命令；
4) 每次只提交一個邏輯改動，便於 review。| 階段 | 你要做的 |
|---|---|
| 改前 | 確認相關測試已綠 |
| 改中 | 限制目錄範圍，拒絕無關 diff |
| 改後 | 跑測試 + lint + typecheck；人工 diff review |
工作流三：讀懂陌生模組
我是新加入的開發者。請用約 400 字解釋 `packages/auth/` 的職責、
入口檔案、對外 API 與主要依賴；並指出我應該先讀的 3 個檔案。
不要修改任何檔案；不確定處標註「待核實」。輸出可當 onboarding 筆記，再針對單個檔案深入追問。配合 DeepSeek 程式設計實戰 中的「證據—假設—驗證」結構，讀程式碼效率會更高。
CLI、IDE 與雲端：形態怎麼選
| 形態 | 適合場景 | 注意 |
|---|---|---|
| CLI | 習慣終端、codex exec 腳本化 | CI 整合時限制權限 |
| IDE 擴充功能 | 邊寫邊改、需要視覺化 diff | 與 CLI 共用 config.toml |
| Codex Web | 無本機環境、輕量任務 | 倉庫存取與沙箱策略可能與本機不同 |
日常開發常見組合：IDE 內聯補全寫單函式，Codex 跑跨檔案任務與測試。與 Claude Code 類似，Codex 強項在「讀倉庫 + 執行命令」閉環。
非互動模式：codex exec
需要把 Codex 嵌入腳本或 CI 時，可使用非互動模式（詳見 非互動文件）。原則：
- CI 中使用唯讀或最小寫入沙箱。
- 禁止在無人工審查的流水線裡自動合入 main。
- API Key 與 ChatGPT 登入分開管理，金鑰走環境變數或密鑰服務。
提示詞習慣：讓 Agent 可審計
| 壞習慣 | 更好寫法 |
|---|---|
| 「修好 bug」 | 附失敗堆疊、重現步驟、預期/實際結果 |
| 「重構一下」 | 指定目錄、禁止項、驗收測試命令 |
| 「你看著辦」 | 列出必須滿足與必須避免的清單 |
要求模型在不確定時明確標註，並要求「先列計畫再執行」，可顯著減少 silent wrong fix。
與 Claude Code / Copilot 如何配合
- Copilot / Cursor 內聯補全：單檔案、單行級速度更快。
- Codex：跨檔案、跑測試、解釋架構更系統。
- Claude Code：Anthropic 生態下的同類 Agent，工作流可對照 Claude Code 指南。
不必只選一個——用內聯補全寫函式，用 Codex 跑整合測試與文件更新，是常見高效組合。
國內環境與模型後端
預設 Codex 走 OpenAI 模型與 ChatGPT 帳戶。若希望改用 DeepSeek 作為後端以降低成本或改善中文程式碼註解體驗，見 Codex 配置 DeepSeek 模型詳細教學。
網頁側可先體驗 DeepSeek V4 國內入口 或 AI Chat Studio 鏡像，但 Agent 工作流仍需在本機完成 API 與 config 配置。
常見問題
第一次任務應該從什麼規模開始？
優先選 30 分鐘內可驗證 的任務：單個 failing test、單檔案 bug、唯讀模組說明。
Codex 改了很多無關檔案怎麼辦？
立即 git checkout -- 回滾，收緊提示詞中的目錄約束，並檢查是否誤將 approval_policy 設為 never。必要時改用 sandbox_mode = "read-only" 先探索。
命令執行失敗如何排障？
把完整終端輸出（含退出碼）貼回；要求「不要猜測 PATH 或 env，只根據日誌推斷」。本機手動重現同一命令，確認是環境問題還是 patch 問題。
可以用 Codex 處理含金鑰的倉庫嗎？
僅在確認 .env 等敏感檔案不會被索引或上傳的前提下使用；公司倉庫先查內部 AI 政策。永遠不要把 API Key 寫進提示詞或提交到 Git。
和 ChatGPT 網頁寫程式碼有何本質區別？
網頁 ChatGPT 無法直接對你的倉庫執行測試與多檔案 patch；Codex 的設計目標就是 repo-grounded 的開發閉環。複雜架構問題仍建議人工 review 後再合併。
官方資源
下一步閱讀
行動路徑
今天：在練習倉庫完成「讀懂模組」唯讀任務。本週：用真實 bugfix 記錄「首次通過率」與人工修改行數。長期：把三條工作流提示詞寫入團隊 Wiki，並為 Codex 設定命令白名單與審批策略。