Estos casos se cubren en otras páginas:
- Probar qué tan confiablemente el plugin cambia el comportamiento de Claude: consulte Test plugins with evals
- Reducir el contexto de su propia sesión: consulte Manage installed plugins y la página context window
Medir qué cuesta un plugin
Para ver qué agrega un plugin al contexto de Claude, ejecuteclaude 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:
- Component inventory: lo que Claude Code encontró en el plugin. Los comandos se cuentan con skills, por lo que
format-allaparece bajoSkills. 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/contexten una sesión con el plugin habilitado y lea la categoríaMCP 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 sudescription 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.
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-diro 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
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: Claude Code los exporta a su propio backend una vez que configura un exportador. Consulte OpenTelemetry events for plugin installs and use.
- API de Analytics: servida desde los registros de Anthropic, sin necesidad de exportador. Consulte Query the Analytics API.
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 entornoOTEL_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
- Test plugins with evals: mida qué tan confiablemente el plugin dirige a Claude, no solo qué cuesta
- Reducir la cifra always-on: qué cambiar en el plugin para reducir su costo por turno
- Plugin security and trust: qué campos de telemetría llevan nombres de plugins y cuándo se redactan
- Monitoring usage: la referencia completa de eventos de OpenTelemetry