核心结论
北京时间 10 月 21 日 4 时 46 分，Anthropic 在 GitHub 发布编码智能体 Claude Code 正式版 v2.1.305。仓库发布记录为 2026-10-20T20:46:50Z，折合北京时间当日，对比区间为 v2.1.304 至 v2.1.305。本次核心是修复 2.1.304 引入的网关回归：在 Vertex、Bedrock 等网关拒绝 ToolSearch 或未配置该能力时全部请求失败，现改为自动重试不带该参数。同时新增 Linux 沙箱嵌套命名空间支持与无人值守重试额度感知能力，其余为客户端修复与体验改进。以上版本、时间与回归修复归属由官方发布页直接确认；是否需要升级为编辑基于发布范围的影响解释，不应理解为服务端模型或计费变化。
版本与时间
对比页显示本次为 3 个提交、16 个文件变更，状态为正式版而非预发布。发布时间以官方发布接口中的 Published 为准，即北京时间 10 月 21 日 4 时 46 分，已确认属于上海当日窗口，未使用往日转载或聚合页补充背景。前一版本 v2.1.304 的发布时间为北京时间 10 月 20 日，本次为其后约 23 小时的跟进修复，延续正式发布序列。中国用户可直接查阅官方发布页核验版本归属，本文仅说明该区间的修复范围与限制，不构成升级保证。
已核实变化
官方宣布的新增内容有两项：一是 sandbox.allowNestedUserNamespaces，允许 Linux 沙箱命令创建用户命名空间，用于 Chromium 与 rootless podman 等绕过沙箱文件保护的场景；二是 CLAUDE_CODE_RETRY_WATCHDOG_USAGE_LIMIT_RECHECK_MS，使无人值守重试模式能感知已提前解除的用量限制。官方宣布的修复重点是网关 ToolSearch 回归，明确标注为 2.1.304 回归。其他官方列出的已核实修复包括 /effort 与 /autocompact 在模型名大小写或 [1m] 标签差异下不生效、裸仓库新建工作区分支起点错误、磁盘写满时 Bash 报错不明、MCP 服务器同名替换、子智能体模型命名错误、云会话压缩摘要遗漏提示、Workflow 重跑已完成智能体等问题，以及 /usage、MCP 同意弹窗、iTerm 图片、远程控制、VS Code 启动钩子、云环境与 Claude Tag、代码评审等改进。以上均为官方发布说明内容，未经独立测试验证，不应理解为已解决特定故障或带来可量化的性能提升。
影响与适用范围
受影响对象为已通过官方渠道安装 Claude Code 的终端、VS Code 与桌面端用户，特别是经自定义网关接入 Vertex、Bedrock 等模型的团队，以及启用 Linux 沙箱与无人值守重试的项目。由于为客户端常规更新，不升级或升级后不调整配置均保持原有逻辑；仅使用网页版 Claude 或其他模型接口的项目不受本次客户端更新直接影响。中国开发者的实际可用性仍取决于账户开通状态与网络环境，具体应以官方账户页与实际安装验证为准，境内使用前建议先在测试环境确认下载、更新与登录链路正常，再决定是否全量升级。
限制与下一步
本次官方未提供性能基准、成功率、延迟、成本或安全承诺数据，不应理解为可用性、性能或成本承诺。网关重试修复不等同于所有网关兼容问题已解决，实际效果仍受网关配置、插件组合、系统版本与账户权限影响。官方本次未声明破坏性变更与许可证变更，但生产升级仍建议先在测试环境验证常用命令、插件加载、会话恢复与云同步，再推进到主力设备。若后续出现补充说明或新的修复版本，将以新的可核验事件另行处理，不对本次补丁做追溯性扩大解读。