Claude Code v2.1.296 发布

Claude Code：GitHub Releases· ashwin-ant·2026-10-10 03:28· 56 分钟前AI 评分44

v2.1.296

AI 导读

Claude Code 发布 v2.1.296，为 Claude apps gateway 的 managed.policies[] 新增 code 键，并在 Claude Desktop 的 Code 标签页中启用 gateway 模式。

正文

What's changed

• 为 Claude apps gateway 的 managed.policies[] 新增了 code 键：与 cli 相同的设置，也会在 Claude Desktop 的 Code 标签页中应用；与 desktop 一起使用时，会开启 Claude Desktop 的 gateway 模式
• 为 subagent frontmatter 和 --agents 定义新增了 autoCompactWindow，使 subagent 可以比主对话的窗口更早地自动压缩
• 新增了 CLAUDE_CODE_WORKFLOW_SUBAGENT_MODEL，可让所有 workflow agent 运行在同一个模型上，而其他 subagent 保留各自的模型
• 新增了 CLAUDE_CODE_OVERLOADED_RETRY_MAX_DELAY_MS 环境变量，用于为重试过载（529）请求时的退避设置更长的最大延迟
• 在 /plugin 中新增了一条说明，针对某个插件因其 hook 被省略，因为另一个已启用的插件具有相同名称
• 为 Read 工具新增了 allow_large 选项，使 Claude 在需要整个文件且上下文有空间时，可以在一次调用中读取超出通常大小限制的文本文件
• 修复了 managed-settings 中 PreToolUse hook 以 "continue": false 拒绝工具调用的问题，以及 managed prompt hook 阻止工具调用的问题——它们会拒绝调用但不会结束回合
• 修复了 managed settings 中的 PostToolUse hook 在某些会话中未应用 updatedMCPToolOutput 的问题
• 修复了 headless 会话在更改目录或重新加载插件后，启动某个文件夹已被关闭的 .mcp.json 或插件 MCP 服务器的问题
• 修复了以 "gateway" 提供 allowedProviders 的 Claude apps gateway 会锁定在用户设置中指定该 gateway 的笔记本电脑的问题
• 修复了在 managed settings 将 forceLoginMethod 设为 gateway 且没有 forceLoginGatewayUrl 的机器上，已保存的 Claude apps gateway 登录被忽略的问题（2.1.295 中的回归）
• 修复了当会话历史无法读取时，--teleport 打开空对话的问题
• 修复了 Haiku 5.5 及其他仅采用自适应思考的模型的 token 计数问题——这些模型在某些 gateway 后面会失败，而在其他地方会按预算思考进行计数
• 修复了恢复的 subagent 被告知用户拒绝了某个因会话关闭而中断的工具调用的问题
• 修复了当 hook 输出包含类似插件提示标签的文本时，输出被更改的问题
• 修复了共享记录和调试日志中的密钥脱敏遗漏某些值的问题——这些值跟在没有值的键之后，包括写在 shell 字符串内的 JSON 中
• 修复了在较旧的基于 VTE 的终端（如 MATE Terminal）中复制后屏幕上打印出多余 52;c;… 转义序列的问题
• 修复了 toast 和通知在 /diff 面板或对话框打开期间一直未被看到地等待的问题
• 修复了在 UserPromptSubmit hook 或某个 mod 的 prompt.submit hook 期间按 Esc 或中断会导致 headless 会话结束、清空已输入的提示，或让未检查的提示通过的问题
• 修复了在 headless 会话启动后加载的插件的 SessionStart hook 被跳过的问题——当另一个同名或另一种拼写的插件已经运行过时
• 修复了 claude self-hosted-runner 在注册被拒绝时打印误导性错误的问题：现在它会指出组织管理员设置，或说明重启的按需运行器需要新的工作订单
• 修复了自托管运行器会话的 git fetch、pull 和 push 失败的问题——当同一仓库的另一个会话在 --capacity 大于 1 的运行器上启动时
• 修复了 workflow 脚本静默截断结果、agent 选项及其他嵌套深度超过约 20,000 层的值的问题，以及深层嵌套结果写入巨大任务输出文件的问题
• 修复了插件提供的 $ 方法在主会话的工作目录而非调用代理的工作目录中运行，并忽略其调用钩子所持有的轮次的问题
• 修复了 $.agent.register 在模组被重新加载或移除后仍从其钩子中成功执行的问题；现在该调用会被拒绝
• 修复了模组中的 $.http.fetch 在响应声明的 Content-Length 超过 4 MiB 正文限制时拒绝 HEAD 请求的问题
• 修复了 claude plugin marketplace add、marketplace update 和 plugin install 对名称类似 constructor 的市场失败并报内部错误的问题；add 现在会明确拒绝此类名称
• 修复了名为 constructor 或 prototype 的插件密钥在该插件选项的下一次保存时被删除的问题
• 修复了云会话在功能标志尚未加载时跳过自动模式对 Claude in Chrome 操作的检查的问题，而该操作已被保存的权限允许
• 修复了当 MCP 工具结果已结束该轮次时，CLAUDE_CODE_RESUME_INTERRUPTED_TURN 在重启后重新运行已完成轮次的问题
• 修复了 Bash 权限检查自动批准某些先赋值 BASH_ARGV0 shell 变量再使用它的命令的问题；这些命令现在会提示请求批准
• 修复了 Edit 和 NotebookEdit 在非有效 UTF-8（Windows-1252、Shift-JIS、GBK）文件中替换每个非 ASCII 字符的问题；此类编辑现在会被拒绝
• 修复了在 ← 之后立即发送的提示被运行两次的问题，其中一次在前台不可见，原因是后台服务响应缓慢
• 修复了在 SessionStart 钩子仍在运行时发送的提示在 ← 将会话移至后台时消失的问题；该提示仍不会发送，但 ↑ 现在会将其找回
• 修复了延迟加载插件的 SessionStart 钩子输出在无头会话中于 /clear 之后到达新对话的问题
• 修复了 PowerShell 命令看不到钩子写入 CLAUDE_ENV_FILE 的变量的问题（当该文件仅包含普通赋值时）
• 修复了当 MCP 服务器需要身份验证时，Claude 将云会话称为非交互式并建议使用 /mcp 或 claude mcp 的问题
• 修复了 /code-review 在云会话、Agent SDK 和 IDE 集成中以原始 JSON 数组结束的问题；发现结果现在以编号列表形式打印
• 修复了自动模式偶尔拒绝对自己工件的某次更新，声称其共享状态已更改而实际并未更改的问题
• 修复了当多个会话共享同一配置目录时，从 claude.ai 同步的技能永远无法完成安装，并在每次同步时被重新下载的问题
• 修复了从 claude.ai 同步的插件在其声明的市场依赖项同样从 claude.ai 同步时被禁用的问题
• 修复了在 macOS 上，当从 Linux 机器复制的插件路径指向 /home 下时启动挂起的问题
• 修复了 Workflow 工具拒绝带有 CRLF 行尾的脚本文件（例如在 Windows 上检出的文件）的问题
• 修复了 OpenTelemetry tool_result 事件在 git commit -q 或 git -C <dir> commit 之后缺少 git_commit_id 的问题
• 修复了当 CLAUDE_CODE_TRANSCRIPT_LOCAL_GC 的文本包含 Unicode 行分隔符或段落分隔符（U+2028、U+2029）时，从保存的转录中丢弃消息的问题
• 修复了当 claude purge 的文本包含 Unicode 行分隔符或段落分隔符（U+2028、U+2029）时，在历史文件中留下提示的问题
• Windows：修复了超过约 1 KB 的 PowerShell 命令总是请求权限的问题，因此允许规则和只读检测现在适用于最大 32 KB 的命令
• Windows：修复了 stdio MCP 服务器在关闭时被强制终止的问题；现在先关闭 stdin，仅当服务器在 300 毫秒后仍在运行时才终止进程树
• Windows：修复了在没有 GitHub SSH 密钥的机器上，GitHub owner/repo 插件源的 claude plugin install 失败的问题；现在会通过 HTTPS 重试克隆
• Windows：修复了 Git Bash 中的 rm -rf /c/Users/<name> 在绕过权限模式下不询问的问题
• 改进全屏模式：鼠标指针下的链接现在会显示下划线，以表明它可以被打开
• 改进了代码密集型对话中转录切换（ctrl+o）的响应速度，通过缓存语法高亮的代码块实现
• 改进了 Claude 应用网关后 Claude Desktop 的代码标签页：当会话无法启动时，包括在未针对网关的 code 设置进行配置的机器上，原因会以回复形式显示
• 改进了被拒绝的云会话的错误提示：现在会说明为何无法加载你组织的策略，并指出覆盖你 claude.ai 登录的 API 密钥或认证令牌
• 改进了 --debug 输出，可指出自定义代理文件中无法识别的前置元数据字段，并针对可能的拼写错误给出提示
• 改进了自动模式：因自动模式的检查没有可用答案而未运行的工具调用，现在显示为灰色的“未运行”行，而不是红色错误
• 改进了钩子的 --debug 输出：工具调用、提示词、SessionStart 和 Stop 上的命令钩子现在会在完成时记录其命令、插件、结果和耗时，因此可以识别出缓慢的钩子
• 改进了 CLAUDE_CODE_TRANSCRIPT_LOCAL_GC：当重写大型转录文件只能释放不到 10% 的空间时，不再进行重写
• 更新了 /cost、状态行、--max-budget-usd 以及 SDK 的成本数据，将 Sonnet 5.5 缓存读取定价为每百万 token 0.10 美元（原为 0.20 美元）
• 更新了内置的数据可视化技能：浅色模式下第七个系列使用更浅的紫色，深色模式下使用更柔和的主文本，以及像 1K 这样的紧凑 y 轴标签
• 将预先发送的 MCP 工具描述和 MCP 服务器指令的默认限制从 2,048 个字符改为 4,096 个字符
• 更改了 ←：当会话转入后台时启动的一轮对话或 ! 命令现在会被停止，而不是在视线之外继续完成
• [VSCode] 修复了扩展设置中缺失 claudeCode.spinnerVerbs 的问题，因此 settings.json 现在可以补全并验证它；格式错误的值不再导致聊天面板崩溃
• [VSCode] 更改了 Chrome 中的 Claude，使其在每个会话中执行浏览器操作前都会询问，包括通过 @browser 连接的会话，与终端的行为一致；为会话允许某个网站后不再重复询问
• [VSCode] 修复了以完整 Windows 路径编写的聊天链接（如 C:\repo\file.ts 或 file:///C:/repo/file.ts）在 Windows 上无法打开文件的问题
• [VSCode] 修复了在你的操作系统、VS Code 中或通过 prefersReducedMotion 设置开启减少动态效果时，工作指示器仍在动画的问题
• [VSCode] 修复了面板延迟赶上消息（例如显示器关闭或远程窗口重新连接后）时，提示缓存时钟显示为热的问题
• [云会话] 在管理设置中自托管环境的 Activity 标签页的 Sessions 和 Runners 列表中添加了状态筛选器；你可以同时选择多个状态
• [云会话] 修复了所有等待自托管运行器的云会话显示相同队列位置的问题；现在每个会话都会显示其前面有多少个会话
• [云会话] 修复了在云会话中 Claude 仍在回复时你发送的消息在该回复完成后跳到其上方的问题；现在它会保持在下方，包括重新加载后
• [Claude Tag] 更改了 Slack 中的 Claude，使其仅在线程中最新的回复上显示带有会话链接、模型和成本的页脚；其前一条回复不再显示页脚
• [Claude Tag] 修复了 Claude 的部分 Slack 回复和任务清单中包含括号的 URL 链接损坏的问题，该问题会显示多余的括号文本并打开错误的页面
• [Claude Tag] 修复了 Claude 的 Slack 回复在仅看起来像十六进制颜色的代码（例如六位数的拉取请求编号）旁边绘制色块的问题
• [Claude Tag] 为拥有 Claude Tag Admin 权限的成员，在 Activity 页面的 Memory 标签页中新增了创建、编辑和删除工作区及频道记忆文件的功能
• [Claude Tag] 修复了 Claude 在 Slack 频道中发布的插件确认卡片显示插件 ID 而非插件名称的问题
• [Claude Tag] 修复了 Claude 在 Slack 中发布卡片以移除频道自身设置中不包含的插件的问题；现在会改为说明该插件的来源
• [Claude Tag] 修复了在自托管环境中，当会话在任务进行中途迁移到新的 runner 时，Claude 在 Slack 中有时会丢失回复的问题
• [Code Review] 修复了 Code Review 检查在审查完成后有时仍停留在拉取请求上显示“进行中”的问题；现在会显示审查结果
• [Code Review] 改进了 Code Review 管理设置，在设置无法保存时会说明原因（例如策略限制），而不再显示通用的失败消息

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