發布日期：2026-10-06
你在終端機使用 Claude Code 時，想知道快取為什麼失效。現在狀態列會在 prompt cache（提示快取，把對話紀錄暫存起來加速回應的機制）失效後的 10 分鐘內顯示原因，例如「快取:62% 剛失效:工具換了」。它涵蓋換模型、思考強度、快速模式、工具或系統提示變更、閒置超時等全部 17 種原因並支援五種語言，遇到不明原因時就不顯示；視窗太窄時會優先隱藏原因。
此功能需 Claude Code 2.1.260 以上；狀態列掛鉤（hook，特定事件發生時被觸發的小程式）升至 1.9 版並會在下次啟動時自動更新。說明文件也同步拿掉已不顯示的過期倒數計時。
當各家 AI 工具頻繁更新時，讀取底層資料的解析程式常因官方改版而無聲失效。現在新增的 scripts/check_upstream.py 開發腳本，會在發布新版本前拿這台電腦上的真實檔案逐一驗證。檢查範圍涵蓋 Claude 狀態列與對話紀錄、Codex 工作階段與 state_6.sqlite 等新版資料庫、Grok 日誌以及監看的 Statuspage 元件。針對 Antigravity，它會確認對話資料庫與額度快取（把用量暫存於本機的記錄）是否正常。這套工具也會比對已安裝的掛鉤（hook，特定事件發生時被觸發的小程式）副本，檢查是否有原始檔修改卻漏改版號的狀況，每項檢查都會清晰回報 OK、NEW、BROKEN 或 NO_DATA。
在小螢幕或分割視窗下查看 Claude Code 側邊面板時，每一行的垂直空間都格外珍貴。現在面板各區塊的標題與數字改移至外框上緣，每個區塊都能省下一行，點擊標題也依然能自由收合區塊。
以前背景工作列出少於四筆時，可能會少顯示一筆剛完成的工作，現在清單會確實列出。面板本身的測試在 Claude Code 2.1.289 上也重新通過，執行 claude plugin validate 指令時不再因狀態合約宣告而報錯。
When using Claude Code in the terminal, you might want to know why a cache was invalidated. Now, the status bar displays the reason within 10 minutes after a prompt cache invalidation, such as "Cache: 62% Just invalidated: Tools changed". It covers all 17 reasons—including model switches, thinking effort, fast mode, tool or system prompt changes, and idle timeouts—and supports five languages, hiding the reason when unknown; when the window is too narrow, the reason is prioritized for hiding.
This feature requires Claude Code 2.1.260 or higher. The status bar hook upgrades to version 1.9 and will automatically update on the next launch. Documentation also removes the obsolete countdown timers that are no longer displayed.
As AI tools update frequently, parsers reading underlying data often silently break due to official revisions. The newly added scripts/check_upstream.py development script now validates real files on this machine one by one before releasing a new version. The check covers Claude status lines and conversation logs, Codex sessions and new database versions like state_6.sqlite, Grok logs, and monitored Statuspage components. For Antigravity, it verifies whether conversation databases and quota caches are operating normally. This tool also compares installed hook copies to detect cases where source files were modified without bumping version numbers, clearly reporting OK, NEW, BROKEN, or NO_DATA for each check.
When viewing the Claude Code side panel on small screens or split windows, every line of vertical space is precious. Section titles and counts are now moved to the top edge of each border, saving one line per section while still allowing sections to be collapsed by clicking their titles.
When fewer than four background tasks were listed, a newly completed task was previously sometimes omitted, but the list now displays them reliably. The panel's own tests pass again on Claude Code 2.1.289, and running claude plugin validate no longer errors on state contract declarations.
**Status line:** for 10 minutes after Claude Code's prompt cache misses, the cache segment says why, for example `Cache:62% missed:tools changed`. It covers all 17 causes Claude Code reports (model, effort, fast mode, tools, system prompt, idle past the 5-minute or 1-hour TTL, likely server-side, and more) in all five languages; an unknown cause is left out. The reason is the first part dropped when the line is too narrow. Requires Claude Code 2.1.260 or newer. The status line hook version is now 1.9, so installed copies update on the next app launch.
**README:** the prompt cache description now matches the status line, which no longer shows an expiry countdown.**Development:** `scripts/check_upstream.py` checks the formats usage depends on against the real files on this machine before a release: the Claude status line payload and transcripts, Codex sessions and SQLite files (including a newer-numbered file such as `state_6.sqlite`), the Antigravity conversation database and quota cache, the Grok log, installed hook copies (including a source edited without bumping its version), and the watched Statuspage components. Each check reports OK, NEW, BROKEN, or NO_DATA.**Claude Code side pane:** each section's title and count now sit on the box's top border, saving one row per section. The title still collapses the section when clicked.
**Claude Code side pane:** the background jobs box could hide one recently finished job when fewer than four jobs were listed.
**Claude Code side pane:** the pane's own tests pass again on Claude Code 2.1.289, and `claude plugin validate` no longer fails on its state contract.