CommunityImagemgithub.com

relatório-de-tokens

Gera relatórios de uso de tokens do Claude Code, incluindo leituras e gravações de cache, valor da lista de API, leituras de cota e tempos de resposta a partir de transcrições locais.

O que é relatório-de-tokens?

Este skill permite que desenvolvedores gerem relatórios detalhados de uso de tokens do Claude Code diretamente a partir de transcrições de sessão armazenadas localmente. Ele fornece uma visão abrangente do consumo de tokens, incluindo entrada base, criação de cache, leituras de cache, valor da lista de API, leituras de cota e tempos de resposta. O relatório não envia dados para nenhum servidor nem instala dependências, sendo totalmente executado no ambiente local do usuário. Suporta múltiplos estilos de apresentação (clínico, matisse, nocturno) e oferece opções para filtrar por período, sessão e formato de saída (HTML ou JSON). O skill enfatiza que os valores reportados referem-se à composição de bytes UTF-8 e não à atribuição de tokens do Claude, e que o histórico capturado é incluído por padrão para compensar possíveis podas de transcrições.

Funciona com✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/stdcmms-lang/token-counter/tree/main/plugins/token-counter-claude/skills/token-report

Installed? Explore more Imagem skills: steipete/songsee, affaan-m/frontend-design, mattpocock/improve-codebase-architecture · View all 6 →

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

Construa um relatório de uso local do Claude Code com o script deste plugin.

O relatório lê transcrições de sessão do Claude Code e o histórico local de captura retido. Seu título usa contagens de prompts registradas: entrada base mais criação de cache mais leituras de cache. Sua visão de composição é um inventário de bytes UTF-8 rotulado, não atribuição de tokens do Claude. Ele não envia nada e não instala dependências.

Use Python 3.8 ou superior. No Windows execute:

python "${CLAUDE_SKILL_DIR}/scripts/report.py" --no-open

No macOS ou Linux execute:

python3 "${CLAUDE_SKILL_DIR}/scripts/report.py" --no-open

Adicione apenas as opções suportadas pela solicitação do usuário:

  • --since YYYY-MM-DD e --until YYYY-MM-DD selecionam dias locais capturados inclusivos.
  • --session PREFIX seleciona uma família de sessões, incluindo seus subagentes capturados e continuações.
  • --style clinical, --style matisse ou --style nocturne seleciona o estilo de abertura.
  • --json PATH escreve figuras detalhadas e contadores de qualidade de dados.
  • --metrics-only pula o inventário de bytes de texto.
  • --no-account pula completamente o arquivo de conta.
  • --sessions-root PATH seleciona outra raiz de transcrição e seu estado local separado.
  • --live-only mostra apenas transcrições atualmente presentes; o histórico retido permanece capturado.
  • --no-cache ignora o índice descartável.
  • --rebuild limpa apenas o índice descartável, reextrai arquivos ativos e mescla sem deletar histórico retido.
  • --doctor verifica caminhos, suporte de análise e estado local sem escrever ou enviar.
  • --out PATH escolhe o destino HTML.

Use python para as variantes Windows de cada comando e python3 para macOS/Linux. Mantenha o caminho do script entre aspas exatamente como mostrado.

Leia o resumo do terminal e os contadores de qualidade de dados materiais antes de descrever o resultado. Link o HTML gerado e qualquer JSON solicitado. Explique medições ausentes ou parciais. Chame o valor em dólares de "valor da lista de API", não de gasto ou conta. Diferencie contagens de tokens registradas de composição de bytes, contagens de imagens inferidas e figuras de tempo de resposta ajustadas.

O histórico capturado é incluído por padrão porque o Claude Code pode podar transcrições. Não afirme uso completo de conta ou calendário. Não limpe o histórico para reparar o índice.

A página local pode nomear a conta a partir de e-mail permitido ou metadados da organização. Saída pública e compartilhamentos omitem essa identidade. O histórico retém apenas campos de plano de conta e a data de criação da inscrição analisada.

Rótulos de plano históricos usam observações de conta capturadas. O script fornece um plano apenas quando sua regra de observação e proteção de criação de inscrição passam; caso contrário, usa null. Não invente rótulos de plano ou declarações datadas.

Uma mudança de plano que deixe subscriptionCreatedAt inalterado não é detectável até que uma execução posterior observe o novo nível. Uma janela que terminou antes dessa execução pode, portanto, carregar o plano antigo. Se essa data muda em upgrade ou downgrade não foi verificado.

Nunca abra .credentials.json, outros arquivos de credenciais, arquivos de resultado de ferramentas externas ou URLs de imagem. Nunca inspecione ou repita conteúdo de prompt, saída, pensamento ou ferramenta. Não busque preços nem instale pacotes.

Para compartilhamento público em tokenusage.dev, use o skill separado token-share apenas quando o usuário explicitamente pedir para compartilhar, publicar, atualizar ou deletar seu uso público. Executar este relatório não autoriza compartilhamento.

Habilidades Relacionadas