Claude Code v2.1.299新增空闲自动压缩与文件提及控制项
该版本为终端加入约 54 分钟空闲后自动压缩长对话的机制，并新增CLAUDE_CODE_DISABLE_FILE_MENTIONS环境变量，使Claude只接收 @ 提及文件的路径而非内容，同时修复大量沙箱、MCP与云端会话问题。
AI解读：Claude Code发布v2.1.299，版本说明由ashwin-ant在GitHub Releases列出，内容以新增功能和修复为主。
新增终端空闲压缩：200K+ token的对话空闲约 54 分钟后，会在一小时提示缓存过期前被压缩。配套环境变量CLAUDE_CODE_IDLE_COMPACT_MIN_TOKENS可调整 200K的最低token门槛，settings.json中的 "idleCompaction": false可关闭该功能，两者都要求v2.1.290或更高版本。
新增CLAUDE_CODE_DISABLE_FILE_MENTIONS环境变量：开启后，Claude通过文件工具获得 @ 提及文件的路径，而不是文件内容。
开源插件/模组接口有多项扩展，例如mod的prompt.submit钩子可通过 $.prompt.media读取提示中图片或文档的字节；由托管设置安装的mod可用 $.session.identity() 获取登录方式及组织、邮箱等信息。
沙箱方面修复了若干边界问题，包括沙箱命令可借由符号链接读写被拒绝路径、--plugin-dir目录可被沙箱内命令写入等，这些修复与隔离和权限控制有关。
该版本还修复了与MCP服务器名称（constructor、prototype、toString）、云端会话、Remote Control、插件热重载、CJK/emoji渲染等相关的多项具体问题；来源未给出性能或效果数据。
Claude Code发布v2.1.299。版本说明列出本次新增的功能开关、插件接口和大量缺陷修复，发布信息来自GitHub上的Claude Code Releases页面，作者署名为ashwin-ant。
终端空闲压缩与会话控制
新增的终端空闲压缩会在 200K+ token的对话空闲约 54 分钟后进行压缩，时间点在一小时提示缓存过期之前，以便下一条消息不必重新处理全部上下文。
最低token门槛可通过CLAUDE_CODE_IDLE_COMPACT_MIN_TOKENS调整，settings.json中设置 "idleCompaction": false可将其关闭；版本说明称这两项配置都要求v2.1.290或更高版本。
- 空闲约 54 分钟的阈值针对 200K+ token的对话。
- 压缩发生在提示缓存到期前，目的是减少下一条消息的重复处理。
- 可通过环境变量改门槛，或通过settings.json关闭。
文件提及控制与插件接口扩展
新增CLAUDE_CODE_DISABLE_FILE_MENTIONS环境变量：设置后，Claude得到的是 @ 文件提及的路径，由它自己的文件工具去读取，而不是直接获得文件内容。
模组接口也有若干新增。由托管设置安装的mod可通过 $.prompt.media读取提示中附加图片或文档的字节；通过 $.session.identity() 可获取会话的登录方式，当托管设置forceLoginOrgUUID列出相关组织时，还可获得组织和邮箱。mod的Text新增size、weight、mono、tabular，命名间距步长从xs到xl；bold被弃用，改用weight。
- CLAUDE_CODE_DISABLE_FILE_MENTIONS改变 @ 提及传递的是路径而非内容。
- $.prompt.media供被托管设置安装的mod读取提示附件字节。
- skill.prompt钩子新增接收技能frontmatter、来源、插件名和文件路径。
- claude self-hosted-runner orchestrator新增 --shutdown-drain-sec，用于SIGTERM后完成进行中的轮询和spawn钩子。
沙箱、MCP与会话可靠性修复
版本说明列出大量修复。沙箱相关包括：沙箱命令可借助符号链接读写被拒绝路径；沙箱化shell命令可写入 --plugin-dir目录，而该目录中的代码会被Claude Code重新加载并在沙箱外运行。
MCP相关修复涉及名为constructor、prototype、toString的服务器此前无法连接或错误请求权限，以及策略检查在服务器被联系前得到执行。云端与Remote Control会话方面，修复了事件大量积压导致上传缓慢时界面卡死、停止消息时Edit和Retry失败，以及恢复会话时已批准工具调用可能执行两次等问题。
- 沙箱修复针对符号链接绕过拒绝路径、以及 --plugin-dir写入带来的沙箱外执行风险。
- MCP修复覆盖特殊服务器名和策略检查顺序。
- 云端、Remote Control、Cowork和headless场景有多项具体错误修复。
- 另有CJK、emoji和宽字符在终端渲染时的换行、截断和空白行修复。