SpyBara
Go Premium

plugins/publish.md 2026-09-24 22:57 UTC to 2026-09-25 23:58 UTC

This page contains 210 additions and 0 deletions.

2026
Fri 25 23:58

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

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

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

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

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

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

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

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

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

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

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

1

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

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

2

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

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

3

Валидация

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

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

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

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

5

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

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

6

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

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

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

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

Добавление .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, согласно Сохраняйте имя записи и имя манифеста одинаковыми:

{
  "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 требует организацию 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 также устанавливает и включает зависимость.

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

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