启动参数看官方文档设置API调用的最大花费金额限制Syntax--max-budget-usd <amount>示例claude -p --max-budget-usd 5.00 "query"全网调研整理典型场景CI/CD 流水线中限制单次自动化任务的最大 API 花费，防止意外超支批量脚本运行时为每条子任务设定独立的花费上限调试新 prompt 阶段防止测试过程中意外消耗大量费用多 agent 并行任务中为每个实例设置独立预算护栏与 -p 和 --max-turns 组合，对非交互模式实施双重成本管控实用技巧与 --max-turns 5-10 组合使用，同时限制轮次与金额，构成双重失控防护加 --output-format json 时超额会返回 subtype: error_max_budget_usd，便于脚本精准捕获并处理相同 prompt 第二次执行因 prompt caching 命中成本大幅降低，可据此合理调低预算值配合 --effort 和 --model 调整时需重新估算预算，换用 Opus 成本可能数倍于 Sonnet超额时 Claude Code 以 exit code 1 退出，并在输出中报告实际已产生的花费常见坑限额是事后检查（post-hoc），一次 API 调用结束后才判断，实际花费可能数倍于设定值（已知超出 8 倍案例）仅在 -p（print/非交互）模式下生效，交互模式中此 flag 被静默忽略，不会报错也不会生效预算最低约 $0.05（系统提示 cache creation 固定成本），低于此值会立即触发预算错误来源When the Docs Fall Short: Investigating Claude Code's Budget CapManage costs effectively - Claude Code DocsCLI reference - Claude Code Docshermes-agent SKILL.md (autonomous-ai-agents/claude-code)How one bad prompt burned $40 of my Claude budget in 18 minutes创建于v2.0.28最近更新v2.1.239变化次数3新增 1改进 1修复 1变化时间线（按版本倒序）改进v2.1.239· 2026/08/22 · 25 天前支持通过 --max-budget-usd 参数指定最大预算修复v2.1.217· 2026/07/22 · 2026/07/22修复不停止后台 subagent 的问题，达到上限时现在会拒绝新生成并停止运行中的后台 agent新增v2.0.28· 2025/10/28 · 2025/10/28新增用于指定 SDK 最大预算限额的启动参数上一个--maintenance回到命令字典下一个--max-turns