Source: https://aiprimetech.io/pt/claude-code/subagents/

[Início](/pt/) › [Claude Code](/pt/claude-code/) › Subagentes

[Visão geral](/pt/claude-code/)[Instalação](/pt/claude-code/install/)[referência da CLI](/pt/claude-code/cli/)[Preços e limites](/pt/claude-code/pricing/)[Agent SDK](/pt/claude-code/sdk/)[Skills e plugins](/pt/claude-code/skills/)[GitHub](/pt/claude-code/github/)[Web, desktop e IDE](/pt/claude-code/web-and-desktop/)[Modelos](/pt/claude-code/models/)[Erros](/pt/claude-code/errors/)[Código aberto?](/pt/claude-code/open-source/)[Tutorial](/pt/claude-code/tutorial/)[Para estudantes](/pt/claude-code/for-students/)[Automação de QA](/pt/claude-code/qa-automation/)[vs Cursor](/pt/claude-code/vs-cursor/)[vs Codex e OpenCode](/pt/claude-code/vs-codex/)[Subagentes](/pt/claude-code/subagents/)[Hooks](/pt/claude-code/hooks/)[MCP](/pt/claude-code/mcp/)[Ecossistema](/pt/claude-code/ecosystem/)[VS Code](/pt/claude-code/vscode/)[OpenRouter](/pt/claude-code/openrouter/)[Limites de requisições](/pt/claude-code/rate-limits/)[Guia em chinês](/claude-code/zh/)

Última atualização: 11 de outubro de 2026

# Subagentes do Claude Code: como funcionam, como defini-los e equipes de agentes

Um subagente é um agente separado do Claude Code com seu próprio prompt de sistema, suas próprias permissões de ferramentas e — a parte importante — sua própria janela de contexto. A sessão principal delega uma tarefa a ele, recebe um resumo de volta e mantém seu contexto limpo. Quando bem usados, os subagentes fazem a diferença entre uma sessão que se degrada após uma hora e outra que funciona o dia inteiro.

## TLDR
- Defina um como um arquivo Markdown em .claude/agents/ (projeto) ou ~/.claude/agents/ (usuário): metadados iniciais para nome, descrição, ferramentas e modelo; o corpo é o prompt de sistema.
- O Claude delega automaticamente quando a descrição corresponde à tarefa, ou explicitamente quando você menciona o agente pelo nome.
- Cada subagente mantém seu próprio contexto e tem seus próprios tokens cobrados; os resultados retornam resumidos.
- /agents cria e gerencia esses subagentes; as equipes de agentes ampliam a ideia para a coordenação de sessões.

## Como definir um subagente 

```
# .claude/agents/code-reviewer.md
---
name: code-reviewer
description: Reviews a diff for correctness, security and test coverage. Use after any non-trivial change.
tools: Read, Grep, Glob, Bash(git diff *)
model: sonnet
---
You are a senior reviewer. Read the staged diff, list concrete defects with file:line,
flag untested paths, and stop. Do not edit files.
```

name é como você o chama; description é como o Claude decide chamá-lo por conta própria, portanto escreva como uma regra de encaminhamento ("use após qualquer alteração não trivial"), em vez de um cargo. tools restringe o que ele pode fazer — um revisor que não pode editar é um revisor mais seguro. model fixa um nível: haiku para exploração e classificação, sonnet para a maior parte do trabalho, opus para a etapa difícil, ou inherit para seguir a sessão principal. 

## Agentes de projeto e de usuário 

Os arquivos em .claude/agents/ pertencem ao repositório e o acompanham — versione-os, e todos os membros da equipe terão o mesmo revisor, criador de testes e agente de migração. Os arquivos em ~/.claude/agents/ são seus em todos os projetos. Os agentes de projeto têm prioridade em caso de conflito de nomes. /agents dentro de uma sessão lista, cria e edita ambos os tipos sem precisar manipular os arquivos manualmente. 

## Quando o Claude delega 

De duas formas. Implícita: o agente principal lê a descrição de cada subagente e delega quando uma tarefa corresponde — não é necessário dizer "execute o subagente code-reviewer nisso" se a descrição já informa quando usá-lo. Explícita: mencione-o pelo nome no prompt. Em ambos os casos, o subagente é executado em seu próprio contexto, vê apenas o que recebe e o que lê, e retorna um resultado que a sessão principal resume em seu próprio histórico. Subagentes não iniciam subagentes; a hierarquia tem apenas um nível. 

## Por que eles mantêm o custo das sessões baixo 

Cada turno no Claude Code reenvia toda a conversa. Um subagente que lê quarenta arquivos faz isso em sua própria janela de contexto; o agente principal recebe um parágrafo. Sem subagentes, esses quarenta arquivos permaneceriam no contexto principal pelo restante da sessão, sendo reenviados a cada turno. Portanto, o padrão para bases de código grandes é: explorar com um subagente Haiku, revisar com um subagente Sonnet e reservar o contexto do agente principal para decisões. Cada subagente tem seus próprios tokens cobrados — não é gratuito, mas seu consumo fica isolado. 

## Paralelismo e limites de requisições 

Vários subagentes podem executar ao mesmo tempo, e cada um corresponde a uma requisição paralela com streaming. Essa é a maneira mais rápida de atingir o limite de requisições simultâneas de qualquer endpoint; por isso, em uma conta nova de gateway, comece com dois ou três em paralelo e solicite maior simultaneidade quando houver uma carga de trabalho real. O guia de erros explica o 429 que você recebe caso contrário. 

## Equipes de agentes 

