📚 Codex 官方教程中文版

功能手册式索引 ｜ 基于官方文档、源码和发布记录，按使用场景重写，方便随时查命令、配置、入口和能力边界

想先建立认知？去 🧠 理解版从原理到实战。 这里是查资料的地方 —— 知道想找什么，按目录直达。

---

🗺️ 全貌一图

flowchart TB
    Start[🌱 00 新手必读]

    subgraph L1["💼 你怎么用 Codex"]
        Entry[🚪 01 产品入口<br/>CLI / App / IDE / Cloud / Windows]
        Rules[🔐 02 规则安全与配置<br/>AGENTS.md / 配置 / 审批 / 沙箱]
    end

    subgraph L2["🔧 怎么扩展"]
        Ext[🧩 03 扩展能力<br/>MCP / Skills / Subagents / Hooks]
        Model[💰 04 模型价格与效率<br/>选模型 / 用量 / 速度]
    end

    subgraph L3["☁️ 怎么进生产"]
        Cloud[☁️ 05 云端与远程环境]
        Team[👥 06 团队企业与集成<br/>GitHub / Slack / Linear / CI]
    end

    subgraph L4["🚀 怎么落地"]
        Path[🎓 07 学习路线]
        Real[🎯 08 实战场景]
        Ver[🎬 09 版本视频与迁移]
    end

    Start --> L1 --> L2 --> L3 --> L4

    style Start fill:#dcfce7,stroke:#22c55e,stroke-width:2px
    style L4 fill:#fef3c7,stroke:#f59e0b

---

📂 10 大目录速查

按"什么时候用得上"组织：

目录	章节数	里面有什么	什么时候来这里
🌱 00 新手必读	5	定位 / 快速上手 / 登录认证 / 术语速查 / 安全清单	第一次接触 Codex
🚪 01 产品入口	25	CLI / 桌面 App / 网页版 / IDE 扩展 / Windows / Worktrees / 内置浏览器	选 / 用 / 配某个具体入口
🔐 02 规则安全与配置	15	AGENTS.md / config.toml / approval / sandbox / 受保护路径 / Rules	给 Codex 立规矩 / 控边界
🧩 03 扩展能力	10	MCP / Skills / Subagents / Hooks / Workflows / Plugins / 记忆	接外部工具 / 沉淀复用流程
💰 04 模型价格与效率	6	写好提示词 / 选模型 / 价格用量 / 速度 / 功能成熟度	调档省钱 / 提速 / 选模型
☁️ 05 云端与远程环境	3	Codex Cloud / 联网权限 / 远程开发环境	跑长任务 / 配云沙箱
👥 06 团队企业与集成	14	GitHub / Slack / Linear / CI/CD / SDK / 企业治理 / 托管配置	团队上 Codex / 接生产工具
🎓 07 学习路线	6	按 Web / 游戏 / 原生应用 / 生产系统选学习路径	不知道下一步学什么
🎯 08 实战场景	37	Bug 分诊 / PR 审查 / 数据查询 / 工具调用 / UI 构建 / 部署……	把真实需求改写成 Codex 任务
🎬 09 版本视频与迁移	3	官方演示视频 / 版本更新脉络 / 迁移说明	看历史变化 / 跟进版本

---

🚀 推荐路径：先认知后查询

flowchart LR
    A[🧠 先读理解版<br/>建立完整认知]
    B[🌱 00 新手必读<br/>掌握术语]
    C[🚪 01 产品入口<br/>选 1-2 个]
    D[🔐 02 规则与配置<br/>立边界]
    E[🎯 08 实战场景<br/>对号入座]

    A --> B --> C --> D --> E

    style A fill:#fef3c7,stroke:#f59e0b
    style E fill:#dcfce7,stroke:#22c55e

---

🔍 按需求快速定位

---

💡 阅读建议

1️⃣ 第一天只读理解版 01-06：建立概念、任务流程、安全边界、入口选择 —— 这些是地基。 2️⃣ 第一次让 Codex 改代码：从小任务开始，不要把重构、依赖升级、权限逻辑、生产配置放在同一任务里。 3️⃣ 每次任务都写清：目标、范围、禁止事项、验证命令、交付物 —— 缺哪项都靠运气。 4️⃣ MCP / Skills / Subagents / Hooks 不急着配：等你有稳定重复出现 5+ 次的场景再学。

---

🌐 官方原文入口

---