Como eu rodo seis agentes do Claude Code ao mesmo tempo
Sextou. Eu fecho o notebook. Os agentes não param.
Enquanto a galera desliga, na minha tela tem várias abas abertas. Cada uma com um agente trabalhando sozinho, numa tarefa diferente. Eu paro. Eles seguem.
Parece mágica. Não é. É arquitetura. E eu vou te mostrar a coisa real, com os bugs inclusos, não o print bonito.
Primeiro: o que é um agente de verdade
Um agente não é um chat. Essa é a confusão que trava 90% da galera.
O chat te dá uma resposta e morre ali. Você pergunta, ele responde, acabou. O agente é outra criatura. É um loop com três peças:
- Ferramentas. O que ele pode tocar (ler arquivo, rodar comando, abrir o browser, dar git commit).
- Contexto. O que ele sabe sobre a tarefa e sobre o seu projeto.
- Critério de parada. Quando ele considera o trabalho pronto e devolve pra você.
O chat responde uma pergunta. O agente persegue um objetivo até bater no critério de parada. Ele lê, tenta, erra, lê o erro, tenta de novo. Sozinho.
Quando você separa isso na cabeça, para de tratar a IA como caixa de perguntas e começa a tratar como processo. E processo você pode rodar em paralelo. Pergunta, não.
Como eu corto o trabalho em pedaços
O segredo não está em mandar a IA codar mais rápido. Está em como você divide a tarefa antes de soltar os agentes.
Cada agente recebe um escopo fechado. Sem estado compartilhado com os outros. Devolve um resultado estruturado que eu junto no final. Tipo assim:
agente 1 → escreve os testes do módulo de pagamento
agente 2 → refatora o parser de CSV
agente 3 → caça o bug de timezone no relatório
agente 4 → documenta a API pública
Repara: nenhum deles depende do outro. É de propósito.
É o mesmo princípio de um time bom. Você não bota duas pessoas mexendo no mesmo arquivo ao mesmo tempo, porque vira conflito de merge e briga. Você corta o problema em pedaços independentes e deixa cada um correr sozinho na sua raia.
A regra que eu sigo: se duas tarefas tocam o mesmo arquivo, elas não vão em paralelo. Ou eu junto numa só, ou rodo em sequência. Estado compartilhado entre agentes é a fonte número um de cagada silenciosa.
O fluxo na prática (fan-out e barreira)
Na unha funciona assim. Eu uso um workflow que faz fan-out das tarefas independentes: dispara todas de uma vez, cada agente na sua aba. As que não dependem uma da outra correm em paralelo. As que dependem, esperam numa barreira até o resultado anterior chegar.
┌─ agente 1 ─┐
fan-out → ├─ agente 2 ─┤ → barreira → eu reviso e junto
├─ agente 3 ─┤
└─ agente 4 ─┘
O resultado prático: na sexta de tarde eu fecho o notebook e quatro, cinco, seis frentes continuam andando. Segunda eu chego, leio o que cada um entregou e reviso o que presta.
A parte que ninguém te conta
Agora a honestidade brutal, porque o resto é vendedor de curso.
Rodar seis agentes em paralelo não é seis vezes mais rápido. Eu já achei que fosse. Apanhei.
Tem agente que entra em loop e fica martelando o mesmo erro até você matar a aba. Tem agente que "termina" a tarefa com o teste vermelho e jura que está pronto. Tem agente que toma uma decisão idiota nos primeiros 30 segundos e os 10 minutos seguintes são em cima de uma base errada. Isso acontece. Comigo, toda semana.
Por isso o gargalo deixa de ser digitar e vira revisar. Quanto mais agente você solta, mais resultado chega pra você conferir. Se você não revisa, você só multiplicou a velocidade com que produz código ruim. A IA não te tira da responsabilidade. Ela te empurra pra cima na cadeia: você para de ser quem aperta a tecla e vira quem decide o que presta.
Duas coisas que me salvaram de muita dor:
- Escopo pequeno e fechado por agente. Tarefa grande demais = agente perdido = retrabalho. Quebra mais do que você acha que precisa.
- Critério de parada explícito. "Termina quando os testes passarem", não "termina quando achar que está bom". Máquina não tem vergonha de mentir.
Não é sobre digitar mais rápido. É sobre parar de ser o gargalo de execução e virar o cara que arquiteta e revisa. Esse é o jogo de verdade.
Quer que eu mostre o workflow de fan-out na tela, agente por agente? Comenta aqui embaixo.
me segue pra mais coisa real de quem usa IA no trabalho de verdade, não pra postar print bonito.