AI资讯 / 工程

工程 / 官方

大规模修复与多项体验提升

Claude Code Releases

Anthropic于2025年10月21日发布Claude Code v2.1.307,这是一次以稳定性和可靠性为核心的重要版本更新。此次发布新增了两项功能:将Claude API代码迁移至2026-10-21 API版本的指令,以及针对每次工具调用的OpenTelemetry安全事件上报能力,便于开发者追踪权限规则、自动模式、安全检查及沙箱行为。修复层面,本次更新解决了MCP服务器在macOS钥匙串锁定时错误显示「需要认证」的问题、HTTP MCP工具调用在连接中断时被重复发送的问题,以及云端会话中/clear指令清除的对话在会话重启后意外恢复的问题。VSCode插件同步修复了长提示词遮挡聊天面板、语音听写在TLS代理后失败等多个问题。自托管Runner也获得多项针对性修复,整体提升了企业级部署场景下的稳定性。

v2.1.307在新功能方面较为克制,但两项新增内容具有实际意义。其一是新增/claude-api api-version指令,将相关API代码正式迁移至2026-10-21版本;其二是引入claude_code.safety_event这一OpenTelemetry事件类型,每当工具调用触发权限规则、自动模式判断、安全检查、钩子拦截或沙箱介入时,均会上报该事件。这为需要审计AI操作行为的企业用户提供了更细粒度的可观测性支持。

MCP服务器相关问题在本次更新中得到集中修复。此前在macOS上,当系统登录钥匙串处于锁定状态时,MCP服务器会在claude -p模式下显示模糊的「需要认证」提示,现在系统会明确说明原因,且解锁后下次运行无需重新登录。此外,当macOS或Linux设备进入睡眠状态时,正在连接中的MCP服务器会被错误标记为超时并在无头运行中持续失败,该问题已得到修复。HTTP MCP工具调用在连接中断时被重复发送的问题也已解决,现在仅对只读或幂等操作进行重试。

云端会话与自托管Runner的稳定性同样是本次修复的重点。使用/clear清除的对话有时会在云端或自托管Runner会话重启后意外恢复,该问题已修复。/autocompact在云端会话重启后回退至默认窗口的问题、CLAUDE_STREAM_FIRST_BYTE_TIMEOUT_MS在Claude应用网关会话中被忽略的问题,以及WebFetch在Cowork云端会话中将4xx状态码和robots.txt拒绝误报为工具错误的问题,均已在本次版本中得到解决。

自托管Runner获得了多项专项修复。使用--use-anthropic-git-proxy时,早期会话遗留的.claude/settings.local.json文件会被错误提交至克隆仓库,该问题已修复。在checkout钩子执行期间归档、重新排队会话或停止Runner,会导致钩子进程残留并占用Runner槽位的问题也已解决。此外,checkout钩子现在默认在30分钟后强制终止,若业务需要更长时间,可通过--checkout-hook-timeout-min参数调整或设为0以禁用限制。

VSCode插件在本次更新中同步跟进了多项修复与调整。长提示词通过「显示更多」展开后会遮挡整个聊天面板的问题已修复,固定提示词现在最多占用面板高度的40%并支持滚动。语音听写在TLS检查代理后因NODE_EXTRA_CA_CERTS仅配置于~/.claude/settings.json而失败的问题已解决,现在同样遵循CLAUDE_CODE_CERT_STORE设置。新增的麦克风按钮提示会在语音听写自动停止时说明原因,并告知用户已录入的文字内容得以保留。

在体验改进方面,Claude Code对无法解析的工具调用新增了最多两次重试机制,避免因单次解析失败直接终止对话轮次。并行启动的fork子代理现在各自知晓自身的启动编号,大幅降低了多个子代理相互干扰、重复执行同一任务的概率。浏览器登录体验也得到优化,登录完成后成功页面会立即显示,无需等待账户资料加载完毕。代码审查功能新增了@claude review stop指令,支持通过off和pause别名终止对某个Pull Request的持续审查订阅。

要点

  • 新增claude_code.safety_event OpenTelemetry事件,为企业用户提供工具调用层面的细粒度安全审计能力。
  • MCP服务器在macOS钥匙串锁定、设备睡眠等场景下的连接问题已全面修复,无头运行稳定性显著提升。
  • 自托管Runner新增checkout钩子30分钟默认超时机制,防止钩子进程失控占用资源。
  • VSCode插件修复了语音听写、长提示词显示及TLS代理证书信任等多个影响日常使用的问题。
  • 代码审查功能新增@claude review stop指令,用户可随时终止对Pull Request的持续审查订阅。
查看原始来源

原始标题:v2.1.307

本文由 DataHub 基于公开来源整理,用于信息发现与摘要阅读;具体事实、数据和后续更新以原始来源为准。