Каждый день в Telegram-канале - что нового в вайб-кодинге: инструменты, кейсы, ошибки. Подпишись, чтобы быть в курсе.
Почему «засрать Claude Code» стало главной болью в 2026?
В июне 2026 я снял короткое видео про 754 готовых навыка кибербезопасности из открытой библиотеки - разлетелось неожиданно широко. Через два дня снял продолжение под лозунгом «не ставь все подряд, выбирай только то, что тебе нужно, иначе засрёшь» - почти так же разошлось. Аудитория голосует ногами: тема «как выбирать» жжёт сильнее, чем тема «что есть».
Hacker News это подтверждает с другой стороны. Осенью 2025 в треде про релиз Claude Skills (HN-обсуждение «Claude Skills», 816 баллов) Simon Willison публично сказал: AGENTS.md и MCP оба пихали слишком много в контекст, паттерн скиллов сюда укладывается гораздо лучше. Готового сводного ответа «когда брать что» не было даже в официальной документации.
Я месяц гоняю все четыре механизма в боевых проектах: собрал стек субагентов под одну сложную задачу, оставил небольшой набор скиллов под повторяющиеся процедуры, держу пару MCP-серверов для живых данных, перебрал около двух десятков плагинов и оставил единицы. Этот гайд - сводная матрица выбора, проверенная боем. С готовым деревом решения, цитатами Anthropic и семью анти-паттернами, после которых Claude становится непригодным.
Чем skill отличается от subagent, MCP и plugin одной таблицей?
Сводная матрица, которую я держу перед глазами:
| Свойство | Skill | Subagent | MCP-сервер | Plugin |
|---|---|---|---|---|
| Изолированный контекст | Нет | Да (свежие 200K) | Нет | Через свои subagent'ы |
| Внешние данные и API | Нет | Только через выданные MCP | Да | Через свои MCP-сервера |
| Экономия токенов | 70-90% (progressive disclosure) | До 70% на сложных задачах | Зависит от tool search | Зависит от состава бандла |
| Ограничение инструментов | Через allowed-tools | Жёстко в frontmatter | Через subagent или политику | Часть бандла |
| Выбор более дешёвой модели | Через поле model | Да, в frontmatter | N/A | Через свои subagent'ы |
| Скорость сборки | Минуты | Минуты | Часы-дни | 1 клик из маркетплейса |
| Главный сценарий | Чеклисты, конвенции, стиль | Делегированная задача с грязным выводом | БД, API, live-data | Готовый workflow от сообщества |
| Главная ловушка | Раздутый SKILL.md > 500 строк | Subagent с правами как у parent | MCP-серверов больше 3 | Бандл с непрочитанным составом |
Простая аналогия для предпринимателя - представь себя CEO компании из десяти человек:
- CLAUDE.md - устав компании. Всегда на стене, все читают, никто не спорит.
- Skill - внутренний регламент. «Как мы делаем ревью», «как пишем релизные заметки», «как принимаем оплату».
- Subagent - специалист с отдельным кабинетом и узким списком прав. Дай ему ключи от всего - получишь второго CEO, не сотрудника.
- MCP-сервер - корпоративные системы: CRM, банк, склад. Это не знание, это подключение.
- Plugin - готовое решение «под ключ» из магазина. Сразу пакет регламентов, специалистов и интеграций в одной коробке.
Когда понимаешь, что это четыре слоя одной системы, а не четыре конкурента - вопрос «что лучше» снимается. Остаётся вопрос «что куда».
Что такое skill в Claude Code и когда его ставить?
Официальное определение от Anthropic:
Скиллы - это переиспользуемые файловые ресурсы, которые дают Claude доменную экспертизу: воркфлоу, контекст и лучшие практики, превращающие универсального агента в специалиста.
Скилл устроен в три уровня:
- Метаданные. Грузятся всегда при старте сессии: имя и описание из frontmatter. Один скилл - примерно 100 токенов на старте.
- Инструкции. Грузятся только когда Claude увидел триггерный запрос. До 5 000 токенов - тело SKILL.md.
- Ресурсы. Подгружаются только когда инструкции явно их зовут. Bundle-файлы, скрипты в
scripts/, справочники вreferences/. Скрипты выполняются черезbash, сам код в контекст не попадает.
Anthropic называет этот принцип progressive disclosure:
Progressive disclosure - это базовый принцип дизайна, который делает Agent Skills гибкими и масштабируемыми.
И там же - метафора, которая объясняет суть лучше всего:
Собрать скилл для агента - это как написать онбординг-гайд для нового сотрудника.
Когда брать skill:
- Стандартная процедура, которую ты вводишь снова и снова. Ревью PR, релизные заметки, code-review по твоему стайл-гайду.
- Когда секция в
CLAUDE.mdвыросла из факта в процедуру и начинает мешать остальным. - Когда одну и ту же инструкцию хочется выполнять одинаково в разных проектах.
У меня для этого простая формула: что делаешь больше пары раз - отдай системе. Один раз - ручной промпт. Второй - готов кандидат на skill.
Когда НЕ брать skill:
- Если задача требует живых данных (БД, API, поиск, актуальная биржа). Это MCP, а не skill. Skill, который пытается «достать актуальную цену» - будет галлюцинировать.
- Если задача требует изолированного контекста. Это subagent.
- Если хочешь детерминированный запрет («никогда не закоммить .env»). Это hook, не skill. Skill - это предложение, не гарантия.
Лимиты, которые надо знать заранее:
- Имя скилла: до 64 символов, только lowercase, цифры и дефисы. Слова
anthropicиclaudeзарезервированы. - Описание: до 1 024 символов. Сумма
description+when_to_useобрезается на 1 536 символах в списке. - Тело SKILL.md: рекомендация - не больше 500 строк. Дальше переносить в
references/иscripts/. - При автоматическом сжатии контекста (auto-compaction) каждый активный скилл получает re-attach первых 5 000 токенов. Общий бюджет на все скиллы - 25 000.
Подробный разбор связки Anthropic-Cybersecurity-Skills (754 готовых скилла по кибербезопасности) - в отдельном гайде «Как защитить вайб-код в Claude Code в 2026: 754 готовых навыка».
Что такое subagent и зачем нужны 5 уровней вложенности?
Из официальной документации:
Субагенты - это специализированные ИИ-ассистенты, которые берут конкретные классы задач. Используй один, когда побочная задача готова забить твою основную беседу результатами поиска, логами или содержимым файлов, на которые ты не будешь ссылаться. Subagent делает эту работу в собственном контексте и возвращает только сводку.
Внутри Claude Code уже встроены три subagent'а, которыми ты пользуешься, даже не зная:
| Subagent | Модель | Доступ | Где работает |
|---|---|---|---|
| Explore | Haiku | Read-only | Поиск по коду, экономит контекст за счёт пропуска CLAUDE.md и git status |
| Plan | Haiku | Read-only | Plan mode - думает до того, как писать код |
| General-purpose | Sonnet/Opus | Все инструменты | Сложные multi-step задачи |
10 июня 2026 Boris Cherny выкатил Claude Code v2.1.172 и снял ограничение, которое держалось с момента релиза subagent'ов: дочерние агенты теперь могут порождать своих субагентов до 5 уровней глубины.
Только что выкатил поддержку вложенных субагентов в Claude Code. На старт ограничил глубину пятью. Дайте знать, что думаете.
Цифра 5 - это потолок безопасности, а не цель оптимизации:
Потолок в 5 уровней существует, чтобы предотвратить взрывную рекурсию, а не как бенчмарк, который надо оптимизировать.
Подробный разбор фичи с YAML-шаблонами оркестратора - в гайде про вложенных субагентов.
Когда брать subagent:
- Исследовательский проход по коду или логам, после которого нужен только короткий вывод.
- Параллельные задачи: «3-5 субагентов - sweet spot», как пишут в Tembo.io 2026 guide.
- Делегирование по специализации: backend / frontend / test / review - каждый на одну фичу.
- Контроль стоимости: subagent на Haiku вместо Sonnet или Opus. Это снижает счёт в 5-7 раз.
Когда НЕ брать subagent:
- Одноразовая мелочь, простой tool-call. У subagent есть startup cost.
- Задачи должны делиться состоянием между собой. Субагенты не видят контекст друг друга - связанная работа должна жить в основном треде.
Главный анти-паттерн от systemprompt.io:
Дать subagent'у Opus и все инструменты - это просто ещё одна основная сессия. Если список инструментов совпадает с главным агентом, у тебя неправильно ограничен subagent.
Иными словами: subagent с теми же правами, что и parent - просто второй CEO. Бессмысленно и дорого.
Что такое MCP-сервер и когда подключать его к Claude Code?
Официальное определение:
Думай о MCP как о USB-C-порте для ИИ-приложений. Как USB-C стандартизировал подключение электроники, MCP даёт стандартный способ подключать ИИ-приложения к внешним системам.
Что MCP реально позволяет на практике:
- Подключить Claude к Google Calendar и Notion - получить персонального ассистента.
- Подключить к Figma - Claude генерит готовый веб-проект по дизайну.
- Подключить корпоративный чат-бот к нескольким базам данных одновременно.
- Подключить к Blender и 3D-принтеру - создавать модели и сразу печатать.
Самые известные MCP-сервера, которые ставят в первую очередь:
| MCP-сервер | Что подключает | Где взять |
|---|---|---|
| Context7 | Актуальная документация любой библиотеки | плагин из claude-plugins-official |
| GitHub | Issues, PR, репозитории | claude-plugins-official |
| Filesystem | Файловая система за пределами проекта | reference в modelcontextprotocol.io |
| Postgres | Прямой доступ к БД | reference там же |
| Magic MCP от 21st.dev | Анимации и UI-компоненты | mcp-каталог |
| Slack / Linear / Jira / Notion | Workplace-интеграции | claude-plugins-official |
Когда брать MCP:
- Любое подключение к внешним данным или действиям. «Достать строки из БД», «прочитать тикеты Jira», «опубликовать в Slack».
- Когда тот же сервис нужен нескольким проектам или агентам - проще держать один централизованный сервер.
Когда НЕ брать MCP:
- Статическое знание или процедура. Это skill, не MCP. Если ты пишешь «инструкцию, как делать code-review» - это skill. Если «прочитай свежий PR из GitHub и проверь» - это MCP.
- Одна разовая CLI-команда. Проще написать
Bash, чем разворачивать сервер. - Когда хочется построить MCP «ради правильной архитектуры». Это эстетика, а не задача.
Главная ловушка MCP - один из главных источников жалоб «Claude Code тупит» в 2026:
Когда ставишь все эти MCP сразу, ты в итоге душишь контекстное окно LLM: все доступные инструменты грузятся в контекст.
Smith Horn Group формулирует rule of thumb коротко: держи не больше 2-3 активных MCP-серверов, направленных под конкретные задачи. Я пробовал больше - стартует медленнее, ошибается чаще.
В Claude Code v2.1.x добавили MCP tool search: инструменты больше не грузятся жадно в контекст, а индексируются и подтягиваются по запросу. Это снижает стоимость «много MCP в проекте», но не убирает её полностью.
Чем plugin отличается от skill и почему граница стёрлась?
Официальная формулировка:
Плагины расширяют Claude Code скиллами, агентами, хуками и MCP-серверами. Маркетплейсы плагинов - каталоги, которые помогают найти и установить эти расширения, не собирая их самому. Думай об этом как о подключении магазина приложений: добавив магазин, ты получаешь доступ к коллекции, но ты сам решаешь, какие приложения скачать.
Лидеры по установкам в июне 2026:
| Место | Плагин | Установок | Что внутри |
|---|---|---|---|
| 1 | Frontend Design (Anthropic) | 829 316 | skills + subagents под дизайн |
| 2 | Superpowers (obra/Jesse Vincent) | 752 120 | TDD + сократические сессии |
| 3 | Context7 (Upstash) | 348 660 | MCP-обёртка над документацией |
| 4 | Code Review (Anthropic) | 347 221 | 5 параллельных subagent'ов на ревью |
| 5 | Code Simplifier | 284 632 | skill + hook на упрощение |
| 6 | TypeScript LSP | 177 136 | LSP-плагин |
| 7 | Pyright LSP | 91 225 | LSP-плагин |
Полный разбор моего отбора - в гайде про топ-10 плагинов из 101.
Когда брать plugin:
- Готовый бандл от сообщества, который закрывает большой кусок воркфлоу. Например, дизайн или ревью.
- Когда не хочется собирать руками связку «skill + subagent + MCP + hook» - берёшь готовое.
- Корпоративная раздача: админ делает team-marketplace, разработчики ставят с одного префикса.
Когда НЕ брать plugin:
- Задача решается одним skill, но бандл тащит ещё пять MCP «на всякий случай». Это в чистом виде засорение контекста.
- Закрытый источник без аудита. Плагин выполняется с твоими правами - читай состав до установки.
- Уже есть собственный плагин на ту же тему. Дубль в контексте - двойная боль.
В Claude Code v2.1.143+ перед установкой видно Context cost - оценку токенов, которые плагин добавит в каждое сообщение. С v2.1.145+ показывает поле Will install с полным списком commands, agents, skills, hooks, MCP и LSP внутри бандла. Прежде чем нажать установить - это первая страница, которую надо открыть.
Хочешь не только разобраться в выборе механизма, но и собрать связку, которая делает Claude стабильным? Skill, subagent и MCP - три из четырёх кирпичиков. На практикуме за 3 эфира собираешь все три кита: ИИ-клон, Второй мозг и Контекст-инжиниринг. Связка, которая превращает Claude из «помощника с галлюцинациями» в надёжный инструмент.
Какая матрица выбора работает в 2026?
Шесть вопросов в порядке приоритета:
- Это повторяющаяся процедура, стиль или чеклист? Если да - skill.
- Нужны внешние данные или действия (БД, API, Slack, GitHub, Figma)? Если да - MCP-сервер.
- Хочу отдельный контекст, чтобы не засорять основной? Если да - subagent.
- Хочу детерминированный запрет или автоматический шаг? Если да - hook, не skill.
- Хочу готовый бандл из 1-4 в один клик? Если да - plugin из маркетплейса.
- Сложная задача, где нужны и данные, и контекст, и стиль? Тогда композиция: subagent на Haiku + preloaded skill + один узкий MCP.
Формула композиции, которую я держу как канон:
Subagent на Haiku с предзагруженным скиллом для конвенций и узким MCP-сервером для живых данных - это паттерн, который реально окупается.
И главное правило направления зависимости:
Subagent'ы могут использовать MCP-сервера. MCP-сервера не могут использовать subagent'ов.
Иными словами: MCP - это всегда данные и действия, не агенты. Если ты хочешь делегировать задачу - это subagent, который дёргает MCP, а не наоборот.
Конкретный пример из моего продакшена: редакционный движок digital-агентства, который пишет одну SEO-статью за 60 минут. Внутри 25 субагентов и 14 этапов проверок - они идут последовательно, каждый со своим контекстом, своими правами и своим skill для конвенций редактуры. Один из субагентов подключён к MCP-серверу с базой готовых тегов и старых статей. Главный агент-оркестратор работает на Opus, дочерние на Haiku - так смета держится в адекватных деньгах.
Это не «фабрика статей» - это пример того, как 4 механизма складываются в одну систему, когда задача стоит на глубину качества, а не на скорость.
Какие 7 ошибок снести из Claude Code прямо сейчас?
-
Поставил все топ-10 плагинов «потому что трендово». Каждый добавляет токены в каждое сообщение. Открой
/plugin listи посмотри Context cost у каждого. Снеси те, которыми не пользовался за две недели. -
Скопировал 15 MCP-серверов из чужой
.mcp.json. Чужой стек настроен под чужой проект и чужие задачи. Smith Horn group рекомендует держать максимум 2-3 активных MCP под текущий проект. Лишние - в отдельный конфиг для другого проекта или сразу удалить. -
Skill и MCP-плагин делают одно и то же. Skill говорит «сделай code review», плагин
pr-review-toolkitзапускает свой ревью-флоу. Они начинают спорить за приоритет. Симптом: «Claude почему-то ходит то туда, то сюда». Решение: оставить один источник истины. У меня - skill, потому что я хочу контроль над инструкцией. -
Skill для enforcement, где нужен hook. Skill - это предложение, не гарантия. Если задача «никогда не дай Claude закоммитить
.env» - это hook, который встаёт на pre-commit, а не skill, который Claude может проигнорировать. -
Subagent с теми же правами, что и parent. Дал ему Opus и все инструменты - получил второй главный сеанс. Подскажет system-prompt из официальной документации - subagent должен иметь узкий список инструментов и собственную ограниченную задачу. Иначе это просто дорогой клон.
-
Не смотрел на Will install перед установкой плагина. В Claude Code v2.1.145+ это поле показывает полный состав бандла. Часто плагин «для одной маленькой штуки» внутри содержит три MCP-сервера, два subagent'а и пять hooks. Все они начинают жить в твоём контексте.
-
Старые
.claude/commands/дублируют новые skills. Anthropic в документации пишет:
Кастомные команды слиты с навыками. Файл
.claude/commands/deploy.mdи навык.claude/skills/deploy/SKILL.mdоба создают/deployи работают одинаково.
Старая папка commands/ продолжает работать, но новый канон - skills. У меня лежали обе - снёс commands/, оставил skills с bundled-файлами и triggers.
Симптомы того, что Claude Code «засрался»:
- Каждое сообщение начинается с упоминания available tools на 200+ строк.
- Простые задачи делает медленнее, чем месяц назад.
- Claude путается между двумя похожими скиллами или плагинами.
- При запуске сессии видны warnings о коллизиях имён.
- Claude дёргает не тот инструмент - skill А вместо MCP Б, который был нужен.
Если узнал хотя бы два пункта из этого списка симптомов - открой /plugin list и /skill list прямо сейчас. Сначала снеси то, чем не пользовался две недели. Потом смотри Context cost у каждого. Дальше - анти-паттерны выше.
Что сам Boris Cherny советует про выбор?
Мои настройки Claude Code остаются удивительно ванильными.
В интервью Fortune Cherny говорил, что бывают дни, когда он управляет десятками тысяч агентов параллельно. Сорок версий Claude Code за июнь, всё работает. Без пятнадцати MCP-серверов, без двадцати плагинов «на всякий случай».
На Hacker News в октябре 2025 тред «Claude Skills» (id 45607117, 816 баллов) собрал сотни комментариев именно вокруг вопроса «когда брать skill, когда subagent, когда MCP». Главный тон обсуждения был «облегчает MCP-перегруз», а не «ставь все». Simon Willison прямо в треде написал: AGENTS.md и MCP оба пихали слишком много в контекст, паттерн скиллов сюда укладывается гораздо лучше.
Главный сигнал для аудитории: создатель инструмента сам им пользуется в минимальной конфигурации. Если он управляет десятками тысяч агентов на ванильной настройке - твой проект тем более выиграет от того, что ты снесёшь половину того, что ставил последние недели.
Сколько skills и MCP можно держать, чтобы не сжечь контекст?
Что показывает Claude Code напрямую:
/skill list- все активные скиллы и их размер в токенах./plugin list- все плагины с Context cost./mcp list- MCP-сервера и их tool count.
Бюджет токенов в реальных цифрах:
| Механизм | Стоимость в простое | Стоимость при срабатывании |
|---|---|---|
| Skill | ~100 токенов (только metadata) | До 5 000 (тело SKILL.md) |
| Subagent | ~50 токенов (имя и описание) | 200K (свой контекст, не общий) |
| MCP-сервер | До 1 500 (tools list) | По вызову tool |
| Plugin | Сумма всех внутренних | Сумма всех внутренних |
Smith Horn Group формулирует rule of thumb для MCP коротко:
Держи не больше 2-3 активных MCP-серверов под конкретные задачи, чтобы сохранять оптимальную скорость старта.
Anthropic в техническом блоге даёт цифры по auto-compaction для skills: re-attach первых 5 000 токенов каждого активного скилла, общий бюджет - 25 000. Это значит, что больше 5 одновременно активных «жирных» skills - и Claude начинает терять часть инструкций.
Простое правило, которое я держу:
- Skills: не больше 5-7 активных под текущий проект. Остальные - в
~/.claude/skills/disabled/, если понадобятся - переношу обратно. - MCP: не больше 2-3 на проект. Context7 для документации почти всегда стоит, остальное - под задачу.
- Plugins: ставлю строго по одному, через две недели проверяю, использовал ли. Не использовал - сношу.
Подробный разбор Anthropic 2026 Agentic Coding Trends Report и почему 80% разработчиков не могут полностью делегировать задачу Claude - в отдельном гайде. Главная цифра оттуда: люди используют ИИ в 60% работы, но полностью передают только 0-20% задач. Главная причина - перегрузка контекста и потеря контроля над инструментами.
С чего начать новичку: минимальный набор для практикума?
Минимальный стек после двух недель работы, без которого я бы сегодня не запускал ни один проект:
- CLAUDE.md в корне с правилами проекта. Полный гайд по 4 правилам Karpathy и настройке CLAUDE.md.
- AGENTS.md для совместимости с другими инструментами, если планируешь работать не только в Claude Code. Подробнее - «Как сделать один файл инструкций для Claude Code, Codex и Cursor».
- 1 skill под твою главную повторяющуюся задачу. У меня первый -
code-reviewпо моему стайл-гайду. - 1 MCP-сервер: Context7 для актуальной документации. Без него Claude всё ещё галлюцинирует про несуществующие API.
- 0 плагинов и 0 subagent'ов в первый месяц. Это не про экономию, это про контроль. Пока не понимаешь базу - бандлы будут запутывать.
Дальше - по задачам. Появилась повторяющаяся процедура? Поднимаешь в skill. Нужны живые данные из конкретного сервиса? Добавляешь MCP. Большая задача начинает забивать основной контекст? Делегируешь subagent'у.
Это и есть та самая трёхъярусная карта, которую я держу в голове: сначала контекст, потом что больше пары раз - отдай системе, потом автопроверки, чтобы система сама не косячила. Каждый ярус добавляется только тогда, когда предыдущий уже работает.
Источники
- Agent Skills Overview - Anthropic Docs
- Skills - Claude Code Docs
- Subagents - Claude Code Docs
- Plugins - Claude Code Docs
- Equipping Agents for the Real World with Agent Skills - Anthropic Engineering
- MCP Introduction - modelcontextprotocol.io
- GitHub anthropics/skills - открытый репозиторий
- Hacker News: Claude Skills (тред с Simon Willison)
- Anthropic 2026 Agentic Coding Trends Report
- systemprompt.io: Skills vs Agents vs MCP guide
- Smith Horn Group: Choosing between skills, subagents, MCP
- Tembo.io: Claude Code Subagents 2026 guide
- Composio: Top Claude Code Plugins 2026
- ChatForest: Nested Sub-Agents depth=5 token math
- Boris Cherny manages tens of thousands of agents at once - Fortune
- Boris Cherny nested subagents tweet
Полная схема по вайб-кодингу за вечер: ИИ-клон + Второй мозг + Контекст-инжиниринг. 3 эфира, 2 000 ₽. Записи остаются у тебя.
Новые материалы - дайджестом, без спама
Гайды выходят регулярно. Подпишись, чтобы не пропускать: пришлю подборку в Telegram или на email. Раз в неделю или каждый день - выбираешь сам.

