---
name: claude-code-cli-interactive
description: "CLI Claude Code (claude -p, claude --print, 45+ флагов). ТОЛЬКО при: claude -p, claude --print, claude flags, Vim mode Claude, claude checkpoints, claude rewind, claude resume, headless Claude, claude output format. НЕ для VS Code (→ claude-code-vscode), НЕ для settings.json (→ claude-code-settings), НЕ для pdf-framework CLI (→ framework-cli), НЕ для 1С."
---

# CLI и интерактивный режим Claude Code

## Основные команды CLI

| Команда | Описание |
|---------|----------|
| `claude` | Интерактивный REPL |
| `claude "query"` | REPL с начальным запросом |
| `claude -p "query"` | Headless (print mode), затем выход |
| `cat file \| claude -p "query"` | Pipe содержимого |
| `claude -c` | Продолжить последний разговор |
| `claude -r "session" "query"` | Возобновить сессию по ID/имени |
| `claude update` | Обновить версию |
| `claude mcp` | Настроить MCP серверы |

## Ключевые флаги

### Режимы работы

| Флаг | Описание |
|------|----------|
| `-p, --print` | Headless режим (без интерактива) |
| `-c, --continue` | Продолжить последний разговор |
| `-r, --resume <id>` | Возобновить сессию |
| `--model <name>` | Модель (`sonnet`, `opus`, `haiku`) |
| `--agent <name>` | Указать подагента |
| `--agents '<json>'` | Определить подагентов через JSON |

### Разрешения и инструменты

| Флаг | Описание |
|------|----------|
| `--allowedTools "Tool1" "Tool2"` | Авто-одобренные инструменты |
| `--disallowedTools "Tool"` | Запрещённые инструменты |
| `--tools "Bash,Edit,Read"` | Ограничить доступные инструменты |
| `--permission-mode <mode>` | Режим разрешений |
| `--dangerously-skip-permissions` | Пропустить ВСЕ проверки |

### Вывод и формат

| Флаг | Описание |
|------|----------|
| `--output-format text\|json\|stream-json` | Формат вывода (headless) |
| `--json-schema '<schema>'` | Структурированный вывод по JSON Schema |
| `--verbose` | Подробное логирование |
| `--debug "api,hooks"` | Отладка по категориям |

### Системный промпт

| Флаг | Описание |
|------|----------|
| `--system-prompt "text"` | Заменить весь системный промпт |
| `--system-prompt-file ./file.txt` | Заменить промпт из файла |
| `--append-system-prompt "text"` | Добавить к дефолтному |
| `--append-system-prompt-file` | Добавить из файла |

### Прочие

| Флаг | Описание |
|------|----------|
| `--add-dir ../lib` | Доп. директории |
| `--max-turns 5` | Макс. ходов (headless) |
| `--max-budget-usd 5.00` | Макс. бюджет (headless) |
| `--mcp-config ./mcp.json` | MCP конфигурация |
| `--plugin-dir ./plugins` | Директория плагинов |
| `--chrome` | Интеграция Chrome |
| `--remote "task"` | Создать веб-сессию на claude.ai |
| `--fallback-model sonnet` | Fallback при перегрузке |

## Встроенные slash-команды

| Команда | Описание |
|---------|----------|
| `/clear` | Очистить историю |
| `/compact [focus]` | Компактировать контекст |
| `/config` | Настройки |
| `/context` | Визуализация контекста |
| `/cost` | Статистика токенов/стоимости |
| `/doctor` | Проверка здоровья |
| `/exit` | Выход |
| `/export [file]` | Экспорт разговора |
| `/init` | Создать CLAUDE.md |
| `/mcp` | Управление MCP |
| `/memory` | Редактировать CLAUDE.md |
| `/model` | Сменить модель |
| `/permissions` | Разрешения |
| `/plan` | Режим планирования |
| `/rename <name>` | Переименовать сессию |
| `/resume` | Возобновить сессию |
| `/rewind` | Откатить код/разговор |
| `/stats` | Статистика использования |
| `/statusline` | Настроить строку состояния |
| `/tasks` | Фоновые задачи |
| `/theme` | Тема |
| `/todos` | Список TODO |
| `/vim` | Включить Vim mode |

