---
title: "指导错了，先查 override"
summary: "同层的 AGENTS.override.md 会让普通文件被忽略。全局家目录里也常藏着一份。"
category: debug
level: intermediate
surfaces: [cli]
tags: ["override", "排错", "发现"]
canonical: /tips/wrong-guidance/
---

# 指导错了，先查 override

同层的 AGENTS.override.md 会让普通文件被忽略。全局家目录里也常藏着一份。

排查顺序：

1. `echo $CODEX_HOME`
2. 找 `AGENTS.override.md`（家目录和仓库树）
3. 确认 `codex status` 里的工作区根
4. 文件是不是空的（空文件会被跳过）
5. 项目是否受信任
6. fallback 文件名是否出现在 `project_doc_fallback_filenames`
7. 是否撞上 32 KiB 上限

改完配置要新开进程。

## 来源

- [OpenAI · AGENTS.md](https://developers.openai.com/codex/guides/agents-md)