Публикация и распространение плагина

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

Следующие случаи рассматриваются на других страницах:

Ваш плагин еще не готов: начните с Создание плагина
Вы поддерживаете CLI или SDK с плагином в официальном маркетплейсе: см. Рекомендуйте свой плагин из вашего CLI

Начните с Выбор способа распространения, чтобы сравнить варианты распространения. Если вы уже знаете свой путь, перейдите к Подготовка плагина к выпуску, а затем следуйте разделу вашего маршрута, чтобы узнать, что сказать пользователям и как они получают ваши обновления.

Выбор способа распространения

Выберите вариант распространения в зависимости от того, кому нужно установить плагин:

Маршрут	Кто может установить	Что вам нужно	Получают ли пользователи ваши обновления автоматически?
Без маркетплейса	Люди, которым вы отправили папку плагина или файл `.zip`	Папка плагина	Нет. Они загружают копию, которую вы отправили
Собственный маркетплейс	Любой, кто может получить доступ к репозиторию, который может быть приватным, который может клонировать ваша команда	Репозиторий git или другой хост с файлом `.claude-plugin/marketplace.json`, который содержит список вашего плагина	Выключено
Маркетплейс сообщества Anthropic	Любой, кто добавит `anthropics/claude-plugins-community`	Отправка через форму отправки каталога плагинов	Выключено

Автоматическое обновление — это параметр маркетплейса на стороне пользователя, который получает новые версии в фоновом режиме.

Подготовка плагина к выпуску

Имя, версия, валидация и установка из маркетплейса определяют, будет ли выпуск работать для людей, которые его установят. Проверьте их перед первым выпуском и снова перед каждым последующим.

Выберите постоянное имя

Пользователи устанавливают, включают и настраивают ваш плагин по name@marketplace, поэтому переименованный плагин — это другой плагин для каждой существующей установки. Выберите имя в формате kebab-case, например deploy-helper, потому что claude plugin validate предупреждает о других формах, и рассматривайте его как постоянное. Установите displayName в plugin.json для метки, которую видят пользователи.

Решите, как вы будете версионировать

Если вы установите version в plugin.json и позже отправите коммиты без его изменения, claude plugin update выведет <name> is already at the latest version (1.0.0). и пользователи сохранят старую копию. Либо увеличивайте version при каждом выпуске, либо опустите его в маркетплейсе, размещенном на git, чтобы Claude Code использовал SHA коммита вместо этого. См. Версии и обновления.

Валидация

В вашей оболочке выполните claude plugin validate --strict ./your-plugin. Чистый запуск выводит ✔ Validation passed.

В CI: сохраняйте --strict, который также завершает запуск с кодом выхода 1 при предупреждениях, таких как неизвестное поле манифеста или отсутствующий version. Удалите --strict, если вы выбрали опустить version на предыдущем шаге.
Пути: валидация сообщает пути компонентов, которые не начинаются с ./. Внутри команд hook и конфигов MCP сервера ссылайтесь на файлы как ${CLAUDE_PLUGIN_ROOT}/.... См. правила пути.

Установите его из локального маркетплейса

В вашей оболочке добавьте локальный маркетплейс, который содержит список плагина с помощью claude plugin marketplace add ./path-to-marketplace, установите плагин из него и запустите сеанс, чтобы подтвердить, что он загружается.

Для наименьшего маркетплейса, который работает, см. Создание маркетплейса.
Чтобы узнать, загружает ли установка ваш исходный каталог или кэшированную копию, см. Плагины на месте и скопированные плагины.

Заполните метаданные, которые видят пользователи

Установите description, author, homepage и repository в plugin.json и добавьте README.md в корень плагина. homepage должен анализироваться как URL. Справочник манифеста содержит список каждого поля.

Запустите свой набор eval

Если у вас есть набор eval, запустите claude plugin eval в вашей оболочке. Он запускает тестовые случаи плагина и оценивает результаты, что выявляет регрессии при изменении плагина. См. Тестирование плагинов с помощью eval.

Если плагин находится в репозитории git, люди могут клонировать его и загрузить checkout, или запустить Claude Code из своей оболочки с --plugin-url, указывающим на файл .zip, который вы прикрепляете к выпуску. Чтобы получить вашу следующую версию, они вытягивают или загружают снова. Если он не находится в репозитории, отправьте им каталог или файл .zip из него. Они загружают его одним из двух способов:

