Содержание

Чем больше вы работаете с Claude Code, тем больше у вас накапливается собственных слэш-команд, часто используемых субагентов, серверов MCP и хуков. plugin — это механизм, который объединяет всё это в один блок, поддающийся версионированию, и позволяет делиться им и переиспользовать его между командами и проектами, а marketplace — это место, где они распространяются (plugins появились в публичной бете в октябре 2025 года; в 2026 году добавились официальный каталог и поиск/список в /plugin).

В этой статье разбираем, что такое plugin, его структуру, как им пользоваться, marketplace, создание и публикацию своего, а также область распространения и безопасность — на основе официальной документации. Три ключевых тезиса сразу. (1) plugin — это одна директория, объединяющая «навыки / команды / субагентов / хуки / серверы MCP», где .claude-plugin/plugin.json служит манифестом. (2) Через /plugin добавьте marketplace, а через install — сам plugin. (3) Создать свой просто — положите plugin.json и SKILL.md, проверьте через claude --plugin-dir и опубликуйте через git.

CLAUDE CODE · PLUGINS

Объедините функции и поделитесь ими

— навыки, агенты, хуки, MCP — установка из marketplace одной командой

my-plugin/
.claude-plugin/plugin.json
skills/
agents/
hooks/
.mcp.json
commands/ …
/plugin marketplace add owner/repo
↓
/plugin install name@market
↓
✓ enabled — поделиться с командой

plugin — это набор функций; marketplace — его каталог распространения (репозиторий git и т. п.).
Официальный marketplace (claude.com/plugins) работает из коробки, а публикация своего сводится к одному лишь git.

1. Что такое plugin для Claude Code

Официальное определение: plugin — это «самодостаточная директория, объединяющая пользовательскую функциональность Claude Code так, чтобы её можно было версионировать, передавать и переиспользовать». В один plugin можно включить любое сочетание следующего:

КомпонентРасположениеРоль
Навыки (Skills)skills/<name>/SKILL.mdВозможности, которые Claude вызывает автоматически по задаче (разбор Skills)
Слэш-командыcommands/Вызываемые пользователем команды /name (документация теперь ориентирует на навыки)
Субагентыagents/Пользовательские определения агентов, отображаемые в /agents
Хуки (Hooks)hooks/hooks.jsonЗапускаются автоматически на событиях вроде PostToolUse
Серверы MCP.mcp.jsonИнтеграции с внешними инструментами/данными (MCP)
Манифест.claude-plugin/plugin.jsonМетаданные: name, description, version и т. д.

Если коротко, plugin — это «расширение Claude Code, упакованное в форму, которой можно делиться». Кастомизации, которые раньше вы настраивали по отдельности, собираются в один репозиторий, чтобы вся ваша команда воспроизводила одну и ту же конфигурацию. Можно также включить серверы LSP, фоновые мониторы и исполняемые файлы (bin/), но для начала достаточно шести пунктов выше.

2. Структура plugin

Насчёт раскладки есть одно важное правило: внутрь .claude-plugin/ кладётся только plugin.json. Директории commands/, agents/, skills/ и hooks/ находятся в корне plugin (а не внутри .claude-plugin/).

my-plugin/
├── .claude-plugin/
│   └── plugin.json          # манифест — здесь живёт ТОЛЬКО этот файл
├── skills/
│   └── code-review/SKILL.md
├── agents/
│   └── security-reviewer.md
├── hooks/hooks.json
├── .mcp.json
└── README.md

Минимальный манифест plugin.json:

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

name — это идентификатор, а также пространство имён навыка (навык вызывается как /my-first-plugin:hello). version необязателен: если он задан, пользователи получают обновления только тогда, когда вы повышаете его. Если при распространении через git вы опускаете version, в роли версии выступает commit SHA (каждый коммит — новая версия).

3. Как пользоваться — /plugin и marketplace

Установка идёт через /plugin, который открывает менеджер со вкладками (Discover / Installed / Marketplaces / Errors). Основные команды:

# Добавить marketplace (каталог распространения)
/plugin marketplace add anthropics/claude-code        # GitHub owner/repo
/plugin marketplace add ./my-marketplace              # локальный путь
/plugin marketplace add https://example.com/marketplace.json

# Установка / управление plugins (по умолчанию пользовательская область)
/plugin install plugin-name@marketplace-name
/plugin enable  plugin-name@marketplace-name
/plugin disable plugin-name@marketplace-name
/plugin uninstall plugin-name@marketplace-name

# Список (фильтр через --enabled / --disabled). В /plugin есть и строка поиска
/plugin list
/plugin list --enabled

# Применить изменения без перезапуска
/reload-plugins

«Добавить marketplace» = «зарегистрировать каталог», что само по себе не устанавливает ни одного plugin — сначала вы добавляете каталог, а затем устанавливаете plugins по отдельности через install. Для скриптов есть неинтерактивные эквиваленты CLI, например claude plugin install …. Если входящий в plugin сервер MCP не подключается, см. исправления ошибок подключения MCP.

4. Что такое marketplace

marketplace — это каталог с файлом .claude-plugin/marketplace.json, который перечисляет plugins и указывает, откуда брать каждый из них (репозиторий git, локальный путь или размещённый на хостинге файл). Есть официальные и есть общественный.

Официальные / общественный marketplace

· Официальный (claude-plugins-official): курируется Anthropic. Доступен автоматически с первого запуска, его можно просматривать через вкладку Discover в /plugin или на claude.com/plugins. Включает plugins для LSP, внешние интеграции (github / linear / notion / slack / figma и др.), наборы для ревью PR и многое другое.

