Codex 從原理到實戰
面向新手的 Codex 理解路線：先理解任務、上下文、邊界和驗證，再進入官方教程中的命令與配置。
這條線不背引數。它解決的是“為什麼 Codex 有時好用、有時不穩”：任務有沒有拆清、上下文有沒有給足、許可權有沒有收住、結果有沒有驗證。
官方教程中文版告訴你“功能怎麼用”。從原理到實戰解決另一個問題：新手應該按什麼順序建立判斷力。Codex 能讀檔案、改程式碼、跑命令、呼叫工具，也可能接入 Cloud、IDE、MCP 和團隊系統。能力越多，越需要先把目標、上下文、邊界和驗收講清。
flowchart LR
Goal[目標] --> Context[上下文]
Context --> Tools[工具]
Tools --> Boundary[邊界]
Boundary --> Verify[驗證]
Verify --> Review[審查]
Review --> Rules[沉澱規則]
Rules --> Goal這條線怎麼讀
完全新手先讀 01、02、03。你要先知道 Codex 不是聊天框，而是能在專案現場執行工程任務的 coding agent。
已經在用但經常不穩，先讀 02、04、05、11。多數問題不是模型不行，而是任務不清、規則沒沉澱、許可權邊界不明確、驗收標準缺失。
想做團隊落地，先讀 04、05、10。團隊場景最重要的是共識、邊界、審查和治理。
想做自動化和複用，先讀 07、08、09。不要一開始就堆 MCP、Subagents、Skills 和 Hooks，先判斷它們各自解決什麼問題。
章節路線
01 Codex 是什麼
分清 coding agent、聊天助手、本地工具和雲端任務的邊界。
02 一次任務怎麼完成
從需求、計劃、讀程式碼、改動、驗證到交付，理解完整鏈路。
03 上下文工程
理解 Codex 能看到什麼、應該先看什麼、哪些資訊不能靠猜。
04 AGENTS.md 指南
把專案約定、執行方式和禁止事項沉澱成 Codex 的長期介面。
05 沙箱和審批
理解 read-only、workspace-write、approval 和 network access 的風險邊界。
06 入口選擇
比較 CLI、App、IDE 和 Cloud，按任務選擇最合適的工作面。
07 MCP 和工具
判斷什麼時候需要外部上下文、工具伺服器和資料系統。
08 Skills / Subagents / Hooks
區分流程複用、隔離執行和確定性自動檢查。
09 模型、成本和速度
建立選擇模型和控制用量的原則，具體價格回官方頁核驗。
10 團隊與生產
把個人體驗升級成可審查、可回復、可治理的團隊流程。
11 從理論到實戰
把一句模糊需求拆成目標、範圍、邊界、驗證和交付物。
12 全貌覆盤
用一張總圖檢查自己是否真的理解 Codex 的工作方式。
第一條推薦提示詞
第一次在專案裡使用 Codex，不要讓它一上來改程式碼。先發一個只讀任務，讓它理解專案用途、技術堆疊、執行方式、主要目錄、潛在風險和下一步適合做的小任務。
请先阅读当前项目，不要修改文件。
帮我理解项目用途、技术栈、运行方式、主要目录和潜在风险。
如果需要运行命令，先说明原因和影响。
最后给出三个适合下一步做的小任务。這個提示詞的重點不是措辭，而是把 Codex 從“馬上動手”拉回“先理解現場”。
和官方教程中文版怎麼配合
- 遇到“為什麼、怎麼判斷、怎麼取捨”，看從原理到實戰。
- 遇到“具體命令、配置欄位、入口步驟、官方限制”，看官方教程中文版。
- 遇到價格、模型、版本、平臺支援差異，直接回官方文件核驗。
怎麼驗收自己讀懂了
- 能用一句話說明 Codex 是什麼。
- 能把一個模糊需求改寫成目標、範圍、邊界、驗證和交付物。
- 能解釋為什麼
AGENTS.md能改善長期效果。 - 能判斷該用 read-only、workspace-write，還是需要審批。
- 能說清什麼時候該用 MCP、Skills、Subagents、Hooks。
- 能在任務結束時要求 diff、測試結果、未驗證項和剩餘風險。
官方資料
- Codex quickstart：https://developers.openai.com/codex/quickstart
- AGENTS.md：https://developers.openai.com/codex/guides/agents-md
- Agent approvals & security：https://developers.openai.com/codex/agent-approvals-security
- Codex CLI features：https://developers.openai.com/codex/cli/features