# 用 Codex 完成第一处代码改动：从读仓库到验收

原文：https://itjc.com/tutorials/codex-first-change/
主题：Codex；级别：入门；更新时间：2026-11-15。

> 以修改一个空状态提示为例，练习限定范围、审阅差异和验证结果。

## 开始前准备
准备一个你有权修改的小项目、可用的 Codex 使用入口，以及项目的运行说明。本教程采用通用的仓库协作步骤，不绑定某个界面的按钮名称。使用前按官方文档完成登录与项目连接；账户可用功能以实际界面为准。

## 第一步：记录工作区起点
在项目目录运行下面的只读命令。如果已有未提交改动，先弄清它们来自哪里。不要为了让工作区“干净”就删除别人的工作。

```sh
git status --short
git diff --stat
```

## 第二步：交付一个小而明确的任务
第一次合作适合选行为清楚、容易手动复现的改动，例如搜索没有结果时给出下一步提示。

```text
先阅读项目 README 和相关的项目指令，再定位搜索空结果界面。
当用户搜索没有匹配项时，显示“没有找到相关教程，试试其他关键词”。
添加一个清除搜索条件的入口，点击后恢复完整列表。
沿用现有组件和样式，不增加依赖。
完成后说明修改文件、验证方法和结果。
```

## 第三步：检查实际差异
不要只凭“已完成”的回复判断任务结果。用 git diff 查看改动，确认没有顺手重构无关模块，也没有写入凭据或生成无关文件。对不理解的部分，可以要求 Codex 解释触发条件和影响范围。

```sh
git diff
```

## 第四步：按行为验收
按 README 启动项目，输入一个确定不存在的关键词，确认提示出现；点击清除后确认列表恢复。再测试一个真实关键词，确保正常搜索仍然工作。已有相关测试时运行它；测试失败要区分是本次改动引入，还是环境缺失。

## 完成标准与下一步
- 差异只涉及本次任务。
- 空结果和正常结果两种状态都被检查。
- 报告如实区分已验证和未验证事项。

完成后再决定是否提交。先掌握这种“任务、差异、行为验证”的节奏，再让 Agent 处理跨文件功能。

## 官方资料与参考

- [Codex 官方训练入口](https://developers.openai.com/training)
- [Codex Cloud 官方说明](https://learn.chatgpt.com/docs/cloud)
