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

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

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

Существует два способа добавления плагинов на маркетплейс:

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

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

Синхронизация с 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 subtree или шаг CI работают хорошо) и ссылайтесь на них с помощью относительных путей.

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

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

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

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

Начальная синхронизация запускается автоматически при подключении репозитория. После этого владельцы организации могут согласиться на продолжение автоматических обновлений для каждого маркетплейса, перейдя в Organization settings > Plugins (в разделе Libraries), нажав кнопку меню в верхнем правом углу маркетплейса и включив «Sync automatically»:

Маркетплейс GitHub будет автоматически синхронизирован при каждом слиянии PR в этот репозиторий. Вы также можете запустить синхронизацию вручную, нажав «Update» на маркетплейсе.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Имена плагинов должны использовать строчные слова, разделённые дефисами (например, 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 может временно удалить плагины из вашего маркетплейса. Исправьте основную проблему, успешно повторно синхронизируйте, затем убедитесь, что предпочтения установки установлены правильно — они могут быть сброшены.

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