---
title: "AGENTS.override.md 不要提交"
summary: "同层存在 override 时，普通 AGENTS.md 会被忽略。把它留给本机或临时实验，并加入 gitignore。"
category: agents-md
level: intermediate
surfaces: [cli]
tags: ["override", "gitignore", "排错"]
canonical: /tips/override-not-committed/
---

# AGENTS.override.md 不要提交

同层存在 override 时，普通 AGENTS.md 会被忽略。把它留给本机或临时实验，并加入 gitignore。

典型分工：

- **提交**：仓库根 `AGENTS.md`，以及各包/服务目录里真正共享的规则
- **不提交**：`AGENTS.override.md` 和 `**/AGENTS.override.md`

Override 适合：

- 你正在试一条还没达成共识的规则
- 某台机器的路径、密钥管理方式和别人不同
- 临时禁用某条全局习惯

指导「看起来错了」时，先查上层或 `~/.codex` 里是不是留着一份 override。

## 来源

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