← 返回系统教程
系统教程快速开始App / CLI / IDE / Cloud入门

第一次使用 Codex:从打开仓库到完成可验证改动

建立一条最小但完整的 Codex 工作流:选择形态、提供仓库上下文、限制范围、检查差异并运行验证。

25 分钟阅读核验于 2026/07/16

先选适合当前任务的形态

CLI 适合终端内的本地仓库工作,IDE 适合围绕当前文件和选区迭代,App 适合并行任务与差异审阅,Cloud 适合在隔离环境中委派较长任务。第一次练习只需选择一种,不必同时配置全部形态。

  • 确认目标目录是 Git 仓库。
  • 先用只读问题让 Codex概括项目结构和验证命令。
  • 把第一次改动限制在一个问题和少量文件内。

写出可执行任务

一个有效任务应同时说明目标、允许修改范围、禁止事项和验收方式。先要求 Codex 读取相关文件并复述计划,再允许它编辑,可以更早发现上下文偏差。

阅读仓库说明与相关实现。只修复登录表单的重复提交问题,不改接口契约。完成后运行现有 lint 与相关测试,并报告改动文件、命令结果和仍未验证的边界。

把验证当成交付的一部分

检查最终差异是否越界,再核对 Codex 实际运行过的命令与退出状态。没有执行的测试必须明确写成未验证,不能把建议命令当成通过记录。

  • 阅读完整 diff。
  • 运行仓库规定的最小检查。
  • 记录手工检查项与残余风险。

参考来源

优先使用 OpenAI 官方文档与官方仓库。外部来源会单独标识。

  1. OpenAI Codex Quickstart

    官方来源 · https://learn.chatgpt.com/docs/quickstart

  2. OpenAI Prompting Codex

    官方来源 · https://learn.chatgpt.com/docs/prompting

codex.study 是独立运营的中文 Codex 学习与资料平台,与 OpenAI 不存在隶属、授权或官方认证关系。