Режим без интерфейса

​

Обзор

Режим без интерфейса позволяет запускать Claude Code программно из скриптов командной строки и инструментов автоматизации без какого-либо интерактивного пользовательского интерфейса.

​

Основное использование

Основным интерфейсом командной строки для Claude Code является команда claude. Используйте флаг --print (или -p) для запуска в неинтерактивном режиме и вывода окончательного результата:

claude -p "Stage my changes and write a set of commits for them" \
  --allowedTools "Bash,Read" \
  --permission-mode acceptEdits \
  --cwd /path/to/project

​

Параметры конфигурации

SDK использует все параметры CLI, доступные в Claude Code. Вот основные из них для использования SDK:

Для полного списка параметров CLI и функций смотрите документацию справочника CLI.

​

Многоходовые разговоры

Для многоходовых разговоров вы можете возобновлять разговоры или продолжать с самой последней сессии:

# Продолжить самый последний разговор
claude --continue "Now refactor this for better performance"

# Возобновить конкретный разговор по ID сессии
claude --resume 550e8400-e29b-41d4-a716-446655440000 "Update the tests"

# Возобновить в неинтерактивном режиме
claude --resume 550e8400-e29b-41d4-a716-446655440000 "Fix all linting issues" --no-interactive

​

Форматы вывода

​

Текстовый вывод (по умолчанию)

claude -p "Explain file src/components/Header.tsx"
# Вывод: This is a React component showing...

​

JSON вывод

Возвращает структурированные данные, включая метаданные:

claude -p "How does the data layer work?" --output-format json

Формат ответа:

{
  "type": "result",
  "subtype": "success",
  "total_cost_usd": 0.003,
  "is_error": false,
  "duration_ms": 1234,
  "duration_api_ms": 800,
  "num_turns": 6,
  "result": "The response text here...",
  "session_id": "abc123"
}

​

Потоковый JSON вывод

Передает каждое сообщение по мере его получения:

claude -p "Build an application" --output-format stream-json

Каждый разговор начинается с начального системного сообщения init, за которым следует список сообщений пользователя и ассистента, за которым следует финальное системное сообщение result со статистикой. Каждое сообщение выдается как отдельный JSON объект.

​

Форматы ввода

​

Текстовый ввод (по умолчанию)

# Прямой аргумент
claude -p "Explain this code"

# Из stdin
echo "Explain this code" | claude -p

​

Потоковый JSON ввод

Поток сообщений, предоставляемых через stdin, где каждое сообщение представляет ход пользователя. Это позволяет делать несколько ходов разговора без перезапуска бинарного файла claude и позволяет предоставлять руководство модели во время обработки запроса.

Каждое сообщение является JSON объектом ‘User message’, следующим тому же формату, что и схема выходного сообщения. Сообщения форматируются с использованием формата jsonl, где каждая строка ввода является полным JSON объектом. Потоковый JSON ввод требует -p и --output-format stream-json.

echo '{"type":"user","message":{"role":"user","content":[{"type":"text","text":"Explain this code"}]}}' | claude -p --output-format=stream-json --input-format=stream-json --verbose

​

Примеры интеграции агентов

​

SRE бот реагирования на инциденты

#!/bin/bash

# Автоматизированный агент реагирования на инциденты
investigate_incident() {
    local incident_description="$1"
    local severity="${2:-medium}"

    claude -p "Incident: $incident_description (Severity: $severity)" \
      --append-system-prompt "You are an SRE expert. Diagnose the issue, assess impact, and provide immediate action items." \
      --output-format json \
      --allowedTools "Bash,Read,WebSearch,mcp__datadog" \
      --mcp-config monitoring-tools.json
}

# Использование
investigate_incident "Payment API returning 500 errors" "high"

​

Автоматизированная проверка безопасности

# Агент аудита безопасности для pull request'ов
audit_pr() {
    local pr_number="$1"

    gh pr diff "$pr_number" | claude -p \
      --append-system-prompt "You are a security engineer. Review this PR for vulnerabilities, insecure patterns, and compliance issues." \
      --output-format json \
      --allowedTools "Read,Grep,WebSearch"
}

# Использование и сохранение в файл
audit_pr 123 > security-report.json

​

Многоходовой юридический помощник

# Проверка юридических документов с сохранением сессии
session_id=$(claude -p "Start legal review session" --output-format json | jq -r '.session_id')

# Проверка контракта в несколько этапов
claude -p --resume "$session_id" "Review contract.pdf for liability clauses"
claude -p --resume "$session_id" "Check compliance with GDPR requirements"
claude -p --resume "$session_id" "Generate executive summary of risks"

​

Лучшие практики

• Используйте JSON формат вывода для программного разбора ответов:

  # Разбор JSON ответа с помощью jq
  result=$(claude -p "Generate code" --output-format json)
  code=$(echo "$result" | jq -r '.result')
  cost=$(echo "$result" | jq -r '.cost_usd')
  

• Обрабатывайте ошибки корректно - проверяйте коды выхода и stderr:

  if ! claude -p "$prompt" 2>error.log; then
      echo "Error occurred:" >&2
      cat error.log >&2
      exit 1
  fi
  

• Используйте управление сессиями для поддержания контекста в многоходовых разговорах

• Учитывайте таймауты для долго выполняющихся операций:

  timeout 300 claude -p "$complex_prompt" || echo "Timed out after 5 minutes"
  

• Соблюдайте ограничения скорости при выполнении множественных запросов, добавляя задержки между вызовами

​

Связанные ресурсы

• Использование CLI и элементы управления - Полная документация CLI
• Общие рабочие процессы - Пошаговые руководства для общих случаев использования