AI 知识库

AGENTS.md

3分钟阅读

AGENTS.md

一句话

AI 编码代理的「项目说明书」标准——README 是给人看的，AGENTS.md 是给 Agent 看的。纯 Markdown，无必填字段，6 万+ 开源项目在用。

基本事实

项目事实
推出方OpenAI（2025 年 8 月），Anthropic 跟进
治理Agentic AI Foundation（AAIF），挂靠 Linux Foundation
采用量6 万+ 开源项目
格式纯 Markdown，无任何必填字段，标题随意
官网https://agents.md/
参考实现OpenAI 主仓有 88 个 AGENTS.md（大型 monorepo 嵌套用）

⚠️ Claude Code 支持：官方文档自相矛盾（2026-10-02 核实）

来源说法
memory 文档至今仍写「Claude Code reads CLAUDE.md, not AGENTS.md」
v2.1.277 更新日志明确写「Added AGENTS.md support」：项目中无 CLAUDE.md 时直接读 AGENTS.md，可在 /config 的 Project instructions 切换

结论：以 changelog 为准，Claude Code 已原生支持。 但要注意：

  • Bedrock / Vertex / Foundry 三个云版本暂不支持
  • 2.1.213+ 的 /import 会把 AGENTS.md 一次性复制进 CLAUDE.md（旧做法）
  • agents.md 官网的支持列表至今仍未收录 Claude Code——所以查官网会得到过时结论

三条实用规则

  1. 大仓用嵌套 AGENTS.md——离被改文件最近的那份优先
  2. 规则冲突时：就近的 AGENTS.md 赢，用户在对话里的明确指令赢一切
  3. 官方建议控制在 200 行以内，避免挤占上下文

各工具配置方式

工具配置
Codex、Cursor、Gemini CLI、VS Code、Copilot、Warp、Junie、opencode、goose、Aider、Devin、Windsurf、Factory、Amp、Kilo、Roo、Zed、Semgrep、Jules、Augment 等开箱即读，无需配置
Claude Codev2.1.277 起原生支持（三个云版本除外）
Aider.aider.conf.yml 加 read: AGENTS.md
Gemini CLI.gemini/settings.json 加 {"context": {"fileName": "AGENTS.md"}}

迁移旧文件：mv AGENT.md AGENTS.md && ln -s AGENTS.md AGENT.md

与我们的关系

  • 本机的 开发规范-通用底稿 就是一份 AGENTS.md，用法是复制到项目根目录改名 AGENTS.md
  • Agent Skills 生态 记的是技能库，AGENTS.md 记的是项目规矩文件——两者互补
  • Pi Coding Agent 的 AGENTS.md 加载路径：~/.pi/agent/ → 父目录 → 当前目录

相关笔记

相关日记

  • 2026-09-18 - 首次盘点时认知有误
  • 2026-10-02 - 核实：更正 Claude Code 支持状态（v2.1.277 起原生支持），建独立笔记