Aulas — Setup 1
Assista as aulas gravadas do Setup 1 antes de começar o setup. Cada aula complementa as etapas práticas que você vai executar a seguir.
Instalar Pré-requisitos
Antes de começar, você precisa ter alguns programas instalados. Não se preocupe — o Claude vai verificar tudo automaticamente e te avisar se estiver faltando algo.
Claude Code — o assistente de setup
Abra o terminal e cole o comando abaixo:
npm install -g @anthropic-ai/claude-code
Python, Node.js, Git e Docker Desktop
Escolha seu sistema operacional e siga as instruções:
brew install python@3.11 node git && brew install --cask docker. Depois abra o Docker Desktop e aguarde iniciar.Primeiro Acesso — Clonar e Abrir
Com os pré-requisitos instalados, você vai clonar o repositório e abrir o Claude. A partir daí, o Claude conduz tudo sozinho — você não precisa digitar mais nenhum comando.
git clone https://github.com/zxmarketingdigital/zx-control-semana1.git && \ cd zx-control-semana1 && \ claude
O que acontece quando você rodar esse comando
O Git baixa o repositório, entra na pasta e abre o Claude Code. O Claude vai se apresentar e aguardar você dar o sinal para começar.
Na primeira vez, o Claude vai se autenticar
Se for seu primeiro uso do Claude Code, ele vai pedir para você fazer login com sua conta Anthropic. Siga as instruções na tela (é só abrir um link no navegador).
Digite INICIAR SETUP para começar
Quando o Claude aparecer e se apresentar, você escreve exatamente isso e pressiona Enter:
INICIAR SETUPA partir daí o Claude conduz tudo — você não precisa mais digitar nenhum comando técnico.
Configurar o Ambiente
O Claude vai coletar algumas informações sobre você e seu negócio, e criar toda a estrutura de pastas da sua operação IA no computador.
Seu nome
Para personalizar o agente e os relatórios com seu nome.
Nome do seu negócio
Usado nas mensagens do agente e nos relatórios de status.
O Claude vai perguntar qual provedor de WhatsApp você quer usar
Você tem duas opções — escolha a que melhor se encaixa no seu cenário:
~/.operacao-ia/ ├── config/ │ └── config.json # suas configurações ├── scripts/ # scripts de automação ├── data/ # banco de contatos └── logs/ # relatórios e logs
Conectar o WhatsApp
O Claude vai instalar e configurar o provedor de WhatsApp escolhido. Você vai escanear um QR Code com seu celular para conectar o número.
Evolution API — roda no seu computador
O Claude instala e configura tudo automaticamente. Ele vai exibir um QR Code para você escanear com o WhatsApp do celular.
Z-API — roda na nuvem (R$97/mês)
O Claude vai pedir seu Instance ID e Token. Você encontra esses dados no painel em app.z-api.io após criar sua conta.
Escaneie o QR Code (apenas Evolution API)
O QR Code vai aparecer direto na janela do Claude. Abra o WhatsApp no celular → Dispositivos Conectados → Adicionar Dispositivo → escaneie o código.
Configurar o Email
Vamos conectar o email para envio de notificações e comunicações. Usamos a Resend, uma plataforma confiável com plano gratuito generoso.
Crie uma conta gratuita em resend.com
O plano gratuito inclui 3.000 emails/mês e 100/dia — mais do que suficiente para começar.
Acesse API Keys no painel da Resend
No menu lateral: API Keys → Add API Key. Dê um nome como "ZX Control" e copie a chave gerada.
Cole a API Key quando o Claude pedir
O Claude vai pedir a chave e enviar um email de teste para confirmar que tudo está funcionando.
Ativar o Agente IA
Aqui você configura o agente IA que vai responder seus leads no WhatsApp usando metodologia BANT — qualificando e encaminhando para o fechamento automaticamente.
API Key do provedor escolhido
O Claude vai pedir sua chave e testar com uma mensagem simples para garantir que está funcionando.
Nome e tom do agente
Como o agente vai se apresentar para seus leads: nome, se é mais formal ou informal, foco em vendas ou suporte.
O agente é instalado em ~/.operacao-ia/scripts/
Com um script de inicialização pronto para rodar quando você quiser ativar.
Importar seus Contatos
Importe a lista de contatos para quem você quer enviar mensagens. O sistema aceita CSV ou colagem direta — sem precisar de planilha online.
Colar diretamente no terminal
O Claude vai pedir que você cole seus contatos no formato abaixo, um por linha. Quando terminar, deixe uma linha em branco e pressione Enter.
# nome,telefone (com DDD, sem espaços) João Silva,11999990001 Maria Santos,21988880002 Carlos Oliveira,31977770003
Informar o caminho de um arquivo CSV
Se tiver um arquivo CSV, informe o caminho completo (ex: ~/Downloads/contatos.csv). O Claude detecta o separador automaticamente.
O que acontece automaticamente
Telefones são validados e normalizados (DDI +55 adicionado automaticamente). Uma lista é salva em ~/.operacao-ia/data/contacts.db.
Configurar Disparos
O sistema de disparo envia mensagens para sua lista com proteção automática contra bloqueio. Você sempre revisa antes de enviar qualquer coisa.
Peça ao Claude para montar o disparo
Dentro do Claude, você diz a mensagem que quer enviar e para quem. O Claude monta tudo e mostra um preview com os primeiros contatos antes de enviar qualquer coisa.
"Claude, quero enviar para minha lista: Oi {nome}, tudo bem? Tenho uma novidade para te contar. Mostra o preview antes de enviar."
Revise o preview e confirme
O Claude mostra como ficará cada mensagem com o nome real de cada contato. Só depois de você confirmar ele começa a enviar — nunca sem sua aprovação.
Filtre por grupo ou tag quando quiser
Você pode pedir ao Claude para enviar só para um grupo específico de contatos. Exemplo: "Envia só para os contatos com a tag 'clientes ativos'."
Ativar o Monitor Diário
O monitor verifica automaticamente se todos os serviços estão funcionando e te envia um relatório no próprio WhatsApp todo dia às 8h da manhã.
O Claude instala o monitor automaticamente
O monitor é registrado como um serviço do sistema e começa a rodar todo dia às 8h — sem você precisar fazer nada.
Primeiro health check imediato
O Claude vai perguntar se você quer rodar o monitor agora para ver o status de tudo que foi configurado.
Teste Final e Operação Pronta
Último passo! O Claude vai guiar você pelo primeiro teste de disparo e confirmar que a Operação IA está completamente funcional.
Resumo de tudo que foi configurado
O Claude mostra um painel completo com status de cada componente: WhatsApp, Email, Agente IA, Contatos, Dispatcher e Monitor.
Primeiro disparo guiado — dentro do Claude
O Claude conduz você pelo primeiro teste de envio. Ele mostra como ficará a mensagem para cada contato antes de qualquer coisa ser enviada. Você aprova e ele dispara.
"Faz o teste do primeiro disparo para minha lista."
Ele cuida do resto.
Operação IA pronta
A partir de agora, sua operação funciona de forma autônoma. O agente responde leads, o monitor avisa se algo der errado, e você dispara quando quiser.
✅ Checklist da Operação IA Completa
Aulas — Setup 2
Assista a gravação da Mentoria com o passo a passo completo do Setup 2 antes de começar.
Primeiro Acesso — Setup 2
Clone o repositório do Setup 2 e abra o Claude. A partir daí, o Claude conduz todo o setup — você não precisa digitar mais nenhum comando técnico.
claude --version deve funcionar)gh auth status deve mostrar "Logged in")gh repo clone zxmarketingdigital/zx-control-semana2 ~/zx-control-semana2 && \ cd ~/zx-control-semana2 && \ claude
O que acontece quando você rodar esse comando
O GitHub CLI baixa o repositório, entra na pasta e abre o Claude Code. O Claude vai se apresentar e aguardar você dar o sinal para começar.
brew install gh (macOS) ou acesse cli.github.com.Digite INICIAR SETUP 2 para começar
Quando o Claude aparecer e se apresentar, você escreve exatamente isso:
INICIAR SETUP 2O Claude faz tudo a partir daqui — você não precisa digitar mais nada.
Independente do Setup 1
Se você pulou o Setup 1, o setup do Setup 2 cria o ambiente mínimo necessário automaticamente. Nada vai quebrar.
O que o Claude faz automaticamente
Ao receber o comando de início, o Claude executa uma série de verificações sem você precisar digitar mais nada:
~/.operacao-ia/config/config.jsonMission Control
Um painel HTML gerado pelo Claude que centraliza tudo da sua operação — links, status, scripts e logs — num arquivo que você abre direto no browser.
Como o Claude gera o Mission Control
O Claude analisa os serviços que você instalou e gera automaticamente um arquivo HTML em:
~/.zxlab-mission-control/dashboard.htmlCada módulo instalado (WhatsApp, agente IA, email, disparos) ganha um card próprio com status e links.
Como abrir no browser
Após o Claude confirmar a criação, abra o arquivo direto no browser:
open ~/.zxlab-mission-control/dashboard.html
Como personalizar
O Mission Control é um HTML puro — você pode pedir ao Claude para adicionar novos cards, mudar cores ou incluir links de serviços externos. Basta dizer "adicione um card para X no Mission Control" em qualquer sessão Claude.
Uso no dia a dia
Toda manhã, antes de qualquer sessão Claude, abra o Mission Control para verificar se todos os serviços estão verdes. Se algum card estiver vermelho, acione /status dentro do Claude para diagnóstico detalhado.
RTK Token Killer
Uma ferramenta que filtra a saída de comandos antes de passar para o Claude, eliminando ruído e economizando 60-90% dos tokens em operações repetitivas.
# Sem RTK — Claude recebe tudo git log --oneline -50 → 50 linhas para o Claude processar # Com RTK — Claude recebe só o relevante git log --oneline -50 → RTK filtra → 5 linhas relevantes economia: ~90% dos tokens desta operação
O que é o RTK
O RTK (Rust Token Killer) é um proxy de linha de comando que intercepta a saída de git, ls, cat e outros antes de chegar ao Claude, removendo ruído e economizando 60-90% dos tokens em operações repetitivas.
Verificar instalação
Após o Claude instalar o RTK, confirme que está funcionando:
rtk --version # deve mostrar: rtk X.Y.Z rtk gain # mostra economia acumulada de tokens
source ~/.zshrc para recarregar o PATH e tente novamente.Uso no dia a dia — transparente
Você não muda nada no fluxo. O Claude Code usa o RTK automaticamente via hook. Para acompanhar as economias acumuladas ao longo do tempo:
rtk gain --history
Pack de Skills Profissionais
Sete comandos prontos que automatizam as tarefas mais comuns do Claude Code — do diagnóstico ao encerramento de sessão.
Como usar as skills
Dentro de qualquer sessão Claude, digite o nome da skill diretamente no chat:
/status # relatório completo de saúde /preflight # verificar antes de um disparo importante /encerrar # sempre ao final de cada sessão
Para que serve no dia a dia
As skills substituem tarefas que você faria manualmente ou simplesmente esqueceria. O /encerrar garante que cada sessão termine com o trabalho salvo e commitado. O /status evita surpresas ao verificar tudo de uma vez antes de começar o dia.
Expandir com mais skills
As skills ficam em ~/.claude/skills/. Você pode criar novas ou instalar pacotes adicionais — o Claude pode criar skills personalizadas para sua operação sob demanda.
Agente Guardião + Heartbeat
Um processo de monitoramento que verifica sua operação a cada 5 minutos e te avisa no WhatsApp se algo cair — antes de você perceber.
O que são o Guardião e o Heartbeat
O Guardião é um script que roda em background via LaunchAgent (macOS). O Heartbeat é o sinal de vida que ele envia regularmente — e que dispara um alerta no seu WhatsApp quando para de chegar.
O que fazer quando receber um alerta
Se chegar uma mensagem de alerta no WhatsApp, siga este passo-a-passo:
/status — o Claude identifica o que caiu e o que precisa ser reiniciadoVerificar se o Guardião está ativo
Para confirmar que o LaunchAgent do Guardião está rodando:
launchctl list | grep zxlab
Se retornar alguma linha, o Guardião está registrado no sistema.
Supabase + Auth
Configure um banco de dados na nuvem com autenticação pronta — gratuitamente. É a base para o mini-CRM que você vai publicar na próxima etapa.
contacts configurada — com schema compatível com os dados do Setup 1~/.operacao-ia/config/config.json para uso pelos scriptsCriar conta Supabase antes desta etapa
O Claude vai precisar das suas credenciais de API. Crie sua conta gratuitamente antes de começar:
O que o banco habilita
Com o Supabase configurado, seus dados saem do computador local e ficam na nuvem — acessíveis de qualquer lugar, com backup automático e autenticação pronta. O mini-CRM da Etapa 8 usa exatamente este banco.
Plano gratuito e limites
O plano gratuito suporta até 500MB de dados e 50.000 usuários — mais que suficiente para começar.
Importar Contatos para a Nuvem
Migre seus contatos do banco local (Setup 1) para o Supabase — ou cole um CSV novo. A partir daqui, sua base fica acessível de qualquer lugar.
~/.operacao-ia/data/contacts.dbnome, telefone, email, tag, statusnome,telefone,email,tag,status João Silva,5511999998888,joao@email.com,lead,ativo
O que acontece durante a migração
O Claude lê o banco local (ou CSV que você fornecer), normaliza os dados e insere na tabela contacts do Supabase criado na Etapa 6. Duplicatas são detectadas e ignoradas automaticamente.
Verificar a importação
Após o Claude confirmar o import, verifique diretamente no painel Supabase:
A partir de agora, tudo vai para a nuvem
Após a migração, novos contatos adicionados pelo agente BANT ou pelos disparos são registrados diretamente no Supabase — sem depender do banco local.
Mini-CRM Publicado
Deploy real no Cloudflare Pages — um CRM com login, listagem de contatos e CRUD básico, publicado online. Seu primeiro produto web funcional.
Como o deploy acontece
O Claude gera o código do mini-CRM e faz o deploy no Cloudflare Pages automaticamente. O processo completo leva menos de 2 minutos:
seu-crm.pages.devPara que serve
O mini-CRM é seu primeiro produto web funcional — do banco de dados ao deploy em produção. Use-o para gerenciar seus leads de qualquer dispositivo e mostre como entregável para clientes da sua agência.
Após o deploy
O link do seu CRM é adicionado automaticamente ao Mission Control ao final desta etapa. Faça o login com as credenciais do Supabase Auth para confirmar que tudo está funcionando.