Claude Code 2.1.310 更新:中转站拒收两种字段时自动重发,Monitor 工具开放到更多环境,沙箱警告会点名 AppArmor
10 月 24 日 Claude Code 发了 2.1.310。网关或中转站拒收 effort-2025-11-24 和对话中途的 system 消息时,改为去掉重发;Monitor 工具开放到云厂商和关了遥测的环境;修了压缩、清理和 Windows hook 的问题。本站在 2.1.310 上看了实际加载的工具。
北京时间 2026 年 10 月 24 日早上(UTC 10 月 23 日 23:39),Claude Code 发布了 2.1.310。和本站读者关系最大的是三点:
- 中转站拒收两种字段时,改为去掉重发。 有的网关和兼容服务不认 beta 头里的
effort-2025-11-24,或者不接受对话中途的 system 消息,以前请求会直接失败,现在 Claude Code 去掉它们再发一次。 - Monitor 工具开放到更多环境。 在后台盯着命令输出、有变化就告诉 Claude 的
Monitor,现在 Bedrock、Vertex、Foundry 上也有,关了遥测或非必要流量时也有。 - 一批修复: 压缩、后台清理、Windows 上的 hook、VS Code 的计划评审。
这是 2.1.308 到 2.1.309 之后的一个版本。下面按“对你有什么影响”整理,不逐条翻译更新日志。本站服务器上的 Claude Code 10 月 24 日升到了 2.1.310,标了“实测”的地方是在它上面跑的,通过酷站AI 中转站。
走中转站的
拒收 effort-2025-11-24 或对话中途的 system 消息时,去掉重发。 上游拒绝某些字段时,Claude Code 本来就会自己改了重发,这一版多了这两种。各种情况怎么处理,见通过中转站用 Claude Code里的那张表。官方的网关兼容性文档还没写这一条,本站也没有实测。
新增和放开的
Monitor 工具开放到更多环境。 更新日志写的是:Bedrock、Vertex、Foundry 上,以及关了遥测或非必要流量时,也提供 Monitor 工具和插件的 monitor,在这些环境里同样会拦下长时间的前台 sleep。当天的工具参考页还把这几种情况列为不可用,文档还没跟上。
实测: 本站在服务器上用 claude -p 读启动信息里的工具清单。10 月 12 日用 2.1.296 读是 21 个,没有 Monitor;这次用 2.1.310,同一台机器、同一家中转站,是 23 个,多了 Monitor 和 ToolSearch。我们的设置里没有关遥测,也没有用云厂商接入,所以之前为什么没有 Monitor 还是说不清;ToolSearch 是 2.1.304 起自定义接口地址也默认打开 MCP 工具搜索带来的。详见内置工具、常用命令和环境变量。
Linux 上沙箱起不来时,警告会点名 AppArmor。 Ubuntu 默认的 AppArmor 策略不让普通程序创建用户命名空间,bubblewrap 因此起不来时,/sandbox 和启动时的警告现在会直接说明是这个限制、怎么解除。解除的办法见沙箱。
auto 模式第一次读工作目录以外的文件之前,提示说得更清楚。 它会说明:拦下这类读取,会让 shell 命令改为要你确认。
修了的
cleanupPeriodDays设得很大时,后台清理会删掉一些新文件,比如粘贴进来的图片。- 遇到 “Prompt is too long” 之后的压缩留下了太多内容。 对话里有大段 base64 或 SVG 这类密集文本时,压缩后下一次请求还可能再失败。非交互会话(
-p、Agent SDK)在会话记录很大时压缩的内存占用也降了。 - Windows:没装 Git Bash 时,命令只是带引号字符串的 hook 会放行。 比如
command只写了一个带引号的路径,PreToolUse和PermissionRequesthook 之前会让这次调用过去。这类 hook 的处理见 Hooks 参考。 - 读文件的权限提示没显示符号链接指向哪里。
- 用外部编辑器改了很久之后,问题的自动继续计时一关编辑器就触发。
- 非交互会话里,MCP 服务器在等你回答时工具调用超时,报错改了: 现在告诉 Claude 没有收到回答、不要重复这次调用。
- mod 的
Image在 tmux 里(开了allow-passthrough和focus-events)、kitty、Ghostty、iTerm2 3.5 以上的全屏渲染下,以前只显示alt文字。 - VS Code: 在计划评审卡片的 “Send feedback and keep planning” 上按回车,以前会直接批准计划,而不是把你的意见发回去;云端会话 “Switch branch & continue” 之后面板显示 “Something went wrong”。
云端会话、Claude Tag 和 Code Review
- 企业的自定义角色可以分别管云端会话和 Remote Control 的权限。 管理后台打开这两项时会先确认,并列出有这项权限的自定义角色。
- 云端环境的设置脚本可以从文件加载(Choose file 按钮);环境对话框改成逐行打开网络访问、设置脚本和环境变量;会话开始时的清单里,设置脚本的输出放在可滚动的框里。
- 另有几条云端环境、定时任务、Claude Tag 和 Code Review 管理页面的报错显示修复。
同一天官方文档的改动
和这个版本一起,官方文档也改了几处,本站相关的文章已经跟着改了:
- 主对话在 plan 模式时,子代理一律留在 plan 模式,不管它的
permissionMode写的是什么。见子代理进阶,本站在 2.1.310 上补测了。 - 安全检查插件的两层审查默认用“一个 Opus 模型”,不再写 Opus 4.7。本站用插件 2.0.16 补测,两层实际用的都是 Opus 5.5,见安全检查插件。
- 监控文档写全了
claude_code.safety_event的字段,见用 OpenTelemetry 看自己的 Claude Code 用量。
怎么升级
claude update
claude --version
原生安装的 Claude Code 会在后台自己更新,claude --version 显示 2.1.310 就是这一版。