打开 Codex 课程目录

Codex 完成第一次受控修改

本页目标

学完本页,你能让 Codex 只修改练习仓库中 README.md 的第一行,并确认最终差异只有这一行。这是前 10 课第一次真正写文件,结果仍然保持很小。

验证范围(2026-07-11) /plan/diff/review 和权限行为已对照 OpenAI 官方文档;制作环境未完成 CLI 实机回放。菜单文字可能随版本变化,最终只以你自己的 Git 差异为准。

OpenAI Codex 官方仓库中展示计划和代码库探索的 CLI 界面
官方截图OpenAI Codex 开源仓库的真实 CLI 展示图(Apache-2.0)。画面版本和模型仅为示例,本课只借它认识计划与工作记录区域。查看官方原图

开始前

准备一个可以随时恢复的 Git 练习仓库,确保根目录有 README.md。先运行 git status --short;本课要求结果为空。只要仓库已有任何改动,就换一个干净练习仓库,不要拿正式项目做第一次修改。

从计划、修改一行到查看差异、审查和人工确认的步骤图
步骤示意这节课只交付一个结果:README 第一行改变;计划、差异和审查都是核对手段。

跟着做

  1. 在仓库中启动 Codex,运行 /status 确认目录正确,再用 /permissions 选择 Read Only。
  2. 输入 /plan,提交下面的任务,让 Codex 先给计划、不写文件。
Codex · 可复制提示词

只改 README 第一行

适用场景
第一次允许 Codex 修改文件
变量说明
把 {新标题} 替换成你的练习项目名称
目标:把 README.md 第一行改成“# {新标题}”。
范围:只允许修改 README.md 第一行。
输出:先给出三步计划,并说明完成后怎样确认只改了这一行。
边界:现在只制定计划,不修改文件,不提交 Git;如果 README.md 不存在或第一行不是标题,请停止并告诉我。
预期结果

得到只涉及 README 第一行和差异检查的简短计划

  1. 核对计划后,等当前任务结束,再输入 /plan 切回普通模式;将 /permissions 调整为 Auto,然后输入:按刚才的计划执行,只改 README.md 第一行,不要提交。
  2. 修改完成后输入 /diff。确认只出现 README.md 第一行变化,再输入 /review 审查当前工作区。
  3. 最后在普通终端运行 git status --short。不要因为审查没有报错就跳过人工检查。

结果检查

合格结果同时满足三点:/diff 只显示一个文件的一行替换;git status --short 只列出 README.md/review 没有发现额外问题,或明确列出仍需处理的问题。出现其他文件时先停止,不要提交。

练习

动手练习

再做一次单行修改

把 README 中的一句项目说明换成更清楚的句子,仍然先计划、只改一处,再查看差异和审查。

完成标准:最终差异只有预期的一行,能亲自说明保留这项改动的依据。

本页小结

第一次修改越小越好。先计划、只放开必要权限、查看准确差异、再做审查和人工确认,就能把“AI 帮我改”变成一个可控制、可验收的过程。

参考资料

查证日期:2026-07-11
学习支持

需要下一步建议?

加入学习社群或预约企业 AI 落地咨询。当前仅提供联系入口,不在站内收费。

查看联系入口