~/教學/LIMIT.md

文章 / Claude Code

Claude Code 額度別燒在雜事上:一個 Haiku 5.5 小幫手子代理+CLAUDE.md 一段,改檔名、找檔案不再吃 Opus 的額度

官方說 Opus 每回合耗的額度是 Sonnet 的好幾倍,Sonnet 又多過 Haiku。兩個可直接貼的檔案:.claude/agents/helper.md(model: haiku)和 CLAUDE.md 一段,雜事交給小幫手,規劃、除錯留在主對話。省多少看雜事佔比,不保證不爆。

Claude Code 的額度又用完了,回頭看紀錄,Opus 剛剛花了好幾回合在改檔名、找檔案、讀 log。這篇是 Reels 裡 LIMIT 那支的完整版:Anthropic 的說明頁寫得很清楚,Opus 每回合耗的額度是 Sonnet 的好幾倍,Sonnet 又多過 Haiku;而一段對話預設就是同一個模型從頭做到尾,雜事也照算。解法是兩個檔案:一個跑在 Haiku 上的小幫手子代理,加上 CLAUDE.md 裡一段分工說明。兩個檔案都可以直接複製,內容在 2026-11-20 對照官方文件和價目表確認過。

01你會得到什麼:改檔名、找檔案不再花 Opus 的額度

Reels 畫面:同一個方案的兩條剩餘額度示意條,全部給 Opus 那條被改檔名、找檔案、讀 log 三張紙條吃掉,雜事給 Haiku 5.5 那條還是綠的
Reels 畫面(示意圖):兩條額度條是畫的,百分比不是量測值;省多少要看你的雜事佔幾成。

先講清楚問題。Claude Code 一段對話就是一個模型在做:你用 /model 選了 Opus,接下來每一回合,不管是跨十個檔案的重構還是改一個檔名,都是 Opus 在算額度。官方的「Models, usage, and limits in Claude Code」說明頁直接寫:Opus 每回合耗的額度是 Sonnet 的好幾倍,Sonnet 又多過 Haiku;Opus「會用掉明顯更多的額度,例行工作請考慮換成 Sonnet」;Haiku 則是「最快、最便宜的選項,適合快速查詢、簡單修改、大量的腳本式執行」。

support.claude.com 說明頁 Choosing a model 一節:Sonnet 適合大多數程式工作、Opus 會用掉明顯更多額度、Haiku 最快最便宜
官方說明頁(2026-11-20 截圖):Choosing a model 一節。

做完這篇,你的專案會多兩個檔案,效果是:

  1. 一個叫 helper 的子代理,跑在 Haiku 上,專門做找檔案、讀 log、列資料夾、改檔名、一行修改這種不用動腦的事。
  2. CLAUDE.md 多一段分工:主對話看到這類雜事就交給 helper,自己只留規劃、除錯和跨多個檔案的修改。
  3. 你不用每次手動打 /model 切來切去;主對話還是你選的模型,雜事自動分出去。
  4. 兩個檔案都是純文字,放進專案後幾秒內生效(第一次建 agents 資料夾要重開一次,後面會講)。

02檔案 1:.claude/agents/helper.md,跑在 Haiku 上的小幫手

子代理(subagent)在 Claude Code 裡就是一個 Markdown 檔:上面一段 YAML frontmatter 寫名字、什麼時候用、能用哪些工具、用哪個模型,下面是它的系統提示。放在專案的 .claude/agents/ 只對這個專案有效;放在家目錄的 ~/.claude/agents/ 對你所有專案有效。我放專案裡,這樣可以跟著 git 一起給同事。

  1. 在專案根目錄建資料夾 .claude/agents/(已經有就跳過)。
  2. 在裡面新增 helper.md,把下面整段貼進去存檔。
  3. 如果 agents 資料夾是這次新建的,把 Claude Code 關掉重開一次;官方寫它只監看開工時就存在的資料夾。之後再改這個檔,幾秒內自動生效,不用重開。
