Руководство пользователя

Вид беседы

Вид беседы показывает сессию агента в виде чата: сообщения, карточки инструментов и запросы разрешений, на которые вы отвечаете кнопками. В этой главе описаны переключение между видом терминала и видом беседы, отправка сообщений во время работы агента, элементы управления под полем сообщения, откат, фоновые задачи, лимиты использования и чтение длинных диалогов.

1. Что такое вид беседы

Любая сессия агента может работать в виде терминала, где агент показывает собственный терминальный интерфейс. Пять агентов могут работать также в виде беседы: Claude Code, Codex, OpenCode, Pi и OMP. Агенты остальных типов всегда используют вид терминала.

В виде беседы VelaTerm сам отображает диалог: ваши сообщения, ответы и рассуждения агента, отдельную карточку для каждого вызова инструмента, а также карточки запросов разрешений и вопросов. Модель, глубину рассуждения и режим разрешений можно менять элементами управления под полем сообщения без перезапуска сессии.

Оба вида продолжают один и тот же диалог. Сессию можно переводить из одного вида в другой, и история при этом сохраняется.

2. Выбор вида

Вид по умолчанию для каждого агента. Параметр «Вид по умолчанию» (Настройки ▸ Агенты) определяет, в каком виде открываются новые сессии этого агента. Доступны варианты «Вид беседы» и «Вид терминала»; для всех пяти агентов по умолчанию выбран «Вид беседы». Существующие сессии сохраняют вид, в котором были созданы.

Для отдельной сессии. В окне «Создать с аргументами…» есть параметр «Открывается в», поэтому отдельную сессию можно запустить в другом виде.

Переключение существующей сессии. В заголовке панели есть кнопка переключения:

  • В виде терминала кнопка с роботом («Вид беседы») переводит сессию в вид беседы.
  • В виде беседы кнопка с терминалом («Вид терминала») возвращает её обратно. Пока вы не закроете подсказку или не воспользуетесь кнопкой, на неё указывает короткая подсказка.

Если агент работает, VelaTerm сначала спрашивает: «Смена вида перезапускает агента. Текущий ход будет прерван. Разговор сохранится.» Нажмите «Переключить», чтобы продолжить. Бездействующая сессия переключается сразу.

3. Отправка сообщений

В поле сообщения отображается подсказка «Сообщение агенту, доступны /команды, /навыки и @файлы». Enter отправляет сообщение, Shift+Enter добавляет новую строку. Когда курсор находится в начале или в конце текста, клавиши ↑ и ↓ возвращают ваши предыдущие сообщения из этого диалога.

В новом диалоге отображается надпись «Введите сообщение в поле ниже, чтобы начать разговор.» Процесс агента запускается, когда вы отправляете первое сообщение.

Во время работы агента

Пока выполняется ход, в поле сообщения отображается подсказка «Введите сообщение; оно будет отправлено по завершении текущего хода». Отправить сообщение можно тремя способами:

ДействиеmacOSWindows и Linux
В очередь: отправить по завершении ходаEnterEnter
Дополнить: добавить сообщение в текущий ход⌥Enter или кнопка «Дополнить»Alt+Enter или кнопка «Дополнить»
Прервать: остановить ход и сначала отправить это сообщение⌘EnterCtrl+Enter

Дополнение хода работает со всеми пятью агентами. Если ход не выполняется, эти сочетания клавиш просто отправляют сообщение.

Сообщения в очереди отображаются в разделе «Сообщения в очереди». Щёлкните сообщение, чтобы отредактировать его, нажмите его кнопку «Дополнить», чтобы добавить его в текущий ход, или удалите его кнопкой ×. Сообщения из очереди отправляются по порядку по мере завершения ходов.

Чтобы остановить текущий ход, нажмите Esc или кнопку остановки, которая заменяет кнопку отправки, пока поле сообщения пусто («Остановить · Esc»). В диалоге появляется надпись «Остановка текущего хода…», а затем «Текущий ход остановлен».

4. Элементы управления под полем сообщения

В строке под полем сообщения находятся элементы управления для следующего сообщения. Набор элементов зависит от агента и модели:

