#Codex

AGENTS.md 统一配置实战：一份文件同时驱动 Claude Code / Codex / Cursor / Trae

2026 年 9 月，Claude Code 2.1.277 开始在没有 CLAUDE.md 时自动回退读取 AGENTS.md——这是 OpenAI 捐给 Agentic AI Foundation 的规范，目前已有 6 万多个开源项目在用。这意味着一件事：你不再需要为每个 AI 编程工具各写一份配置。本文讲透 AGENTS.md：规范字段全解、四个客户端（Claude Code / Codex / Cursor / Trae）的兼容矩阵与优先级规则、从 CLAUDE.md 平滑迁移的 5 步法、分层配置（根目录 + 子目录就近覆盖）、10 个可直接抄的实战片段（编码规范 / 测试要求 / 禁区声明 / 命令清单 / 架构速览）、真实项目的完整范本、以及 18 条踩坑排查表。