20 分钟快速上手实战

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

它不追求把 Codex 所有能力一次讲完，只做一件事：20 分钟内，让你真正完成一次最小闭环。

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

第 1 步：准备练习项目并启动

优先用下面这类项目：

进入项目目录并启动：

``bash


cd D:\code\codex-demo
codex


第 2 步：先让 Codex 读项目（只读分析）
把下面这段发给 Codex：

`markdown


请先只读分析当前项目。
要求：


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

请按下面格式输出：
当前目录


当前路径：
是否像项目根目录：
你的判断依据：
项目结构
你看到的技术栈：
入口文件：
关键目录：
如果有 package.json，请列出 scripts：
新手第一次适合做什么
请推荐 3 个低风险小任务
每个任务都说明涉及文件、为什么风险低、怎么验证


第 3 步：选一个最小的修改任务
只选这种任务：

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

如果它推荐的任务偏大，要求它再缩小：


请把任务再缩小一点。我第一次练习只想做一个单文件改动，最好是改文案或 README。


第 4 步：执行第一次代码修改
选定任务后（例如修改首页标题）：

`markdown


请完成一个第一次练习用的小任务。
任务目标：把首页默认标题改成“Codex Demo”。
要求：


先定位这个标题在哪个文件。
2. 只允许修改 1 个文件。
3. 不要修改样式文件。
4. 不要安装依赖。
5. 不要运行构建。
6. 不要提交 Git。
完成后请按格式汇报：修改文件、修改内容、自检结果（Git 状态、diff 大意）。



第 5 步：检查结果与解释
它完成后，检查：


是否说清楚了改了哪个文件。
2. 是否只改了 1 个文件。
3. 是否解释了 diff。
4. 是否偷跑了范围外的改动。

如果没解释清楚，追问：


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