📋
🛠️ 工具教程
🛠️ 工具教程入门
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
📖 相关使用指南
⚖️ 工具对比
ChatGPT vs Claude 2026 深度对比:哪个 AI 助手更适合你?
ChatGPT 和 Claude 是当前最热门的两款 AI 对话助手。本文从功能、价格、性能、适用场景等维度进行全面对比,帮你选择最适合的 AI 工具。
Cursor vs GitHub Copilot 2026 对比:AI 编程工具哪个更强?
Cursor 和 GitHub Copilot 是两款最受欢迎的 AI 编程助手。本文从功能、价格、使用体验等维度全面对比,帮你选择最适合的 AI 编程工具。
Claude vs Gemini 2026 对比:Anthropic 与 Google 的 AI 较量
Claude 和 Gemini 分别是 Anthropic 和 Google 的旗舰 AI 产品。本文从功能、价格、适用场景等维度全面对比。