ЭлементАгентыНазначение
МодельВсе пятьВыбор модели. «Использовать модель по умолчанию <agent>» следует собственной конфигурации агента
Глубина рассужденияВсе пятьВыбор уровня рассуждения из тех, что предлагает выбранная модель; у Claude есть также вариант «Выключено»
Режим совместной работыCodex, OpenCodeCodex: «Обычный» (сразу выполнять работу) или «Планирование» (сначала изучить задачу и подготовить план). У OpenCode этот элемент называется «Агент» и выбирает агента OpenCode, например build или plan
Режим разрешенийClaude, Codex, OpenCode, OMPСм. таблицу ниже
Быстрый режимClaude, на поддерживающих его моделяхВключение и выключение быстрого режима
СкоростьCodex, если доступно несколько скоростейВыбор скорости обслуживания
ТонCodex, на поддерживающих его моделях«Тон по умолчанию», «Нейтральный», «Дружелюбный» или «Прагматичный»
Серверы MCPClaude, CodexПоказ настроенных серверов MCP и их состояния; переподключение, отключение или включение сервера. У Codex включение или отключение сервера меняет вашу пользовательскую конфигурацию Codex, которую используют и другие диалоги Codex
Фоновые задачиClaudeСм. §9
АккаунтClaude, CodexПовторный вход или выход из аккаунта; см. §12
Сбросы лимитов CodexCodexПросмотр и использование кредитов Codex на сброс лимитов запросов

В меню «Модель», «Глубина рассуждения» и «Режим разрешений» есть пункт «По умолчанию», который делает текущий выбор значением по умолчанию для новых диалогов этого агента. Глубина рассуждения по умолчанию запоминается для той модели, для которой она была выбрана.

Параметр «Панель инструментов ввода» (Настройки ▸ Просмотр диалога) определяет, какие элементы управления располагаются рядом с полем сообщения и в каком порядке. «Модель», «Глубина рассуждения», «Режим совместной работы» и «Режим разрешений» включены по умолчанию. Выключенные элементы и элементы, которым не хватает места, переносятся в меню Ещё, поэтому каждый поддерживаемый элемент остаётся доступным. Пока процесс агента не запущен, элементы «Серверы MCP» и «Фоновые задачи» неактивны («Процесс агента не запущен. Отправьте сообщение, чтобы запустить его.»).

В диалогах Claude и Codex рядом с кнопкой отправки также появляется небольшой индикатор контекста, как только агент сообщит первые данные. Его цвет меняется по мере заполнения контекста или приближения к лимиту запросов. Наведите на него указатель, чтобы увидеть использование контекста («Контекст: … из … токенов»), стоимость сессии, если агент её сообщает, и предупреждения о лимитах запросов.

Режимы разрешений

АгентРежимы
Claude Code«Режим плана», «Всегда спрашивать», «Принимать правки», «Автоматически», «Без вопросов»
Codex«Только чтение», «Автоматически», «Полный доступ»
OpenCode«Всегда спрашивать», «Без вопросов»
OMP«Всегда спрашивать», «Без вопросов»
PiУправления разрешениями нет; Pi выполняет инструменты без запросов

Изменение режима в сессии Codex применяется со следующего хода, и меню отмечает это. Чтобы переключить работающую сессию Claude в режим «Без вопросов», нужен перезапуск; VelaTerm спрашивает «Перезапустить и отключить подтверждения?» и сохраняет историю диалога. Режимы «Без вопросов» и «Полный доступ» отключают все подтверждения, поэтому используйте их с осторожностью.

5. Ответы агенту

Когда агенту нужно ваше участие, в конце диалога появляется карточка, а точка статуса сессии становится жёлтой:

  • Запрос разрешения: «<tool> просит разрешения на запуск» с кнопками «Разрешить» и «Отклонить». Некоторые запросы также предлагают постоянные правила, например «Разрешить … в этой сессии» или «Всегда разрешать …».
  • Вопрос: «У агента есть вопрос». Выберите или введите ответ, затем нажмите «Далее» или «Отправить»; кнопка «Закрыть» оставляет вопрос без ответа.
  • Утверждение плана: «План ожидает одобрения» с кнопками «Одобрить и выполнить» и «Отклонить».
  • Запрос данных от сервера MCP: «<server> запрашивает данные» с кнопками «Отправить», «Отклонить» и «Отмена».

