Non-interactive Mode

Use non-interactive mode when you want Claude Code to run from a shell command instead of an interactive session.

One-off prompt

claude -p "Explain what this project does"

JSON output

claude -p "List all API endpoints" --output-format json

Streaming JSON

claude -p "Analyze this log file" --output-format stream-json --verbose

Good use cases

• CI checks.
• Pre-commit hooks.
• Repo analysis scripts.
• Batch summarization.
• Structured extraction into another command.

Production guidance

Use --verbose while developing the automation. Turn it off once the workflow is stable unless you need detailed logs.