Подключение агента
Агент — отдельная программа: он работает своим процессом, со своей моделью и своим входом в аккаунт. AI for OpenIDE берёт агента из каталога, ставит его вместе с окружением и подключает по протоколу ACP. Агента не из каталога можно подключить своей командой, а через OpenCode — бесплатные и локальные модели.
Описано по версии 0.8.0 (ноябрь 2026).
Редакция: OpenIDE Pro.
Плагин: AI for OpenIDE
Каталог агентов
| Группа | Агенты |
|---|---|
| Основные | Claude Code, Codex, OpenCode, Cursor, Gemini CLI |
| Российские | SourceCraft Code Assistant (Яндекс), Koda CLI, «Астра ИИ Код» |
| Другие | Hermes Agent, OpenClaw, pi, GitHub Copilot CLI, OpenHands, Oh My Pi, Open Interpreter, Cline, CodeBuddy Code, Qwen Code, Kimi Code, GLM Agent |
Состав каталога меняется от версии к версии. Поиск в выборе агента находит и тех агентов, которых ещё можно установить.
Большинство агентов умеют работать по ACP сами. Claude Code и Codex подключаются через адаптеры — claude-agent-acp (прежнее имя — claude-code-acp) и codex-acp. Адаптер плагин ставит сам при выборе агента.
Установка и вход
Агенты настраиваются на странице Настройки → Инструменты → AI for OpenIDE → Агенты (Settings → Tools → AI for OpenIDE → Agents): слева список, справа настройки выбранного агента. Добавить и установить агента можно там же или прямо в чате — в поле ввода рядом с моделью.

Настройки агента: значения для новых чатов, пресеты для вызова через @имя и выход из аккаунта.
- Окружение ставится само. Плагин устанавливает агенту Node.js и Python, если они нужны, и обновляет самого агента.
- Если установка не удалась, карточка показывает причину и предлагает «Добавить вручную».
- Свой экземпляр не подменяется. Агента, которого вы поставили сами (
npm install -g, brew или своя сборка), плагин не заменяет своей копией и не обновляет автоматически. Кнопка Update запускает собственную команду агента (например,opencode upgrade) илиnpm install -gиз того же каталога npm. - Вход — командой агента. Карточка входа появляется в чате; при отказе, например без подписки, она показывает причину. Для входа по API-ключу, например у Gemini, ключ вводится прямо в карточке.
- Выход из аккаунта — ссылка «Выйти» в настройках агента или команда
/logout. Так можно выйти из Cursor, Hermes Agent и OpenHands. - Агент по умолчанию. Новые чаты берут выбранного агента или последнего использованного.
- Проверка запуска проверяет команду агента до первого сообщения, а не в середине работы.
- Список общий для устройства. Агенты доступны во всех проектах; проект может переопределить список своим файлом настроек.

Агент, модель и режим выбираются в поле ввода. Если агент не установлен, плагин предложит установку.
Выбор агента и модели
Агент выбирается на чат, модель и режим — на следующий ход. Если агент даёт выбор, рядом с моделью появляются effort и другие параметры: у Cursor, например, — Effort, размер контекста и режим Fast.
Позвать другого агента, не выходя из чата, можно через @codex, @claude или своё имя вроде @reviewer — ответ придёт в ветке. См. Ветки и Именованные наборы.
Свой агент по ACP
Агент, которого нет в каталоге, подключается своей командой: в выборе агента — «Своя команда…» (или «Задать команду вручную…» на стартовом экране). Укажите исполняемый файл и отдельно аргументы, которые включают режим ACP.
| Агент | Команда в режиме ACP |
|---|---|
| OpenCode | opencode acp |
| Cursor CLI | agent acp |
| Cline | cline --acp |
| GitHub Copilot CLI | copilot --acp --stdio |
| SourceCraft CLI | src code -- acp |
| Koda CLI | koda --acp |
| Qwen Code | qwen --acp |
Все агенты из таблицы уже есть в каталоге; своя команда нужна, если агент запускается по-своему или установлен в нестандартное место. Если IDE не находит агента, укажите полный путь к файлу — на macOS и Linux его покажет which opencode (с именем нужного агента).
Бесплатные модели
В OpenCode есть модели с нулевой ценой запросов. Среди них — GLM 5.3 Flash Free (glm-5.3-flash-free) и DeepSeek V4.1 Flash Free (deepseek-v4.1-flash-free).
- Откройте проект и создайте AI-чат.
- Выберите агента OpenCode. Если он не установлен, плагин установит его вместе с окружением.
- В списке моделей выберите модель с пометкой Free: платные версии тех же моделей стоят рядом.
- Поставьте задачу и проверяйте изменения в проекте.
Бесплатный доступ временный, дата окончания не объявлена. Условия задаёт OpenCode; для GLM 5.3 Flash Free и DeepSeek V4.1 Flash Free OpenCode указывает, что провайдеры не сохраняют запросы и не обучаются на них. Актуальный список смотрите в выборе модели по пометке Free.

