Recomendar plugins para su organización

Claude Code puede sugerir la instalación de un plugin del marketplace de su organización cuando la sesión de un usuario coincide con señales que usted define para ese plugin. Las señales incluyen el directorio de trabajo, los archivos que Claude ha leído y los comandos que Claude ha ejecutado. Las define agregando un bloque relevance a la entrada del plugin en marketplace.json. Un operador del marketplace escribe las entradas de relevance. Un administrador luego permite el marketplace en la configuración administrada. Los usuarios no ven sugerencias de un marketplace hasta que se permita.

Estos casos se cubren en otras páginas:

Desea instalar plugins: consulte Instalar y administrar plugins
Desea desactivar sugerencias: consulte Entender cómo funciona la relevancia de plugins

Comience con las secciones para su rol:

Operadores del marketplace: lea cómo funcionan las sugerencias, luego agregue relevancia a una entrada de plugin y valide su marketplace
Administradores: habilite sugerencias en la configuración administrada

Entender cómo funciona la relevancia de plugins

Cada entrada de plugin en marketplace.json puede incluir un objeto relevance. El objeto nombra un tema y una o más señales. Una señal es un patrón que Claude Code prueba contra la sesión actual, como el directorio de trabajo o los archivos que Claude ha leído. La coincidencia de señales ocurre localmente en la máquina del usuario y no agrega tráfico de red. Claude Code no reporta qué señales coincidieron o sus valores a Anthropic o al operador del marketplace. Cuando una señal coincide y el plugin aún no está instalado, Claude Code sugiere el plugin en estos lugares:

Spinner tip: un mensaje con el comando /plugin install aparece debajo del spinner mientras Claude responde.
Notificación de inicio de sesión: si una señal cwd coincide con el directorio de trabajo, aparece una notificación de una línea antes de que el usuario envíe un primer mensaje.
Pestaña Discover de /plugin: el plugin se fija en la parte superior de la lista Discover.

Vista previa de lo que ve el usuario muestra el texto exacto de cada uno y con qué frecuencia se repiten. Claude Code nunca instala el plugin automáticamente. El usuario siempre confirma. El spinner tip y la notificación de inicio de sesión ambos dejan de aparecer cuando el usuario o proyecto establece spinnerTipsEnabled en false, o cuando un spinnerTipsOverride con excludeDefault reemplaza los consejos integrados. El pin de la pestaña Discover no se ve afectado por ninguna de las dos configuraciones.

Agregar relevancia a una entrada de plugin

Agregue un objeto relevance a la entrada del plugin en su marketplace.json. El siguiente ejemplo declara que el plugin terraform-helpers es relevante cuando Claude lee un archivo .tf o ejecuta terraform:

{
  "name": "your-marketplace",
  "owner": { "name": "Your Org" },
  "plugins": [
    {
      "name": "terraform-helpers",
      "source": "./plugins/terraform-helpers",
      "description": "Your organization's Terraform conventions and helpers",
      "relevance": {
        "topic": "Terraform",
        "signals": {
          "cli": ["terraform"],
          "filesRead": ["**/*.tf"]
        }
      }
    }
  ]
}

Mientras ninguna de sus señales coincida, el plugin mantiene su posición normal en la lista Discover y no aparece como un spinner tip. Para verificar el bloque antes de publicar, valide su marketplace.

Referencia de campos

El objeto relevance y su objeto anidado signals aceptan los campos en las siguientes tablas. Los clientes más antiguos aún cargan un marketplace que usa campos relevance que no reconocen, porque los campos desconocidos bajo relevance y relevance.signals se ignoran en el momento de la carga. Un campo reconocido cuyo valor excede su límite en la referencia de campos invalida toda la entrada del plugin, y los usuarios no pueden instalar ese plugin desde el marketplace hasta que lo corrija; claude plugin validate reporta los mismos límites.

`relevance`

Campo	Tipo	Descripción
`topic`	string	Opcional. La frase que completa “¿Trabajando con topic?” en el spinner tip. Por defecto es el nombre del plugin con cada segmento de guión en mayúscula. Máximo 64 caracteres.
`signals`	object	Coincidencias que determinan cuándo el plugin es relevante. Claude Code sugiere el plugin solo si al menos una señal está establecida. Consulte `relevance.signals`.

El topic suele ser el nombre del producto, por ejemplo Terraform. Use un dominio como design cuando el nombre del plugin no suena natural como un tema.

`relevance.signals`

El objeto signals acepta los siguientes campos.

