# Portability: UNIVERSAL
# Last validated: 2026-05-17
# Next review: 2027-05-17

АВТОМАТИЗАЦИЯ CLAUDE CODE
============================

Инструкции по автоматизации Claude Code через командную строку (CLI).


ОБЗОР
---------
Claude Code может работать в неинтерактивном режиме, что означает, что
Интеграция со сценариями, конвейерами CI/CD и автоматизированными рабочими процессами включена.


1. НЕИНТЕРАКТИВНЫЙ РЕЖИМ (-p / --print)
----------------------------------------
Самый важный параметр для автоматизации. Клод дает ответ
и заканчивается.

    # Простой запрос
    claude -p "Объясните мне, что делает эта функция"

    # При вводе файла через канал
    кот mycode.py | claude -p "Проанализировать этот код"

    # О стандартном вводе
    echo "Сколько будет 2+2?" | клод -p


2. ВЫХОДНЫЕ ФОРМАТЫ ДЛЯ СЦЕНАРИЙ
-------------------------------
Текст (по умолчанию):
    claude -p "Ваш запрос"

JSON (единственный результат):
    claude -p "Список 5 языков программирования" --output-format json

Поток JSON (потоковая передача в реальном времени):
    claude -p «Написать тест» --output-formatstream-json


3. РАЗРЕШЕНИЯ И БЕЗОПАСНОСТЬ
--------------------------------
Полностью автоматически, без подтверждений:
    # ВНИМАНИЕ: Используйте только в безопасных/изолированных средах!
    claude -p "Создать index.html" --dangerously-skip-permissions

Выберите режим разрешений:
    # Режим планирования: Клод планирует изменения перед выполнением
    claude -p "Код рефакторинга" --permission-mode plan

    # Режим DontAsk: никаких запросов во время выполнения.
    claude -p "Обновить зависимости" --permission-mode dontAsk

С ограниченными инструментами:
    # Разрешить только определенные инструменты
    claude -p "Показать статус git" --allowedTools "Bash(git:*)"

    # Запретить определенные инструменты
    claude -p "Анализ кода" --disallowedTools "Редактировать запись"

    # Отключить все инструменты, кроме определенных
    claude -p «Только чтение» --tools «Чтение»


4. УПРАВЛЕНИЕ СЕССИЯМИ
---------------------
Продолжить последний сеанс:
    claude --continue

Продолжить конкретный сеанс по идентификатору:
    claude --resume SESSION_ID

Создать новый идентификатор сеанса в резюме:
    Клод --продолжить --fork-session


5. БЮДЖЕТНЫЙ И МОДЕЛЬНЫЙ КОНТРОЛЬ
------------------------------
    # Установить лимит бюджета (в долларах США)
    Клод -p «Комплексный анализ» --max-budget-usd 1.00

    # Выберите модель
    claude -p "Быстрый вопрос" --модельный сонет
    claude -p "Сложная задача" --model opus

    # Резервная модель на случай перегрузки
    клод -p "запрос" --сонет резервной модели


6. ПОДСКАЗКА НАСТРОЙКИ СИСТЕМЫ
-------------------------
    # Установите свою собственную системную подсказку
    claude -p "request" --system-prompt "Вы эксперт по Python"

    # Развернуть системную подсказку
    claude -p "Запрос" --append-system-prompt "Всегда отвечать на немецком языке"


7. ИНТЕГРАЦИЯ CI/CD
--------------------
Пример: проверка кода в конвейере

    #!/бин/баш
    # code_review.sh
    claude -p "Проверьте этот код на предмет проблем безопасности и рекомендаций" \
      --выходной формат json\
      --dangerously-skip-permissions \
      --max-budget-usd 1.00\
      --model sonnet

Пример: Автоматическое документирование

    #!/бин/баш
    #generate_docs.sh
    кот src/main.py | claude -p "Создать документацию API в формате Markdown" \
      --выходной формат текста \
      --dangerously-skip-permissions > docs/API.md

Пример: генерация теста

    #!/бин/баш
    #generate_tests.sh
    claude -p "Сгенерировать модульные тесты для функции в src/utils.py" \
      --dangerously-skip-permissions \
      --allowedTools «Чтение и запись» \
      --max-budget-usd 0,50


8. ДВУСТОРОННЯЯ ПОТОКОВАЯ ПЕРЕДАЧА
----------------------------
Для комплексной интеграции с общением в реальном времени:

    Клод -p "..." \
      --input-format поток-json\
      --output-format поток-json\
      --include-partial-messages


9. ИНТЕГРАЦИЯ С СЕРВЕРОМ MCP
-------------------------
    # Загрузите конфигурацию MCP (файл или строку JSON)
    Клод -p "запрос" --mcp-config ./mcp-config.json

    # Загрузить несколько конфигов
    Клод -p "запрос" --mcp-config ./config1.json ./config2.json

    # Используйте только серверы MCP из Config
    клод -p "запрос" --mcp-config ./mcp-config.json --strict-mcp-config

    # Управление серверами MCP
    Клод mcp # Интерактивное управление
    claude mcp --help # Показать команды MCP


