Subagentes no Claude Code: o que são e como usar

Resposta curta: Subagentes são ajudantes especializados dentro do Claude Code. Você pode pedir para o agente principal criar um subagente com uma tarefa específica, como analisar um tipo de arquivo. É como chefe de um projeto que contrata um especialista para cuidar de uma parte específica do trabalho.

Imagine que você está cozinhando um jantar complicado. Você é o chef principal (o Claude Code), mas precisa de ajuda para tarefas especializadas: um sous-chef para cortar legumes, outro para preparar o molho. Subagentes funcionam assim: são "ajudantes especializados" que o Claude Code pode criar sob demanda para dividir tarefas complexas em partes menores e mais gerenciáveis. Isso torna o trabalho mais eficiente e organizado.

Índice

1. O que são subagentes, na prática?
2. Por que usar subagentes?
3. Como criar e gerenciar subagentes?
4. Onde os subagentes vivem e como "pensam"?
5. Limites e custos: tokens e contexto
6. Subagentes vs. Skills vs. Conectores MCP: qual a diferença?

O que são subagentes, na prática?

Pense em um subagente como um funcionário temporário que você contrata para uma tarefa bem específica. O Claude Code (seu assistente principal de programação) é capaz de criar esses "funcionários" sob demanda.

Vamos usar uma analogia:

• Claude Code = Gerente de projetos de uma construtora.
• Subagente = Um pedreiro especialista em azulejos que o gerente chama apenas para assentar o piso do banheiro.

O gerente (Claude Code) continua no comando geral, mas delega uma parte técnica e repetitiva para o especialista (subagente). Esse especialista foca 100% naquilo que sabe fazer de melhor.

No mundo digital, isso significa que você pode pedir ao Claude:

"Crie um subagente para revisar apenas os erros de gramática em documentos Markdown, enquanto eu foco na estrutura do texto."

O subagente criado terá instruções bem claras e um "canto" próprio para trabalhar, sem bagunçar a mesa do agente principal.

Por que usar subagentes?

Dividir para conquistar! Essa é a filosofia. Veja os benefícios:

1. Foco total: Um subagente não se distrai. Se ele foi criado para traduzir textos, ele só pensa em tradução.
2. Memória especializada: O conhecimento necessário para a tarefa fica "guardado" com o subagente, não ocupa a mente do agente principal com detalhes.
3. Reutilização: Você pode pedir para salvar esse subagente e usá-lo de novo em outros projetos, sem precisar treiná-lo do zero.
4. Trabalho em paralelo: Em teoria, o agente principal pode criar vários subagentes para atacar diferentes partes de um problema ao mesmo tempo (embora haja limites técnicos, como veremos).

Uma tabela para comparar situações:

Como criar e gerenciar subagentes?

Você não precisa programar para criar um subagente. Basta conversar com o Claude Code. Veja um exemplo passo a passo:

1. Dê a ideia: No chat do Claude Code, diga o que precisa. Exemplo: "Estou com um projeto que tem muitos arquivos de configuração JSON. Pode criar um subagente especialista em validar e formatar JSON para me ajudar?"
2. Defina a especialidade: O Claude vai perguntar ou sugerir um nome e uma descrição clara para o subagente. Algo como "Validador JSON - Checa sintaxe e aplica formatação padrão".
3. Forneça as regras: Explique como quer que o subagente trabalhe. "Sempre valide o JSON antes de formatar. Use indentação de 2 espaços. Me avise se encontrar chaves faltando."
4. Ative o subagente: O Claude Code criará o subagente. Daqui para frente, você pode se dirigir a ele pelo nome ou pedir ao agente principal para delegar tarefas a ele.

Onde isso acontece? Tudo ocorre dentro do terminal do Claude Code. Terminal é aquela janela preta (ou branca) onde digitamos comandos de texto para o computador, em vez de clicar em ícones. É o "painel de controle" do programador.

Para gerenciar, você pode pedir coisas como:

• "Liste todos os subagentes ativos."
• "Dê mais este arquivo para o Validador JSON analisar."
• "Salve as configurações do subagente 'Tradutor' para eu usar depois."

Onde os subagentes vivem e como "pensam"?

Os subagentes não são programas separados que você instala. Eles são "estados" ou "modos de operação" criados dentro da própria sessão do Claude Code.

Pense na memória de contexto do Claude como uma grande mesa de trabalho. Tudo o que você conversa, todos os arquivos abertos, estão nessa mesa. A mesa tem um tamanho limite (1 milhão de tokens – falaremos disso depois). Criar um subagente é como pegar uma pasta organizadora nova nessa mesa, etiquetá-la com o nome do subagente e colocar dentro só as informações e instruções relacionadas à tarefa dele.

Quando você interage com o subagente, a atenção do Claude se foca principalmente no conteúdo daquela pasta, mantendo o resto da mesa (o projeto principal) mais organizado. A arquitetura (que é o "plano" ou "design" de como um sistema de software é construído) por trás disso permite que o agente principal "chame" o subagente quando necessário.

Limites e custos: tokens e contexto

