Skip to main content

Подключить Veai в закрытом контуре

Эта инструкция предназначена для рабочих станций без доступа к интернету.

Она описывает установку плагина из локального ZIP-архива, вход в аккаунт с офлайн-токеном и подключение к модели, развёрнутой в вашей сети через OpenAI-совместимый шлюз.

Что подготовить​

Перед началом попросите администратора контура предоставить:

  • ZIP-архив плагина Veai для вашей версии IDE (2026.1 или 2026.2);
  • адрес шлюза, доступный с целевой машины;
  • API-ключ для этого шлюза;
  • идентификатор модели.

Ещё понадобится телефон или другая машина с доступом к интернету — на ней вы войдёте в личный кабинет Veai. Целевая машина к интернету не подключается.

Узнать версию IDE можно в меню Help | About.

Версия IDE и номер сборки в окне About

Например, для IDE версии 2026.2 номер сборки начинается с 262.

Архив плагина и реквизиты шлюза передавайте на целевую машину по принятому в вашей организации защищённому каналу.

1. Скачайте архив плагина​

На машине с доступом к сети выберите IDE и её версию:

Скачать Veai для своей IDE

Выберите версию IDE. Ссылка ведёт прямо на совместимый ZIP-архив плагина.

Загружаем доступные версии…

В списке показаны версии IDE, для которых доступен Veai 5.17.0 или новее.

Нажмите Скачать ZIP и перенесите архив на целевую машину. Убедитесь, что это архив плагина Veai, а не Veai AI Agent — так называется устаревший плагин. Если вашей версии нет в списке, уточните совместимую сборку у администратора.

2. Установите плагин из архива​

На целевой машине:

  1. Откройте настройки IDE: Settings.
  2. Перейдите в Plugins и нажмите на значок шестерёнки.
  3. Выберите Install Plugin from Disk.
  4. Укажите перенесённый ZIP-архив.
  5. Подтвердите установку и перезапустите IDE.
Агент Veai устанавливается отдельно и через интернет

Плагин не включает агента: кнопка Install скачивает агента и Node.js из интернета. Агент устанавливается в ~/.local/share/veai-ai-agent (в Windows — %USERPROFILE%\.local\share\veai-ai-agent). В документации нет подтверждённого способа установить его без сети или перенести с другой машины. Прежде чем планировать работу в изолированном контуре, уточните у поддержки, как доставить агента на машину без доступа к сети. Если на машине есть доступ хотя бы к установочным адресам агента, установите его там заранее.

3. Войдите в аккаунт без интернета​

В изолированной сети Sign in недоступен, поэтому вход выполняется по офлайн-токену без входа в аккаунт на этой машине.

  1. После перезапуска откройте окно Veai на правой панели IDE. Запустится первоначальная настройка.
  2. На шаге Choose an agent выберите Veai, на шаге Choose a plan — Free.
  3. На шаге входа откройте раздел Work offline with a token.
  4. Нажмите Copy this machine's code и передайте код на телефон или другую машину с интернетом.
  5. На этой машине войдите в личный кабинет Veai (при необходимости зарегистрируйтесь) и получите по коду офлайн-токен.
  6. Вернитесь в IDE и вставьте токен в поле Paste the token here. Плагин проверит его сам (Token accepted).

Настройка офлайн-доступа при первоначальной настройке

Офлайн-токен можно добавить или заменить и позже — в разделе OFFLINE ACCESS панели аккаунта (ссылка Set up offline token). Без связи с сервером Veai сообщения отправляются только при действующем офлайн-токене.

4. Подключите свой шлюз​

Шлюз подключается к агенту Veai как свой OpenAI-совместимый провайдер (карточка Your own key). Ключ вводится не в личном кабинете, а в самом агенте. На шаге выбора модели плагин предложит открыть терминал и добавить провайдера в агенте:

  1. Нажмите Open terminal (или скопируйте команду и выполните её в своём терминале).
  2. В агенте выполните /custom-provider и укажите:
    • адрес шлюза с путём API, например http://gateway.example.local/v1;
    • API-ключ шлюза или ссылку на переменную окружения вида $GATEWAY_KEY;
    • модели, развёрнутые в вашем контуре.
  3. Вернитесь в IDE и нажмите Next: шаг выбора модели проверит провайдера.
  4. Выберите модель шлюза.

Подробно мастер /custom-provider описан на странице «Свои провайдеры и локальные модели». Уточните у администратора, нужен ли путь /v1 и в каком формате указывать идентификатор модели.

Не вставляйте ключ шлюза в файлы проекта и сообщения чата.

5. Отправьте тестовый запрос​

Создайте новый чат и отправьте запрос, который не меняет проект:

Кратко объясни, о чём этот проект. Назови основной стек и укажи 2–3 файла,
которые стоит прочитать в первую очередь. Ничего не меняй.

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

Если подключение не работает​

  • Модели не загружаются: проверьте адрес шлюза, путь /v1, API-ключ и доступность шлюза с целевой машины.
  • При ошибке авторизации запросите у администратора ключ для клиентов шлюза.
  • Сообщение «Can't reach the server…»: добавьте или обновите офлайн-токен в панели аккаунта.
  • Если запрос не появляется в журнале шлюза, проверьте выбранную модель.
  • Для других симптомов обратитесь в поддержку.