Как создавать плагины Claude Code: пошаговое руководство

Claude Code покрывает большинство задач разработки «из коробки», но у каждой команды есть свои процессы, которые стандартные настройки не учитывают. Возможно, вам нужен пользовательский командлет, который генерирует компоненты в принятой в компании структуре, автоматический линтинг перед каждым коммитом или быстрый доступ к документации по фреймворку, с которым вы постоянно работаете.

Плагины Claude Code позволяют добавить такие возможности самостоятельно. Вы можете установить плагины из сообщества или создать свои.

Если вы впервые используете агентный инструмент кодирования от Anthropic, рекомендую начать с руководства по Claude Code или курса «Введение в модели Claude». В этом руководстве предполагается, что у вас установлен Claude Code и вы уже использовали его для базовых задач.

К концу вы узнаете, как:

• Находить и устанавливать плагины из каталога Anthropic и источников сообщества
• Понимать три типа компонентов, из которых могут состоять плагины
• Выбирать правильный тип под разные сценарии
• Создавать и делиться собственными плагинами

Обзор возможностей последней модели Anthropic смотрите в нашем гайде по Claude Sonnet 5.

Итоги вкратце

• Плагины Claude Code объединяют skills, MCP-серверы и hooks в распространяемые пакеты, которые вы устанавливаете командой claude plugin add

• Skills загружаются по требованию (~100 токенов каждый); MCP-серверы предварительно загружают определения инструментов (снижается за счёт Tool Search); hooks выполняются как shell-скрипты с нулевой стоимостью токенов

• Используйте skills для знаний и процессов, MCP-серверы — для доступа к внешним API, а hooks — для правил, которые должны срабатывать всегда

• Плагин строится из трёх файлов: манифеста .claude-plugin/plugin.json, каталога skills/ и файла инструкций SKILL.md

Что такое плагины Claude Code?

Плагин — это пакет, в котором собраны одно или несколько расширений Claude Code для удобного обмена и установки. Вместо ручного копирования конфигураций между машинами или коллегами вы упаковываете всё в плагин и распространяете как единое целое.

Плагины могут содержать три типа компонентов:

• Skills: Пользовательские команды, которые вы вызываете через /skill-name, или контекстные подсказки, которые Claude использует автоматически при необходимости

• MCP-серверы: Подключения к внешним сервисам и API, дающие Claude доступ к данным, которых у него иначе не было бы

• Hooks: Shell-скрипты, которые автоматически запускаются на определённых событиях, например, перед редактированием файла или после коммита

Плагин может содержать только один из этих компонентов или комбинировать несколько, работающих совместно. «Деплоймент»-плагин может включать скилл /deploy для ручных выкладок, MCP-сервер для проверки статуса стейджинга и hook, который запускает тесты перед выполнением любой команды деплоя.

Файл манифеста plugin.json определяет состав плагина. В нём указаны устанавливаемые skills, MCP-серверы и hooks, а также метаданные, такие как название плагина, версия и автор. При установке плагина Claude Code читает этот манифест и размещает каждый компонент в нужном месте.

Благодаря этому формату упаковки вам не нужно разбираться во внутренней структуре файлов расширений Claude Code. Вы устанавливаете плагин — и всё оказывается там, где должно.

Поиск и установка плагинов Claude Code

Большинство плагинов находятся в двух местах. Официальный каталог Anthropic на claude.com/plugins включает плагины от Anthropic, проверенные вкладки сообщества и популярные сторонние расширения. В каждой карточке указано, какие компоненты содержит плагин, информация о совместимости и инструкции по установке.

Второй источник — GitHub:

Когда вы нашли нужный плагин, команда установки зависит от места его размещения:

# From the official directory
claude plugin add @anthropic/deploy-helper
 
# From a GitHub repository
claude plugin add github:username/repo-name
 
# From a local directory (useful during development)
claude plugin add ./my-plugin

После установки нескольких плагинов их нужно контролировать. Команда plugin отвечает за список, обновление и удаление:

# List all installed plugins
claude plugin list
 
# Update a specific plugin to the latest version
claude plugin update @anthropic/deploy-helper
 
# Update all plugins
claude plugin update --all
 
# Remove a plugin
claude plugin remove @anthropic/deploy-helper

Одно из решений при установке касается области действия. Плагины могут устанавливаться в двух местах: установка в пользовательскую область записывает в ~/.claude/plugins/ и работает во всех ваших проектах, а в область проекта — в .claude/plugins/ внутри конкретного репозитория.