Для одного сеанса: они запускают Claude Code из своей оболочки с claude --plugin-dir ./deploy-helper, где путь — это клон, распакованная папка или сам файл .zip. См. Флаги, которые загружают плагин для одного сеанса.
Для каждого сеанса: они перемещают каталог плагина с его .claude-plugin/plugin.json под ~/.claude/skills/, чтобы Claude Code загружал его в каждом сеансе.

Добавление .claude-plugin/marketplace.json в тот же репозиторий — это то, что позволяет людям устанавливать по имени и обновляться с помощью команды; см. Публикация через собственный маркетплейс.

Отправьте плагин со своим собственным инструментом

Если вы поддерживаете CLI или SDK, опубликуйте плагин в маркетплейсе и попросите ваш установщик или сообщение после установки запустить или вывести две команды, которые нужны пользователю: claude plugin marketplace add <source>, затем claude plugin install <name>@<marketplace>. Для обнаружения в сеансе, когда кто-то использует ваш инструмент, см. Рекомендуйте свой плагин из вашего CLI.

Публикация через собственный маркетплейс

Ваш собственный маркетплейс — это файл .claude-plugin/marketplace.json, который содержит список вашего плагина, добавленный в репозиторий git. После того как файл находится в репозитории, плагин опубликован, без формы отправки. Вы можете сохранить файл в собственном репозитории плагина или в отдельном.

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

Чтобы опубликовать из собственного репозитория плагина, сохраните файл маркетплейса рядом с plugin.json в .claude-plugin/, с одной записью, чей source — это "./", корень репозитория. Дайте записи то же name, что и plugin.json, согласно Сохраняйте имя записи и имя манифеста одинаковыми:

.claude-plugin/marketplace.json

{
  "name": "your-marketplace",
  "owner": { "name": "Your Name" },
  "plugins": [
    { "name": "deploy-helper", "source": "./" }
  ]
}

В вашей оболочке запустите claude plugin validate . в репозитории, чтобы проверить файл перед отправкой. Создание маркетплейса охватывает макет с несколькими плагинами в одном репозитории.

Контролируйте, кто может установить

Любой, кто может клонировать репозиторий, может установить из него, поэтому если репозиторий приватный, маркетплейс также приватный. Для хостов, отличных от репозитория git, см. Размещение маркетплейса. Чтобы охватить всех в компании, включая людей, которые не используют git, см. Развертывание для всей компании.

Скажите пользователям, как установить

Скажите своим пользователям добавить маркетплейс, а затем установить плагин из своей оболочки, заменив источник и имена на ваши:

Добавьте маркетплейс один раз: claude plugin marketplace add your-org/your-marketplace, где аргумент — это сокращение GitHub owner/repo, URL или путь
Установите плагин: claude plugin install deploy-helper@your-marketplace
Или сделайте оба из сеанса: /plugin install deploy-helper --marketplace your-org/your-marketplace. Требуется Claude Code v2.1.275 или позже. См. Добавьте маркетплейс и установите в одной команде

Отправьте обновления пользователям

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

По запросу: claude plugin update deploy-helper@your-marketplace в оболочке пользователя обновляет маркетплейс и устанавливает новую копию, когда версия вашего плагина изменилась
Автоматическое обновление: по умолчанию отключено для вашего маркетплейса. См. Включите автоматическое обновление. После включения он делает то же самое, что claude plugin update с задержкой после запуска сеанса

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

Отправить в сообщество marketplace

Сообщество marketplace Anthropic, claude-community, — это публичный marketplace, в котором перечислены плагины, отправленные через форму отправки каталога плагинов. Пользователи добавляют сообщество marketplace в сеанс Claude Code с помощью /plugin marketplace add anthropics/claude-plugins-community и устанавливают его как @claude-community. О том, чем сообщество marketplace отличается от официального marketplace, см. Marketplaces Anthropic. Чтобы отправить ваш плагин в сообщество marketplace, используйте одну из встроенных форм:

claude.ai: claude.ai/admin-settings/directory/submissions/plugins/new
Console: platform.claude.com/plugins/submit

Форма claude.ai требует организацию Team или Enterprise и разрешение Directory, которое по умолчанию имеют владельцы. Отдельные авторы, которые не являются частью организации Team или Enterprise, могут вместо этого использовать форму Console. В вашей оболочке запустите claude plugin validate ./your-plugin локально перед отправкой, заменив ./your-plugin на путь к каталогу вашего плагина. Когда валидация пройдена успешно, Claude Code выводит ✔ Validation passed, или ✔ Validation passed with warnings, если есть предупреждения. Предупреждения не приводят к сбою валидации; добавьте --strict, чтобы рассматривать их как ошибки. Перечисленные плагины появляются в каталоге anthropics/claude-plugins-community, в подавляющем большинстве случаев закреплённые на определённом коммите SHA. Может быть задержка между отправкой и появлением вашего плагина в marketplace.json. Чтобы проверить, доступен ли ваш плагин для установки, найдите его имя в каталоге сообщества. Официальный marketplace, claude-plugins-official, не принимает отправки через эти формы. Если вы работаете с контактом партнёра Anthropic, попросите у них информацию о размещении в официальном marketplace.

