Skip to main content
Utilice esta página cuando un plugin no se cargó, cargó una copia diferente a la que esperaba, o no recogió una actualización, y desea ver qué fuente, ámbito de configuración o archivo en disco decidió eso. Proporciona las reglas que Claude Code aplica cuando comienza una sesión y cada vez que ejecuta /reload-plugins. También puede pedirle a Claude que lea esta página y diagnostique su configuración.
Estos casos se tratan en otras páginas:
Comience con Verificar en qué etapa llegó un plugin para las tres etapas por las que pasa un plugin instalado, o vaya a la sección que coincida con lo que está viendo:

​
Verificar en qué etapa llegó un plugin

Una entrada enabledPlugins se convierte en un plugin que puede usar en etapas: su configuración lo declara, Claude Code lo obtiene en disco, y la sesión en ejecución lo carga. Cuando un plugin no se comporta como sugiere un archivo de configuración, verifique en qué etapa llegó:
  • Declarado, en configuración: enabledPlugins dice qué plugins deben estar activados, y extraKnownMarketplaces dice qué mercados deben existir. Cuando ejecuta claude plugin marketplace add, Claude Code escribe el mercado en extraKnownMarketplaces en su configuración de usuario, así como en disco
  • Obtenido, en disco bajo ~/.claude/plugins/: los registros de lo que Claude Code ha obtenido, y los archivos obtenidos en sí:
    • known_marketplaces.json registra cada mercado que Claude Code ha obtenido, con su source, installLocation, lastUpdated, y autoUpdate. Hay un known_marketplaces.json por usuario, por lo que un mercado que agrega en un proyecto está disponible en cada proyecto
    • installed_plugins.json registra cada instalación con su scope, installPath, y version
    • cache/ contiene los archivos del plugin
  • Cargado, en la sesión en ejecución: el conjunto de plugins que Claude Code cargó al inicio o en el último /reload-plugins. Los cambios en la configuración o en disco no llegan a esta capa hasta que ejecute /reload-plugins o inicie una nueva sesión. Por eso claude plugin update termina con Restart to apply changes. y las actualizaciones en segundo plano le solicitan que ejecute Run /reload-plugins to apply

​
Plugins y mercados que no están en disco al inicio de la sesión

Los plugins se cargan al inicio de la sesión desde installed_plugins.json y la caché sin usar la red. Después de que comienza la sesión, Claude Code verifica los mercados declarados en segundo plano:
  • Un mercado que la configuración declara pero que known_marketplaces.json carece: Claude Code lo clona, luego recarga plugins y descarga plugins habilitados que aún no están en caché
  • Un mercado declarado cuya fuente cambió en la configuración: Claude Code lo vuelve a obtener de la nueva fuente y muestra Plugins changed. Run /reload-plugins to activate.
Un plugin habilitado que ninguna ruta obtuvo y que no tiene un directorio de caché utilizable muestra Plugin "<name>" not cached at <path> en la pestaña Errors de /plugin, y claude plugin list agrega — run /plugin to refresh a la misma línea. Para la solución, consulte Plugin "<name>" not cached at <path>.

​
Encontrar de dónde vino un plugin

Cada plugin tiene un id de la forma <name>@<origin>, que es lo que ve en archivos de configuración y en claude plugin list --json. La parte después de @ le dice dónde Claude Code encontró el plugin: Para un plugin de mercado, <name> es el nombre de entrada en marketplace.json; para @inline y @skills-dir es el name en el manifiesto del plugin. Los nombres de origen en esta tabla están reservados, por lo que ningún mercado puede llamarse inline, skills-dir, o synced.

​
Nombre de entrada y nombre de manifiesto

Un plugin de mercado tiene dos nombres, y pueden diferir:
  • El nombre de entrada en marketplace.json: la clave de instalación y habilitación. Es lo que escribe en enabledPlugins, lo que el directorio de caché se nombra después, y lo que claude plugin list muestra
  • El name en el manifiesto: bajo lo que se espacian los componentes del plugin, y lo que conflictos de nombres comparan

​
Plugins compartidos a través de un repositorio

