Skills, Subagents, MCP и Plugins в Claude Code: что выбрать

В Claude Code можно организовать проверку кода пятью способами: slash-командой, skill, subagent, plugin или обычным запросом в чате. Универсально лучшего варианта нет: выбор зависит от самой задачи, доступного бюджета токенов и того, кто ещё будет пользоваться этим решением.

Рабочая среда Claude Code может объединять собственные skills для разных процессов, subagents для отдельных задач, MCP-серверы для связи с сервисами и plugins с готовыми наборами компонентов. Подобную конфигурацию обычно подбирают постепенно, исправляя ошибки в организации инструментов.

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

Подробнее о сервисе — в документации Ailoot.

Что такое Skills, Subagents, MCP и Plugins?#

Все четыре механизма расширяют возможности Claude, но каждый из них решает свою задачу.

Skill — каталог с файлом SKILL.md, где описано, в каких случаях и каким образом применять методику. Anthropic сравнивает skill с инструкцией для нового сотрудника: вместо ежедневных пошаговых указаний ему передают правила работы.

Subagent — отдельный сеанс Claude, запускаемый из основного диалога и имеющий собственный контекст. Его главное свойство — изоляция. Например, subagent может изучить 30 файлов, подготовить выводы и вернуть в основной чат только краткий результат.

MCP (Model Context Protocol) — открытый стандарт Anthropic для соединения Claude с внешними системами. В статье Anthropic от 13 ноября 2025 года различие описано так:

Plugin — готовый пакет, в котором могут быть skills, subagents, hooks и команды. Его можно установить через /plugin install. Skill задаёт собственную рабочую процедуру, а plugin позволяет подключить уже подготовленный набор компонентов.

Коротко: skills содержат инструкции, subagents выполняют специализированную работу, а MCP предоставляет доступ к сервисам и данным. Расход контекста у них различается: skill подключается по необходимости, тогда как описания инструментов MCP-сервера могут занимать место в контекстном окне.

Зачем нужны четыре слоя, если есть CLAUDE.md?#

CLAUDE.md может служить общей картой проекта: в ней указывают расположение материалов, порядок публикации и принятые договорённости. Благодаря этому правила проекта доступны и в новых сеансах.

Однако одного такого файла хватает не для каждого сценария. Вот несколько примеров.

Ситуация 1: правило нужно выполнять каждый раз. Инструкция CLAUDE.md запускать npm run build перед git push сама не гарантирует исполнение. Правильно настроенный и испытанный hook может выполнить детерминированную проверку и отклонить охваченную операцию. Охват зависит от события и пути инструмента: hook Claude Code не перехватывает автоматически каждую отправку из другого терминала или приложения. Проверьте блокировку намеренно неуспешной сборкой на настоящем используемом пути.

Ситуация 2: регулярно повторяется многошаговый процесс. Например, подготовка каждого руководства включает 14 этапов: поиск информации, составление структуры, работа с MDX, семь параллельных проверок качества, публикацию и отправку в IndexNow. Повторно описывать все шаги в чате долго, поэтому их можно оформить как skill build-guide, запускаемый короткой фразой. В примере это инструкция размером 34 КБ.

Ситуация 3: задача требует большого объёма чтения. Для проверки актуальности опубликованного руководства Claude может понадобиться изучить транскрипт эфира размером 30 КБ, 20 ретроспектив по 5 КБ и текущую страницу сайта. Если выполнять всё в основном диалоге, промежуточный материал займёт значительную часть контекста. Subagent может провести анализ в отдельном сеансе и передать только итоговую сводку объёмом около 300 слов.

Ситуация 4: готовые шаблоны нужны всей команде. Например, можно упаковать правила frontend-дизайна, hooks для публикации через Coolify и настройки MCP для проверок Playwright. Plugin даёт возможность распространить этот набор через marketplace, чтобы коллеги могли установить его одной командой.

CLAUDE.md описывает общие правила проекта. Дополнительные слои нужны для запуска процедур по запросу, работы с изолированным контекстом, соединения с внешними системами и распространения наборов инструментов.

Когда выбрать Skill вместо CLAUDE.md?#

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

