12. CI/CD・自動化
ヘッドレスモード、パイプライン、システムプロンプト
Claude Code はヘッドレスモード(-p フラグ)でスクリプトや CI/CD パイプラインから非対話的に実行できます。JSON 出力、ターン数制限、ツール制限などを組み合わせて、自動化ワークフローに安全に組み込めます。
出力形式
実行制御
- ターン数を制限したいclaude -p --max-turns 3 "query"
- 終了コードを取得したいecho $?
- 出力を抑制したい--quiet または -q
- 詳細出力で実行したい--verbose または -v
- API コストの上限を設定したい--max-budget-usd
- セッションをディスクに保存させたくない--no-session-persistence
- スラッシュコマンドを無効にして実行したい--disable-slash-commands
- フック・LSP・プラグイン同期をスキップして高速実行したい--bare
- 複数ディレクトリにアクセスさせたい--add-dir <path>
- 非対話モードで権限確認を自動処理したい--permission-prompt-tool <tool>
- メンテナンスフックだけ実行して終了したい--maintenance