Как выбирать и безопасно подключать плагин

Один skill сделал страницу заметно лучше, и следующий шаг напрашивается сам: поставить не один, а десять сразу. Тут же коллега присылает ссылку: "поставь, полезная штука". Ставится всё это одной командой, и в этом ловушка. Плагин выглядит как список умений, а на деле это код, который будет работать у вас на машине с вашими правами и занимать место в каждом разговоре с агентом.

Разберём, чем плагин отличается от skill и что в нём может лежать, откуда берутся каталоги и как отличить надёжный источник от случайного, что Claude Code показывает до установки и как это читать. Потом пройдём весь путь: поставить, проверить на своей задаче, выключить, удалить. В конце - что делать перед каждой установкой, и почему то же самое стоит делать с любым skill, который агент принёс из интернета.

1. Skill и plugin

У столяра есть записанные процедуры: как готовить верстак, как точить, как гнать серию по шаблону. Пока он работает один, они лежат у него в тетради. Потом одну просит сосед по цеху, другую подмастерье, а через месяц звонит мастерская через дорогу, и пересылать каждому по листку надоедает. Тогда он складывает несколько процедур в ящик, ставит на бок клеймо мастерской и кладёт внутрь записку: что здесь и как этим пользоваться. Такой ящик можно отдать целиком, обновить и пронумеровать.

Это и есть плагин. Не ещё одно умение, а упаковка вокруг нескольких.

Сам по себе плагин не отдельное умение, а способ раздать несколько. Всё, что он может, он может через то, что внутри: умения, помощников, автоматические реакции, подключения. Поэтому вопрос "что плагин умеет" всегда сводится к другому: что внутри.

Свой плагин собирают, когда ваши skills начинают просить другие. Если сомневаетесь, что именно вам нужно - skill, помощник с отдельной ролью или плагин, - спросите агента, но попросите его сначала задать вопросы, а не собирать сразу: он соберёт черновик, а что внутри, проверяете вы. Ориентир простой: повторяете одну и ту же просьбу - skill; побочная работа засоряет разговор - помощник; тот же набор нужен в другом проекте - плагин. Как собирается плагин по шагам - отдельный разговор. Эта статья про тех, кто ящик получает.

2. Что лежит внутри плагина

Чаще всего отделений в ящике пять, и не все они одинаково безобидны.

• skills - процедуры, которые агент применяет сам по описанию или по вашей команде;
• agents - помощники с отдельной ролью, которым агент поручает часть работы;
• hooks - автоматические реакции на события: запускают команды без вашей просьбы, когда что-то произошло;
• MCP servers - подключения к внешним сервисам, через них агент читает и меняет что-то за пределами вашего компьютера;
• LSP servers - подсказки по коду для конкретного языка; им нужна отдельно установленная программа.

Два нижних отделения - причина, по которой ящик принимают, а не бросают в угол. Плагин с hooks и MCP умеет то, чего от "набора умений" не ждёшь: запускать команды и ходить во внешние сервисы. Внутри живой инструмент под напряжением, а не плакат на стену. Что такое hooks, MCP и agents по отдельности - отдельные разговоры; здесь достаточно знать, что они значат в составе. Бывают отделения и кроме этих пяти, например настройки по умолчанию или стиль ответов агента, но картину они не меняют.

Если карточки под рукой нет, попросите агента открыть репозиторий плагина и пересказать, что лежит в его папках.

3. Имя с префиксом

Skills из плагина называются с префиксом: /имя-плагина:имя-skill, например /commit-commands:commit. У соседа тоже может быть "уборка", и пока на ящике клеймо, их не спутать.

Цена - длинное имя: за общий набор платят тем, что команду набирать дольше. У своего skill в папке проекта префикса нет.

Есть и польза. По префиксу в меню по / всегда видно, откуда пришла команда и чей это ящик.

4. Каталог и два шага

Ящики берут со склада. Каталог плагинов, по-английски marketplace, - это список чужих плагинов, который кто-то ведёт. Работа с ним в два шага: подключить каталог, потом ставить из него плагины по одному. Само подключение каталога ничего не устанавливает, вы только получаете список.

Первый шаг для большинства уже сделан. Команда /plugin открывает панель с четырьмя вкладками: Discover - искать плагины во всех подключённых каталогах; Installed - то, что стоит; Marketplaces - каталоги; Errors - ошибки загрузки. Официальный каталог Anthropic подключён с первого запуска, и во вкладке Discover его плагины видны сразу: выбрать, открыть, поставить. Тот же список есть на сайте claude.com/plugins, если хочется посмотреть без Claude Code.

Второй каталог появляется, когда нужного плагина в официальном нет: каталог сообщества или чужой репозиторий, в котором лежит файл каталога. Подключается он одной командой, плагин из него ставится тоже одной:

