Codex 读不到项目上下文，最常见原因不是它“不懂项目”，而是启动目录不对、仓库没打开、忽略文件挡住了关键内容，或项目缺少说明。先让它确认当前工作目录和可见文件，再谈改代码。
先检查是不是进错目录
很多人会在上级目录、空目录、下载目录里启动 Codex，然后问它为什么找不到页面。正确做法是进入项目根目录，也就是能看到 package.json、pnpm-lock.yaml、README、src 等文件的位置。多仓库项目还要说明具体子项目。
让 Codex 自检上下文
你可以发：“请先列出当前目录、项目类型、主要入口文件、可用测试命令；不要改文件。”如果它列不出来，说明上下文确实没拿到，继续让它改只会增加风险。
补一个 AGENTS.md
AGENTS.md 可以写项目规则，例如常用命令、代码风格、UI 禁忌、测试方式、发布限制。对 Codex 来说，它像项目里的工作说明书。尤其是“不要使用原生弹窗”“删除前先备份”这类团队习惯，写进去比每次口头提醒可靠。
检查忽略文件和大文件
- 确认关键源码没有被 .gitignore、.cursorignore 或类似规则排除。
- 不要让 Codex 一次读取巨大的日志、构建产物和压缩包。
- 把需求相关文件路径直接告诉它，减少无效搜索。
上下文太大怎么办
大型项目里，Codex 不一定需要读完整仓库。你可以让它先定位相关模块，再只围绕这几个文件工作。任务越具体，上下文越干净，回答越稳定。
如果 Codex 总是答非所问，先别换模型，先排查它看到的项目是不是你以为的项目。目录、说明文件、测试命令和禁区规则这四项齐了，大多数上下文问题都会明显缓解。
