Subagentes
Ir para notas que citam estaSubagentes são agentes auxiliares que o agente principal aciona para uma tarefa específica, cada um com contexto próprio e descartável, devolvendo só o resultado ao fluxo principal.
Em ferramentas agênticas de código como o Claude Code, a sessão tem um agente principal. Quando a tarefa pede especialização ou paralelismo, ele lança subagentes, por exemplo um de backend e outro de frontend. Cada um nasce para aquela tarefa, trabalha no próprio contexto, reporta o resultado e encerra. O ganho é duplo: o especialista rende mais no seu domínio, e o contexto do agente principal não se enche com os detalhes de cada execução, porque recebe só o resumo.
Comunicação em estrela e seus limites
A comunicação é em estrela. O principal manda a tarefa, o subagente responde ao principal, e por padrão nenhum subagente fala com outro, nem sabe que os outros existem. Se ele trava por falta de algo, reporta o impedimento ao principal e morre. O subagente também não vê o que o principal sabe: recebe apenas o contexto que lhe foi repassado, não o histórico da conversa.
Quando se pede explicitamente que subagentes conversem, o agente principal vira barramento: a mensagem do agente 1 vai ao principal, que repassa ao agente 3, cuja resposta volta pelo principal. São três partes por troca, contra duas quando os agentes falam diretamente, que é o modelo de Agent Teams.
O mesmo desenho aparece fora do Claude Code. Em sistemas com um Agente Orquestrador, o orquestrador enxerga de cada subagente só o nome e a descrição, não o prompt interno. Por isso a descrição precisa ser clara: descrição vaga faz o orquestrador encaminhar a tarefa ao subagente errado. O mesmo vale na direção contrária: o briefing que o principal escreve ao subagente precisa dizer objetivo, formato de saída, ferramentas e limites, ou subagentes acabam repetindo o trabalho uns dos outros (ver Comunicação entre Agentes).
Paralelismo, custo e escolha de modelo
Subagentes em paralelo encurtam o trabalho. Em uma tarefa grande, pedir o máximo de agentes possível levou a cinco subagentes simultâneos, e dividir a programação entre vários agentes cortou o tempo mais ou menos pela metade em relação a um agente sozinho.
O custo cresce junto, de forma descrita como quase exponencial, porque cada subagente extra é mais uma conversa com o modelo. Ainda assim, o subagente padrão é mais barato que um time com troca de mensagens: numa mesma tarefa de exemplo, subagentes usaram cerca de 50 mil tokens contra cerca de 100 mil do Agent Teams.
A escolha de modelo por agente é a principal alavanca de custo. O modelo recomendado por padrão para subagentes é o mais barato, e em tarefas específicas e bem delimitadas a diferença para um modelo mais avançado tende a ser pequena; em tarefas complexas, o modelo mais capaz leva vantagem. Um padrão comum é um modelo forte para planejar e um barato para executar, ou isolar uma parte, como o frontend, num subagente com o modelo que melhor a resolve. Modelo caro em CRUD simples raramente se paga.
Onde os subagentes são definidos e como guardam aprendizado
Um subagente é definido por um arquivo que descreve o que ele precisa saber, sua personalidade, suas responsabilidades e as ferramentas que usa. Diferente de skills, que ensinam como fazer uma tarefa pontual, o arquivo de agente define o perfil completo de um especialista. A convenção adotada é escrever esses arquivos em inglês, com a justificativa de ser a língua em que o modelo rende melhor e de evitar um custo extra de tradução interna.
O arquivo pode ficar na pasta .claude do projeto, com uso restrito a ele, ou na pasta global do usuário, reaproveitável em qualquer projeto. Agentes globais tendem a ser genéricos; quanto mais o agente conhece a stack real do projeto, mais eficiente ele é. Um agente de backend especializado numa linguagem diferente da usada no projeto tende a gerar código no paradigma errado.
Como subagentes são efêmeros, o aprendizado entre execuções fica na memória do agente: arquivos markdown por agente, locais ou globais, em que ele registra correções e padrões para aplicar da próxima vez.
Subagentes servem a tarefas independentes que só precisam devolver um resultado. Quando os especialistas precisam negociar entre si, como backend e frontend fechando um contrato, a comunicação pelo principal vira gargalo.