CC逆引きリファレンス

JSON 出力したい

11. CI/CD・自動化

コマンド / 機能

claude -p --output-format json "query"

概要

JSON 形式で出力することで、結果を他のツールでパースしやすくなります。メタデータ(トークン使用量、コストなど)も含まれます。

設定例

# JSON 形式で出力
claude -p --output-format json "package.json の依存関係を一覧化して"

# jq で結果を抽出
claude -p --output-format json "エラーを修正して" | jq -r '.result'

# JSON 出力の構造
# {
#   "type": "result",
#   "subtype": "success",
#   "result": "応答テキスト",
#   "session_id": "...",
#   "cost_usd": 0.01,
#   "input_tokens": 100,
#   "output_tokens": 200
# }

# トークン使用量を取得
claude -p --output-format json "hello" | jq '.input_tokens, .output_tokens'

こんな時に使う

  • 出力を他のツールでパースしたい時
  • 構造化データとして結果を取得したい時

使い方

  1. 1--output-format json を追加
  2. 2jq コマンドで必要なフィールドを抽出
  3. 3.result フィールドに応答本文が入る
  4. 4.cost_usd でコストを確認可能

Tips

  • CI でコストをログに残す場合に便利
  • エラー時は subtype が error になる
  • stream-json と違い、完了後に一括で出力される