메뉴
Programmatic/headless Claude Code usage — CLI flags, stream-json protocol, Agent SDKs, session management. Use before spawning Claude as a subprocess, testing skill or agent behavior, running "claude -p", or building with the Agent SDK.
기본적으로 소스를 먼저 확인하는 Prompt가 선택됩니다. 직접 명령으로 전환하거나 로컬 사본을 다운로드할 수도 있습니다.
설치 여부를 결정하기 전에 SKILL.md와 SkillsMP에 표시된 보조 파일을 읽어 보세요.
SOC 직업 분류 기준
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
직접 명령은 검토 Prompt를 거치지 않습니다. 실행하기 전에 소스를 확인하세요.
npx skills add https://github.com/archibate/dotfiles-codex --skill claude-headless명령은 한 줄로 유지됩니다. 복사하기 전에 가로로 스크롤해 전체 내용을 확인하세요.
로컬 사본을 원하시나요? SkillsMP에서 현재 제공할 수 있는 파일을 다운로드하세요.
Inspect or debug web pages in a headless browser — fill forms, click buttons, take screenshots, test web apps, review frontend UI/UX aesthetics. Use for headless browser automation. This skill should be used when user says "test web app interactively", "use a headless browser", "browser automation", "headless web test", "review frontend layout", "screenshot of this page", "frontend UI polish".
Guide for writing ast-grep rules to perform structural code search and analysis. TRIGGER when a text-only grep would need 2+ alternations, regex capture groups, multi-line patterns, or filtering by syntactic role (call vs. import vs. definition). Also TRIGGER when renaming a symbol across call sites + definitions, finding all callers of a method on a specific type, matching code shapes, or writing codemods.
Peer-to-peer messaging between Claude Code sessions sharing a tmux server. Use when coordinating multiple simultaneous Claude sessions — e.g. "dm another claude", "list claude sessions", "peek peer claude", "spawn claude in tmux", "monitor remote claude", "orchestrate claude sessions".
SKILL.md 표시 중
| name | claude-headless |
| description | Programmatic/headless Claude Code usage — CLI flags, stream-json protocol, Agent SDKs, session management. Use before spawning Claude as a subprocess, testing skill or agent behavior, running "claude -p", or building with the Agent SDK. |
Programmatic usage of Claude Code CLI. Three modes available:
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",...}
Resume — continue a previous session:
claude -p "continue the review" --resume <session-id> --output-format json
| Flag | Purpose |
|---|---|
-p / --print | Non-interactive mode |
--output-format stream-json | NDJSON event stream on stdout |
--input-format stream-json | NDJSON messages on stdin (multi-turn) |
--bare | Skip CLAUDE.md, hooks, skills, plugins, MCP, auto-memory, OAuth/keychain (fast CI; see auth.md) |
--allowedTools "Bash,Read" | Pre-approve specific tools |
--max-budget-usd N | Cost cap |
--json-schema '{...}' | Structured output extraction |
For complete flag reference, read references/cli-flags.md.
Load these on demand based on what the user needs:
references/cli-flags.md — Complete CLI flags: headless, permissions, budget, session, system prompt, subcommandsreferences/auth.md — Authentication: subscription OAuth, API key, apiKeyHelper, --bare caveat, token storagereferences/env-vars.md — Complete environment variables: auth, models, thinking, bash/network timeouts, telemetry, TLS, session, plugins, MCP, detectionreferences/stream-json.md — Stream JSON protocol: stdout events, stdin messages, pipe-chainingreferences/permissions.md — Headless permission modes, --allowedTools, --permission-prompt-tool MCPreferences/sdks.md — TypeScript and Python Agent SDKs: API, options, streaming, multi-turnreferences/patterns.md — Real-world patterns: CI/CD, bot bridges, structured extraction, Agent Teams headless