Agent 工具的 effort 可以填哪些值？
官方 changelog 只寫了「新增 effort 參數」，沒有列出值。社群提案建議的是 low、medium、high、xhigh、max，但那是提案內容，並非確認的出貨行為。
請查官方 sub-agents 文件，或在測試專案用不同值各呼叫一次，看哪些被接受、哪些報錯。
per-call 的 effort 會蓋過 agent 定義裡的 effort 嗎？
提案希望的順序是 per-call 優先於 agent 定義，再優先於 session 等級，這也符合一般「呼叫端覆寫預設」的直覺。但官方沒有明說，我也沒有查到維護者的確認。
實測方式很簡單：定義一個 effort 為 low 的 agent，再用 per-call 傳 high，檢查實際行為與 token 用量。
把 effort 調低一定會比較省錢嗎？
方向上通常是，因為思考 token 較少，但沒有官方數據說明各等級實際省多少，品質也可能同時下降。
所以要先量基線，再只在重複性高、錯了代價低的任務降 effort，並以帳單與結果品質雙重確認。
我已經有 reviewer-low、reviewer-high 這種分級 agent，要馬上合併嗎？
不必急。先確認 per-call 參數的值與優先順序都如預期，再逐步把分級 agent 收斂成一個。
合併前保留舊的設定一段時間，兩種做法平行跑一輪，確認行為一致後再移除。
Claude Code v2.1.292（2026 年 10 月 6 日）在 changelog 的新增項目中列了一行：Agent 工具新增 effort 參數。官方只有這一句，沒有給值的清單或優先順序說明，因此這篇會把「確定的」和「推測的」分開寫。
在此之前，Agent 工具已經能在每次呼叫時指定 model，但 subagent 的 effort 只能來自兩個地方：agent 定義裡的 effort（frontmatter 或 --agents JSON），或沿用主 session 的等級。社群 GitHub 上有多個相關提案，其中一個把需求講得很具體：主 session 跑 medium，機械式的批次工作想用 low，棘手的審查想用 xhigh，而且用的是同一種 agent。沒有 per-call 參數時，只能為每個等級各建一個 agent 類型，例如 reviewer-low、reviewer-high，agent 清單因此變得雜亂。
確定的是 changelog 這一行：Agent 工具現在有 effort 參數，且同一版本還新增了 claude Plugin install --marketplace 等功能。不確定的是細節。上述提案建議的值是 low、medium、high、xhigh、max，優先順序為「每次呼叫的 effort > agent 定義的 effort > session 等級」，但那是提案內容，我查到的資料裡沒有維護者確認出貨行為，也沒有說明哪些模型支援。另一個專案的整合紀錄把 frontmatter 當預設、per-call 當覆寫，也屬於使用者側的理解。實際接受的值與優先順序，請以官方 sub-agents 文件或自己的小測試為準。
effort 直接影響思考 token 的用量，而思考 token 按輸出價計費。把低風險、重複性的子任務（掃描檔案、格式檢查、抽取欄位）降到較低 effort，把少數需要判斷的審查提高，是把預算花在刀口上的做法。這和 Haiku 5.5 這類小模型搭配 subagent 的思路一致：不同的子任務值得不同的成本。目前沒有官方數字說明各等級實際省多少，所以收益要靠你自己量。
如果你的團隊跑很多 subagent，先量一週基線：各 agent 平均用多少 token、花多少錢。然後挑一個重複性最高的 agent，用 per-call 的低 effort 跑同一批任務，比較品質與帳單差異。只有在品質沒有下降、成本確實降低時才改預設。在沒有官方等級對照數據之前，把「省多少」當成假設，用你自己的帳單驗證。