Плагины Claude Code: маркетплейсы, установка и как собрать свой

Что внутри плагина

Скилл решает одну задачу. Плагин собирает рабочий набор: например, скилл ревью, команду /review, субагента-ревьюера и хук, который гоняет линтер после правок. Включили плагин, и всё это появилось разом. Выключили, и всё ушло.

Структура папки по справочнику:

my-plugin/
  .claude-plugin/plugin.json   манифест (необязателен)
  skills/<имя>/SKILL.md
  commands/*.md
  agents/*.md
  hooks/hooks.json
  .mcp.json
  .lsp.json
  output-styles/
  settings.json

Компоненты получают пространство имён плагина: plugin:component. Так два плагина с командой /review не конфликтуют. CLAUDE.md в корне плагина не загружается, инструкции кладут в скиллы.

Как установить плагин в Claude Code

Сначала подключают маркетплейс, потом ставят из него плагин:

/plugin marketplace add owner/repo
/plugin install имя-плагина@имя-маркетплейса

То же из терминала: claude plugin marketplace add <owner>/<repo> (или URL, или локальная папка) и claude plugin install <имя>@<маркетплейс>. Команда /plugin без аргументов открывает меню, где видно установленные плагины и подключённые каталоги.

Официальный маркетплейс Anthropic подключён по умолчанию, его добавлять не нужно. Репозиторий anthropics/skills тоже ставится как маркетплейс: /plugin marketplace add anthropics/skills.

Для команды маркетплейсы и плагины прописывают в настройках проекта (extraKnownMarketplaces, enabledPlugins), и коллеги получают их без ручной установки.

Официальные каталоги плагинов Anthropic

Цифры сняты 24.10.2026.

Сторонних маркетплейсов на GitHub тысячи. Агрегатор awesomeclaudeplugins.com на ту же дату насчитал 136 291 плагин в 51 324 репозиториях. Автоматический скан community-каталога не заменяет вашей проверки: хук плагина исполняет код на вашей машине. Отобранные плагины с лицензией и звёздами в паспорте собраны в разделе Плагины и подборке лучших плагинов Claude Code.

plugin.json: манифест плагина

Манифест .claude-plugin/plugin.json необязателен: без него Claude Code найдёт компоненты по стандартным папкам. Если манифест есть, обязательно в нём только name в kebab-case. Префиксы вроде claude-, anthropic-, cc-plugin- запрещены.

{
  "name": "team-review",
  "version": "0.1.0",
  "description": "Ревью перед коммитом: скилл, команда и хук линтера",
  "license": "MIT"
}

Необязательные поля: version, description, author, license, keywords, dependencies, userConfig, mcpServers. В путях хуков и MCP-конфигов работают ${CLAUDE_PLUGIN_ROOT}, ${CLAUDE_PLUGIN_DATA} и ${CLAUDE_PROJECT_DIR}.

Одна оговорка про субагентов: внутри плагина у них игнорируются поля hooks, mcpServers и permissionMode.

marketplace.json: свой маркетплейс

Маркетплейс — это любой git-репозиторий с файлом .claude-plugin/marketplace.json. Обязательные поля: name, owner с name и массив plugins, где у каждой записи есть name и source.

{
  "name": "acme-tools",
  "owner": { "name": "Acme" },
  "plugins": [
    { "name": "team-review", "source": "./plugins/team-review" },
    { "name": "db-guard", "source": { "source": "github", "repo": "acme/db-guard" } }
  ]
}

source бывает относительным путём, GitHub-репозиторием, подпапкой git, URL, архивом, npm-пакетом или командой. Имена официальных маркетплейсов, например claude-plugins-official, зарезервированы. Подробности в документации маркетплейсов.

Как проверить плагин до публикации

• claude plugin validate ./my-plugin проверяет структуру и манифест;
• claude --plugin-dir ./my-plugin запускает сессию с плагином из папки, без маркетплейса;
• после правок обновите плагин и проверьте, что команды видны с префиксом плагина.

Если плагин нужен не только в Claude Code, учтите: Cursor импортирует плагины из GitHub по своему .cursor-plugin/marketplace.json, у Gemini CLI свои расширения с gemini-extension.json, у Codex плагины ставятся через /plugins. Переносятся без правок в основном скиллы, потому что SKILL.md читают все. Как устроены форматы у разных агентов, разобрано в гайде про форматы.