Claude Code 2.1.277 终于读 AGENTS.md 怎么配
2026 年 9 月 18 日 Claude Code 2.1.277 在无 CLAUDE.md 时自动读 AGENTS.md，可在 /config 调优先级。Bedrock Vertex 仍不支持，本文写 monorepo 落地步骤。
2026 年 9 月 18 日 Anthropic 发布 Claude Code 2.1.277：项目里没有 CLAUDE.md（及官方认可的变体）时，CLI 会改读仓库根或向上遍历找到的 AGENTS.md。OpenAI Codex、Copilot、Gemini 系早已支持该跨工具格式；Claude 曾是主要例外。社区统计称已有 6 万+ 仓库带 AGENTS.md，这次更新让「一份 baseline 指令服务多 Agent」在 Claude Code 上终于闭环。
优先级规则（避免双文件打架）
Changelog 与 elsolitario 9 月 18 日梳理的规则很简单：存在 CLAUDE.md 时，Claude Code 只用 CLAUDE.md，同目录的 AGENTS.md 会被忽略。只有缺少 CLAUDE.md 时才会加载 AGENTS.md。
在交互会话里打开 /config，找 “Project instructions” 相关项，可配置优先读哪一种或同时启用（以你安装的 2.1.277+ 文档为准）。升级后先跑：
claude --version
应显示 2.1.277 或更高；低于此版本不会走 fallback。
monorepo 怎么铺
子包各自 AGENTS.md、根目录只有 CLAUDE.md 的仓库：子目录 Agent 会话仍按「向上一路找 instruction file」规则，深目录文件压浅层。若希望全 monorepo 共享 baseline，可以只在根保留 AGENTS.md 并删除根 CLAUDE.md，子包只写差异段。
与 Muse Code trust 边界 类似：instruction 文件在 fork PR 里是 attacker-controlled，先 trust 再加载。企业应用 intake checklist 审 .md 里的 curl/bash 指令。
云 API 路径的缺口
2.1.277 的 AGENTS.md fallback 不适用于 Amazon Bedrock、Google Vertex、Foundry 托管的 Claude Code 网关。那些环境仍要维护 CLAUDE.md 或通过 gateway 注入 system。Changelog 同日还加了 CLAUDE_GATEWAY_PROXY_IS_EGRESS_BOUNDARY=1 等代理 egress 变量，与 instruction 格式无关，但常在同版本一起升级，别漏测 CI 代理。
和 Plugin4Shell 升级一起做的原因
同一 9 月窗口里 Plugin4Shell 要求 Claude Code ≥ 2.1.179（见 Plugin4Shell 总览）。2.1.277 已包含该安全修复区间，建议一次升到最新 stable，而不是 pin 在 2.1.179 停住错过 AGENTS.md 与 changelog 里一长串 Agent SDK 修复。