Claude Code já é um dos agentes de codificação mais poderosos que você pode usar hoje. Ele pode ler arquivos, executar comandos, editar código, verificar erros e executar grandes tarefas de desenvolvimento com muito pouca ajuda. A maioria das pessoas começa a usá-lo como um assistente de terminal mais inteligente, o que já o torna útil o suficiente para o trabalho diário de desenvolvimento.
Mas esta configuração básica também esconde um dos recursos mais úteis do Claude Code. Muitos de nós ainda gerimos tudo através de um único agente central, mesmo que a tarefa envolva claramente investigação, planeamento, implementação, testes e revisão. Embora isso funcione para alterações menores, você começa a ver rachaduras quando a sessão fica longa. Os subagentes de Claude Code resolvem este problema dividindo o trabalho entre assistentes. Cada subagente obtém sua própria janela de contexto, suas próprias instruções e acesso à sua própria ferramenta.
O código de Claude funciona melhor se você parar de pedir a ele para codificá-lo
O código de Claude se tornou muito mais útil quando parei de pensar nele como um gerador de código e comecei a usá-lo para dar sentido a projetos e ao caos terminal.
Problema ao usar apenas um agente
A janela de contexto entra em colapso rapidamente
Usar um único agente de código Claude para tudo se torna um problema quando o agente continua coletando contexto. Cada leitura de arquivo, saída de comando, mensagem de erro e explicação anterior aumentam a importância da mesma sessão. A janela de contexto contém toda a conversa, incluindo mensagens, arquivos, comandos, resultados de ferramentas e outras informações da sessão. À medida que esta janela é preenchida, o modelo começa a perder nitidez e a cometer mais erros.
Por exemplo, mesmo em uma sessão normal de depuração, Claude lê um arquivo, verifica outro arquivo, executa um teste, acompanha o bug, verifica a configuração e depois retorna ao problema original. Isto cria confusão porque o mesmo agente tem de desempenhar muitos papéis ao mesmo tempo. Estes trabalhos exigem prioridades diferentes e muitas vezes deixam para trás diferentes tipos de ruído.
A falta de isolamento do contexto torna-se a verdadeira limitação. Se Claude lê dez arquivos enquanto investiga uma causa possível, essas leituras permanecem parte da conversa principal mesmo depois que o caminho se torna irrelevante. Se o teste resultar em um log de falha longo, o modelo carrega esse log para os turnos subsequentes. O agente ainda consegue resolver a tarefa, mas agora está trabalhando em um espaço de trabalho desordenado.
Também afeta a forma como Claude segue as instruções. Você pode começar pedindo a Claude que apenas investigue o problema e depois peça para implementar a solução mais segura. A mesma conversa agora inclui orientações de pesquisa, suposições abandonadas, planos parciais e restrições atualizadas. O modelo ainda pode seguir o seu pedido mais recente, mas o material anterior está competindo por atenção.
Claude Code pode coletar sessões longas quando a janela de contexto é preenchida, e você pode usar manualmente comandos como /clear e /compact para gerenciar o contexto. Essas ferramentas ajudam você a recuperar espaço, mas não separam o trabalho por responsabilidade como fazem os subagentes.
Subagentes do Claude Code protegem a sessão principal
Você pode dividir o mesmo trabalho entre vários subagentes
Os subagentes do Claude Code são assistentes individuais que a sessão principal pode gerar para um trabalho focado. Cada um obtém sua própria janela de contexto, prompt do sistema, acesso a ferramentas e configurações de modelo, se configurado dessa forma. A sessão principal do Código Claude não precisa mais aprender tudo antes de tomar sua próxima decisão.
Agora você pode manter a sessão principal do Claude Code como moderador e usar subagentes para trabalhos limitados que, de outra forma, inundariam a conversa. Um agente de pesquisa é o exemplo mais simples. Posso pedir para verificar a parte suja da base de código, comparar alguns arquivos e retornar apenas a conclusão. A sessão pai recebe um resumo sem continuar a investigação completa.
Claude Code também dá aos subagentes controle de configuração suficiente para se sentirem úteis em vez de cosméticos. Um subagente em nível de projeto pode residir dentro .claude/agents/ e tornar-se parte do fluxo de trabalho do repositório enquanto o subagente no nível do usuário pode viver ~/.claude/agents/ e me siga em projetos.
Existem vários modelos com os quais você pode trabalhar. Descobri que o modelo de orquestrador e trabalhador é adequado para a maioria dos fluxos de trabalho de codificação. Aqui, o gerente verifica a solicitação recebida e divide o trabalho em tarefas menores. O gerente então delega cada tarefa a um subagente específico.
Existe também o modelo scout de que falei no exemplo acima. Inclui um subagente leve que analisa o material de origem e recupera apenas informações relevantes. O agente mestre recebe um breve resumo em vez de processar todo o conjunto de dados. Então você tem o padrão split-merge, onde o orquestrador divide uma tarefa maior em múltiplas tarefas paralelas. Cada subagente conclui o trabalho que lhe foi atribuído sem esperar por outros agentes. A orquestração, após a conclusão, combina os resultados retornados em um resultado final.
Você também pode usar modelos diferentes para tarefas diferentes. Usei Claude Sonnet para a maioria das tarefas de coordenação e execução. Você também pode usar o Haiku se tiver ações simples que não exijam justificativa. Opus, é claro, funciona melhor como orquestrador mestre.
Fique de olho na janela do aplicativo
Isso irá embora mais cedo do que você pensa
Embora os subagentes possam proporcionar um bom aumento de produtividade, eles também assumem o controle de sua janela de uso. Eles mantêm a sessão principal limpa, mas cada agente gerado ainda executa suas próprias solicitações, lê o contexto, chama ferramentas e registra credenciais. No código de Claude, seu dia de trabalho é definido por uma janela de cinco horas, e os agentes paralelos podem consumi-lo muito mais rápido do que uma sessão típica de agente único.
Eu não criaria um subagente para comandos simples, pequenas correções ou qualquer coisa que um agente pai possa concluir. Use-os para trabalhos barulhentos que fornecem resultados compactos, como pesquisa de repositórios, falhas de testes, análise de logs ou revisões de segurança. Caso contrário, você estará trocando clareza de contexto por sobrecarga de token oculto e o fluxo de trabalho ficará caro sem melhorar.
Claude Coud tem muitos segredos escondidos
A maioria de nós não usa o código de Claude na íntegra. Já é uma excelente ferramenta de codificação, mas não serve apenas para escrever código. O Código de Claude se torna muito mais poderoso quando você pensa nele como um ambiente de desenvolvimento configurável, em vez de um simples assistente de codificação baseado em chat.
O verdadeiro poder de Claude Code vem das melhorias das quais ninguém quer falar
Claude Code fica melhor quando você para de perseguir fluxos de trabalho chamativos e começa a obter detalhes enfadonhos de configuração.
