💻 Claude Code入門 📖 約15分で読めます

Claude Codeの出力フォーマットとパイプ活用術

--printモードとパイプを使った自動化・スクリプト連携の実践テクニック

クロガイド｜Claude＆Claude Codeを無料で学ぼう

AI基礎からプロンプト術、Claude Codeの使い方まで。知識レッスンとクイズ式トレーニングで、AIスキルを段階的にアップ。ユーザー登録不要、すべて無料で今すぐ始められます。

無料で学習を始めるクロガイドとは？

なぜ出力フォーマットが重要なのか

Claude Codeは対話的に使うだけでなく、シェルスクリプトやCI/CDパイプラインに組み込んで自動化ツールとしても活用できます。その際に鍵となるのが、出力フォーマットの制御とパイプ（|）の活用です。

本記事では、--printモードの基本から各出力フォーマットの使い分け、実践的なシェルスクリプトの例まで、自動化に必要な知識を網羅的に解説します。

--printモードの基本

--print（短縮: -p）は、Claude Codeを非インタラクティブ（対話なし）モードで実行するオプションです。

--printモードの特徴

プロンプトを受け取り、回答を出力して終了する（対話なし）
標準入力（stdin）からの入力を受け付ける
標準出力（stdout）に結果を出力する
パイプやリダイレクトと組み合わせ可能
スクリプトやCI/CDパイプラインに最適

基本的な使い方

# 直接プロンプトを指定
claude -p "Pythonでフィボナッチ数列を計算する関数を書いて"

# 標準入力からプロンプトを渡す
echo "Hello Worldプログラムを書いて" | claude -p

# ファイルの内容をプロンプトとして渡す
claude -p "このコードをレビューして" < src/app.py

# 結果をファイルに保存
claude -p "READMEのテンプレートを生成して" > README.md

3つの出力フォーマット

1. text形式（デフォルト）

人間が読みやすいプレーンテキスト形式です。そのまま端末に表示したり、ファイルに保存するのに適しています。

使用例

claude -p --output-format text "現在のディレクトリ構造を説明して"

出力例:

このプロジェクトは以下のような構造になっています：
- src/ : ソースコードディレクトリ
- tests/ : テストファイル
- package.json : npm設定ファイル
...

2. json形式

構造化されたJSON形式で出力します。プログラムから結果をパースして利用するのに最適です。

使用例

claude -p --output-format json "このプロジェクトの依存関係を分析して"

出力は完了後に一括でJSON形式で返されます。jqコマンドと組み合わせることで、特定のフィールドだけを抽出できます。

# jqで結果を抽出
claude -p --output-format json "分析して" | jq '.result'

3. stream-json形式

処理の進行に合わせてイベントごとにJSONを逐次出力します。リアルタイムに処理結果を監視したり、長時間実行の進捗を表示するのに適しています。

使用例

claude -p --output-format stream-json "大規模なリファクタリング計画を作成して"

各イベント（テキスト生成、ツール使用、結果など）が独立したJSONオブジェクトとして逐次出力されます。

フォーマット選択の指針

用途	推奨フォーマット	理由
端末で結果を確認	text	人間が読みやすい
ファイルに結果を保存	text	そのまま使える
別のプログラムで処理	json	パースが容易
リアルタイム監視	stream-json	逐次処理が可能
CI/CDのレポート生成	json	構造化された結果
ログ記録	json	後から検索・分析しやすい

パイプ活用の実践テクニック

テクニック1: ファイル内容の分析

# エラーログの分析
cat /var/log/app/error.log | claude -p "このエラーログから重要な問題を3つ特定して"

# Git diffのレビュー
git diff | claude -p "この変更内容をレビューして問題点を指摘して"

# 設定ファイルの検証
cat config.yaml | claude -p "この設定に問題やセキュリティリスクがないか確認して"

テクニック2: 結果のチェーン処理

# コード生成 → ファイルに保存
claude -p "Express.jsのCRUD APIを生成して" > src/api.js

# 分析結果をさらに加工
claude -p --output-format json "依存関係を分析して" | jq '.vulnerabilities'

# 複数ステップの処理
git log --oneline -20 | claude -p "このコミット履歴を要約して"

シェルスクリプトでの自動化例

例1: 自動コードレビュースクリプト

#!/bin/bash
# review.sh - 変更ファイルを自動レビュー

echo "=== 自動コードレビュー ==="
CHANGED_FILES=$(git diff --name-only HEAD~1)

for file in $CHANGED_FILES; do
    echo "--- レビュー中: $file ---"
    claude -p --max-turns 1 \
        "以下のファイルの変更をレビューして、
         問題点があれば指摘してください: $(git diff HEAD~1 -- $file)"
    echo ""
done

echo "=== レビュー完了 ==="

例2: ドキュメント自動生成

#!/bin/bash
# generate-docs.sh - 関数のドキュメントを自動生成

for file in src/lib/*.ts; do
    echo "ドキュメント生成: $file"
    DOC=$(claude -p --max-turns 1 \
        "このTypeScriptファイルのJSDocコメントを生成して。
         既存のコメントは維持して: $(cat $file)")
    echo "$DOC" > "${file%.ts}.doc.md"
done

例3: CI/CDパイプラインでの品質チェック

#!/bin/bash
# quality-check.sh - CI/CDで使用する品質チェック

RESULT=$(claude -p --output-format json --max-turns 3 \
    --append-system-prompt "JSON形式で回答してください。
    フィールド: passed (boolean), issues (array of strings)" \
    "以下のコードにセキュリティ上の問題がないかチェック: $(git diff origin/main)")

PASSED=$(echo $RESULT | jq -r '.passed')
if [ "$PASSED" = "false" ]; then
    echo "品質チェック失敗"
    echo $RESULT | jq '.issues[]'
    exit 1
fi
echo "品質チェック通過"