Campo	Tipo	Descripción	Límite
`cwd`	array of strings	Patrones Glob coincididos contra el directorio de trabajo de la sesión. Consulte coincidencia de directorio de trabajo.	10 patrones de 256 caracteres cada uno
`cli`	array of strings	Nombres de comandos de comandos shell que Claude ha ejecutado esta sesión, por ejemplo `["terraform"]`. Coincidencia exacta. Consulte coincidencia de nombre de comando.	10 entradas de 64 caracteres cada una
`hosts`	array of strings	Nombres de host vistos en URLs `http://` o `https://` en comandos Bash esta sesión, por ejemplo `["registry.terraform.io"]`. Solo nombre de host en minúsculas: sin esquema, puerto o ruta. Coincidencia exacta sin distinción de mayúsculas y minúsculas.	20 entradas de 128 caracteres cada una
`filesRead`	array of strings	Patrones Glob coincididos contra las rutas de archivos que Claude ha leído esta sesión, por ejemplo `["*/.tf"]`. Normalizado con barra diagonal hacia adelante y sin distinción de mayúsculas y minúsculas.	10 patrones de 256 caracteres cada uno
`manifestDeps`	array of objects	Dependencias declaradas en manifiestos de paquetes que Claude ha leído esta sesión. Cada entrada es `{ "file": "...", "pattern": "..." }`, donde ambos valores son expresiones regulares. Consulte coincidencia de dependencia de manifiesto.	10 entradas, cada valor como máximo 256 caracteres. Los archivos de manifiesto más grandes de 512 KB se omiten

Las señales filesRead y manifestDeps también coinciden contra archivos que Claude ha escrito o editado esta sesión y contra los archivos de memoria CLAUDE.md cargados automáticamente del proyecto.

Coincidencia de directorio de trabajo

cwd es la única señal que puede coincidir al inicio de la sesión, antes de que el usuario envíe un primer mensaje. Claude Code coincide cada patrón cwd de la siguiente manera:

