Документация

Подключение моделей

Агенты работают через CLI ваших подписок. Что поставить, как войти кнопкой из приложения, когда нужен API-ключ и как подключить свой шлюз или локальную модель.

VibeForge не продаёт токены и не проксирует запросы к моделям. Он запускает те же программы, которыми вы пользуетесь в терминале, — под вашим аккаунтом и вашей подпиской.

Движки и подписки

Движок	Подписка	Установка
Claude Code	Claude Pro / Max (Anthropic)	npm i -g @anthropic-ai/claude-code
Codex	ChatGPT (OpenAI)	Настройки → Окружение → Codex → Установить (Node.js не нужен)
Antigravity	Google-аккаунт, AI Pro / Ultra	Настройки → Окружение → Antigravity → Установить
Gemini CLI	Code Assist Standard/Enterprise	npm i -g @google/gemini-cli
Kimi	Kimi Code (Moonshot)	Настройки → Окружение → Kimi → Установить
Grok	SuperGrok (xAI)	по инструкции xAI

Ставить и входить руками не обязательно: у каждой карточки в «Настройки → Окружение» (и в мастере первого запуска) есть кнопки «Установить» и «Войти». Приложение открывает терминал прямо в окне и проходит установку или вход вместе с вами — claude спросит про аккаунт, codex login откроет браузер. Кому привычнее свой Терминал — те же команды лежат рядом с кнопками.

Чем движки отличаются друг от друга — контекстом, набором рабочих слэш-команд, способом обновления — разобрано подробно в разделе «Движки»: там же сравнительная таблица и по странице на каждый. Лимиты подписок, второй аккаунт и обновления движков — на странице «Аккаунты, лимиты и обновления».

Проверка окружения

«Настройки → Окружение» показывает всё, что приложение нашло на машине: движки моделей и вспомогательные программы (git, GitHub CLI, ffmpeg, распознавание речи). У каждого движка видно, выполнен ли вход и чей это аккаунт; у ненайденного стоит команда установки и команда входа. Кнопка «Проверить снова» опрашивает систему заново — перезапускать приложение после установки не нужно.

Codex работает в песочнице, которую задаёт VibeForge: «Только проект», «Проект и сеть» или «Полный доступ». Переключатель — там же, в «Окружении», и действует со следующего сообщения. Режимы без правок («Брейншторм», «План», «Опрос», «Вопрос», «Ревью») всегда только читают.

Когда нужен API-ключ

Ключ нужен только для движка «API» — подписки CLI ключей не требуют. Поля живут в «Настройки → Провайдеры»: ключ Anthropic, ключ и базовый адрес OpenAI, ключ OpenRouter, базовый адрес и ключ своего шлюза или локального сервера. Значения хранятся локально и применяются сразу, без перезапуска; ключ, уже заданный переменной окружения, помечается в интерфейсе — переписывать его не нужно. С версии 2.0.16 модель по API-ключу помнит прошлые ходы разговора и не теряет нить после обрыва связи.

Свой шлюз и локальные модели

Если ключи и лимиты у вас живут в роутере вроде 9router или LiteLLM, впишите его адрес в «Настройки → Провайдеры → Свой шлюз или локальный сервер»: подходит любой адрес, говорящий на OpenAI Chat Completions, в том числе Ollama, LM Studio и vLLM на этой же машине. Там же задаётся модель по умолчанию и список своих моделей — их id появятся в выборе модели новой сессии. В режиме «Оркестратор» каждая роль команды может идти через своего провайдера: планировщик через Anthropic, один агент через OpenRouter, другой через свой шлюз.

Модель на шлюзе должна уметь вызывать инструменты (function calling): агент правит файлы и запускает команды через них. Модель без этого ответит текстом и ничего не сделает. В серверном режиме адрес localhost означает сервер, а не ноутбук.