觀點 · 資訊分享
Claude Code 新增「閒置壓縮」:長對話放著 54 分鐘就先整理好,回來不用整段重算
Claude Code 2.1.299 加入閒置壓縮:超過 20 萬 token 的終端機對話,閒置約 54 分鐘時會趕在一小時的提示快取過期前先壓縮,下一則訊息不必把整段對話重新處理一次。這版也新增讓 @ 檔案只傳路徑的設定。
- 發布
- 2026-10-14
- 篇幅
- 約 4 分鐘 · 1,634 字
- 結構
- 7 節 + 3 題常見問題
- 標籤

一句話看懂:Claude Code 2.1.299 新增「閒置壓縮」,很長的對話放著約 54 分鐘沒動,就會趕在提示快取過期前先整理好,回來繼續時不用把整段對話重新處理一次。

先用白話講:提示快取和「壓縮」是什麼?
想像你請一位助理幫你整理一大疊會議資料,他把重點記在腦中,一小時內你隨時問,他都能馬上回答。可是超過一小時沒互動,他就忘了,你再問問題,他得把整疊資料從頭讀一次,又慢又花錢。
提示快取就是 AI 的短期記憶:同樣的對話內容在快取期間可以便宜又快速地沿用。壓縮(compaction)則是把很長的對話整理成精簡版本,讓後面的對話不用背著整疊資料走。
這次的新功能,就是助理在快要忘記之前,主動先把資料整理成一份重點摘要。
發生什麼事
Anthropic 在 10 月 14 日釋出 Claude Code 2.1.299,在終端機加入閒置壓縮(idle compaction):
- 觸發條件:對話超過 20 萬 token,而且閒置約 54 分鐘
- 目的:趕在一小時的提示快取過期前先壓縮,下一則訊息就不必重新處理整段對話
- 調整門檻:環境變數
CLAUDE_CODE_IDLE_COMPACT_MIN_TOKENS可改 20 萬的下限 - 關閉方式:在
settings.json設定"idleCompaction": false - 上面兩個設定官方註明需要 v2.1.290 以上
同版其他值得注意的更新
CLAUDE_CODE_DISABLE_FILE_MENTIONS:用@提到檔案時,Claude 只拿到檔案路徑,再用檔案工具自己讀,而不是整份內容直接塞進對話/usage新警告:對最大 effort、工作流程、常駐上下文與大型工具結果發出提醒- 修正:沙盒中的指令可以寫入
--plugin-dir資料夾的問題(這個資料夾的程式碼會在沙盒外被重新載入執行) - 修正:WSL2 上沙盒指令因路徑問題失敗的狀況
隔天的 2.1.300 也在 OpenTelemetry 的 api_request 事件加入 cache_creation_5m_tokens 與 cache_creation_1h_tokens,能分開看 5 分鐘與 1 小時快取的寫入量。
給開發者的技術細節
{
"idleCompaction": false
}
- 不想要閒置壓縮就加在
settings.json - 想讓更短的對話也觸發,就把
CLAUDE_CODE_IDLE_COMPACT_MIN_TOKENS調低 - Release notes 沒有說明壓縮後保留哪些內容,重要的決策與規格,最好還是寫進專案文件,而不是只放在對話裡
我的看法
用 Claude Code 做專案,很常遇到的情況是做到一半去開會、吃飯,回來時對話已經很長,下一個問題要等很久、也比較貴。閒置壓縮正好處理這個空檔,對長時間工作的人是很實際的改善。
不過壓縮一定會丟掉部分細節。我的習慣是把重要的設計決定、踩過的坑寫進專案的說明文件,讓 AI 每次都能重新讀到,不依賴對話記憶。這樣不管有沒有壓縮,工作都能接得上。
名詞小辭典
- Claude Code:Anthropic 的終端機寫程式 AI 工具,可以讀程式碼、改檔案、執行指令。
- 提示快取(Prompt caching):把重複送出的內容先存起來,下次沿用時更快也更便宜。
- 壓縮(Compaction):把很長的對話整理成較短的摘要,騰出上下文空間。
- OpenTelemetry:常用的可觀測性標準,用來收集程式的追蹤與統計資料。