Для полных технических спецификаций и схем см. Справочник по плагинам. Для управления маркетплейсами см. Маркетплейсы плагинов.
Плагины позволяют расширить Claude Code с помощью пользовательской функциональности, которая может быть общей для проектов и команд. Устанавливайте плагины из маркетплейсов для добавления готовых команд, агентов, хуков и 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
└── hooks/                    # Event handlers (optional)
    └── hooks.json
Дополнительные компоненты, которые вы можете добавить:
  • Команды: Создайте markdown файлы в директории commands/
  • Агенты: Создайте определения агентов в директории agents/
  • Хуки: Создайте 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. Плагины устанавливаются автоматически для всех участников команды
Для полных инструкций, включая примеры конфигурации, настройку маркетплейса и лучшие практики развертывания, см. Настройка командных маркетплейсов.

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

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

​
Организация сложных плагинов

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

​
Тестирование ваших плагинов локально

При разработке плагинов используйте локальный маркетплейс для итеративного тестирования изменений. Этот рабочий процесс основан на шаблоне быстрого старта и работает для плагинов любой сложности.
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, вот предлагаемые пути для разных целей:

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

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

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

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

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

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

​
См. также

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