ターン数を制限したい
11. CI/CD・自動化コマンド / 機能
claude -p --max-turns 3 "query"概要
ターン数を制限することで、処理時間とコストを制御できます。1ターンはツール使用を含む1回の応答サイクルです。
設定例
# 最大3ターンで制限
claude -p --max-turns 3 "バグを修正して"
# 1ターンのみ（質問への回答だけ）
claude -p --max-turns 1 "このコードの問題点は？"
# CI での安全な実行（暴走防止）
claude -p --max-turns 5 --permission-mode bypassPermissions "テストを実行して修正"
# ターン数とコストの目安
# 1ターン: 単純な質問・説明
# 3-5ターン: ファイル編集・軽い修正
# 10+ターン: 複雑なリファクタリングこんな時に使う
- 処理時間を制限したい時
- コストを抑えたい時
- 単純なタスクで十分な時
使い方
- 1--max-turns N で最大ターン数を指定
- 2ターン数を超えると処理が停止
- 3CI では暴走防止のため必ず設定推奨
Tips
- 1ターン = 1回の応答（ツール使用を含む場合もある）
- 複雑なタスクは多くのターンが必要
- ターン数が足りないと「途中で終了」となる
- CI のタイムアウトと組み合わせて二重の安全策に