Para compartir un plugin a través de un repositorio, enumérelo bajo enabledPlugins en .claude/settings.json o colóquelo bajo .claude/skills/. Claude Code no escanea el directorio .claude/plugins/ de un proyecto. Una sesión en la nube no agrega los mercados que un repositorio enumera bajo extraKnownMarketplaces, porque eso requiere el diálogo de confianza del espacio de trabajo, que una sesión en la nube nunca muestra. Un plugin de directorio de habilidades de ámbito de proyecto se carga solo desde el .claude/skills/ del directorio de trabajo principal de la sesión, y solo después de que acepte el diálogo de confianza del espacio de trabajo para esa carpeta. No busca directorios principales hasta la raíz del repositorio de la manera que lo hacen las habilidades y comandos simples. Si inicia desde un subdirectorio, un plugin en la raíz del repositorio no se carga. Inicie desde la raíz del repositorio en su lugar, o mueva la sesión allí con /cd en v2.1.246 o posterior. Un plugin de ámbito de proyecto se verifica en el repositorio y llega a cada colaborador que lo clona. Debido a que ese contenido proviene del repositorio en lugar de usted, se carga solo después de la misma verificación de confianza que se aplica a las reglas de permiso del proyecto en .claude/settings.json. Confiar en una carpeta principal o ejecutar con -p no es suficiente. Los componentes que ejecutan código están restringidos aún más:
  • Los servidores MCP que declara pasan por la misma aprobación por servidor que un .mcp.json del proyecto
  • Los servidores MCP que declara como un paquete MCP, un archivo .mcpb o .dxt, o desde un archivo fuera del directorio del plugin se omiten. Declárelos en línea o en un .mcp.json dentro del directorio del plugin
  • Los monitores en segundo plano no se cargan
Los plugins de ámbito personal no tienen ninguna de estas restricciones. Para saber cómo escribir plugins --plugin-dir y de directorio de habilidades, consulte Crear plugins.

​
Plugins sincronizados desde claude.ai

Un plugin que activa para su cuenta claude.ai también se carga en Claude Code, junto con los plugins que instala desde mercados. Esto incluye plugins que su organización activa para sus miembros. Cada uno de estos plugins se carga como <name>@synced, sin mercado y sin registro de instalación. En sesiones de terminal, las habilidades, agentes, hooks, servidores MCP y servidores LSP de un plugin sincronizado se cargan todos, con la misma confianza que un plugin de mercado que instaló. Para los componentes que carga Cowork, consulte Plugins en claude.ai y en Cowork en claude.com. Los plugins sincronizados se cargan en sesiones de Cowork y en sesiones de terminal donde inicia sesión con su cuenta claude.ai:
  • Cowork: Claude Code los descarga en el entorno propio de la sesión cuando comienza la sesión
  • Sesiones de terminal: cada vez que inicia Claude Code, se sincroniza una vez en segundo plano, descargando plugins nuevos y actualizados y eliminando los que usted u su organización desactivaron. La sincronización en sesiones de terminal requiere Claude Code v2.1.273 o posterior

​
Tiempo de sincronización en sesiones de terminal

Debido a que la sincronización de terminal se ejecuta en segundo plano, puede terminar después de que su sesión haya comenzado. Cuando agrega, actualiza o elimina un plugin sincronizado en una sesión interactiva, ve Plugins changed. Run /reload-plugins to activate. Ejecute /reload-plugins para cargar el cambio en esa sesión, o déjelo para la próxima vez que inicie Claude Code. Si habilita un plugin en claude.ai mientras se ejecuta una sesión, el plugin se descarga la próxima vez que inicie Claude Code.

​
Requisitos de inicio de sesión para sincronización de terminal

En su terminal, los plugins se sincronizan solo en sesiones donde inicia sesión con su cuenta claude.ai. Si inició sesión en una versión anterior de Claude Code, ese inicio de sesión no cubre plugins hasta que Claude Code lo renueve en segundo plano. Para obtener acceso más rápido, ejecute /login nuevamente. La sincronización de plugins comienza la próxima vez que inicia Claude Code.

