Маркетплейсы плагинов

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

Обзор

Маркетплейс — это JSON-файл, который содержит список доступных плагинов и описывает, где их найти. Маркетплейсы предоставляют:

Централизованное обнаружение: просмотр плагинов из нескольких источников в одном месте
Управление версиями: отслеживание и автоматическое обновление версий плагинов
Распространение в команде: совместное использование необходимых плагинов в вашей организации
Гибкие источники: поддержка git-репозиториев, репозиториев GitHub, локальных путей и менеджеров пакетов

Предварительные требования

Claude Code установлен и запущен
Базовое знакомство с форматом JSON-файлов
Для создания маркетплейсов: Git-репозиторий или локальная среда разработки

Добавление и использование маркетплейсов

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

Добавление маркетплейсов GitHub

Добавление репозитория GitHub, содержащего .claude-plugin/marketplace.json

/plugin marketplace add owner/repo

Добавление Git-репозиториев

Добавление любого git-репозитория

/plugin marketplace add https://gitlab.com/company/plugins.git

Добавление локальных маркетплейсов для разработки

Добавление локального каталога, содержащего .claude-plugin/marketplace.json

/plugin marketplace add ./my-marketplace

Добавление прямого пути к файлу marketplace.json

/plugin marketplace add ./path/to/marketplace.json

Добавление удаленного marketplace.json через URL

/plugin marketplace add https://url.of/marketplace.json

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

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

Установка из любого известного маркетплейса

/plugin install plugin-name@marketplace-name

Интерактивный просмотр доступных плагинов

/plugin

Проверка установки маркетплейса

После добавления маркетплейса:

Список маркетплейсов: запустите /plugin marketplace list, чтобы подтвердить его добавление
Просмотр плагинов: используйте /plugin для просмотра доступных плагинов из вашего маркетплейса
Тестирование установки: попробуйте установить плагин, чтобы проверить, работает ли маркетплейс правильно

Настройка маркетплейсов команды

Установите автоматическую установку маркетплейсов для проектов команды, указав необходимые маркетплейсы в .claude/settings.json:

{
  "extraKnownMarketplaces": {
    "team-tools": {
      "source": {
        "source": "github",
        "repo": "your-org/claude-plugins"
      }
    },
    "project-specific": {
      "source": {
        "source": "git",
        "url": "https://git.company.com/project-plugins.git"
      }
    }
  }
}

Когда члены команды доверяют папке репозитория, Claude Code автоматически устанавливает эти маркетплейсы и любые плагины, указанные в поле enabledPlugins.

Создание собственного маркетплейса

Создавайте и распространяйте пользовательские коллекции плагинов для вашей команды или сообщества.

Предварительные требования для создания маркетплейса

Git-репозиторий (GitHub, GitLab или другой хостинг git)
Понимание формата JSON-файлов
Один или несколько плагинов для распространения

Создание файла маркетплейса

Создайте .claude-plugin/marketplace.json в корне вашего репозитория:

{
  "name": "company-tools",
  "owner": {
    "name": "DevTools Team",
    "email": "[email protected]"
  },
  "plugins": [
    {
      "name": "code-formatter",
      "source": "./plugins/formatter",
      "description": "Automatic code formatting on save",
      "version": "2.1.0",
      "author": {
        "name": "DevTools Team"
      }
    },
    {
      "name": "deployment-tools",
      "source": {
        "source": "github",
        "repo": "company/deploy-plugin"
      },
      "description": "Deployment automation tools"
    }
  ]
}

Схема маркетплейса

Обязательные поля

Поле	Тип	Описание
`name`	string	Идентификатор маркетплейса (kebab-case, без пробелов)
`owner`	object	Информация о сопровождающем маркетплейса
`plugins`	array	Список доступных плагинов

Дополнительные метаданные

Поле	Тип	Описание
`metadata.description`	string	Краткое описание маркетплейса
`metadata.version`	string	Версия маркетплейса
`metadata.pluginRoot`	string	Базовый путь для относительных источников плагинов

Записи плагинов

Записи плагинов основаны на схеме манифеста плагина (со всеми полями, сделанными необязательными) плюс поля, специфичные для маркетплейса (source, category, tags, strict), где name является обязательным.

Обязательные поля:

Поле	Тип	Описание
`name`	string	Идентификатор плагина (kebab-case, без пробелов)
`source`	string\|object	Откуда получить плагин

Дополнительные поля плагина

Стандартные поля метаданных:

Поле	Тип	Описание
`description`	string	Краткое описание плагина
`version`	string	Версия плагина
`author`	object	Информация об авторе плагина
`homepage`	string	Домашняя страница плагина или URL документации
`repository`	string	URL репозитория исходного кода
`license`	string	Идентификатор лицензии SPDX (например, MIT, Apache-2.0)
`keywords`	array	Теги для обнаружения и категоризации плагина
`category`	string	Категория плагина для организации
`tags`	array	Теги для поиска
`strict`	boolean	Требовать plugin.json в папке плагина (по умолчанию: true) ¹

