Плагіни 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, не перекриваючи один одного. Для агентів плагінів діє така сама область видимості у списку @-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 описано розміщення такого сервера.

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

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

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

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

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

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

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

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

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

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

Встановлення складається з 2 кроків, і перший із них нічого не встановлює. Спочатку потрібно додати 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, який визначає, хто матиме доступ до плагіна. 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-команд відкривають панель плагінів для застосування зміни, тому в скриптах слід використовувати shell-еквіваленти claude plugin ....

Щоб передати 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. Те, на що припадають ці витрати, залежить від способу оплати інструмента. У матеріалі про вартість Claude Code для кожного плану наведено рівні підписки та ціни API за токени. Витрати виникають трьома різними способами, і кожен із них працює по-своєму.

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

Витрати під час виклику. Запуск skill плагіна додає його інструкції до діалогу, тому тіло skill оплачується лише під час використання. Однак тіло є дешевою частиною. Дії, які skill доручає агенту, можуть коштувати значно більше: метод Depth Tree у skill unlazy витрачає майже всі токени на додаткові проходи, які він вимагає виконати до того, як агент зможе позначити завдання як виконане, а не на встановлений вами файл. Агент працює інакше. Subagent веде власний діалог із власним системним промптом і власним cache, починаючи без cache hits. Тому плагін, чий workflow запускає агентів, може коштувати значно більше, ніж передбачає його оцінка контексту.

Витрати на cache. Увімкнення або вимкнення плагіна посеред сесії може змусити наступний запит повторно обробити весь діалог. Skills, commands, agents, hooks, LSP servers, monitors і themes цього не роблять: доданий ними вміст дописується після наявної історії, тому наступний запит оплачує новий вміст, а весь попередній читає з cache. Винятком є плагін, який надає MCP-сервер. Якщо його інструменти відкладаються через tool search, cache зберігається. Якщо вони завантажуються в prompt prefix, наступний запит перечитує весь діалог як uncached input. Саме тому /reload-plugins у такому випадку показує попередження й відмовляється продовжувати, доки ви не передасте --force.

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

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

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

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

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

Певні захисні механізми існують, і важливо розуміти, які саме. Плагін із project scope надходить із репозиторію, а не від вас, тому завантажується лише після того, як ви довірите workspace. Його MCP-сервери все одно потребують окремого дозволу для кожного сервера. Його LSP-сервери очікують на підтвердження цієї довіри, а його фонові монітори взагалі не завантажуються. Agents, що постачаються разом із плагіном, не можуть оголошувати hooks, MCP-сервери або permission mode. Плагіни з marketplace копіюються в cache, а symlinks, які вказують за межі marketplace, пропускаються. Тому плагін не може підключити довільні файли з host.

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

FAQ

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

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

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

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

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

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

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

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

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

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