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