Claude Code 终于原生支持 AGENTS.md,告别 CLAUDE.md 双文件时代
量子位 · wechat · 2026-09-20
9 月 19 日起，Claude Code 原生支持 OpenAI 推出的 AGENTS.md 项目指令文件格式，成为最后一个兼容它的主流 AI 编程工具。
背景:AGENTS.md 是写 Repo 根目录、给 AI 编程助手读的标准化 Markdown 指令文件，2025 年 12 月已被 OpenAI 捐给 Linux 基金会旗下 Agentic AI Foundation。抽样调查显示 6.2% 的 GitHub 活跃仓库包含 AGENTS.md，CLAUDE.md 为 5.4%，大量团队被迫同时维护两份 90% 重合的文件，稍不同步就导致不同 agent 给出矛盾建议。社区曾发明符号链接（Windows 上坑很多）和 @导入等变通方案。
实现方式:2.1.277 版本采用回退机制——默认模式 "claude-md-or-agents-md" 只在项目中不存在任何 CLAUDE.md（哪怕空文件）时才读取 AGENTS.md；还可在 /config 中切换只读其一、双读、或只读组织级指令三种模式。整个功能以内置插件（Mod）实现，Mod 是 Claude Code 9 月新推的插件系统，可监听会话启动、上下文构建、工具调用等生命周期事件。
遗留差异:AGENTS.md 的嵌套文件只在文本 Read 时触发、/memory 和 快捷键不识别、--add-dir 目录不加载其中的 AGENTS.md、@导入授权需借 CLAUDE.md 通道等，均因插件事件体系尚未覆盖。
所属事件:Claude Code v2.1.277 起支持 AGENTS.md 标准(33 条相关)→
「编程与Agent」频道最新
- 「evals 就是模糊的单元测试」:AI Engineer 大会 eval 演讲获同行推荐 — TejasKumar_ · 2026-11-04
- 文档抽取过了 POC 之后怎么落地？Reddit 求真实生产管线经验 — Mission-Leave-6551 · 2026-11-04
- LLM-as-judge 该怎么报置信度？开发者拒绝 0-100 分的三条理由 — jokiruiz · 2026-11-04
- Claude Code 做 CAD:开源 SOMA 用户破千,9 分钟设计书架出施工图 — Pr8tham · 2026-11-04
- 周处理百万条消息,AI agent 生产环境降本 37% 的 13 条实操 — AccBalanced · 2026-11-04
- 编码工具 rex 每两小时弹一次更新，作者感叹像 Cursor 早期节奏 — sumitdotml · 2026-11-04