Um subagente é um agente que o agente principal lança para uma tarefa delimitada, como procurar onde uma função é usada. Ele começa com a própria janela de contexto, trabalha com suas ferramentas e devolve só o resultado, não tudo o que leu. Assim o contexto do agente principal não se enche de detalhes.
🤖Agente principal→📤Lança um subagente→🔎Trabalha no contexto dele→📋Devolve o resultado
Teste o que aprendeu
Uma pergunta do app. Escolha uma resposta.
Você disse ao agente "não mexa em pagamentos". Ele lança um subagente. O que repassa?
Ele começa com o próprio contexto, limpo. O que você disse ao agente principal não chega se não for repassado.
Ele só sabe o que recebe. A tarefa e a regra que vale para ela bastam, e o contexto dele fica livre para trabalhar.
Assim enche o contexto dele de coisas que não precisa, que é justamente o que um subagente serve para evitar.
Você pede a um agente de código que renomeie uma função. Antes ele precisa saber onde ela é usada: abre 40 arquivos e acha 6 chamadas. Se faz isso sozinho, esses 40 arquivos ficam na janela de contexto dele pelo resto da sessão. Se um subagente faz, o principal recebe uma lista de 6 linhas.
Também serve para trabalhar em paralelo, com três subagentes revisando três pastas ao mesmo tempo, e para dar a uma parte do trabalho outras regras: um revisor que só pode ler, sem permissão para editar, ou com instruções próprias de revisor.
O que custa
Delegar soma pedidos e relatos, e poupa trabalho e espaço ao principal. Se sai mais barato, depende: um modelo mais barato numa tarefa delimitada pode compensar; três subagentes em paralelo costumam gastar bem mais tokens que um agente só. Para conferir, some tudo, revisão incluída.
E, a menos que a ferramenta o lance com uma cópia da conversa, ele começa sem saber o que o principal sabia. O que você falou na conversa não chega a ele se ninguém passar. Por isso o pedido ao subagente precisa ser completo: a tarefa, o que já se sabe e as regras que valem para ela. Escolher o que passar é engenharia de contexto.
Subagente, skill e arquivo de regras
Uma skill soma instruções ao mesmo agente, no mesmo contexto. Um arquivo como CLAUDE.md dá regras fixas para a sessão inteira. Um subagente é outro agente, com contexto separado, e de todo o trabalho que fez só volta o que ele relata.
Em outubro de 2026, o Claude Code usa esse nome e deixa você definir os seus, cada um com suas instruções e ferramentas. Outras ferramentas têm ideias parecidas com outros nomes, e mudam com frequência: confira a documentação da que você usa.
Erros comuns
"Mais subagentes sai mais barato." É mais rápido em paralelo, mas costuma gastar mais tokens. "Ele sabe o que conversamos." Só sabe o que recebe. "Se o subagente disse, está comprovado." O relato dele é um resumo: pode deixar algo de fora ou errar, como qualquer agente. Para uma tarefa pequena, lançar um custa mais do que economiza.