К основному содержимому

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

Обновлено вчера

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

Владельцы и основные владельцы планов Team и Enterprise могут управлять плагинами организации в Claude Desktop.

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

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

  • Ручная загрузка — загружайте отдельные ZIP-файлы плагинов через интерфейс администратора. Лучше всего подходит для быстрой итерации, одноразовых инструментов или команд, которые не используют GitHub для разработки плагинов.

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

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


Настройка торговой площадки с ручной загрузкой

  1. Откройте Claude Desktop и перейдите в Organization settings > Plugins.

  2. Нажмите «Add plugins» и выберите «Upload a file» в качестве источника.

  3. Если это ваша первая настройка торговой площадки, будет автоматически выбран вариант «Upload to a new marketplace».

    1. При загрузке плагинов в дальнейшем вы сможете выбрать «Add to an existing marketplace».

  4. Введите название для вашей торговой площадки.

  5. Либо перетащите файлы, либо нажмите на подсказку загрузки и выберите файл.

    1. Примечание: Файл должен быть действительным .zip размером менее 50 МБ.

  6. Повторите для каждого плагина, который вы хотите добавить.

  7. Нажмите «Upload», чтобы добавить плагины на новую торговую площадку.

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


Настройка торговой площадки, синхронизированной с GitHub

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

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

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

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

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

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

  1. Убедитесь, что Cowork и Skills включены для вашей организации.

  2. Перейдите в Organization settings > Plugins.

  3. Нажмите «Add plugin» и выберите «GitHub» в качестве источника.

  4. Введите репозиторий в формате owner/repo (например, acme-corp/claude-plugins).

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

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

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

Начальная синхронизация запускается автоматически при подключении репозитория. После этого вы можете запускать синхронизацию вручную, нажав «Check for updates» на вашей торговой площадке в Organization settings > Plugins.

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

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


Управление распространением плагинов

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

Предпочтение

Что это делает

Что видят члены

Auto-install

Автоматически устанавливается для всех членов организации

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

Available

Указан в каталоге плагинов

Члены видят его при просмотре плагинов и могут установить его самостоятельно.

Not available

Полностью скрыт из каталога

Члены не могут видеть или устанавливать плагин. Полезно для подготовки или снятия с производства плагинов.

Установка предпочтений

  1. В Organization settings > Plugins перейдите на вашу торговую площадку.

  2. Выберите предпочтение установки для каждого плагина.

  3. Изменения вступают в силу при следующем сеансе каждого члена или обновлении плагина.

Что видят члены

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

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


Обновление и удаление плагинов

Торговые площадки с ручной загрузкой

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

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

Торговые площадки, синхронизированные с GitHub

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

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


Ограничения

Ограничение

Значение

Примечания

Максимальный размер ZIP плагина (загрузка)

50 МБ

Применяется как на стороне клиента, так и на стороне сервера

Максимум плагинов на торговой площадке (ручная загрузка)

100

На торговую площадку

Максимум плагинов на торговой площадке (синхронизация GitHub)

500

На торговую площадку

Максимальная длина названия плагина

64 символа

Должны использоваться строчные слова, разделённые дефисами

Тайм-аут синхронизации

30 минут

На операцию синхронизации

Видимость репозитория GitHub

Только приватный или внутренний

Должен быть размещён на github.com. Публичные репозитории и экземпляры GitHub Enterprise Server не поддерживаются.


Правила именования

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

  • claude-code-marketplace

  • claude-code-plugins

  • claude-plugins-official

  • anthropic-marketplace

  • anthropic-plugins

  • agent-skills

  • life-sciences

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


Выбор между ручной загрузкой и синхронизацией GitHub

Сценарий

Рекомендуемый подход

Плагины поддерживаются в системе контроля версий с CI/CD

Синхронизация GitHub

Несколько разработчиков сотрудничают над плагинами

Синхронизация GitHub

Вы хотите автоматического распространения обновлений

Синхронизация GitHub

Вам нужно более 100 плагинов на торговой площадке

Синхронизация GitHub

Быстрое прототипирование или одноразовые инструменты

Ручная загрузка

Плагины, созданные не инженерными командами

Ручная загрузка

Среды без доступа к GitHub

Ручная загрузка

Тестирование плагина перед добавлением его в синхронизированный репозиторий

Ручная загрузка


Устранение неполадок

Загрузка отклонена

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

Плагин не отображается для членов

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

Обновлённый плагин не отражается для членов

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

Синхронизация GitHub не удаётся с ошибкой содержимого

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

Плагины исчезли после неудачной синхронизации

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

Не видите репозиторий GitHub при подключении

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

Нашли ответ на свой вопрос?