Документация Claude Code Plugins: что такое плагины, как их установить и когда использовать MCP вместо них

Если вы ищете документцию по плагинам lude Coe, краткий отет таков: плагины — это уровень упаковки для расширений lade Coe. Плагин может обеднять навыки, агентов, хуки, MCP-ерверы, LSP-ерверы и монитоы в оин устанвливаемй блк, в то время как MCP остатся уровнем подлчения инструментов вниз. Если вы искал «mcp plugin» или «oc plugin», то обычно документция преллагает вам такое разделние: плагины распространяют настройку, MCP подключает инструменты, а спровная документция обянет техническую форму кажой части.

Clude Coe теперь имеет достаточно большую поверхность расшерний, что терминология может бырто запутаься. «Plugin» часто используется как обобщение для всего, даже когда реальная функция — это навк, хук или MCP-сервер. Эта путаница важна, потому что шаги устаноки, модель бесопасности и нагрузка на облуживание разные для кажого.

Пржде чем мы прйdem к настройке, оа практическая заметка для команд, которые хотят больше гибкости бэкенда, чем рабочий процсс только с закртыми модлями: уровень расшерний lade Coe отделен от модли, которая работает за ним. Это означает, что вы можете сохранить ту ж самую настройку плагина, навыка и MCP, маршрутизируя инференс через модль с открытыми весами на Novita I, например qen/qen3-oder-480b-a35b-instruct, которая является достоверным вариантом для реальной работы с репозиторием, когда вы хотите больше контроля стоимости, не отказываясь от агентных инструментов.

Что ткущщая докуменатция подчеркивает

Текущиая документаация lade Coe теперь четко разделает четыре вещи:

• плагины, которые упаковывают многократно используемые расшерния;
• MCP, который подключает lade Coe к внешним инструментам и источникам данных;
• навыки и подпагенты, которые содежат многократно используемое поведение;
• хуки, которые автоматизируют действия в жизненных событиях.

Это означает, что многие запросы «Claude Coe plugins docs» на самом деле являются запросами справку по плагинам, процесс обнаружения/установки или документы MCP, которые обяняют, как работает подключение инструментов. Текущая документация также раскрывает процессы установки и распространения на основе маркетплейса, поэтому вы можете устанвливать предварительно собраные плагины вместо того, чтобы вручную подключать каждную составляющую.

Что такое плагины Claude Code на самом деле

Текщая документация Anthropic определяет плагины ка слой распространния и повторного использования расшерний lade Coe. На практике это означает, что плагин — это самодостаточная дректория с манифестом и необязательными компонентами-расшерниями, такими как:

• навыки
• агенты
• хуки
• конфигурация MCP
• конфигурация LSP
• вспомогательные бинарные файлы
• настройки по умолчанию

Вот почему официальная документция по плагинам важна, даже если на самом деле вам нужен многократно используемый навык или одноразовая MCP-основ. Плагин часто является тем, что вы устанавливаете, но поведение, которое вас интересует, находтся внутри упакованных компонентов.

Самое важное следствие — именование. Навыки плагина имеют пространство имен, так что команда из плагина выглядит следующим образом:

/мой-плагин:привет

Это пространство имен не косметическое. Оно предотвращает столкновения между плагинами, которые поставляют команды с одинаковыми именани.

Плагины против MCP против навыков против хуков

Это то, где большинство разработчиков теряют время в документации.

Используйте этот справочник:

Особенность	Что делет	Лучший случай использования
Плагин	Упакоывает и распространяет расшерния	Повторно использовать одинаковую настройку в разных проектах или у коллег
MCP	Подключает lade Coe к внешним инструментам и сервисам	GitHub, Notion, базы данных, автоматизация браузера, внутренние API
Навык	Предоставляет lade многократно используемые знания или рабочий процсс	Контрольные списки ревью, процессы развертывания, домашний стиль, повторяемые просить
Хук	Запускается автоматически в жизненных событиях	Линтинг после правок, блокировка опасных команд, запуск уведомлений

