Плагины Claude Code: что это, как ставить и когда нужны

Короткий ответ

Плагин — это коробка, в которую сложено всё, чем расширяют Claude Code: скиллы, слэш-команды, свои агенты, хуки и MCP-серверы. Ставится одной командой, включается и выключается целиком.

Разница со скиллом простая. Скилл — одна инструкция, которую агент подхватывает, когда она нужна. Плагин — набор, который можно отдать команде или выложить публично. Если вы делаете что-то для себя, начинайте со скилла: он пишется за полчаса обычным текстом.

Что кладут внутрь

Плагин может содержать любое сочетание пяти вещей:

• скиллы — знания и правила, которые агент применяет сам;
• слэш-команды — свои /что-нибудь для повторяющихся действий;
• агентов — специализированные роли с собственным набором инструментов;
• хуки — команды, которые запускаются автоматически на событиях: перед правкой, после сохранения, в конце сессии;
• MCP-серверы — доступ к внешним системам, что это такое.

Отсюда и смысл конструкции: рабочий процесс редко состоит из одной вещи. Ревью кода — это скилл с критериями, команда для запуска и хук, который её вызывает. По отдельности это три файла в трёх местах; плагином — одна установка.

Как поставить

Плагины живут в маркетплейсах — обычных git-репозиториях с манифестом. Подключается маркетплейс и ставится плагин из него:

/plugin marketplace add <url-репозитория>
/plugin install <имя-плагина>

Часть плагинов ставится напрямую по адресу репозитория — так, например, распространяется MCP-обёртка для Гаранта:

/plugin install AurelVU/garant-mcp

Установленным плагином можно управлять там же: посмотреть, что он принёс, отключить временно, удалить.

Отдельно стоит знать, что плагины подключаются и в GitHub Actions — параметрами plugin_marketplaces и plugins в конфигурации действия. Так, например, ставится официальный плагин ревью кода, который оставляет замечания в пул-реквесте: подробнее про связку с GitHub.

ОсторожноПлагин может содержать хуки и MCP-серверы, то есть код, который выполняется у вас на машине с вашими правами. Это не то же самое, что скачать текстовую инструкцию. Ставить стоит по тем же правилам, что и чужой MCP-сервер: смотреть, кто автор, что внутри и когда были последние изменения.

Что проверить перед установкой чужого

Пять минут, которые экономят вечер и иногда больше:

1. Кто ведёт. Плагин от разработчика продукта живёт дольше обёртки энтузиаста.
2. Что внутри. Открыть репозиторий и посмотреть, есть ли хуки и MCP-серверы. Если есть — прочитать, что они делают.
3. Дата последних изменений. Заброшенный плагин ломается на первом же обновлении Claude Code.
4. Лицензия. Для корпоративного контура — вопрос не праздный: у половины небольших проектов её просто нет.
5. Не дублирует ли то, что уже есть. Половина плагинов повторяет функциональность, встроенную в сам инструмент.

Когда плагин не нужен

Чаще, чем кажется.

Правила проекта — это CLAUDE.md, а не плагин. Один файл в корне репозитория, читается автоматически.

Одна инструкция для себя — это скилл. Плагин имеет смысл, когда набор надо отдать команде или выложить.

Доступ к системе — это MCP-сервер. Он может ехать внутри плагина, но может и жить отдельно — так проще отлаживать.

Разовое действие — это просто задача агенту. Оформлять её в команду стоит, когда повторяете третий раз.

Как собрать свой

Порядок, который работает:

1. Начните со скилла. Одна инструкция под одну задачу, обычным текстом. Поработайте с ней неделю — половина замыслов на этом этапе отпадает как ненужные.
2. Соберите папку плагина с манифестом и положите туда скилл. На этом шаге у вас уже рабочий плагин.
3. Добавляйте остальное по мере надобности — команду для явного запуска, агента под отдельную роль, хук для автоматизации.
4. Проверьте на чистом проекте. Плагин, который работает только у автора, — самая частая история.
5. Выложите в маркетплейс, если он полезен не только вам: это обычный git-репозиторий с манифестом.

Главное правило то же, что и со скиллами: описание важнее содержимого. Агент решает, применять ли скилл, по его описанию — расплывчатое описание означает, что плагин не сработает ни разу.

Коротко о главном

• Плагин — набор скиллов, команд, агентов, хуков и MCP-серверов в одной установке.
• Для себя начинайте со скилла; плагин нужен, когда набор надо передать команде.
• Ставится из маркетплейса — обычного git-репозитория: /plugin marketplace add, затем /plugin install.
• Внутри может быть исполняемый код: проверяйте автора, содержимое и дату изменений.
• Плагины работают и в GitHub Actions — так подключают официальное ревью пул-реквестов.
• Правила проекта плагином не оформляют: для этого есть CLAUDE.md.

Дальше: скиллы Claude Code, где взять готовые, команды и хуки.