SpyBara
Go Premium

plugins/publish.md 2026-09-28 22:59 UTC to 2026-09-29 09:02 UTC

This page contains 21 additions and 18 deletions.

2026
Fri 25 23:58 Mon 28 22:59 Tue 29 10:02

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

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

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

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

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

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

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

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

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

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

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

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 с задержкой после запуска сеанса

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

Отправить в справочник Anthropic

Справочник Anthropic — это каталог, который люди просматривают на claude.ai и в Cowork для добавления плагинов и коннекторов. Одно объявление там достигает людей на claude.ai, в Cowork и в Claude Code. Вы отправляете из портала разработчика на claude.ai/directory/manage; Подготовка к проверке на claude.com описывает, что происходит с каждой версией перед её публикацией.

Отправка требует платный план claude.ai. На Pro и Max вы отправляете со своего собственного аккаунта. На Team и Enterprise владелец может отправлять, а на Enterprise владелец также может предоставить разрешение Directory другим членам через пользовательскую роль в разделе Organization settings > Roles. См. Подтвердите, что вы можете отправлять в справочник.

Этапы отправки, проверки, которые должна пройти каждая версия, и что происходит после публикации, задокументированы на claude.com, потому что они одинаковы независимо от того, на какой поверхности находятся ваши пользователи:

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

  • Запустите claude plugin validate ./your-plugin --strict в вашей оболочке: замените ./your-plugin на путь к каталогу вашего плагина. Команда перехватывает ошибки манифеста локально; plugin validate перечисляет, какие файлы читает каждый запуск. Портал применяет дополнительные правила справочника, которые CLI не проверяет, поэтому чистый локальный запуск не гарантирует чистую валидацию портала.
  • Проверьте, что загружается где: некоторые компоненты плагина предназначены только для Claude Code и не загружаются на claude.ai или в Cowork. Таблица поддержки компонентов перечисляет каждый компонент по приложениям, поэтому вы знаете, что получат пользователи вне Claude Code.

Официальный marketplace Anthropic, claude-plugins-official, не принимает отправки через портал справочника. Если вы работаете с контактом партнёра Anthropic, попросите у них информацию об объявлении в официальном marketplace.

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

Человек, который устанавливает ваш плагин из справочника на claude.ai, имеет его на своём аккаунте, и Claude Code загружает его как <name>@synced. Плагины, синхронизированные с claude.ai охватывает то, что они видят и как они его отключают.

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

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

Если вы публикуете через собственный маркетплейс и ваш 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 также устанавливает и включает зависимость.

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

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