Claude AI Bible, глава 15: Plugins и marketplaces
Главная мысль: plugin — это пакет, в котором одной установкой приезжает целая возможность: skill, MCP server, slash-команды и агенты. Marketplace — каталог, из которого такие пакеты ставят. Главное в пакете — не удобство, а то, что части выходят и обновляются вместе. При этом ставить plugin нужно так же осторожно, как любую программу с доступом к вашим аккаунтам.
О чём глава
Заголовок раздела «О чём глава»В главе 14 мы собрали skill. Но рабочая возможность часто состоит из нескольких частей. Например, skill для заметок о релизе работает, только если есть связь с трекером задач, команда для запуска и агент, который сверяет текст с правилами стиля. Коллеге, который попросит «то же самое», придётся дать не одну вещь, а домашнее задание из четырёх пунктов. Глава объясняет, как упаковать такую систему, раздать её, проверить чужой пакет и навести порядок в команде.

На схеме пример из главы: файл plugin.json описывает пакет и ссылается на четыре части, а MCP server ходит наружу, в трекер задач.
Что такое plugin
Заголовок раздела «Что такое plugin»Plugin — это устанавливаемый пакет, в котором может быть четыре вида частей:
| Часть | Что делает |
|---|---|
skill | Инструкции, которые Claude подключает, когда задача подходит (глава 14) |
MCP server | Связь с внешней системой: трекером, базой данных (глава 16) |
slash-команда | Короткая команда в сессии, которая запускает сохранённое действие |
| Агент | Отдельный исполнитель со своими инструкциями и границами |
Состав бывает любым: от набора skill до всех четырёх частей сразу. Автор подчёркивает, что главная польза — надёжность. Части выходят одной версией и обновляются вместе, поэтому ни у кого не окажется нового skill со старой командой.
Как plugin связан со skill и MCP
Заголовок раздела «Как plugin связан со skill и MCP»Эти слова часто путают, поэтому автор раскладывает их по уровням. Самая маленькая единица — skill: папка с инструкциями, которая учит Claude одной задаче. Связь с внешним миром даёт MCP server — работающая программа, которая открывает Claude внешние инструменты и данные в стандартном виде. А plugin — упаковка, которая доставляет всё это одной установкой.
Значит, plugin не конкурирует со skill и MCP, а только оборачивает их. Автор сравнивает так: skill — деталь, MCP server — подключение к электросети, а plugin — прибор, который приходит собранным и сразу включается в розетку.
Ловушка. Не делайте plugin там, где хватит skill. Один набор инструкций без связи, команды и агента — это skill, а обёртка только добавит лишние версии и запутает коллег. Берите самый маленький контейнер, в который помещается сделанное.
Установка plugin
Заголовок раздела «Установка plugin»Внутри Claude Code установка — один шаг: части регистрируются сами, а MCP server при первом подключении может попросить ключ доступа. Обычно plugin берут из marketplace. Команды в книге выглядят так:
/plugin # посмотреть, что можно поставить/plugin install release-notes-kit@acme-internal # поставить plugin из добавленного marketplace/plugin list # что уже стоит/plugin uninstall release-notes-kit@acme-internal # удалить целикомАвтор предупреждает, что синтаксис меняется, поэтому сверяйтесь со справкой в сессии и docs.claude.com. Принцип не меняется: установка добавляет весь пакет, удаление убирает его целиком.
Важно выбрать уровень установки. Пакет для себя видят только ваши сессии. Пакет на уровне проекта записан в настройках репозитория, и его автоматически получает каждый, кто откроет проект в Claude Code. Для общей работы автор советует второй вариант: так возможность хранится вместе с кодом, а не в личных настройках.
От чего plugin не спасёт
Заголовок раздела «От чего plugin не спасёт»Упаковка не делает плохую возможность хорошей. Если skill внутри не срабатывает из-за размытого описания, пакет просто раздаст его большему числу людей. Если MCP server требует ключ, которого у человека нет, установка пройдёт, а работать ничего не будет. «Упаковка — это логистика, а не магия», — пишет автор.
Plugin решает задачи раздачи (как обновить сорок человек сразу), но не проектирования. Поэтому каждую часть сначала проверяют отдельно, потом вместе, и только в конце упаковывают. Иначе все получат одинаково сломанную вещь, и каждый решит, что ошибся сам.
Что такое marketplace и как его добавить
Заголовок раздела «Что такое marketplace и как его добавить»Если plugin — прибор, то marketplace — полка, на которой он стоит. Это каталог пакетов, и благодаря ему их не пересылают архивами в чате. Единого официального каталога нет: вы сами добавляете публичный каталог сообщества, внутренний каталог компании или каталог поставщика. Каждый каталог добавляют по источнику, например по git-репозиторию:
/plugin marketplace add acme-internal https://github.com/acme/claude-plugins/plugin # теперь его plugin видны в спискеПояснение: в документации Claude Code имя каталога берётся из его файла
marketplace.json, поэтому команда короче:/plugin marketplace add acme/claude-plugins.
Для команды внутренний marketplace — проверенная полка вместо всего, что нашлось в интернете. Автор советует не усложнять: даже один git-репозиторий с тремя-четырьмя пакетами стоит тех нескольких часов, что уйдут на настройку, а новички сразу видят, что уже есть.
Проверка plugin перед установкой
Заголовок раздела «Проверка plugin перед установкой»Это самая важная часть главы. В plugin могут быть MCP server и агенты, поэтому установка может дать программе право читать ваши данные и действовать в ваших системах. Автор даёт порядок проверки по важности:
- Источник. Почему вы доверяете автору пакета? Внутренний каталог и неизвестный автор из публичного списка — это разные уровни доверия. «Выглядел полезным» — это не доверие.
- Содержимое. Посмотрите, какие внутри
skillи агенты, к чему подключаютсяMCP serverи есть ли у них право на запись. Ищите сюрпризы: лишнее право на запись, скрытые инструкции агента. - Доступы и ключи. Каждый раз спрашивайте, нужен ли запрошенный доступ для задачи. Помощнику для постов в соцсетях не нужна запись в систему платежей.
- Минимальные права. Только чтение вместо чтения и записи, узкий токен вместо главного ключа. Если пакет окажется с ошибками или вредным, ущерб будет меньше.
Ловушка. В спешке вы дали пакету широкий ключ и забыли о нём, а ключ всё ещё действует. Поэтому не давайте лишних прав при установке и отзывайте доступ у пакетов, которыми больше не пользуетесь.
Какие бывают plugins
Заголовок раздела «Какие бывают plugins»Автор описывает три собирательных типа:
| Тип | Центр | Почему пакет |
|---|---|---|
| Рабочий процесс | skill; MCP server даёт ему данные, команда запускает, агент проверяет | Без связи skill бесполезен, без команды неудобен |
| Коннектор | MCP server; skill учат Claude особенностям сервиса | Поставщик раздаёт сервер с разумными настройками |
| Набор | Несколько связанных skill без внешних связей | Одна установка и одна версия вместо двенадцати |
Тип подсказывает, что положить в пакет: процессу — связь с данными и команду для запуска, связи — инструкции для удобной работы с сервисом, набору — все связанные инструкции.
Свой plugin
Заголовок раздела «Свой plugin»Plugin — это папка с файлом-описанием (manifest) и самими частями. В manifest лежат имя, версия и описание, а каждая часть устроена так же, как без пакета. В книге manifest перечисляет части в отдельном поле, и автор просит сверять схему с документацией. В текущем Claude Code этот файл лежит в .claude-plugin/plugin.json, а части Claude Code находит сам по стандартным папкам. Наш вариант:
{ "name": "release-notes-kit", "version": "1.2.0", "description": "Пишет и проверяет заметки о релизе по задачам из трекера. Используй, чтобы написать release notes или changelog.", "author": {"name": "Platform Team"}}Скрипт ch15_plugin_check.py раскладывает этот пакет по папкам и проверяет manifest:
Файлы plugin: .claude-plugin/plugin.json .mcp.json agents/style-checker.md commands/release-notes.md skills/format-release-notes/SKILL.mdПроверка manifest: okАвтор даёт два совета: честно поднимайте версию при каждом изменении поведения и пишите описание пакета как описание skill, с ситуациями и словами-триггерами. В задании он предлагает нарисовать папку plugin для своего skill и той части, которую вы каждый раз настраиваете руками: так видно, нужен ли пакет.
Публикация через marketplace
Заголовок раздела «Публикация через marketplace»Чтобы поделиться пакетом, его кладут в marketplace, обычно во внутренний. Удобнее всего, когда репозиторий и есть каталог: выпустили версию 1.3 — на полке 1.3. Актуальная версия лежит в одном месте, и на вопрос «у тебя последняя версия?» есть точный ответ.

