A visual, example-driven guide to Claude Code — from basic concepts to advanced agents, with copy-paste templates that bring immediate value.
Плагіни Claude Code
Ця папка містить повні приклади плагінів, які обʼєднують кілька функцій Claude Code у цілісні пакети, що встановлюються однією командою.
Огляд
Плагіни Claude Code — це обʼєднані колекції кастомізацій (слеш-команди, субагенти, MCP-сервери та хуки), які встановлюються однією командою. Вони є механізмом розширення найвищого рівня — поєднуючи кілька функцій у цілісні пакети, якими можна ділитися.
Архітектура плагінів
graph TB
A["Plugin"]
B["Slash Commands"]
C["Subagents"]
D["MCP Servers"]
E["Hooks"]
F["Configuration"]
A -->|bundles| B
A -->|bundles| C
A -->|bundles| D
A -->|bundles| E
A -->|bundles| F
Процес завантаження плагіна
sequenceDiagram
participant User
participant Claude as Claude Code
participant Plugin as Plugin Marketplace
participant Install as Installation
participant SlashCmds as Slash Commands
participant Subagents
participant MCPServers as MCP Servers
participant Hooks
participant Tools as Configured Tools
User->>Claude: claude --plugin-dir ./07-plugins/pr-review
Claude->>Plugin: Download plugin manifest
Plugin-->>Claude: Return plugin definition
Claude->>Install: Extract components
Install->>SlashCmds: Configure
Install->>Subagents: Configure
Install->>MCPServers: Configure
Install->>Hooks: Configure
SlashCmds-->>Tools: Ready to use
Subagents-->>Tools: Ready to use
MCPServers-->>Tools: Ready to use
Hooks-->>Tools: Ready to use
Tools-->>Claude: Plugin installed ✅
Типи та дистрибуція плагінів
| Тип | Область | Спільний | Авторитет | Приклади |
|---|---|---|---|---|
| Офіційний | Глобальний | Усі користувачі | Anthropic | PR Review, Security Guidance |
| Спільнота | Публічний | Усі користувачі | Спільнота | DevOps, Data Science |
| Організація | Внутрішній | Члени команди | Компанія | Внутрішні стандарти, інструменти |
| Персональний | Індивідуальний | Один користувач | Розробник | Кастомні робочі процеси |
Структура визначення плагіна
Маніфест плагіна використовує формат JSON у файлі .claude-plugin/plugin.json:
{
"name": "my-first-plugin",
"description": "A greeting plugin",
"version": "1.0.0",
"author": {
"name": "Your Name"
},
"homepage": "https://example.com",
"repository": "https://github.com/user/repo",
"license": "MIT"
}
Приклад структури плагіна
my-plugin/
├── .claude-plugin/
│ └── plugin.json # Маніфест (назва, опис, версія, автор)
├── commands/ # Навички як Markdown-файли
│ ├── task-1.md
│ ├── task-2.md
│ └── workflows/
├── agents/ # Визначення кастомних агентів
│ ├── specialist-1.md
│ ├── specialist-2.md
│ └── configs/
├── skills/ # Навички агентів з файлами SKILL.md
│ ├── skill-1/
│ │ └── SKILL.md
│ └── skill-2/
│ └── SKILL.md
├── hooks/ # Обробники подій у hooks.json
│ └── hooks.json
├── .mcp.json # Конфігурації MCP-серверів
├── .lsp.json # Конфігурації LSP-серверів для інтелектуальної роботи з кодом
├── bin/ # Виконувані файли, додані до PATH інструменту Bash поки плагін увімкнено
├── settings.json # Стандартні налаштування при увімкненні плагіна (діють лише ключі `agent` і `subagentStatusLine`)
├── templates/
│ └── issue-template.md
├── scripts/
│ ├── helper-1.sh
│ └── helper-2.py
├── docs/
│ ├── README.md
│ └── USAGE.md
└── tests/
└── plugin.test.js
Конфігурація LSP-сервера
Плагіни можуть включати підтримку Language Server Protocol (LSP — протокол мовного сервера) для інтелектуальної роботи з кодом у реальному часі. LSP-сервери надають діагностику, навігацію по коду та інформацію про символи під час роботи.
Розташування конфігурації:
- Файл
.lsp.jsonу кореневому каталозі плагіна - Інлайн-ключ
lspуplugin.json
Довідник полів
| Поле | Обовʼязкове | Опис |
|---|---|---|
command |
Так | Бінарний файл LSP-сервера (має бути в PATH) |
extensionToLanguage |
Так | Відповідність розширень файлів ідентифікаторам мов |
args |
Ні | Аргументи командного рядка для сервера |
transport |
Ні | Метод комунікації: stdio (за замовчуванням) або socket |
env |
Ні | Змінні оточення для процесу сервера |
initializationOptions |
Ні | Опції, що надсилаються під час ініціалізації LSP |
settings |
Ні | Конфігурація робочого простору, що передається серверу |
workspaceFolder |
Ні | Перевизначення шляху до папки робочого простору |
startupTimeout |
Ні | Максимальний час (мс) очікування запуску сервера |
shutdownTimeout |
Ні | Максимальний час (мс) для коректного завершення |
restartOnCrash |
Ні | Автоматичний перезапуск при збої сервера |
maxRestarts |
Ні | Максимальна кількість спроб перезапуску |
Приклади конфігурацій
Go (gopls):
{
"go": {
"command": "gopls",
"args": ["serve"],
"extensionToLanguage": {
".go": "go"
}
}
}
Python (pyright):
{
"python": {
"command": "pyright-langserver",
"args": ["--stdio"],
"extensionToLanguage": {
".py": "python",
".pyi": "python"
}
}
}
TypeScript:
{
"typescript": {
"command": "typescript-language-server",
"args": ["--stdio"],
"extensionToLanguage": {
".ts": "typescript",
".tsx": "typescriptreact",
".js": "javascript",
".jsx": "javascriptreact"
}
}
}
Доступні LSP-плагіни
Офіційний маркетплейс включає попередньо налаштовані LSP-плагіни:
| Плагін | Мова | Бінарний файл сервера | Команда встановлення |
|---|---|---|---|
pyright-lsp |
Python | pyright-langserver |
pip install pyright |
typescript-lsp |
TypeScript/JavaScript | typescript-language-server |
npm install -g typescript-language-server typescript |
rust-analyzer-lsp |
Rust | rust-analyzer |
Встановлення через rustup component add rust-analyzer |
Можливості LSP
Після налаштування LSP-сервери надають:
- Миттєва діагностика — помилки та попередження зʼявляються одразу після редагування
- Навігація по коду — перехід до визначення, пошук посилань, реалізацій
- Інформація при наведенні — сигнатури типів та документація при наведенні курсора
- Список символів — перегляд символів у поточному файлі або робочому просторі
Опції плагіна (v2.1.83+)
Плагіни можуть оголошувати користувацькі опції в маніфесті через userConfig. Значення з позначкою sensitive: true зберігаються у системному сховищі ключів (keychain), а не в текстових файлах налаштувань:
{
"name": "my-plugin",
"version": "1.0.0",
"userConfig": {
"apiKey": {
"type": "string",
"title": "API key",
"description": "API key for the service",
"sensitive": true
},
"region": {
"type": "string",
"title": "Region",
"description": "Deployment region",
"default": "us-east-1"
}
}
}
Постійні дані плагіна (${CLAUDE_PLUGIN_DATA}) (v2.1.78+)
Плагіни мають доступ до каталогу постійного стану через змінну оточення ${CLAUDE_PLUGIN_DATA}. Цей каталог є унікальним для кожного плагіна та зберігається між сесіями, що робить його придатним для кешів, баз даних та іншого постійного стану:
{
"hooks": {
"PostToolUse": [
{
"matcher": "*",
"hooks": [
{
"type": "command",
"command": "node \"${CLAUDE_PLUGIN_ROOT}\"/scripts/track-usage.js \"${CLAUDE_PLUGIN_DATA}\"/usage.json"
}
]
}
]
}
}
Каталог (~/.claude/plugins/data/<id>/) створюється під час першого звернення до нього та зберігається між оновленнями плагіна. Він видаляється, коли ви видаляєте плагін з останнього місця, де його встановлено (якщо не передати --keep-data).
Інлайн-плагін через налаштування (source: 'settings') (v2.1.80+)
Плагіни можна визначати інлайн у файлах налаштувань як записи маркетплейсу з полем source: 'settings'. Це дозволяє вбудовувати визначення плагіна безпосередньо, без окремого репозиторію або маркетплейсу. Оголосіть його в extraKnownMarketplaces.<name>.source; name має збігатися з ключем маркетплейсу, а його плагіни мають посилатися на зовнішні джерела, як-от GitHub або npm (відносні шляхи відхиляються):
{
"extraKnownMarketplaces": {
"inline-tools": {
"source": {
"source": "settings",
"name": "inline-tools",
"plugins": [
{
"name": "quick-lint",
"source": {
"source": "github",
"repo": "my-org/quick-lint"
}
}
]
}
}
}
}
Налаштування плагіна
Плагіни можуть постачатися з файлом settings.json для стандартної конфігурації. Діють два ключі, agent і subagentStatusLine; усі інші ключі відкидаються. agent приймає імʼя одного з агентів плагіна і запускає його як основний потік:
{
"agent": "specialist-1"
}
Коли плагін включає settings.json, його стандартні значення застосовуються при встановленні. Користувачі можуть перевизначити ці налаштування у своїй конфігурації проєкту або користувача.
Автономний vs плагін-підхід
| Підхід | Назви команд | Конфігурація | Найкраще для |
|---|---|---|---|
| Автономний | /hello |
Ручне налаштування в CLAUDE.md | Персональне, специфічне для проєкту |
| Плагіни | /plugin-name:hello |
Автоматичне через plugin.json | Поширення, дистрибуція, командна робота |
Використовуйте автономні слеш-команди для швидких персональних робочих процесів. Використовуйте плагіни, коли хочете обʼєднати кілька функцій, поділитися з командою або опублікувати для дистрибуції.
Практичні приклади
Приклад 1: Плагін PR Review
Файл: .claude-plugin/plugin.json
{
"name": "pr-review",
"version": "1.0.0",
"description": "Complete PR review workflow with security, testing, and docs",
"author": {
"name": "Anthropic"
},
"repository": "https://github.com/your-org/pr-review",
"license": "MIT"
}
Файл: commands/review-pr.md
---
name: Review PR
description: Start comprehensive PR review with security and testing checks
---
# PR Review
This command initiates a complete pull request review including:
1. Security analysis
2. Test coverage verification
3. Documentation updates
4. Code quality checks
5. Performance impact assessment
Файл: agents/security-reviewer.md
---
name: security-reviewer
description: Security-focused code review
tools: Read, Grep, Bash
---
# Security Reviewer
Specializes in finding security vulnerabilities:
- Authentication/authorization issues
- Data exposure
- Injection attacks
- Secure configuration
Встановлення:
claude --plugin-dir ./07-plugins/pr-review
# Результат:
# ✅ 3 слеш-команди встановлено
# ✅ 3 субагенти налаштовано
# ✅ 2 MCP-сервери підключено
# ✅ 4 хуки зареєстровано
# ✅ Готово до використання!
Приклад 2: Плагін DevOps
Компоненти:
devops-automation/
├── commands/
│ ├── deploy.md
│ ├── rollback.md
│ ├── status.md
│ └── incident.md
├── agents/
│ ├── deployment-specialist.md
│ ├── incident-commander.md
│ └── alert-analyzer.md
├── mcp/
│ └── kubernetes-config.json
├── hooks/
│ ├── pre-deploy.js
│ └── post-deploy.js
└── scripts/
├── deploy.sh
├── rollback.sh
└── health-check.sh
Приклад 3: Плагін документації
Обʼєднані компоненти:
documentation/
├── commands/
│ ├── generate-api-docs.md
│ ├── generate-readme.md
│ ├── sync-docs.md
│ └── validate-docs.md
├── agents/
│ ├── api-documenter.md
│ ├── code-commentator.md
│ └── example-generator.md
├── mcp/
│ └── github-docs-config.json
└── templates/
├── api-endpoint.md
├── function-docs.md
└── adr-template.md
Маркетплейс плагінів
Офіційний каталог плагінів, керований Anthropic — anthropics/claude-plugins-official. Адміністратори підприємств також можуть створювати приватні маркетплейси для внутрішньої дистрибуції.
graph TB
A["Plugin Marketplace"]
B["Official<br/>anthropics/claude-plugins-official"]
C["Community<br/>Marketplace"]
D["Enterprise<br/>Private Registry"]
A --> B
A --> C
A --> D
B -->|Categories| B1["Development"]
B -->|Categories| B2["DevOps"]
B -->|Categories| B3["Documentation"]
C -->|Search| C1["DevOps Automation"]
C -->|Search| C2["Mobile Dev"]
C -->|Search| C3["Data Science"]
D -->|Internal| D1["Company Standards"]
D -->|Internal| D2["Legacy Systems"]
D -->|Internal| D3["Compliance"]
style A fill:#e1f5fe,stroke:#333,color:#333
style B fill:#e8f5e9,stroke:#333,color:#333
style C fill:#f3e5f5,stroke:#333,color:#333
style D fill:#fff3e0,stroke:#333,color:#333
Конфігурація маркетплейсу
Підприємства та просунуті користувачі можуть контролювати поведінку маркетплейсу через налаштування:
| Налаштування | Опис |
|---|---|
extraKnownMarketplaces |
Додати додаткові джерела маркетплейсу крім стандартних |
strictKnownMarketplaces |
Контролювати, які маркетплейси дозволено додавати користувачам |
enabledPlugins (значення false) |
Блокування конкретного плагіна: "enabledPlugins": { "<plugin>@<marketplace>": false } у керованих налаштуваннях блокує встановлення в усіх областях і приховує плагін у маркетплейсі |
Дружніші аліаси (v2.1.232):
additionalMarketplacesприймається як аліас дляextraKnownMarketplaces, аallowedMarketplaces— дляstrictKnownMarketplaces. Офіційна довідка з налаштувань наводить обидва в розділі Marketplace key aliases. Старіші версії ігнорують аліаси, тож канонічні ключі безпечно використовувати й далі.
Шаблони власника (v2.1.223+): запис
"owner/*"дозволяє або блокує всі репозиторії маркетплейсів під одним власником GitHub. Приймається лише уstrictKnownMarketplacesтаblockedMarketplaces. Скрізь інде, де зʼявляється джерелоgithub— включно зextraKnownMarketplacesі/plugin marketplace add— значенняrepoмає вказувати на один репозиторій.
Додаткові функції маркетплейсу
- Стандартний таймаут git: Збільшено з 30с до 120с для великих репозиторіїв плагінів
- Кастомні npm-реєстри: Плагіни можуть вказувати URL кастомних npm-реєстрів для розвʼязання залежностей
- Фіксація версій: Закріплення плагінів за конкретними версіями для відтворюваних середовищ
Схема визначення маркетплейсу
Маркетплейси плагінів визначаються у .claude-plugin/marketplace.json:
{
"name": "my-team-plugins",
"owner": { "name": "my-org" },
"plugins": [
{
"name": "code-standards",
"source": "./plugins/code-standards",
"description": "Enforce team coding standards",
"version": "1.2.0",
"author": { "name": "platform-team" }
},
{
"name": "deploy-helper",
"source": {
"source": "github",
"repo": "my-org/deploy-helper",
"ref": "v2.0.0"
},
"description": "Deployment automation workflows"
}
]
}
| Поле | Обовʼязкове | Опис |
|---|---|---|
name |
Так | Назва маркетплейсу в kebab-case |
owner |
Так | Організація або користувач, що підтримує маркетплейс: обʼєкт з обовʼязковим name (email, url необовʼязкові) |
plugins |
Так | Масив записів плагінів |
plugins[].name |
Так | Назва плагіна (kebab-case) |
plugins[].source |
Так | Джерело плагіна (рядок шляху або обʼєкт джерела) |
plugins[].description |
Ні | Короткий опис плагіна |
plugins[].version |
Ні | Рядок семантичної версії |
plugins[].author |
Ні | Автор плагіна: обʼєкт з обовʼязковим name (email, url необовʼязкові) |
Типи джерел плагінів
Плагіни можуть завантажуватися з кількох місць:
| Джерело | Синтаксис | Приклад |
|---|---|---|
| Відносний шлях | Рядок шляху | "./plugins/my-plugin" |
| GitHub | { "source": "github", "repo": "owner/repo" } |
{ "source": "github", "repo": "acme/lint-plugin", "ref": "v1.0" } |
| Git URL | { "source": "url", "url": "..." } |
{ "source": "url", "url": "https://git.internal/plugin.git" } |
| Підкаталог Git | { "source": "git-subdir", "url": "...", "path": "..." } |
{ "source": "git-subdir", "url": "https://github.com/org/monorepo.git", "path": "packages/plugin" } |
| npm | { "source": "npm", "package": "..." } |
{ "source": "npm", "package": "@acme/claude-plugin", "version": "^2.0" } |
Джерела GitHub та git підтримують необовʼязкові поля ref (гілка/тег) та sha (хеш коміту) для фіксації версій.
Методи дистрибуції
GitHub (рекомендовано):
# Користувачі додають ваш маркетплейс
/plugin marketplace add owner/repo-name
Інші git-сервіси (потрібен повний URL):
/plugin marketplace add https://gitlab.com/org/marketplace-repo.git
Приватні репозиторії: Підтримуються через git credential helpers або токени оточення. Користувачі повинні мати доступ на читання до репозиторію.
Подання до каталогу Anthropic: Подавайте плагіни до каталогу Anthropic для ширшої дистрибуції через портал розробника claude.ai/directory/manage. Офіційний маркетплейс Anthropic claude-plugins-official не приймає подання через цей портал.
Суворий режим (strict mode)
Контроль взаємодії визначень маркетплейсу з локальними файлами plugin.json:
| Налаштування | Поведінка |
|---|---|
strict: true (за замовчуванням) |
Локальний plugin.json є авторитетним; запис маркетплейсу доповнює його |
strict: false |
Запис маркетплейсу є повним визначенням плагіна |
Обмеження організації через strictKnownMarketplaces:
| Значення | Ефект |
|---|---|
| Не встановлено | Без обмежень — користувачі можуть додавати будь-який маркетплейс |
Порожній масив [] |
Блокування — маркетплейси заборонені |
| Масив обʼєктів джерел | Білий список — дозволено лише маркетплейси, що відповідають записам |
{
"strictKnownMarketplaces": [
{ "source": "github", "repo": "my-org/*" },
{ "source": "github", "repo": "trusted-vendor/*" }
]
}
Увага: У суворому режимі з
strictKnownMarketplacesкористувачі можуть встановлювати плагіни лише з маркетплейсів білого списку. Це корисно для корпоративних середовищ, що вимагають контрольованої дистрибуції плагінів.
Встановлення та життєвий цикл плагіна
graph LR
A["Discover"] -->|Browse| B["Marketplace"]
B -->|Select| C["Plugin Page"]
C -->|View| D["Components"]
D -->|Install| E["/plugin install"]
E -->|Extract| F["Configure"]
F -->|Activate| G["Use"]
G -->|Check| H["Update"]
H -->|Available| G
G -->|Done| I["Disable"]
I -->|Later| J["Enable"]
J -->|Back| G
Порівняння функцій плагінів
| Функція | Слеш-команда | Навичка | Субагент | Плагін |
|---|---|---|---|---|
| Встановлення | Ручне копіювання | Ручне копіювання | Ручна конфігурація | Одна команда |
| Час налаштування | 5 хвилин | 10 хвилин | 15 хвилин | 2 хвилини |
| Обʼєднання | Один файл | Один файл | Один файл | Кілька |
| Версіонування | Ручне | Ручне | Ручне | Автоматичне |
| Поширення в команді | Копіювання файлу | Копіювання файлу | Копіювання файлу | ID встановлення |
| Оновлення | Ручне | Ручне | Ручне | Автоматично доступне |
| Залежності | Немає | Немає | Немає | Можуть включати |
| Маркетплейс | Ні | Ні | Ні | Так |
| Дистрибуція | Репозиторій | Репозиторій | Репозиторій | Маркетплейс |
CLI-команди плагінів
Усі операції з плагінами доступні як CLI-команди:
claude plugin install <n>@<marketplace> # Встановити з маркетплейсу
claude plugin uninstall <n> # Видалити плагін
claude plugin list # Список встановлених плагінів
claude plugin enable <n> # Увімкнути вимкнений плагін
claude plugin disable <n> # Вимкнути плагін
claude plugin validate <path> # Валідація структури плагіна за шляхом <path>
Методи встановлення
З маркетплейсу
/plugin install plugin-name
# або з CLI:
claude plugin install plugin-name@marketplace-name
Увімкнення / Вимкнення (з автовизначенням області)
/plugin enable plugin-name
/plugin disable plugin-name
Локальний плагін (для розробки)
# CLI-прапорець для локального тестування (повторюваний для кількох плагінів)
claude --plugin-dir ./path/to/plugin
claude --plugin-dir ./plugin-a --plugin-dir ./plugin-b
З Git-репозиторію
/plugin marketplace add username/repo # Додайте GitHub-репозиторій як маркетплейс
/plugin install plugin-name@marketplace-name # Потім встановіть із нього плагін
/plugin install plugin-name --marketplace username/repo # Або обидва кроки за один раз (v2.1.275+)
Коли створювати плагін
graph TD
A["Should I create a plugin?"]
A -->|Need multiple components| B{"Multiple commands<br/>or subagents<br/>or MCPs?"}
B -->|Yes| C["✅ Create Plugin"]
B -->|No| D["Use Individual Feature"]
A -->|Team workflow| E{"Share with<br/>team?"}
E -->|Yes| C
E -->|No| F["Keep as Local Setup"]
A -->|Complex setup| G{"Needs auto<br/>configuration?"}
G -->|Yes| C
G -->|No| D
Випадки використання плагінів
| Випадок | Рекомендація | Чому |
|---|---|---|
| Онбординг команди | ✅ Плагін | Миттєве налаштування, усі конфігурації |
| Налаштування фреймворку | ✅ Плагін | Обʼєднує команди, специфічні для фреймворку |
| Корпоративні стандарти | ✅ Плагін | Централізована дистрибуція, контроль версій |
| Швидка автоматизація | ❌ Команда | Надмірна складність |
| Одна предметна область | ❌ Навичка | Занадто важко, використовуйте навичку |
| Спеціалізований аналіз | ❌ Субагент | Створіть вручну або використовуйте навичку |
| Доступ до живих даних | ❌ MCP | Автономний, не обʼєднуйте |
Тестування плагіна
Перед публікацією протестуйте плагін локально за допомогою CLI-прапорця --plugin-dir (повторюваний для кількох плагінів):
claude --plugin-dir ./my-plugin
claude --plugin-dir ./my-plugin --plugin-dir ./another-plugin
Це запускає Claude Code з завантаженим плагіном, дозволяючи:
- Перевірити доступність усіх слеш-команд
- Протестувати коректну роботу субагентів та агентів
- Підтвердити правильне підключення MCP-серверів
- Валідувати виконання хуків
- Перевірити конфігурації LSP-серверів
- Виявити помилки конфігурації
Гаряче перезавантаження (Hot-Reload)
Плагіни підтримують гаряче перезавантаження під час розробки. При зміні файлів плагіна Claude Code може автоматично виявляти зміни. Також можна примусово перезавантажити командою:
/reload-plugins
Це повторно зчитує всі маніфести плагінів, команди, агентів, навички, хуки та конфігурації MCP/LSP без перезапуску сесії.
Керовані налаштування для плагінів
Адміністратори можуть контролювати поведінку плагінів в організації через керовані налаштування (managed settings):
| Налаштування | Опис |
|---|---|
enabledPlugins |
Білий список плагінів, увімкнених за замовчуванням |
enabledPlugins (значення false) |
Блокування конкретного плагіна: "enabledPlugins": { "<plugin>@<marketplace>": false } у керованих налаштуваннях блокує встановлення в усіх областях і приховує плагін у маркетплейсі |
extraKnownMarketplaces |
Додаткові джерела маркетплейсу крім стандартних |
strictKnownMarketplaces |
Обмеження маркетплейсів, які дозволено додавати користувачам |
allowedChannelPlugins |
Білий список плагінів каналів, яким дозволено надсилати повідомлення в сесії (кожен запис містить marketplace і plugin) |
Дружніші аліаси (v2.1.232):
additionalMarketplacesприймається як аліас дляextraKnownMarketplaces, аallowedMarketplaces— дляstrictKnownMarketplaces. Офіційна довідка з налаштувань наводить обидва в розділі Marketplace key aliases. Старіші версії ігнорують аліаси, тож канонічні ключі безпечно використовувати й далі.
Шаблони власника (v2.1.223+): запис
"owner/*"дозволяє або блокує всі репозиторії маркетплейсів під одним власником GitHub. Приймається лише уstrictKnownMarketplacesтаblockedMarketplaces. Скрізь інде, де зʼявляється джерелоgithub— включно зextraKnownMarketplacesі/plugin marketplace add— значенняrepoмає вказувати на один репозиторій.
Ці налаштування можна застосувати на рівні організації через файли керованої конфігурації, і вони мають пріоритет над налаштуваннями рівня користувача.
Безпека плагінів
Субагенти плагінів ігнорують наступні ключі frontmatter (агент усе одно завантажується; ці ключі не діють):
hooks— субагенти не можуть реєструвати обробники подійmcpServers— субагенти не можуть налаштовувати MCP-сервериpermissionMode— субагенти не можуть перевизначати модель дозволівinitialPrompt— агенти плагінів не можуть автоматично надсилати перший промпт
Файл агента не може сам додати хуки чи MCP-сервери; постачайте їх як хуки та MCP-сервери рівня плагіна.
Публікація плагіна
Кроки для публікації:
- Створити структуру плагіна з усіма компонентами
- Написати маніфест
.claude-plugin/plugin.json - Створити
README.mdз документацією - Протестувати локально за допомогою
claude --plugin-dir ./my-plugin - Подати до маркетплейсу плагінів
- Пройти перевірку та затвердження
- Публікація в маркетплейсі
- Користувачі можуть встановити однією командою
Приклад подання:
# PR Review Plugin
## Description
Complete PR review workflow with security, testing, and documentation checks.
## What's Included
- 3 slash commands for different review types
- 3 specialized subagents
- GitHub and CodeQL MCP integration
- Automated security scanning hooks
## Installation
```bash
claude --plugin-dir ./07-plugins/pr-review
```
## Features
✅ Security analysis
✅ Test coverage checking
✅ Documentation verification
✅ Code quality assessment
✅ Performance impact analysis
## Usage
```bash
/review-pr
/check-security
/check-tests
```
## Requirements
- Claude Code 2.1+
- GitHub access
- CodeQL (optional)
Плагін vs ручна конфігурація
Ручне налаштування (2+ години):
- Встановити слеш-команди одну за одною
- Створити субагентів окремо
- Налаштувати MCP окремо
- Встановити хуки вручну
- Задокументувати все
- Поширити в команді (сподіватися, що налаштують правильно)
З плагіном (2 хвилини):
claude --plugin-dir ./07-plugins/pr-review
# ✅ Все встановлено та налаштовано
# ✅ Готово до використання одразу
# ✅ Команда може відтворити точну конфігурацію
Найкращі практики
Рекомендовано ✅
- Використовуйте зрозумілі, описові назви плагінів
- Включайте вичерпний README
- Версіонуйте плагін правильно (semver — семантичне версіонування)
- Тестуйте всі компоненти разом
- Документуйте вимоги чітко
- Надавайте приклади використання
- Включайте обробку помилок
- Тегуйте належним чином для виявлення
- Підтримуйте зворотну сумісність
- Тримайте плагіни зосередженими та цілісними
- Включайте вичерпні тести
- Документуйте всі залежності
Не рекомендовано ❌
- Не обʼєднуйте неповʼязані функції
- Не зашивайте облікові дані в код
- Не пропускайте тестування
- Не забувайте про документацію
- Не створюйте надлишкових плагінів
- Не ігноруйте версіонування
- Не ускладнюйте залежності компонентів
- Не забувайте обробляти помилки коректно
Інструкції зі встановлення
Встановлення з маркетплейсу
Перегляд доступних плагінів (вкладка Discover показує плагіни з ваших маркетплейсів;
/plugin listпоказує лише встановлені плагіни):/pluginДеталі плагіна: виберіть плагін на вкладці Discover, щоб відкрити його деталі. (
claude plugin details plugin-nameпрацює лише для завантаженого плагіна: встановленого або переданого через--plugin-dir.)Встановлення плагіна:
/plugin install plugin-name
Чи набуде чинності одразу? Починаючи з v2.1.221 — зазвичай так. Прочитайте останній рядок підсумку встановлення:
| Підсумок встановлення каже | Що це означає |
|---|---|
Plugin is now active. |
Claude Code активував плагін під час встановлення. Більше нічого робити не треба. |
Run /reload-plugins to activate. |
Плагін встановлено, але він ще не активний — або активація знецінила б prompt cache, або спроба активації не вдалася. |
До v2.1.221 жодне встановлення не набувало чинності в поточній сесії, доки ви не запускали /reload-plugins або не перезапускали Claude Code.
Встановлення з локального шляху
# /plugin install потребує name@marketplace; шлях дає помилку "marketplace not found"
claude --plugin-dir ./path/to/plugin-directory
Встановлення з GitHub
/plugin marketplace add username/repo # Додайте GitHub-репозиторій як маркетплейс
/plugin install plugin-name@marketplace-name # Потім встановіть із нього плагін
/plugin install plugin-name --marketplace username/repo # Або обидва кроки за один раз (v2.1.275+)
Список встановлених плагінів
/plugin list # усі встановлені плагіни
/plugin list --enabled # лише увімкнені плагіни
/plugin list --disabled # лише вимкнені плагіни
Оновлення плагіна
Використовуйте форму CLI — саме її задокументовано в розділі plugin update і саме її пропонує сам Claude Code, коли з'являється оновлення:
claude plugin update plugin-name
Вимкнення/Увімкнення плагіна
# Тимчасове вимкнення
/plugin disable plugin-name
# Повторне увімкнення
/plugin enable plugin-name
Видалення плагіна
/plugin uninstall plugin-name
Повʼязані концепції
Наступні функції Claude Code працюють разом з плагінами:
- Слеш-команди — окремі команди, обʼєднані в плагіни
- Памʼять — постійний контекст для плагінів
- Навички — предметна експертиза, яку можна обгорнути в плагіни
- Субагенти — спеціалізовані агенти як компоненти плагінів
- MCP-сервери — інтеграції Model Context Protocol, обʼєднані в плагіни
- Хуки — обробники подій, що запускають робочі процеси плагінів
Повний приклад робочого процесу
Повний робочий процес плагіна PR Review
1. Користувач: /review-pr
2. Плагін виконує:
├── pre-review.js хук валідує git-репо
├── GitHub MCP отримує дані PR
├── security-reviewer субагент аналізує безпеку
├── test-checker субагент перевіряє покриття
└── performance-analyzer субагент перевіряє продуктивність
3. Результати синтезуються та представляються:
✅ Безпека: Критичних проблем не виявлено
⚠️ Тестування: Покриття 65% (рекомендовано 80%+)
✅ Продуктивність: Значного впливу немає
📝 Надано 12 рекомендацій
Усунення несправностей
Плагін не встановлюється
- Перевірте сумісність версії Claude Code:
claude --version - Перевірте синтаксис
plugin.jsonвалідатором JSON - Перевірте підключення до інтернету (для віддалених плагінів)
- Перевірте дозволи:
ls -la plugin/
Компоненти не завантажуються
- Переконайтеся, що шляхи в
plugin.jsonвідповідають фактичній структурі каталогів - Перевірте дозволи файлів:
chmod +x scripts/ - Перегляньте синтаксис файлів компонентів
- Перевірте інвентар компонентів:
claude plugin details plugin-name
Збій підключення MCP
- Переконайтеся, що змінні оточення встановлені правильно
- Перевірте встановлення та працездатність MCP-сервера
- Перевірте стан MCP-серверів за допомогою
/mcp - Перегляньте конфігурацію MCP у каталозі
mcp/
Команди недоступні після встановлення
- Переконайтеся, що плагін встановлено успішно:
/plugin list - Перевірте, чи плагін увімкнено:
/plugin list --enabled - Перевірте, чи плагін уже активний — див. підсумок встановлення в розділі Інструкції зі встановлення:
Plugin is now active.— нічого робити не треба,Run /reload-plugins to activate.— запустіть цю команду (перезапуск не потрібен) - Перевірте конфлікти назв з існуючими командами
Проблеми з виконанням хуків
- Переконайтеся, що файли хуків мають правильні дозволи
- Перевірте синтаксис хуків та назви подій
- Перегляньте журнали хуків для деталей помилок
- Протестуйте хуки вручну, якщо можливо
Додаткові ресурси
- Офіційна документація плагінів
- Каталог плагінів
- Маркетплейси плагінів
- Довідник плагінів
- Довідник MCP-серверів
- Посібник конфігурації субагентів
- Довідник системи хуків
Останнє оновлення: 18 жовтня 2026 Версія Claude Code: 2.1.302 Джерела:
- https://code.claude.com/docs/en/discover-plugins
- https://code.claude.com/docs/en/plugins-reference
- https://code.claude.com/docs/en/settings
- https://code.claude.com/docs/en/plugins/install
- https://code.claude.com/docs/en/plugins/cli-reference
- https://code.claude.com/docs/en/plugins/manifest-reference
- https://code.claude.com/docs/en/plugins/marketplace-reference
- https://code.claude.com/docs/en/plugins/components
- https://code.claude.com/docs/en/plugins/publish
- https://code.claude.com/docs/en/plugins/overview Сумісні моделі: Claude Fable 5, Claude Opus 5, Claude Sonnet 5, Claude Sonnet 4.6, Claude Opus 4.8, Claude Haiku 4.5