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
- 初期化フックだけ実行して終了したい--init / --init-only
- 読み込む設定ソースを限定したい--setting-sources user,project,local
- ベータ機能を有効にして実行したい--betas
- 自動モードの分類ルールを確認したいclaude auto-mode defaults
- PTY付きバックグラウンドジョブとしてコマンドを実行したいclaude --bg --exec 'command'
- Bedrock/Vertex/Foundry で自動モードを使いたいdisableAutoMode / CLAUDE_CODE_ENABLE_AUTO_MODE
プロンプト
CI連携
- GitHub Actions 用の Claude をセットアップしたい/install-github-app
- GitHub Actions で使いたいclaude -p --permission-mode bypassPermissions
- CI で認証したいANTHROPIC_API_KEY 環境変数
- CI でキャッシュしたい~/.claude をキャッシュ
- CI/CD 用の長期トークンを発行したいclaude setup-token
- セルフホストの Claude apps ゲートウェイを立てたいclaude gateway --config gateway.yaml
- 深い自動レビューを実行したいclaude ultrareview [target] [--json]
- claude.ai 上にクラウドセッションを作りたい--cloud "<task>"
- OpenTelemetry でログ・メトリクスを収集したいOTEL_LOG_ASSISTANT_RESPONSES / OTEL_LOG_TOOL_DETAILS / OTEL_RESOURCE_ATTRIBUTES