Codex CLI 入门学习指南

适用对象：已经会使用命令行和 Git，想把 Codex CLI 用到真实项目开发、文档维护、代码审查、测试和自动化工作中的开发者。校准日期：2026-06-10。本文档已结合 OpenAI Codex 官方手册和当前仓库结构整理。模型、价格、权限、配置字段、产品形态会变化，涉及这些内容时应定期回看官方文档。

学习路径

建议按下面顺序阅读：

1. 基础功能与安全边界
2. 日常开发工作流与最佳实践
3. 进阶能力：连续编程、Subagents、MCP、Skills、自动化
4. 本项目落地规划与防踩坑指南

这份指南解决什么问题

很多 Codex CLI 教程只停留在“能问问题、能改代码、能运行命令”。真实项目里更关键的是：

• 如何让 Codex 先理解项目，再动手。
• 如何把一次任务拆成可验证的小步骤。
• 如何用 /plan、/review、/diff、/compact、resume 做连续编程。
• 什么时候应该用 subagents，什么时候不应该用。
• 如何把稳定规则沉淀到 AGENTS.md、Skills、MCP 和配置里。
• 当前这个仓库应该怎样规划，避免变成散乱笔记。

当前仓库定位

当前目录结构是：

ai/
  claude-code/
  codex-cli/
  codex-desktop/
  opencode/

这更适合建设成“AI 编程工具学习与实践手册”，而不是只写某一个工具的零散笔记。codex-cli 目录先作为样板：先写清楚基础、工作流、进阶能力和项目落地，再把同样结构推广到 claude-code、codex-desktop、opencode。

推荐下一步

1. 先阅读 1-basic.md，理解 Codex CLI 的权限、安全和基础命令。
2. 再阅读 2-workflow.md，学习如何把 Codex 用到真实开发闭环。
3. 然后阅读 3-advanced.md，掌握连续编程、subagents、MCP 和自动化。
4. 最后阅读 4-project-practice.md，按里面的规划补齐本仓库的根目录说明、AGENTS.md 和案例库。