Поля конфигурации компонентов:

Поле	Тип	Описание
`commands`	string\|array	Пользовательские пути к файлам команд или каталогам
`agents`	string\|array	Пользовательские пути к файлам агентов
`hooks`	string\|object	Конфигурация пользовательских хуков или путь к файлу хуков
`mcpServers`	string\|object	Конфигурации MCP-сервера или путь к конфигурации MCP

^{1 - Когда strict: true (по умолчанию), плагин должен включать файл манифеста plugin.json, и поля маркетплейса дополняют эти значения. Когда strict: false, plugin.json является необязательным. Если его нет, запись маркетплейса служит полным манифестом плагина.}

Источники плагинов

Относительные пути

Для плагинов в том же репозитории:

{
  "name": "my-plugin",
  "source": "./plugins/my-plugin"
}

Репозитории GitHub

{
  "name": "github-plugin",
  "source": {
    "source": "github",
    "repo": "owner/plugin-repo"
  }
}

Git-репозитории

{
  "name": "git-plugin",
  "source": {
    "source": "url",
    "url": "https://gitlab.com/team/plugin.git"
  }
}

Расширенные записи плагинов

Записи плагинов могут переопределять расположение компонентов по умолчанию и предоставлять дополнительные метаданные. Обратите внимание, что ${CLAUDE_PLUGIN_ROOT} — это переменная окружения, которая разрешается в каталог установки плагина (подробности см. в разделе Переменные окружения):

{
  "name": "enterprise-tools",
  "source": {
    "source": "github",
    "repo": "company/enterprise-plugin"
  },
  "description": "Enterprise workflow automation tools",
  "version": "2.1.0",
  "author": {
    "name": "Enterprise Team",
    "email": "[email protected]"
  },
  "homepage": "https://docs.company.com/plugins/enterprise-tools",
  "repository": "https://github.com/company/enterprise-plugin",
  "license": "MIT",
  "keywords": ["enterprise", "workflow", "automation"],
  "category": "productivity",
  "commands": [
    "./commands/core/",
    "./commands/enterprise/",
    "./commands/experimental/preview.md"
  ],
  "agents": [
    "./agents/security-reviewer.md",
    "./agents/compliance-checker.md"
  ],
  "hooks": {
    "PostToolUse": [
      {
        "matcher": "Write|Edit",
        "hooks": [{"type": "command", "command": "${CLAUDE_PLUGIN_ROOT}/scripts/validate.sh"}]
      }
    ]
  },
  "mcpServers": {
    "enterprise-db": {
      "command": "${CLAUDE_PLUGIN_ROOT}/servers/db-server",
      "args": ["--config", "${CLAUDE_PLUGIN_ROOT}/config.json"]
    }
  },
  "strict": false
}

Связь схем: Записи плагинов используют схему манифеста плагина со всеми полями, сделанными необязательными, плюс поля, специфичные для маркетплейса (source, strict, category, tags). Это означает, что любое поле, допустимое в файле plugin.json, также может использоваться в записи маркетплейса. Когда strict: false, запись маркетплейса служит полным манифестом плагина, если plugin.json не существует. Когда strict: true (по умолчанию), поля маркетплейса дополняют собственный файл манифеста плагина.

Размещение и распространение маркетплейсов

Выберите лучшую стратегию размещения для ваших потребностей в распространении плагинов.

Размещение на GitHub (рекомендуется)

GitHub предоставляет самый простой способ распространения:

Создание репозитория: установите новый репозиторий для вашего маркетплейса
Добавление файла маркетплейса: создайте .claude-plugin/marketplace.json с определениями ваших плагинов
Совместное использование с командами: члены команды добавляют с помощью /plugin marketplace add owner/repo

Преимущества: встроенный контроль версий, отслеживание проблем и функции командного сотрудничества.

Размещение на других сервисах git

Любой сервис хостинга git работает для распространения маркетплейса, используя URL произвольного git-репозитория. Например, используя GitLab:

/plugin marketplace add https://gitlab.com/company/plugins.git

Использование локальных маркетплейсов для разработки

Протестируйте ваш маркетплейс локально перед распространением:

Добавление локального маркетплейса для тестирования

/plugin marketplace add ./my-local-marketplace

Тестирование установки плагина

/plugin install test-plugin@my-local-marketplace

Управление операциями маркетплейса

Список известных маркетплейсов

Список всех настроенных маркетплейсов

/plugin marketplace list

Показывает все настроенные маркетплейсы с их источниками и статусом.

Обновление метаданных маркетплейса

/plugin marketplace update marketplace-name

Обновляет списки плагинов и метаданные из источника маркетплейса.

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

