A primeira forma de trabalhar com um agente de IA é quase sempre a mesma: uma conversa longa, um único modelo, e o agente a fazer tudo. Planeia, escreve, corrige, volta atrás, declara que terminou. Funciona em tarefas pequenas. Em tarefas grandes, três coisas acontecem: o custo dispara, os erros aparecem tarde e ninguém confirmou se o resultado cumpre o que foi pedido.
As equipas humanas resolveram este problema há muito tempo com papéis: alguém planeia, alguém executa, alguém revê. A mesma lógica aplica-se aos agentes de IA, e o Claude Code (tal como outros agentes) já tem as ferramentas para a pôr em prática.
Este artigo explica o modelo de três papéis (piloto, construtor e revisor), que modelo usar em cada um, as regras que fazem a diferença e como aplicar a mesma ideia a trabalho de marketing, não apenas a programação.
Em resumo
O essencial em 30 segundos
- Três papéis: quem planeia, quem executa e quem revê
- O modelo mais forte só no planeamento, que gasta pouco
- Cada etapa tem uma “definição de pronto” escrita antes de começar
- O revisor só aponta problemas, nunca corrige
- Dividir sem regras gasta mais, não menos
Termos usados neste artigo
- Agente de IA: assistente que executa passos (ler ficheiros, escrever, correr comandos) para concluir uma tarefa.
- Subagente: agente auxiliar, definido num ficheiro, que recebe uma tarefa, trabalha no seu próprio contexto e devolve só o resultado.
- Contexto: a “memória de trabalho” de uma conversa. Tudo o que lá está é relido a cada passo e conta para o consumo.
- Token: unidade em que os modelos medem texto (cerca de três quartos de uma palavra). Os custos medem-se em tokens.
- Definição de pronto (definition of done): lista de critérios verificáveis que dizem quando uma tarefa está concluída.
- Equipa de agentes (agent teams): funcionalidade experimental do Claude Code em que várias sessões trabalham em paralelo e comunicam entre si.
- CLAUDE.md: ficheiro de instruções que o Claude Code lê no início de cada sessão.
Porque é que um agente sozinho fica caro
Infografia
Os quatro problemas do agente único
A conversa só cresce
Cada passo relê todo o histórico: ficheiros, erros, tentativas falhadas. O custo de cada mensagem sobe ao longo do dia.
Modelo caro em tarefa barata
O mesmo modelo que planeia uma arquitetura também muda uma cor ou renomeia um ficheiro.
Ninguém revê
Quem executa declara que está pronto. O erro aparece mais tarde, quando corrigir custa mais.
Tudo em fila
Uma tarefa espera pela anterior, mesmo quando podiam avançar em paralelo.
A solução não é “mais agentes”. É papéis claros, com regras. Dividir o trabalho sem regras de contexto e de modelo pode gastar mais do que um agente único, porque cada agente novo tem de reler o projeto para perceber o que fazer.
Os três papéis
Infografia
Como o trabalho circula entre os três papéis
Se o revisor reprova, a lista de problemas volta ao construtor. Só quando aprova é que o piloto passa à etapa seguinte.
| Papel | O que faz | O que não faz | Modelo sugerido |
|---|---|---|---|
| Piloto | Divide o pedido em etapas, escreve a definição de pronto de cada uma, decide quem faz o quê e guarda apenas resumos | Não executa o trabalho | O mais capaz (por exemplo, Opus) |
| Construtor | Executa uma etapa, com os ficheiros e critérios definidos, e devolve um resumo curto | Não mexe em ficheiros de outras etapas | Intermédio (por exemplo, Sonnet) |
| Revisor | Confere a etapa contra a definição de pronto e devolve “aprovado” ou “reprovado”, com a localização exata de cada problema | Não corrige: só aponta | Intermédio ou forte, conforme o risco |
A regra mais importante está na última coluna da linha do revisor: quem revê não corrige. Se o revisor também corrige, deixa de haver revisão: passa a haver um segundo construtor, sem ninguém a verificar o trabalho dele.
Que modelo usar em cada papel
O planeamento é a parte mais exigente em raciocínio, mas é a que gasta menos tokens. A execução é a que gasta mais. Num teste publicado com um agente de código, o planeamento consumiu cerca de 6% dos tokens e a execução cerca de 94%. Pôr o modelo mais caro só no planeamento custa, portanto, pouco.
Gráfico
Preço por milhão de tokens de saída (API Claude, USD)
Fonte: página oficial de preços da Anthropic, outubro de 2026 (Haiku 5.5 para pedidos até 100 mil tokens). Nos planos por subscrição, o consumo conta para os limites do plano em vez de ser faturado por token.
Regra prática:
- Piloto: o modelo mais capaz a que tem acesso. Planear mal sai mais caro do que qualquer token.
- Construtor: um modelo intermédio. Em tarefas mecânicas (renomear, formatar, mover ficheiros), um modelo pequeno chega.
- Revisor: intermédio na maioria dos casos; o mais capaz em etapas de risco (pagamentos, dados de clientes, regras de negócio).
No Claude Code, cada subagente pode ter o seu próprio modelo, definido no ficheiro do agente. A sessão principal pode ainda ter modelos de reserva para quando o principal está sobrecarregado: claude --model opus --fallback-model sonnet.
Como montar a equipa no Claude Code
A equipa monta-se com dois ficheiros de subagente e algumas regras no CLAUDE.md. O piloto é a própria conversa principal.
O construtor
Ficheiro .claude/agents/construtor.md:
---
name: construtor
description: Executa uma etapa do plano com ficheiros e critérios definidos. Usar para implementar uma etapa aprovada.
tools: Read, Edit, Write, Bash, Glob, Grep
model: sonnet
---
Recebes uma etapa com: objetivo, lista de ficheiros e definição de pronto.
Regras:
- Mexe apenas nos ficheiros da tua etapa.
- Antes de terminar, corre as verificações indicadas na definição de pronto.
- Se faltar informação, para e diz o que falta. Não inventes conteúdos.
- Responde em no máximo 8 linhas: o que fizeste, que ficheiros mudaste, o que verificaste.
O revisor
Ficheiro .claude/agents/revisor.md:
---
name: revisor
description: Confere uma etapa concluída contra a definição de pronto. Usar sempre depois do construtor.
tools: Read, Glob, Grep, Bash
model: sonnet
---
Confere a etapa contra a definição de pronto que recebes. Não edites ficheiros.
Responde apenas:
- APROVADO, ou
- REPROVADO, seguido da lista do que falta, com ficheiro e linha de cada problema.
Não sugiras melhorias fora da definição de pronto.
Repare que o revisor não tem as ferramentas de edição (Edit, Write). Não é só uma instrução: fisicamente não consegue alterar ficheiros.
As regras do piloto, no CLAUDE.md
# Forma de trabalhar (equipa de agentes)
- Tu és o piloto. Não executas trabalho de implementação.
- Para cada pedido: divide em etapas. Cada etapa tem objetivo, lista de ficheiros e definição de pronto.
- Mostra-me o plano e espera aprovação antes de começar.
- Cada etapa vai para o subagente "construtor". Depois, para o subagente "revisor".
- Se o revisor reprovar, devolve a lista ao construtor. No máximo 3 voltas; à terceira, chama-me.
- No máximo dois construtores em paralelo, e nunca com ficheiros em comum.
- Guarda apenas os resumos de cada etapa, não o trabalho completo.
- Se faltar informação que só eu tenho (preços, textos, dados), pergunta.
Pode confirmar que os agentes foram reconhecidos com o comando /agents.
A definição de pronto: a peça que decide tudo
O que distingue uma equipa de agentes que funciona de uma que gera retrabalho é a qualidade da definição de pronto de cada etapa. “Fazer a secção de preços” não é verificável. Isto é:
Exemplo
Definição de pronto: secção de preços de uma landing page
- Três planos com nome, preço mensal e cinco funcionalidades cada
- Preços iguais aos do ficheiro precos.md, sem arredondamentos
- Botão de cada plano aponta para o link de pagamento correto
- Legível a 375 px de largura sem scroll horizontal
- Contraste do texto cumpre WCAG AA
- A página compila sem erros
Cada linha é verificável por um revisor sem precisar de perguntar nada.
Teste rápido: se o revisor precisasse de lhe perguntar alguma coisa para decidir se está pronto, a definição não está boa o suficiente.
O mesmo modelo, aplicado a marketing
Os três papéis não são exclusivos de programação. Funcionam em qualquer trabalho com etapas e critérios claros. Exemplo para produção de conteúdo:
| Papel | Em produção de conteúdo | Definição de pronto típica |
|---|---|---|
| Piloto (estratega) | Define o tema, o público, a estrutura do artigo e as fontes a usar | Plano aprovado pelo responsável de marketing |
| Construtor (redator) | Escreve uma secção de cada vez a partir do plano e das fontes | Secção com o tamanho, o tom e as fontes definidos |
| Revisor (editor) | Verifica factos contra as fontes, tom de voz, termos proibidos e metas de SEO | Nenhuma afirmação sem fonte, metas dentro dos limites, zero termos proibidos |
Pedido de arranque para um artigo:
Vais trabalhar como piloto. Objetivo: um artigo sobre [tema] para [público].
Fontes autorizadas: os ficheiros em /fontes. Tom de voz: ver marca/tom.md.
1. Propõe a estrutura e a definição de pronto de cada secção. Espera a minha aprovação.
2. Depois, cada secção vai ao construtor e ao revisor.
3. O revisor reprova qualquer afirmação com números que não esteja nas fontes.
Uma segunda opinião de outro fabricante
Há quem use um modelo de outro fabricante para rever (por exemplo, o Codex da OpenAI a rever o trabalho feito com o Claude). A lógica é razoável: modelos diferentes tendem a ter pontos cegos diferentes.
Se o fizer, respeite duas regras:
- Cada ferramenta com a sua própria conta. A documentação do Claude Code não permite encaminhar pedidos através da subscrição Claude em ferramentas de terceiros. Para usar modelos Claude noutras ferramentas, use uma chave de API.
- Verifique a política de dados de cada fornecedor antes de enviar trabalho com dados de clientes.
Subagentes ou equipas de agentes?
O Claude Code tem duas formas de trabalhar com vários agentes. Para a maioria dos casos, os subagentes chegam.
| Subagentes | Equipas de agentes (experimental) | |
|---|---|---|
| Como funcionam | A conversa principal delega uma tarefa e recebe o resultado | Várias sessões independentes, com lista de tarefas partilhada e mensagens entre si |
| Comunicação | Devolvem o resultado a quem os chamou | Falam diretamente uns com os outros |
| Custo em tokens | Menor: só o resumo volta à conversa principal | Maior: cada membro é uma instância completa |
| Melhor para | Tarefas focadas, em que só interessa o resultado | Investigação e revisão em paralelo, com debate entre perspetivas |
| Estado | Funcionalidade estável | Desligada por defeito; ativa-se nas definições |
Para começar, use subagentes. As equipas de agentes fazem sentido em casos específicos, como três revisores com focos diferentes (segurança, desempenho, testes) a analisar a mesma alteração.
Os erros que anulam a poupança
Checklist
O que evitar
- Piloto que começa a executar “só esta parte”
- Dois construtores a mexer no mesmo ficheiro
- Saltar o revisor porque “parece estar bem”
- Pedir ao piloto o trabalho completo de volta, em vez do resumo
- Usar o modelo mais caro em todos os papéis
- Etapas sem definição de pronto
- Começar com cinco projetos em paralelo
Como começar
Infografia
Primeira semana com uma equipa de agentes
- Projeto pequenoUma landing page de três secções ou um artigo. Nada com dados de clientes.
- Dois ficheirosCrie o construtor e o revisor em
.claude/agents/. - Regras do pilotoCole as regras no
CLAUDE.mddo projeto. - Plano com “pronto”Só aprove o plano quando cada etapa tiver critérios verificáveis.
- MedirCompare consumo (
/usage) e retrabalho com a forma antiga.
Perguntas frequentes
O que é um subagente no Claude Code?
É um agente auxiliar definido num ficheiro Markdown (em .claude/agents/ do projeto ou ~/.claude/agents/ para todos os projetos), com nome, descrição, ferramentas permitidas e modelo. Trabalha no seu próprio contexto e devolve apenas o resultado à conversa principal.
Usar vários agentes sai mais caro do que usar um só?
Pode sair, se não houver regras. Cada subagente faz os seus próprios pedidos ao modelo. A poupança vem de usar o modelo mais caro só onde é preciso (planeamento), de manter as conversas curtas e de apanhar os erros cedo, através do revisor.
Posso usar um modelo diferente em cada papel?
Sim. No Claude Code, cada subagente pode ter o campo model definido no seu ficheiro (por exemplo, opus, sonnet ou haiku). Se não definir, usa o modelo da conversa principal.
Porque é que o revisor não deve corrigir?
Porque, se corrigir, passa a ser um segundo construtor sem ninguém a verificar o seu trabalho. Separar quem aponta de quem corrige garante que cada correção volta a ser revista.
Isto serve para marketing ou só para programação?
Serve para qualquer trabalho com etapas e critérios verificáveis. Em marketing, funciona bem na produção de conteúdo (estratega, redator, editor), em landing pages e em relatórios com dados, desde que a definição de pronto de cada etapa seja clara.
O que são as equipas de agentes do Claude Code?
É uma funcionalidade experimental, desligada por defeito, em que várias sessões do Claude Code trabalham em paralelo, com uma lista de tarefas partilhada e mensagens diretas entre si. Consome bastante mais tokens do que os subagentes e faz sentido sobretudo para investigação e revisão em paralelo.
Quer organizar o trabalho de IA da sua equipa com papéis, regras e custos controlados? Agende uma conversa gratuita de 30 minutos e vemos juntos por onde começar.
Informação verificada em outubro de 2026 na documentação oficial do Claude Code sobre subagentes, equipas de agentes e comandos, e na página de preços da Anthropic. Funcionalidades e preços mudam com frequência.
Artigo publicado em jorgerosendo.com — IA, Marketing, SEO e Produtividade.