Skip to main content
Cada sessão em que um plugin está ativado inclui os nomes e descrições de suas skills, agentes e comandos no contexto do Claude, e esses tokens contam contra o uso do usuário, independentemente de o plugin ser usado ou não. Esta página mostra como ver esse número para um plugin, como reduzi-lo se você mantém o plugin e onde o uso aparece para que você possa saber se um plugin ainda está sendo usado. Esta página é para autores e mantenedores de plugins. Se você administra Claude Code para uma organização, Medir em toda a frota cobre as mesmas perguntas em cada máquina.
Estes casos são cobertos em outras páginas:
Comece com Medir o que um plugin custa.

​
Medir o que um plugin custa

Para ver o que um plugin adiciona ao contexto do Claude, execute claude plugin details com o nome do plugin. Você o executa em seu shell, não no prompt de uma sessão Claude Code em execução. O plugin deve estar carregado: instalado, em um diretório de skills ou passado com --plugin-dir no mesmo comando, como em claude --plugin-dir ./formatter plugin details formatter. Este exemplo lê um plugin instalado chamado formatter que tem duas skills, um comando, um agente, um hook e um servidor MCP:
Cada parte da saída responde a uma pergunta diferente:
  • Component inventory: o que Claude Code encontrou no plugin. Comandos são contados com skills, então format-all aparece em Skills. Hooks e servidores MCP não recebem estimativa de custo e nenhuma linha por componente; para ver o que as ferramentas MCP de um plugin adicionam, execute /context em uma sessão com o plugin ativado e leia a categoria MCP tools.
  • Always-on: os tokens que os nomes e descrições das skills, agentes e comandos do plugin adicionam a cada sessão em que o plugin está ativado, independentemente de algo ser executado ou não. Este é o número que cada usuário carrega e o que deve ser reduzido.
  • Per-component: cada linha divide uma skill, agente ou comando em sua parte sempre ativa e seu custo ao invocar, que é o corpo que carrega apenas quando esse componente é executado. Use a coluna sempre ativa para encontrar qual componente contribui mais.

​
Reduzir a figura sempre ativa

Se você mantém o plugin, essas mudanças reduzem o que ele adiciona a cada sessão. Se você apenas o usa, suas opções são desativá-lo ou desinstalá-lo; veja Gerenciar plugins instalados. A figura sempre ativa conta o nome de cada componente mais sua description e when_to_use frontmatter. Para reduzi-la:
  • Encurte as descrições de skills e agentes.
  • Divida um plugin grande para que os usuários instalem apenas os componentes que precisam.
A descrição de uma skill também é o que Claude corresponde a uma solicitação, então uma mais curta pode impedir que a skill seja acionada. Depois de aparar as descrições, verifique o acionamento com um avaliador tool_used: Skill em sua suíte de avaliação. Para saber o que cada tipo de componente contribui, veja componentes de plugin.

​
Custo mostrado aos usuários antes da instalação

Plugins no marketplace oficial mostram seu custo aos usuários antes da instalação. Em /plugin, quando um usuário navega pela lista de plugins de um marketplace e seleciona um plugin, o painel de detalhes mostra uma seção Context cost com uma linha Every turn: e uma linha When invoked:. Quando a figura sempre ativa é 2.000 tokens ou mais, a linha Every turn: aparece destacada. Um plugin em seu próprio marketplace não tem uma seção Context cost.

​
Verificar se um plugin é usado

Claude Code não relata o uso de um plugin de volta ao seu autor. O uso é registrado na máquina de cada pessoa que instalou o plugin, então o que você pode aprender depende de seu relacionamento com essas pessoas:
  • Você administra Claude Code para sua organização: os eventos OpenTelemetry e a API Analytics contam instalações e ativações de skills em cada máquina. Veja Medir em toda a frota.
  • São colegas de equipe que você pode perguntar: o próprio Claude Code de cada usuário mostra a eles se ainda usam o plugin, em quatro lugares: o painel /plugin, /skill-doctor, /doctor e /usage. Todos os quatro são comandos que o usuário executa no prompt Claude Code em uma sessão em sua própria máquina.
  • Nenhum dos dois: você não tem sinal de uso de Claude Code para esse plugin.

