Что такое плагины Claude Code и сколько они стоят
Узнайте, как работают плагины в Claude Code, где они хранятся и как их устанавливать. Разбираем реальную стоимость использования: сам механизм бесплатен, вы платите только за токены.
Что такое плагин Claude Code
Плагин Claude Code — это директория с компонентами, которые Claude Code загружает и управляет ими как единым целым. Основные компоненты включают навыки (skills), агенты, хуки, MCP-серверы, LSP-серверы и фоновые мониторы. Плагин также может содержать команды, стили вывода, темы, рабочие процессы и директорию bin/ с исполняемыми файлами. Установка плагина добавляет все его части одновременно под одним именем, а отключение — удаляет их таким же образом.
По большей части плагин не даёт агенту возможностей, которых у него не было ранее. Навыки, агенты, хуки и MCP-серверы — это компоненты, которые можно создать вручную в директории .claude/. Исключение составляют языковые серверы для анализа кода и моды, которые Claude Code загружает только из плагина. Во всём остальном плагин служит уровнем упаковки: это способ версионировать компоненты, передать их пятнадцати пользователям и обновить позже, не заставляя каждого копировать файлы вручную. В этом заключается основная идея, и большинство недопониманий относительно плагинов возникает из-за ожиданий, что они представляют собой принципиально новый тип функциональности.
Опциональный манифест в .claude-plugin/plugin.json задаёт имя плагина, которое становится пространством имён. Навык в плагине с именем commit-commands вызывается как /commit-commands:commit, поэтому два плагина могут содержать навыки с одинаковым именем commit, не перекрывая друг друга. Агенты плагинов имеют аналогичную область видимости в списке @-упоминаний, например plugin-name:agent-name.
Плагин, навык, MCP-сервер или файл правил
Эти четыре термина часто используют так, будто они конкурируют друг с другом. Это не так, и стоит один раз обозначить границы между ними.
- Навык (skill) — это одна единица инструкции, которую Claude загружает, когда того требует задача. См. что такое навык агента на самом деле.
- MCP-сервер — это отдельный процесс, который предоставляет агенту инструменты через протокол; зачастую это сетевая служба, которую вы запускаете самостоятельно.
- Файл правил, такой как
CLAUDE.md, — это контекст проекта, который считывается при запуске сессии и применяется ко всему. - Плагин — это контейнер, который может объединять в себе навыки, агентов, хуки и определения MCP-серверов, а также содержать номер версии и канал распространения.
Таким образом, вопрос, на который отвечает плагин, звучит не «что может делать агент», а «как мне доставить это моей команде и обновить в следующем месяце». Если вы выбираете между первыми тремя вариантами, сравнение навыков, MCP-серверов и файлов правил подробно описывает этот выбор. Если вас интересует именно часть с MCP, запуск собственных MCP-серверов на VPS охватывает вопросы хостинга.
Где хранятся плагины и что находится внутри
Плагин, установленный из маркетплейса, копируется в локальный кэш по пути ~/.claude/plugins/cache, а не запускается из того места, где он был клонирован. Каждая установленная версия получает собственный каталог. При обновлении или удалении каталог старой версии помечается как «осиротевший» и удаляется примерно через две недели. Это позволяет сеансу, который уже загрузил старую версию, продолжать работу, вместо того чтобы завершаться с ошибкой в процессе выполнения задачи.
Поскольку путь меняется при каждом обновлении, плагин не должен жестко прописывать свое расположение. Хуки и конфигурации MCP внутри плагина используют ${CLAUDE_PLUGIN_ROOT}, который преобразуется в текущий каталог установки. Состояние, которое должно сохраняться после обновления, помещается в ${CLAUDE_PLUGIN_DATA}, который преобразуется в стабильный каталог внутри ~/.claude/plugins/data/.
В кэш копируется только каталог самого плагина, что приводит к последствиям, с которыми пользователи сталкиваются позже. Скрипт, который считывает путь вне корневого каталога плагина, например ../shared-utils, работает во время разработки с локальным путем, но перестает работать после установки, так как эти файлы не были скопированы. Путь к компоненту, объявленный таким образом в plugin.json, выдает ошибку еще раньше: Claude Code отклоняет любой путь к компоненту, выходящий за пределы корня плагина, даже во время разработки, с ошибкой path escapes plugin directory.
Структура выглядит следующим образом.
my-plugin/
├── .claude-plugin/
│ └── plugin.json
├── skills/
│ └── code-review/
│ └── SKILL.md
├── agents/
├── hooks/
│ └── hooks.json
├── .mcp.json
└── bin/Внутри .claude-plugin/ должен находиться только plugin.json. Все остальное располагается в корне плагина. Размещение skills/ или hooks/ внутри .claude-plugin/ — самая частая причина, по которой плагин успешно устанавливается, но затем не выполняет никаких действий: Claude Code ищет эти каталоги в корне, не находит их и загружает плагин без компонентов.
Сам манифест имеет небольшой размер.
{
"name": "my-first-plugin",
"description": "A greeting plugin to learn the basics",
"version": "1.0.0"
}Как установить плагин для Claude Code
Установка состоит из двух этапов, причем первый из них ничего не устанавливает. Вы добавляете маркетплейс — каталог плагинов, а затем устанавливаете из него отдельные плагины. Официальный маркетплейс Anthropic, claude-plugins-official, регистрируется автоматически при первом интерактивном запуске Claude Code. Остальные маркетплейсы вы добавляете самостоятельно.
/plugin marketplace add anthropics/claude-code
/plugin install commit-commands@claude-code-pluginsОбратите внимание, что репозиторий называется anthropics/claude-code, а маркетплейс — claude-code-plugins. Имя берется из файла каталога внутри репозитория, а не из пути к самому репозиторию, поэтому перед вводом команды установки уточните имя маркетплейса на вкладке Marketplaces в /plugin. Этот конкретный репозиторий является демонстрационным маркетплейсом Anthropic, а не официальным, и commit-commands также находится в claude-plugins-official. Для реального использования устанавливайте его как commit-commands@claude-plugins-official, чтобы избежать дублирования.
После установки ознакомьтесь с итоговой строкой. Plugin is now active. означает, что компоненты загружены в текущем сеансе. Run /reload-plugins to apply. означает, что они не были активированы во время установки; панель закрывается, и Claude Code выполняет перезагрузку за вас. Если при перезагрузке появляется предупреждение о повторном чтении диалога, плагин остается в состоянии ожидания, и вы запускаете его повторно командой /reload-plugins --force. Затем убедитесь, что плагин действительно установлен: /plugin отображает его на вкладке Installed, ввод / выводит список его навыков как /plugin-name:skill-name, а все, что не удалось загрузить, отображается на вкладке Errors с указанием причины.
При установке запрашивается область действия (scope), которая определяет, кто получит доступ к плагину. Область User (пользователь) означает, что плагин доступен вам во всех проектах. Область Project (проект) записывает плагин в файл .claude/settings.json репозитория в раздел enabledPlugins, что активирует его для всех, кто клонирует этот репозиторий. Плагин не скачивается автоматически для других участников: каждый соавтор должен установить его на своей машине один раз, например, с помощью claude plugin install name@marketplace --scope project, если только запись в маркетплейсе не является относительным путем. Область Local (локальная) означает, что плагин доступен только вам и только в этом репозитории.
Для скриптов, Dockerfile или любого сеанса, где недоступна интерактивная панель, используйте версию для командной строки. Она устанавливает плагин в область User, если вы не передадите флаг --scope. На машине, где еще не открывали интерактивный сеанс, официальный маркетплейс не зарегистрирован, поэтому сначала добавьте его.
claude plugin marketplace add anthropics/claude-plugins-official
claude plugin install commit-commands@claude-plugins-official --scope project
claude plugin listclaude plugin install выполняется вне сеанса, поэтому в уже открытом сеансе новый плагин не появится, пока вы не выполните /reload-plugins или не начнете новый сеанс.
Управление установленными компонентами происходит по той же схеме в обоих интерфейсах. /plugin list выводит список установленных плагинов и принимает аргументы --enabled или --disabled. /plugin disable name@marketplace отключает плагин без его удаления, /plugin enable включает его обратно, а /plugin uninstall удаляет. Команды со слэшем открывают панель плагинов для применения изменений, поэтому для использования в скриптах следует применять эквиваленты для командной строки claude plugin ....
Чтобы предоставить маркетплейс всей команде, добавьте его в файл .claude/settings.json проекта или один раз выполните claude plugin marketplace add your-org/claude-plugins --scope project и закоммитьте созданный файл. Claude Code зарегистрирует маркетплейс для каждого участника, как только они подтвердят доверие к папке репозитория.
{
"extraKnownMarketplaces": {
"my-team-tools": {
"source": {
"source": "github",
"repo": "your-org/claude-plugins"
}
}
}
}При разработке собственного плагина маркетплейс не требуется. claude --plugin-dir ./my-plugin загружает директорию для текущего сеанса, /reload-plugins подхватывает ваши правки без перезапуска, а claude plugin validate ./my-plugin проверяет манифест, метаданные навыков и агентов, а также hooks/hooks.json, прежде чем плагин увидят другие. Маркетплейс не обязателен и для обмена плагином: вы можете отправить кому-то папку или ее .zip для загрузки через --plugin-dir, однако обновления не будут приходить, пока вы не отправите новую копию.
Сколько стоит плагин для Claude Code?
Механизм использования плагинов бесплатен. По состоянию на август 2026 года плата за добавление маркетплейса, установку плагина или его активацию не взимается. Официальный и общественные маркетплейсы представляют собой публичные git-репозитории, а сам плагин — это каталог с текстовыми файлами.
Стоимость плагина измеряется в токенах, а токены — это единица измерения, по которой рассчитывается использование вашей подписки или счета за API. То, на что именно будут расходоваться токены, зависит от способа оплаты инструмента, а в разделе сколько стоит Claude Code на каждом тарифном плане приведены уровни подписки и стоимость API за токен. Эти расходы возникают тремя способами, и каждый из них влияет на бюджет по-разному.
Стоимость постоянного контекста. Каждый включенный плагин добавляет названия и описания своих навыков, агентов и команд в ваш контекст. Эта часть считывается заново на каждом шаге сессии, независимо от того, выполняется ли какое-либо действие. Не каждый компонент расходует токены: хук запускается через harness и не добавляет ничего в контекст модели. Перед установкой в окне подробного просмотра /plugin отображается раздел Will install, где перечислены команды, навыки, агенты, хуки, а также серверы MCP и LSP, которые вы собираетесь добавить. Для плагина из официального маркетплейса Anthropic также отображается раздел Context cost с оценками Every turn и When invoked, при условии, что вы открыли плагин по его названию в маркетплейсе или через вкладку Marketplaces, а не из списка Discover. Ознакомьтесь с обоими разделами. Плагин из вашего собственного или стороннего маркетплейса не имеет раздела Context cost, но вам не нужно оценивать расходы вручную: команда claude plugin details name в вашей оболочке выводит значение Always-on в токенах и разбивку по компонентам для любого загруженного плагина, включая тот, который вы передаете через --plugin-dir. Таким образом, вы можете клонировать репозиторий и выполнить claude --plugin-dir ./that-plugin plugin details that-plugin до установки. Это значение не учитывает серверы MCP. Плагин, включающий сервер MCP, обычно является самым «тяжелым», так как определения инструментов занимают много места, хотя в моделях, поддерживающих поиск инструментов MCP, эти определения откладываются до момента, пока инструмент не понадобится. Выполните /context в сессии с включенным плагином и прочитайте строку MCP tools, чтобы увидеть, какой объем они добавляют.
Стоимость вызова. Запуск навыка плагина добавляет его инструкции в диалог, поэтому вы платите за тело навыка только тогда, когда он используется. Однако тело навыка — это дешевая часть, а то, что навык предписывает делать агенту, может стоить дорого: метод Depth Tree навыка unlazy расходует почти все токены на дополнительные проходы, которые он принудительно выполняет, прежде чем агенту будет разрешено пометить задачу как выполненную, а не на сам установленный файл. С агентами ситуация иная. Субагент запускает собственный диалог с собственным системным промптом и кэшем, начиная с нуля без попаданий в кэш, поэтому плагин, рабочий процесс которого порождает агентов, стоит значительно дороже, чем предполагает оценка его контекста.
Стоимость кэширования. Включение или отключение плагина в середине сессии может заставить следующий запрос переобрабатывать весь ваш диалог. Навыки, команды, агенты, хуки, мониторы и темы никогда не вызывают этого: то, что они добавляют, присоединяется после существующей истории, поэтому следующий запрос оплачивает новый контент, а все предыдущее содержимое считывается из кэша. Исключение составляют плагины, предоставляющие сервер MCP, и плагины для анализа кода, чей языковой сервер дает Claude инструмент LSP. Для MCP все зависит от поиска инструментов: если инструменты отложены, кэш сохраняется, а если они загружаются в префикс промпта, следующий запрос перечитывает весь диалог как некэшированные входные данные. Именно поэтому /reload-plugins выдает предупреждение и отказывается выполнять действие, если изменение инструментов MCP или инструмента LSP нарушит кэш, пока вы не передадите --force.
Вы можете наблюдать за этим процессом, а не гадать. Каждый ответ API сообщает cache_read_input_tokens и cache_creation_input_tokens, а пользовательская статусная строка с отображением использования токенов в реальном времени выводит эти данные перед вами. Здоровая сессия считывает гораздо больше, чем создает. Если объем создания остается высоким на протяжении нескольких шагов, значит, что-то в вашем префиксе меняется каждый раз. Чтобы получить более полное представление о том, что заполняет окно, см. как управлять окном контекста Claude Code и что на самом деле означают эти счетчики токенов.
Одна процедура обслуживания окупает себя. На вкладке Installed сгруппированы установленные из маркетплейса плагины, которые вы не использовали как минимум 14 дней и 10 сессий; они находятся под заголовком Not used recently, а в окне подробного просмотра есть строка Last used. Эти плагины по-прежнему требуют времени на запуск и расходуют контекст в каждой сессии. Отключите или удалите их. Более экономная привычка — проявлять избирательность перед установкой: какие из навыков Matt Pocock стоит установить — это разбор коллекции из 27 навыков, который отделяет те немногие, что нужны индивидуальному разработчику, от тех, которые приносят пользу только в команде.
Плагин работает с вашими правами доступа
Собственная документация Anthropic прямо указывает на это: установленный вами плагин может выполнять произвольный код на вашей машине с правами вашего пользователя. Это не гипотетическая угроза. Хуки плагина выполняют shell-команды при событиях сессии, включая моменты до и после вызова инструментов. Его директория bin/ добавляется в PATH инструмента Bash, пока плагин активен. Его MCP-серверы — это процессы, которые он запускает, а мод выполняет JavaScript внутри самого Claude Code. Ничто из этого не изолировано от вашей учетной записи пользователя.
На ноутбуке этот риск ограничен тем, к чему имеет доступ ваш пользователь. На сервере это обычно не так. Учетная запись, под которой работает агент, часто содержит SSH-ключи, токены развертывания, сессию cloud CLI и доступ к Docker socket, поэтому «произвольный код от имени вашего пользователя» означает полный контроль над машиной. Если Claude Code запущен на VPS, ознакомьтесь с тем, как безопасно запускать Claude Code на VPS перед установкой чего-либо, и с тем, как ограничить доступ агента к учетным данным перед установкой плагина, взаимодействующего с внешним сервисом. Другие инструменты сталкиваются с теми же ограничениями на арендованном оборудовании, поэтому плагины DeepSeek Harness, которые стоит устанавливать — это в основном лимиты расходов, правила доступа к инструментам и сканирование на инъекции, а не новые функциональные возможности.
Некоторые защитные механизмы существуют, и полезно знать, какие именно. Плагин с областью действия проекта загружается из репозитория, а не вами, поэтому он активируется только после того, как вы доверитесь рабочей области; его MCP-серверы всё равно требуют одобрения для каждого сервера, его LSP-серверы ожидают подтверждения доверия, а фоновые мониторы не загружаются вовсе. Агентам, поставляемым в составе плагинов, запрещено объявлять хуки, MCP-серверы или режим разрешений. Плагины из Marketplace копируются в кэш, при этом символические ссылки, указывающие за пределы Marketplace, игнорируются, поэтому плагин не может получить доступ к произвольным файлам хоста.
Ничто из этого не заменяет необходимость проверять то, что вы устанавливаете. Проверяйте список Will install, отдавайте предпочтение плагинам, исходный код которых можно открыть и прочитать, храните плагины вашей команды в репозитории Marketplace, который вы контролируете, и запускайте claude plugin validate для всего, что пишете самостоятельно.
FAQ
Требуют ли плагины Claude Code дополнительных расходов?
Нет. За систему плагинов, добавление marketplace или установку плагина плата не взимается. Вы платите за использование токенов, которое учитывается в рамках вашего тарифного плана или расходов по API так же, как и любой другой контекст. Плагин добавляет постоянный контекст при каждом ходе, добавляет дополнительный контекст при вызове одного из своих skills или agents и может вызвать один дорогостоящий ход без кэширования, если предоставляет MCP server, инструменты которого загружаются в префикс prompt. Для плагина из официального marketplace Anthropic в представлении подробной информации /plugin перед установкой отображается оценка Context cost; для любого другого плагина claude plugin details name после установки или загрузки с помощью --plugin-dir выводит стоимость токенов, связанных с его постоянным контекстом.
В чём разница между плагином и skill?
Skill — это отдельная инструкция. Plugin — это пакет, который может содержать skills, agents, hooks, MCP servers, LSP servers и monitors, а также имя, обычно версию и обычно marketplace, из которого его можно установить. При этом его можно передать и как папку или .zip, которые загружаются с помощью --plugin-dir. Пишите автономный skill в .claude/, если он предназначен для вас и этого проекта. Пример с единственной задачей — skill Ponytail, который подталкивает agent к минимальному рабочему изменению: это один файл с одним правилом, пока он не понадобится вашей команде. Преобразуйте его в plugin, когда он потребуется другим людям и его нужно будет обновлять со временем. Skills плагина имеют собственные пространства имён, поэтому skill внутри plugin вызывается как /plugin-name:skill-name, а не как /skill-name.
Plugin установлен, но его skills не отображаются. В чём проблема?
Сначала проверьте сводку установки. Если в ней указано Run /reload-plugins to apply., Claude Code выполняет перезагрузку после закрытия панели. Если при перезагрузке появляется предупреждение о повторном чтении разговора, выполните её повторно как /reload-plugins --force. Если plugin загрузился, но ничего не отображается, откройте /plugin и перейдите на вкладку Errors. Самая распространённая структурная ошибка — размещение skills/, agents/ или hooks/ внутри .claude-plugin/: Claude Code не ищет их в этом месте. Помните, что skills плагина имеют собственные пространства имён. Поэтому при вводе / нужно искать /plugin-name:skill-name. В крайнем случае выполните rm -rf ~/.claude/plugins/cache, перезапустите Claude Code и переустановите плагин.
Можно ли устанавливать плагины без интерактивной панели?
Да. Используйте команду оболочки claude plugin install name@marketplace. Она устанавливает плагин в область пользователя, если не передать --scope project или --scope local. Команда работает в скриптах, образах и неинтерактивных средах, где панель /plugin недоступна. Поскольку команда выполняется вне сеанса, уже открытый сеанс нужно перезагрузить с помощью /reload-plugins, прежде чем plugin вступит в силу.
Безопасно ли устанавливать plugin из marketplace, найденного на GitHub?
Относитесь к этому так же, как к запуску install script этого repository от имени своей учётной записи, поскольку по сути это почти одно и то же. Plugin может выполнять команды оболочки через hooks, добавлять исполняемые файлы в PATH инструмента Bash и запускать MCP servers — всё это с привилегиями вашей учётной записи. Anthropic не контролирует и не проверяет содержимое сторонних plugins. Устанавливайте плагины из источников, код которых можно прочитать, перед подтверждением проверяйте список Will install. На server соблюдайте более строгие меры, чем на laptop, поскольку учётная запись на server обычно содержит ключи и токены, которые представляют интерес для злоумышленников.