Claude Code headlessモード完全ガイド｜-pフラグ・JSON出力・セッション管理でCI/CDと自動化スクリプトに組み込む方法

# 最もシンプルな使い方
claude -p "src/auth/login.ts を読んでバグがあれば報告してください"

# stdinからプロンプトを渡す（パイプ対応）
echo "このコードをレビューして" | claude -p -

# ファイルの内容をプロンプトに含める
claude -p "$(cat error.log) このエラーログの原因を教えてください"

#!/bin/bash
# テスト失敗時にClaude Codeで原因を分析するスクリプト

# テストを実行
TEST_OUTPUT=$(npm test 2>&1)
EXIT_CODE=$?

if [ $EXIT_CODE -ne 0 ]; then
  echo "テスト失敗。Claude Codeで分析中..."
  ANALYSIS=$(claude -p "以下のテスト失敗ログを分析して原因と修正方法を教えてください:

$TEST_OUTPUT" --allowedTools "Read,Bash")

  echo "=== 分析結果 ==="
  echo "$ANALYSIS"
  exit 1
fi

# JSON形式で取得
claude -p "src/以下のファイル一覧とその役割を教えてください"   --output-format json

# jqで結果だけを取り出す
RESULT=$(claude -p "バグを特定してください"   --output-format json   | jq -r '.result')

echo "$RESULT"

# セッションIDも取得する
OUTPUT=$(claude -p "分析開始" --output-format json)
SESSION_ID=$(echo "$OUTPUT" | jq -r '.session_id')
RESULT=$(echo "$OUTPUT" | jq -r '.result')
TOKENS=$(echo "$OUTPUT" | jq -r '.usage.input_tokens')

echo "セッションID: $SESSION_ID"
echo "使用トークン: $TOKENS"

{
  "result": "Claudeの応答テキスト",
  "session_id": "sess_01AbCdEfGhIjKlMnOpQrStUv",
  "usage": {
    "input_tokens": 1523,
    "output_tokens": 847
  }
}

# ストリーミングでテキストだけを取り出す（リアルタイム表示）
claude -p "詳しい説明をしてください"   --output-format stream-json   --verbose   --include-partial-messages   | jq -rj 'select(
      .type == "stream_event" and
      .event.delta.type? == "text_delta"
    ) | .event.delta.text'

# Read と Bash のみ許可
claude -p "テストを実行して結果を教えてください"   --allowedTools "Read,Bash"

# Bashのコマンドをパターンで制限する
claude -p "gitの変更をコミットしてください"   --allowedTools "Read,Bash(git diff *),Bash(git add *),Bash(git commit *)"

# 読み取りのみ許可（ファイル変更禁止）
claude -p "このプロジェクトのアーキテクチャを説明してください"   --allowedTools "Read,Glob,Grep"

# 環境に依存しないクリーンな実行
claude --bare -p "このファイルのバグを特定して修正してください"   --allowedTools "Read,Edit"

# bareモード + 特定の設定ファイルを指定
claude --bare   --settings ".claude/ci-settings.json"   -p "テストを実行してください"   --allowedTools "Bash(npm test)"

#!/bin/bash
# セッションを引き継いで段階的に作業する例

# Step 1: 最初の作業 → セッションIDを保存
SESSION_ID=$(claude -p "src/auth/ ディレクトリを読んで認証フローを把握してください"   --output-format json   | jq -r '.session_id')

echo "セッションID: $SESSION_ID"

# Step 2: 同じセッションで次の作業
claude -p "把握した認証フローに基づいてセキュリティ上の問題を列挙してください"   --resume "$SESSION_ID"   --output-format json   | jq -r '.result'

# Step 3: さらに続ける
claude -p "最も深刻な問題を修正してください"   --resume "$SESSION_ID"   --allowedTools "Read,Edit"

# ファイルから関数名のリストを抽出する
claude -p "src/utils/string.ts の全関数名を抽出してください"   --output-format json   --json-schema '{
    "type": "object",
    "properties": {
      "functions": {
        "type": "array",
        "items": {"type": "string"}
      }
    },
    "required": ["functions"]
  }'   | jq '.structured_output.functions[]'

