Claude Code 2.1.314–2.1.316 更新：限制写出工作目录、空闲压缩与网关兼容修复

Claude Code 在 10 月 30 日到 31 日（北京时间）连续发布了 2.1.314、2.1.315 和 2.1.316 三个版本。这几版的重点不在新模型，而在安全边界、长会话和经过 API 网关使用时的兼容性。

升级命令：

npm install -g @anthropic-ai/claude-code@latest
claude --version

新增：禁止写入工作目录以外的文件

2.1.314 新增 permissions.blockWritesOutsideWorkingDirectories 设置。开启后，在任何权限模式下，Write、Edit 和 NotebookEdit 都会拒绝写入工作目录以外的路径。

在自动模式下长时间运行任务，或者让 Claude Code 处理不熟悉的代码库时，这个开关可以防止它误改用户目录里的配置文件、SSH 文件或其他项目。它只限制这三个文件工具，Bash 命令仍受原有的权限规则和沙箱约束。

2.1.316 还修复了 --restricted 会话在 Read 允许规则覆盖时，会上传工作目录以外文件的问题。

长会话：空闲压缩和图片过多的修复

空闲压缩：VS Code 和 Claude Desktop 的 Code 标签页里，超过 20 万 Token 的对话闲置后会提前生成摘要。下次发消息时如果提示缓存已经过期，就直接使用这份摘要，不用重新发送完整历史。

Input is too long：在 Bedrock 上，图片很多的会话以前会在每一轮和 /compact 时报 400 Input is too long.。2.1.314 改为先移除较早的图片再压缩。

PreCompact hook 输出过大：每个 hook 的输出现在截断到 10,000 个字符，避免压缩失败或反复执行。

经过网关使用时的修复

通过 API 网关、中转服务或云平台使用 Claude Code 的用户，可以重点关注这几项：

• 网关不接受 tool search 的 tool_reference 块时，以前会反复被拒。现在 Claude Code 会去掉 tool search 再发一次，并在当前会话里记住。
• 网关或云平台拒绝某个 beta 请求头时，请求会去掉这个头后重发。
• 网关里用点号写的模型名，比如 claude-opus-4.8，以前会被当成旧模型，导致上下文窗口、输出上限、推理强度和费用估算都不对。这个问题已经修复。
• 管理员限制了模型推理强度时，以前会话会一轮接一轮报 “Invalid effort level”。现在 Claude Code 会自动降低强度重试，并说明实际使用的等级。
• 压缩响应被截断或损坏时，部分网络请求会一直挂起，2.1.316 修复了这个问题。

这些修复都在客户端完成。如果升级后仍然遇到报错，可以把版本号、报错原文和请求时间一起记录下来，方便和服务商核对。

其他值得知道的变化

• 新增 CLAUDE_CODE_DISABLE_ULTRATHINK，可以关闭 ultrathink 关键词。
• 新增 CLAUDE_CODE_SUBAGENT_EFFORT，在没有其他配置时设定子代理的推理强度，不再继承主会话。
• claude -p 启动失败时，以前会以退出码 0 静默结束，现在会打印错误并以 1 退出，CI 脚本能正确发现失败。
• 修复 Claude Code 自行退出时，macOS 和 Linux 上仍有 shell 命令在后台运行的问题。
• 2.1.316 的更新日志同时写明：Opus 4.8 的 fast mode 已弃用，11 月 30 日移除，之后不会自动回退到普通速度。

安装来源要确认

10 月 29 日，Cursor 扩展市场里出现了冒充 2.1.312 和 2.1.313 版本的恶意 Claude Code 扩展。这次更新与该事件无关，但升级时建议使用 npm 或官方安装方式，并按这篇自查指南确认电脑没有被植入后门。