SSD Nodes Learn Hosting plans →
Посібники Matt ConnorВід Matt Connor · Оновлено 2026-11-07

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

Дізнайтеся, де зберігається плагін Claude Code, як його встановити та чому механізм коштує $0, а витрати виникають лише за токени в контексті.

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

Плагін Claude Code — це один каталог компонентів, який Claude Code завантажує та керує ним як єдиним цілим. Основні компоненти — skills, agents, hooks, MCP servers, LSP servers і background monitors. Плагін також може містити commands, output styles, themes, workflows і каталог bin/ із виконуваними файлами. Після встановлення плагіна всі його компоненти додаються одночасно під одним іменем. Після вимкнення вони так само видаляються.

Плагін здебільшого не надає агенту можливостей, яких той уже не мав. Skills, agents, hooks і MCP servers можна створити вручну в каталозі .claude/. Винятками є language servers для code intelligence і моди, які Claude Code завантажує лише з плагіна. Для всього іншого плагін є рівнем пакування: він дає змогу версіонувати ці компоненти, передавати їх п’ятнадцятьом користувачам і згодом оновлювати їх без потреби просити кожного копіювати файли. У цьому полягає основна ідея. Більшість непорозумінь щодо плагінів виникає через очікування, що вони є новим типом можливостей.

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

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

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

  • Skill — це один набір інструкцій, який Claude завантажує, коли цього потребує завдання. Див. що насправді таке Agent Skill.
  • MCP-сервер — це окремий процес, який надає агенту інструменти через протокол. Часто це мережевий сервіс, який ви запускаєте самостійно.
  • Файл правил, наприклад CLAUDE.md, містить контекст проєкту. Він зчитується на початку сеансу й застосовується до всіх операцій.
  • Плагін — це каталог зі skill, агентами, hooks, MCP-серверами або іншими компонентами, який Claude Code встановлює та завантажує як єдине ціле. Його необов’язковий manifest містить назву та може додавати версію, опис й інші метадані. Розповсюдження не є частиною плагіна: marketplace — це окремий каталог, у якому перелічено плагіни та вказано, звідки отримати кожен із них.

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

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

Більшість marketplace plugins копіюються в локальний cache за адресою ~/.claude/plugins/cache. Для кожної встановленої версії створюється окремий каталог. Plugins із відносними шляхами в marketplace, який ви додали з локального шляху, завантажуються без копіювання. Plugins із command source у link mode завантажуються через links до каталогу з вихідним кодом. Коли ви оновлюєте або видаляєте скопійований plugin, каталог старої версії позначається як orphaned і видаляється приблизно через два тижні. Тому session, яка вже завантажила стару версію, продовжує працювати й не завершується з помилкою посеред виконання завдання. Очищення виконується лише доки записано щонайменше одну встановлену plugin. Після видалення останнього plugin orphaned-каталоги залишаються, доки ви не встановите інший plugin.

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

Для скопійованого plugin у cache копіюється лише власний каталог plugin. Виняток становлять symlink targets в іншому місці того самого marketplace: вони копіюються на відповідні місця. Script, який читає шлях за межами кореня plugin, наприклад ../shared-utils, працює під час розробки з локальним шляхом і перестає працювати після копіювання plugin у cache, оскільки ці файли не копіювалися. Шлях компонента, оголошений у такий спосіб у plugin.json, спричиняє помилку раніше. Claude Code відхиляє будь-який шлях компонента, який виходить за межі кореня plugin, навіть під час розробки, із помилкою path escapes plugin directory.

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

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, якщо цьому не перешкоджають керована політика або CLAUDE_CODE_DISABLE_OFFICIAL_MARKETPLACE_AUTOINSTALL. Інші marketplace потрібно додавати самостійно.

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

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

Після встановлення прочитайте рядок підсумку. Plugin is now active. означає, що компоненти завантажено в поточному сеансі. Run /reload-plugins to apply. означає, що під час встановлення їх не було активовано; панель закривається, а Claude Code сам виконує перезавантаження. Якщо під час перезавантаження з’являється попередження про повторне читання розмови, плагін залишається в стані очікування, і команду потрібно повторно виконати як /reload-plugins --force. Потім переконайтеся, що плагін справді доступний: /plugin показує його на вкладці Installed, введення / виводить його навички як /plugin-name:skill-name, а все, що не вдалося завантажити, відображається на вкладці Errors із зазначенням причини.