/plugin marketplace remove marketplace-name

Удаляет маркетплейс из вашей конфигурации.

Удаление маркетплейса приведет к удалению всех плагинов, установленных из него.

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

Распространенные проблемы маркетплейса

Маркетплейс не загружается

Симптомы: невозможно добавить маркетплейс или увидеть плагины из него Решения:

Проверьте, что URL маркетплейса доступен
Убедитесь, что .claude-plugin/marketplace.json существует по указанному пути
Убедитесь, что синтаксис JSON верен, используя claude plugin validate
Для приватных репозиториев подтвердите, что у вас есть разрешения на доступ

Ошибки установки плагина

Симптомы: маркетплейс появляется, но установка плагина не удается Решения:

Проверьте, что URL источников плагинов доступны
Убедитесь, что каталоги плагинов содержат необходимые файлы
Для источников GitHub убедитесь, что репозитории являются общедоступными или у вас есть доступ
Протестируйте источники плагинов вручную, клонируя/загружая их

Проверка и тестирование

Протестируйте ваш маркетплейс перед совместным использованием:

Проверка синтаксиса JSON маркетплейса

claude plugin validate .

Добавление маркетплейса для тестирования

/plugin marketplace add ./path/to/marketplace

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

/plugin install test-plugin@marketplace-name

Для полных рабочих процессов тестирования плагинов см. Тестирование плагинов локально. Для технического устранения неполадок см. Справочник плагинов.

Следующие шаги

Для пользователей маркетплейса

Обнаружение маркетплейсов сообщества: поиск на GitHub коллекций плагинов Claude Code
Внесение отзывов: сообщайте о проблемах и предлагайте улучшения сопровождающим маркетплейса
Совместное использование полезных маркетплейсов: помогите вашей команде обнаружить ценные коллекции плагинов

Для создателей маркетплейса

Создание коллекций плагинов: создавайте тематические маркетплейсы вокруг конкретных вариантов использования
Установление версионирования: внедрите четкие политики версионирования и обновления
Взаимодействие с сообществом: собирайте отзывы и поддерживайте активные сообщества маркетплейса
Документация: предоставляйте четкие файлы README, объясняющие содержимое вашего маркетплейса

Для организаций

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

См. также

Плагины - установка и использование плагинов
Справочник плагинов - полные технические спецификации и схемы
Разработка плагинов - создание собственных плагинов
Параметры - параметры конфигурации плагинов

Администрирование

​Обзор

​Предварительные требования

​Добавление и использование маркетплейсов

​Добавление маркетплейсов GitHub

​Добавление Git-репозиториев

​Добавление локальных маркетплейсов для разработки

​Установка плагинов из маркетплейсов

​Проверка установки маркетплейса

​Настройка маркетплейсов команды

​Создание собственного маркетплейса

​Предварительные требования для создания маркетплейса

​Создание файла маркетплейса

​Схема маркетплейса

​Обязательные поля

​Дополнительные метаданные

​Записи плагинов

​Дополнительные поля плагина

​Источники плагинов

​Относительные пути

​Репозитории GitHub

​Git-репозитории

​Расширенные записи плагинов

​Размещение и распространение маркетплейсов

​Размещение на GitHub (рекомендуется)

​Размещение на других сервисах git

​Использование локальных маркетплейсов для разработки

​Управление операциями маркетплейса

​Список известных маркетплейсов

​Обновление метаданных маркетплейса

​Удаление маркетплейса

​Устранение неполадок маркетплейсов

​Распространенные проблемы маркетплейса

​Маркетплейс не загружается

​Ошибки установки плагина

​Проверка и тестирование

​Следующие шаги

​Для пользователей маркетплейса

​Для создателей маркетплейса

​Для организаций

​См. также

Обзор

Предварительные требования

Добавление и использование маркетплейсов

Добавление маркетплейсов GitHub

Добавление Git-репозиториев

Добавление локальных маркетплейсов для разработки

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

Проверка установки маркетплейса

Настройка маркетплейсов команды

Создание собственного маркетплейса

Предварительные требования для создания маркетплейса

Создание файла маркетплейса

Схема маркетплейса

Обязательные поля

Дополнительные метаданные

Записи плагинов

Дополнительные поля плагина

Источники плагинов

Относительные пути

Репозитории GitHub

Git-репозитории

Расширенные записи плагинов

Размещение и распространение маркетплейсов

Размещение на GitHub (рекомендуется)

Размещение на других сервисах git

Использование локальных маркетплейсов для разработки

Управление операциями маркетплейса

Список известных маркетплейсов

Обновление метаданных маркетплейса

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

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

Распространенные проблемы маркетплейса

Маркетплейс не загружается

Ошибки установки плагина

Проверка и тестирование

Следующие шаги

Для пользователей маркетплейса

Для создателей маркетплейса

Для организаций

См. также