实战教程
Codex 基础版教程：四种形态与 30 分钟快速入门
面向新手的 Codex 基础教程，先讲清 Codex 是什么、四种使用形态的差异，再带你用 App、CLI、IDE、Cloud 跑通第一条可执行工作流。
这篇给第一次系统使用 Codex 的开发者准备，目标只有一个：
用最短路径跑通一条可执行工作流，而不是只会提问。
建议阅读顺序：
- 先看这篇基础版（30 分钟）
- 再看进阶版（60 分钟）
- 最后进入 CLI 实战与自动化
1. Codex 到底是什么？
一句话版本：
Codex 不是“代码补全工具”，而是能在真实项目上下文里做推理、执行和验证的开发代理。
你会明显感觉到它和普通工具的区别：
- 复杂任务前会先思考，不会马上吐一段拼凑代码
- 能围绕仓库结构给出整体方案
- 更容易一次输出可落地结果，而不是连续打补丁
2. 四种形态怎么选？
| 形态 | 适合谁 | 一句话建议 |
|---|---|---|
| Codex App | 需要并行处理多个任务的人 | 默认选它，尤其是 Worktree 模式 |
| CLI | 终端重度用户、要做自动化的人 | 最灵活，最适合脚本化和 CI |
| IDE 扩展 | 长时间在编辑器里写代码的人 | 不切窗口，交互成本最低 |
| Cloud | 任务长、机器资源紧张的人 | 放后台跑，完成后再审 diff |
新手默认路径：
- macOS 用户优先 App
- 非 macOS 或偏脚本化优先 CLI
- 长任务交给 Cloud
3. 先跑通第一条工作流（建议照抄）
第一步：定义边界
请先输出分步计划，不要直接改代码。
每一步必须包含：目标、影响文件、风险、验证、回滚。
第二步：让 Codex理解仓库
请总结这个仓库的模块结构，并标记本次改动不应该触碰的目录。
第三步：执行最小改动
请先给最小可行改动，不要一次性大改。
改完后给我验证命令和回滚命令。
第四步：验证
至少执行：
- 功能验证
- 回归验证
- 测试/静态检查
4. Worktree 为什么值得默认开启？
你可以理解为“每个任务都有独立沙盒分支”：
- 不会污染当前主线开发
- 支持并行做多个任务
- 失败后清理成本低
如果你在 Codex App 里工作，建议新线程优先选 Worktree 模式。
5. 新手最容易踩的 5 个坑
- 提示词只写“帮我改一下”，没有边界
- 一次要求太多目标，结果失焦
- 不限制改动目录，导致误改
- 跳过验证，直接提交
- 把 Codex 当最终审核人，而不是执行助手
6. 下一步怎么进阶？
看完这篇后，按这个顺序继续：