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

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

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

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

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

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

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

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

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

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

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

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

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

Маркетплейсы, синхронизированные с GitHub, поддерживают более узкий набор типов source в marketplace.json, чем Claude Code CLI. Относительные пути к папкам плагинов внутри подключённого репозитория (например, "source": "./plugins/my-plugin") полностью поддерживаются. Типы источников github, url и git-subdir поддерживаются только когда целевой репозиторий является публичным. Типы источников npm и pip не поддерживаются. Если ваш код плагина находится в отдельных приватных репозиториях, скопируйте эти папки плагинов в репозиторий маркетплейса (git submodule, git subtree или шаг CI работают хорошо) и ссылайтесь на них с помощью относительных путей.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Отправьте ваши изменения в подключённый репозиторий, затем перейдите в Organization settings > Plugins, найдите ваш маркетплейс и нажмите «Update» для запуска синхронизации. Каждая синхронизация заменяет все плагины текущим состоянием репозитория. Если владелец включил «Sync automatically» для маркетплейса, синхронизация также запускается при слиянии pull request с обновлением версии плагина в ветку по умолчанию репозитория.

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

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

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

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

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

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

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

Одна или несколько записей плагинов в вашем marketplace.json используют source, который указывает вне подключённого репозитория (источник github, url или git-subdir), и целевой репозиторий является приватным. Синхронизация организации в настоящее время может получать внешние источники только из открытых репозиториев. Переместите папки плагинов в репозиторий маркетплейса и измените source каждой записи на относительный путь (например, "./plugins/my-plugin"), затем отправьте и повторно синхронизируйте. Или загрузите затронутые плагины отдельно через Customize > Add plugin > Create plugin > Upload plugin.

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

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

Если ручные обновления работают, но включение «Sync automatically» показывает «Cannot access repository. Ensure the repository exists and the Claude GitHub App is installed», есть две вероятные причины: