Skip to main content
Вы запускаете команды плагинов либо как claude plugin из вашей оболочки или скрипта, либо как /plugin и /reload-plugins внутри сеанса Claude Code. Этот справочник содержит флаги каждой команды, значения по умолчанию, выходные данные и коды выхода, а также два флага, которые загружают плагин на один сеанс. В таблицах ниже перечислены часто используемые параметры каждой подкоманды, а не все параметры. Запустите claude plugin --help в вашей оболочке, чтобы увидеть, какие подкоманды есть в вашей версии, и claude plugin <subcommand> --help, чтобы получить полный список параметров подкоманды.
Эти случаи рассматриваются на других страницах:

​
Команды claude plugin

Запустите claude plugin <subcommand> из вашей оболочки или скрипта, вне сессии Claude Code. Эти подкоманды устанавливают и управляют плагинами без открытия панели /plugin. claude plugins — это псевдоним для claude plugin. Каждая подкоманда имеет эти коды выхода, аргументы плагина и значения области действия:
  • Коды выхода: 0 при успехе и 1 при ошибке. validate добавляет выход 2 для неожиданной ошибки, а eval добавляет коды, указанные в его разделе.
  • Аргументы плагина: аргумент <plugin> — это name плагина или name@marketplace. Когда два маркетплейса предлагают одно и то же имя, используйте квалифицированную форму. configure принимает только квалифицированную форму.
  • Области действия: --scope принимает user, project или local, и называет файл настроек, в который команда записывает. update также принимает managed.

​
plugin init

Создайте каркас нового плагина в ~/.claude/skills/<name>/. Он загружается в вашей следующей сессии как <name>@skills-dir без шага установки. new — это псевдоним для init. Для рабочего процесса создания, тестирования и редактирования, который начинается с этой команды, см. Создание плагина.
<name> становится именем каталога под ~/.claude/skills/ и name плагина в его манифесте. Команда не имеет флага для другого местоположения. Чтобы создать каркас внутри проекта, см. Создание плагина. Создайте плагин с файлами-заготовками скилла и хука:
Claude Code проверяет то, что он написал, и выводит 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]. Запустите claude plugin install --help в вашей оболочке, чтобы увидеть каждую опцию, которую поддерживает ваша версия. Передайте -y из вашего собственного терминала, чтобы принять отображаемую команду без запроса. Вот что происходит без TTY и когда Claude запускает команду:
  • stdin или stdout не является TTY, и вы не передаёте ни -y, ни --accept-command: установка отклоняется. Выходные данные говорят, что команда была только отображена, и код выхода — 1
  • Claude запускает команду через свой инструмент Bash: -y игнорируется. Запустите команду из вашего собственного терминала вместо этого
Установите плагин для всех, кто клонирует проект:
Claude Code выводит 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: подкоманда, которая запустилась, например install
  • outcome: ok или failed
  • message: читаемое описание результата
Другие поля, такие как pluginId, scope и failureCode, появляются только когда они применяются. Опция --json в plugin uninstall, plugin update, plugin enable и plugin disable выводит тот же объект с собственными полями соответствующей подкоманды. Ошибка использования, такая как неверный --scope, не выводит строку результата и выходит с кодом 1 с причиной на stderr.

​
JSON-результат для команд маркетплейса

Для plugin marketplace add, plugin marketplace remove и plugin marketplace update флаг --json выводит один JSON объект на последней строке stdout с полями command, outcome и message. Ниже приведён результат claude plugin marketplace remove your-marketplace --json:
Значение command — это marketplace-add, marketplace-remove или marketplace-update. Поля ниже появляются только когда они применяются:
  • marketplace: имя маркетплейса, с которым работала команда
  • failureCode: код причины, по которой команда не выполнилась, например invalid_source
plugin marketplace add и plugin marketplace remove могут не выводить строку результата, когда аргумент — это зарезервированное имя anthropic-plugin-directory, поэтому для этого имени проверяйте код выхода.

​
Принять отображаемую команду установки

