Codex 完成第一次受控修改
本页目标
学完本页,你能让 Codex 只修改练习仓库中 README.md 的第一行,并确认最终差异只有这一行。这是前 10 课第一次真正写文件,结果仍然保持很小。
验证范围(2026-07-11)
/plan、/diff、/review和权限行为已对照 OpenAI 官方文档;制作环境未完成 CLI 实机回放。菜单文字可能随版本变化,最终只以你自己的 Git 差异为准。

开始前
准备一个可以随时恢复的 Git 练习仓库,确保根目录有 README.md。先运行 git status --short;本课要求结果为空。只要仓库已有任何改动,就换一个干净练习仓库,不要拿正式项目做第一次修改。
跟着做
- 在仓库中启动 Codex,运行
/status确认目录正确,再用/permissions选择 Read Only。 - 输入
/plan,提交下面的任务,让 Codex 先给计划、不写文件。
Codex · 可复制提示词
只改 README 第一行
目标:把 README.md 第一行改成“# {新标题}”。
范围:只允许修改 README.md 第一行。
输出:先给出三步计划,并说明完成后怎样确认只改了这一行。
边界:现在只制定计划,不修改文件,不提交 Git;如果 README.md 不存在或第一行不是标题,请停止并告诉我。预期结果
得到只涉及 README 第一行和差异检查的简短计划
- 核对计划后,等当前任务结束,再输入
/plan切回普通模式;将/permissions调整为 Auto,然后输入:按刚才的计划执行,只改 README.md 第一行,不要提交。 - 修改完成后输入
/diff。确认只出现README.md第一行变化,再输入/review审查当前工作区。 - 最后在普通终端运行
git status --short。不要因为审查没有报错就跳过人工检查。
结果检查
合格结果同时满足三点:/diff 只显示一个文件的一行替换;git status --short 只列出 README.md;/review 没有发现额外问题,或明确列出仍需处理的问题。出现其他文件时先停止,不要提交。
练习
动手练习
再做一次单行修改
把 README 中的一句项目说明换成更清楚的句子,仍然先计划、只改一处,再查看差异和审查。
完成标准:最终差异只有预期的一行,能亲自说明保留这项改动的依据。
本页小结
第一次修改越小越好。先计划、只放开必要权限、查看准确差异、再做审查和人工确认,就能把“AI 帮我改”变成一个可控制、可验收的过程。