Під час встановлення потрібно вибрати область дії. Вона визначає, хто матиме доступ до плагіна. Область User означає, що плагін доступний вам у кожному проєкті. Область Project записує плагін у .claude/settings.json репозиторію, у enabledPlugins, і вмикає його для всіх, хто клонує репозиторій. Плагін не завантажується для них автоматично: кожен учасник усе одно має один раз встановити його на власному комп’ютері, наприклад за допомогою claude plugin install name@marketplace --scope project, якщо запис marketplace не містить відносного шляху або seed directory уже не містить цей плагін. Область Local означає, що плагін доступний вам лише в цьому репозиторії.

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

claude plugin marketplace add anthropics/claude-plugins-official
claude plugin install commit-commands@claude-plugins-official --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 проєкту або один раз виконайте claude plugin marketplace add your-org/claude-plugins --scope project і зафіксуйте створений ним файл у системі контролю версій. Claude Code реєструє marketplace для кожного учасника після того, як той довіряє папці репозиторію.

{
  "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 навички й агента, а також hooks/hooks.json, перш ніж плагін побачить хтось інший. Marketplace також не потрібен для спільного використання плагіна: ви можете надіслати іншій особі папку або .zip цієї папки, щоб вона завантажила його за допомогою --plugin-dir. Однак оновлення не надходитимуть, доки ви не надішлете нову копію.

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

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

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

Постійні витрати на контекст. Кожен увімкнений плагін додає в контекст назви й описи своїх skills, agents і commands, які Claude може викликати самостійно. Ця частина перечитується на кожному ході сесії, навіть якщо нічого не запускається. Не кожен компонент споживає токени: hook запускається harness і нічого не додає до контексту моделі. Перед встановленням у поданні докладної інформації /plugin показано розділ Will install зі списком commands, skills, agents, hooks, а також MCP- і LSP-серверів, які ви збираєтеся додати. Для плагіна з офіційного marketplace Anthropic також показано розділ Context cost з оцінками Every turn і When invoked, якщо відкрити плагін за його назвою в marketplace або з вкладки Marketplaces, а не зі списку Discover. Перегляньте обидва розділи. Плагін із вашого або стороннього marketplace не має розділу Context cost, але оцінювати витрати вручну не потрібно: claude plugin details name у shell виводить кількість токенів Always-on і розподіл за компонентами для будь-якого завантаженого плагіна, зокрема переданого через --plugin-dir. Тому можна клонувати репозиторій і виконати claude --plugin-dir ./that-plugin plugin details that-plugin до встановлення плагіна. Це значення не враховує MCP-сервери. Плагін із вбудованим MCP-сервером зазвичай є найважчим, оскільки визначення інструментів об’ємні. Однак у моделях із підтримкою пошуку MCP-інструментів ці визначення завантажуються лише за потреби. Запустіть /context у сесії з увімкненим плагіном і перегляньте рядок MCP tools, щоб побачити, що саме він додає.

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

Витрати на cache. Увімкнення або вимкнення плагіна посеред сесії може змусити наступний запит повторно обробити всю розмову. Skills, commands, agents, hooks, monitors і themes цього не роблять: їхній вміст додається після наявної історії, тому наступний запит оплачує новий вміст, а попередню історію й далі читає з cache. Винятками є плагін, який надає MCP-сервер, і плагін code intelligence, language server якого надає Claude інструмент LSP. Для MCP усе залежить від пошуку інструментів: якщо інструменти відкладені, cache зберігається; якщо вони завантажуються в префікс промпту, наступний запит повторно читає всю розмову як uncached input. Саме тому /reload-plugins попереджає та відмовляється продовжувати, коли зміна MCP-інструментів або інструмента LSP порушила б cache, доки не буде передано --force.

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

Одна операція з обслуговування окупає себе. Вкладка Installed групує встановлені з marketplace плагіни, якими ви не користувалися щонайменше 14 days і 10 sessions, під заголовком Not used recently; у поданні докладної інформації для них показано рядок Last used. Заголовок не враховує plugins, якими керує система, і plugins із seed-directory, а також plugins із theme, output style, monitor або workflow. LSP server вважається використаним, коли він надає diagnostics або відповідає на запит щодо навігації в коді. Якщо налаштовано strictKnownMarketplaces, не відображаються ні заголовок, ні рядок Last used:. Проте ці плагіни все одно збільшують час запуску та витрати контексту в кожній сесії. Вимкніть або видаліть їх. Економніший підхід — вибирати плагіни до встановлення: які skills Matt Pocock варто встановити аналізує колекцію з 27 skills і відокремлює кілька потрібних окремому розробнику від тих, що виправдовують себе лише в команді.

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

Власна документація Anthropic прямо попереджає: встановлений плагін може виконувати довільний код на вашій машині з правами вашого користувача. Це не гіпотетичний ризик. Hooks плагіна виконують shell-команди під час подій сеансу, зокрема до та після викликів інструментів. Каталог bin/ плагіна додається до PATH інструмента Bash, доки плагін увімкнений. Його stdio MCP servers — це процеси, які він запускає, а mod виконує JavaScript безпосередньо в Claude Code. Hooks, монітори, server processes і mod processes працюють за межами sandbox Claude Code; його правила дозволів усе одно застосовуються до викликів інструментів, які виконує Claude. Ті самі хуки й моди можуть і захищати вас: у матеріалі чи зливає Claude Code ваш email пояснено, що блокує вбудований мод і як хук разом із налаштуваннями git не дають моделі вписати email вашого акаунта в User-Agent або коміти.

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

Певні захисні обмеження існують, і важливо розуміти, які саме. Плагін із project scope надходить із repository, а не від вас, тому він завантажується лише після того, як ви довірите workspace. Його MCP servers усе одно потребують окремого підтвердження для кожного сервера, а його background monitors взагалі не завантажуються. Агентам, які постачаються разом із плагінами, заборонено оголошувати hooks, MCP servers або permission mode. Коли marketplace plugins копіюються до cache, symlinks, що вказують за межі marketplace, пропускаються. Тому скопійований плагін не може отримати довільні файли host через такі посилання.

Усе це не скасовує потреби перевіряти встановлені компоненти. Перегляньте список Will install, надавайте перевагу плагінам, вихідний код яких можна відкрити й прочитати, зберігайте plugins команди в marketplace repository під вашим контролем і запускайте claude plugin validate для всього, що пишете самостійно. Перевірений вами код також може змінитися пізніше: auto-update увімкнено за замовчуванням для офіційних marketplaces Anthropic, крім knowledge-work-plugins і first-party-plugins, а для third-party marketplaces, доданих із source, його вимкнено. Коли auto-update увімкнено, Claude Code оновлює файли плагіна у background.

FAQ

Чи потрібно додатково платити за plugins Claude Code?

Ні. За plugin system, додавання marketplace або встановлення plugin плата не стягується. Ви сплачуєте за використання токенів відповідно до свого plan або витрат API, як і за будь-який інший контекст. Plugin додає постійний контекст у кожному turn, додає більше контексту під час виклику однієї зі своїх skills або agents і може спричинити один дорогий uncached turn, якщо він надає MCP server, інструменти якого завантажуються в prompt prefix. Для plugin з офіційного marketplace Anthropic у поданні деталей /plugin показує оцінку Context cost до встановлення. Для будь-якого іншого plugin claude plugin details name показує його постійні витрати токенів після встановлення або завантаження за допомогою --plugin-dir.

У чому різниця між plugin і skill?

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

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

Спочатку перевірте підсумок встановлення. Якщо там зазначено Run /reload-plugins to apply., Claude Code виконує це перезавантаження після закриття panel. Якщо під час перезавантаження з’являється попередження про повторне читання conversation, виконайте його ще раз як /reload-plugins --force. Якщо plugin завантажився, але нічого не відображається, відкрийте /plugin і перегляньте вкладку Errors. Найпоширеніша структурна помилка — розміщення skills/, agents/ або hooks/ всередині .claude-plugin/, де Claude Code їх не шукає. Пам’ятайте, що skills у plugin мають namespace. Тому під час введення / потрібно шукати /plugin-name:skill-name. Якщо це plugin іншого користувача і він завантажується без помилок, відкрийте його панель деталей на вкладці Installed. Якщо plugin не містить там жодної skill, він нічого не може запропонувати. Якщо на вкладці Errors зазначено, що plugin не кешовано, його installation directory відсутня. Перевстановіть його з shell за допомогою claude plugin install name@marketplace і виконайте /reload-plugins.

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

Так. Використовуйте shell command claude plugin install name@marketplace. За замовчуванням вона встановлює plugin у user scope, якщо не передати --scope project або --scope local. Команда працює у scripts, images і non-interactive environments, де panel /plugin недоступна. Оскільки команда виконується поза session, уже відкрита session потребує /reload-plugins, перш ніж plugin набуде чинності. У session без interactive terminal зміни в plugin MCP servers набувають чинності під час наступної session.

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

Ставтеся до цього так само, як до запуску install script цього repository від імені свого користувача, оскільки за суттю це майже те саме. Plugin може виконувати shell commands через hooks, додавати executables до PATH інструмента Bash і запускати MCP servers — усе з привілеями вашого користувача. Anthropic не контролює і не перевіряє вміст third-party plugins. Встановлюйте plugins лише з джерел, код яких можна переглянути. Перед підтвердженням перевіряйте список Will install. На server дотримуйтеся суворіших вимог, ніж на laptop, оскільки обліковий запис на server зазвичай має keys і tokens, які становлять інтерес для зловмисників.

Чи була ця стаття корисною?