Каталог skills обычно содержит методики для разных задач — например, создания руководств, сценариев, настройки, упрощения кода или помощи с сочетаниями клавиш. Внутри skill можно описать этапы процесса, проверки качества, условия остановки и материалы, которые нужно сохранить. В приведённом примере основной skill занимает 34 КБ.

Когда Skill не нужен.

• Общее правило вроде «отвечай на языке пользователя» следует поместить в CLAUDE.md, если оно должно учитываться всегда.
• Разовое поручение, например «сейчас выполни рефакторинг», достаточно написать в чате.
• Если работа требует отдельного контекста для чтения множества файлов, рассмотрите subagent.

Типичная ошибка. Иногда процедуру оформляют как subagent, хотя для неё хватило бы skill. Subagent создаёт отдельный контекст и требует дополнительных ресурсов. Если методику можно описать примерно в 1500–2000 словах и ей не требуется читать внешние файлы, начните с skill.

О структуре skill, frontmatter и формулировках для запуска читайте в руководстве Claude Code Skills в 2026 году: как создать свою библиотеку навыков.

Когда выбрать Subagent вместо Skill?#

Skill описывает методику, а subagent выполняет порученную работу. Их часто путают, поскольку оба механизма запускаются из чата.

Subagent особенно полезен, когда нужно отделить объёмный анализ от основного диалога. Например, можно поручить ему изучить 30 файлов, а затем получить только заключение, не загружая основной контекст промежуточными материалами.

Пример: параллельные проверки. Руководство можно одновременно проверять на соответствие стилю, точность цитат и фактов, пригодность структуры для поисковиков, а также исправность внутренних и внешних ссылок. Каждая проверка может требовать отдельных правил, вызовов WebFetch и поиска по тексту.

Если проводить весь такой анализ в одном сеансе, материалы проверок будут накапливаться в его контексте. Вместо этого subagents можно запустить в фоне с run_in_background: true. Основной диалог продолжит работу, а после завершения проверок вернутся отчёты, которые можно использовать для исправлений. В приведённом примере получение результатов занимает 4–6 минут.

Ещё один пример — поиск тем. Несколько subagents могут параллельно собирать сигналы из разных источников:

• V1 — форумы и сообщества за 14 дней
• V2 — социальные сети
• V3 — видеоплатформы и блог Anthropic
• V4 — пробелы в SEO

Каждый агент может вернуть 30–40 идей с оценкой потенциального интереса. Затем результаты объединяют и сравнивают по девяти критериям. Такой подход позволяет распределить исследовательскую работу между отдельными контекстами.

Когда Subagent не нужен.

• Если задача не требует чтения файлов или использования WebFetch, её можно решить в основном диалоге.
• Повторяемую процедуру храните в skill; при полезной изоляции она может выполняться субагентом.
• Для внешнего доступа нужен разрешённый инструмент, например MCP или CLI. Делегированный субагент может использовать его.

Типичная ошибка. Общее имя вроде backend-engineer или qa не объясняет, какую конкретно задачу должен выполнять subagent. Названия вроде migration-test-writer или api-route-reviewer точнее обозначают назначение. Чёткие инструкции и конкретная специализация помогают выбрать подходящего агента.

Инструкции по созданию subagents, синтаксис frontmatter и примеры приведены в руководстве Claude Code Subagents в 2026 году: пошаговая инструкция.

Когда выбрать MCP вместо Skill или Subagent?#

В документации Anthropic разница сформулирована кратко: MCP подключает Claude к данным, а Skills описывают, как с этими данными работать.

Для проверки GitHub issue навыку нужно содержимое. Предоставьте его разрешённым MCP, CLI или переданным текстом. Skill задаст порядок анализа и формат выводов; доступ MCP сам по себе не предписывает процедуру.

Примеры использования MCP.

• Playwright MCP — для визуальной проверки страниц: их можно открыть на настольном компьютере и мобильном устройстве, проверить ширину контейнера и отображение блоков.
• Stitch MCP — для работы с дизайн-системой и создания компонентов в стиле бренда.
• vidIQ MCP — для изучения трендов и оценки идей.
• Railway MCP — для управления инфраструктурой развёртывания.

