Плагины

За курс у вас накопилось: навык проверки, навык-ревьюер, три хука, набор правил разрешений. Всё это лежит в .claude/ одного проекта. Скопировать в двадцать других — можно, но через месяц двадцать копий разойдутся. Плагин решает это: тот же набор упаковывается один раз, кладётся в git-репозиторий, а проекты подключают его одной строкой в настройках и получают обновления. В этом уроке разберём, как плагин устроен, как его собрать и проверить и как раздать команде.

Когда плагин, а когда просто .claude/

Документация даёт простое разделение. Папка .claude/ в проекте — для личных сценариев, проектных особенностей и экспериментов; навык вызывается как /verify. Плагин — для того, что нужно нескольким людям или проектам, с версиями и обновлениями; навык вызывается как /amiga:verify. Совет оттуда же: начинайте в .claude/, быстро итерируйте, и переводите в плагин, когда стало понятно, что это нужно не только вам.

Плагин может содержать:

Частая ошибка: положить skills/ или hooks/ внутрь .claude-plugin/. Там лежит только манифест. Всё остальное — в корне плагина.

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

Структура плагина amiga-standards:

amiga-standards/
├── .claude-plugin/
│   └── plugin.json
├── skills/
│   ├── verify/
│   │   └── SKILL.md
│   └── review-diff/
│       └── SKILL.md
├── agents/
│   └── security-reviewer.md
├── hooks/
│   └── hooks.json
└── README.md

Манифест .claude-plugin/plugin.json:

{
  "name": "amiga-standards",
  "description": "Проверка, ревью и защитные хуки для проектов Amiga",
  "version": "1.0.0",
  "author": {
    "name": "Amiga"
  }
}

Поле name становится пространством имён: навык verify будет вызываться как /amiga-standards:verify. Поле version определяет, когда пользователи получат обновление: пока вы не подняли версию, у них остаётся старая.

Навыки переносятся из .claude/skills/ без изменений — verify и review-diff из урока «Навыки проверки» работают как есть. Субагент agents/security-reviewer.md:

---
name: security-reviewer
description: Проверяет изменения на уязвимости
tools: Read, Grep, Glob, Bash
model: opus
---
Ты — инженер по безопасности. Проверь код на:
- инъекции (SQL, XSS, команды);
- ошибки авторизации и аутентификации;
- секреты в коде;
- небезопасную обработку данных.
Давай ссылки на строки и предлагай исправления.

Хуки переезжают из settings.json в hooks/hooks.json — формат тот же, только скрипты адресуются через ${CLAUDE_PLUGIN_ROOT}, папку установленного плагина:

{
  "hooks": {
    "PreToolUse": [
      {
        "matcher": "Edit|Write",
        "hooks": [
          {
            "type": "command",
            "command": "${CLAUDE_PLUGIN_ROOT}/hooks/protect-files.sh"
          }
        ]
      }
    ],
    "PostToolUse": [
      {
        "matcher": "Edit|Write",
        "hooks": [
          {
            "type": "command",
            "command": "jq -r '.tool_input.file_path' | xargs npx prettier --write"
          }
        ]
      }
    ]
  }
}

Скрипт protect-files.sh кладётся рядом, в hooks/, и делается исполняемым.

Проверяем локально

Плагин подключается на одну сессию флагом --plugin-dir:

claude --plugin-dir ./amiga-standards

В сессии: /amiga-standards:verify должен работать, субагент должен появиться в /context в разделе Custom Agents, а хук — сработать при попытке отредактировать .env. После правок в файлах плагина — /reload-plugins, перезапуск не нужен. Флаг можно повторять, чтобы подключить несколько плагинов сразу.

Перед публикацией — валидация:

claude plugin validate ./amiga-standards

Она проверяет структуру и манифест. Если плагин с таким же именем уже установлен из маркетплейса, локальная копия из --plugin-dir на эту сессию имеет приоритет — удобно тестировать изменения, не удаляя рабочую версию.

