# Claude Code Agent Teams - Da Configuracao aos Atalhos > Author: Tony Lee > Published: 2026-02-09 > URL: https://tonylee.im/pt/blog/claude-code-agent-teams-setup-shortcuts-guide/ > Reading time: 5 minutes > Language: pt > Tags: ai, claude-code, developer-tools, ai-agents, workflow, multi-agent ## Canonical https://tonylee.im/pt/blog/claude-code-agent-teams-setup-shortcuts-guide/ ## Rollout Alternates en: https://tonylee.im/en/blog/claude-code-agent-teams-setup-shortcuts-guide/ ko: https://tonylee.im/ko/blog/claude-code-agent-teams-setup-shortcuts-guide/ ja: https://tonylee.im/ja/blog/claude-code-agent-teams-setup-shortcuts-guide/ zh-CN: https://tonylee.im/zh-CN/blog/claude-code-agent-teams-setup-shortcuts-guide/ zh-TW: https://tonylee.im/zh-TW/blog/claude-code-agent-teams-setup-shortcuts-guide/ ## Description Guia pratico sobre o recurso de equipes multi-agente do Claude Code: ativacao, atalhos de teclado, compatibilidade de terminal, gestao de tarefas e limitacoes conhecidas. ## Summary Claude Code Agent Teams - Da Configuracao aos Atalhos is part of Tony Lee's ongoing coverage of AI agents, developer tools, startup strategy, and AI industry shifts. ## Outline - Agentes Solo Agora Constroem Equipes - A Configuracao Leva 30 Segundos - Os Unicos Atalhos Que Voce Precisa - A Compatibilidade de Terminal Varia - Como as Tarefas Fluem - Os Tokens Acabam Mais Rapido do Que Voce Esperaria - Limitacoes Que Vale a Pena Conhecer Antes de Encontra-las ## Content O Claude Code Agent Teams foi lancado junto com a versao Opus 4.6. Sinceramente, considero o recurso ineficiente neste estagio - o consumo de tokens e alto e a sobrecarga de coordenacao e real. Mas depois de ler o guia do Tom (@tomcrawshaw01), percebi que a arquitetura em si merece ser compreendida. Familiarizar-se com ela durante a fase de preview fara diferenca quando o recurso atingir disponibilidade geral. ## Agentes Solo Agora Constroem Equipes Um agente lider decompoe o trabalho e distribui entre multiplos colegas rodando em paralelo. A diferenca principal em relacao a sub-agentes: os colegas trocam mensagens diretamente entre si. Em vez de apenas reportar resultados ao lider, eles compartilham descobertas e ate questionam o trabalho uns dos outros. ## A Configuracao Leva 30 Segundos O recurso e experimental, entao vem desativado por padrao. Uma unica linha o habilita. Adicione `CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS` com o valor `"1"` no bloco `env` do seu `settings.json`. Voce tambem pode definir como variavel de ambiente do shell, mas o `settings.json` persiste entre sessoes e e mais conveniente. ## Os Unicos Atalhos Que Voce Precisa Com uma equipe em execucao, voce vai alternar entre o lider e os colegas para monitorar o progresso. Nao ha muito o que memorizar. - **Shift+Up / Shift+Down** - Alternar entre colegas (modo in-process - e o que voce vai usar na maior parte do tempo) - **Enter** - Ver detalhes da sessao do colega selecionado - **Escape** - Interromper o turno atual do colega selecionado - **Ctrl+T** - Alternar a lista de tarefas compartilhada - **Shift+Tab** - Alternar o modo Delegate, que restringe o lider a apenas coordenar (sem programar) - **Modo split-pane** - Clicar no painel de um colega para interagir diretamente O modo Delegate e importante. Sem ele, o lider as vezes comeca a programar em vez de delegar para os colegas. ## A Compatibilidade de Terminal Varia O modo split-pane so funciona no tmux e no iTerm2. O terminal integrado do VS Code, Windows Terminal e Ghostty nao sao oficialmente suportados. Se voce esta usando Ghostty, vai utilizar o modo in-process padrao com Shift+Up/Down para alternar entre colegas. Para visualizar a saida dos colegas lado a lado, execute o Claude Code dentro de uma sessao tmux. O `teammateMode` padrao e `"auto"`, entao ele muda automaticamente para split-pane quando detecta o tmux. Tenho usado `tmux new -s {meu-projeto}` no iTerm, depois iniciando com `claude --teammate-mode tmux`. Isso da uma visao em tela cheia de toda a atividade da equipe. ## Como as Tarefas Fluem O trabalho e organizado em torno de uma lista de tarefas. O lider cria as tarefas e os colegas assumem cada uma delas. - Quando o lider cria uma lista de tarefas, os colegas automaticamente reivindicam a proxima tarefa nao atribuida - Dependencias entre tarefas sao suportadas - tarefas sucessoras sao desbloqueadas somente apos as predecessoras serem concluidas - Voce pode atribuir tarefas especificas a colegas especificos instruindo o lider - O encerramento dos colegas segue um protocolo: o lider envia uma solicitacao de shutdown, o colega confirma e entao encerra - Para limpeza completa: confirme que todos os colegas foram encerrados e depois instrua o lider a fazer a limpeza Um prompt simples que mencione "team" ja ativa o recurso automaticamente. Mas para um controle mais preciso, defina o numero total de colegas, atribua nomes e funcoes a cada um, delimite o escopo de delegacao e forneca um arquivo externo com regras de dependencia entre tarefas. ## Os Tokens Acabam Mais Rapido do Que Voce Esperaria Cada colega e uma sessao independente do Claude Code. Executa-los em paralelo escala os custos rapidamente. Algumas praticas ajudam. - Escreva prompts especificos ao criar colegas. O historico de conversa do lider nao e transferido - apenas o CLAUDE.md e o contexto do servidor MCP sao carregados automaticamente - Dois colegas editando o mesmo arquivo causarao sobrescrita. Particione o trabalho no nivel de arquivo - Comece com pesquisa ou revisao de codigo em vez de geracao de codigo. A complexidade de coordenacao e menor - Mantenha as unidades de tarefa pequenas e concretas - uma unica funcao ou um unico arquivo de teste funciona bem ## Limitacoes Que Vale a Pena Conhecer Antes de Encontra-las Isto e um preview. Arestas sao esperadas. Conhece-las antecipadamente evita frustracao. - Usar `/resume` ou `/rewind` encerra os colegas em modo in-process. Voce precisara pedir ao lider para criar novos - O status das tarefas pode atrasar. Se um colega conclui o trabalho mas nao marca a tarefa como concluida, as tarefas sucessoras permanecem bloqueadas. Verifique manualmente e peca ao lider para atualizar - Apenas uma equipe por sessao. Colegas nao podem criar sub-equipes - A sessao que cria a equipe permanece como lider. Nao e possivel trocar de lider ou promover colegas durante a sessao O preview e rudimentar e a questao de custo-eficiencia permanece em aberto. Mas se voce quer entender para onde os fluxos de trabalho multi-agente estao caminhando, o caminho mais rapido e ativar o recurso e testa-lo por conta propria. Ferramentas exigem experiencia pratica para serem avaliadas adequadamente. ## Related URLs - Author: https://tonylee.im/en/author/ - Publication: https://tonylee.im/en/blog/about/ - Related article: https://tonylee.im/pt/blog/eight-hooks-that-guarantee-ai-agent-reliability/ - Related article: https://tonylee.im/pt/blog/medvi-two-person-430m-ai-compressed-funnel/ - Related article: https://tonylee.im/pt/blog/claude-code-layers-over-tools-2026/ ## Citation - Author: Tony Lee - Site: tonylee.im - Canonical URL: https://tonylee.im/pt/blog/claude-code-agent-teams-setup-shortcuts-guide/ ## Bot Guidance - This file is intended for AI agents, search assistants, and text-mode retrieval. - Prefer citing the canonical article URL instead of this text endpoint. - Use the rollout alternates when you need the same article in another prioritized language. --- Author: Tony Lee | Website: https://tonylee.im For more articles, visit: https://tonylee.im/pt/blog/ This content is original and authored by Tony Lee. Please attribute when quoting or referencing.