Codex 桌面端 21 天系统学习路线
这份路线给已经在使用 Codex 桌面端的人：从「会发需求」走到「能让 Codex 稳定参与真实工程交付」。每天都有一个可见交付物，避免只看功能介绍却没有肌肉记忆。
学习地图
把 Codex 当成「会修改仓库的协作者」来学，而不是把它当成单次问答工具。学习顺序应从可控的小任务开始，逐步扩大到项目规则、外部工具、长期任务和并行协作。
个人操作层
把需求、上下文、约束、完成标准说清楚。重点入口是线程、项目、终端、diff 面板、/plan、/status。
项目协作层
把常见规则沉淀为项目默认行为。重点入口是 AGENTS.md、.codex/config.toml、权限配置和 /review。
系统扩展层
把外部信息、浏览器、插件、自动化和子代理接入工作流。重点入口是 Skills、Plugins、MCP、Browser、Automations、Subagents。
AGENTS.md 或检查清单。21 天每日路线
路线分成 3 个阶段：第 1 周掌握桌面端基本工作循环，第 2 周进入真实项目与团队规则，第 3 周学习扩展、自动化和并行协作。每一天都以一个可见交付物结束。
第 1 周：把 Codex 用稳
目标是形成「说明任务 - 看计划 - 让它改 - 跑检查 - 看 diff - 反馈」的基础闭环。
桌面端地图
打开一个熟悉项目，找到项目、线程、终端、diff 面板、设置、插件入口。
交付物：一页「我的 Codex 工作台地图」。
检查：能说清本地线程、无项目聊天、云端任务的差别。
好 prompt 的四件套
用「目标、上下文、约束、完成标准」让 Codex 解释一个模块。
交付物：3 个可复用 prompt。
检查：输出包含文件路径、调用关系和不确定点。
Plan mode
给一个模糊需求，先用 /plan 让 Codex 访谈你并形成计划。
交付物：一份 5 步以内执行计划。
检查：计划里有风险、待确认项和验证方式。
小改动闭环
让 Codex 做一个低风险改动，例如文案、配置、单个函数。
交付物：一次干净 diff。
检查：改动范围符合要求，能运行对应检查。
终端与验证
要求 Codex 找到本仓库构建、测试或 lint 命令并执行。
交付物：项目检查命令清单。
检查：能区分失败来自环境、代码还是命令选错。
diff 反馈
在 diff 面板逐行查看改动，并对一处具体行反馈修改意见。
交付物：一次「看 diff -> 反馈 -> 修正」记录。
检查：Codex 能基于你的行级反馈更新实现。
Goal mode
用 /goal 定义一个可完成目标，例如「修复 X 并让测试通过」。
交付物：一个带完成标准的 goal。
检查：目标文本具体到 Codex 可以判断是否完成。
第 2 周：把 Codex 接进真实项目
目标是让 Codex 不只完成单次任务，而是稳定遵守你的仓库结构、测试命令、审查标准和权限边界。
AGENTS.md
让 Codex 读取项目并起草一个短 AGENTS.md。
交付物：项目规则草稿。
检查：包含目录、运行命令、风格、禁区、完成定义。
配置层级
查看 ~/.codex/config.toml 与项目 .codex/config.toml 的职责。
交付物：个人配置与项目配置分工表。
检查：知道哪些规则应全局保存，哪些应随仓库保存。
权限与沙箱
比较只读、工作区写入、完全访问在本地任务里的风险。
交付物：一份权限选择准则。
检查：默认能解释为什么新仓库先用较紧权限。
代码审查
使用 /review 审查未提交改动或对比 base branch。
交付物：一份按严重程度排序的 review 结果。
检查：发现项有文件位置、风险解释和测试缺口。
测试习惯
让 Codex 为 Day 04 的改动补一个最小测试或验证脚本。
交付物：测试或验证说明。
检查：不是只说「已验证」，而是给出命令和结果。
线程管理
并行开两个线程：一个解释代码，一个做改动，避免改同一文件。
交付物：线程命名和使用规则。
检查：知道什么时候开新线程，什么时候继续旧线程。
复盘写回规则
挑一个 Codex 反复误解的问题，写回 AGENTS.md 或 prompt 模板。
交付物：一条新增项目规则。
检查：新线程能自动遵守这条规则。
第 3 周：扩展成个人工作系统
目标是把 Codex 从「本地代码助手」扩展为跨工具协作者，并学会用子代理和自动化处理重复工作。
Skills
用 $ 显式调用一个已安装 skill，并观察它如何读取说明。
交付物：一份 skill 调用笔记。
检查：知道 skill 适合沉淀流程，而不是一次性偏好。
Plugins
打开插件目录，安装或启用一个与你工作相关的插件。
交付物：插件用途与权限记录。
检查：能区分插件里的 skills、apps、MCP servers。
MCP
打开 /mcp 或设置里的 MCP 页面，检查已连接服务器。
交付物：MCP 连接清单。
检查：知道 MCP 适合接外部文档、浏览器、设计工具或内部系统。
浏览器验证
让 Codex 打开本地页面或 localhost，截图检查一个 UI 改动。
交付物：一张验证截图和问题列表。
检查：验证结果来自真实渲染，不只来自代码阅读。
自动化
设计一个低风险自动化，例如每日检查待办或定期提醒复盘。
交付物：自动化需求卡。
检查：说明触发时间、输入、输出、权限和失败处理。
子代理
要求 Codex 为同一个 PR 并行派出安全、测试、可维护性 3 个审查视角。
交付物：合并后的审查报告。
检查：子代理结果被归并、去重，并按风险排序。
毕业任务
选择一个真实中等任务，让 Codex 计划、实现、测试、审查并复盘。
交付物：完整交付记录。
检查：包含 prompt、计划、diff、检查命令、review、经验写回。
可复制模板
基础任务 prompt
目标：请在当前项目中完成 [具体任务]。
上下文：重点查看 [文件/目录/错误信息]，必要时先说明你还需要哪些信息。
约束：保持现有架构，不做无关重构；改动前先说明计划。
完成标准：实现后运行 [测试/构建/检查命令]，最后总结改动、验证结果和剩余风险。让 Codex 先访谈你
我现在只有一个模糊想法：[想法]。
请先不要写代码。先问我最多 5 个关键问题，帮我把目标、范围、约束、验收标准确定下来。
问题问完后，请输出一个 5 步以内的执行计划。代码审查 prompt
请按 code-review 姿态审查当前改动。
优先级：正确性、安全风险、行为回归、缺失测试、可维护性。
输出要求：发现项放最前，每条包含文件位置、风险、建议修复方式；没有问题也要说明测试缺口。AGENTS.md 起步骨架
# AGENTS.md
## 项目结构
- 说明核心目录和入口文件。
## 常用命令
- 安装：
- 开发：
- 测试：
- lint / format：
## 工程约定
- 保持现有架构边界。
- 不做无关重构。
- 修改共享行为时必须补测试。
## 完成标准
- 说明改动摘要。
- 列出运行过的检查命令和结果。
- 标明未验证项和剩余风险。AGENTS.md、自定义 prompt、skill 或项目配置里。入口与来源
常用入口
- Cmd + Shift + P / Cmd + K：打开命令菜单。
- Cmd + J：切换终端。
- Cmd + Option + B：切换 diff 面板。
/plan：进入计划模式。/goal：设置持续目标。/review：审查未提交改动、分支差异或提交。/mcp：查看 MCP 连接状态。$skill/@plugin：显式调用技能或插件。
资料来源
本路线基于 2026.06.14 本地抓取的 OpenAI Codex Manual 整理，覆盖 Quickstart、Best practices、Prompting、Codex app commands、Codex app features、Codex app settings、Agent Skills、AGENTS.md、MCP、Permissions、Plugins、Subagents、Hooks 与 Automations。