Когда запуск --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.
Удалите плагин из области действия проекта:
Claude Code выводит Successfully uninstalled plugin: formatter (scope: project). Когда плагин не установлен в этой области действия, команда выводит строку, которая начинается с Failed to uninstall plugin "formatter@my-marketplace": и выходит с кодом 1. Если строка ошибки продолжается с "formatter" was not uninstalled: и называет файл настроек, Claude Code не смог подтвердить, что настройки области действия больше не включают плагин, поэтому плагин остаётся установленным со всем, что он сохранил. С --json результат содержит failureCode: "settings_still_on". Эта проверка настроек требует Claude Code v2.1.282 или позже.

​
Что удаляет и сохраняет удаление

Когда вы удаляете плагин из последней области действия, в которой он установлен, Claude Code также удаляет сохранённые опции и секреты плагина и его каталог данных, ~/.claude/plugins/data/<id>/. Есть три исключения:
  • С --keep-data каталог данных остаётся
  • Когда другой установленный плагин использует ту же папку, например тот, чей ID отличается от этого только регистром букв, каталог данных остаётся
  • Когда Claude Code не может прочитать список установленных плагинов обратно после удаления плагина из этой области действия, опции, секреты и каталог данных все остаются, потому что плагин может быть установлен в другой области действия. Удаление всё ещё успешно. Сообщение выводит список того, что осталось и как его удалить, и с --json результат содержит savedKept: "install_records_unreadable"
С --json keptData сообщает, остался ли каталог, и /plugin показывает · data preserved, когда он остался. Для каталога, который остаётся без --keep-data, это сообщение требует Claude Code v2.1.281 или позже. Поле savedKept требует Claude Code v2.1.282 или позже.

​
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 для записи там
Повторно включите плагин везде, где он объявлен:
Claude Code выводит 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 делает для уже включённого плагина. Команда не выполняется для плагина, который всё ещё требуется:
  • Другой включённый плагин зависит от него: команда не выполняется и называет зависимые плагины для отключения в первую очередь
  • Ваша организация требует его как синхронизированный плагин: команда не выполняется и ничего не сохраняет
Отключите один плагин:
Claude Code выводит Successfully disabled plugin: formatter (scope: project).

​
plugin update

Обновите плагин до последней версии, которую предлагает его маркетплейс. Новая версия загружается в вашей следующей сессии или после запуска /reload-plugins в работающей.
Обновите плагин:
Claude Code выводит Checking for updates for plugin "formatter@my-marketplace"…, затем результат. Когда ничего не новее, он выводит formatter is already at the latest version (1.0.0). и выходит с кодом 0, если только он не повторяет попытку установки зависимостей плагина и эта установка не завершается ошибкой.

​
Какую область действия обновляет команда

Если вы опустите --scope, команда обновляет плагин в наиболее специфичной области действия, в которой он установлен для вашего текущего проекта, проверяя local, project, user, затем managed. До v2.1.281 команда использовала user, когда вы опускали --scope, поэтому обновление плагина, установленного только в области действия project или local, не выполнялось с Plugin "<name>" is not installed at scope user. На этих версиях передайте --scope. managed — это единственная область действия, которую вы можете обновить, но не установить. Для плагинов, установленных администратором, см. Управление плагинами для вашей организации.

​
Обновление по простому имени

Вы можете передать простое имя плагина, которое команда сопоставляет с установленными плагинами. Когда установленные плагины из разных маркетплейсов имеют одно и то же имя, команда отклоняет обновление и выводит квалифицированные команды plugin-name@marketplace-name для запуска вместо этого. Обновление по простому имени требует Claude Code v2.1.246 или позже.

​
Повторная попытка незавершённой установки зависимостей

Когда плагин уже находится на последней версии, команда также может повторить попытку незавершённой установки зависимостей в его кэшированной копии. О случаях, когда эта повторная попытка выполняется или пропускается, см. Перечисленные пакеты не установлены. Если повторная попытка не удаётся, выходные данные — Failed to update plugin "formatter@my-marketplace" с причиной, и код выхода — 1. До v2.1.287 команда сообщала, что плагин находится на последней версии, не повторяя попытку установки.

​
plugin list

