Claude Code v2.1.299 发布：闲置自动压缩，安全修复大丰收

发布时间：10 月 14 日

Claude Code 迎来 v2.1.299 更新。这一版本属于“低调但含金量高”的类型：没有花哨的大功能，但闲置压缩、安全加固和企业管控三方面的改进，对重度用户和团队管理员来说都是实打实的升级。全量更新包含 17 项新功能、100 余项 Bug 修复和行为优化。

三大亮点亮点一：闲置自动压缩，长会话不再“烧钱”

本次最实用的功能：当一段200K+ token 的长对话闲置约 54 分钟时，Claude Code 会在 1 小时 prompt 缓存过期前自动完成压缩。这意味着你隔夜回来发的那条消息，不用再重新处理整个上下文——成本和延迟双双下降。

可自定义项也齐全：

• CLAUDE_CODE_IDLE_COMPACT_MIN_TOKENS：调整 200K 的触发阈值
• settings.json 中设置“idleCompaction”: false：一键关闭

配套的还有CLAUDE_CODE_DISABLE_FILE_MENTIONS环境变量：@文件引用现在只传路径，由 Claude 用文件工具按需读取，不再一股脑塞进上下文，进一步省 token。

亮点二：安全修复集中轰炸

这个版本堵上了不少安全漏洞，值得管理员重点关注：

• 沙箱逃逸修复：macOS 上被拒绝的路径可通过符号链接（symlink）绕过读写限制；沙箱 glob 规则中的花括号、反斜杠解析不一致问题修复
• Plan 模式越权：修复了在 bypass permissions 可用时，plan 模式下 PreToolUse 钩子放行的写入操作可被实际执行的问题
• API Key 泄漏：修复了自定义ANTHROPIC_BASE_URL场景下，feature flag、启动、反馈等请求把第三方网关的 API Key 发给 Anthropic 的问题
• 恶意 mod 防护：修复__proto__键被静默移除可能跳过tool.check守卫；用户安装的 mod 无法再篡改托管设置下命令钩子的环境变量
• 权限规则更精确mcp__a允许规则不再误匹配a__ba_等同名前缀服务器

对 CJK 用户是个好消息——本版修复了一整批中日韩文字与 emoji 混排的渲染问题：

• 中英文混排换行时丢失最后一行、出现空行
• 极窄终端下 CJK/emoji 被挤压产生空行
• 宽字符旁文字被截断两次、emoji 在颜色切换处消失
• 权限提示中的键帽 emoji 导致文字截断

开发者体验

• /effort/fast命令进入 agent 视图，可为新会话设定默认推理力度；/model/effort/fast现在都会打开选择器
• /usage新增对 max effort、workflows、常驻上下文、大型工具结果的高消耗警告
• PDF引用不再把文件字节存进会话记录，内存和磁盘占用显著下降
• claude plugin eval新增--disallow-toolsdisallowed_tools字段，可在评测中排除 Agent 等内置工具

Mod / 插件系统

• $.prompt.media：钩子可读取提示中附加的图片/文档字节
• $.session.identity()：获取会话登录方式和组织信息
• Text组件新增sizeweightmonotabularbold已弃用，改用weight
• turn.start钩子现在也能监听子代理和队友的回合，通过e.agentId区分
• 插件技能分享流程优化：创建 GitHub 仓库前会自动检查文件

企业管控

• Claude Desktop Code 标签页可关闭署名块（CLAUDE_CODE_ATTRIBUTION_HEADER=0
• /pluginclaude plugin validate会明确列出被组织策略跳过的钩子
• 自托管 runner 编排器新增--shutdown-drain-sec，SIGTERM 时给在途任务优雅收尾的时间

类别

修复内容

稳定性

重度 debug 日志导致的内存增长与退出挂起；恢复含大量子代理的云会话后内存暴涨

长上下文

自定义网关 + 专属模型名场景下，接近 200K token 时误报“Prompt is too long”而不发请求

云会话

工作节点被替换时权限回答丢失、回复中断等多处竞态修复

Remote Control

30–35 MiB 文件无法送达；电脑离线时消息误显示已发送

文件处理

UTF-16LE/GBK/Shift-JIS 等编码文件读写不再被静默转码（现直接拒绝）

Windows

Git Bash PATH 缺失导致整会话“command not found”；孤儿 PowerShell 进程堆积

MCP

OAuth 登录/刷新不发自定义 headers 的老问题修复；HTTP 连接 30 秒挂起修复

计时任务

夏令时结束时定时任务重复触发或提前触发；任务现在报告真实的下次运行时间

⚠️ 行为变更提醒（升级前必读）

1. MCP 允许规则收紧mcp__只作用于指名的服务器，含的服务器名需写成mcp__<全名>__*
2. UserPromptSubmit 钩子提前：现在在技能/斜杠命令展开前运行，能拦截的范围内包括内嵌 shell 命令
3. HTTP 重定向不再跟随：claude.ai 连接器代理与 Anthropic 托管 MCP 服务器的请求不再跟随重定向
4. 云会话 MCP 协议升级：默认协商 MCP 2026-07-28 版本，MCP_PROTOCOL_NEGOTIATION=legacy可回退
5. Claude in Chrome：Cowork 云会话中被安全分类器标记的已批准站点操作，改为询问用户而非直接拒绝
6. 退出提示的 resume 命令改用会话 ID而非会话名，防止会话名中的内容被粘贴执行

v2.1.299 是一次“内向”的发布：功能面上闲置压缩直接命中长会话用户的成本痛点；安全面上从沙箱逃逸到密钥泄漏一口气修复十余处；再加上对 CJK 终端渲染的系统性修缮，建议所有用户升级，托管团队管理员尤其应尽快跟进。

• 发布页：github.com/anthropics/claude-code/releases/tag/v2.1.299
• ⚙️ 闲置压缩相关设置需 v2.1.290 及以上生效