Маркетплейсы плагинов позволяют владельцам планов Team и Enterprise распространять отобранные плагины всем членам организации. Вы создаёте маркетплейс, добавляете в него плагины и точно контролируете, какие плагины видят и используют члены вашей команды. Распространяемые плагины появляются как в чате (в веб-версии и на вкладке Chat в Claude Desktop), так и в Claude Cowork.
Владельцы и основные владельцы планов Team и Enterprise могут управлять плагинами организации в разделе Organization settings > Plugins.
Требования: Cowork и Skills должны быть включены для вашей организации, прежде чем вы сможете использовать маркетплейсы плагинов.
Использование встроенных маркетплейсов Anthropic
Anthropic предоставляет встроенные маркетплейсы плагинов для различных функций, таких как юридические услуги и финансы. Маркетплейс Knowledge Work добавляется в вашу организацию по умолчанию.
Чтобы добавить встроенный маркетплейс Anthropic:
Перейдите в раздел Organization settings > Plugins.
Нажмите «Add plugins».
Выберите «Browse Anthropic sources».
Нажмите «Add» для каждого маркетплейса, который должен быть доступен всем членам организации.
Чтобы удалить маркетплейс Knowledge Work, если он не актуален для ваших команд:
Перейдите в раздел Organization settings > Plugins.
Найдите Knowledge Work.
Нажмите кнопку меню в верхнем правом углу.
Выберите «Remove».
Встроенные маркетплейсы Anthropic отображают понятные названия, такие как «Knowledge Work», вместо базового идентификатора репозитория.
Создание собственного маркетплейса
Помимо встроенных маркетплейсов Anthropic, вы можете создать свой собственный. Существует два способа добавления плагинов в создаваемый маркетплейс:
Ручная загрузка: загружайте отдельные ZIP-файлы плагинов через интерфейс администратора. Лучше всего подходит для быстрой итерации, одноразовых инструментов или команд, которые не используют GitHub для разработки плагинов.
Синхронизация с GitHub: подключите приватный репозиторий GitHub, и Cowork автоматически синхронизирует плагины из него. Лучше всего подходит, когда несколько разработчиков совместно работают над плагинами или вы хотите получать обновления с контролем версий.
Вы можете использовать оба подхода одновременно. Например, запустите маркетплейс, синхронизированный с GitHub, для основных плагинов и отдельный ручной маркетплейс для дополнительных инструментов.
Настройка ручного маркетплейса
Перейдите в раздел Organization settings > Plugins.
Нажмите «Add plugins» и выберите «Upload a file» в качестве источника.
Если это ваша первая настройка маркетплейса, опция «Upload to a new marketplace» выбирается автоматически. Позже при загрузке плагинов вы сможете выбрать «Add to an existing marketplace».
Введите название маркетплейса.
Перетащите файлы или нажмите на поле загрузки и выберите файл. Файл должен быть действительным .zip размером менее 50 МБ.
Повторите для каждого плагина, который вы хотите добавить.
Нажмите «Upload», чтобы добавить плагины в новый маркетплейс.
Если вы загружаете плагин с тем же названием, что и существующий, он автоматически перезаписывает предыдущую версию. Вам не нужно предварительно удалять старую версию.
Настройка маркетплейса, синхронизированного с GitHub
Синхронизация с GitHub позволяет управлять плагинами как кодом в репозитории. Когда вы отправляете изменения, вы можете запустить синхронизацию для обновления маркетплейса — вручную или автоматически.
Подготовка репозитория
Ваш репозиторий должен быть приватным или внутренним — публичные репозитории не допускаются для маркетплейсов организации. Репозитории, размещённые на пользовательских экземплярах GitHub Enterprise Server, не поддерживаются. Ваш репозиторий должен быть размещён на github.com.
Маркетплейсы, синхронизированные с GitHub, поддерживают более узкий набор типов source в marketplace.json, чем Claude Code CLI. Относительные пути к папкам плагинов внутри подключённого репозитория (например, "source": "./plugins/my-plugin") полностью поддерживаются. Типы источников github, url и git-subdir поддерживаются только когда целевой репозиторий является публичным. Типы источников npm и pip не поддерживаются. Если код вашего плагина находится в отдельных приватных репозиториях, скопируйте эти папки плагинов в репозиторий маркетплейса (подмодуль git, поддерево git или шаг CI работают хорошо) и ссылайтесь на них с помощью относительных путей.
Подробную информацию о структуре и форматировании плагинов см. в документации по справочнику плагинов.
Дополнительные ресурсы:
Подключение репозитория
Убедитесь, что Cowork и Skills включены для вашей организации.
Перейдите в раздел Organization settings > Plugins.
Нажмите «Add plugin» и выберите «GitHub» в качестве источника.
Введите репозиторий в формате
owner/repo(например,acme-corp/claude-plugins).
Ваш личный токен GitHub проверяется для подтверждения доступа, затем Cowork использует токен установки GitHub App для операций синхронизации.
Не видите ваш репозиторий? Убедитесь, что приложение Claude GitHub установлено в этом репозитории.
Как работает синхронизация
Начальная синхронизация запускается автоматически при подключении репозитория. После этого владельцы организации могут включить автоматические обновления для каждого маркетплейса, перейдя в Параметры организации > Плагины (в разделе Библиотеки), нажав кнопку меню в верхнем правом углу маркетплейса и включив опцию «Синхронизировать автоматически»:
Маркетплейс GitHub будет автоматически синхронизирован при каждом слиянии PR в этот репозиторий. Вы также можете запустить синхронизацию вручную, нажав кнопку «Обновить» на маркетплейсе.
Во время синхронизации Cowork сравнивает последний коммит в вашем репозитории с последним синхронизированным коммитом. Если ничего не изменилось, синхронизация пропускается. Если есть изменения, Cowork читает манифест, проверяет каждый плагин и заменяет все плагины на маркетплейсе текущим состоянием репозитория. Синхронизация может занять до 30 минут в зависимости от количества плагинов.
Важно: Если синхронизация не удалась, плагины могут быть временно удалены для членов вашей команды. Если это произойдет, проверьте сообщение об ошибке, исправьте проблему в репозитории, отправьте обновление и запустите синхронизацию снова. После успешной синхронизации убедитесь, что ваши предпочтения установки по-прежнему установлены правильно — они могли быть сброшены во время сбоя.
Выберите между ручной загрузкой и синхронизацией GitHub
Сценарий | Рекомендуемый подход |
Плагины хранятся в системе контроля версий с CI/CD | Синхронизация GitHub |
Несколько разработчиков сотрудничают над плагинами | Синхронизация GitHub |
Вы хотите автоматическое распространение обновлений | Синхронизация GitHub |
Вам нужно более 100 плагинов на маркетплейсе | Синхронизация GitHub |
Быстрое прототипирование или одноразовые инструменты | Ручная загрузка |
Плагины, созданные не инженерными командами | Ручная загрузка |
Среды без доступа к GitHub | Ручная загрузка |
Тестирование плагина перед добавлением его в синхронизированный репозиторий | Ручная загрузка |
Управление распределением плагинов
После добавления плагинов на маркетплейс вы управляете их распределением с помощью предпочтений установки. Для каждого плагина вы можете установить один из четырех вариантов:
Предпочтение | Что это делает | Что видят члены |
Установлено по умолчанию | Автоматически установлено для всех членов организации | Плагин появляется в их списке установленных без каких-либо действий. Члены могут удалить его, если захотят. |
Доступно для установки | Указано в каталоге плагинов | Члены видят его при просмотре плагинов и могут установить его самостоятельно. |
Недоступно | Полностью скрыто из каталога | Члены не могут видеть или установить плагин. Полезно для промежуточного хранения или удаления плагинов. |
Требуется | Автоматически установлено для всех членов организации без возможности удаления | Плагин появляется в их списке установленных без каких-либо действий и не может быть отключен или удален. |
Установить предпочтения
В Параметры организации > Плагины перейдите к вашему маркетплейсу.
Выберите предпочтение установки для каждого плагина.
Изменения вступают в силу при следующем сеансе или обновлении плагина каждого члена.
Что испытывают члены
Члены просматривают доступные плагины через модальное окно Просмотр плагинов. Автоматически установленные плагины появляются в их списке установленных автоматически. Доступные плагины отображаются в каталоге для самостоятельной установки.
Члены не могут редактировать плагины, управляемые организацией, что предотвращает конфликтующие изменения в общих инструментах.
Настройка доступа к плагинам по группам
Администраторы предприятия могут переопределить предпочтение организации по установке плагина для определённых групп. Например, вы можете автоматически установить плагин для группы Engineering, сделать его доступным для Legal для самостоятельной установки и скрыть его от остальных.
Доступ к плагинам на уровне группы доступен в планах Enterprise и настраивается администраторами и выше.
Как работают переопределения групп
Каждый плагин в вашем маркетплейсе имеет предпочтение установки на уровне организации (Установлен по умолчанию, Доступен для установки, Обязателен или Недоступен). По умолчанию каждая группа наследует этот параметр организации.
Когда вы устанавливаете переопределение на уровне группы для плагина, оно заменяет параметр организации для членов этой группы. Порядок разрешения: параметр группы, затем параметр организации, затем значение по умолчанию маркетплейса.
Установка доступа к плагину для группы
В Organization settings > Plugins перейдите к вашему маркетплейсу.
Найдите плагин, который вы хотите настроить.
В столбце Custom access нажмите «Add groups».
Выберите группу и выберите одно из предпочтений установки, указанных выше.
Как вручную созданные группы, так и группы, подготовленные через SCIM от вашего поставщика удостоверений, отображаются в средстве выбора групп и работают одинаково.
Что происходит, когда участник входит в несколько групп
Если участник принадлежит двум или более группам с разными параметрами для одного плагина, применяется наиболее разрешающий параметр. Порядок от наиболее к наименее разрешающему: Обязателен > Установлен по умолчанию > Доступен для установки > Недоступен.
Например, если группа A устанавливает плагин на «Недоступен», а группа B на «Установлен по умолчанию», участник в обеих группах получит плагин, установленный по умолчанию.
Примечание: Это противоположно тому, как разрешаются лимиты расходов группы. Лимиты расходов применяют наиболее ограничивающее значение по умолчанию, так как они служат контролем бюджета. Доступ к плагинам применяет наиболее разрешающее значение, так как группы здесь предназначены для предоставления доступа командам, которым нужен инструмент, а не для использования в качестве границы безопасности. Если вам нужно жёстко заблокировать плагин, установите его предпочтение организации на «Недоступен» и предоставьте доступ только группам, которые должны его иметь.
Что происходит при удалении группы
Если группа удалена — например, если она удалена из вашего поставщика удостоверений — переопределение остаётся в пользовательском интерфейсе администратора, но помечается как сиротское. Оно не влияет на участников (так как никто не принадлежит удалённой группе) и не учитывается в значке пользовательского доступа. Вы можете очистить сиротские переопределения из параметров пользовательского доступа плагина.
Сохраняются ли параметры группы при повторной синхронизации маркетплейса?
Да. Переопределения на уровне группы сохраняются при повторной синхронизации маркетплейса, подключённого к GitHub. Они удаляются только если сам плагин удалён из маркетплейса.
Обновление и удаление плагинов
Ручные маркетплейсы
Чтобы обновить плагин, загрузите новый ZIP-файл с тем же именем плагина. Новая версия автоматически заменит существующую. Имена плагинов — это уникальный идентификатор — legal всегда заменит legal.
Чтобы удалить плагин, удалите его из вашего маркетплейса в Organization settings > Plugins.
Маркетплейсы, синхронизированные с GitHub
Отправьте ваши изменения в подключённый репозиторий, затем перейдите в Organization settings > Plugins, найдите ваш маркетплейс и нажмите «Update» для запуска синхронизации. Каждая синхронизация заменяет все плагины текущим состоянием репозитория. Обратите внимание, что если владелец включил «Sync automatically» для маркетплейса, синхронизированного с GitHub, это произойдёт автоматически после отправки изменений в репозиторий.
Чтобы удалить плагин, удалите его из репозитория и запустите синхронизацию.
Ограничения
Ограничение | Значение | Примечания |
Максимальный размер ZIP плагина (загрузка) | 50 МБ | Применяется как на стороне клиента, так и на стороне сервера |
Максимальное количество плагинов на маркетплейс (ручной) | 100 | На маркетплейс |
Максимальное количество плагинов на маркетплейс (синхронизация GitHub) | 500 | На маркетплейс |
Максимальная длина имени плагина | 64 символа | Должны использовать строчные слова, разделённые дефисами |
Время ожидания синхронизации | 30 минут | На операцию синхронизации |
Видимость репозитория GitHub | Только приватные или внутренние | Должен быть размещён на github.com. Публичные репозитории и экземпляры GitHub Enterprise Server не поддерживаются. |
Правила именования
Имена плагинов должны использовать строчные слова, разделённые дефисами (например, deployment-tools, а не Deployment Tools). Следующие имена маркетплейсов зарезервированы и не могут быть использованы:
claude-code-marketplaceclaude-code-pluginsclaude-plugins-officialanthropic-marketplaceanthropic-pluginsagent-skillslife-sciences
Имена, выдающие себя за официальные торговые площадки Anthropic, также заблокированы.
Примечание: Авторы плагинов могут установить displayName, чтобы плагин отображался с понятным именем в каталоге вместо его слага. Если автор не установит его, плагин будет отображать свой слаг (например, deployment-tools).
Устранение неполадок
Загрузка отклонена
Частые причины: файл превышает 50 МБ, это не является допустимым ZIP-файлом или торговая площадка достигла лимита в 100 плагинов. Проверьте размер и формат файла и удалите неиспользуемые плагины, если вы достигли лимита.
Плагин не отображается для участников
Проверьте предпочтение установки плагина в параметрах вашей торговой площадки. Если установлено значение Недоступно, участники его не увидят. Также убедитесь, что Cowork и Skills включены для вашей организации.
Обновленный плагин не отражается для участников
Изменения вступают в силу при следующем сеансе или обновлении плагина каждого участника. Если обновление по-прежнему не отображается, подтвердите успешность загрузки, проверив версию плагина на вашей торговой площадке.
Синхронизация GitHub не удается из-за ошибки содержимого
Один или несколько плагинов в вашем репозитории, вероятно, отформатированы неправильно. Исправьте проблему форматирования, отправьте обновление на GitHub и снова запустите синхронизацию. Требования к структуре плагина см. в документации справочника плагинов.
Синхронизация не удается с сообщением "Внешние источники плагинов еще не поддерживаются" или плагины пропускаются с сообщением "Репозиторий не найден на github.com. Проверьте URL и убедитесь, что репозиторий является общедоступным."
Одна или несколько записей плагинов в вашем marketplace.json используют source, который указывает вне подключенного репозитория (источник github, url или git-subdir), и целевой репозиторий является приватным. Синхронизация организации в настоящее время может получать внешние источники только из общедоступных репозиториев. Переместите папки плагинов в репозиторий торговой площадки и измените source каждой записи на относительный путь (например, "./plugins/my-plugin"), затем отправьте и повторно синхронизируйте. Кроме того, вы можете загрузить затронутые плагины отдельно через Customize > Add plugin > Create plugin > Upload plugin.
Плагины исчезли после неудачной синхронизации
Неудачная синхронизация GitHub может временно удалить плагины с вашей торговой площадки. Исправьте основную проблему, успешно повторно синхронизируйте, затем убедитесь, что предпочтения установки установлены правильно — они могли быть сброшены.
Не удается увидеть репозиторий GitHub при подключении
Убедитесь, что приложение Claude GitHub установлено в этом репозитории. Ваш личный токен GitHub проверяется в первую очередь для подтверждения доступа, но сама синхронизация использует токен установки приложения GitHub.