🧵 Vários agentes em paralelo

Novo aqui? Rodar vários agentes em paralelo significa abrir mais de uma sessão do Claude Code ao mesmo tempo, cada uma trabalhando numa parte diferente da tarefa. Em vez de pedir "scrape os 3 sites, um de cada vez" e esperar cada um terminar, você pede os três ao mesmo tempo, em três janelas — o tempo total cai pra perto do tempo do mais lento, não da soma de todos.

Vale separar dois jeitos de trabalhar que já apareceram nos módulos anteriores. Sequencial é um pedido depois do outro, na mesma sessão — o agente termina a tarefa A, só então começa a B. Paralelo é abrir sessões separadas que trabalham ao mesmo tempo, cada uma na sua tarefa. Nenhum dos dois é "melhor" em geral — a pergunta certa é se as tarefas dependem uma da outra. Se a tarefa B precisa do resultado da tarefa A, elas têm que ser sequenciais, por definição — não tem como paralelizar o que depende de algo que ainda não existe.

Legenda: um pedido grande pode virar três tarefas independentes rodando ao mesmo tempo, cada uma numa pasta ou aba de terminal própria — os resultados se juntam quando todas terminarem, em vez de esperar uma de cada vez.

Novo aqui? Uma sessão é uma conversa aberta com o Claude Code — cada vez que você digita claude num terminal, nasce uma sessão nova, com sua própria memória do que foi pedido ali dentro. Cada sessão do Claude Code roda isolada dentro de uma pasta de projeto ou aba de terminal. Pra rodar em paralelo sem um agente atrapalhar o outro, abra abas de terminal separadas (ou pastas separadas, se cada tarefa mexe em arquivos diferentes) e inicie um claude em cada uma.

Isso importa porque sessões diferentes não "conversam" entre si — o que o Agente 1 descobriu não aparece automaticamente pro Agente 2. Se um passo depende de informação que outro agente gerou, essa informação precisa virar um arquivo (o CSV, um texto) que o outro agente possa ler depois. É por isso que, no build do módulo 2.5, cada aba grava seu próprio arquivo de saída em vez de tentar "avisar" a outra sessão.

Objetivo: três sessões independentes rodando de verdade ao mesmo tempo. Como verificar: abra o gerenciador de abas do seu terminal e confirme que há 3 abas ativas, cada uma com uma conversa diferente em andamento.

O maior cuidado em paralelismo é evitar que dois agentes editem o mesmo arquivo ao mesmo tempo — um pode sobrescrever o trabalho do outro sem avisar. Divida a tarefa de um jeito que cada agente tenha seu próprio arquivo de saída (ex.: produtos-site-a.csv, produtos-site-b.csv) e só depois una os resultados.

Ver por dentro: não existe nenhum mecanismo automático que impeça dois agentes de gravar no mesmo arquivo — cada sessão simplesmente escreve o arquivo inteiro de novo quando termina, como se fosse a única no mundo. Se as duas sessões escrevem produtos.csv por cima uma da outra, quem grava por último "vence", e o trabalho da outra sessão some sem nenhum aviso de erro. Não é um bug do Claude Code — é assim que qualquer programa que reescreve um arquivo se comporta. A proteção é sempre sua: nomes de arquivo diferentes por agente.

Legenda: quando dois agentes escrevem o mesmo arquivo, não há mesclagem automática — o que grava por último apaga o que veio antes, sem aviso de erro. Por isso cada agente precisa de um arquivo de saída próprio.

Pegando o build do módulo 2.5: se você precisa dos preços de três sites diferentes, essa é a divisão perfeita pra paralelismo — cada site é totalmente independente do outro.

Objetivo: três CSVs prontos ao mesmo tempo, em vez de um atrás do outro. Como verificar: os três arquivos existem e cada um tem linhas de dados reais — depois é só juntar (ou pedir pro agente juntar) num CSV final.

Rodar três scrapes ao mesmo tempo não muda a responsabilidade de cada um: continue respeitando os termos de uso do site, não sobrecarregando o servidor com pedidos em excesso e evitando coletar dados pessoais sem necessidade — as mesmas regras do módulo 2.5, só que agora valendo pras três abas ao mesmo tempo. Rodar em paralelo multiplica a chance de um site perceber tráfego incomum e bloquear, então é ainda mais importante não abusar.

Novo aqui? Token é a unidade que mede o quanto o agente "leu e escreveu" numa conversa — cada palavra ou pedaço de palavra processado conta como tokens, e é isso que gera custo. Cada sessão paralela consome tokens de forma independente — três agentes rodando ao mesmo tempo custam, aproximadamente, a soma do que cada um custaria sozinho (não é "de graça" só porque roda em paralelo). O ganho é de tempo, não de custo. Vale a pena quando a urgência compensa, não sempre.

Legenda: rodar 3 tarefas em sequência ou em paralelo consome, no total, a mesma quantidade de tokens — a diferença é só o tempo de relógio que você espera. Paralelo não é mais barato, é mais rápido.

Depois que os três agentes terminarem, um último pedido — numa única sessão — junta os arquivos separados num resultado final. É o mesmo princípio de "buscar" separado de "gravar" que a Trilha 4 (Deploy) vai aprofundar: cada pedaço roda isolado, e a junção acontece num passo só, fácil de repetir se algo falhar no meio.

Objetivo: um único CSV final consolidado. Como verificar: o número de linhas de produtos-final.csv bate com a soma das linhas dos três arquivos originais.

Com isso fecha a Trilha 2. Você saiu de "o que é um servidor MCP" (2.1) até rodar múltiplos agentes buscando dados reais em paralelo e juntando tudo num CSV final (2.6) — passando por instalar e autenticar servidores de verdade (2.3), guardar comandos num cheat sheet pra não reaprender do zero (2.4) e construir um scraper funcional (2.5). O fio que amarra os seis módulos é sempre o mesmo: dar ao agente uma ferramenta externa — seja um servidor MCP, seja o próprio navegador — e tratar erro, chave e limite de uso como parte normal do trabalho, não como exceção. Na Trilha 3, o próximo passo é ensinar o agente a repetir um processo inteiro, de ponta a ponta, sem você precisar reexplicar cada etapa: isso é uma skill.