Appearance
Codex 第一个任务怎么做?只改 README 的安全练习
你会学到:第一次不要让 Codex 改核心代码,先用一个能看懂、能撤回、能验收的小任务建立手感。
先看结论
第一个任务不要追求“有用到飞起”。它的目标只有一个:证明你能安全地让 Codex 读项目、提出计划、做小改动,并检查结果。
最推荐的第一个任务是:
text
只改 README,不改代码、不改配置、不新增依赖。如果你连 README 改动都看不懂,就不要让 Codex 继续碰业务代码。
为什么第一个任务要这么小
新手第一次使用 Codex,最容易出问题的不是“提示词写得不够高级”,而是范围太大。
一个合格的新手任务要满足 5 个条件:
| 条件 | 含义 | 为什么重要 |
|---|---|---|
| 低风险 | 不碰代码、密钥、数据库、部署 | 出错也不会影响项目运行 |
| 小范围 | 最多改 1 个文档文件 | 你能完整看完 diff |
| 可解释 | Codex 先说明它准备怎么做 | 你能提前拦住错误方向 |
| 可撤回 | 不满意可以丢弃改动 | 不会被错误结果绑住 |
| 可验收 | 有明确完成标准 | 不是凭感觉说“好像可以” |
README 小修正好符合这些条件。
第一步:选一个练习目录
不要直接拿公司项目、生产项目、私密知识库练手。
优先选择:
- 一个公开示例项目。
- 一个没有密钥和客户资料的个人项目。
- 一个专门新建的练习文件夹。
- 本站的 README 小修练习。
如果目录里有这些内容,先不要给 Codex 读:
.env、密钥、Token、Cookie。- 生产数据库配置。
- 客户资料、合同、账单、身份信息。
- 你还没备份的重要文件。
第二步:先让 Codex 只读,不要马上修改
第一次提示词建议这样写:
text
请先阅读当前项目的 README 和目录结构。
只提出 README 改进计划,不要修改文件。
重点看:
1. 项目一句话定位是否清楚。
2. 快速开始步骤是否缺东西。
3. 新手应该先读哪 3 个文件。
4. README 是否有明显错别字或结构问题。这里最重要的是“只提出计划,不要修改文件”。
如果 Codex 直接开始改文件,说明边界没有立住。你应该停下来,把任务改小。
第三步:确认计划后,只允许改 README
看到计划后,如果你觉得方向合理,再发第二句:
text
可以执行。
只修改 README,不改代码、不改配置、不新增依赖。
完成后请总结 diff,并列出我需要人工检查的地方。不要把“顺便优化项目结构”“顺便加脚本”“顺便整理配置”放进第一个任务。顺便越多,风险越大。
第四步:看 diff,而不是只看总结
Codex 改完后,先看它的总结,再看实际 diff。
你要确认 4 件事:
- 只改了 README。
- 没有新增你不认识的命令。
- 没有编造安装方式、价格、额度或官方结论。
- 新内容你自己读得懂。
如果你不知道怎么检查,先读 Codex 怎么看 diff 和验证结果。
验收优先级 第一次任务不是为了产出完美 README,而是为了确认你能控制范围、看懂改动、撤回结果。
第五步:不满意就撤回
如果改动不符合预期,不要继续让它在错误结果上修来修去。
你可以直接说:
text
这次改动不采用。
请先解释你改动里的问题,不要继续修改文件。然后撤回这次改动。第一次练习能安全撤回,也算成功。
常见错误
| 错误做法 | 风险 | 更好的做法 |
|---|---|---|
| “帮我优化整个项目” | 范围失控 | “只读项目,先给 README 改进计划” |
| “直接修所有问题” | 你看不完 diff | “只改 README 一个文件” |
| “把能做的都做了” | 容易新增依赖和配置 | “不要改代码、配置、依赖” |
| 改完只看总结 | 可能漏掉实际改动 | 必须看 diff |
| 看不懂也继续下一步 | 风险累积 | 停下,先让 Codex 解释 diff |
完成标准
你完成第一个任务后,应该能说清楚:
- Codex 读了哪些文件。
- 它提出了什么计划。
- 它最终改了哪个文件。
- 你是否看过 diff。
- 这次改动能不能撤回。
如果这 5 个问题都能回答,就可以进入下一步。
推荐下一步
- 还没有准备环境:读 账号与安装。
- 已经能打开项目:做 README 小修练习。
- 改完不知道怎么看:读 看 diff 和验证。
来源与复核
- 来源:本站练习页、公开 Codex 使用经验和任务验收规则整理。
- 官方入口:OpenAI Codex
- 相关页面:OpenAI Help Center: Codex CLI
- 最后复核:2026-06-07。本文主要是任务边界和验收方法,不包含价格、额度、计划权益等易过期事实。