Claude Code v2.1.295 发布：新增 hook 阻断、OSC 7501 状态协议与网关超时控制

Claude Code：GitHub Releases· ashwin-ant·2026-10-09 03:48· 1 小时前AI 评分40

v2.1.295

AI 导读

Claude Code v2.1.295 为 command 和 HTTP hooks 新增 onFailure: "block"，hook 无法启动、超时或异常退出时将阻断操作而非放行。

正文

What's changed

• 为 command 和 HTTP hooks 新增 onFailure: "block"：无法启动、超时或以意外代码退出的 hook 会阻断操作，而不是放行
• 新增 Program Status Protocol (OSC 7501) 支持：实现该协议的终端可以显示 Claude Code 正在工作、等待你输入还是已完成
• 在 /copy 选择器中新增引用文本，这样草拟的消息复制时不会带上 > 标记
• 当 claude plugin install、enable、disable 和 marketplace add 写入的设置文件无法加载时，为其新增警告
• 当 stderr 是终端时，新增一行提示，说明 claude -p 运行在最后一轮之后仍保持打开时在等待什么
• 为 Claude apps gateway 的 Bedrock、Vertex、Foundry 及其他云上游新增 timeouts.upstream_ttfb_ms 支持：你设置的值现在会限制流开始的最长时间，超时后会故障转移或返回 502
• 当 ← 正在等待当前工具完成而你停止该轮时，新增“Backgrounding cancelled”消息
• 为每个 Claude apps gateway 上游新增可选的 models 列表：只有列出的模型会被发送到那里，故障转移时也是如此，条目中的一个 * 是通配符
• 在没有托管设置的机器上，为你自己的用户设置新增 forceLoginMethod: "gateway" 和 forceLoginGatewayUrl 支持，这样 /login 会在该 Claude apps gateway 上打开
• 当插件的 README 没有安装行时，为 claude plugin validate 新增建议：它会打印要粘贴的行，且从不改变退出代码，即使使用 --strict 也是如此
• 为 Claude apps gateway 的 inference 审计事件新增 upstream_request_id：来自 Amazon Bedrock、Anthropic API 或其他上游的请求 ID，用于支持案例
• 为 mods 新增 $.ui.notify：通过你自己的通知设置发出原生通知，并说明是哪个渠道发送的
• 为 mod 的 Button 新增子项：字符串和 Text，这样列表的一行就是一个可点击项，内部带有 chip 或暗色详情
• 新增 CLAUDE_CODE_RETRY_WATCHDOG_MAX_WAIT_MS 以限制无人值守重试模式（CLAUDE_CODE_RETRY_WATCHDOG）等待 429 和 529 错误的时间
• 为 Claude apps gateway 成功的推理响应新增 request-id 头，这样 Claude Code 遥测中的 request_id 就能与 gateway 的审计日志匹配
• 修复了当 gateway、Bedrock、Vertex 或 Foundry 拒绝 context-1m beta 时，[1m] 模型上的所有请求都失败的问题；Claude Code 现在会在不带该 beta 的情况下重新发送
• 修复了当后台工作启动另一轮时，claude -p 文本输出丢弃较早响应的问题；现在每轮的响应会在该轮结束时打印
• 修复了无头会话和 SDK 会话中的远程 MCP 服务器在超过 15 秒的中断后仍保持断开的问题，或对连接后立即断开每次连接的服务器进行紧密循环重连的问题；重复断开现在会退避，最长 30 秒
• 修复了当服务器的错误回复恰好包含网络错误名称时，远程 MCP 连接被断开的问题
• 修复了重复分页游标的 MCP 服务器在每次连接时被请求同一页最多 20 次的问题
• 修复了 MCP 工具返回的 CSS、JavaScript 和 XML 文件被保存为 .bin 而 Read 工具拒绝读取的问题；字体和图标文件现在也有自己的扩展名
• 修复了当模型传入 command_description 而不是 description 时 Bash 工具调用失败的问题
• 修复了 Claude in Chrome 未将使用端口 80（host:80）编写的站点拒绝规则应用于该主机上的普通 http:// 页面的问题
• 修复了 /plugin 的 Errors 标签页在按 Enter 时未经询问就移除加载失败的市场并卸载其插件的问题
• 修复了 claude plugin marketplace add 报告成功的问题，该问题发生在一个无法安装任何插件的市场名称下；此类添加现已被拒绝
• 修复了CLAUDE_AUTO_BACKGROUND_TASKS在编辑或 shell 命令等待其后时，将子代理移到后台，导致该调用在子代理完成之前就开始的问题
• 修复了 PushNotification 在 claude remote-control 会话中、手机消息之后、没有 /config 开关时，或从 Claude Code 内部启动时，提示推送未发送的问题
• 修复了从远程会话发送的文件在一次性发送超过 256 个时被拒绝为“无法担保”的问题
• 修复了登录刷新后启动时加载托管设置罕见失败的问题
• 修复了当 Claude Code 无法再次启动时，/tui 退出时没有消息或出现原始系统错误的问题
• 修复了以文本形式显示的链接地址被回复留下的颜色或隐藏样式所隐藏的问题，包括在表格或问题预览中换行的情况
• 修复了 availableModels 中列出的 Fable 模型未出现在登录到 Claude 应用网关的会话的 /model 选择器中的问题；此类模型现在显示其内置行，以替代为同一模型添加的 modelPicker 行
• 修复了 Claude 应用网关的管理支出视图在开发者的会话不再携带分组后仍显示其旧分组和分组上限的问题
• 修复了 CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC 在 /usage 和状态行中隐藏 Claude 应用网关支出限制的问题。支出限制请求会发送到会话所登录的网关
• 修复了位于各自链接工作树中的子代理被显示父会话的 git 分支、状态和最近提交的问题
• 修复了当提示中输入的文本通过 ← 取消后台化时，Claude 在当前工具结束时停止的问题；Claude 现在会继续在前台工作
• 修复了 --tools 和 --restricted 未应用于启动后注册的内置工具的问题，以及已弃用的工具名称到达调用者工具集之外的工具的问题
• 修复了 Claude 在等待 MCP 服务器的资源列表时，中断直到超时才结束回合的问题
• 修复了 mod 的钩子被传入一个被截断且无错误的深层嵌套工具输入的问题，导致守卫可能通过它从未看到的内容
• 修复了 Esc 无法停止通过 ← 移到后台的自定节奏 /loop 的问题；取消待处理的唤醒现在会显示通知
• 修复了后台会话中的命令和钩子继承 FORCE_COLOR=3 的问题，这会将颜色转义码放入 Claude 读取的输出中
• 修复了 claude agents 在退出时启动新的后台服务的问题，当时两者都在会话打开的情况下停止（例如在重启时），这可能会延迟关闭并重启被中断的会话
• 修复了名为 worker 的自定义代理在自动模式拒绝通知和任务详情视图的活动列表中显示为“Agent”的问题
• 修复了对 glob 模式进行 for 循环的 Bash 权限检查，提高了权限检查的准确性
• 修复了从 Workflow 子代理调用的分叉技能将其结果传递到主对话而非调用代理的问题
• 修复了进程内代理队友在通过工具搜索加载工具之前首次 SendMessage 调用失败的问题
• 修复了 Claude 在恢复时被告知未完成的后台工作流可能已被 TaskStop 停止的问题，而后者永远不可能是原因
• 修复了当你从任务面板或连接的客户端停止长时间运行的 MCP 工具调用时，Claude 未被告知的问题
• 修复了后台会话的 /loop 在会话进程关闭时其下一次唤醒到期而无声停止的问题；会话现在会说明情况并告知 Claude
• 修复了回复或队友消息中的原始终端超链接字节被绘制为带有隐藏地址的可点击链接的问题
• 修复了仓库包含大型 git 子模块的固定插件市场无法添加或刷新的问题：现在只获取存放插件文件的子模块
• 修复了 /advisor 对话框在已保存但不再可用的顾问模型上显示对勾的问题；现在它会打开在“无顾问”上
• 修复了移到后台的 MCP 工具调用通知显示缩短的任务 ID 的问题
• 修复了 vim 模式下 ~ 将光标移到行尾最后一个字符之后，导致其后的 x 不起作用，以及 3~ 继续跑到下一行的问题
• 修复了将 macOS 复制的带重音文本（例如文件名）粘贴到提示中间后，光标多落一个字符的问题
• 修复了当响应达到数万行时终端冻结、ctrl+c 被忽略的问题
• 修复了 mod 在插件 hooks worker 重启期间重新加载时发出的调用绕过了另一个带有 .catch 的 mod 的守卫钩子的问题；此类调用现在会被拒绝
• 修复了 hooks 模块嵌套代码数千层深的插件无法加载或验证，只给出一个简单的栈溢出消息的问题
• 修复了 claude plugin test 通过一个 session.append 钩子，移除真实会话会保留的工具调用、工具结果或思考块的问题
• 修复了在会话被终止并第二次恢复后，Claude 未被告知可以用 SendMessage 恢复后台子代理的问题
• 修复了在运行了诸如 cat 这样未打印文件的 Bash 命令后，文件被当作已读取的问题
• 修复了名为 constructor 或 prototype 的插件选项始终读取为默认值，且编辑后从不重新加载插件的问题
• 修复了 mod 的热重载遗漏在 /reload-plugins 或会话启动读取 mod 文件期间所做保存的问题
• 修复了当 mod 热重载问题被批准但未选择答案时，整个会话中每一轮都会再次询问该问题的问题
• 修复了 /model、/fast 和 /output-style 在保存其设置时未询问插件的 config.set 钩子的问题
• 修复了直接跟在暗色文本之后的粗体文本在管道输出中被绘制得很淡的问题
• 修复了引文每隔几行就嵌套更深的回复导致终端冻结数秒并占用数 GB 内存的问题
• 修复了 mod 的热重载遗漏在其上次重载后几毫秒内所做保存的问题，这会使 mod 停留在旧版本直到下次保存
• 修复了 claude mcp serve 后台 Bash 结果未命名输出文件，以及其工具描述承诺一个永远不会到达的通知的问题
• 修复了异步 SessionStart 钩子未更改的上下文在每次恢复时被再次添加到对话中的问题
• 修复了 SessionStart 钩子写入 CLAUDE_ENV_FILE 的变量在应用内 /resume 或 /branch 后无法到达 Bash 工具的问题
• 修复了当 Skill 工具在响应流结束前完成时，技能的 allowed-tools 和 effort 被丢弃，导致该技能的 Bash 命令在 -p 运行中被拒绝的问题
• 修复了被篡改的服务器管理设置缓存使某人自己的插件在管理设置列出或启用插件的机器上被当作组织管理的问题
• 修复了在功能标志不可用时，Claude 3 Opus 和 Claude 3.x Sonnet 会话被提供这些模型会拒绝的工具搜索的问题
• 修复了生成的类型文件被写入 -p 和 SDK 会话中 --plugin-dir 插件的文件夹的问题；现在它们只写入正在开发 mod 的位置
• 修复了带有制表符或双向控制字符的文本在屏幕边缘丢失结尾或绘制到附近行上的问题
• 修复了 /model 称 Max 努力选择已保存为新会话的默认值的问题；Max 仅适用于当前会话
• 修复了异步钩子的 JSON 输出在分多行打印时被忽略的问题
• 修复了 Read 工具在 pages 参数为空时拒绝调用的问题，现在会将其视为省略该参数
• 修复了 Windows 上 VS Code 中项目范围插件因盘符大小写问题而无法加载的问题（#74612）
• 修复了 Windows 上项目或本地范围的 plugin install 和 uninstall 在仅盘符大小写不同时，缺少安装记录或添加第二条记录的问题
• 修复了在 ← 之后立即用 ↑ 或 Esc 将排队消息拉回提示符时消息丢失的问题：提示历史现在会保留它
• 修复了当 SDK 宿主在无人回答前关闭其启用询问时，mod 热重载在整个会话中被关闭的问题；现在该询问最多会问三次
• 修复了被 mod 的 prompt.submit 钩子重写或丢弃的提示仍按输入原样保存到提示历史和转录的排队提示记录中的问题
• 修复了非交互式会话在你未使用某些 MCP 服务器时仍提示它们需要身份验证的问题
• 修复了 Claude apps 网关登录时未发出 claude_code.auth OpenTelemetry 登录事件的问题。当机器上配置了 OpenTelemetry 或会话已登录到网关时，该事件会被导出
• 修复了添加超大接口的插件在插件钩子工作线程停滞时导致另一个插件被卸载的问题
• 修复了 Edit 在文件内容已更改但修改时间未更新时仍将文件视为已完全读取的问题
• 修复了带有 Windows 行尾（CRLF）的短命令输出被绘制在单行上的问题
• 修复了已停止的计划任务在回退后恢复时重新出现的问题，以及计划任务在压缩后按 Esc 或回退再恢复时丢失的问题
• 修复了终端在对超长行、连续大量空行或未闭合字符串和 heredoc 进行语法高亮时冻结数秒或数分钟的问题
• 修复了被中断的 /ultrareview 上传遗留在 ~/.claude/seed-admin 下的临时文件从未被保留清理删除的问题
• 修复了从设置中移除 disableAutoMode 后，Desktop 和 SDK 会话在重启前拒绝切回自动模式的问题
• 修复了 claude.ai 同步的插件钩子在长时间运行的会话中，在另一个会话同步了插件更新后失败并报“Plugin directory does not exist”的问题
• 修复了在 /rewind 之后发送的提示丢失、以及被移除的轮次重新出现的问题，该问题发生在会话被移到后台或被终止后恢复时
• 修复了当 mod 的 session.receive 钩子在传递消息前请求权限时云会话挂起的问题
• 修复了 macOS 上更新后一起重启的后台会话有时在稳定应用包装器之外运行，导致文件夹访问提示可能再次出现的问题
• 修复了在无头和 SDK 会话中较晚完成的 MCP 登录或重连将带有 setMcpServers() 的服务器集合重新列为你自己服务器的问题
• 修复了在 /config 中更改自动更新通道时，在插件 config.set 钩子被询问之前就保存的问题
• macOS：修复了会话启动时的文件计数可能触及其他应用数据，并在会话从主文件夹或其上层启动时引发“访问其他应用的数据”提示的问题
• 改进了 Amazon Bedrock 上 Claude apps 网关背后的 token 计数，/context 和大文件读取会使用它：网关现在从 AWS 的 CountTokens API 获取，而不是发起单 token 的模型请求。授予 bedrock:CountTokens 以使用它
• 改进了 Claude apps 网关，在其 PostgreSQL 数据库为只读时每 30 秒记录一条警告，说明哪些操作失败以及如何恢复
• 改进了 Remote Control、claude.ai 和桌面应用中会话等待权限提示时的状态显示，现在会按服务器和可读名称来命名 MCP 工具，而不是用其 mcp__server__tool 标识符
• 改进了 Claude 应用网关背后的后台请求，改用 Haiku 4.5 而非会话的模型；在网关不提供 Haiku 4.5 的情况下回退到会话的模型
• 改进了 Claude 应用网关处理未列在 models: 下的模型的方式，适用于 AWS 美国地理范围之外的 Amazon Bedrock 区域。AWS 此前总是拒绝这些请求；网关现在会尝试在你所在区域使用该模型，若被拒绝则会指出需要添加的模型
• 改进了无头 rate_limit_event 用量限制警告，现在会说明该账户是否开启了额外用量
• 改进了内置的 plugin-authoring 技能：它不再让没有终端的会话运行终端命令，并且只在被询问时才解释如何分享 mod
• 改进了 Grep 输入处理：使用 grep 的 -l、-c 或 -r 标志发送的搜索现在会执行，而不是让调用失败
• 改进了 claude plugin validate 和插件加载：当某个 hooks 模块因顶层 var 被重新绑定而被拒绝时，错误现在会指出重新绑定它的那一行、原因以及修复方法
• 改进了 Workflow 工具的 scriptPath 拒绝提示：现在会说明应通过 script 内联传入脚本，这是在没有 Read 工具的会话中可行的方式
• 改进了当 Claude 发送的大文件上传失败且未给出原因时告知 Claude 的内容，使其报告失败而不是缩小文件
• 将模型通过工具搜索加载的 MCP 工具描述从 2,048 个字符改为截断于 16,384 个字符
• 将子代理改为从 skills 字段最多预加载 32 个技能，每个一次；拥有 Skill 工具的子代理仍可调用其余技能
• 将已附加后台会话空闲提示符处的 Ctrl+C 改为不打扰待处理的 /loop 唤醒，因此按两次会分离且循环继续运行；按 Esc 可停止它
• 将随其后台服务停止的 claude agents（macOS，或未安装该服务的 Linux）改为：正在运行的会话现在会在大约一分钟后停止，除非再次运行它，并会显示一条通知说明这一点
• 将 claude.ai 连接器改为在未获取任何标志的安装中默认协商 MCP 协议版本 2026-07-28；MCP_PROTOCOL_NEGOTIATION=legacy 可选择退出
• 将自身没有背景的 Artifact 页面改为以白色而非灰白色显示
• 更改了当 mod 在工具运行后拒绝工具调用时 Claude 和你读到的内容：现在会说明该工具已运行，且某个插件扣留了其结果
• 将制表位改为从文本开始处计数，而不是从屏幕左边缘计数：缩进 2 格的答案其第一个制表位在第 8 个单元格处，而原来是第 6 个
• 将禁用遥测时 Artifact 工具的权限提示改为与其他安装相同的五个问题，而不是在每次读取他人的 artifact 和每次数据编辑前都询问
• 将禁用遥测的安装中的定时运行和 Run now 例行运行改为发布新的私有 artifact，并更新你自己的，无需询问，与其他安装一致
• 将来自你所在组织的 mod 的 toast 改为显示在其他 mod 的 toast 之前，而不是排在它们后面等待
• 将 Claude 应用网关改为在启动时发出警告，并提供一个其捆绑的 Claude Desktop schema 不认识的 desktop 策略键，因此新的 Desktop 设置无需升级网关
• 更改了 WebSocket（ws）MCP 服务器：超过 16 MiB 的消息不再被解析并会关闭连接，这是其他传输方式已有的限制
• [VSCode] 新增了 Claude 发送给你的文件的聊天行：点击文件名可在编辑器中打开；Claude 的说明文字显示在下方，该行在 Focus 视图中保持可见
• [VSCode] 修复了在后台 agent 活动或面板自身状态行之后，“Fork conversation from here”和 Rewind 的对话恢复失败并提示“Message not found in session”的问题
• [VSCode] 修复了聊天输入框中的 Ctrl+Shift+Tab、Cmd+Shift+Tab 和 Alt+Shift+Tab 也会切换权限模式，以及 Ctrl+Tab 会接受建议提示词的问题
• [VSCode] 修复了同时可见的两个 Claude 视图之间键盘焦点来回跳动、可能导致输入的文本发送到错误对话的问题
• 自托管 runner：更改了 runner，不再将 CCR_AUTO_MODE_ALLOW、CCR_AUTO_MODE_ENVIRONMENT 和 CCR_AUTO_MODE_SOFT_DENY 传入会话的环境
• 自托管 runner：修复了在大型仓库上 git 服务器仍在报告进度时 git fetch 被中断的问题；CLAUDE_RUNNER_FETCH_SERVER_PROGRESS_CAP_MS 可调整或关闭该等待
• [Cloud sessions] 修复了取消归档云会话后立即发送的消息有时收不到回复的问题，原因是无法为其启动容器
• [Cloud sessions] 修复了一些较旧的 routine 在开始运行时从未将保存的提示词交给 Claude 的问题；这些 routine 现在会再次运行其提示词
• [Cloud sessions] 改进了云会话在连接断开后追赶的速度：你错过的活动现在会一次性全部出现，而不是逐行出现
• [Cloud sessions] 改进了云环境表单中的 setup script 框：初始高度更高，会随脚本增长，并可通过拖动调整大小
• [Claude Tag] 将 Claude 在 Slack 频道中发布设置确认卡片的时间从 10 分钟改为保持打开 30 分钟
• [Claude Tag] 将 Claude 关于跨 Enterprise Grid 工作区共享的频道使用组织默认值的通知改为仅在有人提及 Claude 时发布，每月最多一次
• [Claude Tag] 修复了分叉线程的“Continued from”卡片中的频道链接和 @ 提及显示为原始 Slack 代码的问题
• [Claude Tag] 修复了在 @Claude !restart 已确认重启后，Slack 的 Working 状态仍在某条线程下旋转的问题
• [Claude Tag] 修复了在 Claude 已停止读取未标记消息的繁忙频道中，其他应用或机器人的 @claude 得不到回应的问题
• [Claude Tag] 在 Claude Tag 管理设置中新增确认步骤：添加频道管理员会将该成员移至 Custom roles，这可能会移除其其他访问权限
• [Code Review] 修复了 Code Review 在早先发现的问题仍未解决时却称未发现问题的问题；评论现在会说明还有多少问题未解决
• [Code Review] 修复了当 pull request 编辑该文件时，Code Review 仍会跳过大型 CLAUDE.md 规则的问题
• 修复了在 xhigh 和 max effort 下，网页搜索和 agent hook 评估耗时过长的问题

来源：Claude Code：GitHub Releases · github.com