Codex 深入浅出
版本说明:本专题中的 Codex 功能点根据 OpenAI 官方 Codex 文档与 Help Center,于
2026-03-22核对。后续如果官方能力更新,请以最新文档为准。
这套专题解决什么问题
这个站点里原本很多高级工作流示例都围绕 Claude Code 展开,但如果你准备把主工具切换到 Codex,往往会遇到 3 个现实问题:
- 不清楚
Codex CLI / IDE 扩展 / App / Web / GitHub这些入口分别适合什么场景 - 看到
Subagents / AGENTS.md / Skills / MCP / Automations等词,但不知道它们之间怎么配合 - 能看懂旧教程的思路,却缺少“如果换成 Codex,具体要怎么做”的步骤
这套专题就是为这 3 个问题准备的。
基础与方法
场景与进阶
官方能力快照
| 能力 | 官方现状 | 你在本教程里的使用方式 |
|---|---|---|
| 入口形态 | ChatGPT Help Center 当前列出了 macOS 应用、Windows 应用、Codex CLI、Codex IDE 扩展、网页版、GitHub | 先学 CLI 和 IDE,再根据任务切到 App / Web / GitHub |
| IDE 集成 | 官方 IDE 扩展支持 VS Code,并明确兼容 Cursor 与 Windsurf | 用来读取当前打开文件、选区和 @file 上下文 |
| 桌面 App | 官方 App 文档明确提供 多项目并行、Worktree、Automations、Git、Skills | 适合多任务并发、版本隔离和长期任务 |
| 多代理 | 官方已提供 Subagents,支持显式并行委派与自定义代理 | 适合代码审查、分工探索、并行修复 |
| 长期规则 | 官方支持 AGENTS.md 分层加载全局和项目级指令 | 用来固定规范、测试命令、风格约束 |
| 工具扩展 | 官方支持 Skills 与 MCP | 把经验和外部工具能力变成可复用资产 |
| 长任务 | 官方 App 文档提供 Automations | 适合日报、定时巡检、后台分析和批量处理 |
| 程序化控制 | 官方提供 Codex SDK 与 codex exec | 适合 CI/CD、内部平台、批处理与线程恢复 |
推荐阅读顺序
- 先看 Codex 快速上手核心指南,建立基本协作心智。
- 再看 Codex 工作流最佳实践,掌握稳定的任务推进方式。
- 然后看 Codex 快速上手与界面指南,把 CLI、IDE、App 的入口和截图记牢。
- 需要接工具时读 Codex MCP 与工具扩展 和 Codex Skills 实战。
- 最后再进入 Subagents、AGENTS.md、Skills 与 MCP 和 Codex SDK 实战指南。
对应到本站原教程
如果你正在按原来的学习路径推进,优先配合这些章节一起看:
这些章节我也同步补了 用 Codex 实现 的说明和入口。