Matheus VizottoMatheus Vizotto
Automação·5 de maio de 2026·10 min de leitura

Como Construí um Sistema de Agentes Claude Code que Substituiu 3 Ferramentas e 10 Horas por Semana

97,9% dos profissionais de marketing brasileiros planejam aumentar o uso de IA em 2026, mas apenas 2,7% realmente usam agentes autônomos. Este é o relato de como montei um stack de agentes Claude Code para marketing que funciona enquanto eu durmo.

Matheus Vizotto
Matheus VizottoGrowth Marketer & Especialista em IA
Claude CodeAgentes IAAutomação de MarketingProdutividadeStack
Fluxo de automação com múltiplos agentes de IA trabalhando em paralelo em tarefas de marketing

80% dos profissionais de marketing já usam IA nas estratégias, mas apenas 2,7% chegaram ao nível de agentes autônomos. Eu estava naquele grupo dos 80% até descobrir que estava fazendo errado.

Em março de 2025, eu usava cinco ferramentas diferentes para gerenciar meu fluxo de trabalho de marketing: uma para pesquisa de concorrentes, outra para criar briefs de campanha, uma terceira para analisar performance, mais duas para conteúdo e organização. Cada ferramenta tinha seu próprio login, sua própria interface, sua própria lógica. Eu passava mais tempo conectando pontos do que tomando decisões.

Foram dez horas por semana. Toda semana. Não em trabalho estratégico. Em trabalho de integração.

Hoje eu uso um sistema de agentes Claude Code que faz esse trabalho por mim. Não é magia. É arquitetura. E neste post vou te mostrar exatamente como funciona.


O problema real: ferramentas demais, integração de menos

Segundo a HubSpot "A Realidade do Marketing no Brasil 2025", pesquisa com 550 profissionais, 97,9% dos marketeiros brasileiros planejam aumentar o uso de IA em 2026. O impulso está certo. O método, muitas vezes, não está.

O erro mais comum que vejo no mercado é empilhar ferramentas. Uma IA para texto, outra para análise, outra para pesquisa. Cada uma resolve um problema isolado, mas nenhuma delas conversa com as outras. O profissional vira o middleware humano do próprio fluxo de trabalho.

O ciclo é assim: pesquisa um concorrente, exporta para Excel, abre o ChatGPT para interpretar os dados, copia o resultado para o Notion, depois abre outra ferramenta para criar o brief de campanha. Cada transição custa cinco minutos de recontextualização mental. Multiplica isso por cinco tarefas repetitivas por dia. São vinte e cinco minutos desperdiçados só em troca de contexto.


O que são agentes Claude Code e por que são diferentes

Usar o Claude no chat é como contratar um freelancer para cada tarefa separada. Você explica o contexto toda vez, ele entrega, e a conversa termina. Agentes Claude Code são diferentes: eles têm acesso ao seu sistema de arquivos, executam ferramentas, leem contexto persistente, e podem encadear ações sem intervenção manual.

A diferença prática é enorme. Um agente pode ler um relatório de performance, identificar as campanhas abaixo da meta, cruzar com dados históricos do seu vault de notas, e te entregar um brief de otimização. Tudo em uma única chamada. Sem você ter aberto uma planilha.

Claude Code versus Claude no chat

  • Claude no chat: contexto zerado a cada conversa, sem acesso a arquivos, sem execução de ferramentas
  • Claude Code: lê e escreve arquivos locais, executa comandos, mantém memória entre sessões, acessa múltiplas fontes em sequência
  • Agentes Claude Code: toda capacidade acima, mais um arquivo SKILL.md que define persona, objetivo, e protocolo de execução

O Gartner estima que 40% dos aplicativos corporativos terão agentes de IA focados em tarefas específicas até 2026. Eu não esperei o mercado chegar lá. Construí o meu agora.


As 3 ferramentas que substituí

Não substituí porque as ferramentas eram ruins. Substituí porque o custo de orquestração entre elas era maior do que o valor que cada uma entregava individualmente.

Ferramenta 1: Notion AI para briefs de campanha

O Notion AI é ótimo para texto genérico. Mas ele não conhece meu histórico de campanhas, não sabe quais formatos funcionaram para qual segmento, e não consegue cruzar dados de performance antes de escrever. Eu precisava alimentá-lo manualmente com todo o contexto a cada brief.

