Claude CodeГайд

Плагины Claude Code: как установить и создать свой

Разбираю, как устроены плагины 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. Ни один компонент не обязателен: плагин может состоять из одного навыка.

Схема из документации: папка my-plugin с plugin.json, SKILL.md, reviewer.md, hooks.json и .mcp.json, и что каждый файл даёт в сессии
Каждый файл плагина превращается в свою часть сессии: навык из skills/review становится командой /my-plugin:review. Схема: документация Anthropic
Claude Code Hooks: автоматизация рабочего процесса
Какие события ловят хуки и как написать свой, чтобы потом положить его в плагин.

Сколько плагин стоит в токенах и когда он нужен

Плагин нужен, когда несколько навыков, хуков или MCP-серверов хочется поставить и обновлять одним пакетом: самому на разных машинах, всей команде или публике. Если у тебя один навык для одного проекта, хватит файла в ~/.claude/skills/ или .claude/skills/ без всякой упаковки.

У включённого плагина есть цена, и платишь ты её в каждой сессии. Имена и описания всех навыков и агентов, которые Claude может вызвать сам, висят в контексте на каждом ходе. Полный текст навыка грузится только при вызове. Поэтому двадцать плагинов «на всякий случай» съедают окно контекста ещё до первого вопроса.

Хорошая новость: цену теперь видно до установки. В карточке плагина из официального маркетплейса есть строка Context cost. У commit-commands это около 100 токенов на каждый ход и около 930 токенов, когда команда сработала.

Карточка плагина commit-commands в /plugin: три команды, Context cost ~100 токенов на ход и ~930 при вызове, выбор из трёх областей установки
До установки видно, что добавит плагин и сколько токенов он будет стоить на каждом ходе. Скриншот: Claude Code / matveev.tech

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

Как установить плагин Claude Code через /plugin

Удобнее всего ставить через панель /plugin внутри сессии. Набери команду без аргументов, и откроется вкладка Discover со всеми плагинами из подключённых маркетплейсов. Сверху поиск, у каждого плагина категория и число установок.

Вкладка Discover в /plugin: 317 плагинов, сверху frontend-design с 1,3 млн установок и superpowers с 1,1 млн
В Discover видно, что ставят чаще всего: frontend-design, superpowers и code-review. Скриншот: Claude Code / matveev.tech, 6 ноября 2026

Дальше четыре шага.

Первый: открыть карточку. Выбери плагин в списке или сразу набери /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-plugins-official, установка commit-commands и список установленных плагинов
Три команды, и плагин установлен без запуска сессии: по умолчанию в область user. Скриншот: терминал / matveev.tech

По умолчанию 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.

Репозиторий anthropics/claude-plugins-official на GitHub: папки plugins и external_plugins, 46,3 тысячи звёзд
Весь официальный каталог лежит в одном репозитории: свои плагины Anthropic в plugins, партнёрские в external_plugins. Скриншот: GitHub / matveev.tech, 6 ноября 2026

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

Каталог плагинов на claude.com с фильтром Claude Code: Frontend Design, Superpowers, Code Review, Context7 и другие
Веб-каталог показывает те же плагины, что вкладка Discover, но искать в нём удобнее. Скриншот: Claude Marketplace / matveev.tech

Сторонний маркетплейс добавляется командой /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, таблица бинарников есть в документации.

Поиск -lsp во вкладке Discover: typescript-lsp, pyright-lsp, csharp-lsp, gopls-lsp и rust-analyzer-lsp с числом установок
Чаще всех ставят typescript-lsp: 228 тысяч установок, на втором месте Python. Скриншот: Claude Code / matveev.tech

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

Superpowers: плагин для Claude Code с TDD и планом
Какие навыки входят в 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 plugin validate для review-helper: предупреждение об иконке, совет добавить строку установки в README и итог Validation passed
Проверка прошла, валидатор лишь предупредил про иконку для каталога. Скриншот: терминал / matveev.tech

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

Вывод claude plugin details для review-helper: один навык check-pr, один агент reviewer, около 70 токенов в каждой сессии
Плагин из навыка и агента добавляет около 70 токенов в каждую сессию. Скриншот: терминал / matveev.tech

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

Ответ Claude Code на /review-helper:check-pr: найден забытый console.log, нет тестов, вызов без скидки даёт NaN
Навык нашёл и отладочный вывод из чеклиста, и ошибку сверх него: без скидки функция возвращает NaN. Скриншот: терминал / matveev.tech

Когда плагин готов, его можно отдать тремя способами: папкой или zip-архивом, через свой маркетплейс (репозиторий с marketplace.json) или заявкой в каталог Anthropic. Есть и команда claude plugin init имя, она создаёт заготовку в ~/.claude/skills/, и такой плагин подгружается в каждой сессии без маркетплейса.

Новые плагины и навыки для Claude Code, которые я реально оставил в работе, разбираю в канале: подписывайся в телеге.

Какие ошибки ломают плагины Claude Code

Большинство проблем с плагинами молчаливые: ошибки нет, просто команды не появились. Вот что встречается чаще всего и как это заметить.

Компоненты внутри .claude-plugin/. В эту папку кладут только plugin.json. Если положить туда skills/, они не загрузятся. Коварство в том, что claude plugin validate такой плагин пропускает. Ловится это через claude plugin details: в инвентаре будет Skills (0).

Плагин с папкой skills внутри .claude-plugin: claude plugin details показывает Skills (0) и Always-on ~0 tok
Навык лежит не там, и Claude Code его просто не видит: ноль навыков и ноль токенов. Скриншот: терминал / matveev.tech

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.

Читайте также

CTO говорит

Разбираю релизы моделей и инструментов: что вышло и стоит ли переходить.

Читать в Telegram

Ещё в разделе Claude Code

Весь раздел