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

Маркетплейсы плагинов — это каталоги доступных плагинов, которые упрощают обнаружение, установку и управление расширениями 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": "Автоматическое форматирование кода при сохранении",
      "version": "2.1.0",
      "author": {
        "name": "DevTools Team"
      }
    },
    {
      "name": "deployment-tools",
      "source": {
        "source": "github",
        "repo": "company/deploy-plugin"
      },
      "description": "Инструменты автоматизации развертывания"
    }
  ]
}

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

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

Поле	Тип	Описание
`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": "Инструменты автоматизации корпоративных рабочих процессов",
  "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

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

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

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

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

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

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

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

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

См. также

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

Начало работы

Создавайте с Claude Code

Claude Code SDK

Развертывание

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

Конфигурация

Справочник

Ресурсы

​Обзор

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

​Хостинг на GitHub (рекомендуется)

​Хостинг на других git-сервисах

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

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

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

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

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

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

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

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

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

​Валидация и тестирование

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

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

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

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

​См. также

Обзор

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Хостинг на GitHub (рекомендуется)

Хостинг на других git-сервисах

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

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

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

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

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

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

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

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

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

Валидация и тестирование

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

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

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

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

См. также