Использование терминала

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

1. Основы

Терминальная сессия запускает настоящую оболочку. В macOS и Linux это системная оболочка по умолчанию ($SHELL); в Windows по умолчанию используется cmd, и её можно заменить (см. §7). По умолчанию рабочим каталогом служит корень проекта. В форме редактирования сессии можно изменить поле «Рабочий каталог (пусто = корень проекта)» и заполнить поле «Команда запуска (необязательно)»: эта команда выполняется при каждом запуске сессии (например, pnpm dev).

Когда несколько агентов одновременно выводят много данных, VelaTerm отдаёт приоритет вашему вводу и видимой вкладке, а вывод фоновых вкладок замедляет. Это поведение управляется параметром «Приоритет вывода активного терминала» (Настройки ▸ Дополнительно, по умолчанию включён). Если после переключения вкладок полноэкранная программа отображается с искажениями, нажмите кнопку «Перерисовать» в заголовке панели. Параметр «Перерисовка при возврате к вкладке» (Настройки ▸ Дополнительно) делает это автоматически каждый раз, когда вкладка становится видимой.

2. Поиск в терминале (⌘F)

⌘F открывает панель поиска («Поиск в терминале») по истории прокрутки текущего терминала с кнопками перехода к предыдущему и следующему совпадению:

Для поиска по всем сессиям и истории используйте глобальный поиск (⌘⇧F), описанный в главе Управление интерфейсом и сессиями.

3. Копирование и вставка

• Выделите текст мышью, затем используйте ⌘C / ⌘V или контекстное меню («Копировать», «Вставить», «Выделить всё», «Очистить», «Поиск…»).
• В программах, которые перехватывают мышь (vim, htop, большинство интерфейсов агентов), удерживайте при перетаскивании Option в macOS или Shift в Windows и Linux, чтобы принудительно выделить текст обычным способом.
• Интерфейсы агентов, такие как Claude Code и Codex, умеют сами копировать текст. Если они только что это сделали, а в терминале ничего не выделено, контекстное меню показывает «Скопировано N симв. · ⌘V».

4. Вставка изображений

Чтобы передать изображение агенту командной строки, вставьте или перетащите его в терминал. Параметр «Вставка изображения» (Настройки ▸ Терминал) предлагает два варианта:

• Вставить путь к файлу (по умолчанию): изображение сохраняется во временный файл, а его путь вставляется в строку ввода; такой файл может открыть любой агент, умеющий читать файлы. Codex получает его как image_path: ….
• Нативная вставка: Claude Code или Codex считывает изображение из системного буфера обмена и показывает собственный заполнитель изображения. Этот вариант доступен только в локальном настольном приложении; в удалённых сессиях всегда вставляется путь к файлу, чтобы агент мог прочитать изображение на своём компьютере.

Параметр «Автоочистка вставленных изображений» (Настройки ▸ Поведение) удаляет эти временные файлы при выходе из приложения, а при запуске очищает оставшиеся файлы старше 24 часов. Кнопка «Очистить сейчас» удаляет их немедленно. Изображения, вставленные в документы, при этом никогда не затрагиваются.

5. Подсказки команд

В обычных терминальных сессиях в macOS и Linux VelaTerm может показывать список подсказок, построенный на основе определений автодополнения вашей оболочки. Параметр «Подсказки команд» (Настройки ▸ Терминал) принимает значения «Автоматически» (по умолчанию), «По Tab» или «Выключены». Выбирайте вариант клавишами со стрелками и вставляйте его клавишей Tab; Enter всегда выполняет команду в том виде, в каком она введена. Когда выделение не может сдвинуться дальше, клавиши ↑ и ↓ передаются оболочке, поэтому ↑ на первом варианте вызывает предыдущую команду. В Windows список недоступен. Подробности приведены в главе Подсказки команд.

6. Встроенные команды

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

Запустите команду с --help, чтобы увидеть её параметры; каждая команда подробно описана в главе Команды сессий. Большинство этих команд существуют также в виде навыков в Claude Code (/vopen) и Codex ($vopen); у vrun и vflow навыков нет, а vask существует только как навык. Навыки устанавливаются кнопкой в параметре «Vela Skills» (Настройки ▸ Общие).

