Agent Tool

Tipos de agentes disponíveis

O Claude Code oferece uma variedade de subagentes especializados:

general-purpose           — agente genérico
Explore                   — exploração de codebase
Plan                      — planejamento de implementação
code-reviewer             — revisão de código
code-archaeologist        — análise de código legado
performance-optimizer     — otimização de performance
documentation-specialist  — geração de documentação
backend-developer         — desenvolvimento backend
frontend-developer        — desenvolvimento frontend
react-component-architect — componentes React
django-backend-expert     — Django
rails-backend-expert      — Ruby on Rails
... (muitos outros)

Como o Claude usa Agent internamente

Quando você pede uma tarefa complexa, o Claude pode automaticamente spawnar subagentes para partes independentes, executar em paralelo, e consolidar resultados — sem que você precise pedir explicitamente.

Forçando uso de agente

Você pode instruir o Claude explicitamente a usar subagentes:

"Use um subagente para pesquisar X e me traga o resultado"
"Spawne um agente para revisar cada arquivo em src/"
"Use agent teams para implementar isso em paralelo"

Parâmetros do Agent tool

Os principais parâmetros ao spawnar um agente:

Worktree isolation

O parâmetro isolation: "worktree" cria uma branch e worktree git isolada para o agente, evitando conflitos quando múltiplos agentes modificam arquivos em paralelo.

Use "worktree isolation" para tarefas que modificam arquivos
Cada agente opera em branch/worktree própria
Evita conflitos em trabalho paralelo
O orquestrador faz merge ao final

Boas práticas para usar agentes

Cinco regras essenciais para uso eficiente do Agent tool:

• Brief mínimo — prompt curto e focado
• Output definido — diga exatamente o que retornar
• Sem dependências — agentes paralelos não devem depender entre si
• Contexto por arquivo — passe context em arquivos, não inline
• Retorno enxuto — { status, files, errors } — nunca conteúdo completo