По умолчанию — пользовательская область. Чтобы установить плагин только для текущего проекта, добавьте флаг --project:

claude plugin add @anthropic/deploy-helper --project

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

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

Выбор подходящего типа плагина Claude Code

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

Skills vs MCP-серверы: компромисс по токенам

MCP-серверы предварительно загружают все определения инструментов в контекстное окно при запуске сессии. Для каждого инструмента нужны имя, описание и полная схема параметров — обычно это 100–300 токенов на инструмент. Конфигурация с пятью серверами потребляет примерно 55 000 токенов ещё до того, как вы что-либо напечатаете:

• GitHub: 35 инструментов
•  Slack: 11 инструментов
• Sentry: 5 инструментов
• Grafana: 5 инструментов
• Splunk: 2 инструмента

Одно исследование показало, что конфигурации с 7+ серверами потребляют 67 000+ токенов, то есть треть вашего 200K-контекста исчезает ещё до начала разговора.

Skills используют иной подход — прогрессивное раскрытие. В начале сессии Claude видит только имя каждого skill и однострочное описание из YAML-преамбулы — около 100 токенов на skill. 

Полные инструкции подгружаются только тогда, когда Claude определяет, что skill релевантен текущей задаче. Файлы-референсы загружаются лишь при явной необходимости. А скрипты вовсе не попадают в контекст — Claude запускает их снаружи, и возвращается только вывод.

Anthropic устранила этот перекос в конце 2025 года с помощью Tool Search — функции, которая приносит «ленивую» загрузку в MCP-серверы. 

Вместо предзагрузки всех определений инструментов Claude Code теперь обнаруживает, что описания инструментов займут более 10% доступного контекста, и переключается на загрузку по требованию. 

Во внутреннем тестировании использование контекста снизилось примерно со ~134 000 токенов до ~5 000 для больших библиотек инструментов. Точность выбора инструментов также выросла: у Opus 4 — с 49% до 74%, а у Opus 4.5 — с 79,5% до 88,1% на оценках MCP.

Как решить, что выбрать.

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

Skills также уместны для операций, где нужны скрипты для тяжёлых вычислений, поскольку код скриптов остаётся за пределами контекстного окна.

MCP-серверы оптимальны, когда Claude нужны данные в реальном времени из внешних сервисов — сообщения Slack, PR в GitHub или запросы к БД. Их стоит выбирать и тогда, когда одним и тем же инструментам должны пользоваться несколько ИИ-агентов, или когда нужны корпоративные функции вроде журналов аудита и явных разрешений.

Во многих конфигурациях сочетаются оба подхода: skills задают «как» и «когда» через естественно-языковые инструкции, а MCP-серверы выполняют реальные вызовы API.

Популярные skills для установки

• Superpowers (наш туториал): 20+ проверенных на проде рабочих процессов для TDD, отладки и структурированного планирования
• frontend-design: Инструктирует Claude избегать шаблонной эстетики и принимать смелые дизайнерские решения
• mcp-builder: Гайд по созданию MCP-серверов для интеграции внешних API
•  webapp-testing: Тестирование локальных веб‑приложений с помощью Playwright для проверки UI
•  skill-creator: Интерактивный инструмент, который помогает пошагово создать новый skill

Популярные MCP-серверы для подключения

• Context7: Поиск документации в реальном времени с учётом версий
• GitHub: Поиск по репозиторию, управление PR, трекинг задач
• Playwright: Автоматизация браузера с использованием деревьев доступности вместо скриншотов
• Supabase: Запросы к базе данных с учётом Row Level Security
• Sentry: Отслеживание ошибок и производительности прямо в редакторе

Также вы можете прочитать наш обзор лучших удалённых MCP-серверов.

Hooks: детерминированный слой

Hooks вообще находятся вне спора «skills или MCP». Если и skills, и MCP-серверы ориентированы на Claude (Claude решает, когда их применять), то hooks ориентированы на систему. Они срабатывают на событиях вроде PreToolUse или PostToolUse, выполняя shell-скрипты до или после совершения Claude определённых действий. Запуск hook не зависит от решения Claude.

Это делает Hooks правильным выбором, когда что-то должно происходить без исключений: линтинг перед каждым коммитом, блокировка записи в защищённые каталоги, логирование каждой bash-команды или запуск тестов перед любым деплоем.

