OpenSquad — como instalar e montar seu primeiro time de IA

Esse é o passo a passo completo do que eu mostrei no Reel. Em mais ou menos 15 minutos você tem seu primeiro squad de agentes rodando dentro do Claude Code, fazendo o trabalho que hoje você paga uma agência ou um freela pra fazer.

A ferramenta é open-source, gratuita, e foi criada pelo Renato Asse. Repositório oficial: github.com/renatoasse/opensquad

Pra quem isso serve

Se você é dono de empresa, gerente de marketing, criador de conteúdo, ou trabalha em agência e quer parar de fazer tarefa repetitiva (roteiro de Reels, carrossel, post de LinkedIn, e-mail, copy de LP), esse passo a passo é pra você.

Não precisa saber programar. Tudo é feito em linguagem natural dentro do Claude Code.

Antes de começar — pré-requisitos

1. Node.js 20 ou superior instalado no seu computador. Pra checar, abre o terminal e roda node -v. Se aparecer algo tipo v20.x.x ou maior, tá tranquilo. Se não tiver, baixa em nodejs.org e instala.

2. Claude Code instalado. Se ainda não tem, instala seguindo a documentação oficial em docs.claude.com/claude-code. É o terminal de IA da Anthropic e roda no seu computador.

3. Uma conta Claude com plano pago (Pro ou Max). O OpenSquad consome bastante token porque cada agente faz uma chamada separada — no plano gratuito você esbarra no limite rápido.

4. Uma pasta no computador onde o squad vai viver. Pode ser uma pasta nova só pra isso, tipo C:\Users\SeuNome\opensquad-marketing ou ~/opensquad-marketing no Mac.

Passo 1 — abrir o Claude Code no projeto

Abre o terminal, navega até a pasta que você criou e roda:

claude

Isso abre o Claude Code dentro daquela pasta. Tudo que o OpenSquad fizer vai ficar organizado ali dentro.

Passo 2 — instalar o OpenSquad

Dentro do Claude Code, digita:

/init opensquad

Ou, se preferir rodar pelo terminal direto (fora do Claude Code), na mesma pasta:

npx opensquad init

Esse comando baixa os arquivos do OpenSquad pra dentro da sua pasta, configura os agentes base e cria a estrutura de diretórios. Vai aparecer uma pasta _opensquad/ com tudo organizado e um arquivo CLAUDE.md com as instruções que o Claude Code vai seguir.

Depois disso, fecha o Claude Code e abre de novo na mesma pasta pra ele carregar as novas instruções.

Passo 3 — criar seu primeiro squad

Aqui que começa a brincadeira. Dentro do Claude Code, digita:

/opensquad create

Vai entrar em ação um agente chamado Arquiteto. Ele vai te fazer perguntas pra entender o que você precisa: que tipo de conteúdo você quer produzir, com que frequência, qual o tom da sua marca, quem é seu público, e por aí vai.

Responde com calma e com o máximo de detalhe possível. Quanto melhor o briefing, melhor o squad.

Exemplos de pedido que funcionam bem:

• "Quero um squad que produz 3 Reels por semana sobre marketing digital, no tom do meu Instagram, com roteiro, legenda e sugestão de B-roll."

• "Quero um squad pra LinkedIn que pega notícias do meu setor e gera um post comentando, no meu tom de voz, 5 vezes por semana."

• "Quero um squad que transforma transcrição de podcast em carrossel pro Instagram com 8 a 10 slides."

No final, o Arquiteto te mostra o desenho do squad: quais agentes terão, o que cada um faz, qual a ordem do pipeline e onde ficam os checkpoints. Você aprova ou pede ajuste.

Passo 4 — investigação de referências (opcional mas vale ouro)

Durante a criação, o Arquiteto pode te oferecer chamar o Sherlock — um investigador que analisa perfis de referência (Instagram, LinkedIn, YouTube, Twitter) que você passar e extrai os padrões reais de conteúdo: hook, estrutura, formato, ritmo.

Se você tem 3 ou 4 perfis que você admira no seu nicho, passa pro Sherlock. Ele vai destrinchar o que esses perfis fazem e essa análise entra como base pros agentes criarem conteúdo no mesmo padrão.

É o que faz a diferença entre conteúdo genérico e conteúdo que parece feito por alguém que entende do nicho.

Passo 5 — rodar o squad

Com o squad criado, é só rodar:

/opensquad run nome-do-seu-squad

O pipeline começa. Cada agente executa sua etapa em sequência:

1. Pesquisador busca o tema

2. Estrategista decide o ângulo

3. Copywriter escreve

4. Designer monta visual (se tiver)

5. Revisor checa antes de entregar

Em cada checkpoint, o pipeline pausa, te mostra o que foi gerado e espera sua aprovação. Você lê, ajusta, pede outra versão, ou libera pra próxima etapa.

Isso é o que faz funcionar de verdade — você não perde o controle do conteúdo, mas também não precisa fazer do zero.

Passo 6 — onde encontrar o que foi gerado

Tudo que o squad produz fica salvo em:

squads/nome-do-seu-squad/output/

Organizado por data e versão. Você pode pegar o conteúdo, colar onde precisa (Instagram, Notion, LinkedIn, ferramenta de agendamento) e publicar.

Dicas práticas que vão te poupar tempo

• Comece pequeno. Cria um squad com objetivo bem específico (ex: "só Reels"). Quando estiver azeitado, cria outro pra LinkedIn. Não tenta resolver tudo num squad só.

• Alimenta a memória do squad. Tem uma pasta _opensquad/_memory/company.md onde você descreve sua empresa, produto, público e tom. Todo squad lê isso antes de rodar. Quanto mais detalhe ali, melhor o resultado.

• Use feedback. Quando o agente entrega algo ruim, fala o que tá ruim e por quê. Ele aprende e salva isso na memória pra próxima vez.

• Não pula checkpoint. O ponto da ferramenta é justamente você ficar no controle. Se aprovar tudo sem ler, vai sair conteúdo ruim publicado no seu nome.

• Aprovação custa atenção, não tempo. Cada checkpoint leva 2-5 minutos pra revisar. É muito menos do que produzir do zero.

Squads que valem a pena montar primeiro

• IG Content — produção semanal de Reels, carrossel e story

• LinkedIn Daily — post diário comentando notícias do seu setor

• Email Newsletter — newsletter quinzenal a partir do conteúdo que você já publicou

• YouTube Shorts from Long-Form — corta seus vídeos longos em Shorts virais

• LP Copy — gera copy completa pra landing page de venda

Quando der ruim

• Claude Code travando ou consumindo muito token: abre outro chat, recomeça. Squad grande consome mesmo.

• Agente entregando conteúdo genérico: falta briefing. Volta no company.md e detalha mais.

• Pipeline não roda: confere se você abriu o Claude Code dentro da pasta certa, e se o npx opensquad init rodou completo.

• Quer entender o que cada agente faz: abre _opensquad/squads/seu-squad/agents/ e lê os arquivos. É tudo markdown, em português, dá pra editar.

Onde se aprofundar

• Repositório oficial: github.com/renatoasse/opensquad

• Documentação completa: dentro do próprio repo, pasta /docs

• Comunidade: o link tá no README do repositório