OpenCode с бесплатной моделью. Пометка Free в названии модели — признак бесплатного доступа.
Локальные модели
Локальная модель подключается через OpenCode: он обращается к серверу модели по OpenAI-совместимому API. Так работают, например, LM Studio и корпоративные модели с таким API.
- Запустите модель и включите локальный сервер. У LM Studio сервер по умолчанию доступен по адресу
http://127.0.0.1:1234/v1. - Откройте
Настройки → Инструменты → AI for OpenIDE → Агенты → OpenCode(Settings → Tools → AI for OpenIDE → Agents → OpenCode) и добавьте провайдера: адрес сервера и модель по умолчанию. Токен, если он нужен, хранится в хранилище паролей IDE. - В чате выберите OpenCode и локальную модель в списке моделей. Сервер модели должен оставаться запущенным.
OpenCode v2 сам находит модели LM Studio на стандартном адресе. Для другого порта или включённой авторизации провайдер задаётся вручную — в настройках агента в IDE или в opencode.json проекта.
Локальная модель не требует покупки токенов и после скачивания работает без интернета, но расходует память и ресурсы компьютера. Небольшие модели заметно хуже справляются с агентными задачами.
Соединение во время работы
- Состояние видно в шапке чата: подключён, подключается, не удалось — с причиной.
- Переподключение открывает свежее соединение: заново передаёт текущий набор MCP-серверов и возвращает диалог.
Другие AI-плагины
GigaCode, Veai, Continue и Kilo Code — отдельные плагины из маркетплейса OpenIDE со своим интерфейсом; к AI for OpenIDE они не подключаются. У KodaCode есть оба варианта: собственный плагин и Koda CLI в каталоге AI for OpenIDE.
Контекст Spring-проекта
Агенту можно передать структурированную модель Spring-проекта — бины, эндпоинты, сущности, миграции — вместо поиска по файлам. Это делает Spring Agent Toolkit через слой Spring MCP, см. Spring Agent Toolkit.
Частые вопросы
Почему агент не отвечает или пишет «Internal error»?
Проверьте агента со стороны провайдера: выполнен ли вход, есть ли подписка или ключ, не исчерпан ли лимит, доступен ли сервис из вашей сети. Под «Internal error» видна причина, которую прислал агент, а отказ во входе объясняет карточка входа. Исчерпанный лимит показывается отдельной карточкой со временем сброса — см. Лимиты. Ошибки соединения вроде RetriableError: [unavailable] у Cursor указывают на сеть между агентом и провайдером: проверьте прокси и VPN.
Claude Code работает только по API-ключу?
Нет, и с подпиской Claude, и с API-ключом: вход выполняется так же, как в самом Claude Code.
Можно ли пользоваться агентом бесплатно?
Да, с бесплатными моделями OpenCode — см. Бесплатные модели. Доступ временный и зависит от условий OpenCode. Сама работа с агентами требует OpenIDE Pro; её можно попробовать 60 дней бесплатно.
Можно ли подключить локальную модель через Ollama или LM Studio?
Да, через OpenCode: он подключается к серверу модели с OpenAI-совместимым API. Пошагово на примере LM Studio — в разделе Локальные модели.
GigaCode, KodaCode и Veai — это агенты AI for OpenIDE?
GigaCode и Veai — отдельные плагины со своим интерфейсом, их ставят из маркетплейса. Если в маркетплейсе нет версии GigaCode под вашу версию IDE, вопрос к разработчикам GigaCode. KodaCode есть и отдельным плагином, и в каталоге AI for OpenIDE как Koda CLI.
Нужного агента нет в каталоге. Как его подключить?
Если агент поддерживает ACP — своей командой: «Своя команда…» в выборе агента, путь к файлу и аргумент режима ACP. См. Свой агент по ACP.
Плагин заменил мой агент своей копией?
С версии 0.8.0 — нет: агента, установленного вами, плагин не подменяет и не обновляет сам. Обновите его своей командой, например opencode upgrade, или кнопкой Update — она запускает ту же команду.
Codex не находит codex-acp. Ставить его отдельно?
Нет, плагин ставит адаптер сам при выборе Codex. Если адаптер уже установлен в другом месте, укажите путь к нему в настройках агента.
Как выйти из аккаунта Cursor?
Ссылкой «Выйти» в настройках агента или командой /logout в чате.