Многие вопросы «Claude Code plugin» на самом деле являются вопросами MCP. Если ваша цель — «подключить lade Coe к Jira» или «позволить lade запрашивать нашу базу данных», вы в основном не ищете функцию плагина. Вы ищете сервер MCP, который может быть устанвлен напрямую или упакован внутри плагина. На практике это означает, что многие поиски MCP plugin на самом деле являются поисками правильного сервера плюс правильного пути упаковки и установки.

Вот почему обзор функций в документции Anthropic полезен: он явным образом разделяет плагины от MCP и от навыков. Плагины — это обертка. MCP — это внешнее подключение. Навыки — это многократно используемые инструкции. Хуки — это слой автоматизации.

С точки зрения стека Novita это также самое чистое место для разделения мыслительных процессов и выполнения. Если вы строите пользовательский рабочий процесс, связанный с lade Coe, вокруг инструментов MCP, API LLM от Novita может обрабатывать слой мыслительных процессов по использованию инструментов, в то время как Novita Agent Sandbox обрабатывает слой изолированного выполнения для кода, команд оболчки и побочных эффектов инструментов. Это разделение естественным образом отображается на границу «модель решает» против «редактор времени выполнения», которую действительно описывают документции плагинов и MCP.

Когда следует использовать плагин

Используйте плагин, когда хотя бы одно из этих утверждений верно:

• вы хотите одинаковую настройку lade Coe в нескольких репозиториях;
• вы хотите, чтобы коллеги устанавливали одно что-то вместо копирования файлов .lade/ вручную;
• вы хотите версионированную, многократно используемую упаковку навыков, хуков или конфигураций MCP;
• вы планируете распространять расширение через маркетплейс.

Не хватайтесь за плагин в первую очередь, если вы только экспериментируете в одном репозитории. Документация Anthropic по-прежнему рекомендуют начинать с самостоятельной конфигурации .lade/ для быстрого прототипирования. Это путь с меньшим трением для специфических для проекта рабочих процессов.

Другими словами:

• самостоятельная конфигурация лучше для локальных экспериментов;
• плагины лучше для портативности и распространения.

Самый быстрый способ установить существующий плагин

Если вы уже знаете имя плагина и маркетплейс, текущая документация указывет на команду слеша изнутри lade Coe.

Например, в документции MCP Anthropic используется этот путь установки для официального плагина mcp-server-dev:

/plugin install mcp-server-dev@claude-plugins-official

Если lade Coe сообщает, что маркетплейс отсутствует, добавьте его сначала:

/plugin marketplace add anthropics/claude-plugins-official

Затем повторно выполните команду установки.

После установки проверьте, говорит ли lade вам перезагрузить плагины. Если да, выполните:

/reload-plugins

Этот шаг перезагрузки важен больше, кажется. Это распространенная причина, по которой разработчики думают, что плагин «не сработал», когда файлы присутствуют, но команды не активны в текущей сессии.

Как создать свой собственный плагин для Claude Code

Если вы хотите создать свой собственный плагин, текущая документация по плагинам описывает прямой быстрый старт:

1. Создайте директорию плагина.
2. Добавьте .claude-plugin/plugin.json.
3. Добавьте директорию skills/, agents/, hooks/ или другую поддерживаемую директорию расширения.
4. Запустите lade Coe с --plugin-dir во время разработки.

Самый маленькый полезный пример — плагин, который поставляет один навык. Документация Anthropic показывает манифест плюс папку skills/<name>/SKILL.md. Манифест определяет идентичность плагина, а навык становится командой с пространством имен.

Во время разработки канонический тестовый поток таков:

claude --plugin-dir ./my-first-plugin

Затем вызовите навык изнутри lade Coe:

/my-first-plugin:hello

Одна деталь, которую легко пропустить: только plugin.json принадлежит внутри .claude-plugin/. Ваши директории skills/, agents/ и hooks/ остаются на корневом уровне плагина, а не вложены под .claude-plugin/.