El patrón se compara contra el directorio de trabajo como una ruta absoluta. Cuando la sesión está dentro de un repositorio git, también se compara contra la ruta del directorio de trabajo relativa a la raíz del repositorio.
La coincidencia se normaliza con barra diagonal hacia adelante y sin distinción de mayúsculas y minúsculas.
Cada patrón coincide con el directorio en sí y todo lo que hay debajo, por lo que infra, infra/ e infra/** se comportan de manera idéntica.

Coincidencia de nombre de comando

Claude Code registra un nombre de comando para cada comando shell que Claude ejecuta: el primer token después de cualquier asignación de variable de entorno inicial y sudo. Los comandos compuestos contribuyen solo con su comando inicial, por lo que cd infra && terraform plan registra cd, no terraform.

Coincidencia de dependencia de manifiesto

Cada entrada de manifestDeps empareja dos cadenas de origen de JavaScript RegExp:

file: coincidido sin distinción de mayúsculas y minúsculas contra la ruta del archivo de manifiesto. La ruta es típicamente absoluta, por lo que ancle el patrón al final en lugar del inicio. Las rutas no se normalizan por separador para esta señal, por lo que las rutas de Windows usan barras invertidas.
pattern: coincidido con distinción de mayúsculas y minúsculas contra el contenido de ese archivo.

El siguiente ejemplo usa manifestDeps para sugerir su plugin una vez que Claude ha leído un package.json que depende del paquete npm de su SDK, nombrado your-sdk aquí.

{
  "name": "your-plugin",
  "source": "./plugins/your-plugin",
  "relevance": {
    "signals": {
      "manifestDeps": [
        {
          "file": "[/\\\\]package\\.json$",
          "pattern": "\"your-sdk\"\\s*:"
        }
      ]
    }
  }
}

En este ejemplo, el patrón file usa [/\\\\] para que coincida tanto con separadores de ruta de barra diagonal como de barra invertida, y \\. para que el punto sea literal. En JSON, cada barra invertida en la expresión regular se escribe dos veces.

Validar su marketplace

En su shell, ejecute claude plugin validate contra su directorio de marketplace para verificar el bloque relevance antes de publicar:

claude plugin validate ./my-marketplace

El validador reporta errores y advertencias en el bloque relevance, incluyendo estos:

Reporta claves desconocidas bajo relevance y relevance.signals como advertencias
Marca un valor relevance que no es un objeto
Rechaza una entrada signals.hosts que incluye un esquema, puerto o ruta

Cada hallazgo se imprime con la ruta del campo que le concierne, y la salida termina con Validation passed, Validation passed with warnings o Validation failed.

Habilitar sugerencias en la configuración administrada

Los usuarios no ven sugerencias de un marketplace hasta que un administrador lo permita en configuración administrada, incluso cuando su marketplace.json declara relevance. Para permitir un marketplace, edite su configuración administrada de la siguiente manera:

Agregue el nombre del marketplace a pluginSuggestionMarketplaces.
Para cualquier marketplace que no sea el marketplace oficial de Anthropic, también declare la fuente del marketplace, ya sea como entrada de ese nombre en extraKnownMarketplaces o como entrada en strictKnownMarketplaces.

En una máquina donde el marketplace no está registrado, o está registrado bajo el nombre permitido desde una fuente diferente, no aparecen sugerencias de él. La verificación de fuente evita que una fuente no relacionada se registre bajo un nombre permitido para que sus plugins se sugieran en toda su organización. El siguiente managed-settings.json registra un marketplace de organización desde un repositorio de GitHub y habilita sus sugerencias:

{
  "extraKnownMarketplaces": {
    "your-marketplace": {
      "source": {
        "source": "github",
        "repo": "your-org/your-marketplace"
      }
    }
  },
  "pluginSuggestionMarketplaces": ["your-marketplace"]
}

El nombre del marketplace oficial solo puede registrarse desde la fuente oficial de Anthropic, por lo que no necesita declaración de fuente. Para el marketplace oficial, permita solo el nombre:

{
  "pluginSuggestionMarketplaces": ["claude-plugins-official"]
}

Vista previa de lo que ve el usuario

Cuando la señal relevance de un plugin coincide durante una sesión, el consejo debajo del spinner lee:

Working with Terraform? Install the terraform-helpers plugin:
/plugin install terraform-helpers@your-marketplace

Cuando una señal cwd coincide al inicio de la sesión, la notificación de una línea lee:

plugin suggestion: terraform-helpers@your-marketplace · /plugin

En la pestaña Discover de /plugin, el plugin se fija encima de los otros resultados con una anotación que nombra la señal coincidente, como suggested for this directory o suggested for terraform commands. Claude Code limita con qué frecuencia sugiere un plugin dado:

La sugerencia aparece como máximo una vez cada tres sesiones en el spinner tip y la notificación de inicio de sesión combinados.
La notificación de inicio de sesión deja de aparecer una vez que el spinner tip y la notificación han mostrado el plugin un total combinado de dos veces.
Ni el spinner tip ni la notificación de inicio de sesión se repiten una vez que el plugin está instalado.
La pestaña Discover fija el plugin la primera vez que el usuario abre la pestaña mientras las señales del plugin coinciden. Claude Code registra eso en ~/.claude.json, por lo que cada vez posterior que el usuario abre /plugin en esa máquina, el plugin aparece en orden normal.

Ver también

Alojar un marketplace: ejecute el marketplace que aloja sus plugins
Referencia de marketplace: cada campo que acepta una entrada de plugin
Recomendar su plugin desde su CLI: solicite a los usuarios desde su propio CLI en lugar de desde las señales de sesión de Claude Code
Administrar plugins para su organización: extraKnownMarketplaces, strictKnownMarketplaces y el resto de las claves de política de plugins

Plugins

Usar plugins

Crear plugins

Ejecutar un marketplace

Administrar plugins para su organización

Solución de problemas

Referencia

Recomendar plugins para su organización

Entender cómo funciona la relevancia de plugins

Agregar relevancia a una entrada de plugin

Referencia de campos

`relevance`

`relevance.signals`

Coincidencia de directorio de trabajo

Coincidencia de nombre de comando

Coincidencia de dependencia de manifiesto

Validar su marketplace

Habilitar sugerencias en la configuración administrada

Vista previa de lo que ve el usuario

Ver también

​Entender cómo funciona la relevancia de plugins

​Agregar relevancia a una entrada de plugin

​Referencia de campos

​relevance

​relevance.signals

​Coincidencia de directorio de trabajo

​Coincidencia de nombre de comando

​Coincidencia de dependencia de manifiesto

​Validar su marketplace

​Habilitar sugerencias en la configuración administrada

​Vista previa de lo que ve el usuario

​Ver también

Entender cómo funciona la relevancia de plugins

Agregar relevancia a una entrada de plugin

Referencia de campos

`relevance`

`relevance.signals`

Coincidencia de directorio de trabajo

Coincidencia de nombre de comando

Coincidencia de dependencia de manifiesto

Validar su marketplace

Habilitar sugerencias en la configuración administrada

Vista previa de lo que ve el usuario

Ver también