Плагіни Claude Code: що це і скільки коштують

Що таке плагін Claude Code

Плагін Claude Code — це один каталог компонентів, які Claude Code завантажує та керує ними як єдиним цілим. До цих компонентів належать skills, agents, hooks, MCP servers, LSP servers і background monitors. Інсталяція плагіна додає всі його компоненти одночасно під одним ім’ям, а вимкнення так само видаляє їх.

Плагін не надає агенту жодних можливостей, яких він уже не мав. Кожен компонент усередині плагіна можна створити вручну в каталозі .claude/. Плагін є рівнем пакування: він дає змогу версіонувати ці компоненти, передавати їх п’ятнадцяти людям і згодом оновлювати без необхідності просити кожного копіювати файли. У цьому полягає вся ідея. Більшість непорозумінь щодо плагінів виникає через очікування, що вони є новим типом можливостей.

Необов’язковий маніфест у .claude-plugin/plugin.json визначає ім’я плагіна, і це ім’я стає простором імен. Skill у плагіні з назвою commit-commands викликається як /commit-commands:commit, тому два плагіни можуть постачати skill з назвою commit, не створюючи конфлікту між ними. Agents плагіна так само мають власний простір імен у списку @-mention, наприклад plugin-name:agent-name.

Плагін, skill, MCP server або файл правил

Ці чотири терміни часто вживають так, ніби вони конкурують між собою. Це не так, і цю межу варто чітко визначити один раз.

• Skill — це окрема інструкція, яку Claude завантажує, коли завдання цього потребує. Див. що насправді таке Agent Skill.
• MCP server — це окремий процес, який надає агенту інструменти через протокол. Часто це мережевий сервіс, який ви запускаєте самостійно.
• Файл правил, наприклад CLAUDE.md, — це контекст проєкту, який зчитується на початку сеансу та застосовується до всього сеансу.
• Плагін — це контейнер, який може об’єднувати skills, agents, hooks і визначення MCP servers, а також містити номер версії та канал розповсюдження.

Отже, плагін відповідає не на запитання «що може робити агент», а на запитання «як передати це команді та оновити наступного місяця». Якщо ви обираєте між першими трьома варіантами, у порівнянні skills, MCP servers і файлів правил це рішення розглянуто докладно. Якщо вас цікавить саме MCP, у матеріалі як запускати власні MCP servers на VPS описано розміщення та адміністрування.

Де зберігаються плагіни та що містить один плагін

Плагін, інстальований із marketplace, копіюється в локальний кеш за шляхом ~/.claude/plugins/cache, а не запускається з каталогу, у який його клонували. Кожна інстальована версія має власний каталог. Після оновлення або видалення старий каталог версії позначається як orphaned і видаляється приблизно через два тижні. Тому сеанс, який уже завантажив стару версію, продовжує працювати й не завершується з помилкою посеред виконання завдання.

Оскільки шлях змінюється під час кожного оновлення, плагін не повинен жорстко задавати власне розташування. Hooks і конфігурації MCP усередині плагіна використовують ${CLAUDE_PLUGIN_ROOT}, яке розгортається в поточний каталог інсталяції. Дані стану, які мають зберігатися після оновлення, потрібно розміщувати в ${CLAUDE_PLUGIN_DATA}, яке розгортається у стабільний каталог під ~/.claude/plugins/data/.

У кеш копіюється лише власний каталог плагіна. Це може спричинити проблему, яку часто виявляють лише наприкінці. Шлях за межами кореневого каталогу плагіна, наприклад ../shared-utils, працює під час розробки з локальним шляхом і перестає працювати після інсталяції, оскільки ці файли не було скопійовано.

Структура має такий вигляд.

my-plugin/
├── .claude-plugin/
│   └── plugin.json
├── skills/
│   └── code-review/
│       └── SKILL.md
├── agents/
├── hooks/
│   └── hooks.json
├── .mcp.json
└── bin/