6. Изображения

Вставляйте или перетаскивайте изображения в поле сообщения. Одно сообщение может содержать до 4 изображений размером до 5 МБ каждое; если изображение не удалось добавить, поле сообщения объясняет причину. Миниатюры отображаются над текстом, у каждой есть кнопка удаления. Изображение можно отправить и без текста. Щёлкните изображение в диалоге правой кнопкой мыши, чтобы выбрать «Открыть исходное изображение», «Копировать изображение» или «Сохранить изображение».

7. Команды и автодополнение

Введите /, чтобы увидеть список команд, или @, чтобы вставить путь к файлу. Tab или Enter вставляет выделенный вариант; Esc закрывает список. Для Claude и Codex в список входят собственные команды и навыки агента.

Следующие команды VelaTerm обрабатывает сам:

КомандаАгентыЧто происходит
/clear (также /new)Все пятьАрхивирует эту сессию и заменяет её в той же панели новой пустой сессией с теми же настройками
/rewindClaude, Codex, OpenCodeОткрывает меню отката для вашего последнего сообщения (см. §8)
/compactCodex, OpenCode, Pi, OMPСжимает диалог в сводку, чтобы освободить контекст
/reviewCodexПросит Codex проверить код; принимает branch <name>, commit <sha> или инструкции
/undo, /redoOpenCodeОтменяет последнее сообщение и внесённые им изменения в файлах или восстанавливает то, что отменила последняя команда undo
/share, /unshareOpenCodeСоздаёт или удаляет ссылку для общего доступа к диалогу

8. Откат и редактирование

У ваших сообщений есть кнопка «Откатить отсюда». Что можно восстановить, зависит от агента:

АгентВарианты
Claude Code«Откатить диалог», «Восстановить файлы», «Откатить диалог и восстановить файлы»
Codex«Откатить диалог»
OpenCode«Откатить диалог и восстановить файлы»
Pi, OMPНедоступно

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

У сообщений в диалогах Claude и Codex есть также кнопка «Редактировать». Измените текст или изображения, нажмите «Проверить и отправить повторно» и подтвердите кнопкой «Удалить и отправить повторно». Исходное сообщение и всё, что идёт после него, удаляются безвозвратно, а отредактированное сообщение отправляется с этого места. Изменения в файлах не восстанавливаются.

9. Фоновые задачи (Claude)

Claude может запускать субагентов и команды в фоне. Элемент Фоновые задачи показывает их список с состоянием («Выполняется», «Завершена», «Ошибка», «Остановлена»). Нажмите «Остановить», чтобы завершить задачу, или откройте её в отдельной вкладке, чтобы увидеть прошедшее время, число токенов, вызовы инструментов, промпт и результат. Пока выполняется ход, пункт «Перевести текущую работу в фон» отправляет текущую работу в фон, чтобы вы могли продолжить диалог.

Пока выполняются фоновые задачи, сессия сохраняет статус «В работе».

10. Лимиты использования и автоматическое продолжение

Если диалог Claude или Codex останавливается из-за исчерпания пятичасового или недельного лимита использования, VelaTerm продолжает задачу после сброса лимита. Эта функция включена по умолчанию; чтобы отключить её, выключите параметр «Продолжать после сброса лимита» (Настройки ▸ Поведение).

Когда параметр включён, диалог показывает, когда работа продолжится, например «Исчерпан 5-часовой лимит использования. Автоматическое продолжение задачи: 14:30.», и кнопку «Отмена». Ожидание сохраняется после перезапуска приложения. Оно завершается без отправки сообщения, если вы сами отправите сообщение, выполните откат, отмените ожидание, выключите параметр, архивируете или удалите сессию либо переведёте её в вид терминала. Если время сброса неизвестно или лимит снова исчерпан после продолжения, диалог сообщает об этом и не продолжается автоматически.

