-p フラグでワンショット実行を行う

-p フラグでワンショット実行を行う

claude -p（--print）フラグを使うと、対話型セッションを起動せずにクエリを実行して結果を取得できます。スクリプト化、パイプライン処理、CI/CD での活用に最適です。

基本的な使い方

# 単純なクエリ実行
claude -p "このプロジェクトのアーキテクチャを説明して"

# パイプからの入力
cat error.log | claude -p "このエラーログの原因を分析して"

# ファイルの内容を分析
cat src/auth.ts | claude -p "このファイルのセキュリティ問題を指摘して"

出力フォーマットの指定

--output-format で出力形式を制御できます。

# プレーンテキスト
claude -p "クエリ" --output-format text

# JSON形式（ツール利用を含む詳細）
claude -p "クエリ" --output-format json

# ストリーミングJSON
claude -p "クエリ" --output-format stream-json

ターン数の制限

--max-turns で最大ターン数を制限できます。無限ループを防ぐのに有効です。

# 最大3ターンで実行
claude -p --max-turns 3 "TypeScriptの型エラーを修正して"

実践的な使用例

コードレビューの自動化

git diff main...HEAD | claude -p "この変更のコードレビューをして。問題があれば指摘して"

コミットメッセージの生成

git diff --staged | claude -p "このステージングされた変更に適したコミットメッセージを生成して"

テスト失敗の分析

npm test 2>&1 | claude -p "テスト失敗の原因を分析して、修正案を提示して"

セッションの継続

# 前回のセッションを継続してワンショット実行
claude -c -p "前回の続きで型エラーを修正して"

CI/CD での活用

GitHub Actions との組み合わせ例。

- name: Code Review
  run: |
    git diff origin/main...HEAD | claude -p \
      --output-format text \
      --max-turns 1 \
      "Review this diff for security issues"

セッション名の付与

# セッションに名前を付けて実行（後で /resume で再開可能）
claude -n "auth-refactor" -p "認証モジュールのリファクタリング計画を立てて"

このように、-p フラグは単発のタスク実行からパイプライン処理まで幅広く活用できる強力な機能です。

---

あわせて読む

• パーミッションモードを使い分ける - 安全性と効率のバランスを設定する方法
• GitHub Actions CI/CD の実践 - CI/CD パイプラインでの活用例