Sub-agents 迅速燒光 Claude Code 5 小時額度？教你一招調整 Prompt Cache 解決

高品質的工程踩坑分享：深入排查 Claude Code 子代理（sub-agent）的 5 分鐘 prompt 快取過期機制，導致額度快速燒光的具體原因與解法。

許多開發者反映使用 Claude Code 時，5 小時的使用額度常在一兩小時內耗盡，罪魁禍首其實是 sub-agent 預設僅有 5 分鐘的 Prompt Cache 壽命。 • 當子代理執行測試、編譯或 git hook 等超過 5 分鐘的工具呼叫時，快取就會失效，導致後續請求被迫以昂貴的快取寫入費率重新寫入數十萬個 token 的完整上下文。 • 作者實測發現，透過調整設定將 sub-agent 快取時間延長，可大幅減少高達 75% 的快取寫入量。 • 設定方式極為簡單，只需在 ~/.claude/settings.json 加入 "subagentPromptCacheTtl": "1h"（需 Claude Code v2.1.242 或更新版本），或使用對應的環境變數。 • 需注意 1 小時寫入的費率雖略高於 5 分鐘，但只要子代理會觸發重複寫入，整體成本與額度消耗反而大幅下降。

「不要讓 sub-agent 長時間停留在單一工具呼叫中，改用背景執行或定時檢查來保持快取溫熱，是避免額度秒殺的關鍵。」 • 檢查自己的專案日誌中若出現 cache_creation_input_tokens 持續出現巨大數字，即代表正面臨快取不斷重寫的問題。