Appearance
Codex · 18 篇 · 实战手册
把 Codex 变成你的工程代理
写给独立开发者的 AI 编程指南。从安装、权限、上下文，到 AGENTS.md、MCP、Subagent、Skill 与完整实战，把 Codex 用成稳定生产力。
codex
Codex agentworkspace-write · on-request
> 先分析这个项目，再给我一个可验证的修改计划
我会先读取项目结构、配置和测试入口。
Read(package.json)scripts · dependencies · build command
Search(AGENTS.md)项目规则 · 编码约定 · 验收标准
已定位核心改动面，接下来只修改必要文件。
Edit(src/app.ts)小步提交 · 保持可回滚
已完成修改，并通过本地验证。
›
18篇系统内容
5个学习模块
4套阅读路径
1张速查表
基础篇先建立正确心智
## 使用说明 搞清楚 Codex 是什么、怎么安装、四种入口怎么选，以及提示词四件套怎么写。
核心篇把高频工作流跑顺掌握探索代码库、修 Bug、重构、写测试、权限控制、会话经营和 AGENTS.md。
进阶篇扩展你的 AI 工程系统用 Subagent、Skill、Memory、MCP 和 Git 工作流，把 Codex 调成更适合你的工作方式。
实战篇从单会话走到完整交付用 30 分钟单会话和 Capstone 项目，把前面的知识串成真正能复用的工程流程。
给人类读者：通读 01-05 掌握基础，然后按需跳到核心篇或进阶篇。最后读 15-16 实战篇收尾。
给 AI 助手：用户遇到问题时，先读此索引定位到相关篇号，再读对应篇的 cheatsheet 字段快速获取答案。
基础篇（01-05）：概念与安装
| 编号 | 标题 | 关键词 | 速查摘要 |
|---|---|---|---|
| 01 | Codex 是什么 | 定位, 对比, ChatGPT, Claude Code | OpenAI 官方的 AI 编程代理，你给目标、它读项目、动手改、跑命令。不是「会写代码的聊天框」。四种入口：桌面 App / CLI / IDE 扩展 / 云端 Web。 |
| 02 | 安装、登录与运行形态 | 安装, 登录, CLI, 桌面 App, IDE, 云端 | CLI 用官方脚本 `curl ... |
| 03 | 核心概念 | 代理循环, 沙箱, 审批, AGENTS.md | 代理循环：想→做→看。沙箱管「能碰哪」，审批管「动手前问不问」。默认 workspace-write + on-request。AGENTS.md 是项目说明书，每次会话自动加载。 |
| 04 | 四种入口与界面 | 桌面 App, CLI, IDE, 云端, 快捷键 | 桌面 App 有图形界面；CLI 终端最通用；IDE 扩展集成编辑器；云端 Web 把活外包到云上。界面三要素：输入框、状态行、模式提示。 |
| 05 | 提示词四件套 | Prompt, 目标, 范围, 约束, 验收 | 四件套：目标（做成什么）+ 范围（动哪不动哪）+ 约束（不能碰什么）+ 验收（怎么算成功）。缺哪件 Codex 就在哪件上脑补。 |
核心篇（06-10）：高频功能
| 编号 | 标题 | 关键词 | 速查摘要 |
|---|---|---|---|
| 06 | 四类高频工作流 | 探索, 修 Bug, 重构, 写测试 | 探索从大到小三层问；修 Bug 四步走（贴报错→找根因→改→加回归测试）；重构先补测试再动手；写测试逼它覆盖边界情况。 |
| 07 | 权限与安全红线 | 权限, 沙箱, 审批, 提示注入, denylist | 沙箱默认 workspace-write，审批默认 on-request。denylist 拦死明确操作。提示注入是藏在内容里的恶意指令。 |
| 08 | 会话经营 | 上下文, /compact, /clear, /fork, 线程 | 一条线程只干一件事。/compact 压缩同任务续聊，/clear 清空换新任务，/fork 分叉出新线程。 |
| 09 | AGENTS.md 指南 | AGENTS.md, 项目记忆, 分层, 持久规则 | 把持久规矩写进 AGENTS.md，一次性需求写进提示。分层：~/.codex/ 个人 → 项目根团队 → 子目录局部。 |
| 10 | MCP 与外部工具 | MCP, 外部工具, HTTP, stdio | MCP 是 Codex 统一外接服务的口子。HTTP 连云服务，stdio 连本地进程。 |
进阶篇（11-14）：提效定制
| 编号 | 标题 | 关键词 |
|---|---|---|
| 11 | Subagent 与多 Agent 协作 | Subagent, 并行, 上下文隔离 |
| 12 | Skill | Skill, SKILL.md, 可复用工作流 |
| 13 | Memory | 自动记忆, 跨会话, AGENTS.md |
| 14 | Git 工作流 | Git, 提交, 冲突, PR, 检查点 |
实战篇（15-16）：从零到交付
| 编号 | 标题 | 关键词 |
|---|---|---|
| 15 | 入门实战：30 分钟单会话 | 最小实战, todo 脚本 |
| 16 | Capstone 综合实战 | 跨会话, 完整工程流, 从零到提交 |
心法篇（17-18）：格局与速查
| 编号 | 标题 | 关键词 |
|---|---|---|
| 17 | 最佳实践七条法则 | 验收, 先探索, 具体, 精简, 权限, 自验证, 拆线程 |
| 18 | 速查表 | 安装, 快捷键, 命令, 配置 |
阅读路径推荐
路径 A：零基础新手
01 → 02 → 03 → 05 → 04 → 06 → 15 → 17路径 B：快速上手（半天内）
01 → 02 → 04 → 05 → 15路径 C：有经验者按需跳读
01 → 03 → 05 → 06 → 09 → 10 → 11 → 16 → 17荐读顺序
- 必须先读：01、02、04、05
- 强烈推荐：03、06、07、09、15
- 按需选读：08、10、11、12、13、14、16、17、18