Claude Agent Teams
O passo a passo completo para subir sua primeira squad em minutos: instalar Claude Code, clonar o CT, instalar a squad e acompanhar várias frentes no…
O que é
Claude Agent Teams
Neste tutorial você vai fazer o caminho completo, do zero, em minutos: instalar o Claude Code, clonar o Centro de Treinamento, subir uma squad num projeto e acompanhar várias frentes de trabalho rodando em paralelo pelo Agent View. No fim, você vai ter uma operação de agentes de pé e vai saber comandá-la de uma tela só.
Contratar uma pessoa leva semanas: anúncio, entrevistas, onboarding, tempo até a pessoa produzir. Subir uma squad de agentes leva minutos, e a squad já chega sabendo trabalhar. Com squads, a entrega cresce e o custo não acompanha na mesma proporção — a sua capacidade passa a ser algo que você liga e desliga conforme a demanda.
Você vai aprender cinco conceitos fundamentais para operar squads: Squad (time de agentes de uma frente), Frente (área de trabalho como Dev, Sites, Social), Agent View (painel de despacho onde você acompanha todas as sessões de relance), Paralelismo (várias sessões independentes rodando ao mesmo tempo) e Capacidade sob demanda (subir frente quando precisa, sem inchar custo fixo).
Antes de começar, você precisa de Node.js instalado (node -v responde), Git instalado (git -v responde) e uma conta no Claude para autenticar na primeira execução.
Instalar o Claude Code
Um único comando npm instala o motor dos agentes globalmente. Em segundos você passa a ter o claude disponível em qualquer pasta do seu computador.
Centro de Treinamento
Clone o repositório open source team-os e tenha acesso a todas as squads prontas para instalar com um comando. Funciona como fonte única da verdade para suas equipes de agentes.
Subir uma squad
Use o team-os-creator para instalar uma squad no seu projeto em minutos. A creator pergunta o destino e a squad, mostra o preview e confirma antes de agir.
Agent View — painel de despacho
Acompanhe todas as sessões de agentes de uma tela só. Espaço para espiar, Enter para entrar, seta para sair — como um despachante que vê todos os caminhões de uma vez.
Paralelismo em segundos
Cada tarefa digitada e enviada no Agent View nasce como uma sessão independente em background. Três frentes em paralelo em três Enters.
Nível: iniciante · Tempo estimado: 20 min
Pré-requisitos
- Terminal aberto (Terminal no Mac, PowerShell no Windows)
- Node.js instalado — confirme com node -v no terminal
- Git instalado — confirme com git -v no terminal
- Uma conta no Claude para autenticar na primeira execução
Conceitos-chave
- 01
Squad
Um time de agentes de uma frente (Dev, Sites, Social, Traffic, PM). Cada squad chega pronta para trabalhar numa área específica.
- 02
Frente
Uma área de trabalho. O conselho de ouro é começar por UMA frente só, dominar, e só então abrir as outras.
- 03
Agent View
A tela cheia que você abre com claude agents. É o seu painel de despacho: cada sessão vira uma linha, e você acompanha tudo de relance.
- 04
Paralelismo
Várias sessões independentes rodando ao mesmo tempo. Cada Enter no Agent View dispara uma sessão nova — não é continuação da anterior.
- 05
Capacidade sob demanda
Sobe frente quando precisa, sem inchar custo fixo. A entrega cresce e o custo não acompanha na mesma proporção.
Passo a passo
Do zero à operação rodando
- 01
Passo 1 — Instalar o Claude Code
Cole o comando no terminal. O -g instala de forma global, para você chamar o Claude Code de qualquer pasta. É o motor que roda os agentes. O que esperar: linhas de instalação e, no fim, o terminal livre. Confirme com claude --version.
npm install -g @anthropic-ai/claude-code - 02
Passo 2 — Trazer o Centro de Treinamento
Na sua pasta de projetos, clone o CT. As squads moram no repositório github.com/joaoguirunas/team-os — ele fica ao lado dos projetos, como fonte única da verdade. O que esperar: a pasta team-os criada ao lado dos seus projetos. Rode pwd antes para confirmar onde você está.
git clone https://github.com/joaoguirunas/team-os.git - 03
Passo 3 — Subir UMA squad no projeto
Entre no CT, abra o Claude Code e dispare a instalação, escolhendo uma frente só. Começar por uma frente é o que dá controle — você aprende o ritmo do time numa área antes de abrir várias. A creator pergunta o destino e a squad, mostra o preview e confirma antes de agir. O que esperar: perguntas de destino e squad, preview, confirmação, e a cópia dos agentes, da skill /team-os e do settings.json. A team-os-creator não vai junto — ela fica só no CT.
cd team-os claude /team-os-creator *install - 04
Passo 4 — Ligar o time
Entre no projeto equipado, abra o Claude Code e rode /team-os. A squad chegou, mas está desligada. O /team-os acende o time e, na primeira vez, faz o Discovery — lê o código e monta a memória compartilhada, para os agentes começarem já sabendo o contexto. O que esperar: scan do ambiente, proposta de construir a memória, leitura do código e o painel final perguntando o objetivo da sessão.
/team-os - 05
Passo 5 — Acompanhar várias frentes com o Agent View
No terminal, abra o Agent View com claude agents. É aqui que a capacidade sob demanda vira algo visível — como um despachante de logística que vê todos os caminhões de uma vez. Cada tarefa que você escreve e envia com Enter vira uma sessão em paralelo. Espaço (peek) espia o output recente sem entrar; Enter ou seta para a direita (attach) entra na sessão; seta para a esquerda com input vazio (detach) sai sem matar a sessão. Leia os ícones de estado: animado = trabalhando; amarelo = precisa de você; esmaecido = idle; verde = concluiu; vermelho = falhou; cinza = parada.
claude agents
Escrever página inicial
Escreva a página inicial do site: hero, prova social e um CTA de contato. Siga o Design System do projeto e me avise quando tiver o rascunho pronto.
Criar roteiro de reel
Crie um roteiro de reel de 30 segundos sobre o principal serviço da empresa, no tom da marca. Entregue o roteiro e três sugestões de gancho.
Revisar página de preços
Revise o texto da página de preços buscando promessas exageradas e inconsistências com a memória do projeto. Liste o que mudar, sem editar ainda.
Erros comuns
- permission denied ao instalar: Ajuste as permissões do npm ou use um gerenciador de versões do Node em vez de forçar sudo
- Clonei o CT dentro de um projeto: Rode pwd antes de clonar para conferir onde você está
- Subi várias squads no primeiro dia e me perdi: Uma frente por vez — comece por uma, domine, depois abra as outras
- Pedi tarefa antes de rodar /team-os: Ligue o time com /team-os primeiro, antes de qualquer pedido
- Abri o Agent View e a tabela está vazia: Normal no começo — você ainda não despachou nada. Escreva uma tarefa e dê Enter
- Fechei o Agent View e achei que perdi as sessões: Sair do Agent View não mata nada; as sessões reaparecem na próxima vez que você abrir
- Detach ou sessão sumindo do painel significa que ela morreu: Detach nunca para a sessão. Depois de uns 30 segundos parado, um teammate some do painel por estar idle; ele está vivo e reaparece quando você o chama pelo nome
Checklist final
- Claude Code instalado (claude --version responde)
- CT clonado ao lado dos projetos
- Uma squad subida com /team-os-creator *install
- /team-os rodado e memória construída
- Agent View aberto com claude agents e ao menos uma sessão despachada
- Sei ler os ícones de estado e usar peek, attach e detach
- Centro de Treinamento — repositório com todas as squads prontas (https://github.com/joaoguirunas/team-os)
- Claude Code — o motor que roda os agentes e abre o Agent View (https://www.npmjs.com/package/@anthropic-ai/claude-code)
Próximo passo
Veja os outros recursos do catálogo
Dezenas de recursos entre squads, skills, apps e integrações — todos usados em produção pelo João.
Voltar ao catálogo