Эта разработчица рекомендует hooks «block-at-submit», а не «block-at-write». Блокировка Claude в середине задачи сбивает агента с толку и ухудшает результат. В её команде используется hook PreToolUse, который оборачивает Bash(git commit) и проверяет временный файл, существующий только если тесты прошли. Нет файла — нет коммита. Агент завершает работу, а валидация происходит в конце.

Hooks не добавляют накладных расходов по токенам, так как выполняются как shell-скрипты вне контекстного окна.

Полезные hooks для настройки

• ESLint/Prettier при редактировании: Автоформатирование файлов после записи Claude
• Тестовый «шлюз» на коммите: Блокировать коммиты, если тесты не прошли
• Защищённые пути: Запрет записи в migrations, configs или vendor
• Уведомление о завершении: Отправка уведомлений в Slack или на рабочий стол по окончании долгих задач
• Резервная копия транскрипта: Сохранение истории диалога перед компактацией

Как создать собственные плагины Claude Code

Когда skill хранится в вашей личной директории .claude/, пользоваться им можете только вы. Упаковка в плагин позволяет делиться им с коллегами или переиспользовать в разных проектах.

Мы создадим плагин под названием session-logger, который добавляет команду /session-logger:summarize. При вызове Claude просматривает разговор и добавляет структурированное резюме в файл SESSION_LOG.md.

Создайте структуру плагина

Плагины могут располагаться где угодно в вашей файловой системе. В этом туториале создадим его в вашем домашнем каталоге:

cd ~
mkdir -p session-logger/.claude-plugin
mkdir -p session-logger/skills/summarize

Будет создано:

~/session-logger/
├── .claude-plugin/
│   └── plugin.json  	# manifest goes here, nowhere else
└── skills/
	└── summarize/   	# folder name becomes the command name
    	└── SKILL.md 	# must be named exactly this

Напишите манифест

Создайте ~/session-logger/.claude-plugin/plugin.json:

{
  "name": "session-logger",
  "description": "Log session summaries to a markdown file",
  "version": "1.0.0"
}

Поле name становится префиксом пространства имён. Все команды этого плагина будут начинаться с /session-logger:.

Напишите skill

Создайте ~/session-logger/skills/summarize/SKILL.md:

---
description: Log a summary of the current session to SESSION_LOG.md
disable-model-invocation: true
---
 
When invoked, review the conversation and create a summary with these sections:
 
- **Date/time**: Current timestamp
- **Tasks completed**: What was accomplished
- **Files modified**: List of files created or changed
- **Decisions made**: Architectural or implementation choices
- **Open questions**: Unresolved items for future sessions
 
Append the summary to SESSION_LOG.md in the project root. Create the file if it doesn't exist.

Строка disable-model-invocation: true сообщает Claude, что только вы можете запускать этот skill. Без этого флага Claude может решить запустить команду автономно, если сочтёт это полезным для разговора. Для журналирования или деплоя обычно нужен ручной контроль.

Протестируйте локально

Перейдите в любой проект, где хотите использовать плагин, затем запустите Claude Code с флагом --plugin-dir, указывающим на ваш плагин:

cd ~/your-project
claude --plugin-dir ~/session-logger

Введите /session-logger:summarize для вызова команды. Обратите внимание: команды плагинов не появляются в автодополнении, пока вы не введёте полное имя. Текст станет синим, когда Claude Code распознает валидную команду.

После некоторой работы в сессии запустите команду. Claude просмотрит разговор и добавит запись в SESSION_LOG.md в текущем каталоге проекта.

Поделитесь с другими

Опубликуйте плагин на GitHub. Чтобы распространять его дальше, чем ручное клонирование, добавьте его в маркетплейс плагинов. Руководство по маркетплейсам рассказывает, как создать собственный маркетплейс или подать плагин в существующие.

Заключение

Плагины превращают Claude Code из универсального помощника в инструмент, настроенный под ваш конкретный рабочий процесс. Журналировщик сессий, который мы собрали, занял около пяти минут и три файла. Большинство полезных плагинов не намного сложнее.

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

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

Чтобы углубиться в Claude Code, посмотрите наши руководства по лучшим практикам Claude Code, фреймворку skills Superpowers, slash-командам для длинных сессий и безопасности и разрешениям. Если хотите больше узнать о моделях Claude, рекомендую курс «Введение в модели Claude».