Claude Code 支持 AGENTS.md：编程智能体走向统一标准

Claude Code 拥抱 AGENTS.md 通用标准

Anthropic 团队成员 Thariq Shihipar 宣布，Claude Code 从 2.1.277 版本开始正式支持 AGENTS.md 文件。这意味着当某个文件夹中不存在 CLAUDE.md 时，Claude 会自动查找并使用 AGENTS.md 作为项目指令来源。

对于长期在多种编程智能体之间切换的开发者来说，这是一个值得关注的信号。AGENTS.md 并非 Anthropic 独有的格式，而是一个正在被多家工具逐渐采用的开放约定——用一个统一的 Markdown 文件向 AI 编程助手传达项目背景、编码规范、构建指令等上下文信息。Claude Code 主动兼容这一格式，实际上是在降低生态碎片化带来的迁移成本。

为什么“项目指令文件”越来越重要

当下的编程智能体（coding agents）能力越来越强，但它们的表现高度依赖于对项目上下文的理解。一个缺乏说明的代码库，往往会让智能体做出不符合团队约定的改动；而一份清晰的项目指令文件，可以显著提升生成结果的可用性。

此前，Claude Code 使用的是专属的 CLAUDE.md，其他工具则各有各的文件命名。开发者若同时使用多个 AI 编程工具，就不得不维护多份内容高度重复的说明文档。AGENTS.md 的出现，正是为了解决这种“一个项目、多份指令”的重复劳动。

Claude Code 的兼容策略也颇为务实：优先读取 CLAUDE.md，在其缺失时退回到 AGENTS.md。这种向后兼容的设计既保护了既有用户的配置，又向通用标准敞开了大门。

背后的技术载体：Claude Code Mods

此次 AGENTS.md 支持并不是简单地写死在主程序里，而是构建在 Claude Code 即将推出的定制机制 mods 之上。据 Thariq Shihipar 介绍，AGENTS.md 是一个“内置 mod”，其源码已在 GitHub 公开。

mods 被描述为“定制 Claude Code harness（框架）的方式”。换句话说，Anthropic 正在把 Claude Code 的行为逻辑模块化，让功能以可插拔的形式存在。官方还表示，开发者未来可以自行构建自定义版本的项目指令处理方式，而不必局限于内置行为。

这一点意义不小。它意味着 Claude Code 正从一个封闭的命令行工具，逐步演化为一个具备扩展能力的平台。将 AGENTS.md 支持作为首批公开的 mod 之一，既是功能落地，也是对 mods 机制的一次实战展示。

mods（模组）机制本质上是一种插件化架构，允许将原本硬编码在主程序中的行为抽象为独立的、可替换的功能单元。在软件工程中，这类设计通常被称为"钩子（hook）"或"中间件（middleware）"模式——核心运行时负责调度，具体行为由外部模块决定。对于 Claude Code 而言，mods 意味着文件读取策略、上下文解析逻辑乃至工作流触发规则，都可以脱离主程序版本更新而独立迭代。将 AGENTS.md 支持实现为一个开源的内置 mod，而非写死在核心代码里，也意味着社区可以 fork 这份实现、修改解析规则，或者参照其结构开发全新的上下文处理逻辑，而不必等待官方版本发布。

对开发者与生态意味着什么

从生态角度看，主流编程智能体向 AGENTS.md 收敛，是一件对开发者有利的事。统一的上下文文件格式让项目在不同 AI 工具之间的可移植性大幅提高——同一份指令文件既能被 Claude Code 读取，也可能被其他兼容工具直接复用。

对个人开发者而言，短期内的行动很简单：升级到 2.1.277 或更高版本，即可享受这一兼容性。如果项目已有 AGENTS.md，无需额外配置即可被 Claude 识别；如果同时保留 CLAUDE.md，则前者仍会被优先使用。

而对更长远的趋势判断则更有价值。mods 机制一旦全面开放，社区可能会围绕 Claude Code 形成一批第三方定制方案，从指令解析到工作流集成，扩展空间相当可观。开放源码与内置示例的组合，也降低了社区参与的门槛。

小结

一个看似不起眼的版本更新，透露出两条清晰的方向：一是编程智能体正在走向上下文标准的统一，AGENTS.md 有望成为跨工具的通用约定；二是 Claude Code 正通过 mods 机制向可扩展平台转型。对于依赖 AI 辅助编程的团队来说，及早了解并采用这类通用标准，将在工具切换与协作中带来实实在在的便利。

背景补充

AGENTS.md 这一约定最初由 OpenAI 的 Codex/ChatGPT 生态推广，随后被 Cursor、Windsurf 等编程智能体工具陆续采纳。其核心思路与 .editorconfig（统一编辑器格式配置）或 .github/CODEOWNERS（代码所有权声明）类似：用一个放置在版本库根目录的纯文本文件，向所有参与项目的工具和人员传达约定，而无需每个工具单独配置。典型的 AGENTS.md 内容包括：项目架构概述、禁止修改的核心文件列表、测试运行命令、代码风格约定，以及智能体在做出变更前需遵循的审批流程。将这些信息纳入版本控制，既保证了团队协作时的一致性，也让新接入的 AI 工具能在无需人工介绍的情况下快速"读懂"项目。