Claude Code v2.1.305：紧急修复 2.1.304 BUG，企业级稳定性大幅提升

发布时间：2026-10-20 | 版本：v2.1.305（Latest）

Claude Code 今天发布了 v2.1.305 版本。这是一次以稳定性修复为核心的更新：不仅紧急修复了上一版本（2.1.304）引入的严重回归，还对自托管运行器、云端会话、VS Code 插件和无障碍体验进行了大量打磨。以下是本次更新的完整解读。

亮点速览

1. 紧急修复：工具搜索被拒导致全部请求失败（2.1.304 回归）
2. 新特性：Linux 沙盒支持嵌套用户命名空间，Chromium、rootless Podman 可以跑起来了
3. 无人值守模式更聪明：用量限制提前解除时立即恢复，不再干等重置时间
4. /usage 交互升级：每条警告变成一行可执行的修复建议，按f一键应用
5. Workflow 断点续跑不再重复劳动：已完成的pipeline()parallel()agent 直接从日志恢复

如果你在上一版本遭遇了"所有请求都失败"，这次更新就是为你准备的：

• Vertex、Bedrock 及其他提供商全面修复：当端点或网关拒绝工具搜索（Tool Search）时，此前会导致每一个请求都失败。现在 Claude Code 会自动降级，在不含工具搜索的情况下重试。同样覆盖了网关不允许 ToolSearch、或--tools中未包含 ToolSearch 的场景。

• 自托管 runner 两处回归修复
• 修复 2.1.300 起启动脚本在设置了TERM时报Resource temporarily unavailable的问题；
• 修复 2.1.296 起 git 凭据助手或 askpass 通过GIT_CONFIG读取配置时仓库访问失败的问题。

• sandbox.allowNestedUserNamespaces：允许 Linux 沙盒内的命令创建用户命名空间。这意味着 Chromium 和 rootless Podman 等工具终于可以在沙盒中运行。⚠️ 注意：该选项会放开沙盒的文件保护，请按需开启。
• CLAUDE_CODE_RETRY_WATCHDOG_USAGE_LIMIT_RECHECK_MS：无人值守重试模式（CLAUDE_CODE_RETRY_WATCHDOG）新增环境变量，可在用量限制的官方重置时间到来之前主动复查——限制一旦解除立刻恢复工作。

️ 关键修复

配置与模型

• /effort/autocompact现在能正确匹配模型名：之前模型名与modelOverrides仅大小写不同、或带有[1m]标签时设置不生效。
• 修复子代理切换到 fallback 模型后，Claude 归因错误模型的问题。

Git 与文件系统

• 裸仓库（bare repo）中新建的 worktree 有时会基于本地 HEAD 而非默认分支；未变更的子代理 worktree 有时不被清理——均已修复。
• 磁盘写满时，Bash 命令的报错不再是晦涩的ENOSPC文件路径，而是明确告知"磁盘已满，命令未执行"。

MCP 与会话

• 修复云端会话或 SDKsetMcpServers传入的 MCP 服务器，在会话中途被你本地配置中的同名服务器"顶掉"的问题。
• MCP 同意对话框优化，提示词中的回车不再容易被误判为"接受"。
• allowedMcpServers不再过滤仅在env中使用${VAR}的 stdio 服务器——升级后原先被过滤的服务器会重新加载，需要屏蔽请使用deniedMcpServers

Workflow 与远程控制

• Workflow resume 不再重复运行已完成的pipeline()parallel()agent，而是直接从运行日志中恢复。
• 远程控制切换会话后不再在/resume中留下空的 "(session)" 条目。

云端会话（Cowork）

• 修复定时云端会话中，子代理的 WebFetch 因等待一个无人审批的 URL 而卡住五分钟的问题。
• 云环境管理页面修复了误报"installs packages"导致已有环境无法保存的问题；删除自托管环境时的对话框也会说清阻塞原因和影响范围。

VS Code 插件

• 新增"Running start-up hooks"加载状态（带屏幕阅读器播报），SessionStart / Setup 钩子运行时不再看起来像卡死。
• 修复spinnerVerbs设为短词时加载动画截断"Compacting..."的问题。
• 会话启动超时的报错信息重排：优先展示输出日志和可能原因，而不是先让人去查登录和网络。

• 屏幕阅读器模式：搜索框现在朗读"Search:"而不是被 VoiceOver 念成"电话录音机"的符号；Ctrl+R 搜索匹配、"ultrathink"等高亮文本不再出现词中断裂。
• /usage 交互升级：每条警告改为一行式修复建议并注明来源，按f键直接应用；同样的修复也出现在 VS Code 和/doctor中。

• 启动时的警告不再以原始文本打印在 Logo 上方，而是写入调试日志；不限制任何内容的权限规则会在横幅下以警告行展示。
• 窄终端下/usage表格行不再被截断。
• iTerm2 3.5+ 全屏渲染模式下，图片类输出可以正常绘制画面（此前只显示 alt 文本）。
• 插件停靠面板宽度限制在终端宽度的 45% 以内。

• Claude Tag：管理员现在可以从后台直接搜索并接入 Claude 尚未加入的公开 Slack 频道；修复了仓库迁移 GitHub 账号后无法再加入访问包、Slack 线程中的定时任务在对话结束后静默失败或互相干扰等多个问题。
• Code Review：多次 push 落在同一次审查期间时，不再漏审最新提交；重新审查时，若此前仍有未解决的阻塞问题，不再以 LGTM 开场。

• 强烈建议所有 2.1.300 – 2.1.304 用户立即升级：尤其是使用 Vertex / Bedrock / 自建网关的用户，以及使用自托管 runner 的团队。
• 如果你在 Linux 沙盒中需要运行 Chromium 或 rootless Podman，请关注新的sandbox.allowNestedUserNamespaces选项（注意其安全权衡）。
• 依赖allowedMcpServers过滤 stdio 服务器的团队请检查升级后是否有多余服务器被加载，必要时改用deniedMcpServers
• 定期任务、Workflow 重跑重度用户将显著受益于本次的续跑与去重修复。