财π新闻 2026年9月19日，Claude Code核心工程师Thariq正式对外宣布，从当日上线的2.1.277版本起，Claude Code正式新增对AGENTS.md格式的接入支持。按照新版本的运行逻辑，当项目文件夹中不存在Claude Code专属的CLAUDE.md文件时，系统将自动识别并读取AGENTS.md文件作为项目说明书，同时这一默认运行行为完全开放给开发者，可通过config设置界面自主切换开启或关闭状态。这一更新的落地，直接解决了困扰开发者长达一年多的行业共性痛点，此前开发者在多AI编程工具并行使用的场景下，不得不维护两套内容高度重复的规则文件，如今无需再使用软链接、手动导入等各类妥协性的临时方案，即可实现不同AI编程工具对同一套项目规则的统一识别。

在本次AGENTS.md支持更新的背后，Claude Code团队同步推出了全新的定制机制Claude Code mods，对AGENTS.md的接入支持正是通过这一全新机制实现，也是该机制上线后首个面向所有用户开放的内置mod。从功能定位来看，mods相当于为Claude Code引入了一套完整的插件系统，彻底打破了以往Claude Code的运行规则仅由Anthropic单方面决定的局限，允许开发者根据自身项目的实际需求，灵活定制项目说明文件的读取方式、运行逻辑和适配规则，这一变化也标志着编程智能体的运行框架正逐步从完全封闭的黑箱模式，走向支持开发者自主改装的开放模式。

作为本次更新核心支持的通用格式，AGENTS.md是OpenAI于2025年8月正式推出的面向AI编程智能体的通用项目说明格式，推出后短时间内就获得了Codex、Cursor、GitHub Copilot等主流AI编程工具的广泛采用，截至本次Claude Code更新发布时，全球范围内已有超过六万个开源项目在日常开发流程中使用AGENTS.md管理项目规则。2025年12月，OpenAI正式将AGENTS.md格式相关的全部资产捐献给Linux基金会，将其纳入行业开放标准体系进行统一维护和迭代，进一步巩固了其作为跨厂商通用项目说明格式的地位。

在本次更新正式落地之前，Claude Code长期坚持仅读取自家专属的CLAUDE.md文件作为项目说明，这一封闭策略在开发者社区引发了持续的争议，Shopify CEO曾公开表态考虑在内部开发流程中全面禁用Claude Code工具，而在Claude Code的官方GitHub仓库中，一条发布于2025年8月的“请支持AGENTS.md”功能请求Issue，在长达十三个月的时间里累计获得了超过5200个点赞、300多条开发者留言，是整个Claude Code仓库中票数最高的功能请求，得票数量高出第二名四倍，充分体现了全球开发者社区对这一功能的迫切需求。

从两类项目说明文件的定位差异来看，CLAUDE.md是Claude Code专属的配置载体，主要用于定义仅适用于Claude Code的工作流、MCP协议配置、子智能体调度规则以及自定义命令等专属功能；而AGENTS.md的核心设计目标，是为所有不同厂商的AI编程工具提供一套可以共享的项目级基础规则，相当于所有接入项目的AI编程智能体都应当共同遵守的通用约定。对于普通开发者和开发团队而言，这一更新带来的最直接变化，是大幅降低了跨工具使用的配置成本，无论开发者日常切换使用哪一款AI编程工具，整个项目都只需要维护一份统一的“给AI看的使用说明”，在更换开发工具、接手陌生项目或者参与开源社区协作的场景下，无需反复重新配置项目规则，避免了大量重复的机械性工作。

在本次更新的2.1.277版本官方GitHub更新记录中，第一行内容就明确标注了对AGENTS.md的支持调整，Thariq在社交平台X上发布的相关公告帖文，上线后仅一个小时浏览量就突破了百万，引发了全球AI开发社区的广泛关注。消息发布后，Codex团队负责人Tibo第一时间在相关内容下留言表达认可，这一行业标志性的更新，也让Claude Code成为了首批正式加入跨厂商项目指令标准体系的主流AI编程工具之一。

此前的一年多时间里，大量同时使用多款AI编程工具的开发团队，长期被两套项目说明文件的维护问题困扰，同一个项目中不同开发者分别使用Claude Code、Codex、Cursor等不同工具时，团队不得不准备两份几乎完全一致的项目说明文件，一旦其中一份文件的内容更新而另一份没有同步修改，不同的AI编程工具就会按照过期的规则生成代码，最终产出的代码风格、编译逻辑、测试流程完全不符合团队统一的开发规范，给后续的代码合并和维护带来大量额外问题。为了应对这一痛点，开发者们自发摸索出了各类临时解决方案，有的开发者将CLAUDE.md通过软链接的方式直接关联到AGENTS.md，有的开发者在CLAUDE.md文件中写入专门的导入语句直接引用AGENTS.md的内容，还有的开发者在AI编程工具的启动环节设置自定义钩子，每次开启新的AI对话前自动把AGENTS.md的全部内容打印出来传递给Claude Code，这些非官方的临时方案不仅操作繁琐，还经常出现各类兼容性问题，开发者不得不花费大量时间处理AI编程工具之间的说明书兼容问题，这一略显荒诞的行业场景持续了整整一年多的时间。

随着本次2.1.277版本的正式上线，此前开发者摸索出的各类临时兼容方案都可以正式停用，任何已经提前配置好AGENTS.md文件的代码仓库，不需要额外添加CLAUDE.md文件，不需要手动写入导入语句，也不需要修改任何默认设置，直接打开Claude Code就可以正常识别并读取项目的全部通用规则，完全实现了开箱即用的流畅体验。而Claude Code推出的全新mods机制，也为后续开发者的自定义需求留下了充足的扩展空间，开发者可以基于开放的mods框架，围绕项目指令的读取逻辑开发更多自定义功能，完全打破此前Anthropic单方面定义所有运行规则的封闭状态，让编程智能体的运行框架真正向开发者开放，适配不同项目的个性化开发需求。

值得注意的是，此前AGENTS.md被捐献给Linux基金会旗下新成立的智能体AI基金会（AAIF）时，Anthropic本身就是该基金会的铂金会员，同时Anthropic也将自家的MCP协议捐献给了该基金会，两家厂商同属同一个开放标准基金会的成员，却在长达十三个月的时间里，旗下最主流的AI编程工具始终不支持对方推出的通用项目说明格式，这一略显别扭的行业状态，直到本次2.1.277版本更新发布后才正式宣告结束。对于已经长期采用AGENTS.md管理项目规则的开发团队而言，本次Claude Code的更新，直接大幅降低了团队引入Claude Code工具的集成成本，不需要对现有项目的规则体系做任何调整，就可以直接将Claude Code纳入团队的日常开发流程中，不同AI编程智能体之间的跨工具协作顺畅度得到了质的提升。

按照新版本的默认运行逻辑，当项目文件夹中同时存在CLAUDE.md和AGENTS.md两份文件时，Claude Code仍然会优先读取专属的CLAUDE.md文件，只有在完全找不到CLAUDE.md以及CLAUDE.local.md文件的前提下，才会自动切换读取AGENTS.md文件，这一优先级设置也充分兼顾了老用户的使用习惯，此前已经基于CLAUDE.md搭建了完整专属工作流的项目，不会因为本次更新受到任何影响，所有原有配置都可以正常运行，同时又为新用户和开源项目提供了支持通用格式的选项，实现了新旧使用场景的平滑过渡。

(编辑：徐松丽)