Скиллы, субагенты и MCP в Claude Code: что это и что поставить первым

Коротко: чем скиллы, субагенты, MCP и плагины отличаются

Claude Code «из коробки» умеет читать и править файлы и запускать команды. Всё остальное добавляется расширениями, и их четыре вида. Скилл — это инструкция в файле SKILL.md, которую Claude подгружает, когда она нужна, или которую вы вызываете как /команду. Субагент — отдельный помощник со своим контекстом, своими инструментами и системным промптом. MCP-сервер — внешний инструмент: браузер, GitHub, база данных, трекер задач. Плагин — упаковка, в которой можно поставить сразу несколько скиллов, субагентов, хуков и MCP-серверов одной командой.

Короткое правило выбора: если Claude не хватает знаний или процедуры — нужен скилл. Если задача засоряет основной диалог логами и поиском — субагент. Если нужен доступ к внешней системе — MCP. Если хочется готовую сборку от других людей или поделиться своей с командой — плагин.

Подробнее: Что такое Claude Skills в целом

Скиллы в Claude Code: SKILL.md, где лежат и как вызываются

Скилл — это папка с файлом SKILL.md: сверху YAML-заголовок, ниже инструкции в Markdown. Поле name задаёт имя команды, а description — то, по чему Claude решает, пора ли подключать скилл. В контексте постоянно висят только имя и описание, а полный текст загружается в момент использования, поэтому десяток скиллов почти не съедает контекст.

Личные скиллы кладутся в ~/.claude/skills/<имя>/SKILL.md и работают во всех проектах. Проектные — в .claude/skills/<имя>/SKILL.md внутри репозитория: их коммитят, и они появляются у всей команды. Скиллы из плагинов вызываются как /плагин:скилл. Старый формат пользовательских команд в .claude/commands/ продолжает работать, но скиллы гибче: рядом с SKILL.md можно положить справочники, примеры и скрипты.

Вызвать скилл можно двумя способами: Claude подключит его сам, если задача совпала с описанием, или вы наберёте /имя-скилла с аргументами. Если скилл должен запускаться только вручную (например, деплой), добавьте disable-model-invocation: true. Список доступных скиллов показывает команда /skills. В Claude Code есть и встроенные скиллы — например, /code-review, /debug и /loop.

# .claude/skills/summarize-changes/SKILL.md
---
name: summarize-changes
description: Summarizes uncommitted changes and flags risky patterns
---

## Current changes

!`git diff HEAD`

## Instructions

Summarize the changes above in 2-3 bullet points, then list risks
like missing error handling, hardcoded values, or tests needing updates.

Субагенты Claude Code: что это и когда нужны

Субагент — это ИИ-агент внутри Claude Code, который работает в собственном контекстном окне со своим системным промптом и набором инструментов. Основной агент отдаёт ему подзадачу, субагент выполняет её — ищет по коду, читает логи, гоняет тесты — и возвращает только краткий итог. Главная польза в том, что основной диалог не засоряется тысячами строк, которые больше не понадобятся.

Встроенных субагентов три: Explore — быстрый поиск и анализ кода только на чтение; Plan — сбор контекста в режиме планирования; general-purpose — универсальный агент для сложных многошаговых задач с доступом ко всем инструментам. Свои субагенты описываются Markdown-файлами с YAML-заголовком в .claude/agents/ (для проекта) или ~/.claude/agents/ (для всех проектов). Обязательны name и description; дополнительно можно ограничить tools, выбрать model и режим разрешений.

Claude делегирует субагенту сам, если описание подходит к задаче. Можно и попросить явно: «пусть субагент code-reviewer посмотрит последние изменения». Важно помнить: каждый субагент отправляет собственные запросы к модели, и эти токены тоже расходуются. Пять параллельных субагентов — это пять потоков запросов.

# .claude/agents/code-reviewer.md
---
name: code-reviewer
description: Reviews code for quality and best practices
tools: Read, Glob, Grep
model: sonnet
---

You are a code reviewer. When invoked, analyze the code and provide
specific, actionable feedback on quality, security, and best practices.

Подробнее: Как субагенты влияют на лимиты и токены

MCP-серверы: как подключить через claude mcp add

MCP (Model Context Protocol) — открытый протокол, через который Claude Code подключается к внешним инструментам. Сервер может работать локально как процесс (транспорт stdio) или удалённо по HTTP. После подключения Claude видит инструменты сервера и вызывает их, когда они нужны для задачи.

Добавляется сервер командой claude mcp add. Для stdio-серверов команда запуска пишется после двойного дефиса --, который отделяет параметры Claude Code от аргументов сервера. У каждого сервера есть область действия: local (по умолчанию, только вы и только этот проект), project (записывается в .mcp.json в корне репозитория и доступна всей команде через git) и user (все ваши проекты).

Проверить подключённые серверы можно командой claude mcp list в терминале или /mcp внутри сессии — там же видно, какие серверы работают, а какие требуют авторизации.

# Удалённый сервер по HTTP
claude mcp add --transport http <name> <url>

# Локальный сервер (stdio): всё после -- — команда запуска сервера
claude mcp add [options] <name> -- <command> [args...]

# Сервер для всей команды — попадёт в .mcp.json
claude mcp add --transport http shared-server --scope project https://example.com/mcp

# Управление
claude mcp list
claude mcp get <name>
claude mcp remove <name>

Популярные MCP для Claude Code: Playwright, GitHub и другие

Playwright MCP от Microsoft — самый востребованный сервер для веб-разработки. Он даёт Claude управляемый браузер: открыть страницу, кликнуть, заполнить форму, проверить результат. Работает через структурированные снимки доступности страницы, а не скриншоты, поэтому подходит для проверки вёрстки и сценариев прямо в процессе разработки.

