[控场AI]
· 7 分钟阅读· 3,798 字

Claude Code v2.1.328 更新:Bedrock 自动模式与多项稳定性修复

Claude Code v2.1.328 更新:Bedrock 自动模式与多项稳定性修复

Claude Code v2.1.328 聚焦多平台自动模式、自托管运行器稳定性与 Code Mode 及终端体验的大量修复。

Claude Code v2.1.328 是一个以打磨为主的版本,没有引入颠覆性功能。最显著的变化是为 Amazon Bedrock、Google Cloud Agent Platform、Microsoft Foundry 及 Claude apps gateway 上的 Opus 4.6 与 Sonnet 4.6 增加自动模式,未设置权限模式的交互式会话将默认启用;`mcp_tool` 钩子新增 `"onFailure": "block"`,与命令钩子和 HTTP 钩子保持一致。自托管运行器新增 `--repository-folder`、`--hook-label`、`--metadata` 参数及两个队列与放弃会话指标,并修复了代理返回空响应体、时钟回拨导致令牌过期、临时磁盘错误后对象丢失等问题。Code Mode 移除了 0.75 秒脚本后暂停、展示运行中的命令与输出,修复顶层 await/return、只读子代理暴露写工具等问题。终端与云会话也修复了 zsh `=` 开头单词报错、Esc 丢失、Markdown 渲染冻结、压缩摘要丢失与跨会话消息不可达等细节。

rss source: v2.1.328

Claude Code 发布了 v2.1.328 版本更新,这次更新主要集中在平台兼容性、自托管运行器稳定性以及代码模式(Code Mode)的交互优化上。虽然没有引入革命性功能,但修复了大量影响日常使用的细节问题,对于依赖 Claude Code 进行开发的团队来说值得关注。

跨平台自动模式与钩子增强

本次更新最显著的变化是为 Amazon Bedrock、Google Cloud 的 Agent Platform、Microsoft Foundry 以及 Claude apps gateway 上的 Claude Opus 4.6 和 Sonnet 4.6 增加了自动模式(auto mode)。对于没有设置权限模式的交互式会话,现在会默认以该模式启动,这降低了多平台用户手动配置权限的负担。

钩子(hooks)机制也得到增强。mcp_tool 钩子现在支持 "onFailure": "block" 配置,与命令钩子和 HTTP 钩子保持一致,意味着当钩子调用失败时可以阻止后续操作。此外,当会话跳过权限提示时,系统会发出警告,提示消息可能被云会话持有或丢弃。在 /status 和 claude doctor 中,如果 OpenTelemetry 导出器没有配置端点,也会显示提示,避免数据静默丢失。

自动模式(auto mode)与权限模式:Claude Code 的权限模式决定了工具调用(如读写文件、执行命令)在执行前是否需要用户逐条批准。常见模式包括默认的交互式逐个确认、bypassPermissions(完全跳过确认)以及 plan 等只读规划模式。自动模式是一种折中方案:在保证一定安全边界的前提下,减少反复弹窗打断工作流的情况,适合已经信任项目环境、希望提升效率的团队。此次把自动模式扩展到 Amazon Bedrock、Google Cloud Agent Platform 等第三方平台,意味着这些平台上未显式设置权限模式的会话也会默认走该路径,行为更一致,但也要求团队提前确认该模式在其合规要求下是否可接受。

钩子(hooks)与 "onFailure" 语义:钩子是 Claude Code 在特定生命周期事件(如工具调用前、会话启动时、权限提示跳过时)自动执行的外部命令或 HTTP 请求,常用于接入审计、策略校验或企业网关。"onFailure" 字段控制钩子本身执行失败(如命令返回非零、HTTP 请求异常)时的处理方式:设为 "block" 会阻止被钩子拦截的后续操作继续,相当于“失败即拒绝”(fail-closed),适合安全校验类钩子;不设置则倾向于放行,属于“失败即开放”(fail-open),适合日志采集类钩子。mcp_tool 钩子此前缺少该选项,此次补齐后,三类钩子在失败语义上保持一致,便于统一配置策略。

自托管运行器:更精细的控制与更稳健的故障处理

自托管运行器(self-hosted runner)是本次更新的重点改进领域。新增了 --repository-folder 参数,允许在 --capacity 1 时为会话指定仓库文件夹名称,替代基础文件夹下的路径(该路径不能是符号链接)。--hook-label 和 --metadata key=value 参数则让编排器能够将标签传递给 spawn-runner 钩子,为会话管理提供了更细粒度的控制。

在可观测性方面,新增了 claude_code_self_hosted_orchestrator_session_queue_wait_by_reason_seconds 和 claude_code_self_hosted_orchestrator_sessions_given_up_total 两个指标,帮助运维人员区分会话等待原因以及统计放弃启动运行器的次数。

