Почему это важно именно вам
У вас накопились скиллы, агенты и хуки. Они лежат в вашей папке и работают только у вас. Коллега просит «поделись» — вы отправляете архив, он раскладывает файлы руками, через месяц у вас разные версии, и никто не знает, чья правильная.
Плагины решают это. Плагин — самодостаточная папка со скиллами, агентами, хуками и MCP-серверами, которую можно установить одной командой, обновлять версиями и раздавать через каталог.
Вторая сторона медали приятнее: вам не всё нужно писать самому. Готовые плагины закрывают типовые задачи — от проверки безопасности до интеграций.
Что это такое
Два способа хранить свои расширения:
| Способ | Как называется команда | Для чего |
|---|---|---|
Обычные файлы в .claude/ |
/привет |
Личные наработки, эксперименты, специфика проекта |
| Плагин | /имя-плагина:привет |
Передача коллегам, версии, использование в разных проектах |
Разумный путь: начинать в .claude/, а когда наработка устоялась и понадобилась другим — оформлять плагином.
Плагин — папка со скиллами, субагентами, хуками и MCP-серверами (а также LSP-серверами, фоновыми мониторами и настройками по умолчанию). Манифест .claude-plugin/plugin.json не обязателен, если всё лежит по стандартным путям, но для раздачи через каталог его лучше завести. Ставится насовсем — из каталога; папку или архив можно подцепить на одну сессию флагами.
Как работает на практике
Посмотреть, что установлено
/plugin list
Показывает установленные плагины прямо в диалоге.
Поставить готовый
Официальный каталог Anthropic подключается сам при первом запуске. Посмотреть, что там есть: /plugin → вкладка Discover. Установить:
/plugin install github@claude-plugins-official
Каталог сообщества добавляют вручную (/plugin marketplace add anthropics/claude-plugins-community), организация может держать свой — с внутренними стандартами команды.
Полезные примеры: security-guidance — проверяет каждое изменение Claude на уязвимости по ходу работы; claude-security — многоагентное сканирование репозитория с превращением находок в исправления. Отдельная категория — плагины code intelligence (typescript-lsp, pyright-lsp и другие): они дают Claude мгновенные ошибки типов после правок.
Попробовать без установки
claude --plugin-dir ~/мой-плагин
claude --plugin-url https://example.com/plugin.zip
Первый вариант подключает папку с плагином на время сессии — удобно при разработке своего. Второй загружает архив по ссылке.
Собрать свой
Минимальный набор:
мой-плагин/
├── .claude-plugin/
│ └── plugin.json ← манифест: имя, версия, описание
├── skills/
│ └── свод/SKILL.md
├── agents/
│ └── проверяльщик.md
└── hooks/
└── hooks.json
Дальше плагин можно положить в репозиторий и подключить как каталог — коллеги ставят его командой, а обновления получают вместе с новой версией.
Зачем это директору
Прямая польза: ваши стандарты перестают быть вашими личными. Скилл проверки договора, агент подготовки отчёта, хук уведомления о важных действиях — упакованы вместе и одинаково работают у всех, кто их поставил. Это ровно та разница между «я умею» и «в компании принято».
Плагин — это чужой код в вашей системе
Плагин может содержать хуки (выполняются автоматически) и MCP-серверы (получают доступ к данным). Ставьте только из источников, которым доверяете: официальные каталоги, репозитории вашей компании, авторы, которых вы знаете. Перед установкой стоит посмотреть, какие хуки и серверы внутри.
Частые ошибки
Ставить всё подряд «на посмотреть». Каждый плагин добавляет команды, а MCP-серверы внутри — расход контекста. Через месяц вы не помните, что и зачем стоит; здесь помогает /plugin → вкладка Installed и раздел Not used recently — там лежат плагины, которых вы не касались две недели.
Упаковывать в плагин сырую наработку. Плагин имеет версии и распространяется. Сначала доведите до ума в .claude/, потом упаковывайте.
Забывать про имена команд. У плагина команды называются с префиксом: /мой-плагин:свод. Это спасает от конфликтов, но об этом надо помнить.
Не проверять, что внутри. Особенно у плагинов с хуками: они выполняются автоматически, без вашего явного вызова.
Держать корпоративный плагин без владельца. Если плагином пользуются пятеро, а поддерживает никто — через полгода он сломается на новой версии и все вернутся к ручной работе.
Когда нужно / когда нет
Плагин оправдан:
- наработкой пользуется больше одного человека;
- нужны версии и обновления;
- одно и то же нужно в разных проектах.
Достаточно .claude/:
- личные привычки и эксперименты;
- специфика конкретного проекта;
- то, что вы ещё активно меняете.
Связь с другими уроками
День 81 — скиллы. Основное содержимое плагинов.
День 22–29 — агенты и День 41–50 — hooks. Всё это тоже упаковывается в плагин.
День 89 — безопасность. Плагины проверки безопасности — как раз оттуда.
Задание на сегодня
- Выполните
/plugin listи посмотрите, что у вас уже установлено; загляните в/plugin→ Installed → Not used recently. - Найдите один готовый плагин, закрывающий вашу реальную задачу, и поставьте его.
- Возьмите свою устоявшуюся наработку (скилл или агента) и соберите из неё плагин с манифестом.
- Проверьте его локально через
--plugin-dir. - Решите, кому в команде он нужен, и подумайте, кто будет его поддерживать.
Критерий «выполнено»: у вас есть собственный плагин, который запускается через --plugin-dir, и понимание, кто его владелец.
Резюме
- Плагин — самодостаточная папка с манифестом
.claude-plugin/plugin.json, содержащая скиллы, агентов, хуки и MCP-серверы. - Команды плагина вызываются с префиксом:
/имя-плагина:команда. - Начинайте в
.claude/, упаковывайте в плагин, когда наработка устоялась и нужна другим. /plugin listпоказывает установленное;--plugin-dirи--plugin-urlподключают плагин на сессию.- Плагин — чужой код с хуками и MCP-серверами: ставьте только из доверенных источников и смотрите, что внутри.
- У корпоративного плагина должен быть владелец, иначе он тихо умрёт на следующем обновлении.