· Общественный (claude-plugins-community): сторонние заявки, прошедшие автоматическую валидацию и проверку безопасности (каждая закреплена за commit SHA). Добавляется командой /plugin marketplace add anthropics/claude-plugins-community.

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

5. Создаём и публикуем свой

Создать его на удивление просто. Начните с того, чтобы положить манифест и навык, а затем протестировать локально.

# 1) Создаём каркас
mkdir -p my-first-plugin/.claude-plugin my-first-plugin/skills/hello
# пишем .claude-plugin/plugin.json и skills/hello/SKILL.md

# 2) Тест без установки (подойдёт и .zip)
claude --plugin-dir ./my-first-plugin

Чтобы опубликовать, просто положите файл .claude-plugin/marketplace.json в корень репозитория git. Пользователи добавляют его командой /plugin marketplace add owner/repo.

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

Версионирование разрешается в порядке: version в plugin.json → (иначе) version в записи marketplace → (иначе) commit SHA. Если вы фиксируете version, повышайте его при каждом релизе (забудете — и пользователи не получат обновление). Перед публикацией проверьте через claude plugin validate .. Чтобы попасть в официальный общественный каталог, подайте заявку через форму отправки (действуют условия Team/Enterprise и другие).

6. Область распространения и безопасность

У установок есть область (scope): user (по умолчанию, все проекты) / project (все соавторы репозитория, записывается в .claude/settings.json) / local (только вы, этот репозиторий) / managed (распространяется администратором, не редактируется пользователем). Для распространения в команде поместите extraKnownMarketplaces и enabledPlugins в .claude/settings.json проекта, и участникам будет предложено установить их, когда они начнут доверять папке.

⚠️ Безопасность: plugins могут выполнять произвольный код

Официальная документация прямо заявляет, что «plugins могут выполнять произвольный код на вашей машине с вашими привилегиями». Anthropic не проверяет сторонние plugins или входящие в их состав серверы MCP. Устанавливайте только из источников, которым доверяете. Организации могут ограничить разрешённые источники через strictKnownMarketplaces ([] — полная блокировка), который проверяется перед любой сетевой/файловой операцией. Для незнакомого plugin изучите его код перед установкой.

Итог

plugin для Claude Code объединяет навыки, слэш-команды, субагентов, хуки и серверы MCP в одну директорию, которую можно версионировать, передавать и переиспользовать (манифест — .claude-plugin/plugin.json; commands/ и прочее кладутся в корень). Они распространяются через marketplace, и официальный (claude.com/plugins) доступен из коробки. Установка: /plugin marketplace add → /plugin install → (при необходимости) /plugin list, поиск, /reload-plugins.

Создание своего — короткий путь: положите plugin.json и SKILL.md, протестируйте через claude --plugin-dir, затем опубликуйте, поместив marketplace.json в репозиторий git. Области — user / project / local / managed, распространение в команде через .claude/settings.json. Но plugins могут выполнять произвольный код, поэтому устанавливайте только от доверенных издателей и ограничивайте источники через strictKnownMarketplaces в организациях. В plugins можно также включать хуки, которые автоматически запускаются на этапах жизненного цикла, — как они устроены, см. подробный разбор. По теме: Claude Agent Skills, MCP, Claude Code Artifacts.

FAQ

Q. В чём разница между plugin и навыком?
A. Навык — это один из компонентов внутри plugin. plugin — это единица распространения (директория), которая объединяет навыки плюс слэш-команды, субагентов, хуки и серверы MCP. plugin — это «коробка» для доставки часто используемых навыков и команд команде; навык — одна из «инструкций» внутри этой коробки.

Q. Как установить plugin?
A. Сначала добавьте marketplace (каталог) командой /plugin marketplace add owner/repo, затем установите по отдельности через /plugin install plugin-name@marketplace-name. Официальный marketplace (claude-plugins-official) доступен автоматически с первого запуска, а просматривать его можно на claude.com/plugins или через вкладку Discover в /plugin. Переключение — /plugin enable|disable; список — /plugin list.

Q. Могу ли я создать и распространять свой plugin?
A. Да. Положите .claude-plugin/plugin.json (манифест) и skills/…/SKILL.md и протестируйте без установки через claude --plugin-dir ./your-plugin. Чтобы опубликовать, просто поместите .claude-plugin/marketplace.json в корень репозитория git; пользователи добавят его командой /plugin marketplace add owner/repo. Помните: внутрь .claude-plugin/ кладётся только plugin.json — skills/ и прочее живут в корне.

Q. Как работает версионирование?
A. Оно разрешается так: version в plugin.json → (иначе) version в записи marketplace → (иначе) git commit SHA. Если вы задали version, обновления доходят до пользователей только когда вы его повышаете, поэтому повышайте его при каждом релизе (иначе пользователи останутся на старом). Опустите version — и каждый коммит станет новой версией. Перед публикацией проверьте через claude plugin validate ..

Q. Безопасны ли сторонние plugins?
A. Не безусловно. В официальной документации отмечено, что plugin «может выполнять произвольный код с вашими привилегиями», и Anthropic не проверяет сторонние plugins или входящий в них MCP. Устанавливайте только от доверенных издателей и изучайте код, если сомневаетесь. Организации могут ограничить разрешённые источники через strictKnownMarketplaces ([] — полная блокировка).