Claude Code /insights: um check-up dos seus hábitos de código
Um único comando slash lê suas sessões recentes e devolve um relatório HTML: no que você trabalha, onde há atrito e quais correções vêm primeiro. Doze passos ilustrados a partir de dois terminais reais.
Resumo
- Digite /insights em qualquer sessão do Claude Code — ele analisa até 200 sessões nesta máquina e pula as muito curtas.
- Cerca de um minuto depois, o relatório HTML aparece em ~/.claude/usage-data/report.html; cada execução também salva uma cópia com carimbo de data/hora.
- O relatório cobre no que você trabalha, como usa o Claude Code, pontos de atrito e recursos para experimentar — com links ou prompts prontos para colar.
- Peça à mesma sessão para destilar o relatório ("top 3 conselhos acionáveis") e deixe o Claude escrever as correções no seu CLAUDE.md e nos hooks.
Claude Code Course 15 - The /insights Report
Canal: Code Playbook5:09
Claude Code: 5 New "Minor" Features You May Have Missed
Canal: AI Coding Daily6:31
Analyze your usage patterns (official docs)
Docs: code.claude.com
Os fatos desta página foram conferidos com o changelog e a documentação oficial do Claude Code: o /insights analisa até 200 sessões nunca vistas na sua máquina, pula as muito curtas e escreve report.html mais uma cópia com carimbo em ~/.claude/usage-data/ (limpeza após cleanupPeriodDays — 30 dias por padrão).
As capturas vêm das duas gravações dos criadores acima, com a sobreposição da câmera cortada; cada passo aponta para o segundo exato do vídeo original.
Executar /insights, ler o relatório, entregar as correções
Executar o comando (passos 1–3)
- 1
Saiba o que o /insights faz antes de executar
A Anthropic anunciou o /insights como um comando que lê seu histórico de mensagens do último mês, resume seus projetos e como você usa o Claude Code, e sugere melhorias de fluxo de trabalho. Ele relata como você trabalha — não quantos tokens queimou.
A publicação oficial do anúncio, mostrada no vídeo do AI Coding Daily.Ver em 0:35 - 2
Digite /insights em qualquer projeto
Abra o Claude Code em qualquer pasta e execute /insights. A análise cobre todas as suas sessões recentes nesta máquina, não só o projeto atual. Um spinner gira enquanto o Claude lê seu histórico — espere cerca de um minuto.
/insights em execução na gravação do Code Playbook; o spinner conta enquanto as sessões são analisadas.Ver em 0:50 - 3
Espere a mensagem "report is ready"
Ao terminar, o Claude Code imprime o caminho do relatório: ~/.claude/usage-data/report.html — e pergunta se você quer explorar uma seção ou testar uma sugestão. Responda direto na sessão.
A mensagem de conclusão com o caminho do report.html, da segunda gravação.Ver em 0:45
Ler o relatório (passos 4–8)
- 4
Abra o report.html e comece pelo cabeçalho
O relatório é um único arquivo HTML local. O cabeçalho mostra seus totais — mensagens, linhas adicionadas e removidas, arquivos tocados, dias ativos, mensagens por dia — e oito pílulas de seções, de What You Work On a Team Feedback.
Estatísticas do cabeçalho de uma análise de 176 sessões: 936 mensagens em 14 dias ativos.Ver em 2:10 - 5
Leia primeiro o cartão At a Glance
O cartão de abertura resume o relatório inteiro em quatro parágrafos: o que está funcionando, o que está atrapalhando, vitórias rápidas para tentar e fluxos ambiciosos. Aqui o Claude aponta atrito de sintaxe recorrente e sugere convenções de CLAUDE.md mais um hook de verificação de build.
O resumo At a Glance — o caminho mais rápido para decidir o que atacar.Ver em 1:48 - 6
Veja como você realmente usa o Claude Code
A seção How You Use CC grafica o que você pediu, quais ferramentas o Claude usou (Read, Edit, Bash…), seus idiomas e tipos de sessão como tarefa única ou refinamento iterativo. O criador acima descobriu que seu fluxo "planejar e depois executar" era sua maior força.
Gráficos de uso do relatório: ferramentas mais usadas, idiomas e tipos de sessão.Ver em 2:18 - 7
Confira o detalhamento por projeto
What You Work On lista seus projetos recentes com uma descrição do que você construiu em cada um e quantas sessões levou — um jeito rápido de ver qual projeto gerou mais idas e voltas.
Cartões de projeto com contagem de sessões, da segunda gravação.Ver em 1:25 - 8
Encare a seção de atrito
O relatório quantifica o que deu errado: tipos de atrito principais como código com bugs ou abordagem errada, e uma pontuação de satisfação estimada pelo modelo. Abaixo, Existing CC Features to Try sugere acréscimos concretos — regras de CLAUDE.md, hooks, até um skill /plan personalizado.
Tipos de atrito, estimativa de satisfação e sugestões de recursos.Ver em 1:40
Transformar achados em correções (passos 9–11)
- 9
Use os blocos PASTE INTO CLAUDE CODE
Muitas sugestões vêm como prompts prontos. Este define um ciclo construir-verificar-corrigir: após cada edição rode o typecheck, analise os erros, corrija todos, recompile e faça grep de cada uso do tipo alterado. Clique em Copy e cole numa sessão.
Um prompt para copiar gerado pelo relatório — sem engenharia de prompt.Ver em 2:35 - 10
Peça à mesma sessão para destilar
O relatório é longo. Peça ao Claude na mesma sessão: "give me the top 3 actionable pieces of advice, summarized in less than 200 words". Você recebe uma lista curta extraída do relatório — e pode continuar perguntando.
O pedido do top três logo depois que o relatório ficou pronto.Ver em 2:55 - 11
Deixe o Claude implementar as correções
Saída típica do top três: adicionar arquivos de convenções CLAUDE.md em cada repositório, configurar um hook de build pós-edição no .claude/settings.json e adicionar uma regra de "rastrear todos os usos antes do commit". Diga sim e o Claude escreve as entradas do CLAUDE.md e a configuração do hook para você.
As três correções sugeridas — cada uma o Claude pode aplicar diretamente.Ver em 3:45
Guardar e compartilhar o relatório (passo 12)
- 12
Guarde ou compartilhe o arquivo HTML
O report.html é um arquivo local autossuficiente — reabra no navegador quando quiser ou envie a um colega. Cada execução salva uma cópia nova com carimbo, e a limpeza remove o que for mais velho que cleanupPeriodDays (30 dias por padrão).
O relatório vive numa URL file:/// simples — funciona offline.Ver em 2:06
Novo na v2.1.281: a recomendação de auto mode
O changelog do Claude Code v2.1.281 adicionou ao /insights uma recomendação de auto mode: o relatório agora estima quantas solicitações de permissão o auto mode teria tratado nas suas sessões recentes. Se o seu dia vai em aprovações, atualize, rode o /insights de novo e veja quantas solicitações o relatório acha que o auto mode absorveria.
Ler a entrada do changelog v2.1.281