Отправка обновлений, переименований и удалений

Выпустите новую версию

Если вы публикуете через собственный маркетплейс и ваш plugin.json устанавливает version, увеличьте его и отправьте. Пользователи, которые запускают claude plugin update или имеют включенное автоматическое обновление, получают новую версию, как описано в Отправка обновлений пользователям.

Отметьте выпуск

Отметьте выпуск в git, когда другие плагины объявляют диапазон версий на вашем, потому что эти диапазоны разрешаются против тегов. В противном случае вам не нужен тег. Чтобы отметить, запустите claude plugin tag в вашей оболочке из каталога плагина. Он создает тег {name}--v{version}. Добавьте --push, чтобы отправить тег на origin. Справочник plugin tag содержит список его флагов.

Переименуйте или удалите плагин

Никогда не изменяйте name опубликованного плагина. После переименования пользователи, которые уже установили его, теряют плагин, потому что их установка записана под старым именем. Запись renames в файле маркетплейса переносит их вместо этого. Измените displayName, когда вы хотите другую метку. Если переименование неизбежно, используйте карту renames файла маркетплейса, чтобы существующие установки переносились вместо сбоя с Plugin "<name>" not found in marketplace. Чтобы удалить плагин из маркетплейса или получить полные детали renames, см. Переименуйте или удалите плагин на странице размещения. Справочник маркетплейса содержит поле.

Объявите зависимости

Если ваш плагин нуждается в другом плагине из того же маркетплейса для включения, перечислите его в массиве dependencies в plugin.json. Каждая запись — это простое имя или объект с диапазоном semver version. Когда пользователь устанавливает ваш плагин, Claude Code также устанавливает и включает зависимость. Зависимости плагинов охватывает синтаксис диапазона, кросс-маркетплейс зависимости и как пользователи удаляют зависимости, которые им больше не нужны.

Следующие шаги

Размещение и поддержка маркетплейса: выпускайте новые версии и держите пользователей в курсе
Зависимости плагинов: объявляйте и версионируйте плагины, на которые полагается ваш
Рекомендуйте свой плагин из вашего CLI: подсказывайте пользователям Claude Code вашего CLI установить плагин
Измеряйте стоимость и использование плагина: посмотрите, что стоит ваш плагин в контексте и используют ли его люди

Плагины

Использовать plugins

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

Запустить marketplace

Управление плагинами вашей организации

Устранение неполадок

Справочник

Публикация и распространение плагина

Выбор способа распространения

Подготовка плагина к выпуску

Отправьте плагин со своим собственным инструментом

Публикация через собственный маркетплейс

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

Контролируйте, кто может установить

Скажите пользователям, как установить

Отправьте обновления пользователям

Отправить в сообщество marketplace

Отправка обновлений, переименований и удалений

Выпустите новую версию

Отметьте выпуск

Переименуйте или удалите плагин

Объявите зависимости

Следующие шаги

​Выбор способа распространения

​Подготовка плагина к выпуску

​Поделитесь плагином без маркетплейса

​Отправьте плагин со своим собственным инструментом

​Публикация через собственный маркетплейс

​Добавьте файл маркетплейса в ваш репозиторий

​Контролируйте, кто может установить

​Скажите пользователям, как установить

​Отправьте обновления пользователям

​Отправить в сообщество marketplace

​Отправка обновлений, переименований и удалений

​Выпустите новую версию

​Отметьте выпуск

​Переименуйте или удалите плагин

​Объявите зависимости

​Следующие шаги

Выбор способа распространения

Подготовка плагина к выпуску

Поделитесь плагином без маркетплейса

Отправьте плагин со своим собственным инструментом

Публикация через собственный маркетплейс

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

Контролируйте, кто может установить

Скажите пользователям, как установить

Отправьте обновления пользователям

Отправить в сообщество marketplace

Отправка обновлений, переименований и удалений

Выпустите новую версию

Отметьте выпуск

Переименуйте или удалите плагин

Объявите зависимости

Следующие шаги