Codex 读大型仓库很慢，别一上来就让它“分析整个项目”

几十万文件的 monorepo 不适合一上来全量分析。node_modules、dist、vendor、生成文件会浪费上下文。更高效的策略是先做项目地图，再从需求入口沿调用链深入。

一、为什么会出现这个问题

• Codex 当前工作目录、仓库范围或项目规则不明确。
• 一次任务给得太大，导致读取上下文、修改文件和运行命令的范围失控。
• AGENTS.md、Git 状态、测试命令和危险操作边界没有提前定义。
• CLI、Node.js、终端环境变量或第三方兼容层与预期不一致。

二、推荐的排查顺序

1. 先确认工作目录和 Git

每次启动任务前执行 pwd、git status、git remote -v。先知道自己在哪里、工作区是否干净，再让 Agent 动手。

2. 把任务边界写清楚

明确允许修改哪些目录、禁止修改什么、测试命令是什么、怎样算完成。比“帮我优化一下”有效得多。

3. 先 Plan 再 Edit

大型任务先让 Codex 列出涉及文件和计划，再进入修改。任务中途也要看 diff，避免最后一次性出现几十个无关改动。

三、可以直接复制的排查示例

find . -maxdepth 2 -type f   \( -name 'README*' -o -name go.mod -o -name package.json -o -name pyproject.toml \)   | sort

git ls-files | head -n 200

四、使用建议

先问 Codex“这个需求最可能涉及哪 5 个文件”，通常比让它先读 500 个文件更省 Token。