Почему в документации по плагинам постоянно упоминается MCP

Потому что плагин может поставлять конфигурацию MCP.

Это полезно, когда у вас есть внутренний сервис, который каждый инженер в вашей команде должен достичь через lade Coe. Вместо того, чтобы говорить всем вручную настраивать один и тот же сервер MCP, вы можете упаковать эту конфигурацию вместе с остальным рабочим процессов lade Coe.

Это не делает MCP устаревшим. Это просто меняет способ доставки сервера.

Думайте об этом так:

• MCP отвечает: «Как lade общается с этой внешней системой?»
• Плагин отвечает: «Как мы чисто распространяем эту настройку?»

Если вы разрабатываете внутренюю платформу для разработчиков, это различие сохраняет много дублирующей работы по настройке.

Когда MCP является лучшей отправной точкой

Начните с MCP, а не с плагина, когда основное требование — внешний доступ:

• трекеры задач
• инструменты мониторинга
• Slack
• Notion
• базы данных
• автоматизация браузера
• внутренние HTTP-сервисы

Текущая документация MCP от Anthropic показывает четыре распространенных режима подключения:

• удаленные HTTP-серверы
• удаленные SSE-серверы
• локальные stdio-серверы
• удаленные WebSocket-серверы

Для большинства облачных сервисов HTTP является рекомендуемым транспортом. SSE все еще документирован, но Anthropic помечает его как устаревший там, где доступен HTTP.

Если вам просто нужно подключить один сервис для себя, claude mcp add обычно является самым чистым местом для начала. Оберните его в плагин позже, если настройка окажется многократно используемой.

MCP дает lade Coe способ достигать инструментов, но он не заменяет безопасную среду выполнения, когда одному из этих инструментов нужно выполнять код, касаться файлов или выполнять команды. В этой схеме API LLM от Novita является серверной частью reasoning, которая решает, когда и как вызывать инструменты, в то время как Novita Agent Sandbox является более безопасной средой выполнения для стороны рабочего процесса, связанной с кодом. Если ваш плагин или сервер MCP открывает удаленное выполнение кода, автоматизацию браузера или вспомогательные средства на основе оболчки, это разделение — больше, чем архитектурная гигиена. Это разница между «lade может вызывать этот инструмент» и «этот инструмент работает в изолированной среде вместо ноутбука инженера или общего хоста».

Практическое правило для принятия решения

Если вы все еще не уверены, какая страница документации вам на самом деа нужаеться, используйте это правило:

• «Я хочу, чтобы lade Coe делал что-то одинаково в каждой сессии». Начните с CLAUDE.md или навыка.
• «Я хочу, чтобы lade Coe общался с другой системой». Начните с MCP.
• «Я хочу, чтобы эта настройка была легко переносима и доступна для повторного использования». Упакуйте ее как плагин.
• «Я хочу, чтобы что-то запускалось автоматически по событию». Используйте хук.

Это полезнее, чем запоминание названий функций, потому что оно напрямую отображается на проблему, которую вы решаете.

Где это вписывается в реальный рабочий процесс

Если плагин или настройка MCP являются лишь одной частью боле крупного агентного стека, сочетайте это с Что такое кодовые агенты?, Среда выполнения агента против интерпретатора кода и Песочница для MCP-серверов: изолированные MCP-серверы с файловой системой, секретами и сетевым контролем. Это дает вам полную цепочку от планирования до доступа к инструментам и изолированного выполнения.

Хороший рабочий процесс с плагинами для реальных команд

Для большинства команд самый чистый прогрессия выглядит так:

1. Прототипируйте рабочий процесс в .claude/ или с помощью прямых команд claude mcp add.
2. Сохраните только те части, которые оказались полезными в реальной работе.
3. Упакуйте эти части в плагин с четким манифестом и навыками с пространством имен.
4. Поделитесь им через маркетплейс или внутреннюу схему распространения.

Это избегает самого распространенного режима отказа: превращения каждой идеи в плагин до того, как кто-то узнает, стоит ли поддерживать этот рабочий процесс.

