Como montar seu primeiro time de agentes
Ao final deste tutorial você vai ter, na sua máquina, uma squad de agentes de IA especializados trabalhando dentro de um projeto seu. Não um agente genéric
O que é
Como montar seu primeiro time de agentes
Ao final deste tutorial você vai ter, na sua máquina, uma squad de agentes de IA especializados trabalhando dentro de um projeto seu. Não um agente genérico tentando fazer tudo, mas um time de especialistas com memória compartilhada e você no comando. Você instala a ferramenta, clona o Centro de Treinamento, entende como os 49 agentes são organizados em 5 squads e liga uma delas dentro de um projeto real.
A promessa do agente autônomo que faz tudo sozinho não se sustenta na prática. Um agente único alucina quando não sabe, perde contexto no meio do caminho e não presta contas do que fez. A saída não é um agente mais esperto — é um time. Vários especialistas, cada um com papel claro, uma memória que todos leem e escrevem, e um humano que decide o que entra e revisa o que sai. O resultado é eficiência operacional com controle: a entrega cresce sem você perder a visão do que está acontecendo.
O tutorial gira em torno de quatro conceitos centrais. O Claude Code é a ferramenta de linha de comando que roda os agentes na sua máquina. O Centro de Treinamento (CT) é a pasta-mãe que fica ao lado dos seus projetos e de onde os agentes saem. As squads agrupam os 49 especialistas por área: Dev, Sites, Social, Traffic e PM. E a divisão entre duas camadas — você administra no CT e produz no projeto — é a regra que mantém tudo organizado.
Nenhum passo exige que você seja programador. Você vai copiar e colar comandos e ler o que aparece na tela. Antes de começar, certifique-se de ter o Node.js (versão LTS), o Git e uma conta no Claude instalados e funcionando na sua máquina.
Como funciona
Principais recursos
Time em vez de agente único
Substitua o agente genérico por especialistas com papéis claros. Cada tarefa vai para quem entende do assunto, com resultado validado antes de sair.
Centro de Treinamento
Um repositório com 49 agentes, skills e hooks de qualidade prontos para você clonar e usar como base de toda a operação.
Memória compartilhada
Na primeira execução o time faz um Discovery: lê o projeto e monta o contexto compartilhado para que todos os agentes comecem alinhados.
Instalação em 5 passos
De zero ao time ligado em menos de 25 minutos: instalar, clonar, explorar, instalar a squad e ligar o time com um único comando.
Humano no comando
Você descreve o objetivo em linguagem natural e o time divide o trabalho entre os agentes — mas a decisão final e a revisão são sempre suas.
Nível: iniciante · Tempo estimado: 25 min
Pré-requisitos
- •Um computador com acesso ao terminal (no Mac é o app Terminal; no Windows, o PowerShell).
- •O Node.js instalado na versão LTS. Baixe em nodejs.org. Teste com node -v — se aparecer um número de versão, está pronto.
- •O Git instalado. Baixe em git-scm.com e teste com git -v.
- •Uma conta no Claude para autenticar a ferramenta na primeira vez que abrir.
Conceitos-chave
Claude Code
A ferramenta de linha de comando que roda os agentes na sua máquina. É o pacote @anthropic-ai/claude-code, instalado globalmente via npm.
Centro de Treinamento (CT)
O centro que comanda tudo. É a pasta de onde os agentes saem e para onde você volta quando precisa ajustar alguma coisa. Ele fica AO LADO dos seus projetos, nunca dentro deles. Vem do repositório github.com/joaoguirunas/team-os.
Squad
Um grupo de agentes de uma mesma área. Os 49 especialistas são organizados em 5 squads: Dev, Sites, Social, Traffic e PM.
Duas camadas
No CT você ADMINISTRA — abre o claude puro para configurar. No projeto você PRODUZ — abre o claude e roda /team-os para trabalhar. CT é a oficina; projeto é o canteiro de obras.
Passo a passo
Instalação e configuração
Passo 1 — Instalar o Claude Code
Abra o terminal e cole o comando abaixo. O Claude Code é o motor: sem ele instalado de forma global na máquina, nenhum dos comandos seguintes existe. O -g significa "global", ou seja, disponível de qualquer pasta. Várias linhas de instalação vão passar na tela e, no fim, o terminal volta a aceitar comandos. Digite claude --version para confirmar que instalou.
npm install -g @anthropic-ai/claude-code
Passo 2 — Clonar o Centro de Treinamento
No terminal, entre na sua pasta de projetos — a mesma onde ficam os trabalhos que você já toca — e rode o clone. O CT mora no repositório github.com/joaoguirunas/team-os. Cloná-lo traz para a sua máquina toda a estrutura pronta: os 49 agentes, as skills e as travas de qualidade. Ele precisa ficar ao lado dos projetos, nunca dentro de um deles. Em poucos segundos surge uma pasta nova (team-os) ao lado dos seus projetos.
git clone https://github.com/joaoguirunas/team-os.git
Passo 3 — Entender as squads
Entre na pasta do CT e olhe dentro de .claude. Conhecer a estrutura evita que você mexa no lugar errado depois. Dentro de .claude há três coisas: agents (as definições dos 49 especialistas em 5 squads), skills (as 49 habilidades que se ativam com a barra, tipo /deep-research) e hooks (as travas de qualidade). Há também docs/smart-memory: a memória compartilhada do time. Você deve ver as pastas agents, skills e hooks listadas. Se não achar a .claude, ela é oculta — use ls -a.
cd team-os ls .claude
Passo 4 — Instalar uma squad num projeto
Ainda dentro do CT, abra o Claude Code (claude) e rode o comando de instalação. Os agentes não trabalham dentro do CT — ele é só a oficina. Você leva uma squad para dentro de um projeto real com este comando. A ferramenta pergunta o projeto de destino e quais squads levar, mostra um preview do que vai fazer e só age depois que você confirma. Para começar, escolha UMA squad só. Ao final, os agentes escolhidos, a skill /team-os e o settings.json são copiados para o projeto.
/team-os-creator *install
Passo 5 — Ligar o time
Saia do CT, entre na pasta do projeto que você acabou de equipar, abra o claude e rode /team-os. A estrutura chegou, mas nada está ligado ainda. O /team-os é o que acende o time. Na primeira vez ele faz o Discovery: lê o código do projeto e monta a memória compartilhada do zero, para que cada agente comece já sabendo o contexto. Você vai ver um scan do ambiente, a proposta de construir a memória, a leitura do código e, no fim, um painel perguntando qual é o objetivo da sessão.
/team-os
Primeiro objetivo de sessão — dividir tarefa entre agentes
/team-os Objetivo desta sessão: publicar 3 posts para o Instagram sobre o lançamento de terça. Divida a tarefa entre os agentes da squad — um pesquisa o tema, um escreve as legendas, um revisa e um adapta o formato. Me mostre o plano com qual agente cuida de cada etapa antes de começar a produzir.
Instalar nova squad ou equipar outro projeto
/team-os-creator *install
Erros comuns
- •"Instalei tudo mas o /team-os não aparece no menu": você provavelmente está no CT, não no projeto, ou não rodou o *install naquele projeto. A skill só existe onde foi instalada.
- •CT dentro de um projeto: apague a pasta e clone de novo no lugar certo (ao lado dos projetos, nunca dentro de um deles).
- •Um agente tenta fazer tudo: esse é o vício do "agente único". A regra do sistema é uma tarefa, um agente — deixe o time dividir o trabalho.
- •"permission denied" ou "EACCES" ao instalar: costuma ser permissão de pasta do sistema. Garanta que o Node foi instalado com um gerenciador de versões — evite sair mandando sudo em tudo, porque isso cria mais problemas do que resolve.
- •Não achar a pasta .claude: ela começa com ponto e fica oculta. Use ls -a para ver arquivos ocultos.
- •Memória compartilhada não criada: ela não vem com o *install — é construída quando você roda /team-os pela primeira vez no projeto. Não pule esse passo.
- Claude Code instalado (claude --version responde)
- CT clonado AO LADO dos projetos
- Entendi as 3 pastas dentro de .claude e as 5 squads
- Uma squad instalada num projeto via /team-os-creator *install
- /team-os rodado e memória compartilhada construída
- Entendi o princípio: uma tarefa, um agente; o humano decide e revisa
- •Centro de Treinamento (team-os) — https://github.com/joaoguirunas/team-os
- •Claude Code (pacote npm) — https://www.npmjs.com/package/@anthropic-ai/claude-code
- •Node.js — https://nodejs.org
- •Git — https://git-scm.com
Vá além do tutorial
Quer dominar isso na prática?
Aprofunde com acompanhamento direto na mentoria ou siga o passo a passo completo, do zero ao avançado, no curso online.