​
Controlar qué plugins sincronizados se cargan

Puede desactivar plugins sincronizados uno a la vez, excepto un plugin que su organización requiere, o desactivar todos los plugins sincronizados en la máquina:
  • Un plugin: claude plugin disable <name>@synced en su shell y la pestaña Installed de /plugin en una sesión guardan "<name>@synced": false en su enabledPlugins de nivel de usuario. Para mantener el plugin fuera de un proyecto en cada entorno, establezca la misma clave en el .claude/settings.json comprometido del proyecto
  • Todos los plugins sincronizados en una máquina: establezca syncClaudeAiPlugins en false en su configuración de usuario, o su organización lo establece en configuración administrada. Claude Code deja de descargar, y la próxima vez que lo inicie, mueve los plugins que ya sincronizó a ~/.claude/plugins/.trash/ y ya no los carga. Si su organización desactiva Skills en claude.ai, los plugins dejan de sincronizarse también
  • Un plugin que su organización requiere: un plugin que su organización marca como requerido en claude.ai se carga incluso si lo desactivó anteriormente. claude plugin disable lo rechaza con Plugin "<name>@synced" is required by your organization and can't be disabled here. Contact your admin to change it., y claude plugin list lo marca como required by your org
Para eliminar un plugin en claude.ai, consulte Administrar plugins instalados.

​
Encontrar dónde está habilitado un plugin

Puede establecer una entrada enabledPlugins en cualquiera de seis fuentes. La tabla las enumera de menor a mayor precedencia, y a quién se aplica cada una. Para los archivos de configuración en sí, consulte Archivos de configuración y a quién afectan. Estas fuentes se fusionan clave por clave. Para cada id de plugin, el valor que se aplica es el de la fuente de mayor precedencia que menciona el id. Una fuente que no menciona el id deja el valor de la fuente de menor precedencia en vigor.

​
Deshabilitado en configuración de usuario pero aún se carga

Si establece un plugin en false en ~/.claude/settings.json y aún se carga, un true en una fuente de mayor precedencia lo está anulando. La fila del plugin en claude plugin list y en /plugin muestra Disabled in ~/.claude/settings.json but still loads — project settings enable it, which overrides your user setting. El mensaje nombra la fuente que lo anuló: project, project, gitignored para .claude/settings.local.json, cli flag, o managed. Para optar por no participar en un plugin habilitado por proyecto en su máquina, establezca el id en false en .claude/settings.local.json, que tiene mayor precedencia que el archivo del proyecto.

​
Habilitado en configuración del proyecto pero no instalado

Cuando el único true de un plugin está en el .claude/settings.json del proyecto, Claude Code no lo obtiene en una máquina donde no está instalado, a menos que su entrada de mercado tenga una fuente de ruta relativa o un directorio semilla ya lo contenga. En su lugar, la pestaña Errors de /plugin muestra Plugin "<name>" is enabled in project settings but isn't installed here. Un plugin de ruta relativa no necesita un registro de instalación porque se carga desde el mercado en sí. Claude Code obtiene un plugin con una fuente externa solo cuando una de estas fuentes lo establece en true:
  • Su configuración de usuario
  • Un .claude/settings.local.json que git no rastrea
  • La bandera --settings
  • Configuración administrada

​
Encontrar plugins en disco

Claude Code mantiene archivos de plugin y registros de estado bajo una raíz de plugins, que es ~/.claude/plugins a menos que establezca CLAUDE_CODE_PLUGIN_CACHE_DIR. Cada ruta en la tabla es relativa a esa raíz. Debido a que ${CLAUDE_PLUGIN_ROOT} apunta a un directorio de versión, la ruta raíz de un plugin cambia con cada versión. Mantenga los archivos duraderos de un plugin en ${CLAUDE_PLUGIN_DATA} en su lugar.

​
Plugins en lugar y copiados

