Плагины: готовые наборы расширений

Скилл — это один файл с инструкцией. MCP — один внешний сервис. Хук — одно автоматическое действие. Плагин — это всё это вместе в одной коробке: набор скиллов + MCP + хуков + субагентов, упакованный одним пакетом. Установил одной командой — получил сразу 10-20 готовых инструментов.

Чем отличается от обычного скилла

Можешь хранить скиллы и хуки россыпью в .claude/skills/ и .claude/settings.json — это standalone-подход. Работает для личного сетапа в одном проекте. Но как только хочешь поделиться с командой или использовать одни и те же инструменты в разных проектах — становится неудобно.

Главная мысль: плагин — это способ упаковать и распространить расширения, а не отдельный тип расширения. Внутри плагина — те же скиллы, MCP, хуки, субагенты, что и в обычном проекте. Просто оформленные как пакет.

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

Самый простой способ — через интерактивное меню:

/plugin

Откроется четыре вкладки (переключаются Tab):

• Discover — обзор доступных плагинов из всех подключённых маркетплейсов
• Installed — что у тебя стоит, можно отключить/включить/удалить
• Marketplaces — список подключённых каталогов
• Errors — ошибки если что-то не загрузилось

Если знаешь точное имя плагина — можешь установить одной командой без меню:

# Из официального маркетплейса
/plugin install github@claude-plugins-official

# Из любого другого
/plugin install имя-плагина@имя-маркетплейса

После установки запускаешь команду чтобы Claude Code подхватил новые компоненты без перезапуска:

/reload-plugins

Куда устанавливается — три варианта

Указать scope при установке через CLI:

claude plugin install formatter@your-org --scope project

Где брать плагины — маркетплейсы

Официальный маркетплейс Anthropic

Подключён по умолчанию. Каталог открыт на claude.com/plugins. Внутри: интеграции с GitHub, GitLab, Jira, Figma, Vercel, Supabase, code intelligence для 11 языков, готовые рабочие процессы.

Демо-маркетплейс с примерами

/plugin marketplace add anthropics/claude-code

Публичные примеры от Anthropic — учебные плагины, можно изучить структуру и взять за основу для своих.

Любой свой источник

# GitHub-репозиторий
/plugin marketplace add owner/repo

# GitLab или Bitbucket
/plugin marketplace add https://gitlab.com/company/plugins.git

# Конкретный тег или ветка
/plugin marketplace add https://gitlab.com/company/plugins.git#v1.0.0

# Локальная папка
/plugin marketplace add ./my-marketplace

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

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

Через интерфейс /plugin → вкладка Installed → Enter на нужном плагине. Через команды:

# Отключить, не удаляя
/plugin disable plugin-name@marketplace-name

# Включить обратно
/plugin enable plugin-name@marketplace-name

# Удалить полностью
/plugin uninstall plugin-name@marketplace-name

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

Установленные плагины физически живут в ~/.claude/plugins/cache/. Если что-то сломалось — можно удалить эту папку и переустановить плагины с нуля.

enabledPlugins в settings.json

Когда устанавливаешь плагин через интерфейс — Claude Code сам прописывает его в settings.json. Если ты заглянешь в ~/.claude/settings.json, там будет блок enabledPlugins со списком активных плагинов.

{
  "enabledPlugins": {
    "github@claude-plugins-official": true,
    "frontend-design@claude-plugins-official": true,
    "superpowers@claude-plugins-official": true,
    "context7@claude-plugins-official": true
  }
}

Проектный .claude/settings.json может ещё иметь extraKnownMarketplaces — это команда говорит «у нас в проекте подключён маркетплейс X, все коллеги его получат при первом открытии проекта».

Создать свой плагин — за 5 минут

Если уже есть несколько скиллов в .claude/skills/ и хочешь упаковать их в плагин для шаринга — это пять шагов.

1. Создай папку плагина

mkdir my-first-plugin
mkdir my-first-plugin/.claude-plugin

2. Создай манифест

Манифест — это файл с «паспортом» плагина: имя, описание, автор, версия. Без него Claude не поймёт что это вообще за папка. Файл должен называться ровно plugin.json и лежать в подпапке .claude-plugin/:

{
  "name": "my-first-plugin",
  "description": "Мой первый плагин для проверки",
  "version": "1.0.0",
  "author": {
    "name": "Никита Шлык"
  }
}

Поле name станет «префиксом» для всех скиллов внутри плагина — это и называется namespace (пространство имён). Если в плагине my-first-plugin есть скилл hello, он будет вызываться как /my-first-plugin:hello. Это нужно чтобы скиллы из разных плагинов не конфликтовали — два разных автора могут назвать свои скиллы одинаково «hello», но префикс плагина их разведёт.

3. Положи внутрь скилл

---
description: Поприветствовать пользователя
---

Поприветствуй пользователя дружелюбно и спроси чем помочь сегодня.

4. Протестируй локально

claude --plugin-dir ./my-first-plugin

# В чате:
/my-first-plugin:hello

5. Поделись с миром

Заливаешь папку плагина в GitHub-репозиторий → коллега подключает через /plugin marketplace add твоё-имя/имя-репо → ставит твой плагин одной командой.

Безопасность — это критично

На что смотреть перед установкой:

• Кто автор — известная компания (Anthropic, GitHub, Vercel) или анонимный аккаунт?
• Откуда плагин — официальный маркетплейс claude-plugins-official проверен Anthropic, остальные — на твой страх
• Что внутри — открой репозиторий, посмотри что в hooks/ и .mcp.json. Если плагин для форматирования просит доступ ко всему — стоп
• Активность репозитория — свежие коммиты, открытые issues, кто-то реально пользуется?

Anthropic не контролирует что внутри сторонних плагинов. Ответственность за безопасность — на тебе.

Когда что выбирать — плагин или standalone

Универсальное правило: начинай со standalone, конвертируй в плагин когда готов делиться.