Claude Monitor — Diagnóstico de Performance

Visão Geral

Monitor de performance do Claude Code e do sistema local. Diagnostica lentidão, mede CPU/RAM/disco, verifica latência da API e gera relatórios de saúde do sistema.

Quando Usar Esta Ferramenta

• Quando o usuário mencionar "lento" ou tópicos relacionados
• Quando o usuário mencionar "lentidão" ou tópicos relacionados
• Quando o usuário mencionar "lag" ou tópicos relacionados
• Quando o usuário mencionar "lagado" ou tópicos relacionados
• Quando o usuário mencionar "travando" ou tópicos relacionados
• Quando o usuário mencionar "claude lento" ou tópicos relacionados

Não Usar Esta Ferramenta Quando

• A tarefa não está relacionada ao monitoramento do Claude
• Uma ferramenta mais simples e específica pode resolver a solicitação
• O usuário precisa de assistência de propósito geral sem conhecimento específico do domínio

Como Funciona

Ferramenta para diagnosticar e resolver problemas de lentidão no Claude Code e no sistema. Determina se o gargalo é local (PC) ou remoto (API Claude) e sugere ações corretivas.

Quando Usar

• Usuário reclama que o Claude Code está lento ou travando
• Troca de sessões de conversa demora para carregar
• Respostas do Claude demoram muito
• PC parece lento enquanto usa o Claude Code
• Qualquer menção a performance, lag, lentidão

1. Diagnóstico Rápido (Health_Check.Py)

Execute SEMPRE como primeiro passo:

python C:\Users\renat\skills\claude-monitor\scripts\health_check.py

O script analisa em ~3 segundos:

• CPU: Uso atual e por núcleo. >80% = gargalo provável
• RAM: Total, usada, disponível. >85% = pressão de memória
• Navegadores: Processos e RAM por navegador. >5GB total = excesso de abas
• Claude Code: Processos e RAM consumida
• Disco: Espaço livre. <10% = impacto em swap/performance
• Rede: Latência para o endpoint da API Claude
• Diagnóstico: Classificação automática do problema com sugestões

2. Interpretar O Resultado

O script retorna um JSON com diagnosis contendo:

• bottleneck: "cpu" | "ram" | "browsers" | "disk" | "network" | "claude_api" | "ok"
• severity: "critical" | "warning" | "ok"
• suggestions: Lista de ações recomendadas
• summary: Resumo em português para mostrar ao usuário

Mostre o summary ao usuário e ofereça executar as sugestões.

3. Ações Corretivas Automáticas

Baseado no diagnóstico, ofereça ao usuário:

Se CPU alta (>80%):

• Listar processos consumindo mais CPU
• Sugerir fechar processos pesados desnecessários
• Verificar se o Windows Update está rodando em segundo plano

Se navegadores pesados (>5GB RAM ou >40 processos):

python C:\Users\renat\skills\claude-monitor\scripts\health_check.py --browsers-detail

Mostra RAM por navegador e sugere quais fechar. Nunca feche processos sem permissão explícita do usuário.

Se disco cheio (>85%):

• Mostrar pastas maiores
• Sugerir limpeza de arquivos temporários, cache de navegadores, lixeira

Se rede lenta (latência >500ms):

• Testar conexão com api.anthropic.com
• Sugerir verificar VPN, proxy ou conexão WiFi

4. Monitoramento Contínuo (Opcional)

Se o usuário quiser monitoramento em segundo plano:

python C:\Users\renat\skills\claude-monitor\scripts\monitor.py --interval 30 --duration 300

Parâmetros:

• --interval: Segundos entre cada amostra (padrão: 30)
• --duration: Duração total em segundos (padrão: 300 = 5 min)
• --output: Caminho do arquivo de log (padrão: monitor_log.json)
• --alert-cpu: Limite de CPU para alerta (padrão: 80)
• --alert-ram: Limite de RAM % para alerta (padrão: 85)

O monitor salva snapshots periódicos e gera um relatório ao final com:

• Picos de CPU e RAM
• Tendência (melhorando/piorando/estável)
• Eventos de alerta detectados
• Recomendação final

5. Benchmark Da API Claude (Opcional)

Para testar se a lentidão é da API:

python C:\Users\renat\skills\claude-monitor\scripts\api_bench.py

Mede o tempo de resposta do processo Claude Code local (não faz chamadas à API). Compara com tempos típicos e indica se está dentro do esperado.

Limites de Referência

Dicas Para O Usuário

Quando apresentar o diagnóstico, inclua estas dicas contextuais:

• Muitas abas = muito CPU/RAM: Cada aba de navegador é um processo separado.

…