Codex 和普通聊天 AI 最大的差别在于它可以先读项目，再基于真实结构做判断。很多任务能不能做稳，关键在于：你有没有先让它读懂当前项目。
> 前置教程：第一次让 Codex 阅读项目
> 依据来源：OpenAI Codex 官方手册中关于 read codebase、任务上下文、只读分析和最小风险工作流的说明。
为什么必须先读项目？
- 自动寻找入口。
- 自动判断相关文件。
- 自动缩小影响范围。
- 识别潜在风险点。
哪些任务强烈建议先读？
- 修真实 Bug。
- 新增功能/改已有页面。
- 修改接口逻辑。
- 排查构建失败。
- 处理复杂或不熟悉的仓库。
最推荐的“第一句”提示词
``markdown
请先只读分析当前项目，不要修改文件。
我这次的目标是：【描述目标，如“修复首页按钮无响应”】。
请优先告诉我：
- 这个问题最可能涉及哪些文件。
- 你判断的技术栈及依据：
- 列出文件 1, 2, 3...
- 你觉得问题最可能在哪：
- 列出不确定内容：
- 你建议下一步做什么：
- 它说清楚了判断依据。
2. 你为什么这么判断。
3. 哪些地方你还不确定。
4. 如果要继续动手，你建议先做什么。
`
结构化输出建议
为了防止 Codex 输出长篇大论却无法直接干活，建议要求它按格式输出：
`markdown
技术栈判断
相关文件
目前判断
不确定项
下一步建议
`
如何验收“读懂了”？
2. 提到的文件在项目中真实存在。
3. 主动承认了不确定项。
4. 下一步建议合理且收敛。
小贴士
即使你已知文件位置，也建议让 Codex 聚焦读取：
`
我怀疑问题在首页相关文件。请先只读分析首页相关实现，不要修改文件。
``
这能给它一个更好的搜索起点。
建议接着看：一次 Codex 任务的完整闭环。