Claude Code plugins: установка, проверка и удаление

Плагин удобно использовать, когда набор инструкций или инструментов должен переноситься между проектами. Чтобы проверить сам механизм установки, не нужен сторонний пакет с неизвестными hooks. Начните с собственного плагина, который содержит одну явно вызываемую skill и возвращает тестовую строку.

Ниже — пример для macOS/Linux с установленным и настроенным Claude Code. В Windows те же JSON и Markdown можно создать редактором; shell-команды здесь рассчитаны на Bash или Zsh. Ответ модели требует рабочего подключения, а проверка структуры плагина выполняется отдельно.

Создайте три файла

Откройте новый пустой каталог и выполните:

mkdir -p plugin-lab/.claude-plugin
mkdir -p plugin-lab/plugins/load-check/.claude-plugin
mkdir -p plugin-lab/plugins/load-check/skills/ping

В plugin-lab/plugins/load-check/.claude-plugin/plugin.json сохраните:

{
  "name": "load-check",
  "version": "1.0.0",
  "description": "Local plugin loading exercise"
}

В plugin-lab/plugins/load-check/skills/ping/SKILL.md:

---
description: Return a marker to verify this local plugin is loaded.
disable-model-invocation: true
---

Return exactly PLUGIN_READY. Do not use tools or change files.

В plugin-lab/.claude-plugin/marketplace.json:

{
  "name": "local-load-lab",
  "owner": {"name": "Local developer"},
  "plugins": [
    {"name": "load-check", "source": "./plugins/load-check"}
  ]
}

Каталог marketplace указывает, где находится пакет. Внутри самого пакета .claude-plugin содержит manifest, а skills располагается рядом с ним. Если вложить skills в .claude-plugin, структура перестанет соответствовать документации плагинов.

Проверьте структуру и установите пакет

Из исходного каталога выполните:

claude --version
claude plugin validate ./plugin-lab/plugins/load-check
claude plugin validate ./plugin-lab
claude

Если validator сообщает ошибку, сначала исправьте конкретный файл. Успешная проверка структуры не доказывает ни качество инструкций, ни безопасность произвольного плагина.

В открытой сессии Claude Code добавьте локальный каталог и выберите плагин:

/plugin marketplace add ./plugin-lab
/plugin install load-check@local-load-lab

В панели установки выберите Local, чтобы ограничить этот опыт текущим проектом. Перед подтверждением прочитайте, куда будет записана настройка. Если сводка просит перезагрузить плагины, выполните /reload-plugins. Последовательность локального marketplace описана в официальном руководстве.

Убедитесь, что загрузилась нужная skill

Выполните:

/plugin list
/load-check:ping

Первый результат должен показывать установленный пакет, второй — вернуть PLUGIN_READY. Полное имя skill включает имя плагина: /load-check:ping. Это позволяет отличить её от одноимённой skill другого пакета.

Отдельно проверьте рабочий каталог: тестовая skill не должна менять файлы. Текст «не использовать инструменты» является инструкцией модели; он не создаёт отдельную системную границу разрешений. Для управления доступом служат permissions Claude Code.

Если команды нет, проверьте по порядку имя в manifest, положение skills/ping/SKILL.md, выбранную область установки, состояние enabled и необходимость перезагрузки. Не смешивайте две проверки одновременно: загрузку через marketplace и запуск с --plugin-dir.

Отключение, обновление и удаление

Для установленного примера доступны команды CLI:

claude plugin disable load-check@local-load-lab --scope local
claude plugin enable load-check@local-load-lab --scope local
claude plugin update load-check@local-load-lab --scope local
claude plugin uninstall load-check@local-load-lab --scope local

Запускайте их по одной из того же проекта и проверяйте результат. Параметр --scope local соответствует выбранной области установки; без него update и uninstall по умолчанию обращаются к user. После обновления перезапустите сессию, если этого требует CLI. После отключения или удаления откройте новую сессию и убедитесь, что skill больше не доступна; после включения повторите короткий тест.

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

Перед установкой чужого плагина

Сначала посмотрите состав пакета. Одна skill с текстом, hook с shell-командой и MCP-сервер создают разные последствия для проекта. Проверьте команды, адреса внешних сервисов и инструкции, запрашивающие секреты. Не выдавайте дополнительные разрешения только ради исчезновения ошибки установки.

Для рабочего проекта повторите тот же короткий цикл: известная область установки, видимый компонент, ожидаемое действие, проверка файлов и понятный способ отключения. Полный формат пакета и возможности validator доступны в справочнике plugins.