.claude/agents/helper.md(整個檔案,照貼)
---
name: helper
description: Use proactively for quick mechanical jobs that need no judgement - searching files, reading logs, listing folders, renaming files, one-line edits. Not for planning, debugging or changes across several files.
tools: Read, Glob, Grep, Bash
model: haiku
---

You are a fast helper for small, mechanical jobs. Do exactly what was asked, nothing more.
Return the result in a few lines (the paths found, the log lines that matter, what you renamed or edited).
If the job turns out to need design decisions, debugging or changes in several files, stop and say so instead of guessing.

四個欄位的意思,照官方的 frontmatter 參考表:name 必填,就是你之後叫它的名字;description 必填,Claude 看這段決定要不要派工作給它,「Use proactively」是官方建議加的字眼,會讓它更主動派;tools 可以不寫,不寫就繼承全部工具,我只給它讀檔、找檔、grep 和 Bash;model 可以填 sonnet、opus、haiku、fable 這幾個別名、完整的 model ID,或 inherit(跟主對話同一個模型),不寫的話預設也是跟著主對話。這裡的重點就是 model: haiku 這一行。

code.claude.com 子代理文件:Claude Code 會監看 ~/.claude/agents/ 和 .claude/agents/,改檔幾秒內生效,三種情況仍要重開
官方文件(2026-11-20 截圖):Write subagent files 一節,哪三種情況要重開寫在這裡。
Reels 畫面:筆電上打出我們的 .claude/agents/helper.md,name: helper、description 寫找檔案讀 log 等雜事,蓋章檔案 1
Reels 畫面:helper.md 打進筆電,和上面那段一模一樣。

03檔案 2:CLAUDE.md 加一段分工

CLAUDE.md 是每次開 Claude Code 都會先讀的專案說明,官方說可以放在 ./CLAUDE.md 或 ./.claude/CLAUDE.md。有了小幫手還不夠,要告訴主對話「這些事別自己做」,不然它看到改檔名還是會順手自己改,額度照扣。

  1. 打開專案的 CLAUDE.md。沒有的話在 Claude Code 裡打 /init,官方說它會分析專案產生一份起始檔;已經有的話 /init 只會建議修改,不會覆蓋。
  2. 把下面這段貼到檔案最後,存檔。
  3. 下一次開 Claude Code 時打 /context all,在 Memory files 清單裡看到 CLAUDE.md,就表示有載入。
CLAUDE.md 加這一段(照貼)
## Delegation

Hand quick mechanical jobs to the `helper` subagent (it runs on Haiku): searching files, reading logs, listing folders, renaming files, one-line edits.
Keep planning, debugging and changes across several files in the main session.
code.claude.com 文件:專案 CLAUDE.md 可放在 ./CLAUDE.md 或 ./.claude/CLAUDE.md,用 /context all 確認載入,/init 可自動產生
官方文件(2026-11-20 截圖):Set up a project CLAUDE.md 一節。
Reels 畫面:筆電上的 CLAUDE.md 多了 Delegation 一段,helper 和 Haiku 兩行反白,蓋章檔案 2
Reels 畫面:CLAUDE.md 加這一段就好。

04怎麼分工:哪些給小幫手,哪些留在主對話

Reels 畫面:兩張紙卡,Haiku 幫手列找檔案、改檔名、讀 log、列資料夾、一行修改,Opus 列規劃、除錯、多檔修改,章寫難的留給 Opus
Reels 畫面:分工表。左邊給小幫手,右邊留在主對話。

