Плагины Claude Code: как установить и создать свой
Разбираю, как устроены плагины Claude Code, как ставить их из официального каталога и чужих маркетплейсов и как собрать свой плагин с навыком и агентом.
В официальном каталоге Claude Code на 6 ноября 2026 года 317 плагинов, и любой ставится одной командой. Но каждый включённый плагин добавляет свои описания в контекст на каждом ходе. Плагины Claude Code — это пакеты из навыков, субагентов, хуков и MCP-серверов, которые ставятся через /plugin и включаются как единое целое.
Берут их из маркетплейсов, официальный каталог Anthropic Claude Code подключает сам. Выбираешь плагин, решаешь, для кого его включить, и через минуту новые команды уже в сессии. Сколько он будет стоить в токенах, теперь видно ещё до установки.
Я пользуюсь плагинами с января. Поставил Superpowers, чтобы Claude Code сначала планировал, потом писал код, и с тех пор подключил больше десятка маркетплейсов. За это время механика заметно поменялась: появились вкладки в /plugin, оценка расхода токенов до установки, команды claude plugin в обычном терминале и отдельный сайт с каталогом. Ниже всё проверено на Claude Code 2.1.319.
В статье разберём:
- что такое плагин и из чего он состоит;
- сколько плагин стоит в токенах и когда он вообще нужен;
- как установить плагин Claude Code через
/pluginи из терминала; - где искать плагины и как подключить чужой маркетплейс;
- какие плагины поставить первыми;
- как включать, выключать и обновлять плагины;
- как создать свой плагин за десять минут;
- какие ошибки ломают плагины и насколько они безопасны.
Что такое плагины Claude Code и из чего они состоят
Плагин — это папка с компонентами и манифестом .claude-plugin/plugin.json, в котором записаны имя, версия и описание. Claude Code загружает такую папку целиком: включил плагин, и все его части появились в сессии, выключил — пропали.
Вот что может лежать внутри.
Навыки (skills). Файлы SKILL.md с инструкциями. Claude подгружает их, когда задача подходит, а ты можешь вызвать навык как команду: /имя-плагина:имя-навыка. Префикс с именем плагина нужен, чтобы два плагина с навыком review не конфликтовали.
Субагенты (agents). Описания помощников с отдельным набором инструментов, которым Claude передаёт часть работы.
Хуки (hooks). Команды, которые Claude Code сам запускает на событиях: после каждой правки файла, перед вызовом инструмента, на старте сессии. Как они устроены, я разбирал в гайде по хукам Claude Code.
MCP- и LSP-серверы. Внешние инструменты и языковые серверы, которые стартуют вместе с сессией.
Сейчас к ним добавились ещё мониторы (фоновые команды), папка bin/ с исполняемыми файлами, темы, стили вывода и моды на JavaScript. Ни один компонент не обязателен: плагин может состоять из одного навыка.


Сколько плагин стоит в токенах и когда он нужен
Плагин нужен, когда несколько навыков, хуков или MCP-серверов хочется поставить и обновлять одним пакетом: самому на разных машинах, всей команде или публике. Если у тебя один навык для одного проекта, хватит файла в ~/.claude/skills/ или .claude/skills/ без всякой упаковки.
У включённого плагина есть цена, и платишь ты её в каждой сессии. Имена и описания всех навыков и агентов, которые Claude может вызвать сам, висят в контексте на каждом ходе. Полный текст навыка грузится только при вызове. Поэтому двадцать плагинов «на всякий случай» съедают окно контекста ещё до первого вопроса.
Хорошая новость: цену теперь видно до установки. В карточке плагина из официального маркетплейса есть строка Context cost. У commit-commands это около 100 токенов на каждый ход и около 930 токенов, когда команда сработала.

Для уже установленного плагина то же самое показывает claude plugin details имя-плагина в обычном терминале. Строка Always-on показывает, сколько токенов плагин добавляет в каждую сессию, а ниже идёт разбивка по навыкам. Если хочешь экономить на MCP-серверах из плагинов, загляни в разбор Tool Search и токенов MCP.
Как установить плагин Claude Code через /plugin
Удобнее всего ставить через панель /plugin внутри сессии. Набери команду без аргументов, и откроется вкладка Discover со всеми плагинами из подключённых маркетплейсов. Сверху поиск, у каждого плагина категория и число установок.