Для черновика есть и claude plugin init <имя>: создаёт заготовку с манифестом и стартовым SKILL.md в папке навыков, откуда она загружается автоматически.

Маркетплейс: как раздать команде

Маркетплейс — каталог плагинов: git-репозиторий с файлом .claude-plugin/marketplace.json. Плагины могут лежать в том же репозитории или ссылаться на другие.

Репозиторий amiga/claude-plugins:

claude-plugins/
├── .claude-plugin/
│   └── marketplace.json
└── plugins/
    ├── amiga-standards/
    └── amiga-mobile/

marketplace.json:

{
  "name": "amiga",
  "owner": {
    "name": "Amiga Dev Tools"
  },
  "plugins": [
    {
      "name": "amiga-standards",
      "source": "./plugins/amiga-standards",
      "description": "Проверка, ревью и защитные хуки",
      "version": "1.0.0"
    },
    {
      "name": "amiga-mobile",
      "source": "./plugins/amiga-mobile",
      "description": "Навыки для мобильных проектов"
    }
  ]
}

Поле source — относительный путь внутри репозитория либо объект со ссылкой на другой репозиторий: {"source": "github", "repo": "amiga/other-plugin"} или git-URL для GitLab и самохостинга. Репозиторий может быть приватным: Claude Code использует ваши обычные git-учётные данные.

Разработчик подключает маркетплейс и ставит плагин:

/plugin marketplace add amiga/claude-plugins
/plugin install amiga-standards@amiga

Для GitHub достаточно owner/repo; для других хостов — полный URL с .git на конце. При установке выбирается область: пользовательская (для всех ваших проектов), проектная (для всех участников репозитория — пишется в .claude/settings.json) или локальная (только вы в этом репозитории).

Но лучше не заставлять каждого выполнять команды. В .claude/settings.json проекта:

{
  "extraKnownMarketplaces": {
    "amiga": {
      "source": {
        "source": "github",
        "repo": "amiga/claude-plugins"
      }
    }
  },
  "enabledPlugins": {
    "amiga-standards@amiga": true
  }
}

Когда участник команды открывает проект и подтверждает доверие папке, Claude Code регистрирует маркетплейс сам. Плагин с внешним источником всё же потребует одной команды claude plugin install — Claude Code подскажет, какой. Двадцать проектов агентства получают стандарты через один и тот же фрагмент настроек, а обновление — через поднятие version в маркетплейсе.

Управление и обновления

/plugin открывает менеджер с вкладками: Discover (что доступно), Installed (что установлено — включить, выключить, удалить), Marketplaces (каталоги), Errors (ошибки загрузки). Из командной строки: /plugin list, /plugin disable amiga-standards@amiga, /plugin enable ..., /plugin uninstall .... Для скриптов есть claude plugin install <имя>@<маркетплейс> --scope project — без интерактивной панели.

Обновление маркетплейса — /plugin marketplace update amiga. У сторонних маркетплейсов автообновление по умолчанию выключено; администратор может включить его в управляемых настройках через "autoUpdate": true в записи extraKnownMarketplaces.

Готовые плагины есть в официальном маркетплейсе claude-plugins-official, который Claude Code подключает сам при первом запуске. Там — интеграции с GitHub, GitLab, Jira, Figma, Slack, Sentry в виде преднастроенных MCP-серверов, плагины кодовой навигации по языкам (typescript-lsp, pyright-lsp и другие; сам языковой сервер нужно установить отдельно), плагин security-guidance и наборы для работы с PR. Устанавливаются так же: /plugin install github@claude-plugins-official.

О доверии

Плагин выполняет код на вашей машине с вашими правами: хуки — это shell-команды, MCP-серверы — процессы. Anthropic не проверяет содержимое сторонних плагинов. Ставьте только из источников, которым доверяете; для команды это собственный маркетплейс в приватном репозитории. Организация может ограничить список разрешённых маркетплейсов управляемыми настройками.