O agente que substituiu isso lê meu vault de notas, puxa os resultados de campanhas anteriores por segmento, e gera um brief já calibrado com o que funcionou. O tempo caiu de quarenta minutos para seis minutos.

Ferramenta 2: Planilha + ChatGPT para análise de concorrentes

O fluxo era: exportar dados do Semrush, abrir o ChatGPT, colar os dados, pedir análise, copiar o resultado, formatar no Notion. Cinco etapas manuais para uma tarefa que deveria ser trivial.

Hoje tenho um agente de pesquisa que lê os arquivos exportados diretamente, cruza com notas de inteligência competitiva que já acumulei, e entrega uma análise estruturada já no formato que uso nos relatórios. Uma etapa.

Ferramenta 3: Planilha de performance semanal

Todo domingo de manhã eu passava uma hora interpretando métricas de campanhas no Google Ads, Meta, e LinkedIn. Formatava tudo em um relatório visual no Notion. Era pura formatação. Zero julgamento real sendo aplicado.

O agente de análise de performance lê os exports dos três canais, identifica anomalias, calcula variação semana a semana, e entrega um resumo executivo com os três pontos que precisam de atenção. A hora virou doze minutos.

Não foi automação por automação. Foi identificar onde eu estava sendo o operador manual de um processo que podia ser delegado. O julgamento ainda é meu. A execução mecânica, não.


A arquitetura do sistema: skills, hooks, e memória

O sistema tem três camadas. Entender cada uma é o que separa quem usa agentes de quem realmente os controla.

Camada 1: Skills (arquivos SKILL.md)

Cada agente tem um arquivo SKILL.md que define quem ele é e o que faz. É um documento de instrução que o Claude lê antes de executar qualquer tarefa. Inclui persona, objetivo, fontes de dados que pode acessar, formato de output, e regras do que não fazer.

Cada SKILL.md tem entre 150 e 300 palavras. Quanto mais específico, melhor o output. Agentes com SKILL.md vagos entregam resultados genéricos. A precisão da instrução determina a qualidade da execução.

Camada 2: Hooks (gatilhos automáticos)

Hooks são scripts que rodam automaticamente em momentos específicos. O hook de início de sessão injeta contexto relevante sem eu precisar pedir. O hook de fim de sessão captura o que foi feito e salva no vault antes de fechar.

É a diferença entre um agente que esquece tudo e um que aprende a cada interação. O contexto acumula. O sistema fica mais útil com o tempo.

Camada 3: Memória de sessão

O arquivo MEMORY.md guarda decisões, preferências, e correções permanentes. Se eu digo que um formato de relatório não funciona, ele salva essa regra imediatamente. Na próxima sessão, o agente já sabe.

Isso é o que torna o sistema verdadeiramente personalizado. Não é um assistente genérico. É um sistema calibrado para o meu fluxo de trabalho específico.


Exemplos reais: os 4 agentes que uso toda semana

Agente 1: Pesquisa de concorrentes

Quando preciso analisar um concorrente, chamo o agente com o nome do domínio. Ele lê arquivos de inteligência que já tenho no vault, cruza com os dados exportados das ferramentas de SEO, e entrega um sumário com posicionamento, lacunas de conteúdo, e oportunidades identificadas.

Em vinte minutos o agente entregou uma análise que normalmente me custava três horas. A diferença não foi velocidade de digitação. Foi eliminar o vai e volta entre fontes.

Agente 2: Criação de conteúdo para LinkedIn

Esse agente conhece meu tom de voz, meus tópicos principais, e o que performou bem historicamente. Quando eu tenho uma ideia, escrevo em bullet points crus e chamo o agente. Ele transforma em um post calibrado para o formato do LinkedIn, sem perder a voz original.

O que não faço: deixo o agente publicar. O julgamento sobre o que vale a pena postar ainda é meu. O agente formata. Eu decido.

Agente 3: Brief de campanha

Antes de criar qualquer campanha, esse agente puxa três coisas: resultados de campanhas similares anteriores, personas ativas do produto, e objetivos do trimestre. Com isso, gera um brief que já está alinhado com o histórico. Não parto do zero nunca mais.

Agente 4: Análise de performance semanal

