Плагины 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 переходит от «персонального ИИ-ассистента» к «инструменту инженерного уровня»