Лише plugin.json розміщується всередині .claude-plugin/. Усе інше міститься в кореневому каталозі плагіна. Розміщення skills/ або hooks/ всередині .claude-plugin/ — найпоширеніша причина, через яку плагін успішно інсталюється, але потім узагалі нічого не робить: Claude Code шукає ці каталоги в корені, не знаходить їх і завантажує плагін без компонентів.

Сам manifest невеликий.

{
  "name": "my-first-plugin",
  "description": "A greeting plugin to learn the basics",
  "version": "1.0.0"
}

Як встановити плагін Claude Code

Установлення складається з двох кроків, і перший нічого не встановлює. Ви додаєте marketplace — каталог плагінів, — а потім установлюєте з нього окремі плагіни. Офіційний marketplace Anthropic, claude-plugins-official, реєструється автоматично під час першого інтерактивного запуску Claude Code. Інші marketplace потрібно додавати самостійно.

/plugin marketplace add anthropics/claude-code
/plugin install commit-commands@claude-code-plugins

Зверніть увагу: репозиторій має назву anthropics/claude-code, а marketplace — claude-code-plugins. Назва marketplace береться з файла каталогу всередині репозиторію, а не зі шляху до репозиторію. Тому перед введенням команди встановлення прочитайте назву marketplace на вкладці Marketplaces у /plugin.

Після встановлення прочитайте підсумковий рядок. Plugin is now active. означає, що компоненти завантажено в поточному сеансі. Run /reload-plugins to activate. означає, що їх не завантажено, і потрібно виконати цю команду. Якщо /reload-plugins попереджає, що повторно прочитає розмову, виконайте її ще раз як /reload-plugins --force. Потім переконайтеся, що плагін справді доступний: /plugin показує його на вкладці Installed, /help перелічує його skills у Custom commands, а все, що не вдалося завантажити, відображається на вкладці Errors із зазначенням причини.

Під час встановлення потрібно вибрати scope. Scope визначає, хто матиме доступ до плагіна. User scope — це ви в усіх проєктах. Project scope записує плагін у .claude/settings.json репозиторію в каталозі enabledPlugins, тому його буде запропоновано всім, хто клонує репозиторій. Local scope — це ви, але лише в цьому репозиторії.

Для скрипта, Dockerfile або будь-якого сеансу, у якому немає інтерактивної панелі, використовуйте shell-форму. За замовчуванням вона встановлює плагін у user scope, якщо не передати --scope.

claude plugin install commit-commands@claude-code-plugins --scope project
claude plugin list

claude plugin install виконується поза сеансом, тому вже відкритий сеанс не побачить новий плагін, доки ви не виконаєте /reload-plugins або не запустите новий сеанс.

Керування встановленими плагінами працює однаково в обох варіантах. /plugin list виводить список установлених плагінів і приймає --enabled або --disabled. /plugin disable name@marketplace вимикає плагін без його видалення, /plugin enable знову вмикає його, а /plugin uninstall видаляє. Форми slash-команд відкривають панель плагінів для застосування зміни. Саме тому в скриптах слід використовувати еквіваленти claude plugin ... для shell.

Щоб передати marketplace всій команді, додайте його до .claude/settings.json проєкту. Учасникам буде запропоновано встановити його після того, як вони довірять каталогу репозиторію.

{
  "extraKnownMarketplaces": {
    "my-team-tools": {
      "source": {
        "source": "github",
        "repo": "your-org/claude-plugins"
      }
    }
  }
}

Поки ви розробляєте власний плагін, не використовуйте marketplace. claude --plugin-dir ./my-plugin завантажує каталог для поточного сеансу, /reload-plugins підхоплює зміни без перезапуску, а claude plugin validate ./my-plugin перевіряє manifest, frontmatter skills і agents, а також hooks/hooks.json, перш ніж плагін побачать інші користувачі.

Скільки коштує плагін Claude Code?

Сам механізм безкоштовний. Станом на August 2026 немає плати за додавання marketplace, встановлення плагіна або його увімкнення. Офіційні та спільнотні marketplace є публічними git-репозиторіями, а плагін — це каталог текстових файлів.

