工程 / 官方
Claude Code v2.1.266 修复网关回归问题，代理配置无需变更
Anthropic 于 2025 年 9 月 8 日发布 Claude Code v2.1.266，专项修复前一版本 v2.1.265 引入的一处回归缺陷。问题根源在于未公开的环境变量 CLAUDE_CODE_USE_GATEWAY 的行为发生了意外变化：该变量原本仅在同时设置 ANTHROPIC_BASE_URL 与 ANTHROPIC_AUTH_TOKEN 时才会生效，但在 v2.1.265 中，它开始单独触发 Cloud 网关登录流程。这导致所有将该变量与 API 密钥、apiKeyHelper 或自定义认证头组合使用的配置，在每次请求时均收到「未登录 Cloud 网关」的错误提示，严重影响依赖 LLM 网关或反向代理架构的企业与开发者。v2.1.266 将该变量的行为恢复至原有逻辑，单独设置时不再产生任何副作用，现有用户无需修改任何配置即可恢复正常使用。
Claude Code v2.1.266 是一次针对性的补丁发布，核心目标是撤销 v2.1.265 中一处意外引入的行为变更。受影响的是名为 CLAUDE_CODE_USE_GATEWAY 的环境变量，该变量从未出现在官方文档中，属于内部或实验性配置项。在正常情况下，它只有在与 ANTHROPIC_BASE_URL 和 ANTHROPIC_AUTH_TOKEN 同时存在时才会激活 Cloud 网关登录路径。
然而，v2.1.265 的代码改动使该变量获得了独立触发网关登录的能力。这意味着，只要系统环境中存在 CLAUDE_CODE_USE_GATEWAY，无论其他认证方式如何配置，Claude Code 都会强制尝试走 Cloud 网关流程。对于使用 API 密钥直连、通过 apiKeyHelper 动态获取密钥或携带自定义认证头的用户而言，这一行为与其配置存在根本冲突。
实际影响集中在企业内网部署和第三方代理场景。许多团队在自建 LLM 网关或反向代理时，会在环境变量中保留 CLAUDE_CODE_USE_GATEWAY 作为历史配置或占位符，并未预期它会主动干预认证流程。v2.1.265 上线后，这些配置下的每一次 API 请求均以「Not signed in to the Cloud gateway」报错终止，导致服务中断。
v2.1.266 的修复方案直接明了：将 CLAUDE_CODE_USE_GATEWAY 的判断逻辑回滚，使其在单独存在时重新被忽略，仅在与完整网关凭据组合时才发挥作用。Anthropic 在发布说明中明确指出，受影响用户无需对现有配置做任何调整，升级版本后即可恢复正常。
此次事件也再次提示开发者关注未文档化环境变量的潜在风险。CLAUDE_CODE_USE_GATEWAY 从未出现在官方配置指南中，其行为边界对外部用户而言本就不透明。当工具链依赖此类隐式变量时，版本迭代中的任何内部逻辑调整都可能在毫无预警的情况下破坏生产环境。建议团队定期审查环境变量清单，移除不再需要或来源不明的配置项。
要点
- v2.1.265 中 CLAUDE_CODE_USE_GATEWAY 环境变量意外获得独立触发 Cloud 网关登录的能力，导致使用 API 密钥或自定义认证头的代理配置全面报错。
- v2.1.266 已将该变量行为恢复原状，单独存在时不再产生任何副作用，受影响用户升级后无需修改配置。
- 该变量属于未公开文档的内部配置项，此次事件暴露了依赖未文档化环境变量的潜在脆弱性。
- LLM 网关与反向代理架构的企业用户受影响最为集中，建议尽快升级至 v2.1.266 以恢复服务稳定性。