10. РАСШИРЕННЫЕ ФУНКЦИИ
-----------------------
Структурированный вывод JSON:
    # Проверка схемы JSON
    claude -p "Дайте мне данные пользователя" --json-schema '{"type":"object","properties":{"name":{"type":"string"}},"required":["name"]}'

Использовать агенты:
    # Предварительно настроенные агенты
    claude -p "Код проверки" --агент рецензент

    # Определите своих собственных агентов
    claude -p "Request" --agents '{"tester": {"description": "Тестирование кода", "prompt": "Вы эксперт по контролю качества"}}'

Интеграция плагинов:
    # Загрузить плагины из каталога
    claude -p "request" --plugin-dir ./my-plugins

Разрешить дополнительные каталоги:
    # Расширяет доступ к инструментам
    claude -p "Анализ нескольких проектов" --add-dir /path/to/project1 /path/to/project2

Режим отладки:
    # С фильтром
    Клод -p "запрос" --debug "api,hooks"

    # Без определенных категорий
    Клод -p "запрос" --debug "!1p,!file"

    # Записать журнал отладки в файл
    claude -p "request" --debug-file ./debug.log


ВАЖНАЯ ССЫЛКА НА ПАРАМЕТРЫ
---------------------------
Описание параметра
--------- ------------
-p, --print Неинтерактивный режим (требуется для автоматизации)
--выходной формат текста, json, поток json
--текст в формате ввода, поток-json
--dangerously-skip-permissions Нет диалоговых окон подтверждения
--permission-mode AcceptEdits, bypassPermissions, default, делегат, dontAsk, план
--allowedTools Разрешенные инструменты (например, «Bash(git:*) Read»)
--disallowedTools Запрещенные инструменты
--tools список инструментов или «» — нет, «по умолчанию» — для всех
--max-budget-usd Ограничение бюджета в долларах США
--model модель (сонет, опус или полное имя)
--fallback-model Резервное копирование при перегрузке
--system-prompt Собственная системная подсказка
--append-system-prompt Развернуть системное приглашение
--continue Продолжить последний сеанс
--resume Возобновить сеанс по идентификатору
--fork-session Новый идентификатор сеанса при продолжении
--session-id Установить конкретный идентификатор сеанса (UUID)
--mcp-config Конфигурации сервера MCP
--strict-mcp-config Использовать только MCP из конфигурации
--json-schema Схема JSON для проверенного вывода
--agent Предварительно настроенный агент
--agents Собственные агенты в формате JSON
--plugin-dir Каталоги плагинов
--add-dir Разрешить дополнительные каталоги
--debug Режим отладки с дополнительным фильтром
--debug-file Записывать журналы отладки в файл
--no-session-persistence Не сохранять сеанс (только с --print)


11. ДИСТАНЦИОННОЕ УПРАВЛЕНИЕ (МОБИЛЬНОЕ ПРИЛОЖЕНИЕ)
-------------------------------
Claude Code можно управлять удаленно через мобильное приложение Claude.
Известная ошибка: --dangerously-skip-permissions не работает с удаленным управлением.

Решение: Используйте профили разрешений BACH:

    # Автоматически (рекомендуется):
    # Рабочий стол: Claude_RemoteControl.bat
    # Меню BACH: клавиша [P]

    # Руководство:
    bach permissions activate remote_control
    Клод --dangerously-skip-permissions
    # -> введите /rc, отсканируйте QR-код
    # После завершения:
    bach permissions deactivate

    # Настройте профили:
    bach permissions set remote_control allow=mcp__neuer_server__*
    bach permissions show remote_control
    bach permissions status

Полную документацию см. в файле Permissions.txt.


ИНСТРУКЦИИ ПО БЕЗОПАСНОСТИ
-------------------
1. --dangerous-skip-permissions только в изолированных средах
   (песочницы, контейнеры).
2. Установите ограничения бюджета, чтобы избежать непредвиденных расходов.
3. Ограничьте инструменты с помощью --allowedTools, если это возможно.
4. Не отправляйте Клоду конфиденциальные данные по каналам


СМОТРИ ТАКЖЕ
----------
- claude --help Полная справка
- проверка установки Клода Доктора
- Клод mcp управляет сервером MCP
- Управление плагинами плагинов Claude
- claude setup-token Установить долговременный токен аутентификации
- claude install [target] Установить собственную сборку (стабильную/последнюю/версию)
- обновление Клауда Проверить наличие обновлений
- claude-code.txt Общая информация о коде Клода
- Permissions.txt Профиль разрешений BACH (дистанционное управление)
