Skip to main content
Chaque session où un plugin est activé inclut les noms et descriptions de ses skills, agents et commandes dans le contexte de Claude, et ces tokens comptent par rapport à l’utilisation de l’utilisateur, que le plugin soit utilisé ou non. Cette page montre comment voir ce nombre pour un plugin, comment le réduire si vous maintenez le plugin, et où l’utilisation s’affiche pour que vous puissiez dire si un plugin est toujours utilisé. Cette page est destinée aux auteurs et mainteneurs de plugins. Si vous administrez Claude Code pour une organisation, Mesurer sur une flotte couvre les mêmes questions sur chaque machine.
Ces cas sont couverts sur d’autres pages :
Commencez par Mesurer le coût d’un plugin.

​
Mesurer le coût d’un plugin

Pour voir ce qu’un plugin ajoute au contexte de Claude, exécutez claude plugin details avec le nom du plugin. Vous l’exécutez dans votre shell, pas à l’invite d’une session Claude Code en cours d’exécution. Le plugin doit être chargé : installé, dans un répertoire de skills, ou passé avec --plugin-dir dans la même commande, comme dans claude --plugin-dir ./formatter plugin details formatter. Cet exemple lit un plugin installé nommé formatter qui a deux skills, une commande, un agent, un hook et un serveur MCP :
Chaque partie de la sortie répond à une question différente :
  • Component inventory : ce que Claude Code a trouvé dans le plugin. Les commandes sont comptées avec les skills, donc format-all apparaît sous Skills. Les hooks et les serveurs MCP n’obtiennent pas d’estimation de coût et pas de ligne par composant ; pour voir ce que les outils MCP d’un plugin ajoutent, exécutez /context dans une session avec le plugin activé et lisez la catégorie MCP tools.
  • Always-on : les tokens que les noms et descriptions des skills, agents et commandes du plugin ajoutent à chaque session où le plugin est activé, que quelque chose s’exécute ou non. C’est le nombre que chaque utilisateur porte, et celui à réduire.
  • Per-component : chaque ligne divise un skill, agent ou commande en sa part always-on et son coût on-invoke, qui est le corps qui se charge uniquement quand ce composant s’exécute. Utilisez la colonne always-on pour trouver quel composant contribue le plus.

​
Réduire le chiffre always-on

Si vous maintenez le plugin, ces modifications réduisent ce qu’il ajoute à chaque session. Si vous l’utilisez seulement, vos options sont de le désactiver ou de le désinstaller ; voir Gérer les plugins installés. Le chiffre always-on compte le nom de chaque composant plus sa description et son frontmatter when_to_use. Pour le réduire :
  • Raccourcissez les descriptions des skills et des agents.
  • Divisez un grand plugin pour que les utilisateurs n’installent que les composants dont ils ont besoin.
La description d’un skill est aussi ce que Claude fait correspondre à une demande, donc une description plus courte peut empêcher le skill de se déclencher. Après avoir réduit les descriptions, vérifiez le déclenchement avec un grader tool_used: Skill dans votre suite d’evals. Pour ce que chaque type de composant contribue, voir composants de plugin.

​
Coût affiché aux utilisateurs avant l’installation

Les plugins de la marketplace officielle affichent leur coût aux utilisateurs avant l’installation. Dans /plugin, quand un utilisateur parcourt la liste des plugins d’une marketplace et sélectionne un plugin, le volet de détails affiche une section Context cost avec une ligne Every turn: et une ligne When invoked:. Quand le chiffre always-on est de 2 000 tokens ou plus, la ligne Every turn: apparaît en surbrillance. Un plugin dans votre propre marketplace n’a pas de section Context cost.

​
Vérifier si un plugin est utilisé

Claude Code ne signale pas l’utilisation d’un plugin à son auteur. L’utilisation est enregistrée sur la machine de chaque personne qui a installé le plugin, donc ce que vous pouvez apprendre dépend de votre relation avec ces personnes :
  • Vous administrez Claude Code pour leur organisation : les événements OpenTelemetry et l’API Analytics comptent les installations et les activations de skills sur chaque machine. Voir Mesurer sur une flotte.
  • Ce sont des coéquipiers que vous pouvez demander : le propre Claude Code de chaque utilisateur leur montre s’il utilise toujours le plugin, en quatre endroits : le panneau /plugin, /skill-doctor, /doctor, et /usage. Les quatre sont des commandes que l’utilisateur exécute à l’invite Claude Code dans une session sur sa propre machine.
  • Aucun des deux : vous n’avez aucun signal d’utilisation de Claude Code pour ce plugin.

