Análise de dados com o Claude Code: consultas, CSVs e um resumo semanal

O que o Claude Code faz em análise de dados

• Responde perguntas com SQL usando um role somente leitura ou uma réplica, e mostra a consulta junto com a resposta.
• Limpa e analisa exportações em CSV com Python e desenha os gráficos.
• Escreve um resumo semanal de métricas: o que mudou, quanto e o motivo provável.
• Aponta anomalias, como uma queda nos cadastros ou um pico de erros, antes que alguém precise notar.

Recursos do Claude Code para análise de dados

Como configurar o Claude Code para análise de dados

1. Conecte as ferramentas

   Crie um role somente leitura no banco de dados e dê essa conexão ao Claude Code, ou a CLI do seu warehouse logada como um usuário somente leitura. Para uma análise avulsa, coloque as exportações em CSV na pasta de trabalho.

   -- Postgres: um role somente leitura para o agente
   CREATE ROLE analyst LOGIN PASSWORD '<password>';
   GRANT pg_read_all_data TO analyst;

2. Escreva as regras no CLAUDE.md

   O Claude Code lê o CLAUDE.md no início de toda sessão, inclusive nas execuções com claude -p. Coloque ali as regras do trabalho, ou em uma skill em .claude/skills/ se forem longas. Veja o guia do CLAUDE.md.

   ## Regras de dados
   - Somente leitura: use o role de analytics, nunca o usuário do
     banco do app. Nada de INSERT, UPDATE, DELETE ou mudanças de schema.
   - Mostre a consulta ou o script por trás de cada número.
   - Compare com o período anterior e diga quando uma mudança está
     dentro do ruído normal.
   - Não exporte dados pessoais; agregue antes de anotar qualquer
     coisa.
   - Resumo semanal: os cinco números que importam, o que mudou e
     uma pergunta que vale fazer na semana que vem.

3. Rode sem a interface interativa

   claude -p roda uma tarefa e encerra, então o cron, o CI ou outra ferramenta pode iniciá-lo. Escolha o que ele pode fazer sem pedir com --allowedTools ou --permission-mode; --output-format json devolve o resultado com o custo.

   # Os números da semana passada em JSON, para um dashboard ou um post
   claude -p "Compare cadastros, ativação e receita da semana passada com a semana anterior" \
     --output-format json --json-schema "$(cat metrics.schema.json)"

4. Coloque em um agendamento

   Transforme-o em uma tarefa agendada na nuvem com /schedule (Pro, Max, Ultra, Team e Enterprise) ou em uma tarefa agendada no desktop, ou use /loop enquanto uma sessão fica aberta. Veja como deixar o Claude Code proativo.

Fonte: documentação do Claude Code

Limites e segurança

• Dê a ele um role somente leitura. Um agente com permissão de escrita no banco consegue alterá-lo.
• Ele pode entender errado o que uma coluna significa. Escreva um dicionário de dados curto e confira as primeiras respostas.
• Resultados grandes custam contexto e uso. Consulte e agregue antes de ler linhas.
• Desde o Claude Code v2.1.302, claude -p começa no modo Manual: uma ação que precisa de aprovação é negada, a menos que uma regra a permita. Permita só as ferramentas de que o trabalho precisa.

Claude Code ou Codex para análise de dados?

As regras valem para os dois. Escreva-as uma vez no AGENTS.md e coloque @AGENTS.md no CLAUDE.md, e os dois agentes leem o mesmo arquivo.

Passo a passo para o outro agente: análise de dados com o Codex.

Coloque alguém responsável por análise de dados

Comandos rodam quando alguém lembra de rodá-los. O Crewmark transforma o seu próprio Claude Code em um funcionário de IA com um cargo, uma meta em números, horário de trabalho e um heartbeat, então o trabalho acontece no horário e aparece em um quadro.

1. Comece pelo cargo

   O cargo de funcionário de IA que você escolher, com estas regras no brief.

2. Leve o trabalho para o quadro dele

   Adicione o trabalho como issue recorrente. O funcionário acorda com o heartbeat, faz o trabalho e relata em um comentário.

3. Veja também

   O relatório diário de SEO é um exemplo prático de um trabalho recorrente de analytics.

Perguntas frequentes