AIDive

影片資料包

Claude Code 每週額度砍幅:實測槓桿、快取表格與週一檢查清單

閱讀約 10 分鐘

重點摘要

  • Claude Code 的每週額度從基準 100 提高到促銷期的 150,之後在 2026 年 9 月 14 日定為永久的 125。相對促銷期是砍 17%,相對舊基準是加 25%。兩種說法同時成立。
  • 在一個月的本機日誌中,subagent 佔了全部 token 的 48.1%,加權成本的 55.3%。最大的單一槓桿,是少啟動 subagent,並替保留下來的 subagent 指定小模型。
  • subagent 寫入 5 分鐘快取,主 session 寫入 1 小時快取。冷卻間隔之後的下一次請求,重寫的快取量約為熱請求的 19 倍。
  • 主 session 中斷超過 60 分鐘,下一次請求的快取重寫中位數是 130,332 token,間隔不到 5 分鐘則是 1,176。
  • 降低 effort 並沒有降低每次請求的輸出量(主 session 上 high 平均 778 token,medium 為 837),所以把它當成品質取捨,而不是免費的節省。
  • 關閉 prompt suggestions 與過濾 shell 輸出確實有效,但幅度小,排在最後再算。

測量結果說了什麼

標題數字的算法:基準 100,促銷等級 150,永久等級 125。125 / 150 = 0.8333,所以砍幅是 16.67%,四捨五入為 17%。錯誤的讀法是把增幅相減(50% 降到 25%),然後說砍了 25%。s2

促銷從 2026 年 5 月 13 日持續到 2026 年 9 月 13 日,只對 Claude Code 把每週額度提高 50%,5 小時額度不變。適用於 Pro、Max、Team 與按席位計費的 Enterprise 方案。s1

以下的測量來自一台機器上的 Claude Code 日誌:455 個主 session、2,631 次 subagent 執行、63,398 筆去重後的請求,期間為 2026-09-03 到 2026-10-03。第一個發現與計數本身有關:每筆請求平均出現在 1.96 行日誌上,所以把每一行加總會讓 token 總量高估 99.3%。任何讀這些日誌的腳本都必須先以 (message.id, requestId) 去重。s11

subagent 是最大的一項。去重後,它們佔總 token 的 48.1%、輸出 token 的 63.9%、加權成本的 55.3%。一次 subagent 執行的第一筆請求,在做任何事之前就帶著中位數 47,117 token 的 prompt;p90 是 52,681,最大值 126,769。工具集受限的 agent 起點低得多(最小值 5,295)。s8

模型選擇會放大這個效果。除非 model frontmatter、每次呼叫的 model 參數或 CLAUDE_CODE_SUBAGENT_MODEL 另有指定,subagent 會繼承主對話的模型;而且自 v2.1.251 起,單靠環境變數不再覆蓋 frontmatter:必須加上 CLAUDE_CODE_SUBAGENT_MODEL_FORCE=1。在日誌中,光是 claude-opus-5 就佔全部 token 的 31.5%、加權成本的 35.8%,其中 63.2% 花在 subagent 內。s3

快取層級取決於請求在哪裡執行。在這份資料中,subagent 的快取寫入 100.0% 是 5 分鐘,主 session 的快取寫入 100.0% 是 1 小時,沒有任何請求是混合的。在 subagent 執行內,41,790 筆後續請求中只有 95 筆(0.2%)是在超過 5 分鐘的間隔後才到達,但它們平均寫入 74,582 個 cache_creation token,熱請求則是 3,886。subagentPromptCacheTtl 設定與 CLAUDE_CODE_SUBAGENT_PROMPT_CACHE_TTL 環境變數接受 5m 或 1h,需要 Claude Code v2.1.242 或更新版本。s4

另一個獨立的測試看到同樣的分野:每筆 subagent 請求都寫在 ephemeral_5m_input_tokens 下,而父層用的是 ephemeral_1h_input_tokens,其中一個 agent 在五分鐘視窗之後的請求上,重寫了前綴的全部 20,971 個 token。s6

主 session 對應的情況是長時間休息。距上一次請求不到 5 分鐘的請求,cache_creation 中位數為 1,176(n = 18,029)。5 到 60 分鐘之間是 1,327(n = 414)。超過 60 分鐘是 130,332(n = 79),prompt 中位數 175,523 token,p90 為 674,348。文件確認,進入超額計費後,主對話同樣會降到五分鐘層級。s3

session 啟動是固定成本:主 session 的第一筆請求帶著中位數 55,989 token(p90 72,000),各專案之間從 15,764 到 105,020 不等,取決於 CLAUDE.md 與記憶的大小。先前一份公開測量把空目錄的下限定在約 29k,掛 3 個 MCP server 為 30.4k,在真實 repo 中為 38.8k。s9

effort 是文件大力推薦、日誌卻沒有回報的槓桿。在主 session 上,high 的請求平均輸出 778 token,medium 為 837;subagent 在 high 平均產出 323,對比 642。這個比較有干擾因素(任務、模型、專案都不同),所以它只是讓人存疑的理由,不是證明。Claude Code 團隊自己的指引,把 effort 視為把推理花在哪裡,而不是預算旋鈕。s10

