Использование и управление CLI

Начало работы

Claude Code предоставляет два основных способа взаимодействия:

Интерактивный режим: Запустите claude для начала сессии REPL
Одиночный режим: Используйте claude -p "запрос" для быстрых команд

# Запуск интерактивного режима
claude

# Запуск с начальным запросом
claude "объясни этот проект"

# Выполнить одну команду и выйти
claude -p "что делает эта функция?"

# Обработка переданного содержимого
cat logs.txt | claude -p "проанализируй эти ошибки"

Команды CLI

Команда	Описание	Пример
`claude`	Запуск интерактивного REPL	`claude`
`claude "запрос"`	Запуск REPL с начальным запросом	`claude "объясни этот проект"`
`claude -p "запрос"`	Выполнить одиночный запрос и выйти	`claude -p "объясни эту функцию"`
`cat file \| claude -p "запрос"`	Обработка переданного содержимого	`cat logs.txt \| claude -p "объясни"`
`claude -c`	Продолжить последний разговор	`claude -c`
`claude -c -p "запрос"`	Продолжить в режиме печати	`claude -c -p "Проверить ошибки типов"`
`claude -r "<session-id>" "запрос"`	Возобновить сессию по ID	`claude -r "abc123" "Закончить этот PR"`
`claude config`	Настроить параметры	`claude config set --global theme dark`
`claude update`	Обновить до последней версии	`claude update`
`claude mcp`	Настроить серверы Model Context Protocol	См. раздел MCP в руководствах

Флаги CLI

Настройте поведение Claude Code с помощью этих флагов командной строки:

Флаг	Описание	Пример
`--print`, `-p`	Печать ответа без интерактивного режима (см. подробную документацию по режиму печати ниже)	`claude -p "запрос"`
`--output-format`	Указать формат вывода для режима печати (варианты: `text`, `json`, `stream-json`)	`claude -p "запрос" --output-format json`
`--verbose`	Включить подробное логирование, показывает полный вывод по очереди (полезно для отладки в режиме печати и интерактивном режиме)	`claude --verbose`
`--max-turns`	Ограничить количество агентных ходов в неинтерактивном режиме	`claude -p --max-turns 3 "запрос"`
`--permission-prompt-tool`	Указать инструмент MCP для обработки запросов разрешений в неинтерактивном режиме	`claude -p --permission-prompt-tool mcp_auth_tool "запрос"`
`--resume`	Возобновить определенную сессию по ID или выбрать в интерактивном режиме	`claude --resume abc123 "запрос"`
`--continue`	Загрузить последний разговор в текущей директории	`claude --continue`
`--dangerously-skip-permissions`	Пропустить запросы разрешений (использовать с осторожностью)	`claude --dangerously-skip-permissions`

Флаг --output-format json особенно полезен для скриптов и автоматизации, позволяя программно анализировать ответы Claude.

Подробности режима печати

Флаг -p (или --print) включает неинтерактивный режим в Claude Code, позволяя передавать ввод и вывод для программного использования. Этот флаг поддерживает различные форматы вывода для разных случаев использования.

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

# Базовый режим печати - выводит только финальный текст ответа
claude -p "Объясни, как использовать флаг печати"

# С вводом через stdin
echo "Сколько будет 2+2?" | claude -p

# Возобновить сессию в режиме печати с запросом
claude -p --resume <session-id> "Возобновить сессию с этим запросом"

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

Опция --output-format (используется с -p) поддерживает три формата:

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

claude -p "Объясни форматы вывода"
# Выводит только текст ответа

2. JSON вывод

claude -p --output-format json "Объясни, как использовать JSON вывод"

Выводит структурированный JSON объект:

{
  "cost_usd": 0.003,
  "duration_ms": 1234,
  "duration_api_ms": 800,
  "result": "Текст ответа здесь...",
  "session_id": "abc123"
}

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

claude -p --output-format stream-json "Создай Python скрипт"

В потоковом режиме каждое сообщение выводится как отдельный JSON объект по мере получения:

Сообщения использования инструментов
Текстовые сообщения ассистента
Сообщения результатов инструментов
Финальное системное сообщение со статистикой

