Claude Code 2.1.295 到 2.1.296 更新：hooks 可以“失败就拦截”，修复 GBK 文件被改坏

2026 年 10 月 8 日和 9 日，Claude Code 发布了 2.1.295 和 2.1.296。两个版本加起来有 220 多条改动，对日常使用影响最大的是三点：

• 用 hooks 做防护的人，可以让 hook “失败就拦截”了。 之前 hook 自己出了问题（启动不了、超时），操作会被放行。
• 项目里有 GBK 等非 UTF-8 编码文件的人，建议升到 2.1.296。 之前编辑这类文件会把里面的中文全部替换掉。
• 子代理可以比主对话更早自动压缩上下文，还可以让所有工作流代理统一用一个模型。

这是 2.1.292 到 2.1.294 之后的两个版本。下面按“对你有什么影响”整理，不逐条翻译更新日志。

和安全有关的

hooks 新增 onFailure: "block"（2.1.295）

命令类型和 HTTP 类型的 hooks 现在可以设置 onFailure: "block"。设置之后，hook 如果启动不了、超时，或者以意料之外的退出码结束，对应的操作会被拦住，而不是放行。

如果你靠 hook 来阻止某些操作，这个选项值得加上：没有它，hook 本身坏掉的时候，等于没有防护。

非 UTF-8 文件不再被改坏（2.1.296）

Edit 和 NotebookEdit 之前在编辑不是合法 UTF-8 的文件时（更新日志点名了 Windows-1252、Shift-JIS 和 GBK），会把文件里所有非 ASCII 字符都替换掉。现在这类编辑会被直接拒绝。

对中文用户来说，这意味着老项目里的 GBK 文件不会再被悄悄改坏；但 Claude 也改不了它们，需要先把文件转成 UTF-8。

权限检查的几处修复

• 给 BASH_ARGV0 这个 shell 变量赋值再使用的某些命令，之前会被自动批准；现在会询问（2.1.296）。
• Windows 的 Git Bash 里，rm -rf /c/Users/<用户名> 在跳过权限确认的模式下之前不会询问（2.1.296）。
• Windows 上超过约 1 KB 的 PowerShell 命令之前总是要求确认；现在允许规则和只读判断对 32 KB 以内的命令都生效（2.1.296）。
• 对通配符做 for 循环的 Bash 命令，权限检查更准确（2.1.295）。
• 托管设置里的 PreToolUse hook 用 "continue": false 拒绝一次调用时，之前只拒绝了调用，没有结束这一轮（2.1.296）。
• 按 Esc 或中断时，如果 UserPromptSubmit hook 还在运行，之前可能让没检查过的提示词通过（2.1.296）。
• 一个 mod 的 hook 拿到嵌套很深的工具输入时，之前会被悄悄截断，防护可能放过它没看到的内容（2.1.295）。
• macOS 上在主目录或更上层启动会话时，开头的文件计数可能碰到其他应用的数据，弹出“访问其他应用数据”的提示（2.1.295）。

新功能

子代理的自动压缩可以单独设置（2.1.296）

子代理的定义里（frontmatter 或 --agents）可以写 autoCompactWindow，让它比主对话更早自动压缩上下文。

工作流里的代理统一用一个模型（2.1.296）

新增环境变量 CLAUDE_CODE_WORKFLOW_SUBAGENT_MODEL：所有工作流代理用同一个模型，其他子代理保持各自的设置。想让工作流里的大量代理跑在便宜的模型上，可以用它。

一次读完大文件（2.1.296）

Read 工具新增 allow_large 选项：当 Claude 确实需要整个文件、上下文也放得下时，可以一次读完超过平常大小限制的文本文件。

终端能显示 Claude Code 的状态（2.1.295）

支持 Program Status Protocol（OSC 7501）。实现了这个协议的终端可以显示 Claude Code 是在工作、在等你，还是已经做完。

过载重试的等待时间上限（2.1.296）

新增 CLAUDE_CODE_OVERLOADED_RETRY_MAX_DELAY_MS，可以把遇到过载（529）后重试的最长等待时间设得更长。它和上一批版本加的 CLAUDE_CODE_OVERLOADED_RETRY_BASE_DELAY_MS 是一对。

