O que é um subagente

Um ajudante especializado com contexto próprio

Até aqui, você conversou com um único Claude Code, que fazia tudo na mesma conversa. O subagente amplia essa ideia: em vez de um agente só, você passa a contar com ajudantes especializados que o Claude Code aciona para tarefas específicas. Um subagente é um assistente com um propósito focado, como revisar código ou pesquisar algo, que recebe uma tarefa, trabalha por conta própria e devolve o resultado. Pense num profissional que, diante de uma tarefa específica, chama um especialista de confiança, passa o trabalho, recebe o resultado pronto e segue. O subagente é esse especialista dentro do Claude Code.

O que torna o subagente especial é o contexto isolado. Lembre da janela de contexto, aquele limite de memória de trabalho do modelo. Quando o Claude Code faz uma tarefa grande de exploração na conversa principal, ela enche o contexto com arquivos lidos, buscas e logs que você talvez nunca mais consulte, deixando menos espaço para o que importa. O subagente resolve isso: ele faz esse trabalho pesado no contexto dele, separado do seu, e devolve à conversa principal apenas o resumo, o resultado útil. É como pedir a um assistente que leia um relatório de cem páginas e te traga só as três conclusões: você recebe o essencial sem carregar o volume.

Por que o isolamento ajuda tanto

O benefício do contexto isolado fica claro num exemplo. Imagine que você está no meio de uma tarefa de implementação e precisa, antes, entender como uma parte antiga do projeto funciona, o que exigiria ler dezenas de arquivos. Se você fizer isso na conversa principal, ela vai encher de conteúdo de exploração, e o contexto da sua implementação fica espremido. Se um subagente fizer a exploração, ele lê os dezenas de arquivos no contexto dele e te devolve um resumo de como aquela parte funciona. Sua conversa principal recebe só esse resumo e continua espaçosa e focada na implementação. O trabalho pesado aconteceu, mas o peso ficou de fora.

Esse isolamento também melhora a qualidade. Uma conversa principal poluída de detalhes irrelevantes confunde o agente e dilui a atenção; uma conversa enxuta o mantém afiado. Ao delegar as tarefas ruidosas a subagentes, você não só economiza espaço, mas mantém a linha de raciocínio principal limpa, o que costuma render respostas melhores. É a mesma lógica de um bom gestor que não se afoga em detalhes operacionais: ele delega o detalhe e guarda a cabeça para as decisões. O subagente permite que o Claude Code faça isso consigo mesmo, terceirizando o detalhe e preservando o fio do trabalho principal.

Vale distinguir o subagente de outras ideias parecidas para não confundir. O subagente trabalha dentro de uma sessão, acionado para uma tarefa e devolvendo o resultado ali mesmo. Existem também formas de rodar várias sessões independentes em paralelo e formas de agentes que conversam entre si, mas essas são coisas distintas e mais avançadas. Para este módulo, o foco é o subagente clássico: o ajudante especializado, de contexto isolado, que a sua conversa principal aciona e do qual recebe um resumo. Dominar esse conceito já muda muito como você organiza tarefas maiores com o Claude Code.

Quando um subagente faz diferença

Um subagente não serve para tudo; ele brilha em situações específicas. A primeira é a tarefa lateral ruidosa: algo que precisa ser feito, mas que encheria a conversa principal de conteúdo que você não vai reconsultar, como uma pesquisa longa ou a leitura de muitos arquivos. A segunda é a tarefa especializada e repetida: quando você se pega pedindo o mesmo tipo de trabalho com as mesmas instruções várias vezes, como uma revisão de código no seu padrão. Nesses casos, ter um ajudante dedicado, com contexto próprio e instruções fixas, é mais eficiente do que fazer tudo na conversa principal e reexplicar sempre.