Плагины Claude Code: отличия и установка

Коротко

Плагины Claude Code — это упакованные наборы расширений, которые могут включать скиллы, агентов, хуки и MCP-серверы. Они предназначены для распространения функциональности между командами, проектами или через маркетплейсы, предлагая версионирование и простоту установки. В отличие от одиночных скиллов, плагины предоставляют комплексное решение, а от MCP-серверов отличаются тем, что не являются сами по себе внешними процессами, а лишь упаковывают их. Установка плагинов происходит через маркетплейсы, включая официальный claude-plugins-official.

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

Плагин Claude Code — это самодостаточный каталог, который объединяет различные компоненты для расширения функциональности Claude Code. Он представляет собой пакет, который может содержать: скиллы (slash-команды), субагентов, хуки, MCP-серверы и даже LSP-серверы. Главное отличие плагина от отдельных скиллов или MCP-серверов заключается в его способности упаковывать несколько таких элементов в единое целое, что упрощает их распространение, версионирование и повторное использование.

Когда использовать плагины:

• Совместное использование: Если вы хотите поделиться набором функциональности с вашей командой или сообществом. code.claude.com
• Повторное использование: Когда вам нужны одинаковые скиллы или агенты в нескольких проектах. code.claude.com
• Контроль версий: Для обеспечения версионности и простых обновлений ваших расширений. code.claude.com
• Распространение через маркетплейс: Если вы планируете предлагать свои расширения через каталог плагинов. code.claude.com

Плагин, скилл и MCP-сервер: в чем разница?

Эти три понятия часто путают, но они находятся на разных уровнях абстракции и выполняют разные функции. Понимание их различий критически важно для эффективной работы с Claude Code.

Скилл (Skill)

Скилл — это, по сути, Markdown-инструкция (SKILL.md), которая учит агента Claude Code конкретной процедуре или способу выполнения задачи. Это одна «способность» или «команда», которую вы или агент можете вызвать, используя префикс /. Скиллы могут быть автономными (в директории .claude/) или частью плагина. Если скилл является частью плагина, его имя будет иметь пространство имен, например, /plugin-name:hello. code.claude.com

MCP-сервер (Model Context Protocol Server)

MCP-сервер — это внешний процесс или сервис, который обеспечивает Claude Code доступ к внешним инструментам и данным через протокол Model Context Protocol. Он отвечает на вопрос «что агент умеет звать», предоставляя новые действия и данные. MCP-серверы могут быть частью плагина или устанавливаться отдельно. Они позволяют Claude Code взаимодействовать с API, базами данных и другими внешними системами. insidepc.tech

Плагин (Plugin)

Плагин — это пакет, который может содержать один или несколько скиллов, MCP-серверов, агентов, хуков и других компонентов. Он отвечает на вопрос «как это упаковать и раздать». Плагин не добавляет Claude Code новых способностей сверх этих «кирпичей», но он их объединяет и делает легко устанавливаемыми и управляемыми. Плагин — это способ дистрибуции, а не новая возможность агента. insidepc.tech

Как устанавливать плагины Claude Code

Установка плагинов в Claude Code — это двухэтапный процесс, который начинается с подключения маркетплейса и затем установки самого плагина. ofis-ai.ru

Шаг 1: Подключение маркетплейса

Официальный маркетплейс Anthropic (claude-plugins-official) автоматически доступен при первом интерактивном запуске Claude Code. Если вам нужен другой маркетплейс (например, для внутренних плагинов вашей компании), вы можете добавить его с помощью команды:

/plugin marketplace add <URL_маркетплейса>

Маркетплейс — это, по сути, GitHub-репозиторий с каталогом плагинов. ofis-ai.ru

Шаг 2: Установка плагина

После того как маркетплейс подключен, вы можете установить плагин. Для установки плагина из официального маркетплейса используйте команду /plugin install @claude-plugins-official/<имя_плагина>. Например, для установки интеграции GitHub:

/plugin install @claude-plugins-official/github code.claude.com

При установке плагина вы можете выбрать область его действия: code.claude.com

• User scope: Устанавливает плагин для вас во всех проектах.
• Project scope: Устанавливает плагин для всех сотрудников в текущем репозитории.
• Local scope: Устанавливает плагин только для вас в текущем репозитории.

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

/reload-plugins code.claude.com

Скиллы, входящие в состав плагина, будут иметь пространство имен по имени плагина. Например, плагин commit-commands предоставит скиллы вроде /commit-commands:commit. code.claude.com