Если ваша команда сочетает lade Coe с альтернативной моделью бэкенда, это также этап, на котором Novita I может быть полезна операционно. Слой плагинов и MCP остается прежним, в то время как маршрутизация моделей может быть передана API LLM от Novita для сессий с интенсивным кодом, которые не требуют премиальной закрытой модели на каждом шагу. Это разделение часто проще, чем перепроектирование самого стека расширений.

Частые ошибки при установке плагинов Claude Code

Это ошибки, которые отнимают больше всего времени:

Восприятие каждого расширения как плагина

Иногда правильный ответ — это простой навыка или прямая конфигурация сервера MCP. Упаковка слишком рано добавляет нагрузки по обслуживанию.

Размещение файлов в неправильной директории

plugin.json находится в .claude-plugin/. Навыки и хуки — нет.

Забывание о пространстве имен

Навык плагина вызывается с префиксом плагина, а не как глобальная команда.

Пропуск перезагрузки после установки

Если lade говорит вам выполнить /reload-plugins, сделайте это, прежде чем предполагать, что установка не удалась.

Использование плагина, когда реальная потребность в MCP

Если основная проблема — подключение инструментов, сосредоточьтесь на MCP сначала и упакуйте позже.

Итог

Документация плагинов lade Coe становится понятнее, как только вы перестаете относиться к «плагину» как к единственному понятию расширения. Плагины — это слой распространения. Навыки содержат многократно используемые инструкции. Хуки автоматизируют жизненные события. MCP подключает lade Coe к внешним системам.

Этот контекст делает остальную часть документации гораздо боле легкой для навигации. Если ваша цель — быстрая установка, начните с наименьшей работающей единицы, которая решает проблему. Добавляйте упаковку только тогда, когда настройка стоит повторного использования.

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

Есть ли плагины Claude Code то же самое, что и серверы MCP?

Нет. Серверы MCP — это слой подключения для внешних инструментов и сервисов. Плагины — это слой упаковки, который может включать конфигурацию MCP вместе с навыками, хуками, агентами и другими расширениями lade Coe.

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

Изнутри lade Coe используйте команду /plugin install с именем плагина и маркетплейса. Если маркетплейс отсутствует, добавьте его с помощью /plugin marketplace add ..., затем перезагрузите плагины, если lade предлагает это.

Следует ли использовать плагин или просто файлы .claude/?

Используйте файлы .claude/ для быстрой итерации, специфичной для проекта. Используйте плагин, когда настройку необходимо повторно использовать в разных проектах, делиться с коллегами или распространять через маркетплейс.

Когда следует использовать MCP вместо плагина?

Используйте MCP в первую очередь, когда ваша главная цель — внешний доступ к системам, таким как GitHub, Jira, Notion, Slack или внутренним API. Если вы сравниваете руководство по MCP plugin со страницей документации по плагинам, рассматривайте руководство по MCP как справку по подключению инструментов, а страницу документации по плагинам — как справку по упаковке. Упакуйте эту настройку в плагин позже, только если вам нужна чистая повторная используемость и распространие.

Могут ли плагины Claude Code работать с моделями бэкенда, отличными от моделей Anthropic?

Да. Слой расширений и модель бэкенда — это отдельные концепции. На практике это означает, что вы можете сохранить одну и ту же настройку плагина и MCP от lade Coe, одновременно маршрутизируя инференс через совместимого провайдера, такого как Novita AI, для поддерживаемых кодовых процессов.

Рекомендуемые статьи

• Claude Code Plugins: Как инструменты MCP расширяют Claude Code с помощью внешних возможностей
• Claude Code Rules: Как писать CLAUDE.md и управлять агентным кодовым контекстом
• Создайте сервер MCP с удаленным выполнением кода с помощью Novita Sandbox и библиотеки mcp-use

Источники проверены 31 авга 2026 года: Обзор функций lade Coe, Документация плагинов lade Coe, Документация MCP lade Coe и Библиотека моделей Novita I.