Плагін коштує токенів, а саме токени фактично враховуються у використанні вашої підписки або рахунку за API. Ці витрати виникають трьома різними способами, і кожен із них працює по-своєму.

Постійні витрати контексту. Усе, що додає плагін, потрапляє в контекст і перечитується на кожному ході сесії. Перед встановленням у поданні докладної інформації /plugin показано оцінку Context cost у токенах і розділ Will install зі списком команд, навичок, агентів, хуків, а також MCP- і LSP-серверів, які ви збираєтеся додати. Перегляньте обидва. Плагіни з локальних або власних marketplace можуть не надавати ці дані. У такому разі оцінку доведеться виконати вручну. Плагін із вбудованим MCP-сервером зазвичай є найважчим, оскільки визначення інструментів мають великий обсяг. Однак у моделях із підтримкою пошуку MCP-інструментів ці визначення відкладаються до моменту, коли інструмент стає потрібним.

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

Витрати кешу. Увімкнення або вимкнення плагіна під час сесії може змусити наступний запит повторно обробити весь ваш діалог. Навички, команди, агенти, хуки, LSP-сервери, монітори та теми цього не роблять: доданий ними вміст дописується після наявної історії, тому наступний запит оплачує новий вміст, а весь попередній читає з кешу. Винятком є плагін, який надає MCP-сервер. Якщо його інструменти відкладені через пошук інструментів, кеш зберігається. Якщо вони завантажуються в префікс промпту, наступний запит повторно читає весь діалог як вхідні дані без кешу. Саме тому /reload-plugins у такому випадку показує попередження та відмовляється продовжувати, доки ви не передасте --force.

Це можна контролювати, а не вгадувати. Кожна відповідь API містить cache_read_input_tokens і cache_creation_input_tokens, а власний statusline із поточним використанням токенів показує обидва значення безпосередньо перед вами. У нормальній сесії обсяг прочитаного значно перевищує обсяг створеного. Якщо створений обсяг залишається високим хід за ходом, щось у вашому префіксі змінюється на кожному ході. Щоб отримати ширше уявлення про те, що заповнює вікно, див. як керувати вікном контексту Claude Code і що насправді означають ці підрахунки токенів.

Одна проста операція з обслуговування швидко окупається. На вкладці Installed плагіни, якими ви не користувалися щонайменше два тижні, згруповано під заголовком Not used recently. У поданні докладної інформації для них показано рядок Last used. Ці плагіни й надалі збільшують час запуску та обсяг контексту в кожній сесії. Вимкніть або видаліть їх.

Плагін працює з вашими правами

У власній документації Anthropic прямо зазначає: плагіни та marketplace — це компоненти з високим рівнем довіри, які можуть виконувати довільний код на вашому комп’ютері з правами вашого користувача. Це не гіпотетичний ризик. Хуки плагіна виконують shell-команди під час подій сесії, зокрема до та після викликів інструментів. Його каталог bin/ додається до PATH інструмента Bash, доки плагін увімкнено. Його MCP-сервери є процесами, які він запускає. Ніщо з цього не ізольовано від облікового запису вашого користувача.

На ноутбуці цей ризик обмежений ресурсами, до яких має доступ ваш користувач робочого столу. На сервері зазвичай це не так. Обліковий запис, від імені якого працює агент, часто має SSH-ключі, deploy-токени, активну сесію cloud CLI і доступ до Docker socket, тому «довільний код із правами вашого користувача» фактично означає доступ до всієї машини. Якщо Claude Code працює на VPS, прочитайте як безпечно запускати Claude Code на VPS перед встановленням будь-чого, а перед встановленням плагіна, який взаємодіє із зовнішнім сервісом, прочитайте як не допустити доступу агента до облікових даних.

