claude-token-analyzer

Claude Token Analyzer

Suas sessões do Claude Code podem estar queimando tokens que você não vê. Diagnostica para onde seus tokens vão, por que são desperdiçados e o que corrigir primeiro.

Totalmente local — analisa seus arquivos JSONL do ~/.claude no SQLite. Nada sai da sua máquina. Sem nuvem. Sem telemetria.

English | 繁體中文

Recursos

• Diagnosticar desperdício de tokens — Detecta 6 tipos de anomalias estatísticas (HighCost, LowCacheHitRate, CostInefficient, ExcessiveToolUse, HighTokenUsage, UnusualModelMix) com pontuação de gravidade
• Auditar custos — Detalhamento de custos por sessão, por projeto e global, com tendências mensais
• Prever gastos — Tendências de uso diárias/semanais/mensais com projeções de taxa de consumo
• Otimizar cache — Identifica sessões com taxas ruins de acerto de cache que inflam custos
• Priorizar correções — Anomalias com pontuação de gravidade para você saber o que corrigir primeiro, não apenas o que está errado
• Conversar naturalmente — Pergunte em linguagem simples: "quanto gastei?" ou "procure anomalias"

Início Rápido

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

Depois é só perguntar em qualquer sessão do Claude Code:

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

Como 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 o processamento acontece localmente. O banco de dados SQLite fica no diretório de dados do plugin no modo plugin e recorre ao ~/.claude/ no modo autônomo. Sem chamadas de rede, sem dependências externas em tempo de execução.

Habilidades

Habilidade	Frases de Ativação	O Que Faz
cta	"cta", "analyze tokens"	Roteia para a sub-habilidade correta
cta-health-check	"quick check", "overview", "看看狀況"	Resumo de uso em uma página
cta-cost-audit	"monthly costs", "cost report", "這個月花多少"	Detalhamento de custos mensais com divisão por modelo
cta-anomaly-hunt	"anomalies", "problems", "有異常嗎"	Varredura de anomalias estatísticas com detalhamento
cta-project-review	"analyze project", "專案健檢"	Análise de projeto em quatro dimensões
cta-trend-watch	"trends", "burn rate", "趨勢"	Análise de tendências de uso com previsão

Ferramentas MCP

Ferramenta	Finalidade
sync_db	Sincroniza logs de sessão JSONL para o SQLite
analyze_session	Análise de sessão em 10 dimensões
analyze_project	Agregação em nível de projeto com ordenação
analyze_global	Visão panorâmica entre projetos
cost_report	Relatório de custos mensais (granularidade diária disponível)
anomaly_scan	Detecção de anomalias em 6 tipos com pontuação de gravidade
trend_report	Tendências de séries temporais (diárias/semanais/mensais)

Configuração

Variáveis de ambiente (todas opcionais):

Variável	Finalidade	Padrão
CTA_DB_PATH	Localização do banco de dados SQLite	${CLAUDE_PLUGIN_ROOT}/data/token-analyzer.db ou ~/.claude/token-analyzer.db
CTA_PROJECTS_DIR	Diretório de logs de sessão	${CLAUDE_CONFIG_DIR}/projects ou ~/.claude/projects
CTA_ARCHIVE_DIR	Diretório de arquivamento	${CLAUDE_PLUGIN_ROOT}/data/token-analyzer-archive ou ~/.claude/token-analyzer-archive
CTA_PRICING_PATH	TOML de preços personalizado	Incorporado no binário
CLAUDE_CONFIG_DIR	Raiz de configuração do Claude para logs de sessão	não definido

Prioridade de resolução de caminhos:

• Banco de dados/arquivo: variável de ambiente > modo plugin ($CLAUDE_PLUGIN_ROOT) > modo autônomo ($HOME/.claude/)
• Projetos: variável de ambiente > diretório de configuração do Claude ($CLAUDE_CONFIG_DIR/projects) > modo autônomo ($HOME/.claude/projects)

Compilação a partir do Código-Fonte

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 .

Requer: Ferramentas Rust

Contribuição

Issues e PRs são bem-vindos! Veja issues abertas para tarefas iniciais.

Configuração de desenvolvimento:

1. Clone o repositório e execute bash scripts/build.sh
2. Execute cargo test --all-targets --manifest-path mcp-server/Cargo.toml para verificar
3. Carregue o plugin localmente com claude --plugin-dir .

Ferramentas Rust são necessárias. O projeto usa cargo clippy -- -D warnings para linting.

Licença

MIT

---

繁體中文

Suas sessões do Claude Code podem estar desperdiçando tokens que você não vê. Diagnostica o fluxo de tokens, os motivos do desperdício e o que corrigir com prioridade.

Totalmente local — analisa arquivos JSONL do ~/.claude no SQLite. Seus dados não saem da sua máquina. Sem nuvem, sem telemetria.

Recursos

• Diagnosticar desperdício de tokens — 6 tipos de anomalias estatísticas com pontuação de gravidade
• Auditoria de custos — Detalhamento de custos por sessão, projeto e global, com tendências mensais
• Previsão de tendências — Tendências de uso diárias/semanais/mensais e previsão de taxa de consumo
• Otimização de cache — Identifica sessões com baixa taxa de acerto de cache, reduzindo gastos desnecessários
• Ordenação por gravidade — Prioriza os problemas de maior impacto, não apenas marca anomalias
• Interação em linguagem natural — Pergunte diretamente em chinês: 「看看狀況」「這個月花多少」「有異常嗎」

Início Rápido

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

Depois é só perguntar diretamente no Claude Code:

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

Visão geral das habilidades

Habilidade	Frases de Ativação	Função
cta	"cta"、"分析 token"	Roteamento inteligente para sub-habilidades
cta-health-check	"看看狀況"、"總覽"	Resumo de uso em uma página
cta-cost-audit	"這個月花多少"、"成本報告"	Detalhamento de custos mensais
cta-anomaly-hunt	"有異常嗎"、"排查"	Varredura de anomalias estatísticas
cta-project-review	"專案健檢"	Análise de projeto em quatro dimensões
cta-trend-watch	"趨勢"、"燃燒率"	Análise de tendências de uso

Desenvolvedores de Taiwan e da Ásia são bem-vindos para testar e enviar feedback!