Claude Code 2.1.266 修复网关认证回退 用代理的必须升级

Claude Code 2.1.265 引入回退 bug，CLAUDE_CODE_USE_GATEWAY 变量导致代理和网关用户登录失败。2.1.266 修复，升级即可，不需要改配置。

Claude Code 2.1.266 修复网关认证回退 用代理的必须升级

如果你的 Claude Code 在升级到 2.1.265 后开始报"Not signed in to the Cloud gateway"错误，而你明明配置了 API key 或自定义代理，这是 2.1.265 引入的一个回退 bug。升级到 2.1.266 即可修复，不需要改任何配置。

作者：CodePass 技术编辑

出了什么问题

2.1.265 改动了 CLAUDE_CODE_USE_GATEWAY 这个环境变量的处理逻辑。这个变量本来是一个内部（undocumented）变量，之前的行为是：只有同时设置了 ANTHROPIC_BASE_URL 和 ANTHROPIC_AUTH_TOKEN 时，它才生效。

2.1.265 打破了这个前提条件：即使只设置了 CLAUDE_CODE_USE_GATEWAY（没有同时设置 ANTHROPIC_AUTH_TOKEN），它也会强制尝试 Cloud gateway 登录。这导致所有通过 API key、apiKeyHelper 或自定义 auth header 认证的用户都无法正常工作。

受影响的典型场景：

  1. 你的团队通过自己的 AI 网关代理 Claude Code 请求（设置了 ANTHROPIC_BASE_URL）
  2. 你使用第三方 AI 网关（如国内的代理服务）
  3. 你的部署环境里碰巧设置了 CLAUDE_CODE_USE_GATEWAY（可能从某个文档或教程里复制的）

修复方法

npm install -g @anthropic-ai/claude-code@latest
claude --version  # 确认 ≥ 2.1.266

升级后不需要改任何环境变量或配置文件。2.1.266 恢复了 2.1.265 之前的行为：CLAUDE_CODE_USE_GATEWAY 单独存在时被忽略，只有同时设置了 ANTHROPIC_BASE_URL 和 ANTHROPIC_AUTH_TOKEN 时才生效。

如果你的部署环境里有多个实例（CI 环境、团队共享服务器等），用以下命令批量检查版本：

claude --version

所有停留在 2.1.265 的实例都需要升级。

升级后的检查

2.1.265 里除了这个回退 bug，还加了 subagent 缓存修复。TheRouter.ai 的分析建议升级到 2.1.266 后监控网关日志里的 cache hit ratio，2.1.265 的 subagent prompt-cache 修复应该能提升命中率。

另外，2.1.265 新增的 user.email 和 user.groups 字段会在会话中传递给网关。如果你的网关有自己的遥测 schema，检查一下这两个字段是否能被正确接收。如果网关不识别这些字段，通常不会导致错误，但可能会在日志里出现 unknown field 警告。

参考资料