Headless-режим claude -p выполняет один неинтерактивный прогон и завершает процесс - это основа скриптов и автоматизации. Успех возвращает код выхода 0, неудача - ненулевой. Тонкость, которую надо знать: ошибки стартовых флагов идут в stderr, а неудача внутри прогона может быть представлена результатом в stdout. Поэтому автоматизация проверяет и код возврата, и структурированный payload - полагаться на что-то одно значит однажды принять сбой за успех.

Ключевой режим для скриптов - bare. Флаг --bare пропускает автоподхват hooks, skills, plugins, MCP, auto memory и CLAUDE.md; это рекомендуемый сейчас режим для скриптов и вызовов SDK и будущий default для -p. Он не читает subscription-OAuth и keychain: для Anthropic API нужен ANTHROPIC_API_KEY или apiKeyHelper в явном --settings, а облачные провайдеры используют свои credentials. Контекст в bare добавляется только явно - через --append-system-prompt, --settings, --mcp-config, --agents, --plugin-dir.

Рядом стоит диагностический --safe-mode. Он сохраняет аутентификацию, модель, встроенные инструменты и permissions, но отключает кастомизации. Это средняя точка для диагностики: если safe-прогон работает, проблему ищут в hook, plugin, MCP, skill, памяти или config-кастомизации. Различие с bare важно: bare - для чистого воспроизводимого прогона в автоматизации, safe-mode - для того, чтобы понять, ломает ли работу именно кастомизация, не теряя при этом аутентификацию и инструменты.

У ввода есть лимиты, которые надо учитывать. Prompt передают аргументом или через stdin, но piped-stdin ограничен 10 МБ; большой лог не встраивают напрямую, а сохраняют в файл и дают путь. Это то же правило узкого контекста: не вставлять безграничный CI-лог в prompt, а сначала отфильтровать или взять хвост, а полный артефакт хранить отдельно. Иначе прогон и дороже, и медленнее, и рискует упереться в лимит на пустом месте.

Форматы вывода определяют, как автоматизация читает результат. text - дефолт; json - один структурированный конверт с result, session_id и метаданными usage и cost; stream-json - события, разделённые переводом строки. Полезно один раз увидеть эти формы рядом. При --json-schema бизнес-результат лежит в structured_output, и required с additionalProperties валидируют на стороне caller: поле format в схеме - аннотация, а не enforcement, поэтому проверку делают сами.