claude plugin из вашей оболочки или скрипта, либо как /plugin и /reload-plugins внутри сеанса Claude Code. Этот справочник содержит флаги каждой команды, значения по умолчанию, выходные данные и коды выхода, а также два флага, которые загружают плагин на один сеанс.
Запустите claude plugin --help на вашей сборке, чтобы подтвердить, какие подкоманды есть в вашей версии.
Эти случаи рассматриваются на других страницах:
- Установка и управление шагами, и где запускается
/plugin: см. Установка и управление плагинами - Что команда изменяет на диске и какой приоритет области действия: см. Справочник загрузки плагинов
- Что означает сообщение об ошибке: см. Устранение неполадок плагинов
Команды claude plugin
Запуститеclaude plugin <subcommand> из вашей оболочки или скрипта, вне сеанса Claude Code. Эти подкоманды устанавливают и управляют плагинами без открытия панели /plugin.
claude plugins — это псевдоним для claude plugin.
Каждая подкоманда имеет эти коды выхода, аргументы плагина и значения области действия:
- Коды выхода:
0при успехе и1при ошибке.validateдобавляет выход2для неожиданной ошибки, аevalдобавляет коды, указанные в его разделе. - Аргументы плагина: аргумент
<plugin>— этоnameплагина илиname@marketplace. Когда два маркетплейса предлагают одно и то же имя, используйте квалифицированную форму. - Области действия:
--scopeпринимаетuser,projectилиlocal, и называет файл параметров, в который команда записывает.updateтакже принимаетmanaged.
plugin init
Создайте каркас нового плагина в~/.claude/skills/<name>/. Он загружается в вашем следующем сеансе как <name>@skills-dir без шага установки.
new — это псевдоним для init.
Для рабочего процесса создания, тестирования и редактирования, который начинается с этой команды, см. Создание плагина.
<name> становится именем каталога под ~/.claude/skills/ и name плагина в его манифесте.
Команда не имеет флага для другого местоположения. Чтобы создать каркас внутри проекта, см. Создание плагина.
Создайте плагин с файлами-заготовками skill и hook:
Created plugin "my-helper" at ~/.claude/skills/my-helper, за которым следует идентификатор, под которым он загружается, и команда claude plugin disable, которая его отключает.
Claude Code выходит с кодом 1 без записи, когда не может безопасно создать каркас, и сообщение называет причину. Это распространённые причины:
- Неизвестное значение
--with - Существующий каркас в целевом месте без
--force - Управляемый параметр, который блокирует плагины из каталога skills
plugin install
Установите плагин из маркетплейса, который вы добавили.i — это псевдоним для install.
headersHelper для его загрузки, Claude Code сначала выводит команду и спрашивает Run this command now? [y/N].
Передайте
-y из вашего собственного терминала, чтобы принять отображаемую команду без запроса. Вот что происходит без TTY и когда Claude запускает команду:
- stdin или stdout не является TTY, и вы не передаёте ни
-y, ни--accept-command: установка отклоняется. Выходные данные говорят, что команда была только отображена, и код выхода —1 - Claude запускает команду через свой инструмент Bash:
-yигнорируется. Запустите команду из вашего собственного терминала вместо этого
Successfully installed plugin: formatter@my-marketplace (scope: project). Когда ничего нового не устанавливается, выходные данные объясняют почему:
- Уже установлено в этой области действия: выходные данные —
Plugin "formatter@my-marketplace" is already installed (scope: project)и код выхода —0 - Вы отклоняете запрос источника команды: выходные данные —
Aborted.и код выхода —1 - Вы отклоняете запрос
headersHelper, или его нельзя подтвердить без TTY: выходные данные —Aborted — the command was not run.и код выхода —1
Формат результата JSON
Когда вы передаёте--json в plugin install, последняя строка stdout — это один JSON объект. Разбирайте только эту строку, потому что Claude Code выводит любую команду, которую объявляет маркетплейс, перед ней.
Три поля всегда присутствуют:
command: подкоманда, которая запустилась, напримерinstalloutcome:okилиfailedmessage: читаемое описание результата
pluginId, scope и failureCode, появляются только когда они применяются.
Ошибка использования, такая как неверный --scope, не выводит строку результата и выходит с кодом 1 с причиной на stderr.
Принять отображаемую команду установки
Когда запуск--json отображает команду, объявленную маркетплейсом, и не запускает её, результат failed также содержит объект shownCommand. Его поля включают команду в том виде, в котором она отображается, плагин, к которому она принадлежит, и sha256 команды.
Чтобы принять именно эту команду, повторно запустите с этим sha256 как --accept-command из вашего собственного терминала, потому что флаг не имеет эффекта внутри сеанса Claude Code. Требует Claude Code v2.1.271 или позже.
sha256 считается принятием именно этой команды, плагина и каталога маркетплейса. Если любой из них изменился с момента отображения команды, Claude Code не принимает sha256 и показывает команду снова. Изменение, которое обновление маркетплейса собственного запуска получает, также считается таким изменением.
Если shownCommand.acceptCommandMatched — это false, sha256, который вы передали, не совпадает с командой, которая сейчас отображается. Проверьте эту команду перед повторным запуском с её sha256.
plugin uninstall
Удалите установленный плагин из одной области действия.remove и rm — это псевдонимы для uninstall.
Удалите плагин из области действия проекта:
Successfully uninstalled plugin: formatter (scope: project). Когда плагин не установлен в этой области действия, команда выводит строку, которая начинается с Failed to uninstall plugin "formatter@my-marketplace": и выходит с кодом 1.
plugin enable
Включите отключённый плагин. Для плагина, синхронизированного с claude.ai, передайте<name>@synced как плагин.
Без
--scope команда проверяет ваши файлы параметров в порядке local, project, user и использует первую область действия, которая упоминает плагин.
Если вы передаёте --scope, где плагин не объявлен, команда либо записывает переопределение, либо не выполняется:
- Область действия, которая имеет приоритет над объявляющей: Claude Code записывает переопределение в переданную область действия. Например,
claude plugin disable formatter --scope localотключает плагин, включённый на уровне проекта, только для вас - Любая другая область действия: команда не выполняется с
Plugin "formatter" is installed at project scope, not user. Use --scope project or omit --scope to auto-detect.
Plugin "formatter" is already enabled и выходит с кодом 1. С --json результат имеет "failureCode": "already_in_goal_state" и "alreadyInGoalState": true, поэтому скрипт может рассматривать этот случай как успех.
Когда плагин объявляет зависимости, Claude Code также включает их. Команда не выполняется в этих случаях:
- Зависимость не установлена: включение не выполняется и выводит команду
claude plugin installдля каждой отсутствующей зависимости - Зависимость заблокирована политикой плагинов вашей организации: включение не выполняется и называет заблокированную зависимость
- Зависимость установлена на
falseв области действия с более высоким приоритетом, чем целевая область действия: включение не выполняется. Включите зависимость в этой области действия или передайте--scopeдля записи там
Successfully enabled plugin: formatter (scope: project), называя обнаруженную область действия.
plugin disable
Отключите плагин без его удаления. Для плагина, синхронизированного с claude.ai, передайте<name>@synced как плагин.
Без
--scope область действия автоопределяется в том же порядке local, project, user, что и plugin enable.
Если вы не передаёте ни имя плагина, ни --all, Claude Code выводит Please specify a plugin name or use --all to disable all plugins и выходит с кодом 1. Отключение плагина, который уже отключён, выводит Plugin "formatter" is already disabled и выходит с кодом 1, как plugin enable делает для уже включённого плагина.
Команда не выполняется для плагина, который всё ещё требуется:
- Другой включённый плагин зависит от него: команда не выполняется и называет зависимые плагины для отключения в первую очередь
- Ваша организация требует его как синхронизированный плагин: команда не выполняется и ничего не сохраняет
Successfully disabled plugin: formatter (scope: project).
plugin update
Обновите плагин до последней версии, которую предлагает его маркетплейс. Новая версия загружается в вашем следующем сеансе или после запуска/reload-plugins в работающем.
managed — это единственная область действия, которую вы можете обновить, но не установить. Для плагинов, установленных администратором, см. Управление плагинами для вашей организации.
Обновите плагин:
Checking for updates for plugin "formatter@my-marketplace"…, затем результат. Когда ничего не новее, он выводит formatter is already at the latest version (1.0.0). и выходит с кодом 0.
Вы можете передать простое имя плагина, которое команда сопоставляет с установленными плагинами. Когда установленные плагины из разных маркетплейсов имеют одно и то же имя, команда отклоняет обновление и выводит квалифицированные команды plugin-name@marketplace-name для запуска вместо этого. Обновление по простому имени требует Claude Code v2.1.246 или позже.
plugin list
Выведите список установленных плагинов с их версией, областью действия и статусом.
Claude Code группирует читаемый выход по тому, как загружается каждый плагин:
Installed plugins:: плагины, которые вы установили из маркетплейсаSession-only plugins (--plugin-dir / --plugin-url):: плагины, загруженные этими флагами в той же команде, как вclaude --plugin-dir ./my-plugin plugin listSkills-directory plugins (.claude/skills/*):: плагины, которые Claude Code нашёл в каталоге skillsSynced from claude.ai: плагины, синхронизированные с вашей учётной записью claude.ai
No plugins installed. Use `claude plugin install` to install a plugin.
Выход JSON
С--json Claude Code выводит массив с одним объектом на установку. Каждый объект содержит поля ниже. id, version, scope, enabled и installPath всегда присутствуют, а остальные появляются только когда они применяются.
С
--json --available Claude Code выводит один объект вместо массива. Его поле installed содержит массив объектов установленных плагинов, а его поле available содержит один объект на неустановленный плагин маркетплейса с полями ниже.
plugin details
Покажите инвентарь компонентов плагина и его прогнозируемую стоимость в токенах. Плагин должен быть загружен: установлен, найден в каталоге skills или передан с--plugin-dir или --plugin-url в той же команде. <name> — это name плагина или name@marketplace.
--help.
Покажите, что вносит установленный плагин:
Component inventory: skills, agents, hooks, MCP серверы и LSP серверы плагинаProjected token cost: всегда включённые токены, которые плагин добавляет в каждый сеансPer-component (rounded): оценки всегда включённых и при вызове для каждого skill, agent и команды. Пропускается, когда плагин не имеет ни одного
Plugin "formatter" not found. Run `claude plugin list` to see installed plugins, or pass --plugin-dir <path> to load one from disk. и выходит с кодом 1.
plugin prune
Удалите автоустановленные зависимости, которые больше не нужны ни одному установленному плагину. Команда никогда не удаляет плагин, который вы установили сами.autoremove — это псевдоним для prune.
Предпросмотрите то, что удалила бы очистка:
(dry run — nothing removed). Когда нечего удалять, он выводит строку, которая начинается с Nothing to prune.
Без --dry-run команда удаляет сиротские зависимости только после того, как вы подтвердите в запросе или передадите -y.
Код выхода — 0 независимо от вашего ответа в запросе.
То, что делает prune, зависит от того, подключен ли терминал и передаёте ли вы -y:
plugin eval
Запустите eval случаи плагина и сообщите оценённые результаты. Требует Claude Code v2.1.269 или позже. Каждый случай — это подсказка плюс оценщики. Claude Code запускает его несколько раз в изолированном сеансе только с целевым плагином загруженным, и по умолчанию также без плагина, чтобы отчёт показал разницу. См. Тестирование плагинов с помощью evals для формата случая, оценщиков, результатов и использования CI.target по умолчанию — текущий каталог и принимает любую из этих форм:
- Каталог плагина
- Один файл
prompt.mdилиcase.yaml - Установленный плагин как
nameилиname@marketplace name@skills-dir
--tag, --allow-tools и --json. Каждая из этих опций принимает слова, которые следуют за ней, как её значение, поэтому target, написанный после одной из них, читается как тег, имя инструмента или путь выходного JSON вместо target.
Эта таблица выводит опции, которые используют большинство запусков. Запустите claude plugin eval --help для полного набора, включая --case, --tag, --output-dir, --report, --allow-real-servers, --keep-temp и --verbose.
Код выхода сообщает, как закончился запуск. Чтобы действовать на нём в конвейере, см. Запуск evals в CI.
plugin eval init
Создайте набор eval для плагина в текущем каталоге. Требует Claude Code v2.1.269 или позже. См. Создание вашего первого набора eval.- Читает плагин
- Спрашивает вас, что он должен делать хорошо
- Предлагает случаи и оценщиков
- Записывает файлы случаев
- Запускает случаи и проверяет оценки с вами, чтобы убедиться, что оценщики оценивают так, как вы бы оценили
--bare или без терминала команда записывает пустой шаблон одного случая вместо этого. Когда Claude запускает команду из внутри сеанса Claude Code, команда выводит инструкции интервью для этого сеанса, чтобы следовать, а не записывать шаблон.
Необязательный name — это имя случая. Это требуется с --bare или без терминала, потому что команда записывает пустой шаблон для этого случая. Интервью не нуждается в одном.
Команда принимает эти опции:
plugin tag
Создайте аннотированный git тег с именем<name>--v<version> для выпуска плагина. Перед тегированием команда проверяет, что plugin.json плагина и любая запись маркетплейса, которая его выводит, согласны по версии.
Для того, когда тегировать выпуск, см. Публикация плагина.
[path] — это каталог плагина, по умолчанию текущий каталог. Команда находит запись маркетплейса, поднимаясь от этого каталога к .claude-plugin/marketplace.json, который выводит плагин.
Предпросмотрите тег для плагина в проверке маркетплейса:
- Имя плагина
- Версию и из какого файла она взята
- Соответствующую запись маркетплейса, когда она есть
- Имя тега
- Команды
git tagиgit push, которые он запустил бы
--dry-run Claude Code выводит Created tag formatter--v1.0.0 и либо Pushed to origin, либо команду push для запуска самостоятельно. Если push не выполняется, тег всё ещё создаётся локально и команда выходит с ошибкой.
Команда выходит с кодом 1 и выводит причину, когда не может безопасно тегировать. Распространённые причины:
- Нет
versionвplugin.jsonили записи маркетплейса - Тег уже существует
- Рабочее дерево грязное
plugin validate
Проверьте манифест плагина, манифест маркетплейса или skills, agents и команды в каталоге, и выходите с кодом, на который может действовать задача CI. Для рабочего процесса создания, тестирования и редактирования см. Создание плагина. Для того, что проверяет валидатор в каждом манифесте, см. справочник манифеста плагина и справочник маркетплейса.
Проверьте плагин перед фиксацией:
Проверка каталога
<path> — это файл манифеста или каталог. Учитывая каталог, Claude Code выбирает то, что проверять, по тому, что он там находит:
.claude-plugin/marketplace.json, когда он существует- Иначе
.claude-plugin/plugin.json - Иначе файлы компонентов, выбранные по имени каталога. Проверка файлов компонентов без манифеста требует Claude Code v2.1.233 или позже:
- Каталог с именем
skills,agentsилиcommands: файлы внутри него - Каталог с именем
.claude: каталогиskills,agentsиcommandsвнутри него - Любой другой каталог: эти три каталога под его
.claude
- Каталог с именем
- Связанный каталог
skills,agentsилиcommandsпод корнем плагина или.claude: Claude Code предупреждает, что ничего в нём не было прочитано. - Связанная запись внутри каталога
skills,agentsилиcommands: Claude Code пропускает её и предупреждает, по каталогу, сколько записей оно пропустило, которые сеанс загрузил бы. - Каталог
skills,agentsилиcommands, который вы называете, сам является символической ссылкой, или его родительский каталог.claudeявляется: Claude Code сообщает об ошибке и ничего в нём не проверяет. Назовите реальный каталог вместо этого.
SKILL.mdв корне плагина: когда вы запускаетеclaude plugin validateпротив каталога плагина, Claude Code не проверяетSKILL.mdв корне плагинаCLAUDE.mdв корне плагина: в запуске плагина Claude Code также предупреждает оCLAUDE.mdв корне плагина- Файлы плагина в запуске маркетплейса: из каталога маркетплейса Claude Code не открывает файлы skill, agent, command или hook плагинов. Чтобы найти ошибки в этих файлах, проверьте каждый каталог плагина
Выход и коды выхода
Claude Code выводит файл, который он проверил, любые ошибки и предупреждения с их путями, и строку вердикта. Код выхода следует вердикту:
С
--json Claude Code записывает отчёт на stdout как один JSON объект с этими полями верхнего уровня:
success: тот же вердикт, который даёт код выходаstrict: рассматривал ли запуск предупреждения как ошибкиtarget: разрешённый путь, который Claude Code проверилmanifest: собственный результат манифеста илиnullдля запуска без манифестаcontents: результаты для каждого файла, каждый называет свойfileи содержит массивыerrors,warningsиnotes
2 команда ничего не записывает на stdout. Сообщение об ошибке идёт на stderr.
Команды claude plugin marketplace
Запуститеclaude plugin marketplace <subcommand> из вашей оболочки, чтобы добавить, вывести, обновить и удалить маркетплейсы, из которых вы устанавливаете плагины.
- Коды выхода: эти подкоманды следуют соглашению кода выхода команд плагина
- Области действия: их флаг
--scopeне имеет короткой формы-s
plugin marketplace add
Добавьте маркетплейс из репозитория GitHub, URL git, размещённогоmarketplace.json или локального пути, и объявите его в файле параметров.
После добавления Claude Code устанавливает любые зависимости, которые отсутствовали у ваших установленных плагинов.
<source> принимает любую из форм в таблице ниже, и его форма решает тип источника и как Claude Code получает маркетплейс. Для результирующего объекта источника см. справочник маркетплейса.
Для хоста, чьи URL клонирования не содержат суффикс
.git, такого как AWS CodeCommit, добавьте маркетплейс как запись git в extraKnownMarketplaces вместо этого. Claude Code клонирует запись git независимо от того, заканчивается ли её URL на .git.
Claude Code также клонирует URL gitlab.com с вложенными подгруппами, такой как https://gitlab.com/group/subgroup/project.
Добавьте маркетплейс и поделитесь им с проектом:
Successfully added marketplace: your-marketplace (declared in project settings), используя name из собственного манифеста маркетплейса. Повторное добавление или неверный источник выводит один из этих результатов вместо этого:
- Маркетплейс уже на диске: выходные данные —
Marketplace 'your-marketplace' already on disk — declared in project settingsи код выхода —0 - Нераспознанный источник: выходные данные —
Invalid marketplace source format. Try: owner/repo, https://..., or ./pathи код выхода —1 - Простой хост, такой как
gitlab.example.com/team/plugins: добавление не выполняется как неверный ярлыкowner/repo, и сообщение говорит вам добавитьhttps://или использовать локальный путь
From claude.ai: из claude plugin marketplace list:
--claudeai команда отклоняет --scope и --sparse. Маркетплейс размещён для вашей учётной записи, не объявлен в файле параметров, поэтому вы не можете поделиться им через .claude/settings.json проекта.
plugin marketplace list
Выведите список каждого маркетплейса, который вы добавили, с его источником.
Claude Code выводит
Configured marketplaces: и одну строку Source: на маркетплейс, или No marketplaces configured.
С --json Claude Code выводит массив с одним объектом на маркетплейс, содержащий поля ниже. Каждое поле — это строка.
Добавленный маркетплейс claude.ai не имеет локального клона, поэтому его запись содержит его идентификаторы claude.ai,
marketplaceId и organizationUuid, вместо installLocation. Он также содержит scope, когда один записан, и status.
Если ваши сеансы терминала синхронизируют плагины с вашей учётной записью claude.ai, текстовый список заканчивается разделом From claude.ai:. Этот раздел называет маркетплейсы, которые claude.ai выводит для вашей учётной записи, которые вы не добавили, как основанные на git, так и размещённые. Это требует Claude Code v2.1.273 или позже.
Чтобы добавить маркетплейс из этого раздела, см. Добавление маркетплейса с claude.ai.
Выход --json охватывает только настроенные маркетплейсы и оставляет раздел.
plugin marketplace remove
Удалите объявление маркетплейса из ваших параметров.rm — это псевдоним для remove.
<name> — это имя маркетплейса, которое показывает plugin marketplace list, не источник, который вы передали в add.
Удалите маркетплейс из каждой области действия:
Successfully removed marketplace: your-marketplace, добавляя (from project settings), когда вы его ограничили. Если вы ограничиваете файл параметров, который не объявляет маркетплейс, команда не выполняется с Marketplace 'your-marketplace' is not declared in project settings. Omit --scope to remove it from all scopes.
plugin marketplace update
Обновите один маркетплейс или каждый маркетплейс из его источника, чтобы получить новые плагины и версии. Маркетплейс, добавленный с ветвью или тегомref, обновляется до последнего коммита этого ref, не ветви по умолчанию репозитория.
--help.
Обновите один маркетплейс:
Successfully updated marketplace: your-marketplace. Когда вы пропускаете имя, он выводит счёт, такой как Successfully updated 2 marketplaces. Без добавленных маркетплейсов он выводит No marketplaces configured и выходит с кодом 0.
/plugin в сеансе
Внутри интерактивного сеанса/plugin открывает панель плагина. Каждая подкоманда открывает панель на вкладке, запускает действие там или выводит результат встроенно. /plugins и /marketplace — это псевдонимы для /plugin.
Вы можете запускать эти команды только в интерактивном сеансе терминала. В неинтерактивном запуске, таком как claude -p, Claude Code отвечает, что /plugin недоступен в этой среде.
Для того, какие поверхности имеют /plugin, как установить без него и что показывает каждая вкладка панели, см. Установка и управление плагинами.
<plugin> — это name плагина или name@marketplace.
Таблица ниже выводит каждую форму сеанса. Подкоманды оболочки init, update, details, prune, eval и eval init не имеют формы сеанса.
Если вы называете плагин, который не установлен в текущем проекте в
/plugin enable, disable, uninstall или configure, Claude Code выводит Plugin "<plugin>" is not installed in this project вместо действия.
/reload-plugins
Примените ожидающие изменения плагина к работающему сеансу без перезагрузки. Ожидающие изменения — это плагины, которые вы установили, обновили, включили, отключили или отредактировали на диске с момента начала сеанса. Когда вы закрываете панель/plugin с ожидающими изменениями, которые вы сделали в ней, Claude Code запускает /reload-plugins для вас. Запустите его самостоятельно после изменений плагина, которые происходят вне панели, такие как команда claude plugin, которую вы запустили в другом терминале.
Сводка перезагрузки
Claude Code перезагружает каждый активный плагин и выводит одну строку сводки,Reloaded: N plugins · N skills · N agents · N hooks · N plugin MCP servers · N plugin LSP servers, пропуская счёт сервера MCP плагина в сеансе без интерактивного терминала. Когда какой-либо плагин не выполнился, сводка добавляет N errors during load. Run /plugin for details.
Счёт skills охватывает каждый skill, который предоставляет плагин, как его записи commands/, так и skills SKILL.md. Счёт agents — это количество агентов, загруженных в сеансе, включая те, которые не поступают из плагинов.
Когда перезагруженный плагин зависимости отсутствуют, Claude Code устанавливает их, перезагружает снова и добавляет (+ N dependencies: <names>) resolved к сводке.
Перезагрузки, которые изменяют инструменты MCP
Когда перезагрузка добавляет или удаляет сервер MCP плагина или инструментLSP, и это изменение инвалидирует кэш подсказок, Claude Code не применяет перезагрузку. Он выводит строку, такую как This reload changes MCP tools (<server>) — your next message will re-read the whole conversation instead of using the cache. Run /reload-plugins --force to apply. Передайте --force, чтобы применить её в любом случае.
Сеансы без интерактивного терминала
/reload-plugins также запускается в сеансах без интерактивного терминала, такие как приложение для рабочего стола, Agent SDK и неинтерактивный режим с -p. Требует Claude Code v2.1.260 или позже.
В этих сеансах команда запускается только когда вы вводите её в сеанс самостоятельно, такие как в подсказке -p или поле подсказки приложения для рабочего стола. Когда она приходит другим способом, такой как через Remote Control или сообщение, переданное из Slack, команда отвечает /reload-plugins isn't available over a remote connection in this session. и ничего не перезагружает.
Перезагрузка в этих сеансах не подключает или отключает серверы MCP плагина. Эти изменения вступают в силу в вашем следующем сеансе.
Флаги, которые загружают плагин на один сеанс
Два флагаclaude загружают плагин на один сеанс только, без установки. Оба повторяемы.
Авторы плагинов используют их для тестирования плагина перед публикацией. Для рабочего процесса загрузки-редактирования-перезагрузки см. Разработка без маркетплейса.
Плагин, который загружает любой флаг, — это плагин только для сеанса.
claude plugin list показывает его как <name>@inline с областью действия session, но только когда тот же флаг предшествует подкоманде. Например, запустите claude --plugin-dir ./my-plugin plugin list.
Когда плагин только для сеанса имеет одно и то же имя с установленным плагином, Claude Code загружает копию только для сеанса для этого сеанса и пропускает установленную. Установленная копия загружается вместо этого, если вы отключили копию только для сеанса с claude plugin disable <name>@inline, или если управляемые параметры блокируют это имя плагина. Для приоритета см. Справочник загрузки плагинов.
Администратор может отклонить оба флага и папки, названные в переменной CLAUDE_CODE_PLUGIN_DIRS, с управляемым параметром disableSideloadFlags. Claude Code затем выводит, что флаг отключён управляемыми параметрами вашей организации, и выходит с кодом 1 без запуска.
Из Agent SDK опция plugins — это эквивалент --plugin-dir.
Следующие шаги
- Установка и управление плагинами: те же операции, что и шаги, с тем, что вы видите на каждом
- Справочник загрузки плагинов: что каждая команда изменяет на диске и какая область действия вступает в силу
- Устранение неполадок плагинов: установка, маркетплейс, загрузка и сообщения об ошибках проверки с их исправлениями
- Справочник манифеста плагина: поля, которые
claude plugin validateпроверяет