Skip to main content
Ogni sessione in cui un plugin è abilitato include i nomi e le descrizioni delle sue skills, agents e commands nel contesto di Claude, e questi token contano rispetto all’utilizzo dell’utente indipendentemente dal fatto che il plugin venga utilizzato o meno. Questa pagina mostra come visualizzare quel numero per un plugin, come ridurlo se mantieni il plugin, e dove viene visualizzato l’utilizzo in modo da poter determinare se un plugin è ancora utilizzato. Questa pagina è per gli autori e i manutentori di plugin. Se amministri Claude Code per un’organizzazione, Misurare su una flotta copre le stesse domande su ogni macchina.
Questi casi sono coperti su altre pagine:
Inizia con Misurare il costo di un plugin.

​
Misurare il costo di un plugin

Per vedere cosa aggiunge un plugin al contesto di Claude, esegui claude plugin details con il nome del plugin. Lo esegui nella tua shell, non al prompt di una sessione Claude Code in esecuzione. Il plugin deve essere caricato: installato, in una directory di skills, o passato con --plugin-dir nello stesso comando, come in claude --plugin-dir ./formatter plugin details formatter. Questo esempio legge un plugin installato denominato formatter che ha due skills, un command, un agent, un hook e un server MCP:
Ogni parte dell’output risponde a una domanda diversa:
  • Component inventory: cosa Claude Code ha trovato nel plugin. I commands vengono conteggiati con le skills, quindi format-all appare sotto Skills. Gli hooks e i server MCP non ottengono una stima dei costi e nessuna riga per componente; per vedere cosa aggiungono gli strumenti MCP di un plugin, esegui /context in una sessione con il plugin abilitato e leggi la categoria MCP tools.
  • Always-on: i token che i nomi e le descrizioni delle skills, degli agents e dei commands del plugin aggiungono a ogni sessione in cui il plugin è abilitato, indipendentemente dal fatto che qualcosa venga eseguito. Questo è il numero che ogni utente porta con sé, e quello da ridurre.
  • Per-component: ogni riga divide una skill, un agent o un command nella sua quota always-on e nel suo costo on-invoke, che è il corpo che si carica solo quando quel componente viene eseguito. Usa la colonna always-on per trovare quale componente contribuisce di più.

​
Ridurre il valore always-on

Se mantieni il plugin, questi cambiamenti riducono quello che aggiunge a ogni sessione. Se lo usi solo, le tue opzioni sono disabilitarlo o disinstallarlo; vedi Manage installed plugins. Il valore always-on conta il nome di ogni componente più la sua description e il frontmatter when_to_use. Per ridurlo:
  • Accorcia le descrizioni di skills e agents.
  • Dividi un plugin grande in modo che gli utenti installino solo i componenti di cui hanno bisogno.
La descrizione di una skill è anche quella che Claude abbina a una richiesta, quindi una più breve può impedire che la skill si attivi. Dopo aver ridotto le descrizioni, controlla l’attivazione con un grader tool_used: Skill nella tua suite di eval. Per sapere cosa contribuisce ogni tipo di componente, vedi plugin components.

​
Costo mostrato agli utenti prima dell’installazione

I plugin nel marketplace ufficiale mostrano il loro costo agli utenti prima dell’installazione. In /plugin, quando un utente sfoglia l’elenco dei plugin di un marketplace e seleziona un plugin, il riquadro dei dettagli mostra una sezione Context cost con una riga Every turn: e una riga When invoked:. Quando il valore always-on è 2.000 token o più, la riga Every turn: appare evidenziata. Un plugin nel tuo marketplace non ha una sezione Context cost.

​
Verificare se un plugin è utilizzato

Claude Code non segnala l’utilizzo di un plugin al suo autore. L’utilizzo viene registrato sulla macchina di ogni persona che ha installato il plugin, quindi quello che puoi imparare dipende dalla tua relazione con quelle persone:
  • Amministri Claude Code per la loro organizzazione: gli eventi OpenTelemetry e l’Analytics API contano le installazioni e le attivazioni di skills su ogni macchina. Vedi Misurare su una flotta.
  • Sono colleghi che puoi chiedere: il Claude Code di ogni utente mostra loro se usano ancora il plugin, in quattro posti: il pannello /plugin, /skill-doctor, /doctor, e /usage. Tutti e quattro sono comandi che l’utente esegue al prompt di Claude Code in una sessione sulla propria macchina.
  • Nessuno dei due: non hai alcun segnale di utilizzo da Claude Code per quel plugin.

