欢迎来到 Codex 快速上手。本篇不要求你会复杂的命令,只带你完成一件事:让 Codex 理解一个项目,并协助完成一个可验证的小任务。

你会完成什么
- 登录 Codex 并打开一个项目目录。
- 理解为什么项目说明和已有代码比一句模糊需求更重要。
- 用“目标、范围、约束、验证”描述一个小任务。
- 检查修改结果,而不是只看一段回答。
1. 选择一个合适的项目
第一次练习请使用一个可以安全修改的测试项目,或创建一个小型示例目录。不要直接让 Codex 在生产仓库中批量重构、删除文件或发布内容。打开项目后,先让它阅读目录结构、依赖文件和项目说明。
请先查看这个项目的目录结构、依赖和已有说明。
暂时不要修改文件,告诉我建议的开发与验证命令。这样可以让后续操作遵循项目已有的框架、测试和格式约定。
2. 用清晰的方式描述任务
高质量的请求应该包含四部分:
- 目标:要解决什么问题。
- 范围:允许修改哪些模块或文件。
- 约束:哪些内容不能改变,例如接口格式、数据库或依赖。
- 验证:如何确认任务完成,例如运行测试和构建。
目标:为页面标题增加字数提示。
范围:只修改编辑页组件和相关测试。
约束:不改变现有提交接口,不新增依赖。
验证:运行相关测试,并说明结果。3. 先查看,再执行
当任务影响范围不明确时,先让 Codex 给出实施计划和预计改动文件。确认无误后再要求执行。对于删除数据、修改权限、发布内容或调用外部服务的操作,必须明确授权。
4. 验证结果
完成后不要只看文字说明。检查修改的文件、运行测试或构建,并询问是否存在未覆盖的风险。一个最小验收清单如下:
- 目标功能是否按预期工作。
- 相关测试、构建或静态检查是否通过。
- 是否改动了任务范围以外的文件。
- 是否有需要人工复核的配置、权限或发布动作。
下一篇
下一篇将安装 Codex CLI,并处理 Windows 中常见的 Node.js、npm 和 PowerShell 问题。