Claude Code carga algunos plugins en lugar desde donde los mantiene y copia el resto en la caché, según su origen:
  • Plugins --plugin-dir y de directorio de habilidades: el directorio se carga en lugar y nunca se copia. Un archivo .zip de --plugin-url o --plugin-dir se extrae en un directorio temporal de sesión primero
  • Plugins de ruta relativa en un mercado que agregó desde un directorio local: el plugin se carga en lugar desde su ruta dentro de la carpeta del mercado. Sus ediciones al directorio de origen surten efecto en el próximo inicio de sesión o /reload-plugins, y no necesita aumentar la versión. Los procesos de hook del plugin y los servidores MCP y LSP reciben un CLAUDE_PLUGIN_ROOT que apunta al directorio de origen. Para sus dependencias de paquete Node.js, consulte Cuándo se ejecuta la instalación de dependencias
  • Plugins de fuente command en modo de enlace: el directorio que imprimió el comando se carga en lugar, a través de enlaces en la entrada de caché
  • Todos los demás plugins de mercado: Claude Code copia el plugin en cache/<marketplace>/<plugin>/<version>/ en la instalación y carga esa copia. Los archivos fuera del directorio del plugin no se copian, por lo que cuando un script dentro de un plugin copiado lee una ruta por encima de la raíz del plugin, como ../shared, no los encuentra

​
Rutas que escapan del directorio del plugin

Ya sea que un plugin se cargue en lugar o desde una copia en caché, Claude Code no le permite declarar componentes fuera de su propio directorio. Rechaza una ruta de componente que se resuelve fuera de la raíz del plugin, ya sea que la ruta se declare en plugin.json o en una entrada de mercado:
  • Una ruta que apunta fuera del plugin como está escrita, como ../shared-utils
  • Un enlace simbólico que conduce fuera del plugin, que no sean enlaces entre plugins dentro de un mercado
  • En macOS y Linux, una ruta que contiene una barra invertida en cualquier lugar, incluso cuando la ruta permanece dentro del plugin. Los componentes declarados con rutas de barra invertida se cargan solo en Windows, por lo que escriba rutas de componentes con barras diagonales, como ./commands/deploy.md
Una ruta rechazada aparece como un error path escapes plugin directory, y el plugin se carga sin ese componente.

​
Limpieza de versiones anteriores

Cuando actualiza o desinstala un plugin, Claude Code escribe un marcador .orphaned_at en el directorio de versión anterior. Elimina ese directorio en una limpieza en segundo plano 14 días después, por lo que una sesión que ya cargó la versión anterior sigue ejecutándose. El barrido se ejecuta solo mientras installed_plugins.json registra al menos una instalación. Después de desinstalar su último plugin, los directorios huérfanos permanecen hasta que instale otro.

​
Dependencias de paquete Node.js

Cuando Claude Code copia un plugin en la caché, también instala las dependencias de paquete Node.js del plugin allí, por lo que los hooks y servidores MCP del plugin pueden cargarlas. Esta sección cubre los paquetes npm y Bun que un plugin declara en su propio package.json. Para plugins que dependen de otros plugins, consulte versiones de dependencia de plugin.

​
Cuándo se ejecuta la instalación de dependencias

Claude Code ejecuta la instalación dentro del directorio de versión copiada cada vez que crea uno:
  • Cuando instala un plugin
  • Cuando Claude Code actualiza un plugin a una nueva versión
  • Al inicio de la sesión cuando un plugin habilitado aún no está en caché, como en una máquina nueva
Para un plugin de ruta relativa cargado en lugar desde un mercado de directorio local, Claude Code no instala las dependencias en el directorio de origen. Instálelas allí usted mismo, o desde un hook en ${CLAUDE_PLUGIN_DATA}. La instalación se ejecuta solo cuando el directorio raíz del plugin contiene tanto un package.json como un archivo de bloqueo compatible. El archivo de bloqueo decide qué comando ejecuta Claude Code: Si un plugin contiene más de uno de estos archivos de bloqueo, Claude Code usa la primera coincidencia, verificando en orden: bun.lock, bun.lockb, npm-shrinkwrap.json, package-lock.json. Claude Code omite la instalación para archivos de bloqueo de Yarn y pnpm y para un bunfig.toml junto al archivo de bloqueo de Bun:
  • Si su plugin tiene solo un yarn.lock o pnpm-lock.yaml, reemplácelo con un archivo de bloqueo npm
  • Si un bunfig.toml está en el mismo directorio que el archivo de bloqueo de Bun, elimine el bunfig.toml, o reemplace el archivo de bloqueo de Bun con un archivo de bloqueo npm