vopen выбирает способ просмотра по типу файла:

vopen README.md          # Markdown → Markdown editor
vopen src/main.rs        # source code → code editor with syntax highlighting
vopen diagram.png        # image → image viewer
vopen https://crates.io  # web address → browser tab (desktop app only)

Относительные пути отсчитываются от текущего каталога; можно открыть несколько файлов сразу. Вкладки документов описаны в главе Вкладки документов и браузера, vspawn — в главе Создание сессий и совместная работа в Git, а vkb — в главах Граф кода и база знаний и Локальные базы знаний.

6.1 Фоновые команды (vrun)

vrun <label> <command...> запускает команду, ждёт её завершения, а затем выводит код завершения, затраченное время и конец журнала. Поэтому агент, запустивший длительную сборку или тесты через vrun, узнаёт результат, как только он становится известен. Закрытие сессии не останавливает команду. vrun --status <label> сообщает о ранее запущенной команде, а -t <seconds> задаёт время ожидания (по умолчанию 1800 секунд); когда время ожидания истекает, vrun завершается с кодом 124, а команда продолжает работать.

Пока такие команды выполняются, над терминалом отображается строка «Фоновые команды». Для каждой команды показаны её метка и надпись «Выполняется: …», кнопка «Журнал», открывающая вывод команды, и кнопка «Остановить»; чтобы завершить команду, нажмите «Подтвердить остановку». Когда ничего не выполняется, строка исчезает.

7. Выбор оболочки (только в Windows)

В Windows терминальные сессии могут использовать любую обнаруженную оболочку: PowerShell, pwsh, cmd, Git Bash и все установленные дистрибутивы WSL. Выберите её в подменю «Новый терминал», в поле «Shell (пусто = системный по умолчанию)» формы редактирования сессии или в меню «Shell», которое открывается правой кнопкой мыши. Работающая сессия сразу перезапускается с новой оболочкой. Параметр «Shell по умолчанию» (Настройки ▸ Терминал) задаёт оболочку для новых терминалов, для которых она не выбрана явно.

Записи WSL отображаются как WSL: <distribution>, только если WSL сообщает об установленном дистрибутиве. При выборе такой записи запускается этот дистрибутив, а каталог проекта Windows сопоставляется с путём внутри него. WSL доступен только для обычных терминальных сессий; сессии агентов по-прежнему используют оболочку хоста Windows. Встроенные команды v в терминалах WSL недоступны.

О встроенном Git Bash: установщик full содержит полный Git Bash (с git, ssh и perl). Установщик min содержит основное подмножество команд; когда вы запускаете отсутствующую команду, он предлагает загрузить полную версию, которую также можно получить через пункт контекстного меню «Скачать полный Git Bash». Сессий агентов это не касается: они используют PowerShell.

В macOS и Linux выбора оболочки нет; сессии используют системную оболочку по умолчанию.

8. Запись сессий

Параметр «Запись журналов сессий» (Настройки ▸ Дополнительно) по умолчанию выключен. Когда он включён, VelaTerm сохраняет вывод терминала сессий агентов, работающих в виде терминала, в локальный файл журнала — до 50 МБ на сессию. Обычные терминальные сессии никогда не записываются.

Запись позволяет воспроизвести архивную сессию в том виде, в каком она выглядела на экране, и делает её экранный текст доступным для поиска. VelaTerm использует запись, только если собственную запись диалога агента прочитать нельзя; в остальных случаях для просмотра и поиска используется запись диалога. Файлы записей удаляются вместе с их сессией.

9. Отрисовка

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

10. Основные горячие клавиши

В таблице приведены сочетания по умолчанию для настольного приложения macOS. В приложениях для Windows и Linux для большинства действий вместо ⌘ используется Ctrl+Alt (разделение вниз — Ctrl+Alt+E, поиск по всем сессиям — Ctrl+Alt+G, а сохранение остаётся Ctrl+S). В браузерных клиентах используются сочетания на основе Ctrl, которые не пересекаются с собственными сочетаниями браузера. В разделе «Настройки ▸ Горячие клавиши» показаны точные назначения для вашей системы; там можно изменить любое действие, кроме переключения вкладок и изменения размера шрифта.