GitHub MCP открывает доступ к issues, pull requests и репозиториям через API — полезно, если хочется, чтобы Claude сам читал задачу из issue и оставлял комментарии. Для работы с базами данных есть серверы вроде DBHub; подключайте их с учётной записью только на чтение. Для мониторинга ошибок документация Claude Code приводит пример с Sentry.

А вот отдельный filesystem-сервер в Claude Code обычно не нужен: работа с файлами в папке проекта — это встроенная возможность. Если нужен доступ к ещё одной папке, хватит команды /add-dir.

# Playwright: управление браузером
claude mcp add playwright npx @playwright/mcp@latest

# GitHub: issues и pull requests (нужен персональный токен GitHub)
claude mcp add --transport http github https://api.githubcopilot.com/mcp/ \
  --header "Authorization: Bearer YOUR_GITHUB_PAT"

# PostgreSQL через DBHub — лучше с пользователем только на чтение
claude mcp add --transport stdio db -- npx -y @bytebase/dbhub \
  --dsn "postgresql://readonly:pass@localhost:5432/analytics"

# Sentry (авторизация через OAuth в /mcp)
claude mcp add --transport http sentry https://mcp.sentry.dev/mcp

Плагины и маркетплейсы Claude Code, включая Superpowers

Плагин — это папка с манифестом .claude-plugin/plugin.json, в которой собраны скиллы, субагенты, хуки и MCP-серверы. Плагины распространяются через маркетплейсы — каталоги, которые описывают, где взять каждый плагин. Официальный маркетплейс Anthropic (claude-plugins-official) Claude Code добавляет сам при первом интерактивном запуске; другие маркетплейсы подключаются командой /plugin marketplace add.

Команда /plugin открывает менеджер плагинов: во вкладке Discover — каталог, в Installed — установленные. Плагин можно поставить для себя во всех проектах, для всей команды в конкретном репозитории или только локально. Отключить без удаления — через /plugin или claude plugin disable.

Superpowers — один из самых популярных плагинов на GitHub, его автор — Jesse Vincent (obra). Это набор скиллов, задающих дисциплинированный процесс разработки: брейншторм и уточнение требований, написание плана, разработка через тесты (RED-GREEN-REFACTOR), систематическая отладка, код-ревью и координация субагентов. Он есть в официальном маркетплейсе. Учтите: у каждого включённого плагина имена и описания скиллов постоянно висят в контексте и расходуют токены, даже если плагин в этой сессии не используется.

# Открыть менеджер плагинов
/plugin

# Superpowers из официального маркетплейса
/plugin install superpowers@claude-plugins-official

# Или из маркетплейса автора
/plugin marketplace add obra/superpowers-marketplace
/plugin install superpowers@superpowers-marketplace

Хуки: когда нужна гарантия, а не просьба

Скиллы и CLAUDE.md — это инструкции, которым модель следует, но не обязана. Если действие должно происходить всегда, используйте хук: shell-команду, которую Claude Code запускает сам на событиях жизненного цикла — до вызова инструмента (PreToolUse), после него (PostToolUse), при уведомлении (Notification), в начале сессии и так далее. Классические примеры — форматирование после каждой правки и блокировка опасных команд.

Хуки описываются в блоке hooks файла настроек (.claude/settings.json для проекта), а посмотреть их можно командой /hooks. Подробнее о повседневной работе с настройками — в нашем гайде для начинающих.

{
  "hooks": {
    "PostToolUse": [
      {
        "matcher": "Edit|Write",
        "hooks": [
          { "type": "command", "command": "jq -r '.tool_input.file_path' | xargs npx prettier --write" }
        ]
      }
    ]
  }
}

Подробнее: Гайд по Claude Code: команды, CLAUDE.md, режимы

Что поставить первым: стартовый набор

Лучшие скиллы для Claude Code — не самые популярные, а те, что решают ваши повторяющиеся задачи. Начинайте с малого: каждое расширение добавляет токены в контекст и ещё одну точку риска. Ниже — порядок, который мы рекомендуем тем, кто только начинает расширять Claude Code.

Безопасность: сторонние скиллы, MCP и плагины исполняют код

Расширение Claude Code — это не просто текст. Плагины и MCP-серверы запускаются с правами вашего пользователя, хуки выполняют произвольные shell-команды, а скилл может содержать скрипты и команды, которые подставляются в контекст. Документация Claude Code прямо предупреждает: проверяйте, что доверяете серверу, прежде чем его подключать, — серверы, которые загружают внешний контент, открывают путь для prompt injection.

• Ставьте расширения из известных источников: официальный маркетплейс, репозитории авторов с историей.
• Перед установкой прочитайте SKILL.md, файлы агентов, hooks.json и .mcp.json плагина.
• Не коммитьте токены в .mcp.json — используйте переменные окружения вида ${VAR}.
• Базам данных давайте пользователя только на чтение, GitHub-токену — минимальные права.
• Открывая чужой репозиторий, помните: его .claude/settings.json и .mcp.json могут содержать хуки и серверы.
• Отключайте неиспользуемые плагины и серверы — это и безопаснее, и экономит контекст.

Скиллы и MCP при работе из России

Скиллы, субагенты, хуки и плагины — локальные возможности Claude Code, поэтому они работают одинаково и с официальным API, и через совместимый шлюз. Через claude-gateway.ru идут только запросы к модели, включая запросы субагентов; сами MCP-серверы подключаются напрямую с вашей машины к своим сервисам. Если в описании субагента указана модель, её идентификатор должен быть доступен на вашем тарифе — ID моделей в шлюзе совпадают с Anthropic.

Подробнее: Подключить Claude Code через российский шлюз · Настройка Claude Code в России · Какую модель выбрать для агентов