# コードレビュー結果を構造化して取得
REVIEW=$(claude -p "src/auth/login.ts をレビューしてください"   --output-format json   --allowedTools "Read"   --json-schema '{
    "type": "object",
    "properties": {
      "severity": {"type": "string", "enum": ["critical", "warning", "info"]},
      "issues": {
        "type": "array",
        "items": {
          "type": "object",
          "properties": {
            "line": {"type": "number"},
            "description": {"type": "string"},
            "suggestion": {"type": "string"}
          }
        }
      }
    }
  }')

# 重大な問題だけを取り出す
echo "$REVIEW" | jq '.structured_output | select(.severity == "critical") | .issues[]'

#!/bin/bash
# GitHub ActionsのPRレビュー自動化スクリプト

PR_NUMBER="${PR_NUMBER:-$(gh pr view --json number -q .number)}"
DIFF=$(gh pr diff "$PR_NUMBER")

# Claude Codeでレビュー
REVIEW=$(echo "$DIFF" | claude -p "
以下のPull Requestの差分をレビューしてください。

バグ・セキュリティ問題・コードの問題点があれば指摘してください。
問題なければ「LGTM」と一言だけ返してください。

---
$DIFF"   --bare   --allowedTools ""   --output-format json   | jq -r '.result')

# PRコメントとして投稿
gh pr comment "$PR_NUMBER" --body "## ? Claude Code レビュー

$REVIEW"

echo "レビュー完了"

#!/bin/bash
# デプロイ前に変更内容をClaudeにチェックさせる

set -e

echo "デプロイ前チェック開始..."

# 変更ファイルの一覧取得
CHANGED_FILES=$(git diff --name-only origin/main...HEAD)

if [ -z "$CHANGED_FILES" ]; then
  echo "変更なし。チェックをスキップ"
  exit 0
fi

# Claude Codeでチェック
CHECK_RESULT=$(claude -p "
以下のファイルが変更されています:
$CHANGED_FILES

これらのファイルを読んで、本番デプロイで問題になりそうな点を確認してください:
1. 設定ファイルに本番用の値が正しく設定されているか
2. デバッグ用のコード（console.log、TODO等）が残っていないか
3. 環境変数が正しく参照されているか

問題があれば「BLOCK: 理由」、問題なければ「OK」と最初に書いてください。"   --bare   --allowedTools "Read,Glob"   --output-format json   | jq -r '.result')

echo "$CHECK_RESULT"

# BLOCKで始まる場合はデプロイを中断
if echo "$CHECK_RESULT" | grep -q "^BLOCK:"; then
  echo "❌ デプロイをブロックしました"
  exit 1
fi

echo "✅ チェック完了。デプロイを続行します"

#!/bin/bash
# テスト失敗時に自動でデバッグレポートを生成する

TEST_OUTPUT=$(npm test 2>&1) || true
EXIT_CODE=$?

if [ $EXIT_CODE -ne 0 ]; then
  echo "テスト失敗 - Claudeで分析中..."

  # JSON Schemaで構造化されたレポートを生成
  REPORT=$(claude -p "
以下のテスト失敗ログを分析してください:

$TEST_OUTPUT"     --bare     --allowedTools "Read,Glob,Grep"     --output-format json     --json-schema '{
      "type": "object",
      "properties": {
        "failedTests": {
          "type": "array",
          "items": {"type": "string"}
        },
        "rootCause": {"type": "string"},
        "suggestedFix": {"type": "string"},
        "affectedFiles": {
          "type": "array",
          "items": {"type": "string"}
        }
      }
    }'     | jq '.structured_output')

  # Slackに通知（例）
  curl -s -X POST "$SLACK_WEBHOOK"     -H "Content-Type: application/json"     -d "{
      "text": "テスト失敗
原因: $(echo $REPORT | jq -r '.rootCause')
修正案: $(echo $REPORT | jq -r '.suggestedFix')"
    }"

  exit 1
fi

npm install @anthropic-ai/claude-agent-sdk