![矽基前沿 [Si]gnals](/silicon-frontier-signals-logo.png){kind=logo}
Claude 有兩種預算，只有一種真的會讓代理停下來
一個按美分硬停，一個只是講給模型聽。
我一直想要一個開關：這個代理最多花我 25 美元，到了就停手。8 月 7 日 Anthropic 給 Claude Managed Agents 開了這個開關。
建 session 的時候多帶一個 budget 欄位。寫法有點刁：金額是整數美分、而且要寫成字串，"2500" 是 25 美元，寫成 "25.00" 直接退你 400 錯誤。官方的理由是用字串就永遠不會有浮點數去碰這個金額。撞到上限，session 不是死掉，是停在 idle，stop_reason 給 budget_reached，歷史跟沙箱都留著。你把上限改高、或整個拿掉，它自己接著跑。
三件事我會先記下來。
它算的是牌價，不是你的價。 平台照公開定價把 session 消耗的東西即時記帳：模型 token 照各自牌價、每千次網路搜尋 10 美元，還有 session 的執行時間，每小時 0.08 美元。官方寫得很白：談過折扣的組織，session 會在牌價總額撞上限時就停，你實際被收的錢比那個上限少。這是一道花費的閘，不是一張帳單。
它攔的是下一個請求，不是攔到一半。 平台在每次模型請求之前檢查，跨過上限的那個請求是在還沒超過時被放行的，會跑完。官方自己舉的例子：設 50 美分，可以停在 53 美分。多執行緒的 session 就是每條執行緒各多一個請求的量。
拿掉上限是單向門。 一個 session 的預算移除之後，再也加不回去；一開始沒設預算的 session 也不能事後補。要留著閘，就用「改高」不要用「移除」。
還有一個很容易混的地方。Messages API 那邊也有一個叫預算的東西，task_budget，但它是勸告：用 token 計，只給模型看一個倒數，讓模型自己收斂進度，官方明說是 soft hint 不是 hard cap，真正的硬天花板還是 max_tokens。它最低要 20,000 token，而且文件警告設太小會讓模型擺爛——看到一個明顯做不完的預算，它可能乾脆不做，或者自己把範圍砍掉。兩個東西都叫預算，一個會讓代理停手，一個只是講給模型聽。
我自己會這樣用：排程跑的代理一律綁 session 預算。但要記得 deployment 上設的預算是複製到它啟動的每一次 run，不是那條排程的累計花費——這句我第一眼讀反了，讀反的代價是你以為設了月上限，其實設的是每次上限。上個月 Claude Code 那三道代理閘講的是同一件事：你能調的是刻度，不是有沒有這道閘。
查核備註：規格與數字全部出自 Anthropic 官方文件與 8 月 7 日的 release notes，官方一次資料。我沒有實際建過帶預算的 session；超額那 3 美分在帳單上長什麼樣，以及多代理 session 共用一份預算、advisor 呼叫也計入這兩點，都是文件說法，我沒實測。
SOURCES
- ASession budgets — Claude Platform Docs
- AClaude Platform release notes — August 7, 2026
- ATask budgets — Claude Platform Docs
來源分級:A = 一手公告/論文/官方文件 · B = 可信媒體 · C = 可參考但需脈絡 · D = 觀察用，不可當事實。
本文由 AI 與編輯共同撰寫，總編輯廖玄同審閱定稿。 編輯方針與 AI 使用說明
