觀點 · 資訊分享

Claude Code 2.1.129 修掉「1 小時快取被默默降成 5 分鐘」，另有 3 項新功能值得看

Claude Code 在 5 月 6 日發布 2.1.129：修正 1 小時 prompt cache 被默默降成 5 分鐘、醒來後登入被踢掉等問題，也新增 --plugin-url、Homebrew 與 WinGet 自動更新設定。閘道模型探索改成要手動開啟。

一句話看懂：Claude Code 2.1.129 修掉了「1 小時快取被默默降成 5 分鐘」等問題，也新增 3 項功能，但閘道模型探索改成要手動開啟。

Claude Code 2.1.129 更新資訊圖卡：修掉快取被默默降級等問題，新增 3 項功能

先用白話講：prompt cache 是什麼？

想像你每次問助理問題，都要把整本背景資料重新念一遍，很花時間也花錢。prompt cache 就像讓助理「先把資料記在便條紙上」，下次不用重念，但便條紙只能保留一段時間。

官方說，這次修掉的問題是：本來設成保留 1 小時的便條紙，被默默縮成只留 5 分鐘。

Claude Code 在 5 月 6 日發布 v2.1.129。重點可以分成三類：

新增

行為變動

閘道的 /v1/models 模型探索改成選擇性：要設 CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY=1（2.1.126 到 2.1.128 是自動的）
Ctrl+R 歷史搜尋預設搜全部專案，按 Ctrl+S 才縮小到目前專案或工作階段
透過 Bedrock、Vertex、Foundry 或自訂閘道的部署，不再看到指向 Anthropic 官方服務的提示

重要修正

閘道探索改成選擇性後，如果你的選單突然少了模型，第一個該檢查的就是 CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY
外掛清單中，主題與監看器現在建議放在 "experimental" 之下，頂層寫法仍可用，但 claude plugin validate 會警告
skillOverrides 設定現在有效：off 對模型與斜線選單都隱藏，user-invocable-only 只對模型隱藏，name-only 會收合說明
官方說 OTel 的 claude_code.pull_request.count 現在也會算進透過 MCP 工具建立的 PR

這個版本最有價值的是「默默降級」的修正：這類問題不會報錯，只會讓成本和速度悄悄變差，很難自己發現。如果你用 Claude Code 做長時間的工作，更新後值得觀察一下用量是否變化，不過官方沒有提供降級影響多大的數字，這部分我不推測。

另外閘道探索變成手動開啟，對公司內部有統一閘道的團隊是會踩到的變動。接案時如果替客戶設了模型閘道，記得把這個環境變數寫進設定說明。

prompt cache 是什麼？為什麼 TTL 被降級很重要？

prompt cache 讓重複送出的內容用較低成本重複使用，TTL 是它能被保留的時間。官方說 1 小時的 TTL 曾被默默降成 5 分鐘，等於快取更容易失效，成本與速度都可能受影響。

我用公司的模型閘道，更新後要注意什麼？

官方說 /model 選單從閘道探索 /v1/models 的功能，現在改成選擇性啟用，需要設定 CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY=1；在 2.1.126 到 2.1.128 之間它是自動的。如果你的選單少了模型，先檢查這個設定。

自動更新怎麼開？

官方新增 CLAUDE_CODE_PACKAGE_MANAGER_AUTO_UPDATE：在 Homebrew 或 WinGet 安裝的版本上設定後，Claude Code 會在背景執行升級指令，並提示你重新啟動。

作者

接案做系統開發、網站與主機託管。觀點裡的文章都是我自己寫的,寫的是做專案時第一手遇到的事。