启动参数看官方文档限制Agent回合数(仅打印模式)Syntax--max-turns <number>示例claude -p --max-turns 3 "query"全网调研整理典型场景CI/CD 流水线中防止 agent 无限循环,避免超出 API 预算配合 `-p` 打印模式运行批处理脚本,确保每次任务在预定回合内结束设置 `--max-turns 1` 执行单次无工具调用的快速查询调试复杂 agent 任务时,逐步增大回合数观察每阶段行为在 GitHub Actions (`claude-code-action`) 中控制自动化工作流的最大执行轮数实用技巧与 `--max-budget-usd` 联用可实现双重防护:回合数 + 费用上限同时兜底与 `--output-format json` 组合使用,便于脚本解析结构化输出并检测是否正常退出达到上限时会输出 `Error: Reached max turns (N)` 并以非零状态退出,可在 shell 脚本中用 `$?` 捕获在 `claude-code-action` v1 中应通过 `claude_args: "--max-turns 10"` 传入(旧版独立输入参数 `max_turns` 已废弃)不指定时默认无限制,非交互式自动脚本中强烈建议显式声明以避免失控常见坑`--max-turns` 不出现在 `claude --help` 输出里(已知文档 Bug #16963),新版本升级后建议用 `claude --help` 重新确认是否已补全达到回合上限时 Claude 直接终止,不会输出部分完成的摘要,任务结果可能丢失仅在 `-p`/`--print` 非交互模式下行为有明确保证;交互式 REPL 下使用效果未经官方证实来源CLI reference - Claude Code Docs[BUG] --max-turns CLI option is undocumented in --help · Issue #16963 · anthropics/claude-codeclaude-code-action configuration.mdShipyard | Claude Code CLI CheatsheetClaude Code CLI Reference: Every Command and Flag - opentools.ai最早记录ⓘ≤v2.1.205最近更新v2.1.205变化次数1修复 1变化时间线(按版本倒序)修复v2.1.205· 2026/07/09 · 2 天前修复了在 --max-turns 限制下消息被 silently 丢失的问题上一个--max-budget-usd回到命令字典下一个--mcp-config