2.1.295 另外加了 CLAUDE_CODE_RETRY_WATCHDOG_MAX_WAIT_MS，用来限制无人值守重试模式等待 429 和 529 错误的最长时间。

其他小改进

• /copy 的选择列表里多了“引用的文字”，复制一段草稿时不带开头的 >（2.1.295）。
• claude -p 在最后一轮之后还没退出时，会在终端里说明它在等什么（2.1.295）。
• --debug 会指出自定义代理文件里不认识的 frontmatter 字段，并提示可能的拼写错误（2.1.296）。
• --debug 里 hooks 的日志更完整：命令、所属插件、结果和耗时，方便找出拖慢速度的 hook（2.1.296）。
• 写 mod 的人：新增 $.ui.notify，可以发系统通知；Button 可以带子元素（2.1.295）。

行为变化

• 价格显示更新（2.1.296）：/cost、状态栏、--max-budget-usd 和 SDK 里的花费，现在按每百万 token 0.10 美元计算 Sonnet 5.5 的缓存读取（之前是 0.20）。降价本身见 Claude Haiku 5.5 发布。
• MCP 工具描述的长度上限：一开始就发给模型的 MCP 工具描述和服务器说明，默认上限从 2,048 个字符提到 4,096（2.1.296）；通过工具搜索加载的描述，上限从 2,048 提到 16,384（2.1.295）。
• 子代理预加载的 skills 最多 32 个（2.1.295）。有 Skill 工具的子代理仍然可以调用其余的。
• 按 ← 把会话转到后台时，这期间新开始的一轮或 ! 命令会被停掉，不再在看不见的地方继续跑完（2.1.296）。
• 在已连接的后台会话里按 Ctrl+C，不再取消等待中的 /loop；按两次是断开连接，循环继续。要停掉它按 Esc（2.1.295）。
• claude.ai 的连接器默认协商 2026-07-28 版本的 MCP 协议；遇到兼容问题可以设置 MCP_PROTOCOL_NEGOTIATION=legacy（2.1.295）。

值得知道的修复

Windows（2.1.296）

• 关闭时本地（stdio）MCP 服务器不再被强行杀掉：先关闭输入，300 毫秒后还在运行才结束进程。
• 没有 GitHub SSH 密钥的机器上，claude plugin install 安装 owner/repo 形式的插件来源会失败；现在会改用 HTTPS 重试。
• hooks 写进 CLAUDE_ENV_FILE 的变量，PowerShell 命令之前看不到。
• 工作流工具之前拒绝 CRLF 换行的脚本文件，比如在 Windows 上检出的文件。

MCP（2.1.295）

• 无界面和 SDK 会话里，远程 MCP 服务器在断线超过 15 秒后会一直连不上，或者对一个一连上就断的服务器不停重连；现在重连会逐步放慢。
• MCP 工具返回的 CSS、JavaScript、XML 文件之前被存成 .bin，Read 工具会拒绝读取。

会话

• SessionStart hook 写进 CLAUDE_ENV_FILE 的变量，在应用内 /resume 或 /branch 之后传不到 Bash 工具（2.1.295）。
• 引用层层嵌套的回复会让终端卡住几秒并占用几个 GB 的内存（2.1.295）。
• 后台会话里的命令和 hooks 继承了 FORCE_COLOR=3，Claude 读到的输出里混进了颜色控制码（2.1.295）。

版本一览

版本	发布日期	要点
2.1.295	10 月 8 日	hooks 的 onFailure: "block"、终端状态协议、MCP 重连修复、子代理预加载 skills 的上限
2.1.296	10 月 9 日	修复非 UTF-8 文件被改坏、子代理的 autoCompactWindow、Read 的 allow_large、多项 Windows 修复

发布日期按 GitHub 上版本说明的时间（UTC）。两个版本里还有大量针对 Claude apps gateway、VS Code 扩展、云端会话、Slack 里的 Claude 和代码评审的改动，这里没有展开，完整的条目请看官方更新日志。