兩個流行的小技巧,實測效果很小。Prompt suggestions 會多花請求,廣為流傳的「省約 10%」是上限,不是典型的節省;設定是 promptSuggestionEnabled: false 或 CLAUDE_CODE_ENABLE_PROMPT_SUGGESTION=false。s12 二十天內的 shell 輸出過濾,把 6,670 萬 token 的輸出減到 2,410 萬,但那 6,670 萬只佔同一時段新消耗 token 的 7.4%。s11

測量數據

Subagent 啟動成本,第一筆請求的 prompt(單位 token),依模型:

模型 n min median p90 max
All 2,631 5,295 47,117 52,681 126,769
claude-opus-5 1,262 36,864 43,905 48,032 50,398
claude-sonnet-5 633 5,916 52,409 53,961 126,769
claude-opus-5-5 426 39,408 47,189 48,362 48,883
claude-sonnet-5-5 165 44,471 47,348 50,197 50,863
claude-fable-5-1 102 36,551 42,593 44,286 47,385
claude-haiku-4-5 42 5,295 29,636 36,714 79,190

恢復時的快取重寫,主 session,依請求前的間隔:

間隔 n cache_creation median mean cache_read median prompt median
< 5 min 18,029 1,176 2,391 184,169 186,412
5 to 60 min 414 1,327 5,575 221,857 225,168
> 60 min 79 130,332 241,499 25,264 175,523

方法:讀取每個 ~/.claude/projects/*/<uuid>.jsonl 主 session 與每個 */<uuid>/subagents/agent-*.jsonl 執行,請求自 2026-09-01 起。以 (message.id, requestId) 對 assistant 行去重,每筆請求只保留一筆 usage 記錄。總 token = input + output + cache_read + cache_creation;prompt 大小 = input + cache_read + cache_creation。間隔 = 在同一個 session 或執行內,從上一筆請求的最後一行日誌到本筆請求第一行的時間。加權成本使用相對權重:input 1、5m 快取寫入 1.25、1h 快取寫入 2、快取讀取 0.1、output 5;這些權重是假設,不是公布的費率。

週一就做

  • 在你的方案上執行 /usage,閱讀依 skill、subagent、plugin 與 MCP 分列的明細,以及近期用量達 10% 以上所觸發的行為標記。
  • 列出你的 subagent 定義,替每一個只做搜尋、檢查或摘要的,加上 model: haiku 或 model: sonnet frontmatter。
  • 如果想讓所有 subagent 不管 frontmatter 都用同一個模型,設定 CLAUDE_CODE_SUBAGENT_MODEL 與 CLAUDE_CODE_SUBAGENT_MODEL_FORCE=1。
  • 確認你的 Claude Code 版本在 2.1.242 或以上,然後依工作流程決定 subagentPromptCacheTtl: "1h" 划不划算:它對在工具呼叫之間閒置的 subagent 有幫助,對短命的沒有。
  • 休息超過一小時之前,先在目前的 session 完成任務並寫一份交接檔;回來時開新 session,不要去恢復一個 175k token 的 prompt。
  • 針對你自己的日誌寫一個唯讀腳本,以 (message.id, requestId) 去重,先比較主 session 與 subagent 的佔比,再改其他東西。
  • 如果你從不使用 suggestions,就設定 promptSuggestionEnabled: false,並把節省量視為最多幾個百分點。

延伸閱讀

  • Max 5x 對 Max 20x:砍額度之後使用者實測的容量比,是影片沒談到的方案選擇問題。s7
  • 快取 TTL 的完整優先順序(force 環境變數、bucket 環境變數、bucket 設定、subagent 的 experimental.cacheTtl),以及超額計費下會有什麼改變。s4
  • 為什麼在 session 中途更改 effort,在大多數模型上可能讀取整段歷史卻完全沒有快取命中,以及哪些模型例外。s3
  • 如何在自己的 session 日誌中讀 usage 欄位與快取層級,以及 ccboard 的每日預算檢視做法。s11
  • 三個 subagent 檔案、三個模型,以及每次啟動實際寫入快取的量,附有作者自己的更正。s8
  • 延遲載入的 MCP 工具定義,以及用 ENABLE_TOOL_SEARCH=auto:N 控制工具 schema 何時載入 context。s3

來源

常見問題

這是砍 17% 還是加 25%?

兩者皆是,只是基準不同。相對促銷前的基準 100,永久等級 125 是加 25%。相對使用者在 2026 年 5 月 13 日到 9 月 13 日之間擁有的促銷等級 150,則是砍 17%。

該把 subagentPromptCacheTtl 全部設成 1h 嗎?

只有在你的 subagent 於請求之間閒置超過五分鐘時才需要。在日誌中,只有 0.2% 的後續請求碰到這種情況,所以一律用 1h 層級,多半只是白付更高的寫入價格。先量測你自己的間隔分布。

降低 effort 會省 token 嗎?

在這些日誌中看不出來:主 session 上 high 請求平均輸出 778 token,medium 為 837。資料有干擾因素,所以誠實的答案是:effort 是品質旋鈕,它的節省量你得在自己的任務上測量。

為什麼午休後的第一個 prompt 這麼貴?

主 session 寫入的是 1 小時快取。間隔超過 60 分鐘後,下一次請求會重寫前綴:日誌中 cache_creation 中位數是 130,332 token,熱請求則是 1,176。長時間休息前先完成任務,休息後再重新開始。