CC逆引きリファレンス

非対話で実行したい

11. CI/CD・自動化

コマンド / 機能

claude -p "query"

ヘッドレスモード

概要

-p（--print）フラグを使うと、対話モードではなくワンショットで実行し、結果を標準出力に出力します。スクリプトや CI/CD での自動化に必須のモードです。

設定例

# 基本的なヘッドレス実行
claude -p "このプロジェクトの概要を説明して"

# ファイルを指定して質問
claude -p "src/index.ts の主要な関数を説明して"

# 複数行のプロンプト
claude -p "以下のコードをレビューして:
- バグの有無
- パフォーマンス問題
- 改善提案"

# 結果をファイルに保存
claude -p "READMEを生成して" > README.md

こんな時に使う

  • スクリプトから Claude を呼び出したい時
  • CI/CD パイプラインで使いたい時
  • 自動化ワークフローに組み込みたい時

使い方

  1. 1claude -p "プロンプト" でヘッドレス実行
  2. 2結果は標準出力に出力される
  3. 3> でファイルにリダイレクト可能
  4. 4終了コード 0 で成功、1 で失敗

Tips

  • -p は --print の短縮形
  • 対話モードと違い、確認なしで実行される場合がある
  • 長いプロンプトは < でファイルから読み込むと便利
  • CI では --permission-mode bypassPermissions と組み合わせる

同じカテゴリの記事

JSON 出力したい
claude -p --output-format json "query"
ストリーミング JSON 出力したい
--output-format stream-json
テキスト出力したい
--output-format text
ターン数を制限したい
claude -p --max-turns 3 "query"
パイプで入力したい
echo "query" | claude -p
ファイルから入力したい
claude -p < input.txt
カテゴリ一覧
CI/CD・自動化
次の記事
JSON 出力したい