Claude Code 2.1.299：20 万 token 以上闲置会话自动压缩避开缓存过期重算，并修复沙箱命令可写入 --plugin-dir 的问题

核心背景与行业痛点

长会话是 Claude Code 重度用户的主要成本来源：提示缓存一小时过期后，回来发一句话就要把 20 万以上 token 全部重新计算，又慢又贵。2.1.299 把这个场景改成默认自动处理，同时修了一个沙箱边界问题。

架构亮点与底层机制

新增“闲置压缩”：终端里超过 20 万 token 的会话闲置约 54 分钟，会在一小时缓存过期前先做一次压缩，下一条消息不必整段重算。阈值可用 CLAUDE_CODE_IDLE_COMPACT_MIN_TOKENS 调整，settings.json 写 "idleCompaction": false 可关闭。安全方面，此前沙箱内的 shell 命令能写入 --plugin-dir 目录，而 Claude Code 会在沙箱外重新加载并运行其中代码，本版已封堵。另有 CLAUDE_CODE_DISABLE_FILE_MENTIONS，让 @ 引用只传路径不塞内容。

权威 Benchmark 与实测跑分对比

官方未公布节省的 token 或费用比例，暂无独立实测；可确认的参数只有 200K 下限、约 54 分钟触发和 1 小时缓存窗口。自定义 ANTHROPIC_BASE_URL 的无数据超时从 180 秒放宽到 300 秒。

开发者实战落地与开箱指南

用 claude update 升级后，长任务挂起不再需要手动 /compact；若依赖完整上下文做审计，可关掉闲置压缩。用 --plugin-dir 开发插件并开沙箱的团队建议尽快升级。做插件评测时可用 claude plugin eval --disallow-tools 排除 Agent 等内置工具，避免工具偏置。完整列表见 官方文档 changelog。