Claude

Плагины Claude Code — как расширить возможности

Плагины добавляют в Claude Code новые навыки, агенты, hooks и MCP-серверы. Разбираемся, как ставить, настраивать и управлять маркетплейсами.

Pavel Matveev

Pavel Matveev

— 3 min read
Плагины Claude Code — как расширить возможности
TL;DR: В Claude Code есть система плагинов — пакеты, которые добавляют навыки (skills), агенты, hooks и MCP-серверы. Устанавливаются из маркетплейсов через команду /plugin. Можно ставить из GitHub, npm, git-репозиториев или локальных директорий.

Когда я впервые услышал про плагины в Claude Code, подумал: «Ну вот, ещё одна система расширений». Но когда попробовал — оказалось, что это действительно меняет рабочий процесс. Плагин Claude Superpowers, например, научил Claude думать перед тем, как писать код. Без шуток — модель стала планировать, а не бросаться редактировать файлы.

Что внутри плагина

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

  • Skills — навыки, которые Claude может вызывать. Специализированные промпты с инструкциями для конкретных задач
  • Agents — субагенты, специализированные AI-помощники с ограниченным набором инструментов
  • Hooks — автоматические действия при событиях (редактирование файла, старт сессии)
  • MCP servers — внешние серверы инструментов для расширения возможностей

Необязательно все четыре — плагин может содержать только skills, или только hooks.

Как установить плагин

Основной способ — команда /plugin в Claude Code. Она открывает интерактивный интерфейс:

  1. Набери /plugin в Claude Code
  2. Выбери «Browse marketplace» или «Add marketplace»
  3. Найди нужный плагин
  4. Подтверди установку

Плагины ставятся из маркетплейсов — реестров, которые хранят метаданные и код плагинов.

Маркетплейсы

Маркетплейс — источник плагинов. Типы:

  • GitHub — репозиторий на GitHub с файлом marketplace.json
  • Git — любой git-репозиторий (GitLab, Bitbucket, self-hosted)
  • npm — npm-пакет
  • URL — JSON-файл по ссылке
  • Directory — локальная директория (для разработки плагинов)

Добавить маркетплейс:

{
  "extraKnownMarketplaces": {
    "my-tools": {
      "source": {
        "source": "github",
        "repo": "username/claude-plugins"
      }
    }
  }
}

Это в проектном .claude/settings.json — тогда маркетплейс автоматически предложится всей команде.

Управление плагинами через settings

Включение и отключение плагинов:

{
  "enabledPlugins": {
    "code-formatter@team-tools": true,
    "experimental-stuff@personal": false
  }
}

Формат: plugin-name@marketplace-name. Можно задать в user settings (для всех проектов), project settings (для команды) или local settings (для себя).

Полезные плагины

Я не буду составлять огромный каталог, потому что экосистема пока молодая и меняется быстро. Но вот что стоит посмотреть:

Claude Superpowers — набор навыков, которые учат Claude Code планировать перед кодингом, проводить code review, дебажить систематически. Я писал отдельный обзор — штука полезная, особенно навык brainstorming перед реализацией фич.

Code intelligence плагины — подключают языковые серверы (LSP). Claude начинает видеть ошибки типов, переходить к определениям, находить ссылки. Без LSP-плагина Claude ориентируется только по тексту — с ним становится заметно точнее.

Остальные плагины зависят от стека. Если твоя команда использует специфические инструменты — скорее всего, стоит написать свой плагин.

Создание своего плагина

Плагин — это директория с файлом .claude-plugin/marketplace.json (для маркетплейса) или набор файлов skills/agents/hooks.

Структура минимального плагина:

my-plugin/
├── .claude-plugin/
│   └── marketplace.json
├── skills/
│   └── my-skill/
│       └── SKILL.md
└── agents/
    └── my-agent.md

SKILL.md — markdown-файл с инструкциями для Claude. По сути, промпт, который загружается при вызове навыка. my-agent.md — описание субагента с YAML-frontmatter для конфигурации.

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

Автообновление плагинов

По умолчанию плагины обновляются автоматически вместе с Claude Code. Если автообновления отключены (DISABLE_AUTOUPDATER=1), можно принудительно обновлять плагины:

FORCE_AUTOUPDATE_PLUGINS=true

Или обновить вручную через /plugin → «Update plugins».

Безопасность плагинов

Вопрос доверия. Плагин может содержать hooks, которые выполняют произвольные команды. Поэтому:

  • Устанавливай плагины только из доверенных источников
  • В корпоративной среде используй strictKnownMarketplaces для ограничения маркетплейсов
  • Просматривай код плагина перед установкой — это просто markdown-файлы и JSON

Claude Code запрашивает подтверждение при установке плагина из нового маркетплейса. Не жми «Yes» не глядя.

Часто задаваемые вопросы

Плагины замедляют Claude Code? Skills и agents загружаются только при вызове. Hooks запускаются при каждом событии, но обычно это быстрые команды. MCP-серверы из плагинов стартуют при начале сессии — если сервер тяжёлый, это добавит пару секунд.

Как удалить плагин? Через /plugin → выбери установленный плагин → «Uninstall». Или удали запись из enabledPlugins в settings.json.

Можно ли использовать плагины в CI/CD? Да, но нужно предустановить их. В CI-среде нет интерактивного /plugin — всё настраивается через settings.json и переменные окружения.

Плагины работают с Bedrock/Vertex/Foundry? Да, плагины не зависят от провайдера модели. Они работают на уровне Claude Code, а не API.

Что ещё почитать