Подключить Veai в закрытом контуре
Эта инструкция предназначена для рабочих станций без доступа к интернету.
Она описывает установку плагина из локального ZIP-архива, вход в аккаунт с офлайн-токеном и подключение к модели, развёрнутой в вашей сети через OpenAI-совместимый шлюз.
Что подготовить
Перед началом попросите администратора контура предоставить:
- ZIP-архив плагина Veai для вашей версии IDE (2026.1 или 2026.2);
- адрес шлюза, доступный с целевой машины;
- API-ключ для этого шлюза;
- идентификатор модели.
Ещё понадобится телефон или другая машина с доступом к интернету — на ней вы войдёте в личный кабинет Veai. Целевая машина к интернету не подключается.
Узнать версию IDE можно в меню Help | About.

Например, для IDE версии 2026.2 номер сборки начинается с 262.
Архив плагина и реквизиты шлюза передавайте на целевую машину по принятому в вашей организации защищённому каналу.
1. Скачайте архив плагина
На машине с доступом к сети выберите IDE и её версию:
Скачать Veai для своей IDE
Выберите версию IDE. Ссылка ведёт прямо на совместимый ZIP-архив плагина.
Загружаем доступные версии…
В списке показаны версии IDE, для которых доступен Veai 5.17.0 или новее.
Нажмите Скачать ZIP и перенесите архив на целевую машину.
Убедитесь, что это архив плагина Veai, а не Veai AI Agent — так называется устаревший плагин.
Если вашей версии нет в списке, уточните совместимую сборку у администратора.
2. Установите плагин из архива
На целевой машине:
- Откройте настройки IDE:
Settings. - Перейдите в
Pluginsи нажмите на значок шестерёнки. - Выберите
Install Plugin from Disk. - Укажите перенесённый ZIP-архив.
- Подтвердите установку и перезапустите IDE.
Плагин не включает агента: кнопка Install скачивает агента и Node.js из интернета. Агент устанавливается в ~/.local/share/veai-ai-agent (в Windows — %USERPROFILE%\.local\share\veai-ai-agent). В документации нет подтверждённого способа установить его без сети или перенести с другой машины. Прежде чем планировать работу в изолированном контуре, уточните у поддержки, как доставить агента на машину без доступа к сети. Если на машине есть доступ хотя бы к установочным адресам агента, установите его там заранее.
3. Войдите в аккаунт без интернета
В изолированной сети Sign in недоступен, поэтому вход выполняется по офлайн-токену без входа в аккаунт на этой машине.
- После перезапуска откройте окно Veai на правой панели IDE. Запустится первоначальная настройка.
- На шаге
Choose an agentвыберитеVeai, на шагеChoose a plan—Free. - На шаге входа откройте раздел
Work offline with a token. - Нажмите
Copy this machine's codeи передайте код на телефон или другую машину с интернетом. - На этой машине войдите в личный кабинет Veai (при необходимости зарегистрируйтесь) и получите по коду офлайн-токен.
- Вернитесь в IDE и вставьте токен в поле
Paste the token here. Плагин проверит его сам (Token accepted).

Офлайн-токен можно добавить или заменить и позже — в разделе OFFLINE ACCESS панели аккаунта (ссылка Set up offline token).
Без связи с сервером Veai сообщения отправляются только при действующем офлайн-токене.
4. Подключите свой шлюз
Шлюз подключается к агенту Veai как свой OpenAI-совместимый провайдер (карточка Your own key). Ключ вводится не в личном кабинете, а в самом агенте. На шаге выбора модели плагин предложит открыть терминал и добавить провайдера в агенте:
- Нажмите
Open terminal(или скопируйте команду и выполните её в своём терминале). - В агенте выполните
/custom-providerи укажите:- адрес шлюза с путём API, например
http://gateway.example.local/v1; - API-ключ шлюза или ссылку на переменную окружения вида
$GATEWAY_KEY; - модели, развёрнутые в вашем контуре.
- адрес шлюза с путём API, например
- Вернитесь в IDE и нажмите
Next: шаг выбора модели проверит провайдера. - Выберите модель шлюза.
Подробно мастер /custom-provider описан на странице «Свои провайдеры и локальные модели».
Уточните у администратора, нужен ли путь /v1 и в каком формате указывать идентификатор модели.
Не вставляйте ключ шлюза в файлы проекта и сообщения чата.
5. Отправьте тестовый запрос
Создайте новый чат и отправьте запрос, который не меняет проект:
Кратко объясни, о чём этот проект. Назови основной стек и укажи 2–3 файла,
которые стоит прочитать в первую очередь. Ничего не меняй.
В ответе должны появиться сведения о проекте и ссылки на существующие файлы. Проверьте в журнале шлюза или его панели мониторинга, что запрос прошёл через внутренний адрес.
Если подключение не работает
- Модели не загружаются: проверьте адрес шлюза, путь
/v1, API-ключ и доступность шлюза с целевой машины. - При ошибке авторизации запросите у администратора ключ для клиентов шлюза.
- Сообщение «Can't reach the server…»: добавьте или обновите офлайн-токен в панели аккаунта.
- Если запрос не появляется в журнале шлюза, проверьте выбранную модель.
- Для других симптомов обратитесь в поддержку.