​
Não usado recentemente em /plugin

Na aba Installed de /plugin, um plugin que o usuário instalou de um marketplace se move sob um cabeçalho Not used recently uma vez que ficou sem uso por pelo menos 14 dias e 10 sessões. Os detalhes do plugin também mostram uma linha Last used:. Para saber o que os usuários fazem com esse cabeçalho e linha, veja Encontrar plugins que você não usa mais. O cabeçalho Not used recently nunca aparece para:
  • Plugins carregados com --plugin-dir ou de um diretório de skills
  • Plugins ativados através de configurações gerenciadas ou montados de um diretório seed
  • Plugins que incluem um tema, estilo de saída, monitor ou workflow, porque esses estão em uso sem uma invocação rastreada
Um servidor de linguagem de um plugin conta como usado quando entrega diagnósticos ou responde a uma solicitação de navegação de código, então um plugin LSP cujo servidor está ativo em suas sessões não está listado como não usado. Quando a organização do usuário define strictKnownMarketplaces, nem o cabeçalho nem a linha Last used: aparece.

​
Encontrar skills que nunca são executadas

Execute /skill-doctor para ver o que cada uma de suas skills custa e com que frequência é usada. Ele sinaliza skills que estão na listagem de skills do Claude mas nunca foram invocadas, incluindo skills de plugins. Em uma sessão interativa, o relatório abre na aba Stats do gerenciador /plugin. Veja Encontrar skills não usadas para saber o que o relatório cobre e onde está disponível.

​
Plugins não usados em /doctor

A verificação /doctor lista cada skill instalada pelo usuário, servidor MCP e plugin, e recomenda desativar os que não foram usados. Veja /doctor na referência de comandos.

​
Compartilhamento de uso em /usage

Em um plano Pro, Max, Team ou Enterprise, o detalhamento /usage atribui o uso recente a skills, subagentes, plugins e servidores MCP como uma parte do total. Veja Usando o comando /usage.

​
Medir em toda a frota

Se você administra Claude Code para uma organização, você pode medir custo e uso de plugin em cada máquina de uma dessas fontes:

​
Eventos OpenTelemetry para instalações e uso de plugins

Esses eventos e atributos OpenTelemetry respondem cada pergunta de plugin de seu backend:

​
Nomes de plugin redatados em seu backend

Plugins do marketplace oficial relatam seu nome de plugin e nome de marketplace para seu backend literalmente. Todos os outros nomes de plugin são redatados ou omitidos por padrão, incluindo um plugin do próprio marketplace de sua organização. O nível de confiança do plugin decide qual. Para obter nomes reais em alguns eventos, defina a variável de ambiente OTEL_LOG_TOOL_DETAILS como 1 nas máquinas que exportam telemetria, por exemplo no bloco env das mesmas configurações gerenciadas que configuram o exportador: Em plugin_loaded, plugin_id_hash ainda identifica cada plugin por padrão, então você pode contar plugins de terceiros distintos.

​
Consultar a API Analytics

No plano Enterprise, a API Analytics responde “quais plugins minha organização instala e invoca” dos registros da Anthropic, sem necessidade de exportador. GET /v1/organizations/analytics/plugins retorna contagens de instalação e invocação por plugin, por dia em Claude Code e Cowork, que você pode agrupar por usuário, grupo RBAC ou produto. A atividade de plugin que chega à Anthropic sem um nome de plugin aparece em uma linha agregada third-party. Encontrar plugins em telemetria diz quais plugins Claude Code relata por nome. Autentique a solicitação com uma chave de API que tenha o escopo read:analytics, que um Proprietário Primário cria conforme descrito em Acessar dados programaticamente. Veja a referência de endpoint para os parâmetros e campos de resposta.

​
Próximos passos