Claude Code 2.1.179：三个关键网关可靠性修复，运营自定义 API 端点的团队必读

Claude Code 2.1.179 于 6 月 16 日发布，表面上看是一次常规维护更新：滚动条回归修复、UI 小问题、问卷调查 bug。但在修复列表深处，隐藏着三个静默地破坏了无数生产部署的回归——专门针对通过自定义 API 网关运行 Claude Code 的团队。

2.1.179 修复了什么

三个与网关直接相关的修复：

1. 使用自定义 ANTHROPIC_BASE_URL 时 claude agents workers 返回 401

如果你从设置了 ANTHROPIC_BASE_URL 和 ANTHROPIC_AUTH_TOKEN 的 shell 环境中启动 Claude Code 后台进程——这是将 Claude Code 指向自托管网关、企业代理或 AI 路由层的标准方式——claude agents workers 会返回 401 Invalid bearer token。后台 worker 会继承自定义端点配置，却对 Anthropic 原始 API 进行鉴权，而非你配置的 base URL。

这正是运营团队在通过多 provider 网关、私有 VPC 代理或合规隔离端点路由 Claude 时使用的典型场景。这个 401 错误是静默的——agent 看起来正常启动，但在第一次 API 调用时就会失败。

2. Compaction 忽略 --fallback-model 配置

Claude Code 的自动 compaction 在上下文窗口接近上限时触发，将早期对话压缩为摘要以释放空间。当 compaction 请求遭遇限速或模型不可用错误时，理应使用 --fallback-model 链。但实际上它没有——compaction 完全绕过了配置的 fallback 策略，导致会话在主力模型过载时卡死。

对于使用 TheRouter 或任何配置了 fallback 策略的 AI 网关的团队，这意味着 fallback 链对普通请求有效，却在 compaction 这个长编码会话最关键的时刻静默失效。

3. 凭证刷新后鉴权配置仍使用旧缓存

如果在会话运行期间在外部刷新了 API 凭证（令牌轮换、短期 JWT 鉴权或网关下发的临时令牌），Claude Code 会继续使用旧的缓存请求配置，即便有效凭证已就位也会报鉴权错误。用户必须重启会话才能生效。

为什么这三个 Bug 对路由团队格外重要

这三个失败有一个共同规律：它们只在生产网关部署中暴露，而不会在默认 api.anthropic.com 路径下出现。

ANTHROPIC_BASE_URL 401 问题在针对 Anthropic 原始 API 测试 Claude Code 时完全隐形。只有当你把 Claude Code 部署给通过共享网关路由的团队时，才会发现 worker 在静默地丢弃请求。

compaction fallback 跳过是间歇性的。它只在主力模型恰好在上下文填满时过载才会触发。对于采用激进 fallback 策略的路由部署，这个情况更常发生，因为主力模型可能在会话进行中就已触达限速。

鉴权缓存陈旧对使用 workload identity federation、有时限 API 令牌或按计划轮换的网关凭证的团队最具破坏力。Anthropic 已为 Claude 推出 workload identity federation，令牌轮换模式因此更为普遍——旧缓存 bug 的触发概率也随之上升。

路由/运营视角

如果你的团队在网关层后方运行 Claude Code——无论是自托管代理、云原生 AI 网关还是多 provider 路由服务——升级至 2.1.179 后请检查以下几点：

鉴权回归审计： 验证 claude agents（后台 worker）能正确命中你的自定义 base URL。启动一个 worker 会话，检查网关上的请求日志，确认 Authorization 头部包含的是网关下发的令牌，而非陈旧的 Anthropic 原始令牌。

Compaction fallback 验证： 配置一个已知繁忙的主力模型并让 auto-compaction 触发。在网关日志中确认 fallback 模型收到了 compaction 请求。2.1.179 已修复，但应在你的环境中验证——compaction 触发时机因会话而异。

凭证轮换处理： 如果你轮换 API 密钥或使用短期令牌，测试刷新路径。在 2.1.179 中，会话外部的凭证刷新现在应无需重启后台进程即可生效。对照你的令牌轮换周期验证此行为。

managed settings 中的 fallback model： 如果通过 managed settings（managedSettings.json）在企业内全量部署 Claude Code，确保在组织层面配置了 fallbackModel。compaction 修复意味着此设置现在在高负载 compaction 事件中也会被正确遵守。

TheRouter 用户的关注点

通过 TheRouter 路由 Claude Code 的团队，普通推理请求已受益于 TheRouter 的 provider 路由和 fallback 策略。2.1.179 的 compaction 修复填补了自动 compaction 绕过网关 fallback 的漏洞——意味着你的 fallback 配置现在可以端到端生效，而不只是在主路径请求上有效。

如果你之前在路由策略下主力模型限速时看到 compaction 报错导致会话卡死，升级至 Claude Code 2.1.179 应能解决该问题。在长编码会话中监控你的网关请求日志，验证 compaction 请求是否流经预期的 fallback 路径。

ANTHROPIC_BASE_URL 修复对于预期 Claude Code worker 通过自定义端点路由的任何部署都至关重要：确保后台进程在设置了网关凭证的同一 shell 环境中启动。

升级方式

通过 npm 更新：

npm install -g @anthropic-ai/claude-code@latest
claude --version  # 应显示 2.1.179

三个可靠性修复无需任何 feature flag。升级即生效。