为 Agent 调用设置美元预算上限

目标

给可调用工具和多轮推理的 Agent 设定成本护栏。

步骤

1. 在 ClaudeAgentOptions(max_budget_usd=0.10) 设置业务认可的美元上限。 [budget]
2. 遍历结果并读取 ResultMessage.total_cost_usd 与 subtype。 [budget]
3. 将 subtype == "error_max_budget_usd" 标记为预算停止，向用户呈现部分结果和实际费用。 [budget]

验证方式

触发低预算测试时识别预算状态并记录最终费用，而非将其视为一般成功。

故障处理

若最终费用略超上限，README 说明预算在每个 API 调用后检查，可能超过一次调用成本；为此预留余量。