Claude Code 2.1.277：仓库里没有 CLAUDE.md，它现在直接读 AGENTS.md

这周 Claude Code 连着发了 5 个版本，值得单独拎出来说的其实就 3 件事，而且第 1 件是事故级的。

先说最要命的：2.1.276 修了一个 400。

2.1.275 引入的回归，会让 ANTHROPIC_BASE_URL 指向代理或网关的用户每个请求都失败，报错长这样：

400 ... Input tag 'advisor_20260301'

紧接着的 2.1.275 本身其实是在修另一个类似问题——网络网关重写了 API 的错误响应，导致 beta 请求头被拒时每一轮都弹 API Error: 400。两次修的是同一类场景：你的请求不是直连官方 API，中间有一层自己搭的或第三方给的转发。

国内用 Claude Code 的人，相当一部分都在这个场景里。如果你今天打开终端发现每轮都报 400，别去查 key 是不是过期了，先看版本号：

claude --version   # 低于 2.1.276 就升级
npm i -g @anthropic-ai/claude-code

升级是免费的，不升级的代价是整个工具不可用。这条不需要权衡。

第二件：2.1.277 开始，没有 CLAUDE.md 的仓库会读 AGENTS.md。

以前想让 Claude Code 认 AGENTS.md，得在 CLAUDE.md 里写一行 @AGENTS.md 把它导入进来。现在不用了。官方给的解析顺序是：

仓库里有什么	Claude 读什么
只有 AGENTS.md（工作目录及其上层都没有 CLAUDE.md / CLAUDE.local.md）	AGENTS.md
既有 AGENTS.md 又有 CLAUDE.md	只有 CLAUDE.md
CLAUDE.md 里已经写了 `@AGENTS.md`	CLAUDE.md，AGENTS.md 通过导入进来

判断”有没有 CLAUDE.md”只看三个文件：工作目录及其上层的 CLAUDE.md、.claude/CLAUDE.md、CLAUDE.local.md。你的 ~/.claude/CLAUDE.md、组织下发的托管 CLAUDE.md 和 .claude/rules/ 都不算数，它们照旧单独加载。

想改这个默认值，在会话里 /config，找 Project instructions，四个取值：

claude-md-or-agents-md：默认，上面的行为
claude-md-and-agents-md：两个都读，同目录下 CLAUDE.md 在前、AGENTS.md 在后
claude-md：只读 CLAUDE.md
managed-only：只读组织托管 CLAUDE.md 和自动记忆

要写进配置文件而不是交互设置，用的是内置 agents-md 插件的 ID（项目级和本地级 settings 对这个值无效，别浪费时间试）：

{
  "pluginConfigs": {
    "agents-md@builtin": {
      "options": { "instructionFiles": "claude-md-and-agents-md" }
    }
  }
}

第三件是往回退的一步：2.1.273 把 2.1.268 加的东西撤了。

2.1.268 曾经让权限检查器对 eval、env -C 这类它无法完全分析的 Bash 行，也去检查 Read / Edit 的 deny 规则。2.1.273 撤回了：现在 time -p make build 这种命令会重新弹出提示，而不是被直接拒绝。

也就是说，如果你上个月照着”用 deny 规则挡住读 .env”的思路配过 eval 或 env -C 相关的拦截，那条规则现在不生效了。 这周值得把 .claude/settings.json 里的 deny 段重看一遍，别以为它还在保护你。

同一批还修了两个不影响正确性但很烦人的问题：Streamable HTTP 的 MCP 工具调用大约 5 分钟就超时（即使你把单服务器的 timeout 调长了），以及只支持旧版 HTTP+SSE、首请求返回 422 或 4xx 的 MCP 服务器连不上。另外 2.1.273 修了上下文计量把 advisor-tool 回合按约 2 倍真实大小计算，导致自动压缩在真实窗口一半的时候就触发——老觉得上下文掉得特别快的人，升级之后应该会好。

泼点冷水。AGENTS.md 这件事被很多人当成”终于统一了”，其实没有：两个文件同时存在时 CLAUDE.md 独占，AGENTS.md 只是个兜底；Bedrock、Vertex、Foundry 三种接入方式下这个开关根本不出现。而且这是”默认行为”，默认是可以变的——别在团队文档里写”我们统一用 AGENTS.md”，要写就写清楚各自仓库放的是哪个文件。

真正该在今天做的只有一件事：确认版本号 ≥ 2.1.276。剩下的按顺序慢慢看。

原文：https://github.com/anthropics/claude-code/blob/main/CHANGELOG.md