Дальше четыре шага.
Первый: открыть карточку. Выбери плагин в списке или сразу набери /plugin install commit-commands@claude-plugins-official. В сессии эта команда ничего не ставит молча: она открывает карточку, где перечислено, что установится.
Второй: прочитать раздел Will install. Там команды, агенты, навыки, хуки и серверы. Если в плагине есть хуки или MCP-серверы, они будут запускать код на твоей машине, поэтому смотри внимательно.
Третий: выбрать область. Вариантов три. Install for you ставит плагин тебе во всех проектах (запись в ~/.claude/settings.json). Install for all collaborators включает его всем, кто работает с репозиторием (запись в .claude/settings.json, который коммитят). Install for you, in this repo only включает его только тебе и только здесь (.claude/settings.local.json).
Четвёртый: проверить. Последняя строка после установки подсказывает, работает ли плагин сразу (Plugin is now active.) или нужен /reload-plugins. Потом набери / и найди команды плагина с его префиксом.
Без интерактива плагин ставится из обычного терминала. Это нужно для скриптов настройки, CI и новых машин. На свежей машине официальный маркетплейс ещё не подключён, его добавляют первой командой.

По умолчанию claude plugin install ставит плагин в область user. Для проекта добавь --scope project. Учти, что запись в .claude/settings.json только включает плагин коллегам, а скачать его каждый должен сам той же командой.
Где искать плагины: маркетплейсы Anthropic и сторонние
Маркетплейс — это каталог плагинов. Технически это репозиторий или папка с файлом .claude-plugin/marketplace.json, где перечислены плагины и откуда каждый скачать. Подключаешь маркетплейс один раз, потом ставишь из него по имени плагин@маркетплейс.
У Anthropic два общих каталога, они описаны на странице Anthropic's marketplaces.
Официальный claude-plugins-official. Claude Code добавляет его сам при первом запуске в терминале. Внутри плагины Anthropic (commit-commands, code-review, feature-dev, языковые серверы) и плагины партнёров: GitHub, Figma, Supabase, Stripe, Sentry и ещё сотни. Репозиторий anthropics/claude-plugins-official на 6 ноября набрал 46,3 тысячи звёзд.
Общественный claude-community. Плагины сторонних авторов, которые прошли заявку в Anthropic. Сам он не подключается: /plugin marketplace add anthropics/claude-plugins-community.

Если удобнее листать в браузере, есть сайт Claude Marketplace. Там фильтр Works with: Claude Code, отметки проверенных Anthropic плагинов и кнопка, которая копирует команду установки.

Сторонний маркетплейс добавляется командой /plugin marketplace add с адресом источника:
/plugin marketplace add owner/repo # GitHub
/plugin marketplace add owner/repo#v1.2.0 # GitHub, закреплённый тег
/plugin marketplace add https://gitlab.com/team/plugins.git
/plugin marketplace add ./my-marketplace # локальная папка
/plugin marketplace add https://example.com/marketplace.json
С версии 2.1.275 маркетплейс и плагин ставятся одной командой: /plugin install deploy-helper --marketplace your-org/plugins. В обычном терминале то же работает с 2.1.292.
Старый маркетплейс claude-code-plugins из репозитория anthropics/claude-code объявлен устаревшим. Если в каком-то туториале есть шаг /plugin marketplace add anthropics/claude-code, пропусти его и ставь из claude-plugins-official.
Какие плагины Claude Code поставить первыми
Каталог большой, но большинство плагинов там партнёрские: они подключают Claude Code к сервису конкретной компании. Пользы от плагина Stripe нет, если ты не работаешь со Stripe. Вот что я бы поставил первым почти в любой проект.
Языковой сервер для твоего стека. LSP-плагины дают Claude то же, что редактору: ошибки типов сразу после правки, переход к определению, поиск ссылок по символу, а не по тексту. В каталоге 13 таких плагинов, от typescript-lsp до swift-lsp. Сам сервер ставится отдельно, для TypeScript это npm install -g typescript-language-server typescript, таблица бинарников есть в документации.

Superpowers. Набор навыков, который заставляет Claude сначала обсудить задачу и составить план, потом писать код с тестами. С 1,1 миллиона установок это второй плагин в каталоге. Теперь он ставится прямо из официального маркетплейса: /plugin install superpowers@claude-plugins-official. Подробно про него в обзоре Superpowers.

