Плагины Claude Code: что это и как ими пользоваться

Коротко: плагин Claude Code - это папка-модуль, в которой собраны навыки, субагенты, хуки и MCP-серверы. Плагин ставится из маркетплейса в домашнюю папку, включается для всей системы или для отдельного проекта и обновляется вместе с маркетплейсом. Управляют плагинами командой /plugin.

Зачем понадобились плагины

Представьте: вы написали навыки, повесили хук на проверку кода, подключили MCP-серверы к базе данных - и всё это находится в папке .claude вашего проекта. Со временем появляется новый проект, и там возникают похожие задачи, для которых пригодилось бы то, что уже сделано.

Можно просто скопировать содержимое папки .claude в новый проект - в принципе, это будет работать. Или другая ситуация: коллега просит сделать ему такие же навыки, инструкции, субагентов, чтобы у него всё это тоже работало. Заархивировать и передать можно, но есть проблема: коллега внесёт правки в навыки и инструкции, а у вас останется старая версия. Чужой навык обновился, а у вас только его старая копия, и как это синхронизировать - непонятно.

Именно для решения таких ситуаций и придумали плагины. Плагин - это папка, которая устанавливается в вашу систему и представляет собой единый модуль: в нём уже собраны навыки, субагенты, хуки, MCP-серверы. Чем-то это похоже на расширение в браузере: браузер работает и без него, а расширение добавляет дополнительные возможности.

Установка, активация и маркетплейсы

Нужно иметь в виду: установить плагин недостаточно, чтобы он стал активен - его ещё нужно активировать. Та же аналогия, что с расширениями: вы устанавливаете плагин глобально в свою систему, в домашнюю директорию .claude, а потом активируете и используете.

Как правило, плагины размещаются в специальных репозиториях, которые называются маркетплейсами. Маркетплейс - это хранилище, список плагинов, которые кто-то собрал и выложил: человек использовал в работе навыки, инструкции, агентов, упаковал их в единый проект и выложил в репозиторий.

В принципе, можно создать и установить плагин и без маркетплейса - он будет работать, но не будет обновляться. Маркетплейс это способ раздавать плагины, чтобы у всех, кто ими пользуется, они были в актуальном состоянии.

Где плагины находятся и как активируются

Сами плагины лежат в одном месте - в домашней папке вашего пользователя. А информация о том, что плагин активирован, записывается в настройках, и у настроек есть уровни. Плагин можно активировать глобально для всех проектов - через settings.json уровня системы, - либо только для конкретного проекта, либо только для себя, если вы делите настройки с кем-то.

Важный момент: если вы активировали плагин на уровне проекта, сам плагин в директорию проекта не копируется - он остаётся в домашней папке. В проекте оказывается только строка с настройками: ключ enabledPlugins в settings.json проекта, где прописывается имя плагина. Значение true означает, что мы активируем его для текущего проекта, false - деактивируем. Чтобы деактивировать, можно просто не указывать плагин; явный false нужен в случае, когда на уровне системы плагин включён, а в проекте мы хотим его отключить. По умолчанию плагин отключён.

Что находится в папке плагинов. Файл installed_plugins хранит информацию о том, какие плагины у вас установлены. Известные маркетплейсы - это подключённые каталоги, из которых вы можете выбирать и устанавливать плагины. Папка marketplaces - копии каталогов. И кэш - это сами плагины, установленные в вашу систему: имя плагина и его содержимое.

Команда plugin

Главная слэш-команда для работы с плагинами так и называется - /plugin. У неё есть несколько вкладок.

Discover - это подключённые маркетплейсы, которые раздают плагины: здесь можно их посмотреть и поставить нужный, выбрав уровень доступа - для пользователя, для проекта или локальный. Оттуда же можно перейти на домашнюю страницу плагина.

Installed - установленные плагины, которые уже есть в системе и которые можно использовать. Marketplace - маркетплейсы, из которых вы скачиваете; сюда можно добавлять сторонние, по сути это репозитории плагинов. Errors - ошибки при работе с плагинами.

Есть и статистика: какие плагины используются меньше всего и какие можно удалить. Это полезно для наведения порядка. Например, у меня огромное количество плагинов, которыми я никогда не пользовался, и они забивают контекст - я могу посмотреть, нужны ли они мне, и удалить. Это освобождает контекст и экономит токены.

Из чего состоит плагин

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

Получается два варианта хранения навыков, инструкций и агентов. Первый - файлы в папке .claude: навык вызывается напрямую слэш-командой по своему имени. Второй - упакованный плагин: там сначала через слэш указывается имя плагина, потом двоеточие, а потом имя навыка. Появляется своя зона действия.

Ещё отличие: если вы поправили что-то в папке .claude, изменения работают сразу. А если внесли изменения в плагин, его нужно обновлять и переустанавливать.

Плагины занимают контекст

Если конструкция из навыков и агентов нужна только вам, можно обойтись и без плагинов. Плагины хороши, когда нужно поделиться готовым набором или держать его в актуальном состоянии на нескольких проектах.

Но нужно иметь в виду: каждый включённый плагин занимает контекст - память разговора, а она не бесконечна. Чем сильнее она забита, тем хуже качество ответов. Включённый плагин добавляет описание своих навыков в каждый запрос, и даже если вы ими не пользуетесь, Claude о них знает. Один активированный плагин, может быть, и незаметен, но если их десятки, контекст съедается значительно.

Поэтому с плагинами стоит быть аккуратнее и активировать только нужные. Наберите команду /plugin: во вкладке статистики видно, как часто плагин срабатывает, и можно решить, нужен ли он. Во вкладке установленных есть отметка not used recently - то, чем не пользовались две недели. Ненужные плагины просто отключайте, не копите их в контексте - это повысит качество ответов.

Что дальше

Как установить и включить плагин по шагам - в уроке «Пример установки и активации плагинов» курса «Claude Code. PRO».

Плагины собирают в себе MCP-серверы и субагентов, о них есть открытые уроки: «Что такое MCP сервер и зачем это нужно» и «Пример создания субагента в Claude Code».

Курс входит в программу «AI инжиниринг»: Claude Code, API OpenAI и основы работы с AI для программистов, доступ на год.