Схема показывает весь путь: от автора на полку, с полки к людям, и так же для каждой новой версии.
Обновления без поломок
Заголовок раздела «Обновления без поломок»После публикации номер версии становится договором. Совместимое дополнение — это minor, например 1.2.0 до 1.3.0, и обновиться можно не думая. Изменение, которое ломает прежнюю работу (переименована команда, у skill другой формат вывода), требует major и заметки о том, что сломалось. Пользователь обновляется одной командой:
/plugin marketplace update acme-internal # обновить список пакетов каталога/plugin update release-notes-kit@acme-internal # обновить установленный pluginРаньше исправление рассылали архивом, и половина людей его не ставила, а с каталогом все переходят на новую версию.
Ловушка. Вы переименовали /release-notes в /notes и назвали это версией 1.4. Для сорока коллег plugin просто «перестал работать». Любое изменение имени команды, триггера или формата вывода — ломающее, и оно требует major и объявления. Наш скрипт проверяет это правило:
Проверка версий: 1.2.0 -> 1.3.0: поднят minor, нужен minor. ok 1.3.0 -> 1.4.0: поднят minor, нужен major. ОШИБКА: нужен major 1.3.0 -> 2.0.0: поднят major, нужен major. okПорядок для команды
Заголовок раздела «Порядок для команды»В команде правило «ставь что нравится» опасно: пакеты приносят связи и ключи, и скоро никто не знает, у какой программы к чему есть доступ. Основа порядка (governance) — внутренний marketplace как единственный разрешённый источник. Пакет попадает на полку только после проверки, поэтому «поставить из каталога компании» значит «поставить проверенное». Поверх этого автор советует решить, кто может публиковать, вести учёт установок и давать по умолчанию только узкие токены.
В маленькой команде хватит одного владельца полки и пятиминутного обзора, в большой компании проверку встраивают в процессы одобрения ПО. Обзор отвечает на четыре вопроса и записывает ответы: что внутри, куда пакет ходит и может ли писать, какой ключ нужен и самый ли он узкий, кто владелец. Владельца назначают сразу при одобрении, иначе пакет остаётся на полке без присмотра, а его ключ продолжает действовать. Раз в квартал полку проходят заново: ненужные пакеты убирают, их ключи отзывают.

