Codex 编程实战

想让 Codex 帮你理解一个陌生仓库、修复 Bug，或者补上一组测试？这个专题从第一次代码任务讲起，逐步介绍项目规则、配置、工具连接和自动化。

你不必先学完所有功能。选一个熟悉的小项目，跟着教程完成一次修改，再根据遇到的问题继续深入。

第一次使用

从快速开始安装并登录 Codex CLI，在项目目录中说明要做什么。可以先请它解释代码，再尝试修改一个函数或补充测试。完成后查看代码差异，运行项目原有的检查。

首次使用时，优先选择你能判断结果的小任务。项目中已有的未提交修改要先保留清楚，避免把不同工作的变更混在一起。

让 Codex 更懂你的项目

• AGENTS.md 项目规则：写清目录结构、代码习惯和测试命令，减少每次重复说明。
• 配置与优先级：了解用户配置、项目配置与命令行参数如何共同生效。
• 沙箱与审批：弄清文件、网络与命令权限，处理运行时的限制和确认请求。

如果 Codex 一直忽略某条约定，先确认规则文件是否位于正确目录，以及当前项目实际读取了哪份配置。

把常用方法和工具接进来

遇到问题时

规则没生效、命令失败、工具未出现，或者改动比预期多，可以从Codex 排障指南按现象查找。保留出错命令和简短错误信息，通常比反复改一整套配置更容易定位问题。

想把需求说得更清楚，也可以参考任务说明示例。