Claude Code 2.1.266 修复了 Gateway 认证回归问题：受影响的配置与升级指引

如果你在升级到 2.1.265 之后，Claude Code 所有请求都开始返回 "Not signed in to the Cloud gateway"，根本原因是 CLAUDE_CODE_USE_GATEWAY 环境变量的求值逻辑出现了回归。2.1.266 于 9 月 9 日发布，恢复了原有行为，不需要修改任何配置，升级即可。

2.1.265 里出了什么问题

CLAUDE_CODE_USE_GATEWAY 是一个未公开的环境变量。在 2.1.265 之前，只有当 ANTHROPIC_BASE_URL 和 ANTHROPIC_AUTH_TOKEN 同时存在时，这个变量才会生效。一些运营者出于防御性目的或未来路由意图，会顺手设置它，在此之前这完全无害。

2.1.265 改变了求值逻辑，这个变量单独出现就足以触发 Cloud gateway 的登录流程。于是，任何同时设置了 CLAUDE_CODE_USE_GATEWAY 和普通 API key（ANTHROPIC_API_KEY）、apiKeyHelper 函数或自定义认证头的配置，都会被推入 Cloud gateway 认证流程，并因为凭据不满足而立即失败。

报错只有一种表现，每个请求都返回 "Not signed in to the Cloud gateway"，不会回退到已配置的凭据路径。

受影响的配置有一个共同特征，CLAUDE_CODE_USE_GATEWAY 已设置，主凭据却不是 ANTHROPIC_AUTH_TOKEN。如果你通过自建 AI gateway 代理 Claude（用自定义 ANTHROPIC_BASE_URL 指向自己的端点，用 API key 或 helper 认证），并且环境里有这个变量，2.1.265 会把每个会话都打断。

2.1.266 恢复了什么

求值逻辑恢复到 2.1.265 之前的样子，只有 ANTHROPIC_BASE_URL 和 ANTHROPIC_AUTH_TOKEN 同时存在，CLAUDE_CODE_USE_GATEWAY 才会起作用。如果你的 gateway 配置以 API key 作为主凭据，这个变量现在又回归到对你完全无影响的状态。

不需要改配置，升级到 2.1.266 或更高版本即可完全修复。

2.1.265 为 gateway 运营者带来了什么

这次回归掩盖了一个对 gateway 运营者来说相当有价值的版本，以下几个变化值得在升级后留意。

用户身份进入 gateway 遥测。 Claude Desktop 和 Cowork 会话现在会在通过 Claude apps gateway 发出的遥测中携带 user.email 和 user.groups。终端会话此前已经发送这些字段，现在所有会话类型对齐了。如果你的 gateway 遥测处理器按会话来源过滤字段，需要在升级 2.1.265 之前更新过滤规则，否则会漏掉新字段。

--plugin-dir 支持文件夹加载。 这个 flag 现在可以接受一个包含多个插件子文件夹的目录，每个有合法 manifest 的子文件夹都会在启动时加载。运行中添加或移除插件无需重启即可生效。对于在团队间维护共享插件仓库的运营者，这省去了每台机器单独安装的步骤。

工具结果磁盘写入上限 1 GB。 保存到磁盘的工具结果现在限制为 1 GB，对话内的预览会提示文件被截断。对于在大型代码库或文件系统上运行 agent 的 gateway 运营者，以前失控的工具结果可能悄悄撑满磁盘，现在有了明确上限。

子 agent 流水线的 prompt cache 修复

2.1.265 里修复了几个 prompt cache 复用缺口。这些问题在 gateway 的费用数据里表现为多 agent 任务中输入 token 数偏高。

• 恢复前台启动的子 agent 后，工具列表和系统提示前缀不再改变，之前每次恢复都会导致该 agent 的 prompt cache 失效。
• agent 队友和恢复的子 agent 在后续轮次中，不再把 SubagentStart hook 上下文和预加载的 skills 移出提示前缀，消除了另一个破坏 cache 的模式。
• 进程在工具调用中途崩溃后恢复，不再重写最后一条提示，保持 cache 前缀完整。

通过 gateway 路由多 agent Claude Code 工作负载、并监控每个会话 cache 命中率的运营者，升级后应当能看到明显改善。

gateway 运营者审查清单

• 检查所有部署环境中的 claude --version，发现 2.1.265 立即升级到 2.1.266。
• 审查环境变量，如果 CLAUDE_CODE_USE_GATEWAY 在没有 ANTHROPIC_AUTH_TOKEN 的情况下被设置，它在 2.1.265 之前和 2.1.266 之后都是无效的，可以根据实际意图保留或移除。
• 升级后监控 gateway 日志中的 cache 命中率，2.1.265 里的子 agent cache 修复应当带来可见的提升。
• 如果你的遥测处理器按会话来源区分字段，在生产环境升级 2.1.265 之前更新 user.email 和 user.groups 字段的过滤规则。