/plugin marketplace add anthropics/claude-plugins-community   # подключить каталог сообщества
/plugin install имя-плагина@claude-community                  # поставить один плагин из него
/plugin list                                                  # проверить, что плагин в списке

Чужой каталог подключается той же первой командой, только с его адресом.

Одна тонкость, на которой спотыкаются чаще всего (и я не исключение). Имя каталога для установки берётся не из имени репозитория, а из описания самого каталога: репозиторий называется anthropics/claude-plugins-community, а ставят из claude-community. Какое имя у каталога, видно во вкладке Marketplaces.

В официальном каталоге лежат плагины разных типов. Интеграция с GitHub - это MCP, подключение к внешнему сервису. Подсказки по коду для языка, скажем typescript-lsp, - это LSP. security-guidance проверяет каждое изменение агента на типовые уязвимости.

5. Три ступени доверия к источнику

Из папки плагин не подхватится сам: его нужно поставить явно, и это не бюрократия. Внутри код, который выполнится с вашими правами, то есть сможет всё то же, что и вы за этим компьютером. Поэтому первый вопрос про любой плагин - не "что он умеет", а "откуда он".

Официальный каталог. Его ведёт Anthropic, но большая часть плагинов в нём от партнёров и других авторов, а не от самой Anthropic. Внимания тут нужно меньше, чем к чужому репозиторию, но описание и состав всё равно стоит прочитать.

Каталог сообщества. Сторонние плагины, прошедшие автоматическую проверку Anthropic; почти каждый закреплён за конкретной версией в каталоге. Это фильтр, а не гарантия: что плагин делает ровно то, что обещает, никто не проверял.

Произвольный репозиторий или папка. Никакой проверки. Вы сами смотрите, кто автор, есть ли внятное описание и что лежит в папках.

В одной рабочей сессии могут встретиться все три ступени: дизайн-плагин из каталога сообщества, ещё один из каталога Anthropic, третий из чужого репозитория с единственным плагином внутри. Это нормально, если вы понимаете, на какой ступени стоите в каждый момент.

Мера - по плагину. Чем больше он умеет, то есть чем больше в нём hooks и MCP, и чем дальше источник от официального, тем внимательнее смотрите.

6. Что Claude Code показывает до установки

Источник задаёт, насколько внимательно смотреть. Детали Claude Code показывает сам: откройте плагин из вкладки Marketplaces панели /plugin или командой /plugin install имя@каталог, и вы увидите его карточку. Карточка из списка Discover короче: оценки цены в ней нет.

В ней три строки, ради которых всё и затевалось. Две последние есть только у плагинов официального каталога.

• Will install - состав: сколько skills, agents, hooks, MCP и LSP приедет;
• Context cost - сколько плагин добавит в окно агента: Every turn - на каждом вашем запросе, When invoked - когда агент загрузит его skills и agents;
• Last updated - когда плагин обновлялся.

Will install:  skills: 8   agents: 1   hooks: 2   MCP servers: 1
Context cost:  Every turn: ~400 tokens   When invoked: ~1.5k tokens
Last updated:  2 weeks ago

Числа и вид строк условные, у каждого плагина и версии Claude Code свои. Читать состав просто, но это первое приближение: если внутри только skills, плагин, скорее всего, читает и подсказывает; есть hooks или MCP - он запускает команды или ходит наружу, и это повод открыть описание и понять, какие именно. Карточка показывает не всё: плагин может принести ещё исполняемые файлы и настройки по умолчанию, которых в ней нет. Для незнакомого источника загляните и в репозиторий.

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

7. Кому достанется плагин

Кому достанется ящик, решают заранее, при установке. Вариантов три.

• user - вам, во всех проектах;
• project - всем, кто работает с этим репозиторием: запись уходит в .claude/settings.json и едет вместе с проектом;
• local - вам и только в этом проекте, коллегам не видно.

Есть ещё managed: его ставит администратор, и менять его нельзя. У большинства он не встретится.

Правило одно: самый узкий подходящий scope. Меньше мест, где плагин включён, - меньше ситуаций, в которых он вообще запускается, и меньше того, что потом убирать. Сомнительный плагин узким scope не обезвреживается: там, где он включён, он может всё то же самое. Project scope стоит отдельного слова: вы решаете не только за себя. У коллеги, открывшего репозиторий, плагин окажется включён, но не установлен: во вкладке Errors панели /plugin появится предупреждение, а поставить плагин он должен сам.

При установке из панели scope спрашивается; /plugin install тоже открывает карточку с выбором.

8. Поставить и проверить

Если установка прошла гладко, она заканчивается одной из двух фраз. Либо плагин уже активен, либо просьба запустить /reload-plugins. Во втором случае запускаем; если команда предупредит, что перезагрузка перечитает разговор, повторяем с --force. Перезапускать Claude Code не нужно.

