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 条踩坑排查表。