Як вибирати і безпечно підключати плагін

Один 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 нагадає про те, чим не користувалися.

Скриню з тавром придумали, щоб віддавати процедури цілком і без пересилок, і це працює в обидва боки. Той, хто скриню отримує, дивиться на тавро, відкриває кришку і ставить на верстак тільки те, що сьогодні потрібно.

Панель плагінів і текст її повідомлень змінюються від версії до версії; якщо ваш екран відрізняється від описаного, орієнтуйтеся на зміст рядків, а не на їхній точний вигляд.