Aqui entramos em um conceito crucial: tokens. Tokens são as unidades básicas de texto que a IA processa. Pode ser uma palavra inteira, uma sílaba ou um pontuação. Imagine que a IA precisa "digerir" o texto em pedacinhos. 1 milhão de tokens equivalem a mais ou menos 555 mil palavras em português.

Tudo consome tokens: sua pergunta, a resposta da IA, os arquivos que você envia, e as instruções e o histórico de cada subagente. Por isso, criar muitos subagentes com instruções muito longas pode encher a "mesa de trabalho" (a janela de contexto) rapidamente.

Os planos pagos do Claude (Pro, Max, Team) incluem o Claude Code e vêm com um limite de tokens que se renova a cada 5 horas. O uso do chat e do Code compartilham o mesmo limite. Subagentes, por funcionarem dentro do Claude Code, consomem tokens desse limite.

Dica para leigos: Comece com um ou dois subagentes simples. Use para tarefas muito claras. Monitorar o uso de tokens é como ficar de olho no medidor de combustível do carro em uma viagem longa.

Subagentes vs. Skills vs. Conectores MCP: qual a diferença?

Esse é um ponto que confunde muitos iniciantes. São três conceitos diferentes no ecossistema Claude:

Os subagentes são mais temporários e contextuais. As Skills são permanentes e reutilizáveis. Os Conectores MCP são pontes para o mundo externo. Você pode, por exemplo, usar um Conector MCP para acessar uma planilha, criar um subagente para analisar os dados dela e instalar uma Skill que formate a análise em um relatório bonito.

Para entender melhor o conceito central por trás disso tudo, leia nosso pilar: Agente de IA: o que é, como funciona e como criar o seu (sem programar).

Recomendamos testar estas 3 skills primeiro

Antes de criar subagentes complexos, experimente instalar algumas Skills. Elas dão superpoderes ao Claude Code e ajudam a entender o potencial da plataforma.

1. skill-creator-anthropics: Esta é a Skill oficial da Anthropic para criar... outras Skills! É um ótimo ponto de partida para ver como uma funcionalidade é empacotada e reutilizada.
2. agent-eval-affaan-m: Esta Skill ajuda a avaliar a qualidade de um agente de IA. Para um leigo, é como um "corretor automático" que dá notas e feedbacks sobre o desempenho do seu assistente, ajudando você a melhorá-lo.
3. agent-harness-construction-affaan-m: O nome é complexo, mas a função é prática: ela ajuda a construir um ambiente de testes para seu agente. Imagine que você quer treinar seu assistente para responder emails. Essa Skill ajuda a montar um cenário de treino com emails de exemplo.

Perguntas frequentes

Precso pagar para usar subagentes no Claude Code? Sim, pois o Claude Code em si só está disponível nos planos pagos (Pro, Max, Team, Enterprise). O plano Free não tem acesso ao Claude Code, portanto, não pode usar subagentes.

Criar muitos subagentes deixa a IA mais lenta? Não necessariamente mais "lenta", mas pode consumir seus tokens disponíveis mais rápido. Cada subagente ocupa um espaço na memória de contexto (os tais tokens). Se você encher muito o contexto, a IA pode ter menos "espaço mental" para processar tarefas novas.

Posso salvar um subagente para usar amanhã? Diretamente, não da mesma forma que salva um arquivo. Subagentes estão ligados à sessão atual de trabalho. Porém, você pode pedir ao Claude Code para salvar as instruções do subagente em um arquivo de texto. Na próxima sessão, você carrega esse arquivo e pede para criar um novo subagente com as mesmas instruções.

Subagentes funcionam no Claude da web (claude.ai)? Não da mesma forma. No site claude.ai, o conceito mais próximo são os "Conectores" (a implementação deles do MCP), que conectam o chat a apps externos. A criação dinâmica de assistentes especializados dentro de uma conversa é uma feature mais poderosa do Claude Code, o aplicativo para desenvolvedores.

Qual a diferença entre subagente e apenas dar instruções claras? Instruções claras são essenciais. A vantagem do subagente é o isolamento. As instruções do subagente ficam em um "espaço" dedicado, menos sujeito a interferência do longo histórico da conversa principal. É a diferença entre dar um manual para alguém no meio de uma festa barulhenta (instruções na conversa principal) e levá-lo para uma sala silenciosa para explicar a tarefa (subagente).

Leia também

Quer se aprofundar? Confira estes outros artigos do nosso blog:

• Entenda o básico: Claude Code: o que é, como baixar, instalar e quanto custa (guia 2026)
• Como começar a criar: Como criar um agente de IA do zero (sem programar)
• Foco no Claude: Como criar agente de IA no Claude
• Conectando com apps: O que é MCP (Model Context Protocol): explicado de um jeito fácil
• Entenda o "combustível" da IA: O que são tokens em IA (e por que eles acabam tão rápido)

Encontre mais ferramentas prontas para usar no nosso diretório: buscar skills.

---

Fontes

• O que é o Model Context Protocol (consultado em 16/10/2026)
• Claude Code: visão geral (consultado em 16/10/2026)
• Planos e preços do Claude (consultado em 16/10/2026)