這個分法不是我發明的,是照說明頁「Match the model to the job」那條習慣:Haiku 做快速的機械工作(它舉的例子是改名、log 行、解釋 regex、樣板程式碼),Sonnet 做大多數程式工作,Opus 留給真的卡住或改動很廣的時候。

  1. 給 helper:找出某個函式被哪些檔案用到、列出某個資料夾的檔案、讀 log 找出錯誤那幾行、把 a.js 改名成 b.js 並更新 import、改一個常數或一行設定。
  2. 留在主對話:要先想架構的功能、找不到原因的 bug、一次動到好幾個檔案的重構、任何需要判斷「該不該」的事。
  3. 不確定的就留在主對話。小幫手系統提示的最後一句就是:發現要做決定、要除錯、要動多個檔案,就停下來回報,不要猜。

貼好之後可以這樣試一句:

測試用(在主對話裡打)
用 helper 子代理找出專案裡所有用到 fetchUser 的檔案,列出路徑就好,不要改任何東西。

照官方文件,Claude 會依你的要求、子代理的 description 和當下情境決定要不要派;你也可以像上面那樣直接點名。派出去的工作在子代理自己的 context 裡做,回到主對話的只有摘要,搜尋過程不會塞進你的對話,這是子代理另一個好處。

05價格:Haiku 5.5 到底多便宜

platform.claude.com 價目表:Opus 5.5 每百萬 token 輸入 4 美元、Sonnet 5.5 2 美元、Haiku 5.5 在 10 萬 token 內 0.10 美元
官方價目表(2026-11-20 截圖):Model pricing 表。

2026-11-20 的官方價目表(美元,每百萬 token):Haiku 5.5 在提示 10 萬 token 以內是輸入 0.10、輸出 0.50;超過 10 萬 token 變成輸入 0.50、輸出 2.50。同一張表上,Haiku 4.5 是 1 / 5,Sonnet 5.5 是 2 / 10,Opus 5.5 是 4 / 20。

Anthropic 2026 年 10 月 7 日的 Haiku 5.5 發表文寫:10 萬 token 以內的請求比 Haiku 4.5 便宜 90%,超過的便宜 50%,平均下來「大約便宜 75%」;也說它「適合搭配 Opus 5.5 和 Sonnet 5.5 當程式工作的子代理」。這就是小幫手選 haiku 而不是 sonnet 的原因。

06要注意

  1. 不保證不爆。省多少完全看你的工作裡雜事佔幾成;規劃、除錯那些回合還是原本的模型在算額度。官方沒有給任何「分給 Haiku 能省幾 %」的數字,Reels 和封面上那兩條 28% / 81% 的額度條是畫的示意圖,不是量測。
  2. 小幫手的請求也算額度。子代理文件寫得很直接:它自己送出的請求「算在和主對話同一個用量限制裡」。它只是便宜,不是免費。
  3. 三種情況要重開 Claude Code 才會載入:第一次建 .claude/agents/ 資料夾;用 --add-dir 或 /add-dir 加進來的資料夾裡的 .claude/agents/(這些不會被監看);用 --disable-slash-commands 開的 session(完全不監看)。
  4. /agents 在現在的版本只會印一行提醒,叫你直接問 Claude 或自己編輯 .claude/agents/;v2.1.197 以前才會開互動式精靈。想確認子代理有沒有被讀到,直接問 Claude 你有哪些子代理,或像上面那樣點名派一次。
  5. CLAUDE.md 有沒有載入,用 /context all 看 Memory files 清單;全螢幕模式下 /context 會把這個清單收起來。
  6. 主對話的模型本身也可以換:說明頁說 /model 隨時能切、不會丟掉對話,常見做法是用 Opus 規劃、Sonnet 執行。小幫手是把最底層的雜事再分出去,兩件事可以同時做。
  7. 兩個檔案是我們依 2026-11-20 的官方文件寫的,欄位都對得上 frontmatter 參考表;但我們沒有量測它實際省了多少額度,這篇也不假裝有。
Reels 畫面:黑牌寫省多少看你雜事佔幾成,紅章不保證不爆,小紙條寫規劃除錯還是 Opus 在算額度、幫手的請求也算在同一個額度
Reels 畫面:老實說的那一段。

資料來源

延伸閱讀