Claude Code v2.1.328 发布,扩展自动模式并修复大量稳定性问题
v2.1.328
Claude Code v2.1.328 为 Claude Opus 4.6 和 Sonnet 4.6 扩展自动模式,并增强 MCP hook、Code Mode 与自托管运行器。该版本还修复会话恢复、权限提示、远程控制、MCP 工具及终端交互等大量问题,同时改善大型会话恢复速度、内存占用和 Code Mode 性能。
推荐理由
AI 评分 60
版本集中改进自动模式、Code Mode、远程会话与自托管运行器,可用于评估复杂开发工作流的稳定性变化。
主题
正文 · AI 翻译
## 变更内容
- 在 Amazon Bedrock、Google Cloud 的 Agent Platform、Microsoft Foundry 和 Claude apps gateway 上为 Claude Opus 4.6 与 Sonnet 4.6 添加了自动模式;未设置权限模式的交互式会话会以该模式启动 - 为 `mcp_tool` hook 添加了 `"onFailure": "block"`,其行为与命令和 HTTP hook 相同:调用失败的 hook 会阻止相应操作 - 新增警告:来自跳过权限提示的会话的消息可能被云会话暂存后丢弃 - 当 OpenTelemetry exporter 未设置 endpoint、其数据很可能丢失时,在 `/status` 和 `claude doctor` 中新增提示 - 新增 `CLAUDE_CODE_DISABLE_DEFERRED_TOOL_RESUME`,允许 host 阻止 `claude -p --resume` 和 `--continue` 执行被 hook 延迟的工具调用 - 支持嵌入 Claude Code 的应用启用策略插件的 `allowManagedModsOnly` 选项;管理员的托管设置仍具有更高优先级 - 当策略中的 `maxEffortLevel` 不是有效的 effort level 时,在 Claude apps gateway 启动时新增警告 - 自托管运行器:新增 `--repository-folder`,用于在 `--capacity 1` 时指定会话使用的仓库文件夹名称,取代基础文件夹下不能为符号链接的仓库路径 - 自托管运行器:当 host 的 settings.json 设置了会话会忽略的默认权限模式时,新增启动警告 - 自托管运行器:为 `claude self-hosted-runner orchestrator` 新增 `--hook-label`,以便将选定的会话标签传递给 `spawn-runner` hook - 自托管运行器:为 `claude --environment` 新增 `--metadata key=value`,以便为会话添加供 `spawn-runner` hook 使用的标签 - 自托管运行器:在 orchestrator 的 `/metrics` 中新增 `claude_code_self_hosted_orchestrator_session_queue_wait_by_reason_seconds`, 从而区分重新打开的会话与新会话的等待时间 - 自托管运行器:新增 orchestrator 指标 `claude_code_self_hosted_orchestrator_sessions_given_up_total`,按原因统计 Anthropic 放弃为会话启动运行器的次数 - 修复了 zsh 中的 Bash 命令在以 `=` 开头的单词处因“not found”错误而停止的问题,例如 `echo ====` 或 `[ a == b ]`;`=cmd` 不再展开为命令路径 - 修复了自动压缩复用会话先前的 system prompt,而不是像 `/compact` 那样重新构建它的问题 - 修复了 markdown 渲染在某些超长或格式错误的输入上冻结的问题 - 修复了少数情况下的屏幕冻结问题 - 修复了在权限提示或问题出现后立即输入时,Esc 经常丢失的问题;在将 Alt 作为 Esc 加按键发送的终端中,未被占用的 Alt 或 Option 键现在会在此处执行拒绝操作 - 修复了慢速连接将粘贴内容或终端回复拆成两部分时,它们被输入到提示词中的问题 - 修复了在第三方 provider 上,或关闭 telemetry 或 feature flag 时,如果无法读取定时任务文件,保存某个定时任务会清除项目中其他已保存任务的问题 - 修复了项目定时任务文件中含有拼写错误的定时任务,会在下次保存该文件时被删除的问题 - 修复了已恢复的云会话在消息较晚保存时,可能丢失压缩摘要或近期消息的问题 - 修复了 spinner 和 subagent 的 token 计数问题:重试的回复会被重复计算,未以流式方式返回的回复会漏算,而且在 Claude 思考时计数会停滞 - 修复了响应过程中用量额度耗尽时显示的错误,该错误此前被称为速率限制 - 修复了在 Bedrock、Agent Platform、 Foundry 或 Claude apps gateway 上,通过拒绝 beta 的 gateway 并设置 `CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS` 后,自动模式在 Claude Desktop 之外每一轮都会失败的问题 - 修复了 `CLAUDE_STREAM_IDLE_TIMEOUT_MS` 无法延长 gateway、自定义 base URL 和云 provider 上 5 分钟连接时限的问题 - 修复了第三方 provider 上的部分 Claude Desktop 会话(定时任务除外)在出现大型工具结果后,因“Prompt is too long”而永久结束的问题;现在会排除其中最大的结果 - 修复了在第三方 provider 上,或关闭 telemetry 或 feature flag 时,输入 schema 以 `anyOf`、`oneOf` 或 `allOf` 开头的 MCP 工具消失的问题 - 修复了在第三方 provider 上,或关闭 telemetry 或 feature flag 时,输入 schema 无效的 MCP 工具导致请求失败的问题;现在会排除该工具,并告知 Claude 原因 - 修复了当 Bedrock、Google Cloud 的 Agent Platform 或 Foundry 拒绝 subagent 进度摘要的 effort 设置时,该 subagent 的模型在本次会话中被关闭 effort 的问题(2.1.327 中的回归) - 修复了在自动模式或绕过模式之外,权限提示、计划批准或问题保持打开十分钟后,Code Mode 会停止脚本的问题 - 修复了自动模式和绕过权限模式下的 Code Mode 脚本无法调用在前一个脚本运行期间连接的 MCP server 的问题 - 修复了在 `claude --resume` 选择器中选定的会话里,Code Mode 脚本在自动模式或绕过权限模式下无法在后台运行的问题 - 修复了 Code Mode 丢失已加载的 skill、 在恢复一个某条回复运行了多个脚本的会话时,丢失 hook 上下文或随权限批准输入的备注的问题 - 修复了从选择器恢复会话,或在需要请求权限的模式下恢复会话时,Claude 未被告知 Code Mode 脚本已被截断的问题 - 修复了 Code Mode 对先前失败脚本从未设置的顶层变量静默使用 `undefined` 的问题 - 修复了 Code Mode 脚本未被告知失败命令的长输出已被截断的问题 - 修复了 Code Mode 拒绝以 `{` 代码块开头的有效脚本的问题 - 修复了 Code Mode 拒绝同时使用顶层 `await` 和顶层 `return` 的脚本的问题 - 修复了脚本读取或写入通过 @ 提及的小文件后,该文件未在 Code Mode 中作为附件添加的问题 - 修复了 Code Mode 向无法调用 `write()` 和 `edit()` 的只读 subagent 提供这两个函数的问题 - 修复了在 Code Mode 中按 Esc 后执行 `/model` 等命令时,Claude 会自行开始一个 turn 的问题 - 修复了 Code Mode 中的 Claude 未被告知仅在用户要求时运行 workflow,也未获知用户在 `/config` 中设置的 workflow 大小的问题 - 修复了 Remote Control 重复显示相同的断开连接消息,并要求用户重试无法重新连接的会话的问题 - 修复了远程会话在服务响应缓慢时重启,会导致等待中的权限提示丢失且其答案被忽略的问题 - 修复了 rewind 后执行 `/clear`,云端会话仍恢复已清除对话的问题 - 修复了在模型流中断并重试后,若远程会话的 runner 或 worker 丢失,该会话会丢失某个 turn 的工具调用及结果的问题 - 修复了刚启动或标题中含有 @ 的云端及 Remote Control 会话,无法从已开启 Remote Control 的会话通过跨会话消息访问的问题 - 修复了 Claude 被告知云端会话永远无法回复的问题; 它现在会了解何时可以收到回复,以及还能通过哪些方式获取结果 - 修复了命令进入另一个 repository 后,`/diff`、Remote Control 会话的 Changes 面板以及编辑操作旁的 diff 会遗漏已提交工作的问题 - 修复了由 IDE 扩展或其他 SDK 应用运行的会话,在 workflow 上次取得进展一小时后才通过 Remote Control 打开时,Remote Control 不显示运行中 workflow 的 agent 的问题 - Remote Control:修复了开启 Remote Control 后,空闲的 Desktop 或 VS Code 会话显示为运行中的问题 - 修复了 SDK 中断已停止后台 agent 后,模型仍称这些 agent 正在运行的问题 - 修复了桌面应用和 SDK host 中的 Send now 会告知 Claude 已停止的 web search 未找到结果的问题 - 修复了在会报告 Cmd 键的终端中,Cmd+字母会被输入到 prompt 的问题 - 修复了全屏模式下 Ctrl+点击会在 GNOME Terminal 中打开链接两次、鼠标侧键会被当作点击,以及暂停后向另一方向滚动时第一个滚轮刻度被忽略的问题 - 修复了 tmux 和 ssh 之外的 Konsole 中 Shift+Enter 无效,以及在支持 kitty keyboard protocol 的终端里,非拉丁键盘布局上的 Alt 快捷键无效的问题 - Linux:修复了安装 `xclip` 或 `wl-copy` 时,Claude Code 通过 Ctrl+Z 暂停后,在其他应用中粘贴会卡死的问题 - Linux:修复了 Ctrl+V 无法获取剪贴板图像、粘贴旧图像或卡住的问题 - 修复了在全屏模式下复制的文本包含引用栏、向上拖动滚动时丢失换行处的空格,或遗漏“Jump to bottom”浮层下方单词的问题 - 修复了粘贴到 `!` 命令中的图像路径会变成附件的问题 - 修复了打开 `?` 快捷键列表时,Ctrl+C 不显示退出警告的问题 - 修复了在全屏模式的 Ctrl+R 搜索和 `/theme` 颜色编辑器中,按键同时到达时会选错行,以及这些界面和 `/config`、`/plugin` 的搜索中会丢失按键的问题 - 修复了 GNU screen 中颜色错误或缺失的问题 - 修复了在全屏模式下,大量后台通知会侵入已打开对话框顶部边框的问题 - 修复了发送给后台 agent 的消息会以很长的文件路径代替粘贴图像的问题 - 修复了当某个 skill 的 Stop hook 与另一个 hook 的措辞相同时,`/goal` 会移除前者或因后者的结果提前结束的问题 - 修复了报告已发送后 `/bug` 仍显示已取消的问题 - 修复了 Pro 和 Max 用户按 Esc 无法关闭 transcript 分享询问的问题 - 修复了在 `/hooks` 中返回时丢失当前位置的问题 - 修复了未填写名称时,`/export` 会写入名为 `.txt` 的文件的问题 - 修复了 Zed 中的 `/terminal-setup` 会用普通文件替换符号链接的 `keymap.json` 的问题 - 修复了要求更新现有 workflow 文件时,`/install-github-app` 却添加新的 code review workflow 的问题 - 修复了在 `/plugin` 中返回后,若缓慢的保存或移除操作才完成,会重新打开某个 skill 或关闭当前页面的问题 - 修复了在更改仍在进行时离开某个 plugin 后,`/plugin` 会询问是否卸载错误的 plugin,或忽略 Esc 的问题 - 修复了搜索无结果或点击标签栏后,`/plugin` 的 Installed 标签页中无法输入或使用方向键的问题 - 修复了在 `/plugin` 中长按 Enter 会关闭多个已安装 plugin 的问题 - 修复了在 1M context 模型上,`/usage` 的 plugin token 总数会停在 2,000,以及未选择模型时 `/usage` 和 `/plugin` 中 token 估算偏低的问题 - 修复了在 Bedrock access keys 步骤按 Esc 会关闭 `/login` 而不是返回上一步的问题 - 修复了 `/exit` 和 Ctrl+D 对运行中工作的描述不一致的问题, 并修复了 `/exit` 对已停止的 workflow 发出警告的问题 - 修复了 Claude 在读取共享文件夹中的 artifact 或将 artifact 发布到其他组织后,将其称为私有 artifact,以及声称只有指定人员才能打开、却未说明其文件夹中的人员也能打开的问题 - 修复了某个 plugin 的 toast 有时会显示另一个 plugin 的文本的问题 - 修复了在某一轮开始后立即保存的修改有时会在该轮进行中重新加载,而不是在该轮结束时重新加载的问题 - 修复了一个格式错误的 `OTEL_RESOURCE_ATTRIBUTES` 条目会导致该变量的其他标签从指标点、事件和 span 中丢失的问题。现在只会忽略该条目 - 修复了请求因过大而被拒绝后,agent hook 在压缩期间运行超过超时时间的问题 - 修复了 `FORCE_COLOR` 被设为负数时启动崩溃的问题 - 修复了机器内存几乎耗尽时,secret masking 发生崩溃的问题 - 修复了在 Linux 上,当分支名称不是有效 UTF-8 时,Bash sandbox 会在每条命令执行后重命名 `.git/HEAD` 的问题 - 自托管运行器:修复了代理或 Web 过滤器以 HTTP 200 和 `{}` 等响应体回复轮询时,所有运行中会话都会停止的问题;运行器现在会重试此类轮询 - 自托管运行器:修复了临时磁盘错误后,保留的 clone 中的 object、ref 以及仅存在于其中的 commit 会被删除的问题;现在该次启动会改为失败 - 修复了在时钟偏慢或被调回的主机上,自托管运行器会在 token 到期时停止的问题 - 自托管运行器:修复了使用 Anthropic 托管 git 的会话中,脚本或 hook 再次运行 `claude` 后会失去对 GitHub 的 git 访问权限的问题 - 修复了使用 Anthropic 托管 git 的自托管运行器在机器的 git 配置设置了 `http.proactiveAuth` 时无法 fetch 或 push 的问题 - 自托管运行器:修复了运行器注册后若设置失败,会直接退出而不通知服务器的问题; 现在它会注销并说明原因,按需运行器也会报告启动失败 - 自托管运行器:修复了会话在等待另一个会话准备同一 repository(`--capacity` 大于 1)期间,对其进行归档或重新排队不会生效的问题 - 自托管运行器:修复了 `.claude.json` 损坏的会话在 `--trust-workspace false` 下每次后续启动都会失败的问题;现在它会使用默认设置启动,并再次关闭其中的 MCP server - 自托管运行器:修复了 checkout hook 或 git 输出大量内容时,启动失败消息会丢失说明具体失败项的文字的问题 - 修复了磁盘停顿数秒时,自托管运行器会跳过会话后 hook 的问题;如果磁盘失效,会话结束默认最多可能多花 25 秒 - 修复了自托管运行器的问题:会话在新的 Claude 配置目录中恢复时,不再丢失任务列表 - 修复了自托管会话在缺少其中一个 repository 的情况下启动时,Claude 不会获知此事及其原因的问题 - 自托管运行器:修复了 `claude --environment` 的 `--correlation-id` 无法传递给 `spawn-runner` hook 的问题 - 修复了自托管运行器设置向导中的密钥轮换建议;现在它会警告,撤销密钥会停止使用该密钥运行的会话 - 改进了 `claude -p` 和 SDK 会话:现在会在后台获取拥有独立 git repository 的 managed-settings plugin,供后续会话使用 - 改进了在新机器上的 `claude -p`、SDK 和 Claude Desktop 会话中,从 git marketplace 获取的 managed-settings plugin 的加载速度; 短时间运行最多可能会晚 30 秒退出 - 提升了大型会话的恢复速度 - 改善了恢复包含大量图片的会话时的内存占用 - 改善了运行缓慢命令或工具的长时间 SDK 和 Desktop 会话中的内存占用与响应速度 - 移除了大多数脚本执行后的 0.75 秒暂停,提升了 Code Mode 在 auto 和 bypass-permissions 模式下的速度 - 改进了带有 MCP server 的新 Code Mode 会话的 prompt caching;现在,当 server 仍在连接以及 server 列表发生变化时,Claude 也会收到通知 - 通过缩短工具描述,减少了 Code Mode 的 token 使用量 - 改进了 Code Mode,使其在脚本运行期间显示正在执行的命令及其输出 - 改进了 Code Mode 的编辑操作:未产生任何变化的编辑不再停止脚本,并且会告知 Claude 失败编辑的匹配位置或最接近的匹配位置 - 改进了 Code Mode:脚本失败时,现在会告知 Claude 哪些工具调用仍在运行 - 改进了 Claude 在 Code Mode 的 auto 和 bypass 模式下启动开发服务器的方式:现在会告知 Claude 将其作为后台任务运行,并显示在 `/tasks` 中 - Windows:改进了 Code Mode,告知 Claude 脚本的 shell 命令在 Git Bash 中运行,并且 PowerShell alias 会优先于同名 function 执行 - 改进了同时启动多个进程内 teammate 的体验:现在因“Lock file is already being held”而失败的情况大幅减少 - 改进了 computer use 审批对话框:现在会显示每个应用的访问级别,并使用更直白的警告 - 改进了跨会话消息传递:当云端会话或另一台计算机未列出时,Claude 现在会说明 Remote Control 已关闭 - 改进了 `claude -p` 的文本输出:当来自另一会话的消息被暂存或丢弃时,现在会在 stderr 中说明, 以及如何允许该消息 - 改进了 Claude 对“谁可以打开它发布的 artifact”的回答:现在会要求 Claude 再次检查 artifact,而不是重复上次发布时的回答 - 改进了恢复的自托管 runner 会话:Claude 现在会检查先前的工作是否仍然存在,并说明缺失了什么 - 更改了第三方提供商上 Opus 4.6 和 Sonnet 4.6 的 plan mode 和 Bash prompt,使其像较新的模型一样使用并提供 auto mode;`disableAutoMode` 会同时关闭二者 - 更改了 Code Mode,使其不再对脚本输出运行 UserPromptSubmit hook,包括 managed hook;如需编辑该输出,请使用带有 `updatedToolOutput` 的 PostToolUse hook - 更改了大多数模型上的 `/code-review`,使其仅报告 bug 和违反 CLAUDE.md 的问题;如需进行复用、简化和效率方面的清理,请运行 `/simplify` - 更改了大多数模型上的 `/code-review`,为每项发现标记 Important、Pre-existing 或 Nit,并在每份摘要末尾给出建议的修复方案;无问题的 review 列表现在会显示“Code review found no issues.” - 更改了形如 `claude.ai ` 的 `deniedMcpServers` 条目,使其也适用于云端和自托管 runner 会话中的相应 connector - 更改了 managed `PostToolUse` hook,使其不再因执行前即被拒绝的调用而触发:此时不会产生日志条目,也不会进行重写、阻止或停止;`PostToolBatch` 会收到其中大多数调用,但不会标记为已拒绝 - 更改了 `/bug`,使其在发送前要求选择 Yes 或 No,因此反复按 Enter 不再发送报告或打开 GitHub - 更改了 `claude -p`、Agent SDK、桌面端和 VS Code 中的 subagent:设置 `CLAUDE_CODE_FORK_SUBAGENT=0` 时,它们现在默认等待自己的 subagent - 更改了设置 `CLAUDE_CODE_FORK_SUBAGENT=0` 的 `claude -p`,使一个后台 subagent 及其等待的 subagent 共用一次 10 分钟的等待时限; 如需支持更长的链路,请提高 `CLAUDE_CODE_PRINT_BG_WAIT_CEILING_MS` - 更改了由 PermissionRequest hook 重写为 sandbox-excluded 命令的 shell 命令,使其在 sandbox 外运行 - 更改了 Claude in Chrome 欢迎屏幕和 `/chrome` 中的说明:除非你的 permission mode 或 `/permissions` 中的规则已经给出答案,否则 Claude Code 会在 Claude 对网站执行操作前征求许可 - 更改了第三方提供商上的 Claude Desktop 和 Agent SDK 会话,以及关闭 telemetry 或 feature flag 的会话:如果关闭时仍有问题等待回答,则结束当前轮次,而不是在没有答案的情况下继续 - 更改了第三方提供商上的粘贴文本,以及关闭 telemetry 或 feature flag 时的粘贴文本,使其对 Claude 标记为已粘贴内容 - 更改了 Anthropic API 上终端会话中的 subagent 进度摘要:现在由默认的小型快速模型根据简短笔记生成,即使关闭 telemetry 也是如此,token 用量也大幅减少 - 更改了无法启动的 sandbox 的报告方式,除非设置了 `sandbox.failIfUnavailable`:下一条需要在 sandbox 中运行的 Bash 命令会被拒绝,并说明本次会话的 sandbox 已关闭 - 更改了 `/list-agents`,使其列表仅对你显示;需要时由 Claude 自行列出会话 - 自托管 runner:更改了内置 `gh api`,在设置按名称限制 Claude 的 GitHub 工具时默认关闭;使用 `--use-anthropic-gh true` 可将其开启 - 自托管 runner:更改了 wrapper 脚本在会话自身的 `claude` 启动前或结束后运行的 `claude`,使其不再拥有 Anthropic 管理的 git - 自托管 runner:更改了 `CLAUDE_RUNNER_SESSION_UUID` 和 `CLAUDE_CODE_REMOTE_SESSION_UUID`,使二者都会为会话及其 `checkout`、 `post-session` 和 `spawn-runner` hook 设置 - 更改了 `--capacity 1` 的自托管 runner:当其推送目标 repository 的路径是 symbolic link 时,会更早拒绝会话 - [VSCode] 新增了来自另一会话的消息被暂存时的通知,其中包含指向可允许该消息的设置文件的链接 - [VSCode] 修复了 panel 高度较低,或 command、URL 或 description 较长时,permission prompt 的 No 按钮、reply 字段或 title 被截断的问题 - [VSCode] 修复了失败或被阻止的 tool call 不显示原因或原因被截短的问题,以及 Glob 和 Grep 将 error 计为 result 的问题
AI 热点