02 · Codex 核心概念速览

这一篇不是背术语。

它的目标很简单：让你看懂 Codex 工作时经常出现的几个词。

第一次用 Codex，小白最容易卡在这些词上：

• 项目
• 文件
• 任务
• 上下文
• 工具
• diff
• 验证

你不用一次学透。先知道它们在一次任务里分别代表什么，就够了。

开始前先有一个画面

把 Codex 想成一个进入项目现场的助手。

你要先知道：

1. 它站在哪个“项目”里。
2. 它能看到哪些“文件”。
3. 你给它的“任务”是什么。
4. 它改完后，你怎么通过 diff 和验证确认结果。

这一篇不要求你背术语。 只要求你以后看到这些词时，不会慌。

第一步：项目就是“工作现场”

你让 Codex 干活，通常不是在空气里干活，而是在一个文件夹里干活。

这个文件夹就可以先理解成“项目”。

比如你的网站项目里，可能有：

docs/
package.json
README.md

Codex 需要先知道项目里有什么，才知道从哪里下手。

所以第一次打开项目时，你可以先问：

请先阅读当前项目结构，不要修改文件。
用普通人能听懂的话告诉我：
1. 这里主要有哪些文件和文件夹
2. 这个项目大概是做什么的
3. 你建议我下一步先看哪个文件

第二步：文件就是“它能改的具体东西”

项目是一个大文件夹，文件是里面具体能改的东西。

比如：

文件	可能负责什么
index.md	首页内容
config.mts	网站配置
main.py	Python 代码
README.md	项目说明

新手要养成一个习惯：

每次让 Codex 修改前，都问清楚它准备改哪个文件。

可以这样问：

开始修改前，请先告诉我你准备修改哪些文件，每个文件为什么要改。
等我确认后再动手。

第三步：任务就是“这一次只做什么”

很多人用 Codex 翻车，不是因为模型不行，而是任务太大。

坏任务：

帮我做一个完整网站。

好任务：

请只修改首页标题，把它改成“普通人 AI 实战手册”。
修改前先告诉我你准备改哪个文件。

任务越小，越容易检查。

小白第一阶段，尽量用这种任务：

1. 只改一个文件。
2. 只做一个目标。
3. 做完能马上看结果。

第四步：上下文就是“你给它的背景”

Codex 不是读心术。

你不告诉它背景，它就只能猜。

比如你说：

把页面改好看一点。

这句话太模糊。

更好的说法是：

这个网站给完全不会编程的小白看。
页面风格要清爽、像教程手册，不要做成科技发布会那种夸张风格。
请先只调整首页第一屏文案，不要改其它页面。

这就是上下文。

上下文一般包括：

1. 给谁看。
2. 要解决什么问题。
3. 第一版范围。
4. 不要做什么。
5. 怎么判断完成。

第五步：工具就是 Codex 能用来干活的能力

Codex 可能会用不同工具完成任务，比如：

• 读取文件
• 修改文件
• 运行命令
• 打开网页预览
• 搜索项目内容
• 总结改动

你不用记工具名。

你只要记住：当 Codex 要运行命令或修改文件时，你要看清楚它准备做什么。

如果不懂，直接问：

这一步会做什么？会不会删除、覆盖、移动我的文件？
请用普通人能听懂的话解释。

第六步：diff 就是“改动对比”

diff 是新手必须慢慢看懂的东西。

它通常长这样：

- 旧内容
+ 新内容

你先不用看懂所有符号，只记住：

1. - 通常代表删掉的旧内容。
2. + 通常代表新增的新内容。
3. 你要看它有没有改到不该改的地方。

每次 Codex 修改后，你都可以问：

请解释这次 diff。重点告诉我：
1. 删除了什么
2. 新增了什么
3. 修改了哪些文件
4. 有没有超出我要求的范围

第七步：验证就是“别只听它说完成”

Codex 说“完成了”，不代表真的能用。

验证就是检查结果。

常见验证方式：

任务	怎么验证
改文案	打开页面看文案是否变了
改代码	运行测试或构建
修 bug	重现原来的错误，看是否消失
写文档	检查目录、链接、错别字

你可以固定问：

请告诉我这次任务应该怎么验证。
如果可以运行检查，请你运行检查并解释结果。

常见错误

错误一：不让 Codex 先读项目。

更好的做法：先让它解释项目结构。

错误二：任务太大。

更好的做法：一次只做一个小目标。

错误三：不给上下文。

更好的做法：说清楚读者、目标、范围和不要做什么。

错误四：不看 diff。

更好的做法：每次修改后都让 Codex 解释 diff。

错误五：不验证。

更好的做法：让 Codex 说明检查方式，你自己也看一遍结果。

检查清单

读完这一篇，你应该能勾选：

• 我知道项目就是 Codex 工作的文件夹。
• 我知道修改前要问清楚会改哪些文件。
• 我知道任务要小，不要一上来做完整项目。
• 我知道上下文就是我给 Codex 的背景信息。
• 我知道 diff 是改动对比。
• 我知道完成后必须验证。

小结

Codex 的核心概念不用背。

你先记住这条线：

项目是现场，文件是对象，任务是目标，上下文是背景，diff 是改动，验证是验收。

下一篇开始，我们再进入安装和登录。