CommunityImagengithub.com

token-report

Informar sobre el uso de tokens de Claude Code, lecturas de caché, valor de lista de API, lecturas de cuotas y tiempos de respuesta a partir de transcripciones locales de Claude Code.

¿Qué es token-report?

El skill `token-report` permite generar informes detallados de uso de tokens, operaciones de caché, valor de lista de API y tiempos de respuesta a partir de las transcripciones locales de Claude Code. Es especialmente útil para desarrolladores que desean monitorizar el consumo de recursos sin enviar datos a servidores externos ni instalar dependencias adicionales. Funciona en sistemas Windows, macOS y Linux usando Python 3.8 o superior, y ofrece opciones como filtrado por rango de fechas, selección de sesiones, estilos de presentación y salida a JSON o HTML. El informe distingue claramente entre recuentos de tokens, composición de bytes, valores inferidos de imágenes y tiempos de respuesta calculados, y respeta la privacidad al no acceder a credenciales ni compartir datos automáticamente.

Compatible con✓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 Imagen skills: steipete/songsee, affaan-m/frontend-design, mattpocock/improve-codebase-architecture · View all 6 →

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

Construye un informe local de uso de Claude Code con el script de este plugin.

El informe lee las transcripciones de sesiones de Claude Code y el historial local capturado retenido. Su titular utiliza los recuentos de prompts registrados: entrada base más creación de caché más lecturas de caché. Su vista de composición es un inventario de bytes UTF-8 etiquetados, no una atribución de tokens de Claude. No envía nada ni instala dependencias.

Usa Python 3.8 o posterior. En Windows ejecuta:

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

En macOS o Linux ejecuta:

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

Agrega solo las opciones que admita la solicitud del usuario:

  • --since YYYY-MM-DD y --until YYYY-MM-DD seleccionan días locales capturados inclusive.
  • --session PREFIX selecciona una familia de sesiones, incluyendo sus subagentes capturados y continuaciones.
  • --style clinical, --style matisse o --style nocturne selecciona el estilo de presentación.
  • --json PATH escribe cifras detalladas y contadores de calidad de datos.
  • --metrics-only omite el inventario de bytes de texto.
  • --no-account omite por completo el archivo de cuenta.
  • --sessions-root PATH selecciona otra raíz de transcripciones y su estado local separado.
  • --live-only muestra solo las transcripciones presentes actualmente; el historial retenido permanece capturado.
  • --no-cache omite el índice desechable.
  • --rebuild limpia solo el índice desechable, reextrae archivos en vivo y fusiona sin eliminar el historial retenido.
  • --doctor verifica rutas, soporte de análisis y estado local sin escribir ni enviar.
  • --out PATH elige el destino HTML.

Usa python para las variantes de Windows de cada comando y python3 para macOS/Linux. Mantén la ruta del script entrecomillada exactamente como se muestra.

Lee el resumen del terminal y los contadores de calidad de datos materiales antes de describir el resultado. Enlaza el HTML generado y cualquier JSON solicitado. Explica las mediciones faltantes o parciales. Llama al valor en dólares "valor de lista de API", no "gasto" o "factura". Distingue los recuentos de tokens registrados de la composición de bytes, los recuentos de imágenes inferidos y las cifras de tiempo de respuesta ajustadas.

El historial capturado se incluye por defecto porque Claude Code puede podar las transcripciones. No afirmes un uso completo de cuenta o calendario. No borres el historial para reparar el índice.

La página local puede nombrar la cuenta a partir del correo electrónico permitido o de metadatos de organización. Las salidas públicas y las comparticiones omiten esa identidad. El historial retiene solo los campos del plan de cuenta y la fecha de creación de suscripción analizada.

Las etiquetas históricas del plan utilizan observaciones de cuenta capturadas. El script proporciona un plan solo cuando su regla de observación y la protección de creación de suscripción pasan; de lo contrario, usa null. No inventes etiquetas de plan ni declaraciones fechadas.

Un cambio de plan que deje subscriptionCreatedAt sin cambios no se detecta hasta que una ejecución posterior observe el nuevo nivel. Por lo tanto, una ventana que terminó antes de esa ejecución puede llevar el plan anterior. No se ha verificado si esa fecha cambia en una actualización o degradación.

Nunca abras .credentials.json, otros archivos de credenciales, archivos de resultados de herramientas externas o URL de imágenes. Nunca inspecciones ni repitas el contenido del prompt, la salida, el pensamiento o la herramienta. No obtengas precios ni instales paquetes.

Para compartir públicamente en tokenusage.dev, usa el skill separado token-share solo cuando el usuario solicite explícitamente compartir, publicar, actualizar o eliminar su uso público. Ejecutar este informe no autoriza la compartición.

Skills relacionados