--max-turns
CLI（コマンド・フラグ） ／ 実行フラグ ・ 最終確認 2026年7月11日
ひとことで：エージェントの自律ターン数を制限する。
書式
--max-turns <n>説明
暴走や過剰なループを防ぐ安全弁として。
用例
claude -p "直して" --max-turns 5出典（公式ドキュメント）
- Claude Code 公式ドキュメント｜CLI reference（CLIコマンド・フラグ） ・ 確認 2026年7月11日
コマンド名・書式・キー割り当ては Claude Code のバージョンで変わることがあります。実行前に必ず上記の公式ページで最新の記載をご確認ください。当辞典の説明・用例は公式原文の逐語転載ではなく、日本語で要約し直したものです。
よくある質問
--max-turns とは何ですか？
エージェントの自律ターン数を制限する。
--max-turns はどう使いますか？
暴走や過剰なループを防ぐ安全弁として。 用例: claude -p "直して" --max-turns 5
--max-turns の種別・カテゴリは？
種別は「CLI（コマンド・フラグ）」、カテゴリは「実行フラグ」です。
--max-turns の情報はどこで確認できますか？
Claude Code 公式ドキュメント（https://code.claude.com/docs/en/cli-reference）で 2026年7月11日 に確認しました。仕様は改定されることがあるため、実行前に公式ページで最新の記載をご確認ください。
同じカテゴリ（実行フラグ）の他の項目
- --model ・ 現在のセッションで使うモデルを指定する。
- --add-dir ・ Claudeが読み書きできる作業ディレクトリを追加する。
- --allowedTools ・ 権限プロンプトなしで実行できるツールを指定する。
- --disallowedTools ・ ツールを拒否するルールを指定する。
- --permission-mode ・ 起動時の権限モードを指定する。
- --dangerously-skip-permissions ・ 権限プロンプトをすべてスキップする（取り扱い注意）。
- --output-format ・ printモードの出力形式を指定する（text / json / stream-json）。
- --input-format ・ printモードの入力形式を指定する。
- --max-budget-usd ・ 停止までにAPIへ使う上限金額（ドル）を設定する。
- --verbose ・ 詳細ログを有効化し、ターンごとの動きを全部表示する。
- --mcp-config ・ JSONファイルまたは文字列からMCPサーバーを読み込む。
- --append-system-prompt ・ 既定のシステムプロンプトの末尾に独自テキストを追加する。