Versões mais recentes do Claude Code adicionam equipes de agentes: em vez de um agente principal delegar a subagentes de curta duração, várias sessões se coordenam como integrantes identificados por nome, com uma lista de tarefas compartilhada e mensagens entre elas, de modo que um líder possa distribuir trabalho, pedir atualizações de status e interromper um integrante. É um recurso experimental que vem desativado até ser habilitado por uma configuração e muda entre versões — consulte claude --help e o registro de alterações para encontrar a opção atual, em vez de consultar uma publicação de blog. O modelo mental é o mesmo dos subagentes, com persistência e comunicação adicionadas; o modelo de custos também é o mesmo, multiplicado pelo número de integrantes. 

## No gateway 

Subagentes e equipes usam o mesmo endpoint e a mesma chave da sessão principal, portanto ANTHROPIC_BASE_URL=https://aiprimetech.io abrange todos eles. Em um plano ilimitado de preço fixo, a questão do paralelismo passa a ser de uso justo, em vez de cobrança, e é por isso que usuários com uso intenso de múltiplos agentes tendem a optar por ele. 

 | Plano | Duração | Preço

 | Ilimitado por 1 hora | 1 hora | $1

 | Ilimitado por 24 horas | 24 horas | $10

 | Ilimitado por 1 semana | 1 semana | $49

 | Ilimitado por 15 dias | 15 dias | $89

[Todos os planos ilimitados →](/pt/plans/)

## Experimente gratuitamente primeiro

Novas contas recebem $5 em crédito gratuito para a API com o código CLAUDECODE — suficiente para uma noite de Claude Code com Sonnet — e depois créditos com 7.69231× o valor nominal.

```
export ANTHROPIC_BASE_URL=https://aiprimetech.io
export ANTHROPIC_API_KEY=your_key
```

[Crie uma conta com o código CLAUDECODE](/register?promo=CLAUDECODE)

## Perguntas frequentes

O que é um subagente no Claude Code?

Um agente separado com seu próprio prompt de sistema, permissões de ferramentas, escolha de modelo e janela de contexto, definido como um arquivo Markdown em .claude/agents/, ao qual a sessão principal delega tarefas.Onde está a documentação de subagentes do Claude Code?

A referência oficial está na documentação do Claude Code da Anthropic, na seção Subagentes; esta página é a versão prática — o formato do arquivo, quando a delegação acontece e quanto custa.Subagentes têm custo adicional?

Seus próprios tokens são cobrados como em qualquer requisição. Eles economizam dinheiro em sessões longas ao manter grandes volumes de leitura fora do contexto do agente principal e custam mais se você executar muitos em paralelo com Opus.O que são equipes de agentes?

Uma extensão experimental em que várias sessões do Claude Code se coordenam como integrantes identificados por nome, com troca de mensagens e uma lista de tarefas compartilhada, em vez de um agente principal e auxiliares de curta duração.

## Execute o Claude Code no gateway

Os mesmos modelos, duas variáveis de ambiente, créditos com 7.69231× o valor nominal — ou um plano ilimitado com preço fixo. Novas contas: $5 em crédito gratuito para a API com o código CLAUDECODE.[Obter uma chave de API](/register?promo=CLAUDECODE) [Ver planos ilimitados](/pt/plans/)

A AI Prime Tech é um gateway de API independente e não é afiliada, endossada nem patrocinada pela Anthropic. “Claude” e “Claude Code” são marcas comerciais da Anthropic. Os recursos do Claude Code descritos aqui seguem a documentação pública da Anthropic no momento da redação e mudam com frequência; os preços e as listas de modelos nesta página são obtidos das configurações atuais deste gateway.

## Mais guias do Claude Code

[Claude Code: o guia completo](/pt/claude-code/)[Como instalar o Claude Code](/pt/claude-code/install/)[Documentação da CLI do Claude Code: comandos e flags](/pt/claude-code/cli/)[Preços e limites do Claude Code, explicados](/pt/claude-code/pricing/)[O SDK do Claude Code, agora Claude Agent SDK](/pt/claude-code/sdk/)[Skills e plugins do Claude Code](/pt/claude-code/skills/)[Claude Code no GitHub: o App, a Action e @claude](/pt/claude-code/github/)[O Claude Code tem uma interface web? Entenda as versões web, desktop e para IDE](/pt/claude-code/web-and-desktop/)[Qual modelo o Claude Code usa e como alterá-lo](/pt/claude-code/models/)[Erros do Claude Code e como corrigi-los](/pt/claude-code/errors/)[O Claude Code é de código aberto?](/pt/claude-code/open-source/)[Tutorial do Claude Code: sua primeira sessão real](/pt/claude-code/tutorial/)[Claude para estudantes: Claude Code, a API e o que você realmente ganha na área de educação](/pt/claude-code/for-students/)[Como usar o Claude Code para automação de QA](/pt/claude-code/qa-automation/)[Claude Code vs Cursor: qual usar, quando — e como usar ambos](/pt/claude-code/vs-cursor/)[Claude Code vs Codex vs OpenCode: comparação dos agentes de terminal](/pt/claude-code/vs-codex/)[Hooks do Claude Code: controle determinístico sobre o que o agente faz](/pt/claude-code/hooks/)[MCP no Claude Code: conexão de servidores, escopos, MCP remoto e exemplos reais](/pt/claude-code/mcp/)[O ecossistema do Claude Code: roteadores, frameworks, plugins e as listas que os acompanham](/pt/claude-code/ecosystem/)[Claude Code no VS Code: a extensão, o uso pelo terminal e os erros](/pt/claude-code/vscode/)[Como usar o OpenRouter no Claude Code (e quando não usar)](/pt/claude-code/openrouter/)[Erro de limite de taxa do Claude: o que significa "Erro de API: limite de taxa atingido" e como corrigir](/pt/claude-code/rate-limits/)[Como usar o Claude Code: da instalação ao uso diário](/claude-code/zh/)