开源Claude Code Releases·原文 2026年10月10日

Claude Code v2.1.296为网关策略新增code键,修复非UTF-8文件编辑被静默替换等问题

Anthropic发布Claude Code v2.1.296,在网关托管策略中加入code键以把同一套设置应用到Claude Desktop的Code标签页;同时修复大量缺陷,包括Edit/NotebookEdit对非UTF-8编码文件逐字符替换、以及Windows上超过约 1KB的PowerShell命令总是要授权等问题。

Claude Code发布v2.1.296。该版本在Claude apps gateway的managed.policies[] 中新增code键,其设置内容与cli相同,同时应用于Claude Desktop的Code标签页;与desktop并列使用时,会开启Claude Desktop的网关模式。

版本还新增若干配置项:subagent frontmatter与 --agents定义支持autoCompactWindow,让子代理可以比主对话更早自动压缩;环境变量CLAUDE_CODE_WORKFLOW_SUBAGENT_MODEL可让所有工作流代理使用同一模型,而其他子代理保持各自模型;环境变量CLAUDE_CODE_OVERLOADED_RETRY_MAX_DELAY_MS用于设置 529 过载重试退避的最大等待时间;Read工具新增allow_large选项,在需要整个文件且上下文有余量时一次性读取超出通常大小限制的文本文件。

新增功能与配置项

网关策略新增code键:与cli相同的设置也会应用到Claude Desktop的Code标签页,并在与desktop并列时开启Claude Desktop网关模式。

/plugin中会对钩子被省略的插件给出提示,原因是另一个已启用插件与其同名。

/cost、状态栏、--max-budget-usd和SDK的成本统计更新:Sonnet 5.5缓存读取按每百万tokens 0.10美元计费,此前为 0.20 美元。

内置dataviz技能更新配色与坐标轴标签;MCP工具描述与服务端指令的默认上限由 2,048 字符改为 4,096 字符。

“←”行为变更:会话转入后台时启动的一轮对话或“!”命令会被停止,而不是在后台继续跑完。

缺陷修复:编辑与转录

Edit和NotebookEdit此前会替换非UTF-8文件(Windows-1252、Shift-JIS、GBK)中的每一个非ASCII字符,现在此类编辑会被拒绝。

secret redaction此前会漏掉部分值(包括shell字符串内JSON中无值键后面的内容),现已修复。

CLAUDE_CODE_TRANSCRIPT_LOCAL_GC此前在消息文本含U+2028、U+2029时会丢弃已保存转录中的消息;claude purge也会在历史文件中留下同样含这些字符的提示。

钩子输出中包含类似插件提示标签的文本时会被改动的问题已修复;在旧VTE终端(如MATE Terminal)复制后屏幕出现 52;c;… 转义序列的问题也已修复。

权限与钩子行为

托管设置中拒绝工具调用的PreToolUse钩子(continue: false)以及阻止调用的prompt钩子,此前会拒绝调用但同时结束该轮对话,现已修复。

在UserPromptSubmit钩子或mod的prompt.submit钩子期间按Esc或中断,此前会结束无头会话、清空已输入提示或让未经检查的提示通过,现已修复。

Bash权限检查此前会自动批准部分先给BASH_ARGV0赋值再使用它的命令,现在会要求授权。

Windows上,超过约 1KB的PowerShell命令此前总是要求授权;现在允许规则和只读检测可覆盖至 32KB。

Windows、IDE与其他平台修复

Windows方面:stdio MCP服务器在关闭时不再被强制杀死,改为先关闭stdin,300 毫秒后仍在运行才终止进程树;claude plugin install对GitHub owner/repo插件源在无GitHub SSH密钥的机器上会改用HTTPS重试;Git Bash中rm -rf /c/Users/在bypass permissions模式下不再要求确认。

VS Code扩展方面:claudeCode.spinnerVerbs现在出现在扩展设置中并可补全与校验,格式错误的值不再导致聊天面板崩溃;Claude in Chrome在每个会话中执行浏览器操作前都会询问,包括通过 @browser连接的会话;Windows完整路径形式的聊天链接(如C:\repo\file.ts)现在可以打开。

成本与计费变更

Sonnet 5.5缓存读取改为每百万tokens 0.10美元,之前为 0.20 美元;该价格适用于 /cost、状态栏、--max-budget-usd以及SDK的成本数字。

信息来源