Skip to main content

Быстрый старт с Veai CLI

За несколько минут вы установите Veai CLI, войдёте в аккаунт Veai, зададите агенту вопрос о проекте и внесёте первое изменение.

Что нужно перед началом​

  • Одна из поддерживаемых платформ: Windows x64, macOS на Intel или Apple Silicon, Linux x64 с glibc.
  • Аккаунт на app.veai.ru, если вы будете работать по подписке Veai. Если планируете работать только со своим API-ключом, регистрацию можно пропустить.
  • На Windows — Windows 10 версии 1803 или новее и PowerShell.
  • На Linux и macOS — curl или wget и tar.
  • Доступ в интернет.
  • Проект с кодом, который вы понимаете.

Node.js, npm и права администратора не нужны: установщик сам скачает всё необходимое в домашний каталог пользователя.

Шаг 1. Установите Veai CLI​

Windows (PowerShell):

irm https://veai.ru/cli/install.ps1 | iex

Linux и macOS:

curl --proto '=https' --tlsv1.2 -fsSL https://veai.ru/cli/install.sh | sh

Если не хотите запускать скрипт вслепую, сначала откройте его по той же ссылке и прочитайте.

Установщик создаст команду veai в ~/.local/bin и добавит этот каталог в PATH: на Windows — в переменную окружения пользователя, на Linux и macOS — строкой в профиль оболочки (установщик спросит разрешение). Если после установки команда не находится, откройте новое окно терминала. Подробнее об установке и обновлениях — на странице «Установка и обновление».

Шаг 2. Запустите агента в проекте​

Перейдите в папку проекта и запустите агента:

cd path/to/project
veai

Агент работает с файлами в папке, из которой запущен. Запускайте его из корня проекта.

Шаг 3. Войдите в аккаунт​

  1. Введите в поле ввода команду /login.
  2. Выберите Sign in with an account, затем Veai.
  3. Завершите вход в браузере.

Подписка и минуты общие с плагином Veai. Условия описаны на странице «Тарифы и баланс».

Если вы хотите работать со своим API-ключом провайдера, выберите его в том же меню /login. Как подключить локальную модель или корпоративный шлюз, описано на странице «Свои модели и шлюзы».

Шаг 4. Выберите модель​

Введите /model и выберите модель из списка. Если не знаете, какую выбрать, начните с autopilot: он сам подбирает модель под задачу по соотношению цены и качества и списывает четверть минуты за каждую минуту работы. Подробнее — на странице «Модели и автоподбор».

Шаг 5. Задайте первый вопрос​

Начните с вопроса, который не меняет проект:

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

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

Шаг 6. Внесите первое изменение​

Поручите агенту небольшую понятную правку:

Добавь к функции parseConfig в src/config.ts краткий комментарий-документацию:
назначение, параметры и возвращаемое значение. Больше ничего не меняй.

Замените имя функции и файла на свои. Агент прочитает файл, внесёт правку и сообщит, что изменил.

По умолчанию агент работает в режиме разрешений default: обычные действия выполняются сразу, а перед опасными агент спрашивает разрешение. Прочитайте, что он собирается сделать, и подтвердите или откажите. Режимы разрешений описаны на странице «Работа в терминале».

Проверьте результат привычным способом: посмотрите git diff, откройте файл в редакторе, запустите тесты.

Что дальше​