Claude Code 2.1.310 已发布。这次值得关注的，是网关兼容、Windows 权限钩子，以及前一版集中修复的沙箱与权限问题。使用兼容网关、Windows Hooks 或自定义 MCP 配置的用户，可以优先安排更新。
1. 兼容网关报错，先区分参数与连接问题
部分网关或兼容服务不接受effort-2025-11-24beta 值，或不接受对话中途出现的 system 消息。2.1.310 为这两种情况增加了去掉相应内容后重试的处理。
如果你遇到的是相关参数或消息格式被拒绝，可以先升级再复现。若错误是认证失败、模型无权限或网络超时，仍应检查密钥、模型授权和连接；这项修复没有覆盖所有网关故障。
2. Windows Hooks：配置了拦截，还要检查实际执行
2.1.310 修复了一个特定组合：缺少 Git Bash，且 hook 命令只有带引号的字符串，例如带引号的程序路径。在此条件下，PreToolUse和PermissionRequest曾可能放行工具调用。
前一版 2.1.309 还修复了 PowerShell hook 以退出码 2 结束却没有阻断，以及 Windows 某些 PowerShell hooks 在缺少 Git for Windows 时放行的问题。
依赖 hook 做权限控制时，更新后应在临时目录做一次无害测试：让 hook 明确拒绝创建一个测试文件，检查文件确实没有生成，同时确认日志中 hook 正常执行。不要只看配置文件里“已经写了规则”。
3. 前一版的安全修复，也值得一起看
| 版本 | 官方列出的修复 | 对使用者的影响 |
|---|---|---|
| 2.1.309 | macOS、Linux 沙箱命令的 shell 启动文件曾在沙箱外运行 | 使用自定义 shell 启动脚本时，应检查更新后的行为 |
| 2.1.309 | 沙箱命令或自动接受的编辑曾能修改--mcp-config指定文件 | 自定义 MCP 配置的写保护值得复测 |
| 2.1.310 | 文件读取权限提示没有显示符号链接的目标 | 审批读取时更容易判断真正访问的位置 |
4. Monitor 的变化是覆盖更多环境
Monitor 工具及插件监测能力扩展到了 Bedrock、Vertex、Foundry，以及关闭遥测或非必要流量的环境。
另一个实用修复是：遭遇 “Prompt is too long” 后，含大量 base64、SVG 等密集文本的会话压缩曾可能保留过多内容，导致下一次请求再次失败。2.1.310 调整了这项处理。
-修复系统问题)
