.cursorrules vs CLAUDE.md vs AGENTS.md：你需要哪种 AI 编码规则文件？

每个 AI 编码工具都想要一个包含你项目规则的 Markdown 文件。但它们都想要不同的 Markdown 文件。

如果你同时使用多种 AI 工具（大多数开发者都是这样），这会很快令人困惑。以下是确定你需要哪些文件以及每个文件放什么内容的权威指南。

文件概览

文件	工具	位置	范围
AGENTS.md	通用（所有工具）	项目根目录	所有 AI 代理的共享规则
CLAUDE.md	Claude Code	项目根目录	Claude 专用指令
.cursor/rules/*.md	Cursor	.cursor/rules/ 目录	Cursor 专用规则
.github/copilot-instructions.md	GitHub Copilot	.github/ 目录	Copilot 专用指令
.windsurf/rules	Windsurf	.windsurf/ 目录	Windsurf 专用规则
JULES.md	Google Jules	项目根目录	Jules 专用指令

AGENTS.md：通用标准

最适合： 使用多种 AI 工具的团队、开源项目

AGENTS.md 是我们拥有的最接近通用标准的文件。它现在被超过 60,000 个代码库使用，由 Linux 基金会的 Agentic AI Foundation 负责管理（与 MCP 和 goose 一起）。

将共享指令放在这里——每个 AI 工具都应该知道的内容：

• 项目结构和架构
• 构建和测试命令
• 代码风格约定
• 常见模式和反模式
• 依赖项和设置步骤

每个主要的 AI 编码工具都会读取 AGENTS.md，使其成为项目 AI 指令的唯一真实来源。

CLAUDE.md：Claude Code 的记忆

最适合： Claude Code 用户、基于 Anthropic 的标准化团队

CLAUDE.md 在每次 Claude Code 会话开始时自动读取。它支持一些 Claude 专用功能，如记忆持久化和会话上下文。

在 CLAUDE.md 中使用：

• Claude 专用行为调整
• 只有 Claude Code 支持的功能
• 覆盖或扩展 Claude 的 AGENTS.md

推荐模式：共享规则放在 AGENTS.md，Claude 专用补充放在 CLAUDE.md。

.cursorrules / .cursor/rules/：Cursor 的方式

最适合： Cursor 用户、以 Cursor 为主要 IDE 的团队

Cursor 最初使用单个 .cursorrules 文件，后来演变为 .cursor/rules/ 目录以实现更精细的控制。目录中的每个文件都是 Cursor 应用的单独规则。

在 Cursor 规则中使用：

• Cursor 专用代理行为
• Cursor 的 Composer 和 Agent 模式规则
• 特定文件类型的指令（例如 .tsx 与 .py 的不同规则）

copilot-instructions.md：GitHub 的约定

最适合： GitHub Copilot 用户、以 GitHub 为中心的工作流程

GitHub Copilot 读取 .github/copilot-instructions.md 获取项目级指令。它遵循 GitHub 将配置放在 .github/ 目录的约定。

推荐设置

对于大多数项目，你最多需要两个文件：

如果你使用一种 AI 工具：

只使用该工具的原生文件（Claude Code 使用 CLAUDE.md，Cursor 使用 .cursor/rules/ 等）。

如果你使用多种 AI 工具：

1. AGENTS.md — 所有共享规则（架构、构建命令、约定）
2. 工具特定文件 — 仅适用于该工具独有功能

示例结构：

your-project/
  AGENTS.md              # 共享：构建命令、架构、约定
  CLAUDE.md              # Claude 专用：记忆偏好、工具使用
  .cursor/rules/style.md # Cursor 专用：composer 行为
  .github/copilot-instructions.md  # Copilot 专用

规则文件中应包含什么

根据对数千个代码库的分析，最有效的指令文件包含：

始终包含：

• 如何构建和运行项目
• 如何运行测试
• 关键架构决策
• 代码风格偏好

通常有用：

• 不应该做什么（否定指令效果出奇地好）
• 文件结构说明
• 常见调试步骤
• 依赖管理命令

跳过：

• 显而易见的语言功能
• AI 已经知道的内容
• 过于详细的规则（从最小化开始，按需添加）

用网络上下文构建你的 AI 规则

编写好的 AI 指令文件通常需要引用外部文档、风格指南或架构模式。这就是以 Markdown 格式获取网络内容有所帮助的地方。

例如，如果你的项目遵循文档页面中的特定 API 模式，你可以：

1. 使用 Save 将该文档页面转换为 Markdown
2. 在 AGENTS.md 中引用或摘录相关部分
3. 你的 AI 编码助手现在拥有完整上下文

同样适用于框架文档、风格指南、最佳实践文章和 Stack Overflow 解决方案。干净的 Markdown 是你和你的 AI 工具都能最有效使用的格式。

结论

AI 编码规则生态系统仍在演变，但规律很清晰：一切都是 Markdown。无论你使用一种工具还是五种，你项目的 AI 指令都存在于版本控制、人类可读、机器可解析的 Markdown 文件中。

从 AGENTS.md 开始设置通用规则，按需添加工具特定文件，并保持一切最小化，直到你看到值得解决的重复问题。

---

Save 将任何网页转换为干净的 Markdown——非常适合构建你的 AI 编码助手所需的参考材料和文档上下文。免费试用 Save。