20 分钟快速上手

如果你已经完成安装、登录和模型配置，这篇就是最适合立刻开做的第一篇。

它不追求把 Codex 所有能力一次讲完，只做一件事：

20 分钟内，让你真正完成一次最小闭环。

这个闭环不是“看懂概念”，而是：

进入项目 -> 让 Codex 先读项目 -> 让它做一个小修改 -> 让它解释结果

前置教程：第一次让 Codex 阅读项目
如果你还没有完成安装、登录和模型配置，或者还没有让 Codex 成功读过一个项目，先完成前置教程，再回到本篇。

依据来源：OpenAI Codex 官方手册中关于任务拆分、只读分析、范围控制、检查和结果汇报的说明。

本篇目标

跟着本篇做完后，你应该能做到：

在正确项目里启动 Codex。
让 Codex 先做只读分析。
让 Codex 做一个单文件低风险修改。
让 Codex 检查本次修改结果。
判断这次练习是否跑通。

先说结论：这 20 分钟你要做什么

如果你时间很少，直接按下面顺序做：

进入一个练习项目。
启动 Codex。
让 Codex 只读分析项目结构。
让 Codex 只改一个文案。
让 Codex 解释 Git 状态和 diff。

这就是第一轮最小闭环。

第 1 步：准备一个练习项目

不要一上来就在公司的正式项目里练。

优先用下面这类项目：

自己新建的演示项目
一个静态页面小项目
一个 Vite 默认项目
一个你完全可以接受改坏的练习仓库

如果你使用 Windows 命令提示符，进入项目目录：

cd D:\code\codex-demo

如果项目在 C 盘，就换成你自己的实际路径。

然后启动 Codex：

codex

第 2 步：先不要改，先让 Codex 读项目

把下面这段发给 Codex：

请先只读分析当前项目。

要求：
1. 不要修改任何文件。
2. 不要创建或删除文件。
3. 不要运行安装、构建、测试或提交相关命令。
4. 如果你不确定，请直接写不确定，不要猜。

请按下面格式输出：

## 当前目录
- 当前路径：
- 是否像项目根目录：
- 你的判断依据：

## 项目结构
- 你看到的技术栈：
- 入口文件：
- 关键目录：
- 如果有 package.json，请列出 scripts：

## 新手第一次适合做什么
- 请推荐 3 个低风险小任务
- 每个任务都说明涉及文件、为什么风险低、怎么验证

你现在的目标不是看它分析得多高级，而是确认它会先读再动手。

第 3 步：从它推荐的任务里选一个最小的

你只选这种任务：

改一个标题文案
改一个按钮文字
改 README 里的一句话

你不要选这种任务：

重构首页
修复所有报错
新增登录注册
优化整站样式

如果它推荐的任务偏大，继续回复：

请把任务再缩小一点。
我第一次练习只想做一个单文件改动，最好是改文案或 README。
请重新给我 3 个只涉及 1 个文件的小任务。

第 4 步：发出第一次真正可执行的修改任务

选定任务后，把下面这段发给 Codex：

请完成一个第一次练习用的小任务。

任务目标：
把首页默认标题改成“Codex Demo”。

要求：
1. 先定位这个标题在哪个文件。
2. 只允许修改 1 个文件。
3. 不要修改样式文件。
4. 不要安装依赖。
5. 不要运行构建。
6. 不要提交 Git。
7. 如果你发现需要改多个文件，请先停下来说明原因。

完成后请按下面格式汇报：

## 修改文件
- 文件路径：

## 修改内容
- 原内容：
- 新内容：

## 自检结果
- 当前 Git 状态：
- diff 大意：
- 是否只修改了 1 个文件：
- 是否存在超出范围的改动：

如果你练的是 README，就把“首页默认标题”替换成 README 的实际目标。

第 5 步：看它是不是按你要求来

它完成后，你只检查 4 件事：

它有没有说清楚改了哪个文件。
它是不是只改了 1 个文件。
它有没有解释 diff。
它有没有偷偷扩大范围。

如果它没解释清楚，继续追问：

请把这次修改后的 Git 状态和 diff 用新手能看懂的话再解释一遍。
只解释，不要继续修改文件。

第 6 步：20 分钟版本的完成标准

如果下面 5 条都满足，就说明你这 20 分钟没白花：

你成功在项目里启动了 Codex。
它先做了只读分析。
它完成了一次单文件小修改。
它解释了修改结果。
你能判断这次修改是否在范围内。

这时候你还没有“精通 Codex”，但你已经正式跨过了最难的一步：

从“知道有这个工具”，变成“真的用它完成了一个完整小任务”。

如果 20 分钟里卡住了

最常见就卡这几种：

1. Codex 找不到项目

先检查你是不是在正确目录里启动的。

2. Codex 一上来就想跑很多命令

立刻补一句：

这次只允许只读分析或单文件修改，不要运行构建、测试、安装或提交相关命令。

3. 它改了多个文件

先不要继续，直接问：

我要求只改 1 个文件。请解释为什么会有多个文件变化，不要继续修改。

4. 你看不懂它的总结

就让它重新用中文讲人话：

请把这次修改结果用完全新手能看懂的话重新解释。

下一步该看什么

如果你已经跑通这 20 分钟流程，下一篇建议看：

这三篇会把你刚刚做的“简化版流程”扩成真正能用于项目的工作方式。