Где брать плагины Claude Code

Основное место для поиска плагинов — это маркетплейсы. Официальный маркетплейс Anthropic (claude-plugins-official) уже встроен в Claude Code. Вы можете просмотреть доступные плагины, запустив /plugin и перейдя на вкладку Discover, или посетив каталог на claude.com/plugins. code.claude.com

Примеры популярных плагинов из официального маркетплейса:

• Интеграции с внешними сервисами: Эти плагины объединяют предварительно настроенные MCP-серверы для подключения Claude к внешним инструментам без ручной настройки. code.claude.com

  • Source control: github, gitlab
  • Project management: atlassian (Jira/Confluence), asana, linear, notion
  • Design: figma
  • Infrastructure: vercel, firebase, supabase
  • Communication: slack
  • Monitoring: sentry

• Плагины для общих задач разработки: code.claude.com

  • commit-commands: рабочие процессы Git commit, push и создание PR.
  • pr-review-toolkit: специализированные агенты для проверки pull requests.
  • agent-sdk-dev: инструменты для разработки с Claude Agent SDK.
  • plugin-dev: набор инструментов для создания собственных плагинов.

При просмотре плагинов в Claude Code вы можете увидеть дополнительную информацию: code.claude.com

• Context cost: Оценка стоимости контекста (сколько токенов плагин добавит к окну контекста). (Claude Code v2.1.143+)
• Last updated: Дата последнего обновления плагина. (v2.1.144+)
• Will install: Раздел, перечисляющий все команды, агентов, скиллы, хуки и MCP/LSP серверы, которые будут установлены. (v2.1.145+)

Создание собственных плагинов

Если вы хотите создать свой собственный плагин, это также возможно. Плагин — это, по сути, директория, содержащая файл манифеста plugin.json в поддиректории .claude-plugin/. Внутри этой директории вы можете размещать свои скиллы (в папке skills/), MCP-серверы (.mcp.json) и другие компоненты. code.claude.com

Для быстрого старта можно использовать команду plugin init, которая создаст базовую структуру плагина. Такие локально обнаруженные плагины не копируются в кэш, а используются напрямую из вашей рабочей директории. code.claude.com

Для более глубокого понимания того, как работают скиллы, рекомендуем ознакомиться с нашей статьей Claude Skills: что это и как создать свой скилл. Если вас интересует создание MCP-серверов, вам поможет материал Как создать MCP-сервер на Python: гайд.

Частые вопросы

Могу ли я использовать скиллы без плагинов?

Да, вы можете использовать скиллы без плагинов. Автономные скиллы хранятся в директории .claude/ в вашем домашнем каталоге или в каталоге проекта. Они идеально подходят для личных рабочих процессов, настроек для конкретного проекта или быстрых экспериментов. Плагины же используются, когда вам нужно поделиться набором скиллов и других компонентов с командой, версионировать их или распространять через маркетплейс.

Зачем нужен маркетплейс плагинов?

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

В чем преимущество плагинов перед просто набором скиллов и MCP-серверов?

Основное преимущество плагинов в том, что они объединяют различные типы расширений (скиллы, агенты, хуки, MCP-серверы) в единый, легко управляемый пакет. Это обеспечивает согласованность, упрощает установку и обновление, а также позволяет контролировать версии всего набора. Для командной работы или распространения через маркетплейс плагины предлагают структурированный и стандартизированный подход, предотвращая конфликты имен благодаря пространству имен скиллов.

Что такое пространство имен скиллов в плагинах?

Пространство имен скиллов — это механизм, который предотвращает конфликты между скиллами из разных плагинов. Когда скилл является частью плагина, его имя автоматически получает префикс, соответствующий имени плагина. Например, скилл hello из плагина my-first-plugin будет вызываться как /my-first-plugin:hello. Это гарантирует, что даже если два разных плагина содержат скиллы с одинаковым именем, они не будут конфликтовать, поскольку их полные имена будут уникальными.

Могут ли плагины включать в себя MCP-серверы?

Да, плагины могут включать в себя MCP-серверы. Это одна из ключевых особенностей плагинов, позволяющая им предоставлять комплексные интеграции. MCP-серверы, встроенные в плагин, запускаются автоматически при его включении и отображаются как стандартные инструменты MCP в наборе инструментов Claude Code. Это позволяет плагинам не только обучать агента новым процедурам (через скиллы), но и предоставлять ему доступ к внешним сервисам и данным, упаковывая все необходимое для работы с ними в один пакет.