放着不动约五十四分钟会先压缩

Claude Code 2.1.299 于 2026 年 10 月 14 日发布。终端里超过二十万 token 的对话,空闲约五十四分钟会先压缩,免得一小时的提示缓存到期后下一条消息整段重算。可用环境变量改最低 token,或在设置里关掉。两项都要求 2.1.290 或更新。

放着不动约五十四分钟会先压缩

claude code 空闲时压缩对话是 2.1.299 加在终端里的行为。发布说明写:超过 200K token 的对话,空闲大约 54 分钟后会先压缩,赶在一小时的提示缓存到期之前,这样你的下一条消息不必把整段重新送去处理。2.1.299 的发布时间是 2026 年 10 月 14 日 02:49 UTC。

作者:CodePass 技术编辑

两个开关,而且都要 2.1.290 以后

CLAUDE_CODE_IDLE_COMPACT_MIN_TOKENS 用来改掉默认的 200K token 下限。设置里的 "idleCompaction": false 会关掉空闲压缩。说明写:这两项都需要 2.1.290 或更新的版本。只把变量写进环境、二进制仍低于 2.1.290 时,不要预期压缩门槛会变。

54 分钟是「大约」。说明没有写计时从最后一次按键、最后一次模型返回,还是最后一次工具结束起算。不到 200K token 的对话不在默认范围内。把下限调低之后,才会让更短的对话进入这套空闲压缩。调低的具体效果,说明没有给例子。

这是终端里的空闲压缩。说明没有写 Claude Desktop、远程控制会话或 Agent SDK 会在同样的 54 分钟后做同一件事。同一版另有一条:Agent SDK、IDE 和 claude remote-control 里,后台任务还在跑时,计划中的定时唤醒不会触发。那是唤醒被后台任务挡住,不是空闲压缩。

和 @ 文件不再塞进正文是相邻的另一项

2.1.299 还加了 CLAUDE_CODE_DISABLE_FILE_MENTIONS。打开后,Claude 拿到的是 @ 文件提及的路径,要用文件工具自己去读,而不是直接拿到文件内容。这和空闲压缩无关。一个管你离开之后缓存到期前要不要先压缩,一个管提及文件时上下文里放路径还是放正文。

写作日没有把一段超过 200K token 的终端对话闲置 54 分钟,没有观察到压缩发生的提示。版本低于 2.1.299 时,这套空闲压缩不在发布说明里。

参考资料