Skip to main content
Cada sesión en la que un plugin está habilitado incluye los nombres y descripciones de sus skills, agentes y comandos en el contexto de Claude, y esos tokens se cuentan contra el uso del usuario independientemente de si el plugin se utiliza o no. Esta página muestra cómo ver ese número para un plugin, cómo reducirlo si mantiene el plugin, y dónde aparece el uso para que pueda saber si un plugin aún se está utilizando. Esta página es para autores y mantenedores de plugins. Si administra Claude Code para una organización, Medir en toda una flota cubre las mismas preguntas en cada máquina.
Estos casos se cubren en otras páginas:
Comience con Medir qué cuesta un plugin.

Medir qué cuesta un plugin

Para ver qué agrega un plugin al contexto de Claude, ejecute claude plugin details con el nombre del plugin. Lo ejecuta en su shell, no en el prompt de una sesión de Claude Code en ejecución. El plugin debe estar cargado: instalado, en un directorio de skills, o pasado con --plugin-dir en el mismo comando, como en claude --plugin-dir ./formatter plugin details formatter. Este ejemplo lee un plugin instalado llamado formatter que tiene dos skills, un comando, un agente, un hook y un servidor MCP:
Cada parte de la salida responde una pregunta diferente:
  • Component inventory: lo que Claude Code encontró en el plugin. Los comandos se cuentan con skills, por lo que format-all aparece bajo Skills. Los hooks y servidores MCP no obtienen estimación de costo ni fila por componente; para ver qué agregan las herramientas MCP de un plugin, ejecute /context en una sesión con el plugin habilitado y lea la categoría MCP tools.
  • Always-on: los tokens que los nombres y descripciones de los skills, agentes y comandos del plugin agregan a cada sesión donde el plugin está habilitado, independientemente de si algo se ejecuta o no. Este es el número que cada usuario lleva, y el que debe reducir.
  • Per-component: cada fila divide un skill, agente o comando en su parte siempre activa y su costo de invocación, que es el cuerpo que se carga solo cuando ese componente se ejecuta. Use la columna always-on para encontrar qué componente contribuye más.

Reducir la cifra always-on

Si mantiene el plugin, estos cambios reducen lo que agrega a cada sesión. Si solo lo usa, sus opciones son deshabilitarlo o desinstalarlo; consulte Manage installed plugins. La cifra always-on cuenta el nombre de cada componente más su description y frontmatter when_to_use. Para reducirla:
  • Acorte las descripciones de skills y agentes.
  • Divida un plugin grande para que los usuarios instalen solo los componentes que necesitan.
La descripción de un skill también es lo que Claude compara con una solicitud, por lo que una más corta puede evitar que el skill se active. Después de recortar descripciones, verifique la activación con un calificador tool_used: Skill en su suite de evaluación. Para ver qué contribuye cada tipo de componente, consulte plugin components.

Costo mostrado a los usuarios antes de instalar

Los plugins en el marketplace oficial muestran su costo a los usuarios antes de instalar. En /plugin, cuando un usuario explora la lista de plugins de un marketplace y selecciona un plugin, el panel de detalles muestra una sección Context cost con una línea Every turn: y una línea When invoked:. Cuando la cifra always-on es de 2.000 tokens o más, la línea Every turn: aparece resaltada. Un plugin en su propio marketplace no tiene sección Context cost.

Verificar si se utiliza un plugin

Claude Code no informa el uso de un plugin a su autor. El uso se registra en la máquina de cada persona que instaló el plugin, por lo que lo que puede aprender depende de su relación con esas personas:
  • Administra Claude Code para su organización: los eventos de OpenTelemetry y la API de Analytics cuentan instalaciones y activaciones de skills en cada máquina. Consulte Medir en toda una flota.
  • Son compañeros de equipo a los que puede preguntar: el propio Claude Code de cada usuario les muestra si aún usan el plugin, en cuatro lugares: el panel /plugin, /skill-doctor, /doctor, y /usage. Los cuatro son comandos que el usuario ejecuta en el prompt de Claude Code en una sesión en su propia máquina.
  • Ninguno: no tiene señal de uso de Claude Code para ese plugin.

