启动参数看官方文档当默认模型过载时自动故障转移到指定模型Syntax--fallback-model <model>示例claude -p --fallback-model sonnet "query"全网调研整理典型场景CI/CD 流水线中主模型因 overload 返回 529 时，自动切换备用模型保证流水线不中断定时脚本或批量处理任务使用 -p（print mode）时，防止模型不可用导致整批任务失败高峰时段用 --model opus --fallback-model sonnet 组合，确保复杂任务在 Opus 过载时仍能完成GitHub Actions 中 claude-code-action 的 claude_args 配置备用模型，提升 PR 自动化可靠性API 用量达到 Max 订阅阈值时，作为手动控制的降级策略补充自动 fallback 机制实用技巧接受与 --model 相同的别名（sonnet/opus/haiku）或完整模型名（claude-sonnet-4-6），可混用别名与精确版本号在 claude-code-action 的 YAML 中用多行 claude_args 组合：--model opus --fallback-model sonnet --max-turns 100，fallback 模型会继承 --max-turns / --permission-mode 等设置固定 fallback 到具体版本号（如 claude-sonnet-4-6）而非别名，避免别名随 Anthropic 发布新版本意外跳变与 --output-format json/stream-json 搭配使用时，fallback 切换对下游解析器透明，无需额外处理交互模式下 Max 套餐有独立的自动 fallback 机制（Opus→Sonnet），无需此 flag；此 flag 专为 -p 自动化准备常见坑仅在 print mode（-p / --print）下生效，交互式会话中设置此 flag 无效只触发 overload（429/529）错误时的切换；server downtime、无效模型名、其他 5xx 均不触发，此为官方设计而非 bug（issue #8413 closed as not planned）主模型传入无效模型名（如拼写错误）时直接报错退出，不会降级到 fallback 模型来源Model configuration - Claude Code Docs[DOCS] Inconsistency between --fallback-model flag restrictions and Max User fallback behavior · Issue #19371Fallback model only triggers on overload, not on other failure scenarios · Issue #8413Fallback model only triggers on overload (claude-code-action) · Issue #594Claude Code CLI Reference: Every Command and Flag - opentools.ai最早记录ⓘ≤v2.1.152最近更新v2.1.178变化次数2改进 1修复 1变化时间线(按版本倒序)修复v2.1.178· 2026/06/16 · 25 天前修复了 compaction 在过载或模型不可用时不遵守该标志的问题。改进v2.1.152· 2026/05/27 · 2026/05/27当主模型未找到时切换到该配置的模型上一个--exec回到命令字典下一个--from-pr