修复方面同样密集:解决了代理或网页过滤器返回 HTTP 200 但响应体为 {} 时导致所有运行中会话被停止的问题;修复了临时磁盘错误后保留克隆的对象或引用被删除的情况;修复了主机时钟变慢或回拨时令牌过期导致运行器停止的问题;以及会话在新配置目录恢复时丢失任务列表的问题。这些修复让自托管场景的可靠性有了明显提升。

自托管运行器与编排器:自托管运行器(self-hosted runner)指由用户在自己的基础设施上部署的进程,负责接收编排器(orchestrator)下发的任务、拉起 Claude Code 会话并回传结果,适用于代码不能离开内网或需要与内部 CI/权限系统集成的场景。--capacity 控制单个运行器可同时承载的会话数;--repository-folder 用于在容量为 1 时指定具体仓库目录,从而让同一台机器按仓库隔离会话;spawn-runner 钩子则在运行器被拉起时触发,--hook-label 与 --metadata key=value 把标签和键值对透传给该钩子,便于编排层做路由、计费或审计。文中新增的两个 Prometheus 风格指标分别统计“按原因分类的排队等待时长”和“放弃启动的会话总数”,是排查容量不足与调度失败的关键信号。

Code Mode 的交互与性能优化

Code Mode 在此次更新中获得了大量修复和体验改进。在自动模式和绕过权限模式下,脚本执行后等待的 0.75 秒暂停被移除,速度有所提升。同时,Code Mode 现在会在脚本运行时显示正在执行的命令及其输出,让开发者对执行过程有更清晰的感知。

编辑操作也变得更智能:不产生实际变化的编辑不再中断脚本,失败的编辑会告知 Claude 匹配位置或最接近的位置。当脚本失败时,Claude 会被告知哪些工具调用仍在运行。对于顶层使用 await 和 return 的脚本、以 { 块开头的脚本,之前会被错误拒绝,现在已修复。此外,还修复了顶层变量未定义时静默使用 undefined 的问题,以及只读子代理被提供 write() 和 edit() 工具的问题。

Code Mode 与顶层 await/return:Code Mode 允许 Claude 以编写并执行脚本的方式编排多次工具调用,而不是逐条发起,从而把“读文件—改代码—跑测试”等多步操作合并为一次执行。脚本通常被包在一个异步函数体内运行,因此顶层 await 是合理写法;早期实现会错误地把这类脚本当作非法语法拒绝,或对未定义变量静默取 undefined,导致失败难以定位。此次修复让顶层 await、return 以及以 { 开头的脚本能正常执行,并让只读子代理不再拿到 write()/edit() 工具,属于对执行沙箱语义的收紧与纠偏。

终端与编辑器体验修复

针对终端环境的修复覆盖了多个常见痛点。zsh 中以 = 开头的单词(如 echo ==== 或 [ a == b ])不再导致“not found”错误,=cmd 也不再展开为命令路径。自动压缩不再复用会话早期的系统提示,而是像 /compact 命令一样重新构建。长或格式错误的 Markdown 输入导致渲染冻结的问题、罕见的屏幕冻结问题均得到修复。

权限提示或提问时按 Esc 经常丢失的问题被修复,在发送 Alt 和按键的终端中,未使用的 Alt 或 Option 键现在会拒绝操作。慢连接将粘贴或终端回复分成两段时被输入到提示符的问题也已解决。Linux 下 Ctrl+V 丢失剪贴板图像、粘贴旧图像或挂起的问题,以及全屏模式下复制文本包含引用条、换行丢失空格等问题都在修复列表中。

云会话与远程控制的稳定性提升

云会话方面,修复了恢复的云会话在消息保存较晚时可能丢失压缩摘要或最近消息的问题。当响应中途用量信用耗尽时,错误提示曾错误地命名为速率限制,现已修正。远程控制会话中重复显示断开连接消息、在服务缓慢时重启导致等待中的权限提示丢失等问题也得到处理。

跨会话消息传递也获得改进:新启动或标题中包含 @ 的云和远程控制会话,在开启远程控制的会话中进行跨会话消息传递时不可达的问题被修复。Claude 之前被告知云会话永远无法回复,现在它会了解何时可以收到回复以及如何获取结果。

总结

v2.1.328 是一个典型的“打磨型”版本,没有颠覆性功能,但在自托管运行器、Code Mode、终端交互和云会话稳定性上做了大量扎实的修复。对于使用 Amazon Bedrock 等第三方平台或自托管部署的团队,自动模式和指标增强降低了运维复杂度;对于日常在终端中工作的开发者,输入与渲染相关的修复则直接提升了使用流畅度。

rss source: v2.1.328

#Claude Code#v2.1.328#自动模式#自托管运行器#Code Mode#终端修复#云会话
分享:

相关推荐