Skip to main content
Ejecuta comandos de plugins ya sea como claude plugin desde tu shell o un script, o como /plugin y /reload-plugins dentro de una sesión de Claude Code. Esta referencia proporciona las banderas, valores predeterminados, salida y códigos de salida de cada comando, junto con las dos banderas que cargan un plugin para una sesión. Ejecuta claude plugin --help en tu compilación para confirmar qué subcomandos tiene tu versión.
Estos casos se cubren en otras páginas:

​
Comandos claude plugin

Ejecuta claude plugin <subcommand> desde tu shell o un script, fuera de una sesión de Claude Code. Estos subcomandos instalan y gestionan plugins sin abrir el panel /plugin. claude plugins es un alias para claude plugin. Cada subcomando comparte estos códigos de salida, argumentos de plugins y valores de ámbito:
  • Códigos de salida: 0 en caso de éxito y 1 en caso de fallo. validate añade salida 2 para un error inesperado, y eval añade los códigos listados en su sección.
  • Argumentos de plugins: un argumento <plugin> es un name de plugin o name@marketplace. Cuando dos marketplaces ofrecen el mismo nombre, usa la forma calificada.
  • Ámbitos: --scope toma user, project o local, y nombra el archivo de configuración al que escribe el comando. update también toma managed.

​
plugin init

Crea un nuevo plugin en ~/.claude/skills/<name>/. Se carga en tu próxima sesión como <name>@skills-dir sin necesidad de un paso de instalación. new es un alias para init. Para el flujo de trabajo de crear, probar y editar que comienza con este comando, consulta Crear un plugin.
<name> se convierte en el nombre del directorio bajo ~/.claude/skills/ y el name del plugin en su manifiesto. El comando no tiene una bandera para otra ubicación. Para crear un scaffold dentro de un proyecto, consulta Crear un plugin. Crea un plugin con archivos de skill y hook de inicio:
Claude Code valida lo que escribió e imprime Created plugin "my-helper" at ~/.claude/skills/my-helper, seguido del id con el que se carga y el comando claude plugin disable que lo desactiva. Claude Code sale con 1 sin escribir cuando no puede crear un scaffold de forma segura, y el mensaje nombra la razón. Estas son razones comunes:
  • Un valor desconocido de --with
  • Un scaffold existente en el destino sin --force
  • Una configuración gestionada que bloquea plugins de directorio de skills

​
plugin install

Instala un plugin desde un marketplace que hayas añadido. i es un alias para install.
La mayoría de los plugins se instalan sin un aviso. Para un plugin cuya entrada de marketplace ejecuta un comando para instalarlo o establece un headersHelper para su descarga, Claude Code primero imprime el comando y pregunta Run this command now? [y/N]. Pasa -y desde tu propia terminal para aceptar el comando mostrado sin el aviso. Aquí está lo que sucede sin un TTY y cuando Claude ejecuta el comando:
  • stdin o stdout no es un TTY, y no pasas ni -y ni --accept-command: la instalación se rechaza. La salida dice que el comando solo se mostró, y el código de salida es 1
  • Claude ejecuta el comando a través de su herramienta Bash: -y se ignora. Ejecuta el comando desde tu propia terminal en su lugar
Instala un plugin para todos los que clonan el proyecto:
Claude Code imprime Successfully installed plugin: formatter@my-marketplace (scope: project). Cuando nada nuevo se instala, la salida dice por qué:
  • Ya instalado en ese ámbito: la salida es Plugin "formatter@my-marketplace" is already installed (scope: project) y el código de salida es 0
  • Rechazas un aviso de origen de comando: la salida es Aborted. y el código de salida es 1
  • Rechazas un aviso de headersHelper, o no se puede confirmar sin un TTY: la salida es Aborted — the command was not run. y el código de salida es 1

​
Formato de resultado JSON

Cuando pasas --json a plugin install, la última línea de stdout es un objeto JSON. Analiza solo esa línea, porque Claude Code imprime cualquier comando que declare el marketplace antes de ella. Tres campos siempre están presentes:
  • command: el subcomando que se ejecutó, como install
  • outcome: ok o failed
  • message: una descripción legible por humanos del resultado
