首页教程中心AGENTS.md / CLAUDE.md 配置指南:让 AI 编程助手记住你的项目规范
📋
🛠️ 工具教程
🛠️ 工具教程入门

AGENTS.md / CLAUDE.md 配置指南:让 AI 编程助手记住你的项目规范

2026 年 9 月 Claude Code 正式支持 AGENTS.md 标准配置文件,一次配置让所有 AI 编程工具(Claude Code / Cursor / Codex)统一遵守项目规范。本教程带你写出高质量的配置文件,告别每次重述规则的烦恼。

12 分钟 5 个步骤2026-09-28
分享:

1理解 AGENTS.md 与 CLAUDE.md 的关系

先搞清楚这两者的区别: **CLAUDE.md(传统方案)** - Claude Code 专属配置文件,放在项目根目录 - 其他工具(Cursor、Codex)默认不读取 CLAUDE.md - 格式自由,没有统一规范 **AGENTS.md(2026 年 9 月新标准)** - 开源标准,被 Claude Code、Codex、Cursor 等多个工具支持 - 放在项目根目录,所有兼容工具自动识别 - 有推荐的结构化格式,覆盖项目规范、编码风格、环境说明 **Claude Code 的读取优先级:** 项目根目录下的 CLAUDE.md > AGENTS.md > 无配置文件 💡 如果你主要使用 Claude Code,继续用 CLAUDE.md 即可;如果希望多工具兼容(Claude Code + Cursor + Codex),推荐使用 AGENTS.md。

小贴士

  • 🎯 配置文件的前三行最重要——AI 首次读取时最先看到的内容决定它对你项目的「第一印象」。把最重要的约束写最前面
  • 📝 用「必须/禁止/一律」等明确词汇比「建议/尽量」更有效——AI 对模糊指令的遵守率远低于硬性要求
  • 🔄 每 2-4 周审查一次配置文件。随着项目演进,旧的规范可能不再适用,新的约定需要加入——让配置文件跟着项目成长
  • 📂 大型项目可以拆成多个配置文件:项目根目录的 AGENTS.md(通用规范)+ 各子目录的 .claude.md(模块专属规则)
1 / 5

全部步骤

返回教程中心