Что плагин встал, видно по /plugin list: он в списке, а его skills появились под префиксом в меню по /.

Открытый ящик занимает верстак. Включённый плагин с первой секунды добавляет в окно агента объявления своих skills: имена и описания. Полное содержимое подтягивается, только когда skill идёт в дело, но объявления висят всегда. У подключений к внешним сервисам сразу приезжают имена инструментов, описания - по мере надобности; автоматические реакции окна почти не занимают. Чем окно полнее, тем дороже и медленнее каждый ответ.

Настоящую цену видно только сравнением: /context показывает, чем занято окно. Запустите до установки и после.

1) без плагина: своя задача, результат запомнить
2) поставить плагин, при необходимости /reload-plugins
3) та же задача снова
4) сравнить и решить: оставить, выключить, удалить

Результата сравнения здесь нет намеренно: он у каждого свой. Критерий простой: вы можете в двух фразах сказать, что плагин делает, и назвать одну причину оставить или убрать - из своего прогона, а не из описания.

9. Выключить, удалить, убрать каталог

Три действия, и они разные. /plugin disable выключает, но не удаляет: плагин перестаёт занимать окно, а вернуть его - /plugin enable. /plugin uninstall убирает совсем. /plugin marketplace remove убирает каталог, и вместе с ним удаляются все плагины, которые из него ставились. Об этом легко забыть.

/plugin disable имя-плагина@каталог      # выключить, но не терять
/plugin uninstall имя-плагина@каталог    # удалить совсем
/plugin marketplace remove каталог       # убрать каталог и всё, что из него ставилось

Команды открывают ту же панель и оставляют её открытой, закрыть - Esc. Во вкладке Installed то же самое делается без команд: проблемные плагины показаны сверху, выключенные свёрнуты внизу. Если удаляете плагин, включённый для всего проекта, Claude Code спросит: только у вас или для всех.

Уборка. Плагины, которые вы ставили сами и не использовали две недели на протяжении десяти сессий, Claude Code собирает во вкладке Installed под заголовком "Not used recently", а в карточке показывает, когда плагин последний раз работал. Отдельно /doctor называет неиспользуемые плагины вместе с их ценой в контексте. набор инструментов остаётся набором, пока вы помните, что в нём и зачем.

Обновления. Официальные каталоги обновляются сами и просят запустить /reload-plugins; сторонние по умолчанию нет. Обновление - почти новая установка: состав может измениться, и карточку стоит открыть заново.

Если что-то сломалось, в том числе при самой установке: вкладка Errors покажет причину. Дальше выключить, переустановить, в крайнем случае очистить кэш плагинов и поставить снова. Если из вкладки Marketplaces пропал официальный каталог, его возвращает /plugin marketplace add anthropics/claude-plugins-official.

10. Не только плагины

Skill, который агент по вашей просьбе скачал из чужого репозитория и положил в папку проекта, - тот же случай, только без каталога, карточки и scope. Проверять его некому, кроме вас.

Вопросы те же. Откуда он. Что внутри: SKILL.md читается за минуту, но проверяют папку целиком - скрипты и файлы, на которые он ссылается, тоже. Какие инструменты он себе разрешает заранее: поле allowed-tools. Оно показывает, что предодобрено без отдельного вопроса, а не полный список того, что может произойти. Skill из репозитория стороннего сервиса вполне может разрешить себе запускать команды, и для skill, который что-то отправляет наружу, это нормально. Но увидеть это стоит до первого запуска, а не после.

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

11. Что делать перед каждой установкой

Шесть шагов, в том порядке, в каком они шли по статье.

1. Источник. Официальный каталог, каталог сообщества или чужой репозиторий - это задаёт, насколько внимательно смотреть дальше.
2. Состав. Карточка "Will install"; hooks и MCP значат команды и выход наружу, для них открыть описание.
3. Цена. "Context cost" в карточке (у официального каталога) и /context до и после: плагин платит из каждого вашего запроса.
4. Scope. Самый узкий подходящий; project scope это решение и за коллег.
5. Пробный прогон. Одна задача до и после, вывод из своего теста, а не из описания.
6. Решение. Оставить, выключить или удалить; через пару недель вкладка Installed напомнит о том, чем не пользовались.

Ящик с клеймом придуман, чтобы отдавать процедуры целиком и без пересылок, и это работает в обе стороны. Тот, кто ящик получает, смотрит на клеймо, открывает крышку и ставит на верстак только то, что сегодня нужно.

Панель плагинов и текст её сообщений меняются от версии к версии; если ваш экран отличается от описанного, ориентируйтесь на смысл строк, а не на их точный вид.