核心主题 OpenAI 的 Codex CLI 工具通过 `AGENTS.md` 文件机制,为 AI 编程助手提供持久化的项目级自定义指令。 关键要点 1. **三层指令发现机制**:Codex 启动时按优先级加载指令——全局(`~/.codex/`)→ 项目根目录 → 当前工作目录,越靠近当前目录的指令优先级越高。 2. **覆盖机制**:同目录下 `AGENTS.override.md` 优先于 `AGENTS.md`,适合临时规则或团队级定制,无需修改基础配置。 3. **备选文件名**:通过 `project_doc_fallback_filenames` 配置,可以将已有的 `TEAM_GUIDE.md` 等文件纳入指令发现范围。 4. **容量控制**:默认合并上限 32 KiB(可通过 `project_doc_max_bytes` 调整),超出部分会被截断,建议按目录拆分大型指令文件。 5. **配置隔离**:`CODEX_HOME` 环境变量支持不同项目使用不同的全局配置档案,适合自动化场景。 #Codex #Openai #AI编程 #AI助手 #ClaudeCode #Cursor