工程 / 官方
大规模修复与多项新功能上线
Anthropic 于 2026 年 11 月发布 Claude Code v2.1.317,这是一次覆盖范围极广的版本更新,包含超过 60 项修复与改进。新功能方面,版本新增了调度任务连接器警告机制、网络请求前的邮件地址确认提示、Agent SDK 钩子回调的 onFailure block 模式,以及面向管理员的费用报告 API。在可观测性层面,anthropic.plan、anthropic.seat_type 等字段被纳入 OTel 指标与追踪体系。修复方面,本次更新解决了 MCP 服务器断连、自动模式在网关返回 403 或 422 时持续失败、会话标题丢失、PDF 页数统计错误、OpenTelemetry 导出挂起等多个影响生产环境的关键问题。VSCode 插件、云会话、自托管运行器及远程控制模块均获得针对性修复,整体稳定性与可靠性显著提升。
v2.1.317 在功能层面引入了多项面向企业和开发者的增强。调度任务(/schedule)现在会在新建云端任务意外附带未请求连接器时主动发出警告,并提示如何移除。Agent SDK 的钩子回调新增 onFailure: block 选项,当回调执行失败时可直接阻断后续操作,而非默认放行,这对需要严格审计的自动化流程尤为重要。此外,网络或 Shell 工具调用在向外部网络发送账户邮件地址前,系统现在会先行询问用户确认。
可观测性与成本管理能力在本次更新中得到显著扩充。OTel 指标、事件与追踪数据现已包含 anthropic.plan、anthropic.seat_type、anthropic.provider 和 anthropic.custom_base_url 四个新字段,便于企业按订阅计划和服务商维度进行精细化监控。管理员 API 新增 GET /v1/organizations/analytics/cost 端点,支持按日期范围、开发者、每日或 IdP 群组维度查询历史费用,同时每日记录开发者所属 IdP 群组,保留周期由 admin.identity_retention_days 控制。
本次修复覆盖了多个影响日常使用的关键缺陷。MCP 服务器在部分 Claude Desktop 会话中首轮对话后断连的问题已得到解决;自动模式在 LLM 网关以 403 或 422 响应服务端安全检查时每轮均失败的问题同样被修复。云会话与 SDK 会话中,当新消息或停止指令在标题生成期间到达时导致会话标题丢失的问题,以及 Artifact 工具上传文件时触发不必要审批的问题,均已在本版本中得到处理。
针对自托管运行器和企业网关的修复同样值得关注。Amazon Bedrock 返回的「Input is too long.」错误此前被网关隐藏,导致会话以「upstream rejected the request」持续失败而无法触发压缩,现已修复并正确透传原始错误信息。自托管运行器会话在计划等待审批期间重启后丢失近期对话轮次的问题、stdio MCP 服务器接收到空 AWS_BEARER_TOKEN_BEDROCK 导致无法使用本机凭证的问题,以及 TLS 检查代理环境下证书更新后 API 请求失败的问题,均在本次更新中得到修复。
VSCode 插件在本次更新中获得多项专项修复。并行工具调用中仅保留一个结果、压缩后末尾消息丢失导致回答与问题脱节的问题已被解决;Claude 未能在超时前完成启动时丢失消息的问题,现在会触发一次重试再显示错误。此外,区域或网络封锁被误判为登录失败并错误打开登录界面的问题、聊天字体调大后附件组件未随之缩放的问题,以及 ultrathink 在关闭遥测时无法提升努力等级的问题,均已修复。云会话新增链接卡片功能,MCP 服务器请求打开的链接现在会以卡片形式呈现,用户可选择打开或拒绝,而非让请求悄然消失。
要点
- Agent SDK 新增 onFailure: block 钩子模式,回调失败时可阻断操作执行,适合对自动化流程有严格审计要求的企业场景。
- 管理员 API 新增费用报告端点,支持按开发者、日期、IdP 群组多维度查询历史支出,企业成本管控能力显著增强。
- OTel 可观测性字段扩展至订阅计划、席位类型、服务商及自定义 Base URL,便于多云和多计划环境下的精细化监控。
- 本次修复解决了 MCP 服务器断连、自动模式网关兼容性、OpenTelemetry 导出挂起等多个影响生产稳定性的关键问题。
- VSCode 插件、云会话、自托管运行器均获得针对性修复,整体可靠性和用户体验得到系统性提升。