​
Non utilisé récemment dans /plugin

Sur l’onglet Installed de /plugin, un plugin que l’utilisateur a installé à partir d’une marketplace se déplace sous un en-tête Not used recently une fois qu’il n’a pas été utilisé pendant au moins 14 jours et 10 sessions. Les détails du plugin affichent également une ligne Last used:. Pour ce que les utilisateurs font avec cet en-tête et cette ligne, voir Trouver les plugins que vous n’utilisez plus. L’en-tête Not used recently n’apparaît jamais pour :
  • Les plugins chargés avec --plugin-dir ou à partir d’un répertoire de skills
  • Les plugins activés via les paramètres gérés, ou montés à partir d’un répertoire seed
  • Les plugins qui incluent un thème, un style de sortie, un moniteur ou un workflow, car ceux-ci sont en cours d’utilisation sans invocation suivie
Le serveur de langage d’un plugin est compté comme utilisé quand il fournit des diagnostics ou répond à une demande de navigation de code, donc un plugin LSP dont le serveur est actif dans vos sessions n’est pas listé comme inutilisé. Quand l’organisation de l’utilisateur définit strictKnownMarketplaces, ni l’en-tête ni la ligne Last used: n’apparaissent.

​
Trouver les skills qui ne s’exécutent jamais

Exécutez /skill-doctor pour voir ce que chacun de vos skills coûte et à quelle fréquence il est utilisé. Il signale les skills qui sont dans la liste des skills de Claude mais qui n’ont jamais été invoqués, y compris les skills des plugins. Dans une session interactive, le rapport s’ouvre dans l’onglet Stats du gestionnaire /plugin. Voir Trouver les skills inutilisés pour ce que le rapport couvre et où il est disponible.

​
Plugins inutilisés dans /doctor

La vérification /doctor liste chaque skill installé par l’utilisateur, serveur MCP et plugin, et recommande de désactiver ceux qui n’ont pas été utilisés. Voir /doctor dans la référence des commandes.

​
Partage d’utilisation dans /usage

Sur un plan Pro, Max, Team ou Enterprise, la ventilation /usage attribue l’utilisation récente aux skills, subagents, plugins et serveurs MCP en tant que part du total. Voir Utiliser la commande /usage.

​
Mesurer sur une flotte

Si vous administrez Claude Code pour une organisation, vous pouvez mesurer le coût et l’utilisation des plugins sur chaque machine à partir de l’une de ces sources :

​
Événements OpenTelemetry pour les installations et l’utilisation des plugins

Ces événements OpenTelemetry et attributs répondent à chaque question de plugin depuis votre backend :

​
Noms de plugins masqués dans votre backend

Les plugins de la marketplace officielle signalent leur nom de plugin et leur nom de marketplace à votre backend littéralement. Tous les autres noms de plugins sont masqués ou omis par défaut, y compris un plugin de la propre marketplace de votre organisation. Le niveau de confiance du plugin décide lequel. Pour obtenir des noms réels sur certains événements, définissez la variable d’environnement OTEL_LOG_TOOL_DETAILS à 1 sur les machines qui exportent la télémétrie, par exemple dans le bloc env des mêmes paramètres gérés qui configurent l’exportateur : Sur plugin_loaded, plugin_id_hash identifie toujours chaque plugin par défaut, vous pouvez donc compter les plugins tiers distincts.

​
Interroger l’API Analytics

Sur le plan Enterprise, l’API Analytics répond à « quels plugins mon organisation installe et invoque » à partir des enregistrements d’Anthropic, sans exportateur nécessaire. GET /v1/organizations/analytics/plugins retourne les comptages d’installation et d’invocation par plugin, par jour, sur Claude Code et Cowork, que vous pouvez regrouper par utilisateur, groupe RBAC ou produit. L’activité des plugins qui atteint Anthropic sans nom de plugin apparaît dans une ligne third-party agrégée. Trouver les plugins dans la télémétrie dit quels plugins Claude Code signale par nom. Authentifiez la demande avec une clé API qui a la portée read:analytics, qu’un propriétaire principal crée comme décrit sous Accéder aux données par programmation. Voir la référence du point de terminaison pour les paramètres et les champs de réponse.

​
Étapes suivantes