重點摘要
- 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: sonnetfrontmatter。 - 如果想讓所有 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
來源
- Claude Code May to August 2026 weekly limits promotion, Anthropic help center。為什麼值得讀:Anthropic 自己的說法,50% 促銷的確切日期、方案與範圍。
- Anthropic is cutting Claude Code's current weekly limits by 17 percent, BleepingComputer。為什麼值得讀:25% 的增幅與 17% 的砍幅並列,附上公告的引文。
- Manage costs effectively, Claude Code docs。為什麼值得讀:
/usage明細、subagent 模型繼承,以及 effort 與 MCP 的快取規則。 - How Claude Code uses prompt caching, Claude Code docs。為什麼值得讀:對 5m 與 1h 層級及 TTL 設定唯一權威的說明。
- Sub-agents burning your Claude Code 5-hour window? Check the cache TTL, Reddit r/ClaudeAI。為什麼值得讀:最早點出 subagent 5 分鐘快取的討論串,附上切換它的設定。
- Max20x is now just 1.5 times better than Max5x, Reddit r/ClaudeCode。為什麼值得讀:砍額度之後,使用者對兩個 Max 層級容量的比較。
- Three Claude Code subagent files, three models in frontmatter, dev.to。為什麼值得讀:可重現的啟動成本實驗,附原始 usage 欄位與誠實的更正。
- Claude Code token overhead: what 33k actually costs, devaireviews.com。為什麼值得讀:在空目錄、掛 MCP server 與真實 repo 三種情況下的啟動開銷測量。
- Using Claude Code: Spending your effort, X, Claude Code team。為什麼值得讀:團隊如何看待 effort 等級;文中沒有任何 token 數字,這正是重點。
- The real cost of AI, part 9: measure your own usage, florian.bruniaux.com。為什麼值得讀:一份二十天的日誌研究,讓 shell 輸出過濾與總消耗量之間的比例一目了然。
- PSA: Turn off Prompt Suggestions, save ~10% of your limits/spend, Reddit r/ClaudeAI。為什麼值得讀:最初的說法,以及把 10% 收斂為上限的討論串。
常見問題
這是砍 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。長時間休息前先完成任務,休息後再重新開始。
AIDive