【2026最新】Codex 学习手册

从入门到高级工程化实践：AI Agent 新手的系统学习路线​

生成日期：2026-08-10​

阅读说明​

本书面向刚开始系统学习 Codex 和 AI Agent 的读者。全书采用案例驱动方式，每章都包含学习目标、操作案例、练习、检查清单和常见坑。​

​

关于 Codex：Codex 是 OpenAI 于 2025 年推出的 AI 编程智能体，到 2026 年已成为开发者圈子里最热门的生产力工具之一。它和日常使用的聊天机器人有着本质区别——不只是简单问答对话，还能直接读取本地项目文件、编辑文档与代码、执行系统命令。OpenAI Codex CLI 是用 Rust 重写的轻量级开源编码代理，能读取、编辑、执行项目目录下的代码。截至 2026 年，Codex 每周活跃用户已超过 800 万。​

​

​

总目录​

第一部分：入门篇——认识 Codex​

•

第 1 章：Codex 是什么​

1.1 Codex vs 聊天机器人：本质区别​

1.2 Codex 的三种使用形态：CLI、桌面应用、VS Code 插件​

1.3 Codex vs Claude Code vs Cursor vs Copilot：该选哪个？​

1.4 Codex 的核心能力全景图​

​

•

第 2 章：环境准备、账号与安装​

2.1 系统要求：Node.js ≥ 18，macOS 12+ / Ubuntu 20.04+ / Windows WSL2​

2.2 账号准备：ChatGPT Plus/Pro/Team/Enterprise 或 OpenAI API Key​

2.3 三种安装方式：npm、Homebrew、官方二进制​

2.4 Windows 用户的 WSL2 配置指南​

2.5 首次登录与认证​

​

•

第 3 章：第一个 Codex 任务​

3.1 启动 Codex：交互式 TUI 与单次命令模式​

3.2 让 Codex 理解一个陌生项目​

3.3 第一个实操任务：统计代码行数或解释项目结构​

3.4 观察 Codex 的思考过程与执行轨迹​

​

第二部分：基础篇——掌握核心操作​

•

第 4 章：Codex 的文件系统与工具能力​

4.1 Codex 如何读取、编辑、执行文件​

4.2 沙盒安全机制与权限控制​

4.3 三种权限模式：read-only、workspace-write（默认）、danger-full-access​

4.4 文件边界与工作目录管理​

•

第 5 章：快捷键与 Slash 命令​

◦

5.1 TUI 核心快捷键：Ctrl+C、Ctrl+D、Ctrl+L、Ctrl+G​

◦

5.2 /init —— 初始化项目，自动分析结构​

◦

5.3 /model —— 切换模型与推理强度​

◦

5.4 /plan —— 切换至计划模式​

◦

5.5 其他常用斜杠命令速查​

​

•

第 6 章：代码理解与项目地图​

◦

6.1 用 Codex 理解陌生代码库​

◦

6.2 代码搜索与符号定位​

◦

6.3 依赖关系分析与架构概览​

◦

6.4 让 Codex 生成项目文档​

•

第 7 章：Bug 定位与修复​

◦

7.1 将错误日志交给 Codex​

◦

7.2 Codex 的自主调试流程​

◦

7.3 代码审查与修复验证​

◦

7.4 实战：修复一个真实 Bug​

​

•

第 8 章：重构、测试与文档​

◦

8.1 用 Codex 重构遗留代码​

◦

8.2 自动生成单元测试​

◦

8.3 代码覆盖率分析与提升​

◦

8.4 文档生成与维护​

​

第三部分：进阶篇——工程化实践​

•

第 9 章：AGENTS.md——让 Codex 记住项目规则​

•

第 10 章：提示词工程基本功​

◦

10.1 高质量 Prompt 的四要素：Goal、Context、Constraints、Done when​

◦

10.2 使用 @ 符号精准定位上下文​

◦

10.3 分阶段提示：先设计再实现​

◦

10.4 常见提示词误区与避坑指南​

​

•

第 11 章：计划模式（Plan Mode）与探索模式​

◦

11.1 计划模式的工作原理：先思考再动手​

◦

11.2 何时使用计划模式​

•

第 12 章：上下文管理与长会话​

◦

12.1 Codex 的上下文窗口机制​

◦

12.2 大型项目的上下文优化策略​

◦

12.3 线程系统：跨会话保留工作上下文​

◦

12.4 置顶线程（Pinned Threads）的使用场景​

​

•

第 13 章：Token 节省与成本优化​

◦

13.1 Codex 的成本优势：同等任务 Token 消耗约为 Claude 的三分之一​

◦

13.2 大型单体仓库的启动策略​

◦

13.3 模型选择与成本权衡​

第四部分：高级篇——自动化与协作​

•

第 14 章：Skills 基础​

◦

14.1 Skill 是什么：用 Markdown 写成的“指令包”​

◦

14.2 Skill 的目录结构与发现机制​

◦

14.3 全局技能库 vs 项目级技能​

◦

14.4 内置 Skill 工具的使用​

​

•

第 15 章：自定义 Skill 开发​

◦

15.1 识别高频操作，抽象通用模板​

◦

15.2 编写 SKILL.md 文件​

◦

15.3 添加验证逻辑与参数校验​

•

第 16 章：MCP 集成与工具链扩展​

◦

16.1 MCP（Model Context Protocol）是什么​

◦

16.2 将 Codex 注册为 MCP 服务器​

◦

16.3 与其他工具的集成：Claude Code、Warp 等​

◦

16.4 上下文引擎与语义搜索增强​

​

•

第 17 章：多 Agent 协作​

◦

17.1 Codex 的 SubAgent 支持现状​

◦

17.2 通过 MCP 实现子代理并行执行​

◦

17.3 编排器模式：一个主 Agent 调度多个专业 Agent​

◦

17.4 实战：并行任务处理与结果汇总​

​

•

第 18 章：从一次性问答到可复用工作流​

◦

18.1 识别可自动化的工作流​

◦

18.2 将经验沉淀为 Skill 或自动化脚本​

◦

18.3 配置文件的默认行为管理​

◦

18.4 完整的工程化工作流案例​

​

第五部分：专题篇——实战与生态​

•

第 19 章：桌面应用与 VS Code 插件​

◦

19.1 Codex 桌面应用：任务工作台模式​

◦

19.2 VS Code 插件：编辑器内委派任务​

◦

19.3 三种入口的选择策略​

◦

19.4 图像生成与设计辅助：gpt-image-1.5​

​

•

第 20 章：CI/CD 与自动化集成​

•

第 21 章：团队协作与知识沉淀​

◦

21.1 共享 AGENTS.md 与项目规则​

◦

21.2 团队级 Skills 库的建立​

◦

21.3 Codex 的代码审查工作流​

◦

21.4 拉取请求生成与审阅流程​

​

•

第 22 章：常见问题与排障指南​

◦

22.1 安装与登录问题​

◦

22.2 Windows/WSL2 踩坑汇总​

​

快速参考：本书各章既可顺序学习，也可按需跳读。建议初学者从第 1 章到第 8 章顺序学习，掌握基础后再根据实际需求选择进阶章节。每章末尾的“检查清单”和“常见坑”可以帮助你快速验证学习成果、规避典型错误。​

​

​