Claude Headless

Programmatic usage of Claude Code CLI. Three modes available:

Quick Start

One-shot — single prompt, get result, exit:

claude -p "Explain this error" --output-format json

Stream JSON — bidirectional real-time NDJSON over stdin/stdout:

claude -p --output-format stream-json --input-format stream-json --verbose
# Send: {"type":"user","message":{"role":"user","content":"hello"}}
# Recv: {"type":"assistant","message":{...}}
# Recv: {"type":"result","subtype":"success",...}