AI资讯 / 工程

工程 / 官方

钩子拦截、终端状态协议与大量稳定性修复

Claude Code Releases

Anthropic 于 2025 年 10 月 8 日发布 Claude Code v2.1.295,带来数十项新功能与大规模缺陷修复。新功能方面,命令钩子和 HTTP 钩子新增 onFailure: "block" 选项,钩子启动失败、超时或退出码异常时将直接拦截操作而非放行;同时引入 OSC 7501 程序状态协议,支持该协议的终端可实时显示 Claude Code 的工作、等待或完成状态。Claude apps 网关在 Bedrock、Vertex、Foundry 等云上游新增 timeouts.upstream_ttfb_ms 超时配置,以及可按模型过滤流量的可选模型列表。修复层面,本次解决了远程 MCP 服务器断线重连死循环、CSS/JS/XML 文件被错误保存为 .bin、后台子代理竞态条件、终端在超长输出时冻结等大量问题,并对 VS Code 扩展、云会话、Claude Tag 及 Code Review 模块分别进行了专项修复与改进。

在钩子与安全控制方面,v2.1.295 为命令钩子和 HTTP 钩子引入了 onFailure: "block" 机制。当钩子无法启动、执行超时或以非预期退出码结束时,对应操作将被直接阻断,而非默认放行。这一改动显著提升了钩子作为安全守卫的可靠性,避免因钩子异常而导致未经审查的操作被执行。与此同时,mod 的 Button 组件新增 children 支持,可在列表行内嵌入文字标签或次要说明,丰富了插件 UI 的表达能力。

终端体验方面,本次更新新增对 OSC 7501 程序状态协议的支持。实现该协议的终端模拟器可直接读取 Claude Code 当前处于工作、等待用户输入还是已完成的状态,无需解析输出文本。此外,/copy 选择器现在会自动去除引用块的 > 标记,claude -p 在最后一轮结束后保持打开时会在 stderr 输出等待原因,后台会话取消时也会显示明确的「Backgrounding cancelled」提示,整体交互反馈更加清晰。

Claude apps 网关获得多项能力增强。新增 timeouts.upstream_ttfb_ms 配置项,可限制 Bedrock、Vertex、Foundry 等上游开始返回流式数据的最长等待时间,超时后自动故障转移或返回 502。每个上游现在支持可选的模型列表,仅将指定模型的请求路由至该上游,故障转移时同样遵守此规则,支持通配符 *。网关推理审计事件新增 upstream_request_id 字段,便于将 Claude Code 遥测中的请求 ID 与网关审计日志对应,方便排查问题。

MCP 与插件生态的稳定性在本次更新中得到大幅改善。修复了远程 MCP 服务器在断线超过 15 秒后持续断连或进入重连死循环的问题,现在重复断连会以指数退避方式延迟,最长等待 30 秒。MCP 工具返回的 CSS、JavaScript、XML 文件不再被错误保存为 .bin 扩展名,字体和图标文件也获得了正确的扩展名映射。分页游标重复的 MCP 服务器不再被反复请求同一页面,插件市场在加载失败时也不会在未经确认的情况下自动卸载插件。

后台任务与子代理方面,修复了 CLAUDE_AUTO_BACKGROUND_TASKS 在编辑或 Shell 命令等待期间将子代理移入后台、导致调用提前触发的竞态问题。后台会话中的命令和钩子不再继承 FORCE_COLOR=3,避免颜色转义码混入 Claude 读取的输出。自定义名为 worker 的代理在自动模式拒绝通知和任务列表中现在能正确显示其名称,而非统一显示为「Agent」。此外,终端在处理数万行响应时冻结、语法高亮超长行或未闭合字符串时卡顿等渲染问题也一并得到修复。

针对 VS Code 扩展、云会话和 Claude Tag,本次更新同样带来专项修复。VS Code 中新增文件行,点击文件名可直接在编辑器中打开 Claude 发送的文件;修复了「Fork conversation from here」和 Rewind 在后台代理活动后报「Message not found」的问题。云会话修复了取消归档后立即发送消息无响应的问题,并改善了断线重连后活动内容的追赶速度。Claude Tag 修复了 Slack 频道链接和 @-mentions 显示为原始代码的问题,并将设置确认卡的有效期从 10 分钟延长至 30 分钟。

要点

  • onFailure: "block" 让命令钩子和 HTTP 钩子在异常时真正拦截操作,而非静默放行,显著提升安全守卫的可靠性。
  • OSC 7501 程序状态协议支持使兼容终端可原生感知 Claude Code 的运行状态,无需解析文本输出。
  • Claude apps 网关新增上游超时配置和按模型过滤路由,为企业级多云部署提供更精细的流量控制能力。
  • MCP 断线重连引入指数退避机制,文件扩展名映射修复,以及分页游标去重,大幅提升 MCP 生态的稳定性。
  • 本次版本覆盖后台任务竞态、终端渲染冻结、插件加载、云会话、VS Code 扩展等多个子系统的大规模缺陷修复,工程质量显著提升。
查看原始来源

原始标题:v2.1.295

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