​
Non utilizzato di recente in /plugin

Nella scheda Installed di /plugin, un plugin che l’utente ha installato da un marketplace si sposta sotto un’intestazione Not used recently una volta che non è stato utilizzato per almeno 14 giorni e 10 sessioni. I dettagli del plugin mostrano anche una riga Last used:. Per sapere cosa fanno gli utenti con quell’intestazione e quella riga, vedi Find plugins you no longer use. L’intestazione Not used recently non appare mai per:
  • Plugin caricati con --plugin-dir o da una directory di skills
  • Plugin abilitati tramite impostazioni gestite, o montati da una directory seed
  • Plugin che includono un tema, uno stile di output, un monitor o un workflow, perché questi sono in uso senza un’attivazione tracciata
Un language server di un plugin conta come utilizzato quando fornisce diagnostica o risponde a una richiesta di navigazione del codice, quindi un plugin LSP il cui server è attivo nelle tue sessioni non è elencato come inutilizzato. Quando l’organizzazione dell’utente imposta strictKnownMarketplaces, né l’intestazione né la riga Last used: appare.

​
Trovare skills che non vengono mai eseguite

Esegui /skill-doctor per vedere il costo di ogni tua skill e quanto spesso viene utilizzata. Contrassegna le skills che sono nell’elenco di skills di Claude ma non sono mai state richiamate, incluse le skills dai plugin. In una sessione interattiva, il report si apre nella scheda Stats del gestore /plugin. Vedi Find unused skills per sapere cosa copre il report e dove è disponibile.

​
Plugin inutilizzati in /doctor

Il checkup /doctor elenca ogni skill installata dall’utente, server MCP e plugin, e consiglia di disabilitare quelli che non sono stati utilizzati. Vedi /doctor in the commands reference.

​
Condivisione dell’utilizzo in /usage

Su un piano Pro, Max, Team o Enterprise, la suddivisione /usage attribuisce l’utilizzo recente a skills, subagents, plugin e server MCP come quota del totale. Vedi Using the /usage command.

​
Misurare su una flotta

Se amministri Claude Code per un’organizzazione, puoi misurare il costo e l’utilizzo dei plugin su ogni macchina da una di queste fonti:

​
OpenTelemetry events for plugin installs and use

Questi eventi e attributi OpenTelemetry rispondono a ogni domanda sui plugin dal tuo backend:

​
Nomi di plugin redatti nel tuo backend

I plugin dal marketplace ufficiale segnalano il loro nome di plugin e il nome del marketplace al tuo backend letteralmente. Il nome di ogni altro plugin è redatto o omesso per impostazione predefinita, incluso un plugin dal marketplace della tua organizzazione. Il trust tier del plugin decide quale. Per ottenere nomi reali su alcuni eventi, imposta la variabile di ambiente OTEL_LOG_TOOL_DETAILS su 1 sulle macchine che esportano telemetria, ad esempio nel blocco env delle stesse impostazioni gestite che configurano l’esportatore: Su plugin_loaded, plugin_id_hash identifica ancora ogni plugin per impostazione predefinita, quindi puoi contare i plugin di terze parti distinti.

​
Query the Analytics API

Sul piano Enterprise, l’Analytics API risponde a “quali plugin installa e richiama la mia organizzazione” dai record di Anthropic, senza necessità di esportatore. GET /v1/organizations/analytics/plugins restituisce conteggi di installazione e attivazione per plugin, per giorno, su Claude Code e Cowork, che puoi raggruppare per utente, gruppo RBAC o prodotto. L’attività del plugin che raggiunge Anthropic senza un nome di plugin appare in una riga aggregata third-party. Find plugins in telemetry dice quali plugin Claude Code segnala per nome. Autentica la richiesta con una chiave API che ha lo scope read:analytics, che un Primary Owner crea come descritto in Access data programmatically. Vedi il riferimento dell’endpoint per i parametri e i campi di risposta.

​
Passaggi successivi