觀點 · 資訊分享

Claude Code 新增「閒置壓縮」:長對話放著 54 分鐘就先整理好,回來不用整段重算

Claude Code 2.1.299 加入閒置壓縮:超過 20 萬 token 的終端機對話,閒置約 54 分鐘時會趕在一小時的提示快取過期前先壓縮,下一則訊息不必把整段對話重新處理一次。這版也新增讓 @ 檔案只傳路徑的設定。

發布
2026-10-14
篇幅
約 4 分鐘 · 1,634 字
結構
7 節 + 3 題常見問題
標籤
#Claude Code#Anthropic#提示快取#AI 開發工具
Claude Code 新增「閒置壓縮」:長對話放著 54 分鐘就先整理好,回來不用整段重算

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

Claude Code 閒置壓縮上線資訊圖卡:長對話放著不動時,趕在快取過期前先壓縮,回來不必重新處理整段內容

先用白話講:提示快取和「壓縮」是什麼?

想像你請一位助理幫你整理一大疊會議資料,他把重點記在腦中,一小時內你隨時問,他都能馬上回答。可是超過一小時沒互動,他就忘了,你再問問題,他得把整疊資料從頭讀一次,又慢又花錢。

提示快取就是 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:常用的可觀測性標準,用來收集程式的追蹤與統計資料。

資料來源

常見問題

閒置壓縮在做什麼?
長對話會被提示快取暫存一小時,過期後再送訊息,整段對話都要重新處理。閒置壓縮會在快取過期前(約 54 分鐘)先把對話壓縮成較短的內容,你回來時就不用重新處理全部。
會不會把重要的內容壓掉?
壓縮本來就是把對話整理成摘要,細節可能會少一些。Release notes 沒有說明壓縮的具體規則;如果你需要保留完整對話,可以在 settings.json 設定 "idleCompaction": false 關閉。
要什麼版本才能用?
這個功能在 2.1.299 加入。調整門檻的環境變數與關閉設定,官方註明需要 v2.1.290 以上。
LINE