claude-code-headless

# Claude Code Headless Mode Run Claude Code from scripts without interactive UI. ## Quick Start ```bash # Basic headless execution claude -p "Explain this code" --allowedTools "Read,Grep" # JSON output for parsing claude -p "List files" --output-format json # Continue conversation claude -p "Start analysis" --output-format json > result.json session=$(jq -r '.session_id' result.json) claude --resume "$session" "Now fix the issues" ``` ## Essential CLI Options | Flag | Description | |------|-------------| | `-p`, `--print` | Non-interactive (headless) mode | | `--output-format` | text, json, stream-json | | `-r`, `--resume` | Resume by session ID | | `-c`, `--continue` | Continue most recent session | | `--allowedTools` | Comma-separated allowed tools | | `--disallowedTools` | Comma-separated denied tools | | `--mcp-config` | Path to MCP server config JSON | | `--verbose` | Enable verbose logging | | `--append-system-prompt` | Add to system prompt | ## Permission Modes | Mode | Flag | Effect | |------|------|--------| | Default | (none) | Prompt for permissions | | Accept edits | `--permission-mode acceptEdits` | Auto-accept file changes | | Bypass | `--permission-mode bypassPermissions` | Skip all prompts | ## Output Formats ### Text (default) ```bash claude -p "Hello" # Outputs: Human-readable response ``` ### JSON ```bash claude -p "Hello" --output-format json ``` ```json { "type": "result", "subtype": "success", "result": "Hello! How can I help?", "sess...