Настройки и горячие клавиши
Настройки открываются кнопкой с шестерёнкой в строке заголовка. В macOS в меню приложения есть также пункт «Настройки…» (⌘,); в Windows и Linux нажмите Alt и выберите «Файл ▸ Настройки…». Окно настроек содержит восемь категорий: «Общие», «Внешний вид», «Терминал», «Просмотр диалога», «Поведение», «Дополнительно», «Агенты» и «Горячие клавиши». В этой главе описан каждый параметр, а в конце приведены сочетания клавиш по умолчанию. Настройки общие для настольного приложения и подключённых к нему браузерных клиентов.
1. Общие
| Параметр | Описание |
|---|---|
| Язык | Язык интерфейса. «Авто (система)» следует языку системы; доступно одиннадцать языков |
| Звук уведомлений | Звуковой сигнал уведомлений (по умолчанию включён) |
| Системные уведомления | Включает и выключает системные уведомления (по умолчанию включены). Если система ещё не разрешила уведомления, кнопка «Разрешить уведомления» запрашивает разрешение; если уведомления заблокированы, показываются инструкции для вашей системы |
| Команда оболочки | Только в настольном приложении macOS: «Установить команду ‘vela’» добавляет в оболочку команду vela <project-path>, которая открывает проект в VelaTerm. «Удалить команду ‘vela’» удаляет её |
| Vela Skills | «Установить» (после установки — «Переустановить») устанавливает навыки VelaTerm для Claude Code и Codex, например /vspawn и $vspawn. Если Codex их не показывает, начните новую сессию Codex. См. Команды сессий, §2 |
2. Внешний вид
| Параметр | Описание |
|---|---|
| Акцент | Акцентный цвет: «Как тема» или один из четырёх цветов |
| Плотность | «Плотно», «Обычно» (по умолчанию) или «Просторно» |
| Панели | Стиль панелей: «Вплотную» (по умолчанию) или «Карточка» |
| Разделитель | «Тонкий» (по умолчанию) или «Видимый» |
| Боковая панель | «Дерево» (по умолчанию) или «Компактно» |
| Шрифт интерфейса | Шрифт интерфейса |
| Размер интерфейса | Размер шрифта интерфейса; значение «Авто» зависит от плотности |
Светлая и тёмная темы переключаются в строке заголовка (как в системе, тёмная, светлая), а не здесь. Работающие сессии Claude в виде терминала применяют новую тему без перезапуска.
3. Терминал
| Параметр | Описание |
|---|---|
| Вставка изображения | «Вставить путь к файлу» (по умолчанию) сохраняет вставленное изображение во временный файл и вставляет его путь. «Нативная вставка» позволяет Claude Code или Codex прочитать изображение из буфера обмена; этот вариант доступен только в локальном настольном приложении |
| Подсказки команд | «Автоматически», «По Tab» или «Выключены». Применяется сразу, в том числе к уже открытым терминалам; там, где функция не поддерживается, параметр скрыт. См. Подсказки команд |
| Shell по умолчанию | Оболочка для новых терминалов. Отображается в Windows, где доступно несколько оболочек; в macOS и Linux всегда используется системная оболочка |
| Шрифт терминала | Шрифт терминала |
| Размер терминала | Размер шрифта терминала (по умолчанию 13). Во время работы его можно менять сочетаниями ⌘+ / ⌘- / ⌘0 |
| Высота строки в терминале | Межстрочный интервал терминала (по умолчанию 1,2×) |
4. Просмотр диалога
Эти настройки применяются к виду беседы в сессиях агентов; см. Вид беседы.
| Параметр | Описание |
|---|---|
| Шрифт диалога, Размер шрифта диалога, Высота строки диалога | Оформление текста диалога, не зависящее от настроек терминала (размер по умолчанию 13,5, высота строки 1,2×) |
| Панель инструментов ввода | Какие элементы управления отображаются рядом с полем сообщения и в каком порядке: «Модель», «Глубина рассуждения», «Режим совместной работы», «Режим разрешений», «Быстрый режим», «Скорость», «Тон», «Серверы MCP», «Фоновые задачи», «Аккаунт» и «Сбросы лимитов Codex». У каждого элемента есть переключатель; стрелки меняют порядок включённых элементов. «Модель», «Глубина рассуждения», «Режим совместной работы» и «Режим разрешений» включены по умолчанию |
Элементы, которые текущий агент или модель не поддерживает, не отображаются. Поддерживаемый элемент остаётся видимым, даже если его функция временно недоступна: например, «Серверы MCP» и «Фоновые задачи» видны, пока процесс агента остановлен.
Выключенные элементы и элементы, которым не хватает места рядом с полем сообщения, находятся в меню Ещё, поэтому любым поддерживаемым элементом можно воспользоваться, не включая его здесь. Меню «Ещё» не отображается, если все поддерживаемые элементы включены и помещаются в строке. Элемент, который выключили и снова включили, перемещается в конец строки. На мобильных устройствах выключенные элементы отображаются во второй строке.
5. Поведение
| Параметр | Описание |
|---|---|
| Вкладки | «Одна» (по умолчанию): при открытии сессии агента повторно используется текущая вкладка, а предыдущая продолжает работать в фоне. «Несколько»: каждая сессия открывается в отдельной вкладке |
| Динамическое добавление в фильтр статуса | Если в боковой панели включён фильтр по статусу, в него добавляются сессии, которые начинают ему соответствовать (по умолчанию включено) |
| Лимит фоновых вкладок | Отображается в режиме «Одна»: максимальное число фоновых вкладок (8, 16, 32 или 64; по умолчанию 32). При превышении лимита самая старая неактивная фоновая вкладка завершается |
| Подтверждать запуск дочерних сессий | Показывать карточку подтверждения перед запуском дочерней сессии (по умолчанию включено); см. Создание сессий и совместная работа в Git, §4 |
| Автообновление использования | Поддерживать актуальность данных об использовании аккаунта на панели «Информация» (по умолчанию включено) |
| Интервал обновления | Интервал обновления: 30 с, 1 мин, 2 мин или 5 мин (по умолчанию 5 мин) |
| Продолжать после сброса лимита | Автоматически продолжать задачу Claude или Codex после сброса пятичасового или недельного лимита использования (по умолчанию включено) |
| Автоочистка вставленных изображений | Удалять временные файлы вставленных изображений при выходе из приложения, а при запуске — файлы старше 24 часов (по умолчанию включено). «Очистить сейчас» удаляет их немедленно |
Параметр «Контекст ссылок на сеансы» определяет, как vrefer --ask (и навык vask) передаёт диалог другой сессии отвечающему агенту. «Полная запись» (по умолчанию) передаёт весь диалог. «Сначала резюме» сначала сжимает его с помощью агента («Агент для резюме»), модели и глубины рассуждения, выбранных здесь. См. Команды сессий, §5.
6. Дополнительно
| Параметр | Описание |
|---|---|
| Отрисовщик терминала | «DOM» (по умолчанию) или «WebGL». Оставьте значение по умолчанию, если у вас нет конкретной причины его менять |
| Перерисовка при возврате к вкладке | Полностью перерисовывает терминал, когда вы возвращаетесь на его вкладку (по умолчанию выключено). Включите, если терминальные интерфейсы иногда отображаются с искажениями после переключения |
| Приоритет вывода активного терминала | Сохраняет отзывчивость ввода, пока агенты в других вкладках выводят много данных (по умолчанию включено) |
| Запись журналов сессий | Сохраняет вывод терминала сессий агентов в файл журнала (по умолчанию выключено). Когда параметр включён, архивные сессии можно воспроизводить, а глобальный поиск охватывает и вывод терминала. Обычные терминальные сессии никогда не записываются |
7. Агенты
Раздел «Настройки новых сеансов по умолчанию» применяется к новым сессиям выбранного агента. Настройки отдельной сессии имеют приоритет, за исключением пути к исполняемому файлу, который всегда применяется ко всему типу агента.
| Параметр | Описание |
|---|---|
| Тип агента | Агент, значения по умолчанию которого вы редактируете |
| Путь к исполняемому файлу (необязательно) | Полный путь к исполняемому файлу агента. Если поле пусто, команда ищется в PATH. Заполняется автоматически после успешной установки в один щелчок |
| Аргументы запуска (необязательно) | Аргументы командной строки по умолчанию, например --model opus |
| Разрешения | Разрешения по умолчанию для новых сессий. Claude, Codex и OpenCode предлагают свои именованные режимы; большинство других агентов — «По умолчанию» и «YOLO» (пропускать все подтверждения разрешений); у Pi запросов разрешений нет. См. Сессии ИИ-агентов, §6 |
| Вид по умолчанию | Для Claude, Codex, OpenCode, Pi и OMP: «Вид беседы» (по умолчанию) или «Вид терминала» для новых сессий. Существующие сессии сохраняют свой вид |
8. Горячие клавиши
Щёлкните сочетание клавиш нужного действия, затем нажмите новое сочетание; Escape отменяет изменение. Сочетание состоит из буквы с ⌘ (в настольном приложении macOS) или Ctrl и, при необходимости, с Shift и Option/Alt. Если сочетание уже занято, в сообщении указано действие, которое его использует. «Сбросить по умолчанию» восстанавливает все назначения.
| Действие | Настольное приложение macOS | Windows, Linux |
|---|---|---|
| Открыть проект | ⌘O | Ctrl+Alt+O |
| Новый терминал | ⌘T | Ctrl+Alt+T |
| Новый сеанс агента | ⌘N | Ctrl+Alt+N |
| Новая вкладка браузера (только в настольном приложении) | ⌘⇧B | Ctrl+Alt+B |
| Разделить вправо | ⌘D | Ctrl+Alt+D |
| Разделить вниз | ⌘⇧D | Ctrl+Alt+E |
| Закрыть панель / вкладку | ⌘W | Ctrl+Alt+W |
| Поиск в терминале | ⌘F | Ctrl+Alt+F |
| Поиск по всем сеансам | ⌘⇧F | Ctrl+Alt+G |
| Сохранить документ | ⌘S | Ctrl+S |
Обычные браузеры. Когда вы используете VelaTerm в обычном браузере (удалённый доступ по URL), сам браузер занимает многие сочетания с ⌘ и Ctrl, поэтому приведённые выше назначения для Windows и Linux действуют во всех системах, и страница настроек показывает их именно так. Исключение — браузер в macOS, где разделение вправо и вниз остаётся на ⌘D и ⌘⇧D. Окна удалённого подключения настольного приложения используют назначения настольного приложения.
Фиксированные клавиши, которые нельзя изменить: ⌘1–9 переключает вкладки, а ⌘+ / ⌘- / ⌘0 изменяет или сбрасывает размер шрифта терминала (в Windows, Linux и браузерах — с Ctrl).
9. Окно выбора агента для новой сессии
«Новый сеанс агента» открывает список типов агентов и сохранённых пресетов с поиском («Поиск агентов и пресетов»). Недавно использованные варианты идут первыми и отмечены как «Последний выбор».
Окно выбора показывает, где будет создана сессия. Если активна сохранённая сессия, выберите «На том же уровне», чтобы создать новую сессию рядом с ней, или «Дочерний сеанс», чтобы создать её под ней. Пока поле поиска в фокусе, действуют следующие клавиши:
- Tab переключает между вариантами «На том же уровне» и «Дочерний сеанс».
- ↑ и ↓ выбирают результат; Enter создаёт сессию.
- Shift+Tab переводит фокус на предыдущий элемент управления; Escape закрывает окно выбора.
Можно также щёлкнуть результат и нажать «Создать». Если ни один проект недоступен, сначала выберите проект или воспользуйтесь командой «Открыть проект».
У окна выбора есть собственный адрес, в котором сохраняются место создания, позиция, текст поиска и выбранный вариант. Копирование ссылки, обновление страницы или переходы назад и вперёд восстанавливают окно выбора, не создавая сессию. Если создать сессию не удалось, окно выбора остаётся открытым, чтобы можно было повторить попытку.
10. Другие клавиши
| Где | Клавиша | Действие |
|---|---|---|
| Вид беседы | Enter / Shift+Enter | Отправить / новая строка |
| Вид беседы, во время работы агента | ⌥Enter (Alt+Enter) | Добавить сообщение в текущий ход |
| Вид беседы, во время работы агента | ⌘Enter (Ctrl+Enter) | Остановить ход и отправить это сообщение |
| Вид беседы, во время работы агента | Esc | Остановить ход |
| Карточка подтверждения запуска | ⌘Enter (Ctrl+Enter) | Запустить сессию |
| Панель вкладок | Щелчок средней кнопкой | Закрыть вкладку |
| Боковая панель | ⌘/Ctrl-щелчок, Shift-щелчок | Выбрать несколько сессий или диапазон |