Настройка, которой вы доверяете, стоит гораздо больше, когда на ней работает вся ваша команда. Проблема — в её переносе. Вы строите отличный каталог .claude с навыками, субагентами и хуками, и что дальше? Все копируют файлы между машинами и надеются, что они останутся синхронизированными. Плагины это исправляют. Плагин — это способ Claude Code упаковать настройку и перенести её от одного человека к другому.
Здесь две стороны, и мы разберём обе. Первая — использование плагинов, которые публикуют другие люди. Вторая — упаковка собственных, когда вы построили что-то достойное распространения.
Что такое плагин
Плагин — это один устанавливаемый юнит. Он объединяет всё, чем вы иначе делились бы вручную: навыки, субагентов, конфигурации хуков и MCP-серверов, плюс длинный хвост вроде серверов языкового протокола, фоновых мониторов, тем и среза settings.json. Одна версия, одна установка.
Где живёт плагин, определяет, как вы его устанавливаете. Внутри сессии можно установить напрямую по имени:
```
/plugin install org-name@plugin-name
```
Вот как это выглядит. Claude Code устанавливает его и говорит выполнить /reload-plugins, чтобы применить изменение.
Добавление маркетплейса для вашей команды
Для команды лучший ход — один раз добавить приватный маркетплейс. Маркетплейс — это общий источник, через который разрешаются плагины:
```
/plugin marketplace add your-org/claude-plugins
```
Назовите как хотите. После добавления каждая последующая установка разрешается через него. Вы получаете централизованное обнаружение, отслеживание версий и обновления в одном месте вместо разбросанных по всем ноутбукам.
Что доступно, можно смотреть со вкладки Discover. Она перечисляет плагины на ваших маркетплейсах, чтобы можно было искать и выбирать.
Прочитайте, прежде чем устанавливать
Вот часть, которая важнее всего. Плагин выполняет код на вашей машине с вашими привилегиями. Его хуки срабатывают на каждый подходящий вызов инструмента. Так что если вы устанавливаете плагин ради его навыков, вы также получаете его хуки PreToolUse и Stop, читали вы их или нет.
Подумайте, что это значит. Плагин сообщества мог бы поставлять Stop-хук, который при каждом срабатывании ходит на сетевой эндпоинт, и ничто в вашей конфигурации вас об этом не предупредит. Это не повод избегать плагинов. Это повод сначала посмотреть.
Перед установкой проверьте детали плагина. Claude Code показывает, что он установит, и оценивает стоимость контекста, вместе с прямым предупреждением, что Anthropic не контролирует содержимое сторонних плагинов.
Две вещи, которые стоит знать о том, откуда берутся плагины:
- Форма подачи внутри приложения постит в маркетплейс сообщества после автоматизированного ревью Anthropic.
- Официальный маркетплейс курируется на отдельном собственном треке.
Но проверенное — не то же самое, что заслуживающее доверия. Автоматизированное ревью ловит кое-что, но не всё. Так что правило в силе: устанавливайте плагины и добавляйте маркетплейсы только из источников, которым действительно доверяете, и проверяйте, что плагин реально делает, прежде чем его включать.
Компоненты работают рядом с вашими
Плагин не перезаписывает вашу конфигурацию. Его компоненты работают рядом с вашими собственными. Это в основном хорошо, но у этого есть последствия, которые стоит понимать.
Хуки складываются. Хук PreToolUse плагина и ваш собственный хук PreToolUse срабатывают на каждый вызов инструмента. Ни один не заменяет другой. Именно поэтому сначала читайте детали.
Навыки, агенты и команды изолированы в пространстве имён под именем плагина, так что они никогда не конфликтуют с вашими. Плагин также может поставлять файл settings.json, но только узкий. Claude Code учитывает из него лишь два ключа: ключи строки состояния агента и субагента.
Этот ключ агента стоит паузы. Его установка продвигает одного из субагентов плагина в главный поток вместе с его системным промптом, ограничениями инструментов и моделью. Другими словами, включение плагина может изменить поведение Claude Code по умолчанию. Это одна из главных причин смотреть, прежде чем вообще включать.
Когда плагин установлен, всё, что он добавил, можно увидеть, управлять этим и удалить это из панели плагинов.
Упаковка собственного плагина
Теперь другая сторона. Когда вы построили каталог .claude, который работает, не заставляйте команду копировать его между машинами. Упакуйте его.
Хорошая новость — ничего перестраивать не нужно. Плагин использует ту же форму .claude, которую вы уже используете:
- Одна папка на навык.
- Один markdown-файл на субагента в agents.
- hooks/hooks.json и .mcp.json в корне плагина.
Структура каталогов делает большую часть работы. Claude Code обнаруживает компоненты по соглашению.
Манифест
Поверх этого есть необязательный манифест. Он живёт в .claude-plugin/plugin.json и держит имя, версию, описание и автора:
```
{
"name": "svg-splitter-review",
"version": "0.1.0",
"description": "Reviews the SVG Splitter repo",
"author": {
"name": "Lewis Menelaws"
}
}
```
Манифест необязателен. Опустите его, и Claude Code всё равно обнаружит ваши компоненты по соглашению о каталогах. Но пара деталей, которые стоит знать:
- Name — единственное обязательное поле. Оно изолирует ваши навыки в пространстве имён как company-name:skill-name, что удерживает их от коллизий с чужими.
- Версионируйте как любую другую зависимость. Именно это обеспечивает обновления и отслеживание версий в вашей команде.
Вывод
Двумя простыми правилами покрывается большая часть этого:
- Когда используете плагины, читайте перед установкой. Плагин выполняет код с вашими привилегиями, так что сначала смотрите на его хуки, агенты и MCP-серверы.
- Когда строите свой, упакуйте свой .claude в тот момент, когда он заработал. Один манифест, одна установка.
В этом весь смысл. Один устанавливаемый юнит — и настройка, которой вы доверяете, доходит до всей вашей команды.