Todo domingo, esse agente lê os exports de Google Ads, Meta, e LinkedIn. Calcula variação semana a semana por canal e por campanha. Identifica os três maiores desvios positivos e negativos. Entrega um texto executivo de dois parágrafos com o que precisa de atenção.


O que não automatizar: onde o julgamento humano ainda importa

Segundo dados do IAB Brasil em parceria com Nielsen, 80% dos profissionais já usam IA nas estratégias, mas apenas 2,7% chegaram ao nível de agentes autônomos. Parte dessa resistência é saudável. Nem tudo deve ser delegado.

Decisões estratégicas com ambiguidade alta

Quando o cenário tem múltiplas variáveis e o erro custa caro, o agente vira consultor, não executor. Ele pode agregar dados e estruturar o problema. A decisão final fica comigo.

Comunicação sensível com clientes

Qualquer mensagem que carrega nuance emocional ou contexto de relacionamento não passa por automação. Um cliente insatisfeito merece um humano do outro lado. Um e-mail de renovação de contrato merece atenção real.

Validação de hipóteses novas

Agentes são bons em executar padrões conhecidos. Quando você está testando algo que nunca fez antes, sem histórico para calibrar, o agente vai gerar output baseado em analogias genéricas. Para hipóteses novas, o pensamento humano não tem substituto ainda.


Como começar: os primeiros 3 agentes para qualquer marketeiro

  1. Agente de contexto de sessão: um hook simples que carrega seu contexto de trabalho ao abrir o Claude Code. Quem você é, no que está trabalhando, quais são as prioridades. Elimina a recontextualização manual toda vez que você abre o sistema.
  2. Agente de primeiro rascunho: um SKILL.md que conhece seu tom de voz, seus formatos de conteúdo, e suas restrições de mensagem. Use para e-mails, posts, ou qualquer texto onde você hoje começa do zero.
  3. Agente de síntese de dados: lê um export de planilha ou relatório e entrega um resumo em linguagem natural com os três pontos mais importantes. Simples, mas economiza quarenta minutos semanais facilmente.

A instalação do Claude Code leva menos de trinta minutos. Criar o primeiro SKILL.md funcional leva mais trinta. Em uma hora você tem seu primeiro agente rodando.


Perguntas frequentes

Preciso saber programar para usar Claude Code?

Não. Claude Code é uma interface de linha de comando, não um ambiente de desenvolvimento. Você escreve instruções em linguagem natural nos arquivos SKILL.md. O nível técnico necessário é o mesmo que configurar um Notion avançado. A maioria dos usuários não-técnicos consegue criar seu primeiro agente funcional em menos de duas horas.

Agentes de IA são seguros para dados de clientes?

Depende de como você configura. O Claude Code opera localmente na sua máquina, o que significa que seus arquivos não saem do ambiente que você controla. Para dados sensíveis de clientes, mantenha fora dos arquivos que o agente acessa. A regra prática é a mesma de qualquer ferramenta: não coloque no sistema o que você não colocaria em um e-mail.

Quanto tempo leva para o sistema pagar o investimento?

No meu caso, a configuração inicial levou cerca de quatro horas. Com dez horas recuperadas por semana, o retorno foi positivo na primeira semana de uso. O investimento real não é de tempo de setup. É o tempo de mudança de mentalidade de "usuário de ferramenta" para "construtor de sistema".

Vale a pena para equipes pequenas ou só para quem trabalha solo?

Vale especialmente para equipes pequenas. Quando você tem dois ou três profissionais de marketing cobrindo o trabalho de cinco, agentes de IA preenchem a lacuna operacional sem custo de contratação.

O que diferencia um agente bom de um ruim?

A qualidade do SKILL.md. Agentes vagos entregam outputs genéricos. Agentes com instrução precisa, contexto histórico carregado, e exemplos reais de output desejado entregam resultados que você realmente usa. Dos agentes que uso, os melhores foram os que reescrevi três vezes antes de ficarem certos. A primeira versão sempre parece boa demais até você ver o output real.

Matheus Vizotto
Matheus Vizotto·Growth Marketer & Especialista em IA · Sydney, AU

Growth marketer e especialista em IA baseado em Sydney, Austrália. 9+ anos em startups e marketplaces de alto crescimento no Brasil e na Austrália. Escreve sobre IA para marketing, sistemas de crescimento e estratégia prática.