Otros campos, como pluginId, scope y failureCode, aparecen solo cuando aplican. Un error de uso, como un --scope inválido, no imprime ninguna línea de resultado y sale con 1 con la razón en stderr.

​
Aceptar un comando de instalación mostrado

Cuando una ejecución de --json muestra un comando declarado por el marketplace y no lo ejecuta, el resultado failed también lleva un objeto shownCommand. Sus campos incluyen el comando tal como se mostró, el plugin al que pertenece, y el sha256 del comando. Para aceptar exactamente ese comando, vuelve a ejecutar con ese sha256 como --accept-command desde tu propia terminal, porque la bandera no tiene efecto dentro de una sesión de Claude Code. Requiere Claude Code v2.1.271 o posterior. El sha256 cuenta como aceptación para exactamente ese comando, plugin y catálogo de marketplace. Si alguno de ellos cambió desde que se mostró el comando, Claude Code no acepta el sha256 y muestra el comando nuevamente. Un cambio que la actualización del marketplace de la propia ejecución obtiene también cuenta como tal cambio. Si shownCommand.acceptCommandMatched es false, el sha256 que pasaste no coincide con el comando ahora mostrado. Revisa ese comando antes de volver a ejecutar con su sha256.

​
plugin uninstall

Elimina un plugin instalado de un ámbito. remove y rm son alias para uninstall.
Desinstala un plugin del ámbito del proyecto:
Claude Code imprime Successfully uninstalled plugin: formatter (scope: project). Cuando el plugin no está instalado en ese ámbito, el comando imprime una línea que comienza con Failed to uninstall plugin "formatter@my-marketplace": y sale con 1.

​
plugin enable

Habilita un plugin deshabilitado. Para un plugin sincronizado desde claude.ai, pasa <name>@synced como el plugin.
Sin --scope, el comando verifica tus archivos de configuración en el orden local, proyecto, usuario, y usa el primer ámbito que menciona el plugin. Si pasas un --scope donde el plugin no está declarado, el comando escribe una anulación o falla:
  • Un ámbito que tiene precedencia sobre el que lo declara: Claude Code escribe una anulación en el ámbito que pasaste. Por ejemplo, claude plugin disable formatter --scope local desactiva un plugin habilitado en el proyecto solo para ti
  • Cualquier otro ámbito: el comando falla con Plugin "formatter" is installed at project scope, not user. Use --scope project or omit --scope to auto-detect.
Si el plugin ya está habilitado en el ámbito resuelto, el comando imprime Plugin "formatter" is already enabled y sale con 1. Con --json, el resultado tiene "failureCode": "already_in_goal_state" y "alreadyInGoalState": true, para que un script pueda tratar ese caso como éxito. Cuando el plugin declara dependencias, Claude Code también las habilita. El comando falla en estos casos:
  • Una dependencia no está instalada: enable falla e imprime el comando claude plugin install para cada dependencia faltante
  • Una dependencia está bloqueada por la política de plugins de tu organización: enable falla y nombra la dependencia bloqueada
  • Una dependencia está establecida en false en un ámbito con mayor precedencia que el ámbito de destino: enable falla. Habilita la dependencia en ese ámbito, o pasa --scope para escribir allí
Vuelve a habilitar un plugin dondequiera que esté declarado:
Claude Code imprime Successfully enabled plugin: formatter (scope: project), nombrando el ámbito que detectó.

​
plugin disable

Deshabilita un plugin sin desinstalarlo. Para un plugin sincronizado desde claude.ai, pasa <name>@synced como el plugin.
Sin --scope, el ámbito se auto-detecta en el mismo orden local, proyecto, usuario que plugin enable. Si no pasas ni un nombre de plugin ni --all, Claude Code imprime Please specify a plugin name or use --all to disable all plugins y sale con 1. Deshabilitar un plugin que ya está deshabilitado imprime Plugin "formatter" is already disabled y sale con 1, como plugin enable hace para un plugin ya habilitado. El comando falla para un plugin que aún es requerido:
  • Otro plugin habilitado depende de él: el comando falla y nombra los dependientes a deshabilitar primero
  • Tu organización lo requiere como un plugin sincronizado: el comando falla y no guarda nada
