---
title: "记清 AGENTS.md 的发现顺序"
summary: "全局一份，再从 Git 根走到 cwd。每一层优先 override，后出现的更具体规则覆盖前面的。"
category: agents-md
level: intermediate
surfaces: [cli, app, ide]
tags: ["发现顺序", "override", "优先级"]
canonical: /tips/agents-discovery-order/
---

# 记清 AGENTS.md 的发现顺序

全局一份，再从 Git 根走到 cwd。每一层优先 override，后出现的更具体规则覆盖前面的。

每次启动（TUI 通常是每个会话一次）重建指令链：

1. **全局**：`$CODEX_HOME/AGENTS.override.md`，否则 `AGENTS.md`。这一层只取第一份非空文件。
2. **项目**：从项目根（通常是 Git 根）走到当前目录。每一层按 `AGENTS.override.md` → `AGENTS.md` → fallback 文件名查找，**每层最多一份**。
3. **合并**：从根拼到 cwd，靠近当前目录的文件更靠后，因此覆盖更通用的规则。

空文件会被跳过。合并大小达到 `project_doc_max_bytes`（默认 32 KiB）就停止追加。

验证：

```bash
codex --ask-for-approval never "列出你加载的指令来源，并按优先级复述规则。"
```

改完文件要新开会话。运行中的会话不会持续重扫。

## 来源

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