Плагины OpenCode: когда ставить расширение и как проверить его перед запуском
Как выбрать и подключить плагин OpenCode, чем он отличается от MCP-сервера и skills, и какие проверки сделать до выдачи расширению доступа к проекту.
Плагин меняет поведение самого OpenCode: добавляет интеграцию или реагирует на события. Механизм мощный, но нужен реже, чем кажется. Часто задачу закрывает короткая инструкция или один MCP-сервер.
Плагин, skill или MCP
| Механизм | Что добавляет | Когда подходит |
|---|---|---|
| Skill | Инструкцию для агента | Нужен порядок работы или правила проекта |
| MCP-сервер | Инструменты и данные | Агенту требуется читать сервис, API или базу |
| Плагин | Расширение поведения OpenCode | Нужна логика, не выражаемая инструкцией |
Хватает чек-листа, бери skill. Нужно, чтобы агент забирал задачи из трекера, скорее подойдёт MCP. Плагин оставь для логики, которую словами не опишешь. И держи в голове обновления: чем больше у тебя движущихся частей, тем дольше потом искать, что сломалось после апдейта.
Как выбрать расширение
Начни с документации или репозитория автора. Посмотри, с какой версией OpenCode плагин работает, когда его последний раз обновляли и каких прав он просит. Знакомое название в npm ничего не гарантирует: пакет может оказаться чужим или заброшенным. Ставь по ссылке из источника, которому доверяешь.
До установки загляни в настройки. Плагин может видеть конфигурацию, переменные окружения и файлы проекта, а иногда ещё и ходить в сеть. Каждая такая возможность должна объясняться его задачей. Если инструкция просит вставить токен прямо в конфиг проекта, остановись и перечитай её.
Подключение и первый тест
Установи плагин по инструкции для своей версии, перезапусти агент и проверь одно заметное действие: появилась ли команда, сработал ли обработчик, нет ли ошибки в логе. Если плагин меняет файлы, в первый раз запускай его на отдельной ветке или копии проекта.
OpenCode, плагин и конфиг одновременно не обновляй, иначе при сбое не поймёшь, кто виноват. Запиши рабочую версию и держи минимальный конфиг без секретов. Если что-то пошло не так, пригодится разбор «OpenCode не работает». А если тебе на самом деле нужен доступ к сервису, а не новый код внутри агента, проще настроить MCP-сервер.