claude-token-analyzer

Claude Token Analyzer

Tus sesiones de Claude Code podrían estar quemando tokens que no puedes ver. Diagnostica a dónde van tus tokens, por qué se desperdician y qué corregir primero.

Totalmente local — analiza tus archivos JSONL de ~/.claude en SQLite. Nada sale de tu máquina. Sin nube. Sin telemetría.

English | 繁體中文

Características

• Diagnostica el desperdicio de tokens — Detecta 6 tipos de anomalías estadísticas (HighCost, LowCacheHitRate, CostInefficient, ExcessiveToolUse, HighTokenUsage, UnusualModelMix) con puntuación de severidad
• Audita costos — Desglose de costos por sesión, por proyecto y global con tendencias mensuales
• Pronostica gastos — Tendencias de uso diarias/semanales/mensuales con proyecciones de tasa de consumo
• Optimiza caché — Identifica sesiones con malas tasas de acierto de caché que inflan los costos
• Prioriza correcciones — Anomalías con puntuación de severidad para saber qué corregir primero, no solo qué está mal
• Conversa naturalmente — Pregunta en lenguaje sencillo: "¿cuánto gasté?" o "busca anomalías"

Inicio Rápido

# Install (binary auto-downloads, no Rust toolchain needed)
claude plugin install claude-token-analyzer

Luego solo pregunta en cualquier sesión de Claude Code:

> cta
> how much did I spend this month?
> scan for anomalies
> analyze this project
> show me usage trends

Cómo Funciona

~/.claude/projects/**/*.jsonl       Your session logs (never modified)
    → parser.rs                     Extract + deduplicate responses
    → analyzer.rs                   Cost calculation, 10-dimension metrics
    → storage.rs                    Upsert into local SQLite
    → detector.rs                   6-type anomaly detection + severity scoring
    → MCP tools / Skills            You ask, it answers

Todo el procesamiento ocurre localmente. La base de datos SQLite se encuentra en el directorio de datos del plugin en modo plugin y recurre a ~/.claude/ en modo independiente. Sin llamadas de red, sin dependencias externas en tiempo de ejecución.

Habilidades

Habilidad	Frases de Activación	Qué Hace
cta	"cta", "analyze tokens"	Enruta a la sub-habilidad correcta
cta-health-check	"quick check", "overview", "看看狀況"	Resumen de uso en una página
cta-cost-audit	"monthly costs", "cost report", "這個月花多少"	Desglose de costos mensuales con división por modelo
cta-anomaly-hunt	"anomalies", "problems", "有異常嗎"	Escaneo de anomalías estadísticas con desglose
cta-project-review	"analyze project", "專案健檢"	Análisis de proyecto en cuatro dimensiones
cta-trend-watch	"trends", "burn rate", "趨勢"	Análisis de tendencias de uso con pronóstico

Herramientas MCP

Herramienta	Propósito
sync_db	Sincroniza registros de sesión JSONL a SQLite
analyze_session	Análisis de sesión en 10 dimensiones
analyze_project	Agregación a nivel de proyecto con ordenamiento
analyze_global	Vista panorámica entre proyectos
cost_report	Informe de costos mensuales (disponible granularidad diaria)
anomaly_scan	Detección de anomalías de 6 tipos con puntuación de severidad
trend_report	Tendencias de series temporales (diarias/semanales/mensuales)

Configuración

Variables de entorno (todas opcionales):

Variable	Propósito	Predeterminado
CTA_DB_PATH	Ubicación de la base de datos SQLite	${CLAUDE_PLUGIN_ROOT}/data/token-analyzer.db o ~/.claude/token-analyzer.db
CTA_PROJECTS_DIR	Directorio de registros de sesión	${CLAUDE_CONFIG_DIR}/projects o ~/.claude/projects
CTA_ARCHIVE_DIR	Directorio de archivo	${CLAUDE_PLUGIN_ROOT}/data/token-analyzer-archive o ~/.claude/token-analyzer-archive
CTA_PRICING_PATH	TOML de precios personalizados	Integrado en el binario
CLAUDE_CONFIG_DIR	Raíz de configuración de Claude para registros de sesión	sin establecer

Prioridad de resolución de rutas:

• BD/archivo: variable de entorno > modo plugin ($CLAUDE_PLUGIN_ROOT) > modo independiente ($HOME/.claude/)
• Proyectos: variable de entorno > directorio de configuración de Claude ($CLAUDE_CONFIG_DIR/projects) > modo independiente ($HOME/.claude/projects)

Compilación desde el Código Fuente

git clone https://github.com/li195111/claude-token-analyzer.git
cd claude-token-analyzer
bash scripts/build.sh
# Binary: mcp-server/target/release/cta-mcp-server

# Run tests (106 tests)
cargo test --all-targets --manifest-path mcp-server/Cargo.toml

# Lint
cargo clippy --manifest-path mcp-server/Cargo.toml -- -D warnings

# Launch with plugin loaded
claude --plugin-dir .

Requiere: cadena de herramientas de Rust

Contribuciones

¡Se aceptan issues y PRs! Consulta issues abiertos para tareas iniciales.

Configuración de desarrollo:

1. Clona el repositorio y ejecuta bash scripts/build.sh
2. Ejecuta cargo test --all-targets --manifest-path mcp-server/Cargo.toml para verificar
3. Carga el plugin localmente con claude --plugin-dir .

Se requiere la cadena de herramientas de Rust. El proyecto usa cargo clippy -- -D warnings para linting.

Licencia

MIT

---

繁體中文

Tus sesiones de Claude Code podrían estar desperdiciando tokens que no puedes ver. Diagnostica el flujo de tokens, las causas del desperdicio y qué corregir primero.

Totalmente local — Analiza archivos JSONL de ~/.claude en SQLite. Los datos no salen de tu máquina. Sin nube, sin telemetría.

Características

• Diagnostica el desperdicio de tokens — 6 tipos de anomalías estadísticas con puntuación de severidad
• Auditoría de costos — Desglose de costos por sesión, proyecto y global con tendencias mensuales
• Pronóstico de tendencias — Tendencias de uso diarias/semanales/mensuales con predicción de tasa de consumo
• Optimización de caché — Identifica sesiones con baja tasa de acierto de caché para reducir gastos innecesarios
• Orden por severidad — Prioriza los problemas de mayor impacto, no solo marca anomalías
• Interacción en lenguaje natural — Pregunta directamente: "看看狀況" "這個月花多少" "有異常嗎"

Inicio Rápido

# 安裝（自動下載 binary，無需 Rust 工具鏈）
claude plugin install claude-token-analyzer

Luego pregunta directamente en Claude Code:

> 看看狀況
> 這個月花多少？
> 有異常嗎？
> 分析這個專案
> 用量趨勢

Lista de Habilidades

Habilidad	Frases de Activación	Función
cta	"cta", "分析 token"	Enrutamiento inteligente a sub-habilidades
cta-health-check	"看看狀況", "總覽"	Resumen de uso en una página
cta-cost-audit	"這個月花多少", "成本報告"	Detalle de costos mensuales
cta-anomaly-hunt	"有異常嗎", "排查"	Escaneo de anomalías estadísticas
cta-project-review	"專案健檢"	Análisis de proyecto en cuatro dimensiones
cta-trend-watch	"趨勢", "燃燒率"	Análisis de tendencias de uso

¡Bienvenidos los desarrolladores de Taiwán y Asia a probar y dar retroalimentación!