Deshabilita un plugin:
Claude Code imprime Successfully disabled plugin: formatter (scope: project).

​
plugin update

Actualiza un plugin a la última versión que su marketplace ofrece. La nueva versión se carga en tu próxima sesión, o después de ejecutar /reload-plugins en una en ejecución.
managed es el único ámbito que puedes actualizar pero no instalar. Para plugins instalados por administrador, consulta Gestionar plugins para tu organización. Actualiza un plugin:
Claude Code imprime Checking for updates for plugin "formatter@my-marketplace"…, luego el resultado. Cuando nada es más nuevo, imprime formatter is already at the latest version (1.0.0). y sale con 0. Puedes pasar un nombre de plugin simple, que el comando coincide contra tus plugins instalados. Cuando plugins instalados de diferentes marketplaces comparten el nombre, el comando rechaza la actualización y lista los comandos plugin-name@marketplace-name calificados a ejecutar en su lugar. Actualizar por nombre simple requiere Claude Code v2.1.246 o posterior.

​
plugin list

Lista plugins instalados con su versión, ámbito y estado.
Claude Code agrupa la salida legible por humanos por cómo se carga cada plugin:
  • Installed plugins:: plugins que instalaste desde un marketplace
  • Session-only plugins (--plugin-dir / --plugin-url):: plugins cargados por esas banderas en el mismo comando, como en claude --plugin-dir ./my-plugin plugin list
  • Skills-directory plugins (.claude/skills/*):: plugins que Claude Code encontró en un directorio de skills
  • Synced from claude.ai: plugins sincronizados desde tu cuenta claude.ai
Sin nada en ningún grupo, Claude Code imprime No plugins installed. Use `claude plugin install` to install a plugin.

​
Salida JSON

Con --json, Claude Code imprime un array con un objeto por instalación. Cada objeto lleva los campos a continuación. id, version, scope, enabled e installPath siempre están presentes, y los otros aparecen solo cuando aplican. Con --json --available, Claude Code imprime un objeto en lugar de un array. Su campo installed contiene el array de objetos de plugin instalado, y su campo available contiene un objeto por plugin de marketplace no instalado con los campos a continuación.

​
plugin details

Muestra el inventario de componentes de un plugin y su costo de token proyectado. El plugin debe estar cargado: instalado, encontrado en un directorio de skills, o pasado con --plugin-dir o --plugin-url en el mismo comando. El <name> es un name de plugin o name@marketplace.
El comando no toma banderas más allá de --help. Muestra lo que contribuye un plugin instalado:
Claude Code imprime el nombre, versión, descripción y fuente del plugin, luego estas secciones:
  • Component inventory: los skills, agents, hooks, servidores MCP y servidores LSP del plugin
  • Projected token cost: los tokens siempre activos que el plugin añade a cada sesión
  • Per-component (rounded): estimaciones siempre activas y bajo invocación para cada skill, agent y comando. Se omite cuando el plugin no tiene ninguno
Para lo que significan las dos figuras de costo, consulta Medir costo y uso de plugins. Para un plugin que no está cargado, Claude Code imprime Plugin "formatter" not found. Run `claude plugin list` to see installed plugins, or pass --plugin-dir <path> to load one from disk. y sale con 1.

​
plugin prune

Elimina dependencias auto-instaladas que ningún plugin instalado necesita más. El comando nunca elimina un plugin que instalaste tú mismo. autoremove es un alias para prune.
Previsualiza lo que un prune eliminaría:
Claude Code lista las dependencias huérfanas y termina con (dry run — nothing removed). Sin nada a eliminar, imprime una línea que comienza con Nothing to prune. Sin --dry-run, el comando elimina las dependencias huérfanas solo después de que confirmes en el aviso o pases -y. El código de salida es 0 sin importar lo que respondas en el aviso. Lo que prune hace depende de si una terminal está adjunta y si pasas -y:

​
plugin eval

Ejecuta los casos eval de un plugin e informa resultados puntuados. Requiere Claude Code v2.1.269 o posterior. Cada caso es un prompt más calificadores. Claude Code lo ejecuta varias veces en una sesión aislada con solo el plugin de destino cargado, y por defecto también sin el plugin para que el informe muestre la diferencia. Consulta Probar plugins con evals para el formato de caso, calificadores, resultados y uso de CI.
El target opcional por defecto es el directorio actual y toma cualquiera de estas formas:
  • Un directorio de plugin
  • Un archivo único prompt.md o case.yaml
  • Un plugin instalado como name o name@marketplace
  • name@skills-dir
Pon el target antes de --tag, --allow-tools y --json. Cada una de estas opciones toma las palabras que la siguen como su valor, por lo que un target escrito después de una de ellas se lee como una etiqueta, un nombre de herramienta o la ruta de salida JSON en su lugar del target. Esta tabla lista las opciones que la mayoría de ejecuciones usan. Ejecuta claude plugin eval --help para el conjunto completo, incluyendo --case, --tag, --output-dir, --report, --allow-real-servers, --keep-temp y --verbose. El código de salida informa cómo terminó la ejecución. Para actuar sobre él en un pipeline, consulta Ejecutar evals en CI.

​
plugin eval init

Crea un conjunto eval para el plugin en el directorio actual. Requiere Claude Code v2.1.269 o posterior. Consulta Crear tu primer conjunto eval.
En una terminal, el comando abre una sesión interactiva de Claude Code para una entrevista de autoría. En la entrevista, Claude hace lo siguiente:
  1. Lee el plugin
  2. Te pregunta qué debería hacer bien
  3. Propone casos y calificadores
  4. Escribe los archivos de caso
  5. Ejecuta los casos y revisa las calificaciones contigo para verificar que los calificadores puntúen de la forma que lo harías
Con --bare, o sin una terminal, el comando escribe una plantilla de caso único en blanco en su lugar. Cuando Claude ejecuta el comando desde dentro de una sesión de Claude Code, el comando imprime las instrucciones de entrevista para que esa sesión siga en su lugar de escribir una plantilla. El name opcional es un nombre de caso. Es requerido con --bare o sin una terminal, porque el comando escribe la plantilla en blanco para ese caso. La entrevista no necesita uno. El comando acepta estas opciones:

​
plugin tag

Crea una etiqueta git anotada nombrada <name>--v<version> para una versión de plugin. Antes de etiquetar, el comando verifica que el plugin.json del plugin y cualquier entrada de marketplace que lo liste estén de acuerdo en la versión. Para cuándo etiquetar una versión, consulta Publicar un plugin.
El [path] es el directorio del plugin, por defecto el directorio actual. El comando encuentra la entrada de marketplace caminando hacia arriba desde ese directorio a un .claude-plugin/marketplace.json que lista el plugin. Previsualiza la etiqueta para un plugin en un checkout de marketplace:
Claude Code imprime el plan:
  • El nombre del plugin
  • La versión y de qué archivo vino
  • La entrada de marketplace coincidente, cuando hay una
  • El nombre de la etiqueta
  • Los comandos git tag y git push que ejecutaría
Sin --dry-run, Claude Code imprime Created tag formatter--v1.0.0 y ya sea Pushed to origin o el comando push a ejecutar tú mismo. Si el push falla, la etiqueta aún se crea localmente y el comando sale con un error. El comando sale con 1 e imprime la razón cuando no puede etiquetar de forma segura. Las razones comunes son:
  • Sin version en plugin.json o la entrada de marketplace
  • La etiqueta ya existe
  • El árbol de trabajo está sucio

​
plugin validate

Valida un manifiesto de plugin, un manifiesto de marketplace, o los skills, agents y comandos en un directorio, y sale con un código en el que un trabajo de CI puede actuar. Para el flujo de trabajo de crear, probar y editar, consulta Crear un plugin. Para lo que el validador verifica en cada manifiesto, consulta la referencia de manifiesto de plugin y la referencia de marketplace.
Valida un plugin antes de confirmarlo:

​
Validar un directorio

El <path> es un archivo de manifiesto o un directorio. Dado un directorio, Claude Code elige qué validar por lo que encuentra allí:
  • .claude-plugin/marketplace.json, cuando existe
  • Si no .claude-plugin/plugin.json
  • Si no los archivos de componentes, elegidos por el nombre del directorio. Validar archivos de componentes sin un manifiesto requiere Claude Code v2.1.233 o posterior:
    • Un directorio nombrado skills, agents o commands: los archivos dentro de él
    • Un directorio nombrado .claude: los directorios skills, agents y commands dentro de él
    • Cualquier otro directorio: esos tres directorios bajo su .claude
Claude Code no sigue enlaces simbólicos dentro del directorio que nombras. Lo que hace depende de dónde esté el enlace:
  • Un directorio skills, agents o commands enlazado bajo la raíz del plugin o .claude: Claude Code advierte que nada en él fue leído.
  • Una entrada enlazada dentro de un directorio skills, agents o commands: Claude Code la omite y advierte, por directorio, cuántas entradas omitió que una sesión cargaría.
  • El directorio skills, agents o commands que nombras es en sí mismo un enlace simbólico, o su directorio padre .claude es: Claude Code reporta un error y no verifica nada en él. Nombra el directorio real en su lugar.
Algunos archivos no son leídos por una ejecución de validación:
  • Un SKILL.md en la raíz del plugin: cuando ejecutas claude plugin validate contra un directorio de plugin, Claude Code no verifica un SKILL.md en la raíz del plugin
  • Un CLAUDE.md en la raíz del plugin: en una ejecución de plugin, Claude Code también advierte sobre un CLAUDE.md en la raíz del plugin
  • Archivos de plugin en una ejecución de marketplace: desde un directorio de marketplace, Claude Code no abre los archivos de skill, agent, comando o hook de los plugins. Para encontrar errores en esos archivos, valida cada directorio de plugin

​
Salida y códigos de salida

Claude Code imprime el archivo que validó, cualquier error y advertencia con sus rutas, y una línea de veredicto. El código de salida sigue el veredicto: Con --json, Claude Code escribe el informe a stdout como un objeto JSON con estos campos de nivel superior:
  • success: el mismo veredicto que el código de salida da
  • strict: si la ejecución trató advertencias como errores
  • target: la ruta resuelta que Claude Code validó
  • manifest: el resultado del propio manifiesto, o null para una ejecución sin manifiesto
  • contents: resultados por archivo, cada uno nombrando su file y llevando arrays errors, warnings y notes
En salida 2, el comando no escribe nada a stdout. El mensaje de error va a stderr.

​
Comandos claude plugin marketplace

Ejecuta claude plugin marketplace <subcommand> desde tu shell para añadir, listar, actualizar y eliminar los marketplaces desde los que instalas plugins.
  • Códigos de salida: estos subcomandos siguen la convención de código de salida de los comandos de plugin
  • Ámbitos: su bandera --scope no tiene forma corta -s
Para qué es un marketplace y cómo Claude Code lo cachea, consulta Referencia de carga de plugins.

​
plugin marketplace add

Añade un marketplace desde un repositorio de GitHub, una URL de git, un marketplace.json alojado, o una ruta local, y decláralo en un archivo de configuración. Después de añadirlo, Claude Code instala cualquier dependencia que tus plugins instalados estaban perdiendo.
<source> toma cualquiera de las formas en la tabla a continuación, y su forma decide el tipo de fuente y cómo Claude Code obtiene el marketplace. Para el objeto de fuente resultante, consulta la referencia de marketplace. Para un host cuyas URLs de clonación no llevan el sufijo .git, como AWS CodeCommit, añade el marketplace como una entrada de git en extraKnownMarketplaces en su lugar. Claude Code clona una entrada de git sin importar si su URL termina en .git. Claude Code también clona una URL de gitlab.com con subgrupos anidados, como https://gitlab.com/group/subgroup/project. Añade un marketplace y compártelo con el proyecto:
Claude Code imprime Successfully added marketplace: your-marketplace (declared in project settings), usando el name del propio manifiesto del marketplace. Una adición repetida o una fuente inválida imprime uno de estos resultados en su lugar:
  • Marketplace ya en disco: la salida es Marketplace 'your-marketplace' already on disk — declared in project settings y el código de salida es 0
  • Fuente no reconocida: la salida es Invalid marketplace source format. Try: owner/repo, https://..., or ./path y el código de salida es 1
  • Host simple como gitlab.example.com/team/plugins: la adición falla como un atajo owner/repo inválido, y el mensaje te dice que añadas https:// o uses una ruta local
Añade un marketplace alojado en claude.ai por el nombre impreso en la sección From claude.ai: de claude plugin marketplace list:
Con --claudeai, el comando rechaza --scope y --sparse. El marketplace está alojado para tu cuenta, no declarado en un archivo de configuración, por lo que no puedes compartirlo a través del .claude/settings.json de un proyecto.

​
plugin marketplace list

Lista cada marketplace que has añadido, con su fuente.
Claude Code imprime Configured marketplaces: y una línea Source: por marketplace, o No marketplaces configured. Con --json, Claude Code imprime un array con un objeto por marketplace, llevando los campos a continuación. Cada campo es una string. Un marketplace de claude.ai añadido no tiene un clon local, por lo que su entrada lleva sus identificadores de claude.ai, marketplaceId y organizationUuid, en su lugar de installLocation. También lleva scope cuando uno se registra, y status. Si tus sesiones de terminal sincronizan plugins desde tu cuenta claude.ai, el texto listado termina con una sección From claude.ai:. Esa sección nombra los marketplaces que claude.ai lista para tu cuenta que no has añadido, tanto basados en git como alojados. Requiere Claude Code v2.1.273 o posterior. Para añadir un marketplace de esa sección, consulta Añadir un marketplace desde claude.ai. La salida de --json cubre solo marketplaces configurados y deja la sección fuera.

​
plugin marketplace remove

Elimina la declaración de un marketplace de tu configuración. rm es un alias para remove.
Cuando eliminas un marketplace del último ámbito que lo declara, Claude Code también elimina su caché y desinstala cada plugin que instalaste desde él. Sin --scope, el comando elimina la declaración de cada ámbito. Para actualizar un marketplace sin perder sus plugins, ejecuta plugin marketplace update en su lugar.
El <name> es el nombre del marketplace que plugin marketplace list muestra, no la fuente que pasaste a add. Elimina un marketplace de cada ámbito:
Claude Code imprime Successfully removed marketplace: your-marketplace, añadiendo (from project settings) cuando lo limitaste. Si limitas a un archivo de configuración que no declara el marketplace, el comando falla con Marketplace 'your-marketplace' is not declared in project settings. Omit --scope to remove it from all scopes.

​
plugin marketplace update

Actualiza un marketplace, o cada marketplace, desde su fuente para obtener nuevos plugins y versiones. Un marketplace añadido con una rama o etiqueta ref se actualiza al último commit de esa ref, no la rama predeterminada del repositorio.
El comando no toma banderas más allá de --help. Actualiza un marketplace:
Claude Code imprime Successfully updated marketplace: your-marketplace. Cuando omites el nombre, imprime un recuento como Successfully updated 2 marketplaces. Sin marketplaces añadidos, imprime No marketplaces configured y sale con 0.

​
/plugin en una sesión

Dentro de una sesión interactiva, /plugin abre el panel de plugins. Cada subcomando abre el panel en una pestaña, ejecuta una acción allí, o imprime un resultado en línea. /plugins y /marketplace son alias para /plugin. Solo puedes ejecutar estos comandos en una sesión de terminal interactiva. En una ejecución no interactiva como claude -p, Claude Code responde que /plugin no está disponible en este entorno. Para qué superficies tienen /plugin, cómo instalar sin él, y qué muestra cada pestaña del panel, consulta Instalar y gestionar plugins. Un <plugin> es un name de plugin o name@marketplace. La tabla a continuación lista cada forma de sesión. Los subcomandos de shell init, update, details, prune, eval y eval init no tienen forma de sesión. Si nombras un plugin que no está instalado en el proyecto actual en /plugin enable, disable, uninstall o configure, Claude Code imprime Plugin "<plugin>" is not installed in this project en su lugar de actuar.

​
/reload-plugins

Aplica cambios de plugins pendientes a la sesión en ejecución sin reiniciarla. Los cambios pendientes son plugins que instalaste, actualizaste, habilitaste, deshabilitaste o editaste en disco desde que comenzó la sesión. Cuando cierras el panel /plugin con cambios pendientes que hiciste en él, Claude Code ejecuta /reload-plugins para ti. Ejecútalo tú mismo después de cambios de plugins que suceden fuera del panel, como un comando claude plugin que ejecutaste en otra terminal.

​
Resumen de recarga

Claude Code recarga cada plugin activo e imprime una línea de resumen, Reloaded: N plugins · N skills · N agents · N hooks · N plugin MCP servers · N plugin LSP servers, omitiendo el recuento de servidor MCP de plugin en una sesión sin una terminal interactiva. Cuando algún plugin falló, el resumen añade N errors during load. Run /plugin for details. El recuento de skills cubre cada skill que proporciona un plugin, tanto sus entradas de commands/ como sus skills de SKILL.md. El recuento de agents es el número de agents cargados en la sesión, incluyendo los que no vienen de plugins. Cuando las dependencias de un plugin recargado están faltando, Claude Code las instala, recarga de nuevo, y añade (+ N dependencies: <names>) resolved al resumen.

​
Recargas que cambian herramientas MCP

Cuando la recarga añadiría o eliminaría un servidor MCP de plugin o la herramienta LSP, y ese cambio invalidaría el caché de prompt, Claude Code no aplica la recarga. Imprime una línea como 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. Pasa --force para aplicarla de todas formas.

​
Sesiones sin una terminal interactiva

/reload-plugins también se ejecuta en sesiones sin una terminal interactiva, como la aplicación de escritorio, el Agent SDK, y modo no interactivo con -p. Requiere Claude Code v2.1.260 o posterior. En esas sesiones, el comando se ejecuta solo cuando lo escribes en la sesión tú mismo, como en el prompt de -p o la caja de prompt de la aplicación de escritorio. Cuando llega de otra forma, como a través de Remote Control o un mensaje retransmitido desde Slack, el comando responde /reload-plugins isn't available over a remote connection in this session. y no recarga nada. La recarga en esas sesiones no conecta o desconecta servidores MCP de plugins. Esos cambios toman efecto en tu próxima sesión.

​
Banderas que cargan un plugin para una sesión

Dos banderas de claude cargan un plugin para una sesión solamente, sin instalarlo. Ambas son repetibles. Los autores de plugins las usan para probar un plugin antes de publicarlo. Para el flujo de trabajo de cargar-editar-recargar, consulta Desarrollar sin un marketplace. Un plugin que cualquiera de esas banderas carga es un plugin de solo sesión. claude plugin list lo muestra como <name>@inline con ámbito session, pero solo cuando la misma bandera precede al subcomando. Por ejemplo, ejecuta claude --plugin-dir ./my-plugin plugin list. Cuando un plugin de solo sesión comparte un nombre con un plugin instalado, Claude Code carga la copia de solo sesión para esa sesión y omite la instalada. La copia instalada se carga en su lugar si deshabilitaste la copia de solo sesión con claude plugin disable <name>@inline, o si la configuración gestionada bloquea ese nombre de plugin. Para la precedencia, consulta Referencia de carga de plugins. Un administrador puede rechazar ambas banderas, y carpetas nombradas en la variable CLAUDE_CODE_PLUGIN_DIRS, con la configuración gestionada disableSideloadFlags. Claude Code entonces imprime que la bandera está deshabilitada por la configuración gestionada de tu organización y sale con 1 sin iniciar. Desde el Agent SDK, la opción plugins es el equivalente de --plugin-dir.

​
Próximos pasos