Claude Code v2.1.295
来自 Claude Code Releases · 期号 2026-10-09
摘要
Claude Code v2.1.295 发布，新增命令和 HTTP 钩子的 onFailure: "block" 模式：钩子无法启动、超时或返回意外状态码时，会阻止操作继续，而不是放行。 终端新增程序状态协议（OSC 7501）支持，实现该协议的终端可以显示 Claude Code 当前是在工作中、等待用户输入还是已完成。 修复了 60 多个 bug，包括远程 MCP 服务器断连后重试风暴、子 agent 在后台工作时输出丢失、终端因超长响应冻结等问题。
深读
导读 Claude Code v2.1.295 是一次以修复为主的密集更新，修复了超过 60 个 bug，同时引入了几个关键新特性：命令和 HTTP 钩子新增 onFailure: "block" 模式，终端支持程序状态协议（OSC 7501），以及 Claude apps 网关新增超时和模型列表配置。对于日常使用 Claude Code 的开发者，这次更新直接解决了远程 MCP 服务器断连重试风暴、终端因超长响应冻结、子 agent 输出丢失等痛点。 关键信息 - 新增 onFailure: "block" 模式：命令或 HTTP 钩子无法启动、超时或返回意外状态码时，会阻止操作继续，而非放行。 - 新增程序状态协议（OSC 7501）支持：实现该协议的终端可以显示 Claude Code 当前是在工作中、等待用户输入还是已完成。 - 修复了远程 MCP 服务器断连超过 15 秒后保持断开状态的问题，以及断连后以紧循环重连的问题；重复断连现在会退避，最长等待 30 秒。 - 修复了终端因响应长达数万行而冻结、Ctrl+C 失效的问题。 - 修复了 MCP 工具返回的 CSS、JavaScript 和 XML 文件被保存为 .bin 格式、导致 Read 工具拒绝读取的问题。 - 修复了子 agent 在后台工作时，claude -p 文本输出丢失早期响应的问题；每个 turn 的响应现在在 turn 结束时打印。 逐节讲解 新增功能 本次更新新增了多项功能。命令和 HTTP 钩子新增 onFailure: "block" 模式：如果钩子无法启动、超时或返回意外状态码，会阻止操作继续，而不是放行。终端新增程序状态协议（OSC 7501）支持，实现该协议的终端可以显示 Claude Code 当前是在工作中、等待用户输入还是已完成。/copy 选择器新增引用文本支持，草稿消息复制时不再包含 > 标记。当 claude plugin install、enable、disable 和 marketplace add 写入的设置文件无法加载时，会显示警告。claude -p 运行在最后一轮后保持打开状态时，如果终端是终端，会在 stderr 上输出一行说明它在等待什么。 Claude apps 网关新增 timeouts.upstream_ttfb_ms 支持，该值限制流在 Bedrock、Vertex、Foundry 等云上游开始的时间，超时后故障转移或返回 502。网关每个上游新增可选的模型列表，只有列出的模型才会发送到该上游，故障转移时也适用，条目中的 * 是通配符。新增 forceLoginMethod: "gateway" 和 forceLoginGatewayUrl 支持，用于没有托管设置的机器上的用户设置，使 /login 打开在该 Claude ap…