{"id":"cli-reference","name":"cli-reference","summary":"Claude Code CLIコマンド、フラグ、ヘッドレスモード、オートメーションパターン","body":"# CLI Reference\n\nComplete reference for Claude Code command-line interface.\n\n## When to Use\n\n- \"What CLI flags are available?\"\n- \"How do I use headless mode?\"\n- \"Claude in automation/CI/CD\"\n- \"Output format options\"\n- \"System prompt via CLI\"\n- \"How do I spawn agents properly?\"\n\n## Core Commands\n\n| Command | Description | Example |\n|---------|-------------|---------|\n| `claude` | Start interactive REPL | `claude` |\n| `claude \"query\"` | REPL with initial prompt | `claude \"explain this project\"` |\n| `claude -p \"query\"` | Headless mode (SDK) | `claude -p \"explain function\"` |\n| `cat file \\| claude -p` | Process piped content | `cat logs.txt \\| claude -p \"explain\"` |\n| `claude -c` | Continue most recent | `claude -c` |\n| `claude -c -p \"query\"` | Continue via SDK | `claude -c -p \"check types\"` |\n| `claude -r \"id\" \"query\"` | Resume session | `claude -r \"auth\" \"finish PR\"` |\n| `claude update` | Update version | `claude update` |\n| `claude mcp` | Configure MCP servers | See MCP docs |\n\n## Session Control\n\n| Flag | Description | Example |\n|------|-------------|---------|\n| `--continue, -c` | Load most recent conversation | `claude --continue` |\n| `--resume, -r` | Resume session by ID/name | `claude --resume auth-refactor` |\n| `--session-id` | Use specific UUID | `claude --session-id \"550e8400-...\"` |\n| `--fork-session` | Create new session on resume | `claude --resume abc --fork-session` |\n\n## Headless Mode (Critical for Agents)\n\n| Flag | Description | Example |\n|------|-------------|---------|\n| `--print, -p` | Non-interactive, exit after | `claude -p \"query\"` |\n| `--output-format` | `text`, `json`, `stream-json` | `claude -p --output-format json` |\n| `--max-turns` | Limit agentic turns | `claude -p --max-turns 100 \"query\"` |\n| `--verbose` | Full turn-by-turn output | `claude --verbose` |\n| `--dangerously-skip-permissions` | Skip permission prompts | `claude -p --dangerously-skip-permissions` |\n| `--include-partial-messages` | Include streaming events | `claude -p --output-format stream-json --include-partial-messages` |\n| `--input-format` | Input format (text/stream-json) | `claude -p --input-format stream-json` |\n\n## Tool Control\n\n| Flag | Description | Example |\n|------|-------------|---------|\n| `--allowedTools` | Auto-approve these tools | `\"Bash(git log:*)\" \"Read\"` |\n| `--disallowedTools` | Block these tools | `\"Bash(rm:*)\" \"Edit\"` |\n| `--tools` | Only allow these tools | `--tools \"Bash,Edit,Read\"` |\n\n## Subagent Definition (--agents flag)\n\nDefine custom subagents inline via JSON:\n\n```bash\nclaude --agents '{\n  \"code-reviewer\": {\n    \"description\": \"Expert code reviewer. Use proactively after code changes.\",\n    \"prompt\": \"You are a senior code reviewer. Focus on code quality and security.\",\n    \"tools\": [\"Read\", \"Grep\", \"Glob\", \"Bash\"],\n    \"model\": \"sonnet\"\n  },\n  \"debugger\": {\n    \"description\": \"Debugging specialist for errors and test failures.\",\n    \"prompt\": \"You are an expert debugger. Analyze errors and provide fixes.\"\n  }\n}'\n```\n\n### Agent Fields\n\n| Field | Required | Description |\n|-------|----------|-------------|\n| `description` | Yes | When to invoke this agent |\n| `prompt` | Yes | System prompt for behavior |\n| `tools` | No | Allowed tools (inherits all if omitted) |\n| `model` | No | `sonnet`, `haiku`, or `claude-opus-4-5-20251101` |\n\n### Key Insight\nWhen Lead uses Task tool, it auto-spawns from these definitions. No manual spawn needed.\n\n## System Prompt Customization\n\n| Flag | Behavior | Modes |\n|------|----------|-------|\n| `--system-prompt` | **Replace** entire prompt | Interactive + Print |\n| `--system-prompt-file` | **Replace** from file | Print only |\n| `--append-system-prompt` | **Append** to default (recommended) | Interactive + Print |\n\n**Use `--append-system-prompt`** for most cases - preserves Claude Code capabilities.\n\n## Model Selection\n\n| Flag | Description | Example |\n|------|-------------|---------|\n| `--model` | Set model for session | `--model claude-sonnet-4-5` |\n| `--fallback-model` | Fallback if default overloaded | `--fallback-model sonnet` |\n\nAliases: `sonnet`, `opus`, `haiku`\n\n## MCP Configuration\n\n| Flag | Description | Example |\n|------|-------------|---------|\n| `--mcp-config` | Load MCP servers from JSON | `--mcp-config ./mcp.json` |\n| `--strict-mcp-config` | Only use these MCP servers | `--strict-mcp-config --mcp-config ./mcp.json` |\n\n## Advanced Flags\n\n| Flag | Description | Example |\n|------|-------------|---------|\n| `--add-dir` | Add working directories | `--add-dir ../apps ../lib` |\n| `--agent` | Specify agent for session | `--agent my-custom-agent` |\n| `--permission-mode` | Start in permission mode | `--permission-mode plan` |\n| `--permission-prompt-tool` | MCP tool for permissions | `--permission-prompt-tool mcp_auth` |\n| `--plugin-dir` | Load plugins from directory | `--plugin-dir ./my-plugins` |\n| `--settings` | Load settings from file/JSON | `--settings ./settings.json` |\n| `--setting-sources` | Which settings to load | `--setting-sources user,project` |\n| `--betas` | Beta API headers | `--betas interleaved-thinking` |\n| `--debug` | Enable debug mode | `--debug \"api,hooks\"` |\n| `--ide` | Auto-connect to IDE | `--ide` |\n| `--chrome` | Enable Chrome integration | `--chrome` |\n| `--no-chrome` | Disable Chrome for session | `--no-chrome` |\n| `--enable-lsp-logging` | Verbose LSP debugging | `--enable-lsp-logging` |\n| `--version, -v` | Output version | `claude -v` |\n\n## Output Formats\n\n### JSON (for parsing)\n```bash\nclaude -p \"query\" --output-format json\n# {\"result\": \"...\", \"session_id\": \"...\", \"usage\": {...}}\n```\n\n### Streaming (for real-time monitoring)\n```bash\nclaude -p \"query\" --output-format stream-json\n# Newline-delimited JSON events\n```\n\n### Structured Output (schema validation)\n```bash\nclaude -p \"Extract data\" \\\n  --output-format json \\\n  --json-schema '{\"type\":\"object\",\"properties\":{...}}'\n```\n\n## Headless Agent Pattern (CRITICAL)\n\nProper headless agent spawn:\n\n```bash\nclaude -p \"$TASK_PROMPT\" \\\n  --session-id \"$UUID\" \\\n  --dangerously-skip-permissions \\\n  --max-turns 100 \\\n  --output-format stream-json \\\n  --agents '{...}' \\\n  --append-system-prompt \"Context: ...\"\n```\n\n**Missing any of these causes hangs:**\n- `--session-id` - Track the session\n- `--dangerously-skip-permissions` - Headless requires this\n- `--max-turns` - Prevents infinite loops\n\n## Common Patterns\n\n### CI/CD Automation\n```bash\nclaude -p \"Run tests and fix failures\" \\\n  --dangerously-skip-permissions \\\n  --max-turns 50 \\\n  --output-format json | jq '.result'\n```\n\n### Piped Input\n```bash\ncat error.log | claude -p \"Find root cause\"\ngh pr diff | claude -p \"Review for security\"\n```\n\n### Multi-turn Session\n```bash\nid=$(claude -p \"Start task\" --output-format json | jq -r '.session_id')\nclaude -p \"Continue\" --resume \"$id\"\n```\n\n### Stream Monitoring\n```bash\nclaude -p \"Long task\" \\\n  --output-format stream-json \\\n  --include-partial-messages | while read -r line; do\n    echo \"$line\" | jq '.type'\ndone\n```\n\n## Keyboard Shortcuts (Interactive)\n\n| Shortcut | Action |\n|----------|--------|\n| `Ctrl+C` | Cancel current |\n| `Ctrl+D` | Exit |\n| `Ctrl+R` | Reverse search history |\n| `Esc Esc` | Rewind changes |\n| `Shift+Tab` | Toggle permission mode |\n\n## Quick Commands\n\n| Prefix | Action |\n|--------|--------|\n| `/` | Slash command |\n| `!` | Bash mode |\n| `#` | Add to memory |\n| `@` | File mention |","author":"@parcadei","ownerProfile":null,"authorContacts":null,"sourceUrl":"https://github.com/parcadei/Continuous-Claude-v3/tree/main/.claude/skills/cli-reference","license":"MIT","category":"document","lang":"en","tokens":2054,"stars":0,"calls30d":1,"claimed":false,"visibility":"public","origin":"crawler","version":"0.1.0","createdAt":"2026-08-22","updatedAt":"2026-08-22","files":[],"requires":{"mcp":[],"tools":["Read"]},"safety":{"flags":[{"code":"injection.disable-permissions","kind":"injection","where":"SKILL.md:45","excerpt":"--dangerously-skip-permissions","message":"instructs the agent to disable permission checks","severity":"warn"}],"scannedAt":"2026-08-22","hasScripts":false,"networkEndpoints":[]}}