commit-commands и code-review. Первый даёт команды для коммита, пуша и PR, второй гоняет несколько агентов по пулреквесту. Если нужна облачная версия ревью, она описана в обзоре Code Review в Claude Code.
context7. MCP-сервер со свежей документацией библиотек, чтобы Claude не писал код под API двухлетней давности.
plugin-dev. Нужен, если соберёшься писать свои плагины: команда /plugin-dev:create-plugin проведёт по шагам и проверит результат.
Отдельные навыки без упаковки в плагин я разбирал на примере Karpathy skills и UI UX Pro Max.
Как включать, выключать и обновлять плагины
Управлять плагинами можно в панели /plugin на вкладке Installed: пробел включает и выключает, Enter открывает меню с Update now и Uninstall. Неиспользуемые плагины Claude Code сам собирает в группу Not used recently. Это хороший повод раз в месяц их перебрать.
То же самое делается из терминала:
claude plugin list # что установлено и где
claude plugin disable formatter@your-org # выключить, не удаляя
claude plugin enable formatter@your-org
claude plugin update commit-commands@claude-plugins-official
claude plugin uninstall formatter@your-org --scope project
Включённые плагины хранятся в настройках, в ключе enabledPlugins. Формат плагин@маркетплейс, значение true или false. Где лежат файлы настроек и какой из них главнее, я разбирал в гайде по settings.json.
{
"enabledPlugins": {
"commit-commands@claude-plugins-official": true,
"experimental@my-tools": false
}
}
Чтобы вся команда видела ваш маркетплейс, добавь его в проектный .claude/settings.json через extraKnownMarketplaces. Claude Code применит эту запись только в папке, которой участник доверился.
{
"extraKnownMarketplaces": {
"my-tools": {
"source": { "source": "github", "repo": "your-org/claude-plugins" }
}
}
}
С обновлениями в старой версии этой статьи была неточность, исправляю. Автоматически обновляются только плагины из официальных маркетплейсов Anthropic и из маркетплейсов, добавленных через claude.ai. У сторонних, общественного и локальных маркетплейсов автообновление по умолчанию выключено, его включают на вкладке Marketplaces кнопкой Enable auto-update. Проверка идёт в фоне через случайную паузу до десяти минут после первого сообщения, а новая версия грузится при следующем запуске или после /reload-plugins.
Если ты отключил обновления самого Claude Code через DISABLE_AUTOUPDATER=1 или DISABLE_UPDATES=1, плагины тоже перестают обновляться. Вернуть только их можно переменной FORCE_AUTOUPDATE_PLUGINS=1, остальные переменные собраны в справочнике переменных окружения. Команды «обновить всё» нет: обновляют по одному плагину или весь маркетплейс через Update marketplace.
Как создать свой плагин Claude Code
Свой плагин собирается за десять минут, маркетплейс для этого не нужен. Я сделал демо review-helper: навык проверяет diff перед пулреквестом, а агент ищет ошибки логики. Структура такая:
review-helper/
├── .claude-plugin/
│ └── plugin.json
├── README.md
├── agents/
│ └── reviewer.md
└── skills/
└── check-pr/
└── SKILL.md
Манифест короткий. Обязательно только поле name: оно станет префиксом всех команд плагина. Поле version держит пользователей на этой версии, пока ты её не поднимешь.
{
"name": "review-helper",
"description": "Проверка PR перед отправкой: чеклист и агент-ревьюер",
"version": "1.0.0",
"author": { "name": "Pavel Matveev" },
"license": "MIT"
}
Навык пишется обычным markdown с фронтматтером. Строка disable-model-invocation: true значит, что Claude не запустит навык сам, только по твоей команде.
---
name: check-pr
description: Проверить текущие изменения перед открытием PR по чеклисту команды
disable-model-invocation: true
---
Посмотри `git diff` текущей ветки и проверь его по чеклисту:
1. Нет забытых console.log, print и отладочных флагов.
2. У новых функций есть тесты.
3. В сообщении коммита сказано, зачем это изменение.
Ответь списком: что в порядке, что поправить до PR.
Перед запуском проверь плагин командой claude plugin validate. Она сверяет манифест и фронтматтер навыков, а заодно подсказывает, чего не хватит для публикации в каталог Anthropic: README, лицензии, иконки.

Потом посмотри, что Claude Code реально нашёл в папке и сколько это будет стоить.

Для разработки плагин не устанавливают, а подключают на одну сессию флагом --plugin-dir. После правки файлов набери /reload-plugins, переустанавливать ничего не нужно. Я прогнал навык на демо-репозитории, где в функцию подсчёта суммы добавил скидку и забыл console.log.