## Горячие клавиши

### Основные

| Клавиша | Действие |
|---------|----------|
| `Ctrl+C` | Отменить ввод/генерацию |
| `Ctrl+D` | Выход |
| `Ctrl+G` | Открыть в текстовом редакторе |
| `Ctrl+L` | Очистить экран |
| `Ctrl+O` | Подробный вывод (toggle) |
| `Ctrl+R` | Поиск по истории |
| `Ctrl+V` | Вставить изображение |
| `Ctrl+B` | Фоновое выполнение (tmux: 2x) |
| `Ctrl+T` | Список задач (toggle) |
| `Esc+Esc` | Rewind (откат кода/разговора) |
| `Shift+Tab` | Переключить Permission Mode |
| `Alt+P` | Переключить модель |
| `Alt+T` | Расширенное мышление (toggle) |

### Многострочный ввод

| Метод | Клавиша |
|-------|---------|
| Универсальный | `\` + `Enter` |
| macOS | `Option+Enter` |
| iTerm2/WezTerm/Ghostty/Kitty | `Shift+Enter` |
| Управляющий символ | `Ctrl+J` |

### Быстрые команды

| Префикс | Действие |
|---------|----------|
| `/` | Slash-команда или skill |
| `!` | Bash режим (прямое выполнение) |
| `@` | Автодополнение пути к файлу |

## Vim Mode

Включение: `/vim` или `/config`.

### Основные операции

| Команда | Normal → | Insert → Normal |
|---------|----------|-----------------|
| `i` | Вставить перед | `Esc` |
| `a` | Вставить после | |
| `o`/`O` | Новая строка ниже/выше | |
| `I`/`A` | Начало/конец строки | |

### Навигация (Normal mode)

`h`/`j`/`k`/`l` — лево/низ/верх/право.
`w`/`b`/`e` — слово вперёд/назад/конец.
`0`/`$`/`^` — начало/конец/первый символ строки.
`gg`/`G` — начало/конец ввода.
`f{c}`/`F{c}` — найти символ вперёд/назад.

### Редактирование (Normal mode)

`dd`/`D` — удалить строку/до конца. `cc`/`C` — изменить строку/до конца.
`x` — удалить символ. `yy`/`p` — копировать/вставить.
`>>`/`<<` — отступ. `.` — повторить.

### Текстовые объекты

`iw`/`aw` — внутри/вокруг слова. `i"`/`a"` — внутри/вокруг кавычек.
`i(`/`a(` — внутри/вокруг скобок. `i{`/`a{` — внутри/вокруг фигурных.

## Контрольные точки (Checkpoints)

Claude Code автоматически создаёт контрольные точки при каждом сообщении.

### Откат (Rewind)

`Esc + Esc` или `/rewind` → выбрать:
- **Только беседа** — откатить разговор, сохранить код
- **Только код** — откатить файлы, сохранить беседу
- **Код + беседа** — откатить всё

### Ограничения

- Bash команды (rm, mv, cp) НЕ отслеживаются
- Внешние изменения НЕ отслеживаются
- Очистка через 30 дней (настраивается через `cleanupPeriodDays`)

## Фоновые задачи

### Запуск

- Попросить Claude: "run this in the background"
- `Ctrl+B` — перевести текущую задачу в фон
- `!command` + `Ctrl+B` — фоновый bash

### Управление

`/tasks` — список фоновых задач.

Отключение: `CLAUDE_CODE_DISABLE_BACKGROUND_TASKS=1`.

## Режим Bash (`!`)

```
! npm test          # Выполнить напрямую, добавить вывод в контекст
! git status        # Без интерпретации Claude
```

- Поддерживает `Ctrl+B` для фонового выполнения
- Tab-автодополнение из истории `!` команд

## Источники

- `docs/documentation/Claude Code Docs/5. Справка/Справочник CLI.md`
- `docs/documentation/Claude Code Docs/5. Справка/Интерактивный режим.md`
- `docs/documentation/Claude Code Docs/5. Справка/Контрольные точки.md`