Выведите список установленных плагинов с их версией, областью действия и статусом.
Claude Code группирует читаемый выход по тому, как загружается каждый плагин:
  • Installed plugins:: плагины, которые вы установили из маркетплейса
  • Session-only plugins (--plugin-dir / --plugin-url):: плагины, загруженные этими флагами в той же команде, как в claude --plugin-dir ./my-plugin plugin list
  • Skills-directory plugins (.claude/skills/*):: плагины, которые Claude Code нашёл в каталоге skills
  • Synced from claude.ai: плагины, синхронизированные с вашей учётной записью claude.ai
Когда в любой группе ничего нет, Claude Code выводит 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. Покажите, что вносит установленный плагин:
Claude Code выводит имя плагина, версию, описание и источник, затем эти разделы:
  • Component inventory: скиллы, агенты, хуки, MCP-серверы и LSP серверы плагина
  • Projected token cost: всегда включённые токены, которые плагин добавляет в каждую сессию
  • Per-component (rounded): оценки всегда включённых и при вызове для каждого скилла, агента и команды. Пропускается, когда плагин не имеет ни одного
Для того, что означают две цифры стоимости, см. Измерение стоимости и использования плагина. Для плагина, который не загружен, Claude Code выводит Plugin "formatter" not found. Run `claude plugin list` to see installed plugins, or pass --plugin-dir <path> to load one from disk. и выходит с кодом 1.

​
plugin configure

Покажите опции userConfig установленного плагина и какие из них установлены, или сохраните значения, переданные на stdin. Требует Claude Code v2.1.285 или позже.
Без флагов команда выводит список каждой опции с до трёх ярлыков: required или optional, затем sensitive для опции, которую манифест объявляет чувствительной, затем set или not set. Она не выводит сохранённые значения. С --json выходные данные включают сохранённые значения опций, которые не чувствительны, и никогда текст чувствительной. Чтобы сохранить значения, запишите их в файл как JSON объект, который отображает ключи опций на строковые значения, затем передайте файл на stdin. Замените formatter@my-marketplace на id вашего собственного плагина, как показывает claude plugin list. Этот пример устанавливает одну опцию с именем api_url из файла values.json, который содержит {"api_url": "https://example.com"}:
Claude Code проверяет каждое значение против объявленного типа опции и выводит Configuration saved. Restart Claude Code to apply it. Если вы передаёте ключ, который манифест не объявляет, или значение, которое не проходит проверку, команда ничего не сохраняет, выводит Failed to save configuration: с причиной и выходит с кодом 1. С --json отклонённое значение также выводит объект на stdout, чьё поле refused содержит message и, когда одна опция виновата, её ключ option. Передайте полный id плагина name@marketplace, как показывает claude plugin list. configure не принимает простое name. Когда ни один загруженный плагин не имеет этот id, команда выводит No installed plugin has the id "<plugin>". и выходит с кодом 1. Для настроек упакованного MCP-сервера см. plugin install --config или элемент Configure в /plugin.

​
plugin prune

Удалите автоустановленные зависимости, которые больше не нужны ни одному установленному плагину. Команда никогда не удаляет плагин, который вы установили сами. autoremove — это псевдоним для prune.
Предпросмотрите то, что удалила бы очистка:
Claude Code выводит список сиротских зависимостей и заканчивается с (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
Поместите target перед --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.
Запустите команду из корневой папки плагина, каталога, который содержит .claude-plugin/plugin.json или SKILL.md скилла. Чтобы создать каркас набора в другом каталоге специально, передайте --eval-dir. В терминале команда открывает интерактивную сессию Claude Code для интервью авторства. В интервью Claude делает следующее:
  1. Читает плагин
  2. Спрашивает вас, что он должен делать хорошо
  3. Предлагает случаи и оценщиков
  4. Записывает файлы случаев
  5. Запускает случаи и проверяет оценки с вами, чтобы убедиться, что оценщики оценивают так, как вы бы оценили
С --bare или без терминала команда записывает пустой шаблон одного случая вместо этого. Когда Claude запускает команду изнутри сессии Claude Code, команда выводит инструкции интервью, которым должна следовать эта сессия, а не записывает шаблон. Необязательный name — это имя случая. Это требуется с --bare или без терминала, потому что команда записывает пустой шаблон для этого случая. Имя случая начинается с буквы или цифры и содержит только буквы, цифры, ., _ и -. На каждой платформе команда также отклоняет имена, которые Windows не может хранить, такие как con или имя, заканчивающееся на .. Команда принимает эти опции:

​
plugin tag

Создайте аннотированный git тег с именем <name>--v<version> для выпуска плагина. Перед тегированием команда проверяет, что plugin.json плагина и любая запись маркетплейса, которая его выводит, согласны по версии. Для того, когда тегировать выпуск, см. Публикация плагина.
[path] — это каталог плагина, по умолчанию текущий каталог. Команда находит запись маркетплейса, поднимаясь от этого каталога к .claude-plugin/marketplace.json, который выводит плагин. Предпросмотрите тег для плагина в проверке маркетплейса:
Claude Code выводит план:
  • Имя плагина
  • Версию и из какого файла она взята
  • Соответствующую запись маркетплейса, когда она есть
  • Имя тега
  • Команды git tag и git push, которые он запустил бы
Без --dry-run Claude Code выводит Created tag formatter--v1.0.0 и либо Pushed to origin, либо команду push для запуска самостоятельно. Если push не выполняется, тег всё ещё создаётся локально и команда выходит с ошибкой. Команда выходит с кодом 1 и выводит причину, когда не может безопасно тегировать. Распространённые причины:
  • Нет version в plugin.json или записи маркетплейса
  • Тег уже существует
  • Рабочее дерево грязное

​
plugin test

Запустите тесты для мода — плагина, код которого регистрирует обработчики событий. Команде не нужны сессия, вход в систему или сеть. О том, как написать тест, см. Тестирование мода.
[directory] — это каталог мода, по умолчанию текущий каталог. Команда запускает каждый файл в нём, имя которого заканчивается на .test.ts или .test.tsx, и выходит с кодом 1, когда тест не проходит. Запустите тесты для мода в ./first-mod:

​
plugin validate

Проверьте манифест плагина, манифест маркетплейса или скиллы, агентов и команды в каталоге, и выходите с кодом, на который может действовать задача 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
Когда каталог содержит и .claude-plugin/marketplace.json, и .claude-plugin/plugin.json, Claude Code проверяет маркетплейс, а также манифест и файлы компонентов плагина. Это требует Claude Code v2.1.289 или позже. Claude Code не следует символическим ссылкам внутри названного вами каталога. То, что он делает, зависит от того, где находится ссылка:
  • Связанный каталог 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 не открывает файлы скиллов, агентов, команд или хуков плагинов, которые маркетплейс перечисляет в других каталогах, или файлы MCP-серверов, которые они включают. Чтобы найти ошибки в этих файлах, проверьте каждый каталог плагина

​
Выход и коды выхода

Claude Code выводит файл, который он проверил, любые ошибки и предупреждения с их путями, и строку вердикта. Код выхода следует вердикту: С --json Claude Code записывает отчёт на stdout как один JSON объект с этими полями верхнего уровня:
  • success: тот же вердикт, который даёт код выхода
  • strict: рассматривал ли запуск предупреждения как ошибки
  • target: разрешённый путь, который Claude Code проверил
  • manifest: собственный результат манифеста или null для запуска без манифеста
  • contents: результаты для каждого файла, каждый называет свой file и содержит массивы errors, warnings и notes
    • gatingHooks: есть ли у каждого хука мода, который может отклонить действие, например хука tool.call, обработчик .catch. Каждый элемент содержит module, pattern, hook и hasCatch. Требует Claude Code v2.1.290 или позже
При выходе 2 команда ничего не записывает на stdout. Сообщение об ошибке идёт на stderr.

​
Команды claude plugin marketplace

Запустите claude plugin marketplace <subcommand> из вашей оболочки, чтобы добавить, вывести, обновить и удалить маркетплейсы, из которых вы устанавливаете плагины.
  • Коды выхода: эти подкоманды следуют соглашению кода выхода команд плагина
  • Области действия: их флаг --scope не имеет короткой формы -s
Чтобы узнать, что такое маркетплейс и как Claude Code его кэширует, см. Справочник загрузки плагинов.

​
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. Добавьте маркетплейс и поделитесь им с проектом:
Claude Code выводит 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:// или использовать локальный путь
Добавьте маркетплейс, размещённый на claude.ai, по имени, выведенному в разделе 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 не имеет локального клона, поэтому его запись вместо installLocation содержит его идентификаторы claude.ai — marketplaceId и organizationUuid. Она также содержит scope, если он записан, и status. Если ваши сессии терминала синхронизируют плагины с вашей учётной записью claude.ai, текстовый список заканчивается разделом From claude.ai:. В этом разделе перечислены маркетплейсы, которые claude.ai указывает для вашей учётной записи, но которые вы не добавили, — как основанные на git, так и размещённые. Для этого требуется Claude Code v2.1.273 или позже. Чтобы добавить маркетплейс из этого раздела, см. Добавление маркетплейса с claude.ai. Вывод --json охватывает только настроенные маркетплейсы и не включает этот раздел.

​
plugin marketplace remove

Удалите объявление маркетплейса из ваших настроек. rm — псевдоним для remove.
Когда вы удаляете маркетплейс из последней области действия, которая его объявляет, Claude Code также удаляет его кэш и удаляет каждый плагин, который вы из него установили. Он также удаляет их сохранённые параметры и секреты и данные, где это возможно.Чтобы обновить маркетплейс без потери его плагинов, вместо этого запустите plugin marketplace update.
<name> — это имя маркетплейса, которое показывает plugin marketplace list, а не источник, который вы передали в add. Удалите маркетплейс из всех областей действия:
Claude Code выводит Successfully removed marketplace: your-marketplace. Когда команда удаляет плагины, выходные данные перечисляют их под строкой вроде Also uninstalled 2 plugins from this marketplace:. Чтобы снова использовать один из них, добавьте маркетплейс обратно и переустановите плагин. Если вы ограничите команду файлом настроек, который не объявляет маркетплейс, команда завершится ошибкой Marketplace 'your-marketplace' is not declared in project settings. Omit --scope to remove it from all scopes.

​
plugin marketplace update

Обновите один маркетплейс или все маркетплейсы из их источника, чтобы получить новые плагины и версии. Маркетплейс, добавленный с веткой или тегом ref, обновляется до последнего коммита этого ref, а не ветки репозитория по умолчанию.
Обновите один маркетплейс:
Claude Code выводит Successfully updated marketplace: your-marketplace. Если вы не указываете имя, он выводит количество, например Successfully updated 2 marketplaces.

​
/plugin в сеансе

Внутри интерактивного сеанса /plugin открывает панель плагина. Каждая подкоманда открывает панель на вкладке, запускает действие там или выводит результат встроенно. /plugins и /marketplace — это псевдонимы для /plugin. Вы можете запускать эти команды только в интерактивном сеансе терминала. В неинтерактивном запуске, таком как claude -p, Claude Code отвечает, что /plugin недоступен в этой среде. Для того, какие поверхности имеют /plugin, как установить без него и что показывает каждая вкладка панели, см. Установка и управление плагинами. <plugin> — это name плагина или name@marketplace. Таблица ниже выводит каждую форму сессии. Подкоманды оболочки init, update, details, prune, eval, eval init и test не имеют формы сессии. Если вы называете плагин, который не установлен в текущем проекте в /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 показывает его только когда тот же флаг предшествует подкоманде, как в claude --plugin-dir ./my-plugin plugin list. Плагин отображается как <name>@inline под заголовком, который начинается с Session-only plugins, и --json сообщает его scope как session. Когда плагин только для сеанса имеет одно и то же имя с установленным плагином, Claude Code загружает копию только для сеанса для этого сеанса и пропускает установленную. Установленная копия загружается вместо этого, если вы отключили копию только для сеанса с claude plugin disable <name>@inline, или если управляемые параметры блокируют это имя плагина. Для приоритета см. Справочник загрузки плагинов. Администратор может отклонить оба флага и папки, названные в переменной CLAUDE_CODE_PLUGIN_DIRS, с управляемым параметром disableSideloadFlags. Claude Code затем выводит, что флаг отключён управляемыми параметрами вашей организации, и выходит с кодом 1 без запуска. Из Agent SDK опция plugins — это эквивалент --plugin-dir.

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