Плагины Claude Code

Плагины (Plugin) — это в Claude Codeмеханизм расширения самого высокого уровня,используемый для того, чтобы брать такие возможности, как команды, агенты, Skills, хуки, MCP, LSP, иупаковывать, версионировать, делиться и распространять.。

Плагин = переиспользуемая коллекция возможностей расширения Claude Code

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

  • Слэш-команды
  • Субагенты (Agents)
  • Skills (описания возможностей)
  • Хуки (хуки событий)
  • MCP-серверы (внешние инструменты/сервисы)
  • LSP-серверы (интеллектуальные возможности кода)

У плагинов только одна основная цель:

Сделать возможности Claude Code переиспользуемыми как набор инструментов, а не перенастраивать их в каждом проекте.


Плагины против отдельной конфигурации (как выбрать)

Claude Code поддерживает два метода расширения:

Метод Форма команды Подходящие сценарии
Автономная конфигурация(.claude/) /hello Личное использование, один проект, быстрые эксперименты
Плагин(.claude-plugin/) /plugin-name:hello Совместное использование командой, между проектами, с версионированием

Когда использовать автономную конфигурацию?

  • Используется только в текущем проекте
  • Личный рабочий процесс
  • Экспериментальная конфигурация, ещё не стабильна
  • Хотите короткое имя команды (например,/review)

Когда использовать плагины?

  • Нужноповторно использовать в нескольких проектах
  • хотитеподелиться с командой или сообществом
  • Нуженконтроль версий, обновления, откаты
  • Планируете распространять через маркетплейс
  • Может принимать команды пространства имён (чтобы избежать конфликтов)

Лучшие практики:

Сначала в.claude/конфигурации, итерируйте → как только она станет стабильной, упакуйте как плагин.


Минимальная структура плагина (нужно запомнить)

my-plugin/
├── .claude-plugin/
│   └── plugin.json     # 插件清单(必需)
├── commands/           # 斜杠命令
├── agents/             # 子代理
├── skills/             # Skills
├── hooks/              # 钩子
├── .mcp.json           # MCP 配置
└── .lsp.json           # LSP 配置

Важные правила

  • .claude-plugin/В каталоге,может содержать толькоplugin.json
  • Другие каталоги должны находиться в корневом каталоге плагина.

Манифест плагина (plugin.json)

«ID-карта» плагина, определяющая:

  • Имя плагина
  • Пространство имён команд
  • Version
  • Информация об авторе

Пример:

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

Описания ключевых полей:

Поле Назначение
name Уникальный идентификатор + пространство имён команд
description Отображается в магазине плагинов
version Семантическое версионирование
author Необязательно, описание атрибуции

Слэш-команды (наиболее часто используемая возможность плагина)

1. Способ определения команды

  • Расположено вcommands/каталога
  • Каждая команда = один файл Markdown
  • Имя файла = имя команды

Пример:

commands/hello.md

Соответствующая команда:

/my-first-plugin:hello

2. Пример содержимого команды

---
description: Greet the user with a friendly message
---

Greet the user warmly and ask how you can help them today.

3. Аргументы команды

Использование$ARGUMENTSЗахват ввода пользователя:

Greet the user named "$ARGUMENTS" warmly.

Вызов:

/my-first-plugin:hello Alex

Локальное тестирование плагинов (необходимо для разработки)

Использование--plugin-dirЗагрузка каталога плагина напрямую:

claude --plugin-dir ./my-plugin

Возможности:

  • Установка не требуется
  • Перезапустите Claude Code после изменений
  • Поддерживает одновременную загрузку нескольких плагинов
claude --plugin-dir ./plugin-a --plugin-dir ./plugin-b

Что ещё умеют плагины?

Способность Сценарий использования
Команды Пользовательские слэш-команды
Агенты Выделенные субагенты
Навыки Научите Claude, когда использовать определённую возможность
Хуки Автоматизация (например, запуск команд после записи файлов)
MCP Подключение к внешним сервисам (GitHub, DB, API)
LSP Анализ кода (навигация, проверка типов)

Магазин плагинов

Плагины распространяются черезмагазин; по сути, это репозиторий-каталог плагинов.

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

  • Добавлен по умолчанию
  • Запустите/plugin → Обзор

Установить плагин:

/plugin install plugin-name@claude-plugins-official

Область установки плагина

Область действия Описание
Область пользователя Только вы, все проекты
Область проекта Текущий репозиторий, общий для команды
Локальная область Текущий репозиторий, только для вас

Рекомендация:

  • Командные инструменты →Область проекта
  • Инструменты личной продуктивности →Область пользователя

Типичные категории плагинов

1. Интеллектуальные возможности кода (LSP)

  • TypeScript, Python, Go, Rust и т. д.
  • Обеспечивает навигацию по определениям, ссылкам и ошибкам типов

Требуется локальная установка соответствующего языкового сервера

2. Внешняя интеграция (MCP)

  • GitHub / GitLab
  • Jira / Notion
  • Slack / Figma
  • Vercel / Supabase

Суть:Плагин = MCP-сервер + конфигурация

3. Процесс разработки

  • Git-коммиты, PR
  • Агент проверки кода
  • Инструменты разработки плагинов

Основные команды управления плагинами

/plugin                # 打开插件管理器
/plugin install         # 安装插件
/plugin uninstall       # 卸载
/plugin enable/disable  # 启用 / 禁用
/plugin marketplace add # 添加市场
/plugin marketplace rm  # 移除市场

from.claude/Миграция на плагины (ключевые идеи)

До После миграции
.claude/commands plugin/commands
.claude/agents plugin/agents
settings.json hooks plugin/hooks/hooks.json

После миграции:

  • Сначала вступает в силу версия плагина
  • Можно удалить старое.claude/Конфигурация предотвращает дублирование

Когда вам обязательно нужно использовать плагины?

  • У вас уже естьстабильные рабочие процессы Claude
  • Выпостоянно копируете.claude/
  • Члены команды начинают спрашивать вас: «Как мне это настроить?»
  • Вы хотите, чтобы Claude был таким же управляемым, как плагины IDE

Плагины — это переломный момент, когда Claude Code переходит от «персонального ИИ-ассистента» к «инструменту инженерного уровня»

Другие расширения