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

Маркетплейсы плагинов позволяют владельцам планов Team и Enterprise распространять отобранные плагины всем членам организации. Вы создаёте маркетплейс, добавляете в него плагины и точно контролируете, какие плагины видят и используют члены вашей команды. Распространяемые плагины появляются как в чате (в веб-версии и на вкладке Chat в Claude Desktop), так и в Claude Cowork.

Требования: Cowork и Skills должны быть включены для вашей организации, прежде чем вы сможете использовать маркетплейсы плагинов.

Anthropic предоставляет встроенные маркетплейсы плагинов для различных функций, таких как юридические услуги и финансы. Маркетплейс Knowledge Work добавляется в вашу организацию по умолчанию.

Чтобы добавить встроенный маркетплейс Anthropic:

Чтобы удалить маркетплейс Knowledge Work, если он не актуален для ваших команд:

Встроенные маркетплейсы Anthropic отображают понятные названия, такие как "Knowledge Work," вместо базового слага репозитория.

Помимо встроенных маркетплейсов Anthropic, вы можете создать свой собственный. Есть два способа добавления плагинов в создаваемый маркетплейс:

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

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

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

Подготовка репозитория

Ваш репозиторий должен быть приватным или внутренним — публичные репозитории не допускаются для маркетплейсов организации. Вы можете подключить репозиторий, размещённый на github.com или на GitHub Enterprise хосте вашей организации.

Маркетплейсы, синхронизированные с GitHub, поддерживают более узкий набор типов source в marketplace.json, чем Claude Code. Относительные пути к папкам плагинов внутри репозитория маркетплейса (например, "source": "./plugins/my-plugin") полностью поддерживаются и являются самым простым вариантом. Типы источников github, url и git-subdir также поддерживаются. Типы источников npm, archive и command не поддерживаются.

Источник плагина может быть приватным в двух случаях: источник github.com, который имеет того же владельца, что и репозиторий маркетплейса, который организационная синхронизация получает через Claude GitHub App, или источник на GitHub Enterprise хосте вашей организации с установленным Claude GitHub Enterprise App на этом репозитории. Все остальные источники получаются без учётных данных, поэтому репозитории github.com под другим владельцем и репозитории на других хостах (таких как GitLab или Bitbucket) должны быть публичными.

Если код вашего плагина находится в приватном репозитории, который не соответствует указанным выше критериям, скопируйте папки плагинов в репозиторий маркетплейса и измените источник каждого плагина на относительный путь (хорошо работает git subtree или CI шаг, который упаковывает файлы).

Подробнее о структуре плагинов и форматировании см. в документации по справочнику плагинов.

Дополнительные ресурсы:

Подключение репозитория

Ваш личный токен GitHub проверяется для подтверждения доступа, затем Cowork использует токен установки своего приложения GitHub для операций синхронизации.

Не видите свой репозиторий? Убедитесь, что приложение Claude GitHub установлено в этом репозитории.

Как работает синхронизация

Начальная синхронизация запускается автоматически при подключении репозитория. После этого владельцы организации могут включить автоматические обновления для каждого маркетплейса, перейдя в Параметры организации > Плагины, нажав кнопку меню в верхнем правом углу маркетплейса и включив опцию "Синхронизировать автоматически":

Включение автоматической синхронизации создает вебхук в подключенном репозитории. Человек, включающий переключатель, должен иметь права администратора для этого репозитория на GitHub. Это проверяется через его личное подключение GitHub, которое отделено от установки приложения Claude GitHub. Без прав администратора страница показывает "Невозможно получить доступ к репозиторию. Убедитесь, что репозиторий существует и приложение Claude GitHub установлено", даже если приложение установлено правильно и ручные обновления работают.

Разрешение Вебхуки (Чтение и запись) приложения Claude GitHub также должно быть одобрено при установке. Для установок, созданных до введения этого разрешения, GitHub показывает запрос "Claude запрашивает обновленные разрешения", который должен одобрить администратор репозитория или организации.

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

Во время синхронизации Cowork сравнивает последний коммит в вашем репозитории с последним синхронизированным коммитом. Если ничего не изменилось, синхронизация пропускается. Если есть изменения, Cowork читает манифест, проверяет каждый плагин и заменяет все плагины на маркетплейсе текущим состоянием репозитория. Синхронизация может занять до 30 минут в зависимости от количества плагинов.

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

Участники просматривают доступные плагины через модальное окно Обзор плагинов. Автоматически установленные плагины появляются в их списке установленных плагинов автоматически. Доступные плагины отображаются в каталоге для самостоятельной установки.

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