Каждый MCP-сервер предоставляет связь с внешней системой. Без него для таких операций может понадобиться собственная обёртка или ручной переход в браузер.

Затраты контекста. MCP-сервер может занимать место описаниями инструментов, схемами аргументов и другими сведениями. В приведённом примере для четырёх серверов оценка составляет 8–12 тысяч токенов в каждой новой сессии — ещё до первого запроса.

Поэтому постоянно подключайте только те серверы, которые действительно нужны в большинстве сеансов. Если Sentry MCP используется редко, можно активировать его по запросу через флаг --mcp sentry, а не держать включённым постоянно.

Когда MCP не нужен.

• Правила работы с данными лучше оформить как skill.
• Для объёмного анализа многих файлов может подойти subagent.
• Автоматическую публикацию одной командой можно организовать через hook или plugin.

Типичная ошибка. Создание MCP-сервера для выдачи инструкции по code review решает задачу, связанную с методикой, а не с доступом к внешним данным. Такую процедуру можно описать в skill и не держать её в виде постоянно подключённого инструмента.

Общие ресурсы и конфликты. Если Playwright MCP сообщает Browser is already in use, причиной может быть другой процесс, который уже использует браузер. Перед параллельной работой проверьте, не занят ли общий ресурс — браузер, порт или файл — другим процессом.

Руководство по настройке MCP содержит примеры семи связок: MCP-серверы Claude Code в 2026 году: 7 готовых конфигураций.

Когда выбрать Plugin вместо Skill или Subagent?#

Skills, subagents и MCP можно настроить под собственные процессы. Plugin позволяет подключить уже собранный набор компонентов.

В октябре 2025 года Anthropic представила Claude Code Plugins как механизм распространения пакетов. В plugin могут входить:

• собственные slash-команды
• собственные skills
• собственные subagents
• собственные hooks
• конфигурации MCP
• собственные стили вывода

Компоненты упаковываются в каталог с файлом plugin.json. Установить пакет можно через ~/.claude/settings.json или командой /plugin install <name>.

Примеры plugins.

• frontend-design из официального репозитория claude-plugins-official содержит 67 стилей, 96 цветовых палитр, 57 сочетаний шрифтов и 13 фреймворков. Такой набор может пригодиться при создании блока сайта или шаблона письма.
• playwright из того же официального набора предоставляет skills и конфигурации MCP для тестирования в браузере.
• telegram — набор для управления аккаунтом Telegram из Claude Code с политикой доступа, allowlist и pairing.
• trailofbits/skills — комплект security-skills от компании Trail of Bits.

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

Когда Plugin не нужен.

• Если методика предназначена только для вашего рабочего процесса, оставьте её в skill.
• Если ещё неясно, кому пригодится набор, сначала попробуйте skill самостоятельно.
• Для копирования нескольких файлов на новую машину может быть достаточно команды cp ~/.claude/skills/X /new/machine/.claude/skills/.

Типичная ошибка. Plugin не предназначен для дублирования CLAUDE.md. Правила, относящиеся только к одному проекту, следует описывать в файле этого проекта. Plugin полезен для распространения повторно используемых компонентов.

Дерево решений: четыре вопроса перед задачей#

Вопрос 1: есть повторяемая процедура, которую стоит сохранить?

Оформите её как skill в SKILL.md с ясным условием применения. Он задаёт методику, но сам не предоставляет внешний доступ или отдельный контекст.

Вопрос 2: нужен отдельный контекст или ограниченная делегированная роль?

Используйте subagent с точной задачей и инструментами. Та же работа может следовать методике skill внутри отдельного контекста.

Вопрос 3: нужны инструменты или внешние данные?

Предоставьте разрешённый доступ через MCP или подходящий инструмент, например настроенный CLI. Skill объясняет использование доступа, а субагент может быть исполнителем.

Вопрос 4: нужно распространять и поддерживать настройку пакетом?

Используйте plugin для навыков, агентов, hooks или конфигурации MCP. Пакет может быть собственным или другого автора.

Пример: регулярная проверка GitHub issue. Skill определяет процедуру и формат, настроенный MCP или CLI даёт разрешённый доступ, субагент читает длинное обсуждение отдельно и возвращает выводы, а plugin распространяет сочетание команде. Все четыре ответа могут быть положительными.

Пять ошибок при выборе слоя#

Ошибка 1: subagent вместо skill.

Представим, что для написания поста в блог создали subagent. При каждом запуске он загружается, читает методику объёмом 2 КБ, создаёт текст и завершает работу. Дополнительные ресурсы расходуются при каждом повторе.

Лучше оформить инструкцию по написанию постов как skill с запускающей фразой «новый пост в блог». Тогда для процедуры не потребуется отдельный сеанс. В исходном примере такая схема оценивается как более экономная в 3–5 раз.

Ошибка 2: MCP-сервер вместо skill.

Допустим, MCP-сервер создан, чтобы выдавать инструкцию по code review. В контексте постоянно присутствуют описания инструментов и схемы аргументов, хотя доступ к внешнему сервису для этой задачи не нужен. Примерная оценка лишнего расхода в таком сценарии — 2–3 тысячи токенов на запрос.

Правила проверки кода — это процедура, которую можно описать в skill. MCP нужен, если требуется получить актуальные сведения из внешней системы, например последние ошибки в Sentry.

Ошибка 3: plugin вместо CLAUDE.md.

Можно упаковать правила одного проекта — использовать строгий режим TypeScript, избегать определённых знаков тире или запускать pnpm вместо npm — в plugin. Если этот пакет лишь повторяет инструкции CLAUDE.md, он добавляет лишний уровень.

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

Ошибка 4: попытка заменить Skill на hook.

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

Hook предназначен для детерминированного действия: запуска команды, форматирования результата или блокировки операции. Он сам по себе не загружает skill и не обращается к Claude. Общую методику можно оформить как skill, а постоянно действующее правило — внести в CLAUDE.md.

Ошибка 5: добавление слоя для редкой задачи.

Узнав о skills, можно потратить время на создание инструкции для задачи, которая встречается раз в месяц. Такой инструмент потребует обслуживания, но будет редко использоваться.

Разовое поручение можно дать прямо в чате. Skill имеет смысл, когда методика действительно регулярно повторяется; оценивать частоту нужно применительно к собственному процессу.

Независимо проверьте потребности: процедура, изоляция контекста или роли, доступ инструментов и распространение. Добавляйте каждый слой с конкретной целью и сочетайте их при необходимости.

Фрагментация: куда движется Claude Code в 2026 году#

В Claude Code способы провести code review включают команды, skills, subagents, plugins и запросы в чате. Эти варианты могут решать похожую задачу, различаясь способом настройки и контекстом выполнения.

Объявленный для 2026 года встроенный /code-review skill показывает направление консолидации. Изменения инструментов не отменяют необходимости выбирать механизм в зависимости от характера работы.

Вот какие выводы можно сделать для практики.

Первое: для повторяемых процедур удобно использовать skills. Они позволяют описать порядок действий и применять его по мере необходимости. Если вы пока не знакомы с skills, начните с изучения этого механизма.

Второе: subagents полезны для изоляции объёмной работы. Чем точнее указаны задача и специализация агента, тем понятнее, для чего он предназначен. Например: migration-test-writer или api-route-reviewer.

Третье: обновления продуктов требуют проверки по официальным объявлениям. В источнике также упоминались команда /workflows, объявленная 28 мая 2026 года для координации десятков subagents, и разделение биллинга Agent SDK с 15 июня. Проверяйте сведения о доступности и условиях этих функций в официальных материалах Anthropic.

В 2026 году набор функций может меняться, а некоторые механизмы — объединяться. Дерево решений остаётся полезным, поскольку помогает сначала определить потребность задачи, а уже затем выбирать инструмент.

Матрица: десять типичных задач и подходящий слой#

Необязательно внедрять все варианты сразу. Для многих индивидуальных задач достаточно CLAUDE.md, нескольких skills и нужных MCP-серверов. Subagents и plugins можно подключать, когда появляется конкретная потребность.

Как организовать рабочую среду в Claude Code#

Эти механизмы дополняют друг друга. CLAUDE.md задаёт основу для работы в проекте, а остальные инструменты можно подключать по мере усложнения задач.

Узнать больше о Ailoot.