---
id: "fluxos.orquestracao-agent-teams"
titulo: "Agent Teams do Claude Code dentro do Elyra"
resumo: "Inicie os Agent Teams nativos do Claude Code num terminal do Elyra, com os teammates abrindo como divisões do painel."
idioma: "pt-br"
tipo: "guia"
categoria: "agentes"
aplicavelDesde: "0.0.16"
capabilities: ["orchestration.claude.teams"]
estadoEditorial: "aprovado"
nivelEvidencia: "artefato-distribuido"
refFonte: "27574c339b58316408f6be2d62169d59041d07bf"
revisaoFonte: "2026-09-24"
revisor: "mantenedor (v1, 2026-10-03)"
rota: "/docs/pt-br/fluxos/orquestracao-agent-teams/"
fonte: "pt-br/fluxos/orquestracao-agent-teams.md"
caminhoPublico: "docs/publica/pt-br/fluxos/orquestracao-agent-teams.md"
hashFonte: "sha256:6b0c110ac227fdb5f8e718e056b2a08b6f3a2fecc1aa56d63b2497c0933148cc"
hashDestaPagina: "sha256:6b0c110ac227fdb5f8e718e056b2a08b6f3a2fecc1aa56d63b2497c0933148cc"
traducaoAssistidaPorIA: false
traducaoDesatualizada: false
corpoRetido: false
---
O Claude Code tem um modo próprio de trabalhar com vários agentes ao mesmo tempo, os **Agent Teams**.
O Elyra expõe esse modo dentro do terminal, com uma diferença de forma: os teammates abrem como
**divisões nativas do painel**, em vez de janelas ou processos separados que você precisa procurar.

## Como iniciar

```bash
elyra claude-teams
```

O comando só funciona **dentro de um terminal do Elyra** — ele é um repasse para o Claude Code, não um
agente próprio. Qualquer outro argumento é passado direto para o Claude Code.

## Quando usar isto, e quando não

| Você quer | Use |
|---|---|
| Vários agentes trabalhando em paralelo, coordenados por conversa, com cartões ligados no Canvas | A orquestração do próprio Elyra: [o maestro e os cartões ligados](/docs/pt-br/fluxos/orquestracao-conceito/) |
| O modo Agent Teams nativo do Claude Code, com as divisões dele | `claude-teams` |

São coisas diferentes com nomes parecidos. As **mensagens** e os **papéis** do Elyra não são o
mecanismo dos Agent Teams, e vice-versa: um teammate do Claude Code não é um papel de agente do Elyra.

## Limites e escopo

- **Depende do Claude Code instalado e numa versão que suporte Agent Teams.** Se a versão instalada não
  tiver o recurso, o comando repassa e o Claude Code é quem responde — o Elyra não inventa o modo.
- **Só dentro do terminal do Elyra.** Fora dele não há painel para dividir.
- **As divisões são do painel de terminal.** Fechar o painel encerra o que estava nele; o trabalho dos
  teammates não é retomado automaticamente.