1 Codex 从零开始：它到底是什么，适合放在哪些工作里

查看大图

你好，我是郭震。

这套教程从零开始讲 Codex。先把一句话说清楚：Codex 不是简单的代码补全，也不是只会回答问题的聊天窗口。官方 manual 里把它定义为 OpenAI 的 coding agent，可以写代码、理解陌生代码库、审查代码、调试问题，也可以自动化重复的开发任务。

我更愿意把它理解成一个能进仓库干活的工程搭档。你给它目标、上下文、约束和验收标准，它会读文件、改文件、跑命令、看报错、继续迭代。你仍然是负责人，Codex 负责把找入口、读上下文、执行检查这些重复工作压缩掉。

我自己第一次把 Codex 放进项目时，不会让它直接重构全站，而是先让它只读目录、找页面入口，再改一处能肉眼确认的小问题。这个顺序慢一点，但很快能看出它有没有读懂项目。

查看大图

这张图可以当作第一天的验收单：只要任务没有清晰入口、没有检查命令、没有回退办法，就先不要扩大范围。Codex 做得越像工程搭档，越要用工程方式验收。

先分清几个入口

Codex 有多个使用入口，适合不同工作方式：

查看大图

开始使用前，可以先把任务拆成代码范围、修改意图、验证命令和禁止触碰的边界。这样和 Codex 协作时，输出会更像一次可复查的开发流程，而不是一段孤立的回答。

• CLI：适合在终端里处理本地仓库，读写文件、跑测试、做小步修改。
• IDE 扩展：适合边看代码边让 Codex 解释、补测试、改当前文件。
• Codex App：适合多线程、多项目、工作树、浏览器验证、图形化审查。
• Codex Web/Cloud：适合把任务放到云端并行跑，尤其是你想从另一台设备委托任务时。

新手不用一开始全学。我的建议是先学 CLI 或 Codex App，再逐步理解 IDE、Cloud、GitHub Action、MCP、Skills。

Codex 最适合的第一类任务

第一次用 Codex，不要让它“重构整个系统”。先做这几类小任务：

查看大图

读《Codex 从零开始：它到底是什么，适合放在哪些工作里》时，先确定要解决的场景，再把关键概念和练习动作串起来。这样读到细节时，不容易只记住零散名词。

1. 解释一个陌生仓库的目录结构。
2. 找一个页面、接口或函数的入口。
3. 修一个可复现的小 bug。
4. 给一个函数补测试。
5. 看一次 diff，列出潜在风险。

这些任务都有共同点：目标明确，范围有限，结果能验证。Codex 做得好不好，你很快能判断。

Codex 不适合一上来做什么

不要第一天就让它直接处理生产数据库、支付回调、服务器权限、密钥文件、跨仓库大迁移。不是说它永远不能碰，而是这些任务必须先有计划、权限边界和验证步骤。

官方 best practices 里有一个非常实用的提示：给 Codex 的任务最好包含目标、上下文、约束和完成标准。比如“帮我优化首页”太模糊，“只调整首页第一屏按钮文案，不改路由，构建通过才算完成”就清楚得多。

一套新手使用路线

这套教程会按 10 篇走完：

查看大图

练习《Codex 从零开始：它到底是什么，适合放在哪些工作里》时，建议把输入条件、处理动作和可见结果写在一起，方便下次复查。

查看大图

复习《Codex 从零开始：它到底是什么，适合放在哪些工作里》时，建议把关键概念、操作步骤和可见结果放在同一页里回看。

1. 认识 Codex 和各个入口。
2. 安装、登录、诊断环境。
3. 第一次读仓库、改文件、跑测试。
4. 写好 prompt、计划模式和 goal。
5. 用 AGENTS.md 和配置文件让规则持久化。
6. 审批、沙箱、安全边界。
7. 浏览器和 Computer Use 处理前端问题。
8. Skills、Plugins、MCP 连接外部工具。
9. Automations 和 Hooks 做稳定流程。
10. GitHub Action、代码审查和团队化。

学完之后，你应该能把 Codex 放进自己的真实项目里，而不是只停留在“它好像能写代码”的印象里。

参考资料：

• Codex overview
• Codex best practices
• Codex workflows