JSON Schema に合致した構造化出力を得たい

コマンド / 機能

--json-schema

JSON Schema バリデーション付き出力（print モードのみ）

概要

--json-schema フラグにスキーマを渡すと、エージェントのワークフロー完了後に指定スキーマに合致した JSON オブジェクトが出力されます。データパイプラインや自動化での安定した出力に便利です。

設定例

# JSON Schema を指定して構造化出力を得る
claude -p --json-schema '{
  "type": "object",
  "properties": {
    "summary": {"type": "string"},
    "issues": {"type": "array", "items": {"type": "string"}},
    "severity": {"type": "string", "enum": ["low", "medium", "high"]}
  },
  "required": ["summary", "issues", "severity"]
}' "このコードをレビューして"

# スキーマファイルを使う場合
claude -p --json-schema "$(cat schema.json)" "処理して"

公式ドキュメントを見る