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 |
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_keyPerguntas 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 Ver planos ilimitadosA 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.