Верхний ряд схемы — проверка одного пакета, нижний — цикл, который команда повторяет постоянно.
Пример из книги: логистическая компания из Роттердама дала Claude Code шестидесяти сотрудникам и разрешила ставить пакеты откуда угодно. Через месяц у пакетов без владельца оказались API-ключи, два из них — к системам с данными об отправках клиентов. Утечки не было, но проверка безопасности подняла тревогу. Пакеты при этом не запретили: это убило бы пользу от них. Компания сделала один внутренний marketplace и поручила platform-инженеру проверять всё до публикации. Лишние ключи отозвали, а польза почти вся осталась. Вывод инженера: против риска помогает не меньше пакетов, а доверенная полка и минимальные права.
Итоги главы
Заголовок раздела «Итоги главы»Plugin— это пакет, в котором одной версией приезжаютskill,MCP server,slash-команды и агенты.- Нужен самый маленький контейнер:
pluginоправдан, только когда частей несколько. Pluginрешает раздачу, а не качество, поэтому части проверяют до упаковки.Marketplaceдобавляют по источнику, и внутренний каталог становится проверенной полкой команды.- Для общей работы пакет лучше ставить на уровне проекта.
- Перед установкой проверяют источник, содержимое и доступы, а права дают самые узкие.
- Изменение того, чем пользуются люди, требует
majorи объявления. - Порядок для команды держится на внутреннем каталоге, владельцах пакетов и чистке раз в квартал.
Ключевые термины
Заголовок раздела «Ключевые термины»| Термин | Значение |
|---|---|
plugin | Устанавливаемый пакет из skill, MCP server, slash-команд и агентов |
marketplace | Каталог пакетов, который добавляют по источнику |
manifest | Файл plugin.json: имя, версия, описание пакета |
| Уровень проекта | Установка из настроек репозитория для всех, кто его открыл |
| Минимальные права | Самый узкий доступ, с которым пакет делает работу |
Что это значит на практике
Заголовок раздела «Что это значит на практике»- Общие
skillдля dbt-моделей и связь с хранилищем удобно раздать однимpluginна уровне репозитория. MCP serverк хранилищу в пакете получает роль только на чтение и только к нужным схемам.- Внутренний
marketplace— это обычный git-репозиторий, а новые пакеты проверяют через pull request. - Переименовать команду в общем пакете — то же, что переименовать колонку в витрине: нужен
majorи предупреждение.
Вопросы для самопроверки
Заголовок раздела «Вопросы для самопроверки»- Почему главная польза
plugin— надёжность, а не удобство? - Когда стоит обойтись одним
skill? - Почему пакет для общей работы лучше ставить на уровне проекта?
- Почему при проверке источник стоит первым?
- Почему переименование команды требует
major? - Что не даёт пакетам в команде копить риск?
Предыдущая: Skills — многоразовые умения. Следующая: Model Context Protocol (MCP).