Executar agentes em paralelo
Compare as formas como Claude Code pode assumir múltiplas tarefas simultaneamente: subagentes, visualização de agentes, equipes de agentes, workflows dinâmicos e projetos.
Claude Code tem cinco formas de trabalhar em várias tarefas ao mesmo tempo: subagentes, visualização de agentes, equipes de agentes, workflows dinâmicos e projetos. Eles diferem em quanto você permanece envolvido, desde orientar cada conversa você mesmo até deixar Claude coordenar um grupo de trabalhadores, e se o trabalho é executado em sua máquina ou na nuvem.
| Abordagem | O que oferece | Use quando |
|---|---|---|
| Subagentes | Trabalhadores delegados dentro de uma sessão que fazem uma tarefa secundária em seu próprio contexto e retornam um resumo | Uma tarefa secundária inundaria sua conversa principal com resultados de pesquisa, logs ou conteúdos de arquivo que você não consultará novamente |
| Visualização de agentes | Uma tela para despachar e monitorar sessões em execução em segundo plano, aberta com claude agents. Visualização de pesquisa |
Você tem várias tarefas independentes e quer delegá-las, verificar o status rapidamente e intervir apenas quando uma precisar de você |
| Equipes de agentes | Múltiplas sessões coordenadas com uma lista de tarefas compartilhada e mensagens entre agentes, gerenciadas por um líder. Experimental e desabilitado por padrão | Você quer que Claude divida um projeto em partes, as atribua e mantenha os trabalhadores sincronizados |
| Projetos | Uma conversa contínua em claude.ai/code ou no aplicativo desktop. Claude inicia sessões paralelas na nuvem chamadas threads, fornece a cada uma os repositórios, instruções e memória do projeto, e mostra quais precisam de você. Beta público em Pro e Max | O trabalho abrange muitas tarefas ao longo de dias ou semanas, deve continuar em execução quando sua máquina está desligada, e você prefere descrevê-lo uma vez em vez de despachar e rastrear cada sessão |
| Workflows dinâmicos | Um script que executa muitos subagentes e verifica seus resultados, para um trabalho muito grande para coordenar em um único turno ou que precisa de mais de uma passagem | Uma tarefa cresce além de um punhado de subagentes, ou você quer que as descobertas sejam verificadas uma contra a outra: uma auditoria em toda a base de código, uma migração de 500 arquivos, pesquisa com verificação cruzada ou um plano elaborado de vários ângulos |
Em cada abordagem, os trabalhadores são sessões Claude. Para envolver uma ferramenta diferente, exponha-a ao Claude como um servidor MCP.
Três ferramentas adicionais suportam este trabalho sem serem uma forma de executar agentes em si:
- Worktrees dão a cada sessão um checkout git separado, para que sessões paralelas nunca editem os mesmos arquivos. Use-as para sessões que você executa você mesmo. Uma sessão que você despacha da visualização de agentes move para seu próprio worktree antes de editar arquivos, e subagentes que você gera podem cada um receber um também.
- Mensagens entre sessões permite que Claude liste e envie mensagens para suas outras sessões Claude Code nesta máquina, em outra máquina ou na nuvem, para que sessões que você executa você mesmo possam passar descobertas e status entre si.
/batché uma skill que tem Claude dividir uma grande mudança em 5 a 30 subagentes isolados em worktree que cada um abre um pull request. É um uso empacotado de subagentes e worktrees, não um estilo de coordenação separado.
Alguns outros recursos executam Claude sem você dirigir cada passo, mas resolvem um problema diferente do que dividir trabalho entre agentes:
- Um comando bash em segundo plano executa um comando shell sem bloquear a conversa. Ele não gera um agente.
- Um subagente bifurcado é um subagente que herda seu contexto de conversa completo em vez de começar do zero. É uma forma de gerar um subagente, não uma superfície separada. Inicie um com
/subtask. Claude também gera um ele mesmo onde modo de bifurcação está ativado. Para copiar a sessão inteira em uma nova sessão em segundo plano que executa ao lado dela, use/fork. Com visualização de agentes desativada, o comando de subagente bifurcado é/forkem vez disso e/subtasknão está disponível. - Uma rotina executa uma sessão em um cronograma na nuvem, não em paralelo em sua máquina.
Escolha uma abordagem
A abordagem correta depende de quem coordena o trabalho, se os trabalhadores precisam se comunicar e se editam os mesmos arquivos:
- Quem coordena o trabalho?
- Claude delega e coleta resultados dentro de uma conversa: subagentes
- Você entrega tarefas independentes e verifica depois: visualização de agentes
- Claude planeja, atribui e supervisiona um grupo de trabalhadores: equipes de agentes, experimental e desabilitado por padrão
- Um script mantém o plano em vez do julgamento turno a turno de Claude: fluxos de trabalho dinâmicos. Veja como fluxos de trabalho se comparam a subagentes e skills
- Os trabalhadores precisam conversar um com o outro? Claude pode passar descobertas com mensagens entre sessões entre sessões que você executa você mesmo, incluindo as sessões que você envia da visualização de agentes. Subagentes relatam resultados de volta para a conversa que os gerou, e sessões de visualização de agentes relatam resultados apenas para você. Companheiros de equipe em uma equipe de agentes se mensageiam diretamente e, quando têm as ferramentas Task, compartilham uma lista de tarefas.
- As tarefas tocam os mesmos arquivos? Isole o trabalho com worktrees. Subagentes e sessões que você executa você mesmo podem cada um usar um worktree separado. Equipes de agentes não isolam companheiros de equipe em worktrees, então particione o trabalho para que cada companheiro de equipe possua um conjunto diferente de arquivos.
Verifique o trabalho em execução
O comando para verificar o trabalho em execução depende de qual abordagem você usou:
- Para sessões em segundo plano,
claude agentsabre visualização de agentes: uma tela mostrando cada sessão, seu estado e quais precisam de sua entrada. - Para subagentes na sessão atual, subagentes em segundo plano nomeados aparecem na digitação de menção @- com seu status. A partir da v2.1.198,
/agentsnão abre mais um painel; imprime um aviso apontando para os locais dos arquivos de subagentes. Para criar e editar subagentes personalizados, peça ao Claude ou edite os arquivos diretamente. Apesar do nome similar,/agentsé separado declaude agents. - Para qualquer coisa em execução em segundo plano da sessão atual,
/taskslista cada item e permite que você verifique, se anexe ou interrompa. A lista também inclui subagentes que terminaram. - Para fluxos de trabalho dinâmicos,
/workflowslista execuções em andamento e concluídas, a fase em que cada uma está e quantos agentes terminaram.
Para uma visualização de desktop de todas as suas sessões, veja sessões paralelas no aplicativo desktop.
Saiba mais
Cada guia abaixo cobre configuração e configuração para uma abordagem:
- Criar subagentes personalizados: defina especialistas reutilizáveis e controle quais ferramentas eles podem usar.
- Gerenciar agentes com visualização de agentes: despache sessões, observe seu estado e se anexe quando uma precisar de você.
- Orquestrar equipes de agentes: configure um líder e companheiros de equipe, atribua tarefas e revise seu trabalho.
- Orquestrar fluxos de trabalho dinâmicos: execute um fluxo de trabalho agrupado ou deixe Claude escrever um que execute muitos subagentes e verifique suas descobertas um contra o outro.
- Executar sessões paralelas com worktrees: inicie Claude em um checkout isolado, controle o que é copiado e limpe depois.