---
title: "Agent 指令文件：AGENTS.md、CLAUDE.md 等 · DotsAgent"
description: "了解 AGENTS.md、CLAUDE.md、GEMINI.md 以及 Cursor、Copilot、Devin 和 Cline 规则文件的位置、合并方式，以及 9 款编程工具中哪些会读取 AGENTS.md。"
url: https://dotsagent.io/zh/instructions/files
---

指令 · 参考

# Agent 指令文件

每款编程 Agent 在开始工作前，都会加载一个项目文件，读取其中长期有效的指令。以下介绍各工具会查找哪些文件、支持哪些 frontmatter，以及全局、项目级和嵌套文件如何合并。内容已根据厂商文档于 2026-10-01 核实。

## 各工具读取哪些文件

| 工具 | 读取文件 | AGENTS.md |
| --- | --- | --- |
| OpenAI Codex | `AGENTS.md``AGENTS.override.md``~/.codex/AGENTS.md` | 原生支持 |
| Claude Code | `CLAUDE.md``CLAUDE.local.md``.claude/rules/*.md``~/.claude/CLAUDE.md``AGENTS.md` | 原生支持 |
| Cursor | `.cursor/rules/*.mdc``AGENTS.md` | 原生支持 |
| GitHub Copilot | `.github/copilot-instructions.md``.github/instructions/*.instructions.md``AGENTS.md``CLAUDE.md``GEMINI.md` | 原生支持 |
| Gemini CLI | `GEMINI.md``~/.gemini/GEMINI.md``.gemini/settings.json` | 通过配置 |
| Devin Desktop（原 Windsurf） | `.devin/rules/*.md``.windsurf/rules/*.md``.windsurfrules``~/.codeium/windsurf/memories/global_rules.md``AGENTS.md` | 原生支持 |
| Cline | `.clinerules/*.md``.cline/rules/*.md``AGENTS.md``.cursorrules``.windsurfrules` | 原生支持 |
| Aider | `.aider.conf.yml` | 通过配置 |
| OpenClaw | `AGENTS.md``SOUL.md``IDENTITY.md``USER.md``MEMORY.md` | 原生支持 |

将唯一的 AGENTS.md 作为事实来源，并让其他工具引用它。上述九种工具中有七种无需额外配置即可读取它；Gemini CLI 和 Aider 需要添加一行配置，而仅包含 @AGENTS.md 的 CLAUDE.md 可让旧版 Claude Code 保持同步。只有在需要按路径限定规则、而 AGENTS.md 无法表达时，才使用各工具自己的规则格式。

## 所有指令文件

- [AGENTS.md](https://dotsagent.io/zh/instructions/files/agents-md): AGENTS.md 是一个纯 Markdown 格式的项目指令文件，大多数编程 agent 无需额外配置即可读取。OpenAI 已将其贡献给 Linux Foundation 旗下的 Agentic AI Foundation，超过 60k 个开源项目正在使用它。

- [CLAUDE.md (Claude Code)](https://dotsagent.io/zh/instructions/files/claude-md): CLAUDE.md 是 Claude Code 在启动时从主目录、项目目录和所有父目录加载的记忆文件。.claude/rules/ 中按路径限定的规则会提供额外指引，仅在读取匹配的文件时加载。

- [GEMINI.md (Gemini CLI)](https://dotsagent.io/zh/instructions/files/gemini-md): GEMINI.md 是 Gemini CLI 随每个 prompt 一同发送的上下文文件。它也可以读取 AGENTS.md，或通过 context.fileName 设置的其他文件名。

- [Cursor Project Rules (.cursor/rules/*.mdc)](https://dotsagent.io/zh/instructions/files/cursor-rules): Cursor Project Rules 是存放在 .cursor/rules/ 中的 .mdc 文件，其 frontmatter 决定每条规则何时生效。Cursor 也会读取 AGENTS.md，以及在仓库外设置的 User Rules 和 Team Rules。

- [GitHub Copilot custom instructions](https://dotsagent.io/zh/instructions/files/github-copilot-instructions): GitHub Copilot 会读取一个仓库级文件 .github/copilot-instructions.md，以及按路径生效的 .instructions.md 文件。它也会遵循 AGENTS.md，或根目录下单独的 CLAUDE.md 或 GEMINI.md。

- [Devin Desktop (Windsurf) rules](https://dotsagent.io/zh/instructions/files/windsurf-rules): 自 2026-06-02 起，Windsurf 更名为 Devin Desktop。它会从 .devin/rules/ 读取规则文件，同时仍支持 .windsurf/rules/ 和旧版 .windsurfrules。每条规则是否生效取决于其触发方式：始终生效、按 glob 匹配、由模型选择或手动调用。

- [Cline Rules (.clinerules/)](https://dotsagent.io/zh/instructions/files/cline-rules): Cline Rules 是 .clinerules/ 中的 Markdown 文件，Cline 会将其与全局规则和 AGENTS.md 合并。可选的 paths frontmatter 可将规则限制为匹配的文件。

- [OpenClaw workspace bootstrap files](https://dotsagent.io/zh/instructions/files/openclaw-workspace): OpenClaw 根据工作区中的 Markdown 引导文件为每个 agent 构建上下文，其中必需的 AGENTS.md 是核心文件。每个新会话的第一轮中，这些文件都会注入 system prompt。

为 AI agent 开发者提供的独立参考资料。与此处提及的任何厂商均无关联。

© 2026 DotsAgent · 事实核查日期：2026年10月1日