Плагины и маркетплейсClaude Code

Когда ты обживаешься в Claude Code, у тебя накапливается набор настроек: пара скилов, свои slash-команды, субагент-другой, хуки на автоформат. Перенести это на новую машину или поделиться с коллегой руками — морока. Плагины решают ровно это: упаковывают весь набор в одну коробку, которая ставится одной командой. А маркетплейс — это магазин таких коробок.

Часть 1 · Понятие

Что такое плагин Claude Code

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

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

Плагин — это коробка. Маркетплейс — это магазин коробок. Одна команда — весь набор внутри.

Часть 2 · Установка

Как поставить плагин

Всё делается прямо в чате Claude Code slash-командами. Сначала говоришь, откуда брать плагины — добавляешь маркетплейс. Источником может быть репозиторий на GitHub (owner/repo), git-URL или даже локальная папка:

# Добавляем маркетплейс (репозиторий-каталог плагинов)
/plugin marketplace add owner/repo

# Можно из локальной папки — удобно при разработке своего плагина:
/plugin marketplace add ./my-marketplace

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

# Ставим плагин из маркетплейса
/plugin install имя-плагина@имя-маркетплейса

# Пример:
/plugin install quality-review-plugin@my-plugins

После установки расширения из плагина становятся доступны сразу: скилы Claude подключает по описанию, команды появляются в списке /, субагенты — в делегировании. Управлять подключениями можно и интерактивно — команда /plugin без аргументов открывает меню.

Часть 3 · Состав

Что лежит внутри плагина

Структура простая и предсказуемая. Один служебный манифест описывает плагин, остальные папки — это его начинка. Что положишь, то плагин и даст: только скилы, только команды или всё сразу.

my-plugin/
├── .claude-plugin/
│   └── plugin.json      # манифест: имя, описание, версия
├── skills/              # скилы (навыки, подключаются сами)
│   └── code-reviewer/
│       └── SKILL.md
├── commands/            # slash-команды
├── agents/              # субагенты
└── hooks/               # хуки на события

Манифест plugin.json — это короткая карточка плагина: как он называется, что делает и какая версия. По ней плагин отображается в менеджере:

{
  "name": "my-first-plugin",
  "description": "A greeting plugin to learn the basics",
  "version": "1.0.0",
  "author": { "name": "Your Name" }
}

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

Часть 4 · Сборка

Как собрать и раздать свой

Один плагин — это начинка. Маркетплейс — это витрина, через которую её раздают. marketplace.json описывает каталог: как он называется, кто владелец и какие плагины в нём есть с указанием, где их искать:

{
  "name": "my-plugins",
  "owner": { "name": "Your Name" },
  "plugins": [
    {
      "name": "quality-review-plugin",
      "source": "./plugins/quality-review-plugin",
      "description": "Adds a quality-review skill for quick code reviews"
    }
  ]
}

Источником плагина (source) может быть путь внутри того же репозитория или ссылка на отдельный GitHub-репозиторий. Дальше всё как обычно: коллега добавляет твой маркетплейс через /plugin marketplace add и ставит плагин. Так команды раздают единые настройки, а сообщества — тематические наборы.

Часть 5 · Управление

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

Список установленного с версиями, источником и статусом показывает команда из обычного терминала:

# Показать установленные плагины: версия, маркетплейс, включён ли
claude plugin list

Тонко управлять — что включено, а что нет — удобно в settings.json через поле enabledPlugins. Там же можно заранее объявить известные маркетплейсы, чтобы они подхватывались на новой машине:

{
  "enabledPlugins": {
    "formatter@acme-tools": true,
    "analyzer@security-plugins": false
  }
}

Вопросы

Частые вопросы

Читать дальше

Соседние гайды