這是在 X 看到的文章 Getting started with Codex: Best practices for better results，翻譯後分享給大家。
--
如果你是第一次使用 OpenAI Codex 或一般的程式代理（coding agents），這份指南可以幫助你更快取得更好的成果。
內容涵蓋讓 Codex 在 CLI、IDE 擴充套件與 Codex App 中更有效率的核心習慣，從 提示（prompting）、規劃（planning）、驗證（validation）、MCP、技能（skills）到自動化（automations）。
Codex 的最佳使用方式，是 不要把它當成一次性的助手，而是把它當成一位可以長期配置與優化的團隊夥伴。
一個實用的思考模型是：
-
先提供正確的任務上下文
-
使用 AGENTS.md 提供長期可持續的指引
-
讓 Codex 配置成符合你的工作流程
-
用 MCP 連接外部系統
-
將重複工作變成 Skills
-
將穩定流程變成 Automations
1. 用清楚的上下文與提示，建立良好的第一次使用體驗
即使你的提示（prompt）不完美，Codex 也足夠強大，仍然可以產生有用的結果。
很多時候你只需要最少的設定，就可以把困難問題交給它並得到不錯的答案。
不過 清楚的提示能讓結果更可靠，尤其是在：
-
大型程式碼庫
-
重要或高風險任務
如果你在大型或複雜的專案中工作，最大的提升通常來自：
提供正確的任務上下文與明確的任務結構。
建議在提示中包含四個部分：
Goal（目標）
你想要修改或建立什麼？
Context（上下文）
哪些檔案、資料夾、文件、範例或錯誤訊息與任務相關？
你可以使用 @提及檔案 來提供上下文。
Constraints（限制條件）
需要遵循哪些標準、架構、安全規則或開發慣例？
Done when（完成條件）
任務完成時應該滿足哪些條件，例如：
-
測試通過
-
行為改變
-
bug 修復
這樣可以幫助 Codex：
-
限制工作範圍
-
減少錯誤假設
-
產出更容易檢查與驗證的結果
推理等級設定
可依任務難度調整推理程度：
-
Low：快速、範圍明確的任務
-
Medium / High：較複雜的修改或除錯
-
Extra High：長時間推理、代理型任務
新手建議：
先從小成功開始，例如：
-
問 Codex 有關程式碼庫的問題
-
讓它修一個小 bug
另外，Codex App 的語音輸入功能可以大幅提升操作速度。
2. 在困難任務中先讓 Codex 規劃，降低錯誤
如果任務：
-
很複雜
-
描述模糊
-
難以清楚說明
建議 先讓 Codex 規劃（plan），再開始寫程式。
常見方法：
Plan Mode
對多數使用者來說最簡單有效。
Plan Mode 會讓 Codex：
-
收集上下文
-
提出澄清問題
-
建立更完整的實作計畫
開啟方式：
/plan
或
Shift + Tab
讓 Codex 先「訪問」你
如果你只有模糊想法，可以請 Codex：
-
先向你提問
-
挑戰你的假設
-
把模糊想法變成具體需求
再開始寫程式。
使用 PLANS.md 模板
在較進階流程中，可以使用：
PLANS.md
來定義長任務或多步驟執行計畫。
3. 使用 AGENTS.md 讓成功的指引可以重複使用
當某種提示方式有效後，下一步就是：
不要再每次手動重複提示。
這時就要使用：
AGENTS.md
你可以把它想像成：
AI 代理的 README
它是一種簡單的開放格式，會自動加入到上下文中，最適合用來定義：
Codex 在這個專案中的工作方式
一個好的 AGENTS.md 通常包含：
-
專案目錄結構
-
如何執行專案
-
build / test / lint 指令
-
工程開發規範
-
PR 規則
-
禁止事項
-
完成標準與驗證方式
CLI 中可以用：
/init
快速建立 AGENTS.md。
但建議依照團隊實際流程修改。
AGENTS.md 層級
你可以建立多層：
全域設定
~/.codex/AGENTS.md
專案層級
repo/AGENTS.md
子資料夾層級
repo/subdir/AGENTS.md
越接近目前工作目錄的檔案優先權越高。
實務建議
AGENTS.md 應該：
-
簡短
-
準確
-
可操作
而不是長篇抽象規則。
如果 Codex 重複犯同樣錯誤：
-
請它做一次回顧（retrospective）
-
更新 AGENTS.md
4. 配置 Codex 讓它符合你的工作流程
配置（configuration）可以讓 Codex：
-
跨 session
-
跨工具
-
行為更一致
可以設定：
-
模型
-
推理等級
-
sandbox
-
approval policy
-
profiles
-
MCP
建議配置方式：
個人設定
~/.codex/config.toml
專案設定
repo/.codex/config.toml
CLI 覆蓋
只用於一次性設定。
config.toml 可定義：
-
MCP servers
-
profiles
-
multi-agent
-
實驗功能
Sandbox 與權限
Codex 有兩個重要控制：
Approval mode
何時需要你批准指令。
Sandbox mode
Codex 可以讀寫哪些檔案。
新手建議：
先使用保守權限
只在可信任專案中放寬。
5. 讓 Codex 自動測試、驗證與審查
不要只讓 Codex 修改程式碼。
同時要求它：
-
建立測試
-
執行測試
-
驗證結果
-
檢查程式碼
例如：
-
撰寫或更新測試
-
執行測試套件
-
lint / formatting / type check
-
確認行為符合需求
-
檢查 diff
Codex App 中可開啟：
diff panel
逐行檢視修改。
/review 指令
/review
可進行：
-
PR review
-
未提交變更 review
-
commit review
-
自訂 review
如果有：
code_review.md
也可以讓 Codex 遵循。
6. 用 MCP 連接外部工具與即時資料
如果 Codex 所需資訊不在 repo 中，可以使用：
MCP（Model Context Protocol）
它是一個開放標準，讓 Codex 連接：
-
外部工具
-
API
-
系統
適合情境：
-
資料不在 repo
-
資料經常變動
-
想讓 Codex 使用工具
-
需要跨專案整合
Codex 支援：
-
STDIO
-
Streamable HTTP
-
OAuth
7. 將重複流程變成 Skills
當某個流程開始重複時：
不要再寫長 prompt。
建立：
SKILL.md
Skills 可以包含：
-
指令
-
上下文
-
腳本
-
邏輯
適合任務：
-
log triage
-
release notes
-
PR review
-
migration planning
-
incident summary
-
debugging
8. 用 Automations 自動執行任務
當流程穩定後，可以建立：
Automation
讓 Codex 在背景定期執行。
可設定：
-
project
-
prompt
-
schedule
-
execution environment
例如：
-
commit summary
-
bug scan
-
release notes
-
CI failures
-
standup summary
9. 用 session 控制管理長任務
Codex session 不只是聊天紀錄。
它是：
累積上下文與決策的工作線程。
CLI 常用指令：
/resume
/fork
/compact
/agent
/theme
/apps
/status
建議：
一個 thread 對應一個問題。
10. 常見錯誤
新手常見問題：
-
把規則寫在 prompt 而不是 AGENTS.md
-
沒告訴 agent 如何 build/test
-
跳過 planning
-
一開始就給完整權限
-
多個 thread 修改同一檔案
-
尚未穩定就自動化
入門檢查清單
開始使用 Codex 時：
-
提供 Goal / Context / Constraints / Done when
-
困難任務先 planning
-
建立 AGENTS.md
-
設定 build / test / review
-
設定 config
-
連接 MCP
-
建立 Skills
-
使用 Automations
當你把 工作流程、標準與上下文都轉換成 Codex 可以理解的形式後，你就會真正看到 AI coding agent 的威力。
現在就開始吧。
