Маркетплейсы плагинов позволяют владельцам планов Team и Enterprise распространять отобранные плагины всем членам организации. Вы создаёте маркетплейс, добавляете в него плагины и точно контролируете, какие плагины могут видеть и использовать члены вашей команды. Распространяемые плагины появляются в чате (в веб-версии и на вкладке Chat в Claude Desktop), в Claude Cowork и в сеансах Claude Code, где члены входят с одной учётной записью Claude.
Владельцы и основные владельцы планов Team и Enterprise могут управлять плагинами организации в Organization settings > Plugins & skills. На планах Enterprise это могут делать также члены с пользовательской ролью, которая включает управление библиотеками организации.
Требования: Cowork и Skills должны быть включены для вашей организации, прежде чем вы сможете использовать маркетплейсы плагинов.
Справочную версию этих элементов управления см. в разделе Manage plugins for your organization в документации Claude Code.
Примечание: Отключение Skills для вашей организации также останавливает синхронизацию навыков и плагинов с Claude Code и удаляет уже синхронизированные. Отключение Cowork не влияет на синхронизацию с Claude Code. Чтобы сохранить навыки и плагины в Claude, но остановить только синхронизацию, установите syncClaudeAiSkills и syncClaudeAiPlugins в значение false в управляемых параметрах Claude Code. Узнайте больше о настройке администратора Claude Code.
Примечание: Маркетплейсы — это способ, которым владельцы распространяют плагины в своей организации. Пользователи также могут поделиться плагином, который они создали, с конкретными коллегами или группами, или отправить его для публикации в библиотеку вашей организации. Совместное использование и публикация контролируются параметрами в Organization settings > Plugins & skills на вкладке «Policy», а отправки плагинов рассматриваются там на вкладке «Requests». Узнайте больше о использовании плагинов в Claude и разрешении пользователям публиковать навыки и плагины в вашей организации.
Посмотрите, что находится в вашей организации
Вкладка «Inventory» содержит список всех навыков и плагинов, которыми управляет ваша организация, включая те, которые пользователи создали для себя. Навыки и плагины теперь находятся на одной странице, поэтому вам не нужно переключаться между параметрами.
Для каждого элемента таблица показывает его источник, версию, возможности, аудиторию и количество людей, которые использовали его за последние 30 дней.
Чтобы найти элемент, выполните поиск по названию или используйте фильтры:
Источник: Ваша организация, библиотека организации или конкретный маркетплейс
Аудитория: Кто может использовать элемент
Тип: Навыки или плагины
Навыки, которыми управляет ваша организация, отображаются в разделе Organization library. Маркетплейсы плагинов управляются на вкладке Marketplaces.
Чтобы выполнить действие с элементом, нажмите кнопку меню в конце его строки. Вы можете просмотреть детали и файлы, посмотреть историю версий и изменить доступ по умолчанию и доступ группы.
Для навыков и плагинов, созданных пользователями, вкладка Inventory показывает метаданные и статус совместного использования. Она не показывает сами файлы.
Использование встроенных маркетплейсов Anthropic
Anthropic предоставляет встроенные маркетплейсы плагинов для различных функций, таких как юридические и финансовые. Маркетплейс Knowledge Work добавляется в вашу организацию по умолчанию.
Чтобы добавить встроенный маркетплейс Anthropic:
Перейдите в Organization settings > Plugins & skills и нажмите на вкладку «Marketplaces».
Нажмите «Add», затем выберите «Add marketplace».
Выберите «Browse Anthropic sources».
Нажмите «Add» на каждом из них, который вы хотите, чтобы появился для всех в вашей организации.
Чтобы удалить маркетплейс Knowledge Work, если он не актуален для ваших команд:
Перейдите в Organization settings > Plugins & skills и нажмите на вкладку «Marketplaces».
Найдите Knowledge Work.
Нажмите кнопку меню в верхнем правом углу.
Выберите «Remove».
Встроенные маркетплейсы Anthropic показывают читаемые названия, такие как «Knowledge Work», вместо базового слага репозитория.
Создание собственного маркетплейса
Помимо встроенных маркетплейсов Anthropic, вы можете создать свой собственный. Есть два способа добавить плагины на создаваемый маркетплейс:
Ручная загрузка: Загружайте отдельные ZIP-файлы плагинов через пользовательский интерфейс администратора. Лучше всего для быстрой итерации, одноразовых инструментов или команд, которые не хранят плагины в репозитории Git.
Синхронизация репозитория: Подключите приватный репозиторий GitHub или GitLab, и Claude синхронизирует плагины из него. Лучше всего, когда несколько разработчиков сотрудничают над плагинами или вы хотите обновления с контролем версий.
Вы можете использовать оба подхода параллельно. Например, запустите маркетплейс, синхронизированный с GitHub, для ваших основных плагинов и отдельный ручной маркетплейс для специальных инструментов.
Настройка ручного маркетплейса
Перейдите в Organization settings > Plugins & skills.
Нажмите «Add», затем выберите «Upload a plugin».
Если это ваш первый раз при настройке маркетплейса, «Upload to a new marketplace» выбирается автоматически. Вы сможете выбрать «Add to an existing marketplace» при загрузке плагинов позже.
Введите название для вашего маркетплейса.
Либо перетащите ваши файлы, либо нажмите на подсказку загрузки и выберите ваш файл. Файл должен быть действительным .zip размером менее 200 МБ.
Повторите для каждого плагина, который вы хотите добавить.
Нажмите «Upload», чтобы добавить ваши плагины на новый маркетплейс.
Если вы загружаете плагин с тем же названием, что и существующий, он автоматически перезаписывает предыдущую версию. Вам не нужно сначала удалять старый.
Настройка маркетплейса, синхронизированного с GitHub
Синхронизация GitHub позволяет управлять плагинами как кодом в репозитории. Когда вы отправляете изменения, вы можете запустить синхронизацию для обновления маркетплейса, вручную или автоматически.
Подготовка вашего репозитория
Вы можете подключить репозиторий, размещённый на github.com или на хосте GitHub Enterprise вашей организации. На github.com ваш репозиторий должен быть приватным или внутренним — публичные репозитории не допускаются для маркетплейсов организации. Для синхронизации из GitLab см. Настройка маркетплейса, синхронизированного с GitLab.
Маркетплейсы, синхронизированные с GitHub, поддерживают более узкий набор типов source в marketplace.json, чем Claude Code. Относительные пути к папкам плагинов внутри репозитория маркетплейса (например, "source": "./plugins/my-plugin") полностью поддерживаются и являются самым простым вариантом. Типы источников github, url и git-subdir также поддерживаются. Типы источников npm, archive и command не поддерживаются.
Источник плагина может быть приватным в трёх случаях:
Источник github.com, который содержит владельца репозитория вашего маркетплейса, который синхронизация через Claude GitHub App получает.
Источник на GitHub Enterprise хосте вашей организации с установленным GitHub Enterprise App вашей организации в этом репозитории.
URL или git-subdir источник на том же хосте GitLab, что и репозиторий вашего маркетплейса. На gitlab.com источник также должен находиться в той же группе верхнего уровня или пространстве имён пользователя, что и репозиторий маркетплейса.
Все остальные источники получаются без учётных данных, поэтому это должен быть публичный репозиторий на github.com, gitlab.com или bitbucket.org. Источники на любом другом хосте отклоняются.
Если код вашего плагина находится в приватном репозитории, который не соответствует указанным выше критериям, скопируйте папки плагина в репозиторий маркетплейса и измените источник каждого плагина на относительный путь (git subtree или шаг CI, который упаковывает файлы, работает хорошо).
Подробнее о структуре плагина и форматировании см. справочник манифеста плагина.
Дополнительные ресурсы:
Подключить репозиторий
Убедитесь, что Cowork и Skills включены для вашей организации.
Перейдите в Параметры организации > Плагины и навыки и нажмите вкладку «Маркетплейсы».
Нажмите «Добавить плагины», затем выберите «Синхронизировать с GitHub».
Введите репозиторий в формате
owner/repo(например,acme-corp/claude-plugins).
Ваш личный токен GitHub проверяется для подтверждения доступа, затем Cowork использует токен установки GitHub App для операций синхронизации.
Не видите свой репозиторий? Убедитесь, что Claude GitHub App установлен в этом репозитории.
Как работает синхронизация
Начальная синхронизация запускается автоматически при подключении репозитория. В потоке создания GitHub вы также можете отключить «Синхронизировать автоматически», что включено по умолчанию. Если это включено, синхронизация запускается при слиянии pull request в ветку, за которой следит маркетплейс, или когда кто-то напрямую отправляет в эту ветку.
Человек, включающий или отключающий автоматическую синхронизацию, должен иметь доступ уровня администратора к этому репозиторию на GitHub. Это проверяется через его личное подключение GitHub, которое отделено от установки Claude GitHub App. Без доступа администратора страница показывает «Невозможно получить доступ к репозиторию. Убедитесь, что репозиторий существует и Claude GitHub App установлен», даже если приложение установлено правильно и ручные обновления работают.
Разрешение Webhooks (Read & Write) Claude GitHub App также должно быть одобрено при установке. На установках, созданных до введения этого разрешения, GitHub показывает подсказку «Claude запрашивает обновленные разрешения», которую должен одобрить администратор репозитория или организации.
После включения автоматическая синхронизация репозитория GitHub запускается при слиянии pull request, который включает обновление версии плагина, в ветку по умолчанию репозитория. Прямые отправки в ветку по умолчанию не запускают синхронизацию. Вы всегда можете запустить синхронизацию вручную, нажав «Пересинхронизировать» на маркетплейсе.
Во время синхронизации Cowork сравнивает последний коммит в вашем репозитории с последним синхронизированным коммитом. Если ничего не изменилось, синхронизация пропускается. Если есть изменения, Cowork читает манифест, проверяет каждый плагин и заменяет все плагины в маркетплейсе текущим состоянием репозитория. Синхронизация может занять до 30 минут в зависимости от количества плагинов.
Важно: Если синхронизация не удалась, участники сохраняют последнюю синхронизированную версию каждого плагина. Проверьте сообщение об ошибке, исправьте репозиторий и пересинхронизируйте.
Настроить маркетплейс с синхронизацией GitLab
Вы можете синхронизировать маркетплейс организации из репозитория на gitlab.com или на самостоятельно управляемом экземпляре GitLab. Поддерживаемые типы источников плагинов и какие источники могут быть приватными см. в разделе Подготовка репозитория выше.
Поддержка GitLab находится в бета-версии и применяется только к синхронизации маркетплейса плагинов. Claude Code в веб-версии пока не поддерживает репозитории GitLab.
Перед началом
Роль. Вам нужна роль Owner или Primary Owner для добавления конфигурации GitLab.
Видимость проекта. На gitlab.com проект маркетплейса должен быть приватным или внутренним. На самостоятельно управляемом экземпляре работает любая видимость.
Токен доступа. Создайте токен доступа GitLab для Claude для чтения проекта маркетплейса и любых проектов источников плагинов на том же хосте. Работают личные, групповые и проектные токены доступа. Пользователь токена должен иметь как минимум роль Reporter в этих проектах.
Устаревший (scoped) токен: как минимум область
read_api.Детализированный личный токен доступа: разрешения Project: Read, Branch: Read и Repository: Read.
Опционально, для автоматической настройки webhook (шаг 3): роль Maintainer в проекте маркетплейса плюс область
api(устаревшая) или разрешение Webhook: Create and Delete (детализированная). Без этого вы добавляете webhook вручную один раз (шаг 4).
Только самостоятельно управляемые экземпляры.
Имя хоста экземпляра должно разрешаться на публичный IP-адрес, и экземпляр должен принимать HTTPS-соединения от исходящих IP-адресов Anthropic.
Если сертификат TLS выдан приватным центром сертификации, подготовьте сертификат CA (PEM).
Доставка webhook для автоматической синхронизации поступает с вашего экземпляра на api.anthropic.com, поэтому экземпляр должен иметь возможность делать исходящие HTTPS-запросы на этот хост.
Шаг 1: Добавить конфигурацию GitLab
Чтобы добавить конфигурацию GitLab:
Перейдите в Параметры организации > Claude Code.
В разделе Самостоятельно управляемая инфраструктура найдите GitLab и нажмите «Добавить конфигурацию».
Введите отображаемое имя, имя хоста (gitlab.com или имя хоста вашего экземпляра, например gitlab.example.com), токен доступа и, для самостоятельно управляемого экземпляра с приватным CA, сертификат CA.
Нажмите «Добавить конфигурацию». Claude сразу же запускает тест соединения и показывает результаты в диалоговом окне Тест соединения GitLab.
(Опционально) Чтобы проверить, что токен может читать ваш проект маркетплейса, введите его путь (например,
platform/claude-plugins) в разделе Путь проекта и нажмите «Тест доступа синхронизации».
Вы можете повторно запустить тест в любое время из меню конфигурации с помощью Тест соединения. Имя хоста не может быть изменено позже. Если оно изменится, удалите конфигурацию и добавьте новую.
Шаг 2: Добавить маркетплейс
Чтобы добавить маркетплейс:
Перейдите в Параметры организации > Плагины и навыки и нажмите на вкладку «Маркетплейсы».
Нажмите «Добавить», затем выберите «Синхронизировать с GitLab».
В поле URL репозитория GitLab введите HTTPS URL проекта, например
https://gitlab.example.com/platform/claude-plugins. Проекты во вложенных подгруппах работают.Оставьте Автоматическую синхронизацию включённой, если вы хотите, чтобы отправки запускали синхронизацию (см. Шаг 3).
Выберите Доступ по умолчанию для плагинов, которые содержит маркетплейс.
Нажмите «Создать».
Claude читает ветку по умолчанию проекта и проверяет файл маркетплейса перед его созданием. Маркетплейс получает имя по пути проекта.
Шаг 3: Автоматическая синхронизация
Если Автоматическая синхронизация включена, каждая отправка в ветку по умолчанию проекта запускает синхронизацию через вебхук в проекте GitLab. Если ваш токен может управлять вебхуками (см. Перед началом), Claude создаст вебхук для вас, и больше ничего не требуется.
Вы можете включить или отключить Автоматическую синхронизацию позже из меню маркетплейса. Включение настраивает вебхук таким же образом.
Шаг 4: Если Claude не может создать вебхук
Если токен не может управлять вебхуками, Claude показывает сообщение Завершите настройку вебхука в GitLab на экране с URL вебхука и токеном. Токен отображается только один раз, поэтому завершите этот шаг перед закрытием сообщения.
В вашем проекте GitLab откройте Параметры > Вебхуки и добавьте новый вебхук с URL из сообщения.
Вставьте токен в поле.
Если сообщение показывает Секретный токен, вставьте его в поле Secret token в GitLab.
Если сообщение показывает Токен подписи (gitlab.com и самоуправляемые версии 19.1 или позже), выберите «Создать токен подписи» в GitLab и замените созданное значение на значение из Claude.
Включите События отправки и сохраните.
(Необязательно) Используйте Тест > События отправки на новом вебхуке в GitLab и убедитесь, что он возвращает HTTP 200.
Если вы потеряли токен, откройте Настроить вебхук из меню маркетплейса, нажмите «Удалить вебхук», затем «Включить вебхук», чтобы получить новый. Старый токен перестанет работать.
Выберите между ручной загрузкой и синхронизацией репозитория
Сценарий | Рекомендуемый подход |
Плагины поддерживаются в системе контроля версий с CI/CD | Синхронизация GitHub или GitLab |
Несколько разработчиков сотрудничают над плагинами | Синхронизация GitHub или GitLab |
Вы хотите автоматическое распространение обновлений | Синхронизация GitHub или GitLab |
Быстрое прототипирование или одноразовые инструменты | Ручная загрузка |
Плагины, созданные не инженерными командами | Ручная загрузка |
Среды без доступа к GitHub или GitLab | Ручная загрузка |
Тестирование плагина перед добавлением его в синхронизированный репозиторий | Ручная загрузка |
Контролируйте распределение плагинов
После создания маркетплейса с плагинами вы контролируете их распределение с помощью предпочтений установки. Для каждого плагина вы можете установить один из четырёх вариантов:
Предпочтение | Что это делает | Что видят члены |
Установлено по умолчанию | Предварительно устанавливает плагин для всех членов организации | Плагин появляется в их списке без каких-либо действий. Члены могут отключить его, если захотят. |
Доступно для установки | Указано на вкладке Обнаружить | Пользователи видят его на вкладке Обнаружить и могут добавить его самостоятельно. |
Недоступно | Полностью скрыто | Пользователи не могут видеть или добавлять плагин. Полезно для промежуточного хранения или снятия плагинов с производства. |
Обязательно | Предварительно устанавливает плагин для всех членов организации без возможности его удаления | Плагин появляется в их списке без каких-либо действий, отмечен как «Этот плагин требуется вашей организацией». Пользователи не могут его отключить или удалить. Он также остается включенным в сеансах Claude Code, которые синхронизируют плагины учетной записи участника. |
Важно: плагины, установленные на «Установлено по умолчанию» или «Обязательно», также устанавливаются в Claude Code для пользователей, которые входят со своей учетной записью Claude. В Claude Code хуки плагина, подагенты и MCP-серверы работают на компьютере пользователя, и плагин «Обязательно» нельзя отключить там. Перед установкой плагина на «Обязательно» проверьте его хуки. Узнайте больше о синхронизированных плагинах в документации Claude Code.
Установить предпочтения
В Параметры организации > Плагины и навыки нажмите вкладку «Инвентарь».
Найдите плагин и нажмите кнопку меню в конце его строки.
Нажмите «Доступ по умолчанию», затем выберите опцию в разделе Установка.
Изменения вступают в силу при следующем сеансе или обновлении плагина каждого участника.
Что видят участники
Участники просматривают доступные плагины на вкладке Обнаружить в разделе Настройка > Плагины. Плагины, установленные на «Установлено по умолчанию» или «Обязательно», автоматически появляются в их списке. Плагины, установленные на «Доступно для установки», отображаются на вкладке Обнаружить, чтобы участники могли добавить их самостоятельно.
Участники не могут редактировать плагины, управляемые организацией, что предотвращает конфликтующие изменения общих инструментов.
Настроить доступ к плагинам по группам
Администраторы Enterprise могут переопределить предпочтение установки плагина на уровне организации для определенных групп. Например, вы можете автоматически установить плагин для группы Engineering, сделать его доступным для Legal для самостоятельной установки и скрыть его от всех остальных.
Доступ к плагинам на уровне группы доступен в планах Enterprise. Вы устанавливаете его на той же странице Параметры организации > Плагины и навыки, для чего требуется роль Owner или пользовательская роль, включающая управление библиотеками организации.
Как работают переопределения групп
Каждый плагин в вашем маркетплейсе имеет предпочтение установки на уровне организации (Установлено по умолчанию, Доступно для установки, Обязательно или Недоступно). По умолчанию каждая группа наследует этот параметр на уровне организации.
Когда вы устанавливаете переопределение на уровне группы для плагина, оно заменяет параметр на уровне организации для участников этой группы. Порядок разрешения: параметр группы, затем параметр на уровне организации, затем значение по умолчанию маркетплейса.
Установить доступ к плагину для группы
В Параметры организации > Плагины и навыки нажмите вкладку «Инвентарь».
Найдите плагин, который хотите настроить, и нажмите кнопку меню в конце его строки.
Нажмите «Доступ по группам…».
Нажмите «Добавить группы» рядом с Целевая установка.
Выберите группу и выберите одно из предпочтений установки, указанных выше.
Как вручную созданные группы, так и группы, подготовленные SCIM от вашего поставщика удостоверений, отображаются в средстве выбора групп и работают одинаково.
Что происходит, когда участник входит в несколько групп
Если участник принадлежит двум или более группам с разными параметрами для одного плагина, применяется наиболее разрешающий параметр. Порядок от наиболее к наименее разрешающему: Обязательно > Установлено по умолчанию > Доступно для установки > Недоступно.
Например, если группа A устанавливает плагин на «Недоступно», а группа B устанавливает его на «Установлено по умолчанию», участник в обеих группах получит плагин, установленный по умолчанию.
Примечание: это отличается от того, как разрешаются лимиты расходов группы. Лимиты расходов применяют либо более высокое, либо более низкое значение группы в зависимости от параметра Лимит расходов для нескольких групп. Доступ к плагинам применяет наиболее разрешающее значение, потому что группы здесь предназначены для предоставления доступа командам, которым нужен инструмент, а не для использования в качестве границы безопасности. Если вам нужно жестко заблокировать плагин, установите его предпочтение на уровне организации на «Недоступно» и предоставьте доступ только группам, которые должны его иметь.
Что происходит при удалении группы
Если группа удаляется (например, удаляется из вашего поставщика удостоверений), переопределение остается в пользовательском интерфейсе администратора, но помечается как потерянное. Это не влияет на участников (так как никто не принадлежит удаленной группе) и не учитывается в значке пользовательского доступа. Вы можете очистить потерянные переопределения в параметрах «Доступ по группам…» плагина.
Сохраняются ли параметры группы при повторной синхронизации маркетплейса?
Да. Переопределения на уровне группы сохраняются при повторной синхронизации маркетплейса, подключенного к GitHub или GitLab. Они удаляются только если сам плагин удаляется из маркетплейса.
Ограничить маркетплейсы, которые пользователи могут добавлять
Owner или Primary Owner может ограничить, какие маркетплейсы плагинов люди в вашей организации могут добавлять, используя список разрешений, список блокировок или оба. Вы устанавливаете эти списки в управляемых параметрах Claude Code, но они также применяются в Claude и Claude Cowork.
Чтобы установить список разрешений или список блокировок:
Перейдите в Параметры организации > Claude Code.
Найдите Управляемые параметры.
Нажмите «Управлять».
Добавьте strictKnownMarketplaces (список разрешений), blockedMarketplaces (список блокировок) или оба в JSON.
Нажмите «Добавить параметры» или «Обновить параметры».
Введите название вашей организации GitHub точно так, как его показывает GitHub, потому что сопоставление списка разрешений чувствительно к регистру. Если источник находится в обоих списках, он блокируется.
После установки списков Claude проверяет их каждый раз, когда кто-то в вашей организации добавляет маркетплейс из репозитория Git в Claude, Claude Desktop или Cowork. Это охватывает маркетплейсы, которые пользователи добавляют для себя в Customize, и маркетплейсы, добавленные для всей организации в Параметры организации > Плагины и навыки. Claude отказывает в доступе к любому репозиторию, который списки не разрешают, за исключением маркетплейсов, созданных Anthropic.
Имейте в виду:
Установите списки в параметрах организации. Файл managed-settings.json или политика MDM, развернутые на компьютерах, применяются только к Claude Code на этих компьютерах.
Существующие маркетплейсы не проверяются повторно. Маркетплейсы, добавленные до установки списков, остаются до тех пор, пока кто-то их не удалит.
Загруженные плагины не проверяются. Чтобы запретить пользователям загружать файлы плагинов, отключите Пользовательские навыки в Параметры организации > Плагины и навыки на вкладке «Политика».
Для каждого типа источника, который принимают списки, см. Ограничить то, что пользователи могут установить в документации Claude Code.
Обновление и удаление плагинов
Ручные маркетплейсы
Чтобы обновить плагин, загрузите новый ZIP-файл с тем же именем плагина. Новая версия автоматически заменит существующую. Имена плагинов — это уникальный идентификатор, поэтому legal всегда заменит legal.
Чтобы удалить плагин, удалите его из вашего маркетплейса в Organization settings > Plugins & skills на вкладке «Inventory».
Маркетплейсы, синхронизированные с GitHub
Отправьте изменения в подключённый репозиторий, затем перейдите в Organization settings > Plugins & skills и нажмите вкладку «Marketplaces», найдите ваш маркетплейс и нажмите «Update» для запуска синхронизации. Каждая синхронизация заменяет все плагины текущим состоянием репозитория. Если владелец включил «Sync automatically» для маркетплейса, синхронизация также запускается при слиянии pull request с обновлением версии плагина в ветку по умолчанию репозитория.
Для маркетплейсов, синхронизированных с GitLab, см. Set up a GitLab-synced marketplace.
Чтобы удалить плагин, удалите его из репозитория и запустите синхронизацию.
Ограничения
Ограничение | Значение | Примечания |
Максимальный размер ZIP-файла плагина (загрузка) | 200 MB | Проверяется как на клиентской стороне, так и на сервере |
Максимальное количество плагинов на маркетплейс (вручную) | 1000 | На маркетплейс |
Максимальное количество плагинов на маркетплейс (синхронизация GitHub или GitLab) | 1000 | На маркетплейс |
Максимальная длина имени плагина | 64 символа | Должны использоваться строчные слова, разделённые дефисами |
Время ожидания синхронизации | 30 минут | На операцию синхронизации |
Видимость синхронизированного репозитория | Только приватные или внутренние на github.com и gitlab.com | Размещены на github.com, GitHub Enterprise Server, gitlab.com или самоуправляемом экземпляре GitLab. Хосты GitLab (включая gitlab.com) требуют конфигурации GitLab в Organization settings > Claude Code. |
Правила именования
Имена плагинов должны использовать строчные слова, разделённые дефисами (например, deployment-tools, а не Deployment Tools). Следующие имена маркетплейсов зарезервированы и не могут быть использованы:
claude-code-marketplaceclaude-code-pluginsclaude-plugins-officialanthropic-marketplaceanthropic-pluginsagent-skillslife-sciences
Имена, выдающие себя за официальные маркетплейсы Anthropic, также заблокированы.
Примечание: Авторы плагинов могут установить displayName, чтобы плагин отображал читаемое имя в каталоге вместо его slug. Если автор не установит его, плагин отображает свой slug (например, deployment-tools).
Устранение неполадок
Загрузка отклонена
Частые причины: файл превышает 200 МБ, это не корректный ZIP-файл или маркетплейс достиг лимита в 1000 плагинов. Проверьте размер и формат файла, удалите неиспользуемые плагины, если вы на пределе. Если включено сканирование навыков и плагинов, плагин может быть отклонён, если он был помечен как вредоносный. Проверьте причину, исправьте проблему и загрузите плагин снова.
Плагин не отображается для участников
Проверьте предпочтение установки плагина в настройках маркетплейса. Если установлено значение Not available, участники его не увидят. Также убедитесь, что Cowork и Skills оба включены для вашей организации.
Обновлённый плагин не отражается для участников
Изменения вступают в силу при следующем сеансе или обновлении плагина каждого участника. В Claude Code пользователи получат изменение при следующем запуске Claude Code. Если обновление всё ещё не отображается, подтвердите успешность загрузки, проверив версию плагина в маркетплейсе.
Синхронизация GitHub не удаётся из-за ошибки содержимого
Один или несколько плагинов в вашем репозитории, вероятно, отформатированы неправильно. Исправьте проблему форматирования, отправьте обновление на GitHub и запустите синхронизацию снова. Требования к структуре плагина см. в plugin manifest reference.
Синхронизация не удаётся с сообщением «External plugin source type is not supported. Supported types: git-subdir, github, url» или плагины пропускаются с сообщением «Repository not found on gitlab.com. Check the URL and make sure the repository is public.»
Одна или несколько записей плагинов в вашем marketplace.json используют source, который указывает вне подключённого репозитория (источник github, url или git-subdir), и организационная синхронизация не может его получить. Приватный источник работает только в трёх случаях: репозиторий github.com имеет того же владельца, что и репозиторий маркетплейса, репозиторий на хосте GitHub Enterprise вашей организации с установленным приложением GitHub Enterprise App или источник url или git-subdir на том же хосте GitLab, что и репозиторий маркетплейса (на gitlab.com также в той же группе верхнего уровня или пространстве имён пользователя).
Для любого другого приватного источника переместите папки плагинов в репозиторий маркетплейса и измените source каждой записи на относительный путь (например, "./plugins/my-plugin"), затем отправьте и повторно синхронизируйте. Или загрузите затронутые плагины отдельно через Параметры организации > Плагины и навыки. Нажмите «Добавить», «Загрузить плагин», затем выберите «Добавить в существующий маркетплейс». Плагины, загруженные через собственное меню «Настройка» участника, устанавливаются только для этого участника и не распространяются на вашу организацию, хотя участники могут делиться плагинами с конкретными коллегами или группами, если включено общее использование.
Не видно репозитория GitHub при подключении
Убедитесь, что приложение Claude GitHub установлено в этом репозитории. Сначала проверяется ваш личный токен GitHub для подтверждения доступа, но сама синхронизация использует токен установки приложения GitHub.
«Невозможно получить доступ к репозиторию» при включении «Синхронизировать автоматически»
Если ручные обновления работают, но включение «Синхронизировать автоматически» показывает «Невозможно получить доступ к репозиторию. Убедитесь, что репозиторий существует и приложение Claude GitHub установлено», возможны две причины:
У вас нет прав администратора для этого репозитория. Включение автоматической синхронизации создает вебхук, для чего требуется доступ уровня администратора к репозиторию через ваше личное подключение GitHub. Попросите администратора репозитория включить переключатель или обновите ваш доступ GitHub.
Разрешение Webhooks приложения Claude GitHub не было одобрено. При более старых установках GitHub показывает запрос «Claude запрашивает обновленные разрешения». Администратор репозитория или организации должен одобрить разрешение Webhooks (Read & Write) при установке.
«Для вашей организации еще не настроен экземпляр GitLab. Добавьте его в параметрах Claude Code, затем вернитесь сюда» при добавлении маркетплейса
Если вы видите это сообщение при добавлении маркетплейса в GitLab, убедитесь, что вы сначала добавили конфигурацию GitLab. См. Шаг 1: Добавить конфигурацию GitLab в разделе Настройка маркетплейса, синхронизированного с GitLab.
«Этот URL не находится на настроенном экземпляре GitLab»
Убедитесь, что имя хоста URL точно совпадает с настроенным именем хоста GitLab.
Добавление проекта gitlab.com не удается с ошибкой «Не удалось создать маркетплейс. Попробуйте еще раз.»
Проверьте, что видимость проекта установлена как приватная или внутренняя. Публичные проекты gitlab.com нельзя использовать в качестве маркетплейсов организации.
Тест подключения не проходит на этапе «Reach host» (например, «Не удалось разрешить имя хоста», «Соединение было отклонено» или «GitLab не ответил вовремя»), или добавление маркетплейса на самоуправляемом экземпляре не удается с общей ошибкой
Убедитесь, что экземпляр доступен из открытого интернета по HTTPS и что IP-адреса исходящего трафика Anthropic разрешены через ваш брандмауэр. «Не удалось установить безопасное соединение» обычно означает, что сертификат CA отсутствует или неправильный.
Ошибки, начинающиеся с «Ошибка аутентификации для…» или «Доступ запрещен»
Токен истек, отозван или не имеет области или роли, указанные в разделе Перед началом в Настройка маркетплейса, синхронизированного с GitLab. Создайте новый токен и вставьте его в конфигурацию (Редактировать > Токен доступа).