# Agentes no Claude Code: o que são e como usar (sub-agents) > Percebe o que são os agentes e sub-agentes no Claude Code, como funcionam na prática e em que situações lhe poupam horas de trabalho. - Fonte: https://doutorai.pt/blog/claude-code-agentes - Autor: Miguel Diamond (https://doutorai.pt/autor/miguel) - Categoria: Claude Code - Publicado: 29 jun 2026 - Site: Doutor AI - a maior biblioteca portuguesa de ferramentas de IA para pequenos negócios (https://doutorai.pt) ## Resposta rápida Os agentes no Claude Code são assistentes especializados e autónomos que o Claude Code pode invocar para realizar tarefas específicas, como rever código, escrever testes ou fazer uma auditoria de segurança. Em vez de um único assistente generalista, tem uma equipa de especialistas disponíveis conforme a necessidade. - Assistentes autónomos especializados em tarefas concretas - Invocados automaticamente pelo Claude Code ou a seu pedido - Podem correr em paralelo para reduzir o tempo total - Reduzem erros em projectos complexos com muitas partes ## O que são os agentes no Claude Code Os agentes no Claude Code são assistentes especializados e autónomos que o Claude Code pode invocar para realizar tarefas específicas. Em vez de um único assistente que tudo faz de forma generalista, os agentes funcionam como membros de uma equipa virtual: cada um tem uma especialidade e o Claude Code delega-lhes o trabalho adequado. Quando pede ao Claude Code para construir uma funcionalidade numa aplicação, por exemplo, ele pode invocar um agente de planeamento para definir a abordagem, depois um agente de revisão de código para verificar o que foi escrito, e por fim um agente de segurança para garantir que não há vulnerabilidades. Tudo de forma automática e coordenada. Se ainda não conhece o Claude Code, vale a pena começar por [perceber o que é o Claude Code](https://doutorai.pt/blog/o-que-e-o-claude-code) antes de mergulhar nos agentes. ## Agentes vs skills: qual a diferença É fácil confundir agentes e skills porque ambos «ensinam» algo ao Claude Code. A diferença fundamental é esta: - **Skills** são ficheiros de instruções e regras que definem como o Claude Code deve comportar-se. São passivas: informam, não agem. - **Agentes** são entidades autónomas que executam tarefas ativamente. Recebem um objetivo, trabalham para o concluir e reportam o resultado. Uma boa analogia: a skill é o manual de boas práticas que um empregado lê; o agente é o empregado que lê o manual e executa o trabalho. Pode aprender mais sobre as skills no nosso artigo sobre [Claude Code skills](https://doutorai.pt/blog/claude-code-skills). ## Como funcionam os sub-agentes O termo «sub-agente» refere-se a agentes invocados por um agente orquestrador principal. O fluxo típico funciona assim: - Você faz um pedido ao Claude Code - O Claude Code, como orquestrador, analisa o pedido e decide que agentes especialistas são necessários - Invoca os sub-agentes adequados, que podem correr em paralelo se as tarefas forem independentes - Os sub-agentes completam as suas tarefas e devolvem os resultados ao orquestrador - O orquestrador consolida tudo e apresenta-lhe o resultado final Este modelo de orquestrador mais sub-agentes é particularmente poderoso para projectos complexos, onde diferentes partes do trabalho requerem competências distintas. ## Agentes mais comuns e o que fazem AgenteO que fazQuando é invocadoplannerCria planos de implementação detalhadosAntes de construir uma nova funcionalidadecode-reviewerRevê código escrito e sinaliza problemasDepois de escrever ou modificar códigotdd-guideOrienta o desenvolvimento guiado por testesAo criar novas funcionalidadessecurity-reviewerAudita vulnerabilidades de segurançaAntes de publicar código com autenticaçãoarchitectToma decisões de arquitetura de sistemasEm projectos com decisões técnicas complexasrefactor-cleanerLimpa código morto e consolida duplicadosEm manutenção e limpeza de código ## Quando faz sentido usar agentes Os agentes brilham quando o trabalho é complexo o suficiente para beneficiar de uma perspectiva especializada. Se está a escrever um pequeno script rápido, não precisa de invocar agentes. Mas se está a construir uma funcionalidade nova, a refactorizar uma base de código grande ou a fazer uma auditoria de segurança, os agentes especializados fazem uma diferença real na qualidade do resultado. A outra situação em que os agentes são especialmente úteis é quando as tarefas podem correr em paralelo. Em vez de fazer tudo sequencialmente, o Claude Code pode lançar vários agentes ao mesmo tempo e reduzir significativamente o tempo total de execução. Explore a [biblioteca de prompts](https://doutorai.pt/prompts) para ver exemplos práticos de como pedir ao Claude Code que utilize agentes específicos. Para a visão completa do Claude Code, visite [doutorai.pt/claude-code](https://doutorai.pt/claude-code). ## Perguntas frequentes ### Qual é a diferença entre um agente e uma skill? Uma skill é um ficheiro de instruções que define regras de comportamento. Um agente é uma entidade autónoma que executa tarefas ativamente. As skills informam o assistente; os agentes trabalham por conta própria para concluir um objetivo. ### Os sub-agentes têm acesso a toda a minha base de código? Os sub-agentes operam dentro do mesmo contexto e permissões do Claude Code. Têm acesso aos ficheiros e ferramentas que o Claude Code tiver disponíveis, mas não têm acesso a nada além do que configurou. ### Posso criar os meus próprios agentes personalizados? Sim. Os agentes são definidos em ficheiros de configuração na pasta de agentes do Claude Code. Pode criar agentes personalizados para as tarefas específicas do seu negócio ou fluxo de trabalho. ### Os agentes correm em paralelo ou em sequência? Podem correr de ambas as formas. Para tarefas independentes, o Claude Code pode invocar vários agentes em paralelo, reduzindo o tempo total. Para tarefas que dependem umas das outras, correm em sequência. ### Preciso de instalar algo extra para usar agentes? Não. Os agentes fazem parte do Claude Code. Precisa apenas de ter o Claude Code instalado e configurado. Alguns agentes específicos podem requerer ferramentas adicionais, mas os agentes de base estão disponíveis de imediato. --- Conteúdo de Doutor AI (https://doutorai.pt). Ao citar, indique a fonte: https://doutorai.pt/blog/claude-code-agentes