Создание plugins

​

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

• Вы настраиваете Claude Code для одного проекта
• Конфигурация личная и не требует совместного использования
• Вы экспериментируете с skills или hooks перед их упаковкой
• Вы хотите короткие имена skills, такие как /hello или /deploy

• Вы хотите поделиться функциональностью с вашей командой или сообществом
• Вам нужны одинаковые skills/agents в нескольких проектах
• Вы хотите контроль версий и простые обновления для ваших расширений
• Вы распространяете через marketplace
• Вы согласны с пространством имён skills, такими как /my-plugin:hello (пространство имён предотвращает конфликты между plugins)

​

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

​

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

• Claude Code установлен и аутентифицирован

​

Создайте ваш первый plugin

mkdir my-first-plugin

mkdir my-first-plugin/.claude-plugin

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

mkdir -p my-first-plugin/skills/hello

---
description: Greet the user with a friendly message
disable-model-invocation: true
---

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

claude --plugin-dir ./my-first-plugin

/my-first-plugin:hello

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

# Hello Skill

Greet the user named "$ARGUMENTS" warmly and ask how you can help them today. Make the greeting personal and encouraging.

/my-first-plugin:hello Alex

• Манифест plugin (.claude-plugin/plugin.json): описывает метаданные вашего plugin
• Директория skills (skills/): содержит ваши пользовательские skills
• Аргументы skill ($ARGUMENTS): захватывает пользовательский ввод для динамического поведения

​

Разработка plugin в вашей директории skills

claude plugin init my-tool

​

Обзор структуры plugin

​

Разработка более сложных plugins

​

Добавьте Skills в ваш plugin

my-plugin/
├── .claude-plugin/
│   └── plugin.json
└── skills/
    └── code-review/
        └── SKILL.md

---
description: Reviews code for best practices and potential issues. Use when reviewing code, checking PRs, or analyzing code quality.
---

When reviewing code, check for:
1. Code organization and structure
2. Error handling
3. Security concerns
4. Test coverage

​

Добавьте LSP servers в ваш plugin

{
  "go": {
    "command": "gopls",
    "args": ["serve"],
    "extensionToLanguage": {
      ".go": "go"
    }
  }
}

​

Добавьте фоновые мониторы в ваш plugin

[
  {
    "name": "error-log",
    "command": "tail -F ./logs/error.log",
    "description": "Application error log"
  }
]

​

Поставляйте параметры по умолчанию с вашим plugin

{
  "agent": "security-reviewer"
}

​

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

​

Протестируйте ваши plugins локально

claude --plugin-dir ./my-plugin

claude --plugin-dir ./my-plugin.zip

• Попробуйте ваши skills с /plugin-name:skill-name
• Проверьте, что agents появляются в /context под Custom Agents, или упомяните один по его scoped name с помощью @
• Убедитесь, что hooks работают как ожидается

claude --plugin-dir ./plugin-one --plugin-dir ./plugin-two

claude --plugin-url https://example.com/my-plugin.zip --plugin-url https://example.com/other.zip

claude --plugin-url "https://example.com/my-plugin.zip https://example.com/other.zip"

​

Отладка проблем plugin

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

​

Поделитесь вашими plugins

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

​

Отправьте ваш plugin на официальный marketplace сообщества

• claude-plugins-official: курируемый набор plugins, поддерживаемый Anthropic. Зарегистрирован автоматически при первом запуске Claude Code в интерактивном режиме. Неинтерактивный скрипт, который запускается перед этим первым запуском, должен добавить его явно с помощью claude plugin marketplace add anthropics/claude-plugins-official.
• claude-community: публичный marketplace сообщества, где размещаются сторонние отправки после проверки. Пользователи добавляют его с помощью /plugin marketplace add anthropics/claude-plugins-community и устанавливают из него как @claude-community.

• claude.ai: claude.ai/admin-settings/directory/submissions/plugins/new
• Console: platform.claude.com/plugins/submit

​

Преобразование существующих конфигураций в plugins

​

Шаги миграции

mkdir -p my-plugin/.claude-plugin

{
  "name": "my-plugin",
  "description": "Migrated from standalone configuration",
  "version": "1.0.0"
}

# Copy commands
cp -r .claude/commands my-plugin/

# Copy agents (if any)
cp -r .claude/agents my-plugin/

# Copy skills (if any)
cp -r .claude/skills my-plugin/

mkdir my-plugin/hooks

{
  "hooks": {
    "PostToolUse": [
      {
        "matcher": "Write|Edit",
        "hooks": [{ "type": "command", "command": "jq -r '.tool_input.file_path' | xargs npm run lint:fix" }]
      }
    ]
  }
}

claude --plugin-dir ./my-plugin

​

Что изменяется при миграции

​

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

​

Для пользователей plugin

• Обнаружение и установка plugins: просмотр marketplaces и установка plugins
• Настройка team marketplaces: установка plugins на уровне репозитория для вашей команды

​

Для разработчиков plugin

• Создание и распространение marketplace: упаковка и совместное использование ваших plugins
• Справочник plugins: полные технические спецификации
• Углубитесь в конкретные компоненты plugin:
  • Skills: детали разработки skill
  • Subagents: конфигурация и возможности agent
  • Hooks: обработка событий и автоматизация
  • MCP: интеграция внешних инструментов