Перейти к основному содержанию

​
Обзор

Режим без интерфейса позволяет запускать 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

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

Режим без интерфейса использует все параметры CLI, доступные в Claude Code. Вот ключевые из них для автоматизации и создания скриптов:
ФлагОписаниеПример
--print, -pЗапуск в неинтерактивном режимеclaude -p "query"
--output-formatУкажите формат вывода (text, json, stream-json)claude -p --output-format json
--resume, -rВозобновить беседу по ID сеансаclaude --resume abc123
--continue, -cПродолжить самую последнюю беседуclaude --continue
--verboseВключить подробное логированиеclaude --verbose
--append-system-promptДобавить к системной подсказке (только с --print)claude --append-system-prompt "Custom instruction"
--allowedToolsРазделённый пробелами список разрешённых инструментов, или

строка со списком разрешённых инструментов, разделённых запятыми		claude --allowedTools mcp__slack mcp__filesystem

claude --allowedTools "Bash(npm install),mcp__filesystem"
--disallowedToolsРазделённый пробелами список запрещённых инструментов, или

строка со списком запрещённых инструментов, разделённых запятыми		claude --disallowedTools mcp__splunk mcp__github

claude --disallowedTools "Bash(git commit),mcp__github"
--mcp-configЗагрузить MCP серверы из JSON файлаclaude --mcp-config servers.json
--permission-prompt-toolMCP инструмент для обработки запросов разрешений (только с --print)claude --permission-prompt-tool mcp__auth__prompt
Полный список параметров 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"
# Output: 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 requests
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"
  • Соблюдайте ограничения скорости при выполнении нескольких запросов, добавляя задержки между вызовами

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