Певні запобіжні механізми існують, і важливо розуміти, які саме. Плагін із project scope надходить із репозиторію, а не від вас, тому завантажується лише після того, як ви довірите робочому простору; його MCP-сервери все одно потребують окремого дозволу для кожного сервера, його LSP-сервери очікують на підтвердження довіри, а його фонові монітори взагалі не завантажуються. Агентам, які постачаються з плагінами, заборонено оголошувати хуки, MCP-сервери або режим дозволів. Плагіни з marketplace копіюються в кеш, а символічні посилання за межі marketplace пропускаються, тому плагін не може підключати довільні файли хоста.

Це не скасовує потреби перевіряти все, що ви встановлюєте. Перегляньте список Will install, надавайте перевагу плагінам, вихідний код яких можна відкрити й прочитати, зберігайте плагіни команди в репозиторії marketplace під вашим контролем і запускайте claude plugin validate для всього, що пишете самостійно.

FAQ

Чи потребують плагіни Claude Code додаткової оплати?

Ні. За систему плагінів, додавання marketplace або встановлення плагіна плата не стягується. Оплачується використання токенів відповідно до вашого плану або витрат API, як і будь-який інший контекст. Плагін додає постійний контекст у кожному ході, додає більше контексту під час виклику однієї з його skills або agents і може спричинити один дорогий хід без кешування, якщо він надає MCP server, інструменти якого завантажуються в префікс prompt. У поданні з докладною інформацією /plugin показується оцінка Context cost перед встановленням.

У чому різниця між плагіном і skill?

Skill — це окрема інструкція. Плагін — це пакет, який може містити skills, agents, hooks, MCP servers, LSP servers і monitors, а також має ім’я, версію та marketplace, з якого його можна встановити. Створюйте автономний skill у .claude/, якщо він призначений для вас і цього проєкту. Skill для однієї конкретної задачі, як-от Ponytail, який спрямовує agent до найменшої працездатної зміни, є найочевиднішим прикладом: один файл з одним правилом у ньому — доти, доки він не знадобиться вашій команді. Перетворюйте його на плагін, коли він потрібен іншим людям і має оновлюватися з часом. Skills плагіна мають простір імен, тому skill усередині плагіна викликається як /plugin-name:skill-name, а не як /skill-name.

Плагін установився, але його skills не відображаються. У чому проблема?

Спочатку перевірте підсумок встановлення. Якщо там зазначено Run /reload-plugins to activate., компоненти ще не завантажені. Якщо під час перезавантаження з’являється попередження про повторне читання розмови, виконайте його як /reload-plugins --force. Якщо плагін завантажився, але нічого не відображається, відкрийте /plugin і перегляньте вкладку Errors. Найпоширеніша структурна помилка — розміщення skills/, agents/ або hooks/ усередині .claude-plugin/, де Claude Code їх не шукає. Пам’ятайте, що skills плагіна мають простір імен. Тому у вкладці Custom commands вікна /help потрібно шукати /plugin-name:skill-name. У крайньому разі виконайте rm -rf ~/.claude/plugins/cache, перезапустіть програму та встановіть плагін повторно.

Чи можна встановлювати плагіни без інтерактивної панелі?

Так. Використовуйте команду оболонки claude plugin install name@marketplace. Вона встановлює плагін у користувацьку область, якщо не передати --scope project або --scope local. Команда працює у скриптах, образах і неінтерактивних середовищах, де панель /plugin недоступна. Оскільки команда виконується поза сесією, уже відкрита сесія потребує /reload-plugins, перш ніж зміни плагіна набудуть чинності.

Чи безпечно встановлювати плагін із marketplace, який я знайшов на GitHub?

Ставтеся до цього так само, як до запуску install script цього репозиторію від імені свого користувача, оскільки фактично це майже те саме. Плагін може виконувати команди оболонки через hooks, додавати виконувані файли до PATH інструмента Bash і запускати MCP servers — усе з привілеями вашого користувача. Anthropic не контролює та не перевіряє вміст сторонніх плагінів. Встановлюйте плагіни лише з джерел, код яких можна прочитати, перевіряйте список Will install перед підтвердженням і будьте обережнішими на сервері, ніж на ноутбуці, оскільки обліковий запис на сервері зазвичай має ключі й токени, які можуть викрасти.