如何使用 Codex 完成一个真实任务
从打开项目、描述目标、确认计划，到让 Codex 修改代码、运行测试并交付结果的手把手教程。
最近更新：2026年6月11日
描述任务
目标、范围、验收标准
修改项目
读取上下文并编辑文件
运行验证
测试、构建、浏览器检查
效果：交付结果可检查
示意图：用户目标进入 Codex 后，会经过项目上下文、代码修改和验证循环。
先把工作区和目标说清楚
Codex 会读取当前项目、遵守仓库规则，并在同一个工作区里修改文件。你给出的目标越具体，它越容易直接完成，而不是停留在建议层面。
- 说明你要改的页面、接口或文件范围。
- 说明验收标准，例如页面要出现什么文字、按钮要能做什么。
- 如果有不能碰的内容，也要提前写明。
描述任务
目标、范围、验收标准
修改项目
读取上下文并编辑文件
运行验证
测试、构建、浏览器检查
效果：交付结果可检查
示意图：用户目标进入 Codex 后，会经过项目上下文、代码修改和验证循环。
让 Codex 先读项目再动手
在已有项目中，最稳的方式是让 Codex 先查看目录、package 脚本、框架文档和相关文件。它会把发现同步给你，然后再开始编辑。
- 让 Codex 使用项目已有组件、样式和数据结构。
- 复杂改动可以要求它列出计划；小改动可以直接执行。
- 每次代码改完后，让它运行 typecheck、lint、test 或本地页面验证。
描述任务
目标、范围、验收标准
修改项目
读取上下文并编辑文件
运行验证
测试、构建、浏览器检查
效果：交付结果可检查
示意图：读项目、改代码、跑验证是 Codex 交付任务的基本闭环。
手把手教学
打开目标项目
在 Codex 桌面端或 CLI 中进入项目目录，确认当前工作区就是你要修改的仓库。
cd /path/to/your-project完成效果：Codex 能读取仓库文件、脚本和本地说明文档。
用一句话给出目标
把目标、范围和验收结果写在同一条消息里。例如：把首页的空状态改成教程入口，运行测试并告诉我部署前检查结果。
完成效果：Codex 会开始查找相关文件，并说明它准备修改的区域。
让 Codex 执行修改
如果计划合理，直接让它继续。它会编辑文件、保留无关改动，并避免覆盖你已经写好的内容。
完成效果：项目中会出现可查看的代码变更，而不是只有文字方案。
要求验证和交付
让 Codex 运行项目里的验证命令；如果是前端，还应该打开本地页面做一次视觉和交互检查。
npm run typecheck && npm run lint && npm run test完成效果：你会得到通过项、失败项和剩余风险说明。
效果展示
完成后，Codex 应该给出具体改了哪些文件、哪些验证通过、哪些事项仍需人工确认。