Администраторы Enterprise могут переопределить предпочтение установки плагина на уровне организации для определённых групп. Например, вы можете автоматически установить плагин для группы Engineering, сделать его доступным для Legal для самостоятельной установки и скрыть его от всех остальных.

Каждый плагин в вашем маркетплейсе имеет предпочтение установки на уровне организации (Установлено по умолчанию, Доступно для установки, Обязательно или Недоступно). По умолчанию каждая группа наследует этот параметр на уровне организации.

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

Как вручную созданные группы, так и группы, подготовленные через SCIM от вашего поставщика удостоверений, отображаются в средстве выбора групп и работают одинаково.

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

Например, если группа A устанавливает плагин на «Недоступно», а группа B устанавливает его на «Установлено по умолчанию», участник в обеих группах получит плагин, установленный по умолчанию.

Если группа удаляется (например, удаляется из вашего поставщика удостоверений), переопределение остаётся в пользовательском интерфейсе администратора, но помечается как сиротское. Это не влияет на участников (так как никто не принадлежит удалённой группе) и не учитывается в значке пользовательского доступа. Вы можете очистить сиротские переопределения из параметров пользовательского доступа плагина.

Да. Переопределения на уровне группы сохраняются при повторной синхронизации маркетплейса, подключённого к GitHub. Они удаляются только если сам плагин удаляется из маркетплейса.

Чтобы обновить плагин, загрузите новый ZIP-файл с тем же именем плагина. Новая версия автоматически заменяет существующую. Имена плагинов — это уникальный идентификатор, поэтому legal всегда заменит legal.

Чтобы удалить плагин, удалите его из вашего маркетплейса в Параметры организации > Плагины.

Отправьте ваши изменения в подключённый репозиторий, затем перейдите в Параметры организации > Плагины, найдите ваш маркетплейс и нажмите «Обновить», чтобы запустить синхронизацию. Каждая синхронизация заменяет все плагины текущим состоянием репозитория. Если владелец включил «Синхронизировать автоматически» для маркетплейса, синхронизация также запускается при слиянии запроса на вытягивание с обновлением версии плагина в ветку по умолчанию репозитория.

Чтобы удалить плагин, удалите его из репозитория и запустите синхронизацию.

Имена плагинов должны использовать строчные слова, разделённые дефисами (например, deployment-tools, а не Deployment Tools). Следующие названия на маркетплейсе зарезервированы и не могут быть использованы:

Названия, выдающие себя за официальные маркетплейсы Anthropic, также заблокированы.

Частые причины: файл превышает 50 МБ, это не корректный ZIP-файл или маркетплейс достиг лимита в 100 плагинов. Проверьте размер и формат файла, удалите неиспользуемые плагины, если вы на пределе. Если включено сканирование навыков и плагинов, плагин также может быть отклонён, если он был помечен как содержащий вредоносный контент. Проверьте причину, исправьте проблему и загрузите плагин снова.

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

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

Один или несколько плагинов в вашем репозитории, вероятно, отформатированы неправильно. Исправьте проблему форматирования, отправьте обновление на GitHub и запустите синхронизацию снова. Требования к структуре плагина см. в документации справочника плагинов.

Одна или несколько записей плагинов в вашем marketplace.json используют source, который указывает вне подключённого репозитория (источник github, url или git-subdir), и синхронизация организации не может его получить. Приватный источник работает только в двух случаях: репозиторий github.com имеет того же владельца, что и репозиторий маркетплейса, или репозиторий на хосте GitHub Enterprise вашей организации с установленным GitHub Enterprise App.

Для любого другого приватного источника переместите папки плагинов в репозиторий маркетплейса и измените source каждой записи на относительный путь (например, "./plugins/my-plugin"), затем отправьте и повторно синхронизируйте. Или загрузите затронутые плагины отдельно через Параметры организации > Плагины > Добавить плагины > Загрузить файл, затем выберите «Добавить в существующий маркетплейс». Плагины, загруженные через собственное меню Customize участника, устанавливаются только для этого участника и не распространяются на вашу организацию.

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

Убедитесь, что Claude GitHub App установлено в этом репозитории. Сначала проверяется ваш личный токен GitHub для подтверждения доступа, но сама синхронизация использует токен установки GitHub App.

Если ручные обновления работают, но включение «Синхронизировать автоматически» показывает «Не удаётся получить доступ к репозиторию. Убедитесь, что репозиторий существует и Claude GitHub App установлено», есть две вероятные причины: