Перейти к основному содержанию
Полные технические спецификации и схемы см. в справочнике плагинов. Для управления маркетплейсом см. Маркетплейсы плагинов.
Плагины позволяют расширить Claude Code пользовательской функциональностью, которая может быть общей для проектов и команд. Устанавливайте плагины из маркетплейсов, чтобы добавить готовые команды, агентов, хуки, Skills и MCP серверы, или создавайте свои собственные для автоматизации ваших рабочих процессов.

​
Быстрый старт

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

​
Предварительные требования

  • Claude Code установлен на вашем компьютере
  • Базовое знакомство с инструментами командной строки

​
Создайте свой первый плагин

1

Создайте структуру маркетплейса

mkdir test-marketplace
cd test-marketplace
2

Создайте директорию плагина

mkdir my-first-plugin
cd my-first-plugin
3

Создайте манифест плагина

Create .claude-plugin/plugin.json
mkdir .claude-plugin
cat > .claude-plugin/plugin.json << 'EOF'
{
"name": "my-first-plugin",
"description": "A simple greeting plugin to learn the basics",
"version": "1.0.0",
"author": {
"name": "Your Name"
}
}
EOF
4

Добавьте пользовательскую команду

Create commands/hello.md
mkdir commands
cat > commands/hello.md << 'EOF'
---
description: Greet the user with a personalized message
---

# Hello Command

Greet the user warmly and ask how you can help them today. Make the greeting personal and encouraging.
EOF
5

Создайте манифест маркетплейса

Create marketplace.json
cd ..
mkdir .claude-plugin
cat > .claude-plugin/marketplace.json << 'EOF'
{
"name": "test-marketplace",
"owner": {
"name": "Test User"
},
"plugins": [
{
  "name": "my-first-plugin",
  "source": "./my-first-plugin",
  "description": "My first test plugin"
}
]
}
EOF
6

Установите и протестируйте ваш плагин

Start Claude Code from parent directory
cd ..
claude
Add the test marketplace
/plugin marketplace add ./test-marketplace
Install your plugin
/plugin install my-first-plugin@test-marketplace
Выберите “Install now”. Затем вам нужно будет перезагрузить Claude Code, чтобы использовать новый плагин.
Try your new command
/hello
Вы увидите, как Claude использует вашу команду приветствия! Проверьте /help, чтобы увидеть вашу новую команду в списке.
Вы успешно создали и протестировали плагин с этими ключевыми компонентами:
  • Манифест плагина (.claude-plugin/plugin.json) - Описывает метаданные вашего плагина
  • Директория команд (commands/) - Содержит ваши пользовательские слэш-команды
  • Тестовый маркетплейс - Позволяет вам протестировать ваш плагин локально

​
Обзор структуры плагина

Ваш плагин следует этой базовой структуре: 
my-first-plugin/
├── .claude-plugin/
│   └── plugin.json          # Plugin metadata
├── commands/                 # Custom slash commands (optional)
│   └── hello.md
├── agents/                   # Custom agents (optional)
│   └── helper.md
├── skills/                   # Agent Skills (optional)
│   └── my-skill/
│       └── SKILL.md
└── hooks/                    # Event handlers (optional)
    └── hooks.json
Дополнительные компоненты, которые вы можете добавить:
  • Команды: Создавайте файлы markdown в директории commands/
  • Агенты: Создавайте определения агентов в директории agents/
  • Skills: Создавайте файлы SKILL.md в директории skills/
  • Хуки: Создавайте hooks/hooks.json для обработки событий
  • MCP серверы: Создавайте .mcp.json для интеграции внешних инструментов
Следующие шаги: Готовы добавить больше функций? Перейдите к Разработке более сложных плагинов, чтобы добавить агентов, хуки и MCP серверы. Для полных технических спецификаций всех компонентов плагина см. Справочник плагинов.

​
Установка и управление плагинами

Узнайте, как обнаруживать, устанавливать и управлять плагинами для расширения возможностей Claude Code.

​
Предварительные требования

  • Claude Code установлен и запущен
  • Базовое знакомство с интерфейсами командной строки

​
Добавьте маркетплейсы

Маркетплейсы - это каталоги доступных плагинов. Добавьте их, чтобы обнаруживать и устанавливать плагины:
Add a marketplace
/plugin marketplace add your-org/claude-plugins
Browse available plugins
/plugin
Для подробного управления маркетплейсом, включая Git репозитории, локальную разработку и распределение команде, см. Маркетплейсы плагинов.

​
Установите плагины

​
Через интерактивное меню (рекомендуется для обнаружения)

Open the plugin management interface
/plugin
Выберите “Browse Plugins”, чтобы увидеть доступные опции с описаниями, функциями и вариантами установки.

​
Через прямые команды (для быстрой установки)

Install a specific plugin
/plugin install formatter@your-org
Enable a disabled plugin
/plugin enable plugin-name@marketplace-name
Disable without uninstalling
/plugin disable plugin-name@marketplace-name
Completely remove a plugin
/plugin uninstall plugin-name@marketplace-name

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

После установки плагина:
  1. Проверьте доступные команды: Запустите /help, чтобы увидеть новые команды
  2. Протестируйте функции плагина: Попробуйте команды и функции плагина
  3. Просмотрите детали плагина: Используйте /plugin → “Manage Plugins”, чтобы увидеть, что предоставляет плагин

​
Настройте рабочие процессы плагинов команды

Настройте плагины на уровне репозитория, чтобы обеспечить согласованность инструментов во всей вашей команде. Когда члены команды доверяют папке вашего репозитория, Claude Code автоматически устанавливает указанные маркетплейсы и плагины. Для настройки плагинов команды:
  1. Добавьте конфигурацию маркетплейса и плагина в .claude/settings.json вашего репозитория
  2. Члены команды доверяют папке репозитория
  3. Плагины устанавливаются автоматически для всех членов команды
Для полных инструкций, включая примеры конфигурации, настройку маркетплейса и лучшие практики развертывания, см. Настройка маркетплейсов команды.

​
Разработка более сложных плагинов

Когда вы освоитесь с базовыми плагинами, вы сможете создавать более сложные расширения.

​
Добавьте Skills в ваш плагин

Плагины могут включать Agent Skills для расширения возможностей Claude. Skills вызываются моделью — Claude автономно использует их на основе контекста задачи. Чтобы добавить Skills в ваш плагин, создайте директорию skills/ в корне вашего плагина и добавьте папки Skills с файлами SKILL.md. Skills плагина автоматически доступны при установке плагина. Для полного руководства по созданию Skills см. Agent Skills.

​
Организуйте сложные плагины

Для плагинов со многими компонентами организуйте структуру директорий по функциональности. Для полных макетов директорий и шаблонов организации см. Структура директории плагина.

​
Протестируйте ваши плагины локально

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

Настройте вашу структуру разработки

Организуйте ваш плагин и маркетплейс для тестирования:
Create directory structure
mkdir dev-marketplace
cd dev-marketplace
mkdir my-plugin
Это создает:
dev-marketplace/
├── .claude-plugin/marketplace.json  (you'll create this)
└── my-plugin/                        (your plugin under development)
    ├── .claude-plugin/plugin.json
    ├── commands/
    ├── agents/
    └── hooks/
2

Создайте манифест маркетплейса

Create marketplace.json
mkdir .claude-plugin
cat > .claude-plugin/marketplace.json << 'EOF'
{
"name": "dev-marketplace",
"owner": {
"name": "Developer"
},
"plugins": [
{
  "name": "my-plugin",
  "source": "./my-plugin",
  "description": "Plugin under development"
}
]
}
EOF
3

Установите и протестируйте

Start Claude Code from parent directory
cd ..
claude
Add your development marketplace
/plugin marketplace add ./dev-marketplace
Install your plugin
/plugin install my-plugin@dev-marketplace
Протестируйте компоненты вашего плагина:
  • Попробуйте ваши команды с /command-name
  • Проверьте, что агенты появляются в /agents
  • Убедитесь, что хуки работают как ожидается
4

Итерируйте над вашим плагином

После внесения изменений в код вашего плагина:
Uninstall the current version
/plugin uninstall my-plugin@dev-marketplace
Reinstall to test changes
/plugin install my-plugin@dev-marketplace
Повторяйте этот цикл по мере разработки и совершенствования вашего плагина.
Для нескольких плагинов: Организуйте плагины в поддиректориях типа ./plugins/plugin-name и обновите ваш marketplace.json соответственно. См. Источники плагинов для шаблонов организации.

​
Отладка проблем плагина

Если ваш плагин не работает как ожидается:
  1. Проверьте структуру: Убедитесь, что ваши директории находятся в корне плагина, а не внутри .claude-plugin/
  2. Протестируйте компоненты отдельно: Проверьте каждую команду, агента и хук отдельно
  3. Используйте инструменты валидации и отладки: См. Инструменты отладки и разработки для команд CLI и методов устранения неполадок

​
Поделитесь вашими плагинами

Когда ваш плагин готов к распространению:
  1. Добавьте документацию: Включите README.md с инструкциями по установке и использованию
  2. Версионируйте ваш плагин: Используйте семантическое версионирование в вашем plugin.json
  3. Создайте или используйте маркетплейс: Распространяйте через маркетплейсы плагинов для простой установки
  4. Протестируйте с другими: Попросите членов команды протестировать плагин перед более широким распространением
Для полных технических спецификаций, методов отладки и стратегий распространения см. Справочник плагинов.

​
Следующие шаги

Теперь, когда вы понимаете систему плагинов Claude Code, вот предлагаемые пути для разных целей:

​
Для пользователей плагинов

  • Обнаруживайте плагины: Просматривайте маркетплейсы сообщества для полезных инструментов
  • Внедрение в команде: Настройте плагины на уровне репозитория для ваших проектов
  • Управление маркетплейсом: Научитесь управлять несколькими источниками плагинов
  • Продвинутое использование: Исследуйте комбинации плагинов и рабочие процессы

​
Для разработчиков плагинов

  • Создайте свой первый маркетплейс: Руководство маркетплейсов плагинов
  • Продвинутые компоненты: Углубитесь в конкретные компоненты плагина:
    • Слэш-команды - Детали разработки команд
    • Подагенты - Конфигурация и возможности агентов
    • Agent Skills - Расширьте возможности Claude
    • Хуки - Обработка событий и автоматизация
    • MCP - Интеграция внешних инструментов
  • Стратегии распространения: Упакуйте и поделитесь вашими плагинами эффективно
  • Вклад в сообщество: Рассмотрите возможность внесения вклада в коллекции плагинов сообщества

​
Для руководителей команд и администраторов

  • Конфигурация репозитория: Настройте автоматическую установку плагинов для командных проектов
  • Управление плагинами: Установите рекомендации по одобрению плагинов и проверке безопасности
  • Обслуживание маркетплейса: Создавайте и поддерживайте каталоги плагинов, специфичные для организации
  • Обучение и документация: Помогите членам команды эффективно внедрить рабочие процессы плагинов

​
См. также

  • Маркетплейсы плагинов - Создание и управление каталогами плагинов
  • Слэш-команды - Понимание пользовательских команд
  • Подагенты - Создание и использование специализированных агентов
  • Agent Skills - Расширьте возможности Claude
  • Хуки - Автоматизация рабочих процессов с обработчиками событий
  • MCP - Подключение к внешним инструментам и сервисам
  • Параметры - Опции конфигурации для плагинов