O que são subagentes?

Sub-agents are specialized assistants that Claude can delegate tasks to. Subagentes são assistentes especializados aos quais Claude pode delegar tarefas. Each sub-agent runs in its own conversation contacts window with a custom system prompt that you define. Cada subagente roda em sua própria janela de contexto com um system prompt personalizado que você define. When finished, it returns a summary to the main thread while all the intermediate work stays isolated. Ao terminar, ele retorna um resumo para o thread principal enquanto todo o trabalho intermediário fica isolado. One of the main advantages of sub-agents is that they help manage context window usage. Uma das principais vantagens dos subagentes é que eles ajudam a gerenciar o uso da janela de contexto. When you chat with Claude Code, you're adding context to the main context window. Quando você conversa com Claude Code, está adicionando contexto à janela de contexto principal. Every tool call and its results get stored in this main context window. Cada chamada de ferramenta e seus resultados ficam armazenados nessa janela de contexto principal. And so, when Claude uses a sub-agent, a separate window starts. Então, quando Claude usa um subagente, uma janela separada é iniciada. The sub-agent receives two inputs, a custom system prompt from your configuration file, and a task description written by the parent or parent agent based on what you ask for. O subagente recebe duas entradas: um system prompt personalizado do seu arquivo de configuração e uma descrição de tarefa escrita pelo agente pai com base no que você solicitou. The sub-agent then works autonomously. O subagente então trabalha de forma autônoma. When it reads files, edits files, or uses tools, none of these will appear in the main conversation. Quando lê arquivos, edita arquivos ou usa ferramentas, nada disso aparece na conversa principal. Just a summary is returned back. Apenas um resumo é retornado. The entire sub-agent conversation then gets completely discarded. Toda a conversa do subagente é completamente descartada ao final. Consider a task like investigating how the payment system works in an unfamiliar code base. Considere uma tarefa como investigar como o sistema de pagamentos funciona em uma base de código desconhecida. Maybe you're trying to use Claude Code to figure out which service handles refunds. Talvez você esteja tentando usar Claude Code para descobrir qual serviço processa reembolsos. Well, without a sub-agent, Claude might read 15 files, run several searches, and trace through multiple function calls. Sem um subagente, Claude poderia ler 15 arquivos, executar várias buscas e rastrear múltiplas chamadas de função. All of that context fills your context window, even if you only needed one single fact, which service handles refunds. Todo esse contexto preenche sua janela de contexto, mesmo que você precisasse de um único fato: qual serviço processa reembolsos. With a sub-agent, you get the answer without the journey. Com um subagente, você obtém a resposta sem o percurso. The sub-agent explores, discovers the answer, and returns a focused summary, keeping your main context clean. O subagente explora, descobre a resposta e retorna um resumo focado, mantendo seu contexto principal limpo. But, the main window loses visibility into how the sub-agent reaches its conclusions and what it discovered along the way. Mas a janela principal perde visibilidade de como o subagente chega às suas conclusões e o que ele descobriu no caminho. Claude Code includes several built-in sub-agents that you can use immediately, like the general-purpose sub-agent, used for multi-step tasks that require both exploration and action. Claude Code inclui vários subagentes integrados que você pode usar imediatamente, como o subagente de uso geral, usado para tarefas com múltiplas etapas que exigem exploração e ação. The explore sub-agent, used for fast searching of code bases. O subagente explore, usado para busca rápida em bases de código. The plan sub-agent, used during plan mode for research and analysis of your code base before presenting a plan. O subagente plan, usado no modo de planejamento para pesquisa e análise da sua base de código antes de apresentar um plano. And you can also create your own sub-agents with custom system prompts and tool access. E você também pode criar seus próprios subagentes com system prompts personalizados e acesso a ferramentas. Sub-agents like Claude Code break work into focused pieces, keep your main context window clean, and bring back just what you need, whether you're using the built-in ones or creating your own. Subagentes como Claude Code dividem o trabalho em partes focadas, mantêm sua janela de contexto principal limpa e trazem de volta apenas o que você precisa, seja usando os integrados ou criando os seus próprios. They're a practical way to get more out of longer Claude Code sessions. São uma forma prática de aproveitar mais as sessões longas do Claude Code.