Codex CLI 入门:完成第一个可验证任务
新手不要一上来就让 Codex 重构整个项目。最稳的方式是选一个小任务,让它读上下文、做最小修改、运行验证。
1. 准备项目目录
在你要修改的项目根目录启动 Codex。这样它能读取仓库结构、项目规则和测试命令。
cd my-project
codex
2. 用四段式描述任务
把任务写成“目标、范围、约束、验收”。这比一句“帮我修 bug”稳定得多。
目标:修复登录接口偶发超时。
范围:只修改 src/auth 和相关测试。
约束:保持现有 API 兼容,不做无关重构。
验收:添加回归测试,并运行 npm test。
3. 要求先解释计划
如果任务涉及多个文件,先让 Codex 说明它准备读哪些文件、可能风险是什么、准备用什么测试验证。
4. 检查最终结果
完成后重点看三件事:修改是否在范围内、测试是否真的运行、是否还有未验证风险。
建议:第一次练习只做 30 分钟以内能完成的小任务。目标是建立闭环,不是追求一次性自动化所有工作。