Когда плагин готов, его можно отдать тремя способами: папкой или zip-архивом, через свой маркетплейс (репозиторий с marketplace.json) или заявкой в каталог Anthropic. Есть и команда claude plugin init имя, она создаёт заготовку в ~/.claude/skills/, и такой плагин подгружается в каждой сессии без маркетплейса.
Какие ошибки ломают плагины Claude Code
Большинство проблем с плагинами молчаливые: ошибки нет, просто команды не появились. Вот что встречается чаще всего и как это заметить.
Компоненты внутри .claude-plugin/. В эту папку кладут только plugin.json. Если положить туда skills/, они не загрузятся. Коварство в том, что claude plugin validate такой плагин пропускает. Ловится это через claude plugin details: в инвентаре будет Skills (0).

marketplace.json вместо plugin.json. В старой версии статьи я сам их перепутал. marketplace.json описывает каталог из многих плагинов, а у самого плагина манифест plugin.json.
npm как источник маркетплейса. Плагин можно взять из npm-пакета, а маркетплейс нельзя: Claude Code ответит NPM marketplace sources not yet implemented. Для каталога используй GitHub, любой git, локальную папку или ссылку на JSON.
Относительный путь без ./. Запись my-org/plugins Claude Code читает как GitHub-репозиторий. Локальную папку пиши как ./my-org/plugins.
Плагин включён в проекте, но не установлен. Коллега закоммитил enabledPlugins, а у тебя плагина нет на диске. Лечится одной командой claude plugin install имя@маркетплейс --scope project.
Ждёшь плагины в облачной сессии. Сессии в браузере на claude.ai/code не грузят плагины из твоих локальных настроек и из .claude/settings.json репозитория. Там работают только плагины, которые раздаёт организация.
Ставишь всё подряд. Каждый включённый плагин съедает контекст на каждом ходе. О том, куда ещё утекают токены, есть отдельная статья: как экономить токены в Cursor и Claude Code.
Насколько безопасны плагины Claude Code
Плагин выполняет код с правами твоего пользователя, и документация говорит об этом прямо в разделе о безопасности. Хуки, мониторы, MCP- и LSP-серверы плагина работают вне песочницы, и правила разрешений на них не действуют. Правила срабатывают только на вызовы инструментов, которые делает сам Claude. Как настроить эти правила, я разбирал в гайде по разрешениям и sandbox.
Имя маркетплейса подделать нельзя: имена официальных и общественных каталогов Claude Code принимает только из репозиториев github.com/anthropics/. Но официальный каталог не значит «проверено до последней строчки». Большинство плагинов в нём от партнёров, а Anthropic прямо пишет в карточке, что не контролирует их содержимое.
Перед установкой чужого плагина я делаю три вещи. Читаю hooks/hooks.json, .mcp.json и папку bin/: там всё, что запустится само. Смотрю инвентарь через claude --plugin-dir путь plugin details имя до установки. Не включаю автообновление для маркетплейсов, которым не доверяю: иначе проверенные файлы могут тихо смениться.
В компании это решают политикой. Через управляемые настройки можно разрешить только свои маркетплейсы (strictKnownMarketplaces), запретить конкретные (blockedMarketplaces) и поставить нужные плагины всем сразу. Об этом подробнее в статье про Claude Code для команд.
Чек-лист для нового плагина Claude Code
Короткий список проверок, его удобно сохранить:
- в карточке
/pluginпрочитан раздел Will install и строка Context cost; - если в плагине есть хуки, MCP-серверы или папка
bin/, просмотреныhooks/hooks.json,.mcp.jsonиbin/: этот код запустится вне песочницы; - область установки выбрана осознанно: для себя, для всех в репозитории или только для себя в этом проекте;
- после установки команды с префиксом плагина видны по
/, а если нет, выполнен/reload-plugins; - свой плагин прошёл
claude plugin validate, аclaude plugin detailsне показываетSkills (0); - автообновление включено только у тех сторонних маркетплейсов, которым ты доверяешь;
- раз в месяц группа Not used recently на вкладке Installed разобрана, лишнее выключено.
Больше гайдов по агенту в разделе о Claude Code.
Читайте также
- MCP серверы для Claude: что это и как настроить: как подключить MCP-сервер без плагина
- Рейтинг плагинов Claude Cowork: какие плагины ставить в Claude на claude.ai и что они умеют на демо-данных
- Channels в Claude Code: Telegram, Discord и вебхуки: канал Telegram тоже ставится плагином