Incluya un archivo de bloqueo npm para llegar a la mayoría de los usuarios. Claude Code ejecuta el administrador de paquetes del archivo de bloqueo coincidente desde el PATH del usuario y no intenta el otro archivo de bloqueo en su lugar si falta ese administrador de paquetes. Para un plugin distribuido a través de una fuente npm, use npm-shrinkwrap.json, porque npm excluye package-lock.json de los paquetes publicados.

​
Límites en la instalación de dependencias

Claude Code limita esta instalación de dependencias para que ningún código del plugin o sus paquetes se ejecute durante ella, y limita cuánto tiempo puede ejecutarse:
  • Resolución congelada: Bun y npm instalan exactamente lo que el archivo de bloqueo fija, y fallan en lugar de re-resolver versiones cuando package.json y el archivo de bloqueo no coinciden
  • Sin scripts de ciclo de vida: --ignore-scripts evita que se ejecuten scripts preinstall, install y postinstall, por lo que las dependencias que construyen módulos nativos en esos scripts se descargan pero no se compilan durante esta instalación
  • Tiempo de espera de 60 segundos: Claude Code detiene una instalación que se ejecuta más tiempo y la trata como fallida
Claude Code obtiene un plugin de fuente npm antes de esta instalación de dependencias, y ninguno de los scripts de instalación propios del paquete se ejecuta durante la obtención. Consulte fuente de plugin npm. No puede desactivar la instalación automática. Ninguna configuración o variable de entorno la desactiva. En redes restringidas, consulte los requisitos de acceso a la red para los hosts a permitir.

​
Cuándo falla o se omite la instalación de dependencias

Una instalación fallida u omitida nunca bloquea el plugin, y cada caso deja un signo diferente:
  • Una instalación fallida, u omitida debido a un archivo de bloqueo de Yarn o pnpm o un bunfig.toml, aparece como una advertencia en la salida claude --debug
  • Un plugin con un package.json y sin archivo de bloqueo se omite sin una entrada de registro
  • Una instalación que agota el tiempo de espera puede dejar un árbol node_modules parcial en la copia en caché
Cuando la instalación automática no puede proporcionar una dependencia, instálela desde un hook en el directorio de datos persistentes. Eso incluye paquetes que necesitan sus scripts de ciclo de vida para construir, dependencias de Python, y plugins bloqueados con Yarn o pnpm.

​
Versiones y actualizaciones

Si el autor de un plugin envió nuevas confirmaciones y claude plugin update imprime <name> is already at the latest version (<version>)., la versión que Claude Code calcula para el plugin no cambia, por lo que nada cambia en disco. Claude Code calcula una versión para cada plugin que instala, y esa versión es cómo detecta una actualización. claude plugin update y la actualización automática en segundo plano calculan la versión nuevamente y omiten el plugin cuando coincide con lo que installed_plugins.json registra. La versión también nombra el directorio de caché del plugin. Un manifiesto que fija "version" es una forma en que la versión calculada permanece igual en las confirmaciones. Consulte Cómo Claude Code calcula la versión para el orden de resolución. Un plugin cargado en lugar desde un mercado de directorio local carga sus archivos de origen actuales en cada inicio de sesión, sin importar lo que diga su cadena de versión. Para un plugin de un mercado alojado en claude.ai, la versión que claude.ai registra para el plugin es su versión, y el version del manifiesto no se lee.

​
Cómo Claude Code calcula la versión

Para un mercado que agregó por fuente, Claude Code elige la regla por el tipo source de la entrada del mercado del plugin. La referencia de mercado enumera los tipos de fuente. Para cada tipo de fuente en esa lista excepto command:
  1. El campo version en el manifiesto del plugin viene primero
  2. Luego el campo version en la entrada del mercado del plugin
  3. Cuando ninguno está establecido, la versión viene del tipo de fuente:
