#Codex 完整教程

欢迎来到 Codex 完整教程。本教程基于 OpenAI 官方文档与开源实现（openai/codex）整理，从「能跑起来」到「理解原理、能定制、能落地团队规范」，帮助你系统掌握 OpenAI 的 AI 编程 Agent。

---

#教程目录

#基础篇

1. Codex 简介

   • Codex 是什么：从代码模型到编程 Agent 的演进
   • 产品矩阵：CLI、App、IDE 扩展、Cloud
   • 与 Claude Code、Copilot 的定位差异

2. 安装与登录

   • 系统要求与安装方式
   • ChatGPT 账号 vs API Key
   • Windows / macOS / Linux 差异

3. 快速上手

   • 第一个交互式会话
   • 非交互 exec 与 CI 集成
   • 常用工作流模板

#原理篇

4. 架构与运行机制
   • Agent 循环：规划、工具调用、验证
   • 指令链（Instruction Chain）与上下文管理
   • Skills 的渐进式披露（Progressive Disclosure）
   • 沙箱与审批如何协同

#定制篇

5. AGENTS.md 项目指令

   • 全局 vs 仓库 vs 嵌套目录
   • 优先级、合并规则与字节上限
   • 团队规范落地与反馈闭环

6. Agent Skills

   • SKILL.md 格式与开放标准
   • 显式 / 隐式触发
   • Plugin 与 $skill-installer

7. MCP 集成

   • config.toml 中的 MCP 配置
   • 与 Skills 的组合模式
   • 常见服务器示例

8. Subagents 子代理

   • 并行与专责分工
   • 代码审查 Agent
   • 设计模式与边界

#安全与运维篇

9. 沙箱与安全

   • sandbox_mode 与 approval_policy
   • 权限预设与 /permissions
   • 企业场景与 requirements.toml

10. 配置与 CLI 参考

    • ~/.codex/config.toml 分层
    • 常用 CLI 标志与子命令
    • 日志、模型切换与脚本化

#实践篇

11. 实战案例

    • 重构遗留模块
    • 自动化 Code Review
    • 从 Issue 到 PR 的端到端流程

12. 资源与延伸阅读

    • 官方文档索引
    • AGENTS.md 开放标准
    • 社区插件与 Skills 仓库

---

#学习路径建议

---

#前置知识

• 熟悉终端与 Git 基本操作
• 了解至少一门编程语言
• 有 ChatGPT Plus/Pro 或 OpenAI API 额度（可选但推荐）