Подробный вывод в режиме печати

При использовании --verbose с -p, он должен быть в паре с --output-format json или --output-format stream-json:

claude -p --verbose --output-format json "Отладь этот код"

В подробном JSON режиме вывод включает полную стенограмму разговора:

[
  {
    "role": "user",
    "content": "Отладь этот код"
  },
  {
    "role": "assistant",
    "content": "Я помогу вам отладить этот код..."
  },
  {
    "role": "system",
    "cost_usd": 0.003,
    "duration_ms": 1234,
    "duration_api_ms": 800,
    "result": "Текст ответа здесь...",
    "session_id": "abc123"
  }
]

Дополнительные опции для режима печати

Максимальное количество ходов

claude -p --max-turns 3 "Исправь этот код" < file.py

Ограничивает количество агентных ходов в неинтерактивном режиме.

Инструмент запроса разрешений

claude -p --permission-prompt-tool mcp_auth_tool "Создать файл"

Указывает инструмент MCP для обработки запросов разрешений в неинтерактивном режиме.

Возобновление сессии

claude -p --resume abc123 "Возобновить сессию с этим запросом"

Возобновить определенную сессию по ID в режиме печати с новым запросом.

Продолжение сессии

claude -c -p "Продолжить со следующей задачей"

Продолжить последний разговор в этом проекте.

Слэш-команды

Управляйте поведением Claude во время интерактивной сессии:

Команда	Назначение
`/bug`	Сообщить об ошибках (отправляет разговор в Anthropic)
`/clear`	Очистить историю разговора
`/compact [instructions]`	Сжать разговор с опциональными инструкциями фокусировки
`/config`	Просмотр/изменение конфигурации
`/cost`	Показать статистику использования токенов
`/doctor`	Проверяет состояние вашей установки Claude Code
`/help`	Получить справку по использованию
`/init`	Инициализировать проект с руководством CLAUDE.md
`/login`	Переключить аккаунты Anthropic
`/logout`	Выйти из вашего аккаунта Anthropic
`/memory`	Редактировать файлы памяти CLAUDE.md
`/pr_comments`	Просмотреть комментарии к pull request
`/review`	Запросить проверку кода
`/status`	Просмотреть статусы аккаунта и системы
`/terminal-setup`	Установить привязку клавиш Shift+Enter для новых строк (только для iTerm2 и VSCode)
`/vim`	Войти в режим vim для чередования режимов вставки и команд

Специальные сочетания клавиш

Быстрая память с `#`

Добавляйте воспоминания мгновенно, начиная ввод с #:

# Всегда использовать описательные имена переменных

Вам будет предложено выбрать, в какой файл памяти это сохранить.

Разрывы строк в терминале

Вводите многострочные команды используя:

Быстрый выход: Введите \ и затем Enter
Сочетание клавиш: Option+Enter (или Shift+Enter если настроено)

Чтобы настроить Option+Enter в вашем терминале:

Для Mac Terminal.app:

Откройте Настройки → Профили → Клавиатура
Отметьте “Использовать Option как Meta Key”

Для iTerm2 и терминала VSCode:

Откройте Настройки → Профили → Клавиши
В разделе Общие установите левую/правую клавишу Option на “Esc+”

Совет для пользователей iTerm2 и VSCode: Запустите /terminal-setup в Claude Code для автоматической настройки Shift+Enter как более интуитивной альтернативы.

См. настройку терминала в настройках для подробностей конфигурации.

Режим Vim

Claude Code поддерживает подмножество привязок клавиш Vim, которые можно включить с помощью /vim или настроить через /config.

Поддерживаемое подмножество включает:

Переключение режимов: Esc (в NORMAL), i/I, a/A, o/O (в INSERT)
Навигация: h/j/k/l, w/e/b, 0/$/^, gg/G
Редактирование: x, dw/de/db/dd/D, cw/ce/cb/cc/C, . (повтор)

Код Claude

​Начало работы

​Команды CLI

​Флаги CLI

​Подробности режима печати

​Базовое использование

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