No utilizado recientemente en /plugin

En la pestaña Installed de /plugin, un plugin que el usuario instaló desde un marketplace se mueve bajo un encabezado Not used recently una vez que ha estado sin usar durante al menos 14 días y 10 sesiones. Los detalles del plugin también muestran una línea Last used:. Para ver qué hacen los usuarios con ese encabezado y línea, consulte Find plugins you no longer use. El encabezado Not used recently nunca aparece para:
  • Plugins cargados con --plugin-dir o desde un directorio de skills
  • Plugins habilitados a través de configuración administrada, o montados desde un directorio seed
  • Plugins que incluyen un tema, estilo de salida, monitor o flujo de trabajo, porque están en uso sin una invocación rastreada
El servidor de lenguaje de un plugin se cuenta como utilizado cuando entrega diagnósticos o responde una solicitud de navegación de código, por lo que un plugin LSP cuyo servidor está activo en sus sesiones no se enumera como sin usar. Cuando la organización del usuario establece strictKnownMarketplaces, ni el encabezado ni la línea Last used: aparecen.

Encontrar skills que nunca se ejecutan

Ejecute /skill-doctor para ver qué cuesta cada uno de sus skills y con qué frecuencia se utiliza. Marca skills que están en la lista de skills de Claude pero nunca han sido invocados, incluidos skills de plugins. En una sesión interactiva, el informe se abre en la pestaña Stats del administrador /plugin. Consulte Find unused skills para ver qué cubre el informe y dónde está disponible.

Plugins sin usar en /doctor

El chequeo /doctor enumera cada skill instalado por el usuario, servidor MCP y plugin, y recomienda deshabilitar los que no se utilizaron. Consulte /doctor en la referencia de comandos.

Compartir uso en /usage

En un plan Pro, Max, Team o Enterprise, el desglose /usage atribuye el uso reciente a skills, subagentes, plugins y servidores MCP como una parte del total. Consulte Using the /usage command.

Medir en toda una flota

Si administra Claude Code para una organización, puede medir el costo y el uso del plugin en cada máquina desde cualquiera de estas fuentes:

Eventos de OpenTelemetry para instalaciones y uso de plugins

Estos eventos y atributos de OpenTelemetry responden cada pregunta de plugin desde su backend:

Nombres de plugins redactados en su backend

Los plugins del marketplace oficial reportan su nombre de plugin y nombre de marketplace a su backend literalmente. El nombre de todos los demás plugins se redacta u omite por defecto, incluido un plugin del propio marketplace de su organización. El nivel de confianza del plugin decide cuál. Para obtener nombres reales en algunos eventos, establezca la variable de entorno OTEL_LOG_TOOL_DETAILS en 1 en las máquinas que exportan telemetría, por ejemplo en el bloque env de la misma configuración administrada que configura el exportador: En plugin_loaded, plugin_id_hash aún identifica cada plugin por defecto, por lo que puede contar plugins de terceros distintos.

Consultar la API de Analytics

En el plan Enterprise, la API de Analytics responde “qué plugins instala e invoca mi organización” desde los registros de Anthropic, sin necesidad de exportador. GET /v1/organizations/analytics/plugins devuelve recuentos de instalación e invocación por plugin, por día en Claude Code y Cowork, que puede agrupar por usuario, grupo RBAC o producto. La actividad de plugin que llega a Anthropic sin un nombre de plugin aparece en una fila agregada third-party. Find plugins in telemetry dice qué plugins reporta Claude Code por nombre. Autentique la solicitud con una clave de API que tenga el alcance read:analytics, que un Propietario Principal crea como se describe en Access data programmatically. Consulte la referencia del endpoint para los parámetros y campos de respuesta.

Próximos pasos