stream-json 出力に部分メッセージやフックイベントを含めたい

コマンド / 機能

--include-partial-messages / --include-hook-events

stream-json の詳細度を上げる

概要

--include-partial-messages は生成中のテキストデルタを stream-json 出力に含め、--include-hook-events はフックのライフサイクルイベントを含めます。--replay-user-messages はラッパーUIが自分の入力を確認できるように stdin のユーザーメッセージを stdout に再送し、--prompt-suggestions はフォローアップのプロンプト候補を出力します。

設定例

# ストリーミングトークンをリアルタイムに受け取る
claude -p --output-format stream-json --include-partial-messages "長いレポートを生成して"

# フックの実行状況もイベントとして受け取る
claude -p --output-format stream-json --include-hook-events "デプロイして"

# ラッパーUIでユーザー入力をエコーバックさせる
claude -p --output-format stream-json --replay-user-messages < input.jsonl

# フォローアップの提案プロンプトを取得
claude -p --output-format stream-json --prompt-suggestions "このバグを直して"

公式ドキュメントを見る