Claude Code no toma la versión de un repositorio que encierra la ruta de instalación, como un ~/.claude administrado por git. Para una fuente command, Claude Code siempre deriva la versión de lo que el comando produjo: un hash de 12 caracteres por sí solo, o <manifest version>-<hash> cuando el manifiesto establece uno. El version de la entrada del mercado se ignora para fuentes de comando. Para lo que cubre el hash, consulte Modo de copia y modo de enlace. Debido a que el manifiesto viene primero, un manifiesto que fija "version": "1.0.0" mantiene a cada usuario en la copia en caché hasta que su autor cambie la cadena, sin importar cuántas confirmaciones envíe. Para permitir que los usuarios rastreen confirmaciones en su lugar, deje version fuera del manifiesto y la entrada. Alojar un mercado cubre qué opción se ajusta a qué configuración de lanzamiento.

​
Cuándo Claude Code actualiza un mercado antes de una instalación

Cuando instala un plugin, Claude Code lo busca en su copia local del catálogo del mercado. Puede ejecutar /plugin install en una sesión o claude plugin install en su shell, y nombrar el plugin con o sin su mercado. La tabla muestra cuál de esas combinaciones actualiza la copia local. La actualización antes de una instalación name@marketplace no depende de la configuración de actualización automática del mercado o de DISABLE_AUTOUPDATER. Cuando la actualización falla, la instalación procede desde el catálogo en caché y claude plugin install reporta marketplace not refreshed. Claude Code omite la actualización antes de una instalación name@marketplace cuando:
  • El mercado se agregó desde una fuente file o directory local, o se define en línea en configuración con una fuente settings
  • Un directorio semilla proporciona el mercado
  • Claude Code actualizó el mercado en los últimos 30 segundos
  • Establece CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC
  • Configuración administrada bloquea el mercado, en cuyo caso Claude Code también rechaza la instalación

​
Cuándo se ejecuta la actualización automática

En una sesión interactiva, después de enviar su primer mensaje, Claude Code espera un retraso aleatorio de hasta diez minutos. Luego actualiza cada mercado con actualización automática activada y actualiza los plugins instalados desde ellos en disco. La sesión en ejecución mantiene las versiones que cargó, y ve Plugin updated: <name> · Run /reload-plugins to apply. Ya sea que recargue o no, las nuevas versiones se cargan en su próximo lanzamiento.

​
Qué mercados y plugins se actualizan automáticamente

Si un mercado se actualiza automáticamente sigue el primero de estos que está establecido:
  1. autoUpdate en su entrada extraKnownMarketplaces en un archivo de configuración
  2. autoUpdate en su entrada known_marketplaces.json, que el interruptor Enable auto-update bajo /plugin Marketplaces escribe. Cuando un archivo de configuración también declara el mercado bajo extraKnownMarketplaces, el interruptor escribe autoUpdate a esa entrada de configuración también
  3. El predeterminado: activado para los mercados oficiales de Anthropic como claude-plugins-official, desactivado para knowledge-work-plugins y first-party-plugins, activado para mercados agregados desde claude.ai, y desactivado para todos los demás mercados
Si establece DISABLE_UPDATES=1, DISABLE_AUTOUPDATER=1, o CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC=1, toda la pasada está desactivada y el interruptor Enable auto-update está oculto, a menos que también establezca FORCE_AUTOUPDATE_PLUGINS=1. La referencia de variables de entorno cubre el efecto más amplio de cada variable. La actualización automática también omite un plugin cuya entrada de mercado declara un headersHelper. Instalaciones y actualizaciones que rechazan un comando en lugar de preguntar explica cuándo aparece tal plugin en la pestaña Errors de /plugin y cómo lo actualiza desde allí. Cuando un plugin copiado se actualiza a mitad de sesión, los comandos de hook, monitores, servidores MCP y servidores LSP siguen usando la ruta de la versión anterior. Ejecute /reload-plugins para cambiar hooks, servidores MCP y servidores LSP a la nueva ruta. Los monitores requieren un reinicio de sesión.

