Claude Code 2.1.203：静默丢失 ANTHROPIC_BASE_URL 的 Bug 正将 API 请求路由到错误端点

如果你的团队通过自定义 AI 网关运行 Claude Code——使用 ANTHROPIC_BASE_URL 将请求指向代理、本地转发器或其他端点——那么 2.1.203 版本包含一个直接影响你们的修复。后台 Agent 会话和 agent-view 会话会静默丢弃 shell 导出的 ANTHROPIC_BASE_URL，将 API 请求路由到 Anthropic 的默认端点而非你配置的端点。结果：401 错误看起来像密钥问题，实际上是路由问题。

该修复随 30 多项针对后台 Agent 和 worktree 隔离 subagent 的可靠性改进一起进入 2.1.203。此次发布的覆盖范围不寻常——它解决了自后台 Agent 架构成熟以来积累的一批 daemon、会话和 subagent 生命周期 bug。

发生了什么

Claude Code 2.1.203 于 2026 年 7 月 8 日发布。changelog 列出了对后台会话行为、daemon 可靠性、PATH 继承、worktree 隔离以及 subagent 生命周期管理的修正。

关键运维问题：后台和 agent-view 会话会丢弃 shell 导出的 ANTHROPIC_BASE_URL，将 API 请求发送到默认端点并触发 401。这是一个静默回归——没有任何错误消息指向路由配置错误。团队可能将 401 归因于密钥轮换或过期，而非网关路由失败。

第二个问题加剧了这一情况：后台 agent 从 daemon 继承了过时的 PATH，而非调度 shell 的 PATH。对于只存在于用户 shell PATH 中的自定义网关二进制或包装脚本，后台 agent 会静默回退到系统默认值，完全丢失所需工具。

此外修复：daemon 会话 token 过期会导致会话永久无响应——无法 attach、回复或停止——直到手动终止。现已添加自动恢复。

为何对 AI 工程团队至关重要

ANTHROPIC_BASE_URL 丢失问题对任何运行自定义 AI 网关或代理层的团队都是最高优先级项。失败模式十分隐蔽：

1. 开发者在 shell 中导出 ANTHROPIC_BASE_URL=https://my-gateway.internal/v1。
2. 从该 shell 启动后台 Agent 会话。
3. 后台会话不继承导出的变量。
4. 所有 API 调用转向 https://api.anthropic.com。
5. 网关从未收到请求。401 错误看起来像密钥问题。

这意味着一整批后台 Agent 运行可能已绕过你的路由策略、成本控制、可观测层或自定义 fallback 逻辑——取决于你的网关提供了哪些能力。

对于使用 worktree 隔离 subagent 的团队，还修复了两个额外 bug：subagent 有时在父级 checkout 而非其隔离 worktree 中执行 shell 命令；worktree 创建在多仓库工作空间中会拒绝嵌套仓库，导致后台会话完全无法隔离。

subagent 委托行为也得到改进：agent 现在更不容易将整个任务重新委托给另一个 subagent——这一行为此前会膨胀 token 消耗并模糊多 agent 工作流中的职责边界。

路由/运维视角

ANTHROPIC_BASE_URL 丢失是网关卫生问题，不只是 Claude Code 的 bug。 2.1.203 的修复是必要的，但团队还应排查此前的后台运行是否绕过了路由基础设施。

升级到 2.1.203 后的运维检查清单：

1. 审计近期后台 Agent 日志中的 401 错误。 如果你看到本应通过网关的请求出现 401，这些请求直接到达了 Anthropic。检查其包含的数据，以及该时期的用量统计是否准确。
2. 核对网关流量量。 将网关的请求计数与 API 密钥用量报告对比。若有差异，说明部分运行绕过了网关。
3. 在后台会话中重新测试 ANTHROPIC_BASE_URL 继承。 升级后，启动一个后台 Agent 并确认它仍通过你配置的端点路由。
4. 检查 PATH 依赖。 如果你的网关包装器或任何必需的 CLI 工具只存在于用户 shell PATH 中，请在 2.1.203 修复后测试后台 Agent 是否能正确获取。
5. 检查 worktree 隔离配置。 使用 WorktreeCreate hook 进行后台会话隔离的团队，应在多仓库工作空间中重新运行其配置，验证嵌套仓库创建不再失败。

daemon 会话 token 过期的自动恢复对长时间运行的网关部署同样重要。此前，过期的 daemon token 会使会话永久无响应且无可见错误。2.1.203 后，恢复变为自动——运维人员不再需要监控幽灵会话。

TheRouter 用户应关注的内容

通过 TheRouter 网关端点路由 Claude Code 的团队应立即升级到 2.1.203，并重新验证 ANTHROPIC_BASE_URL 在后台 Agent 会话中是否被正确继承。如果你此前遇到无法解释的 401 错误或发现网关账本外的用量，此次升级很可能是根本解决方案。

底层模式——shell 导出的环境变量未传播到 daemon 启动的后台进程——是一类可能在任何类似架构中复现的 bug。运维层面的应对是：在后台 Agent 部署的 CI/CD 流水线中添加显式的环境变量验证步骤，而非仅依赖 shell export。

配套发布的 2.1.204（同样是 7 月 8 日）新增了一个针对性修复：headless 会话中 SessionStart hook 期间 hook 事件未流式传输，可能导致远程 worker 在 hook 执行中途被 idle-reap。运行带 SessionStart hook 的 headless 网关部署的团队应同时应用 2.1.203 和 2.1.204。

完整变更列表请参阅 CHANGELOG。