11. Чтение длинных диалогов

  • Сначала загружается последняя часть диалога. Чтобы прочитать более ранние сообщения, прокрутите вверх или нажмите «Загрузить более ранние сообщения».
  • Идущие подряд вызовы инструментов сворачиваются в одну строку («Вызовов инструментов: N»); щёлкните её, чтобы увидеть каждый вызов.
  • Промежуточные шаги каждого ответа можно скрыть («Скрыть шаги» / «Показать шаги (N)»). В заголовке панели есть кнопки «Скрыть все шаги» / «Показать все шаги».
  • Кнопка «Поиск…» в заголовке панели или сочетание клавиш для поиска в терминале (⌘F / Ctrl+Alt+F) запускает поиск по диалогу.
  • Если вы прокрутили диалог вверх, кнопка «К последнему сообщению» возвращает к его концу.
  • У ваших собственных сообщений есть кнопка копирования. Текст любого сообщения можно выделить и скопировать.

Архивные диалоги открываются в базе знаний только для чтения; см. Управление интерфейсом и сессиями, §8.

12. Вход в аккаунт и выход (Claude и Codex)

Элемент Аккаунт («Учётная запись Claude» или «Учётная запись Codex») по умолчанию не показан на панели инструментов. Откройте его из меню Ещё или включите в параметре «Панель инструментов ввода» (Настройки ▸ Просмотр диалога). Он предлагает действия «Войти снова» и «Выйти». Смена аккаунта откладывается до завершения текущего хода; Claude также дожидается завершения фоновых задач и ответа на запросы разрешений.

Codex. Если запрос Codex сообщает, что вход больше недействителен, диалог предлагает «Войти снова». Откройте страницу авторизации и введите код, показанный в диалоге. Когда вход завершится, вид обновится, и вы сможете продолжить тот же диалог. Вход по коду устройства должен быть разрешён для вашего аккаунта или рабочего пространства ChatGPT, а ваш Codex CLI должен его поддерживать. Кнопка «Отмена» прерывает незавершённый вход.

Claude. «Войти снова» показывает ссылку для авторизации. Войдите на этой странице, вставьте показанный там код целиком (включая часть после #) в поле «Код авторизации» и нажмите «Отправить код». Код не отправляется как сообщение чата. Для этого нужна версия Claude CLI, поддерживающая авторизацию аккаунта.

Выход требует подтверждения. Он удаляет учётные данные аккаунта на подключённом компьютере, поэтому затрагивает и другие сессии, которые используют те же учётные данные. История диалога сохраняется. После выхода диалог предлагает «Войти», чтобы продолжить работу. Выход из Claude не меняет настроенные ключи API.

13. Команды оболочки с !

Введите ! и команду, например ! az login --tenant <id>, чтобы выполнить команду в оболочке сессии, а не отправлять её агенту. Это работает со всеми пятью агентами.

  • Команда выполняется в рабочем каталоге агента и с его окружением. Текст после ! передаётся оболочке в том виде, в каком он введён.
  • Строка «Команда оболочки» показывает команду, её вывод в реальном времени и кнопку «Отменить». После завершения в строке отображается код завершения или «Отменено». Для длинного вывода сохраняется только последняя часть, и строка сообщает об этом.
  • После завершения команды агент получает саму команду и её вывод и может на них отреагировать.
  • В одном диалоге одновременно может выполняться только одна команда оболочки. К командам оболочки нельзя прикреплять изображения, и они не принимают интерактивный ввод. Ограничения по времени нет, поэтому команда, ожидающая входа через браузер, выполняется до завершения или до отмены.

14. Когда процесс агента останавливается

  • Закрытие вкладки диалога освобождает процесс агента: бездействующий агент останавливается сразу, а работающий — после завершения текущего хода. Следующее отправленное сообщение снова запускает его и продолжает тот же диалог.
  • Пункт «Завершить процесс» в контекстном меню сессии после подтверждения завершает работающего агента. История диалога сохраняется.
  • Если агент завершает работу сам, в диалоге отображается «Агент завершился (код N)».
  • Если агент не установлен, в панели отображается «<Agent> не установлен» с кнопками «Установить», «Документация» и «Установлю сам». «Установить» переводит сессию в вид терминала и выполняет установку там; см. Сессии ИИ-агентов, §7.