​
Cuándo se vuelve a ejecutar una fuente de comando

Los plugins con una fuente command no esperan la pasada de actualización automática. El directorio impreso refleja el estado de la herramienta en el momento en que se ejecutó el comando, por lo que Claude Code ejecuta el comando que aceptó nuevamente en estos momentos:
  • Cada vez que instala o actualiza el plugin
  • Una vez por sesión para cada plugin habilitado de fuente de comando, en segundo plano, poco después de que comienza la sesión. Esta ejecución no depende de la configuración de actualización automática del mercado o de DISABLE_AUTOUPDATER
  • Al inicio o en /reload-plugins, cuando la versión instalada de un plugin habilitado falta en la caché del plugin
Claude Code omite las dos ejecuciones en segundo plano cuando establece CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC. Las instalaciones y actualizaciones explícitas aún ejecutan el comando con esa variable establecida. Cuando la salida con hash del comando ha cambiado, Claude Code instala el resultado como una nueva versión y lo recarga en la sesión interactiva en ejecución, cambiando los mismos componentes que /reload-plugins cambia. Ve una notificación de que el plugin fue recargado. Si recargar en lugar invalidaría la caché de solicitud de la sesión, Claude Code en su lugar le solicita que ejecute /reload-plugins, que advierte sobre el costo de caché y se aplica cuando se vuelve a ejecutar con --force.

​
Conflictos de nombres

Cuando los plugins habilitados de diferentes orígenes comparten un nombre de manifiesto, este orden decide cuál se carga, de mayor a menor precedencia:
  1. Un plugin cuyo id aparece en enabledPlugins de configuración administrada, como true o false. Una copia --plugin-dir cuyo nombre de manifiesto coincide con la parte del nombre del id no se carga, y ve --plugin-dir copy of "<name>" ignored: plugin is locked by managed settings
  2. Un plugin --plugin-dir, --plugin-url, o CLAUDE_CODE_PLUGIN_DIRS habilitado. Reemplaza un plugin de mercado instalado o de directorio de habilidades con el mismo nombre:
    • Un plugin de mercado instalado: reemplazado silenciosamente. claude plugin list aún muestra la fila del mercado como habilitada, porque esa fila refleja su configuración. Solo el registro que Claude Code escribe bajo ~/.claude/debug/ cuando inicia con --debug registra Plugin "<name>" from --plugin-dir overrides installed version
    • Un plugin de directorio de habilidades: reemplazado con una fila de pestaña Errors de /plugin que lee Not loaded — the name "<name>" is already taken by a session-only plugin (--plugin-dir / --plugin-url), which takes precedence
  3. Un plugin de mercado instalado. Un plugin de directorio de habilidades con el mismo nombre obtiene la misma fila Not loaded, nombrando el plugin instalado
  4. Un plugin de directorio de habilidades. Entre dos de estos, la copia bajo ~/.claude/skills/ se carga y la copia de .claude/skills/ del proyecto se descarta, con una fila que dice qué ruta la eclipsó
  5. Un plugin sincronizado desde claude.ai. Cuando un plugin habilitado de cualquier otro origen coincide con su nombre, Claude Code carga ese plugin e informa que la copia de claude.ai no se cargó. Para usar la copia de claude.ai en su lugar, desactive su propia copia
Debido a que el orden compara nombres de manifiesto, un plugin --plugin-dir llamado hello-plugin reemplaza hello@example-marketplace cuando el manifiesto de ese plugin también dice "name": "hello-plugin".

​
Evitar que un plugin de solo sesión se cargue

Para evitar que un plugin --plugin-dir eclipse algo, o para desactivarlo cuando un proceso principal pasa la bandera para usted, establezca su id en false en cualquier archivo de configuración. Para un plugin cuyo nombre de manifiesto es hello-plugin, la entrada es "enabledPlugins": {"hello-plugin@inline": false}. Un plugin de solo sesión deshabilitado no eclipsa, por lo que la copia de mercado o directorio de habilidades se carga en su lugar.

​
Próximos pasos