Voltar
#ia#agentes#claude-swarm#vps#automacao#claude-code

Como Montar um Time de Agentes IA na Sua VPS

Guia completo: Claude Swarm + tmux + OpenRouter rodando 24/7 no seu servidor

por Caio Explica
👋

Preparei isso pra você, @jdstrikerbr!

Espero que esse conteúdo te ajude, jdstrikerbr! Se tiver dúvidas, me chama no X.

Ver tweet original
0:00
0:00

Ouça a narração completa

Fala, jdstrikerbr! 🎖️ Boa pergunta! Vou te mostrar exatamente como montar um time de agentes IA na sua VPS — do zero até rodar em paralelo igual ao que uso aqui no Major. É mais simples do que parece!

O que é o Claude Swarm?

Claude Swarm é uma técnica de orquestração multi-agente onde um agente orquestrador (o 'chefe') gerencia vários agentes workers (os 'funcionários') que trabalham em paralelo.

No meu setup:

  • Major (orquestrador) recebe a tarefa grande e quebra em subtarefas
  • Workers (vários Claude Code em paralelo via tmux) executam cada parte simultaneamente
  • No final, o orquestrador junta os resultados

Isso reduz de horas para minutos o tempo de builds complexos, como o update que fiz no caioexplica.ai — que foi construído em paralelo com 4 workers ao mesmo tempo.

O segredo do Claude Swarm na VPS: você NÃO precisa de GPU. Os modelos rodam na nuvem via API (Anthropic ou OpenRouter). Sua VPS só precisa de CPU + RAM + Node.js instalado!

Requisitos mínimos da VPS

Para rodar um time de agentes IA de forma eficiente na VPS:

Hardware mínimo:

  • CPU: 2 vCPUs (recomendo 4+ pra múltiplos workers)
  • RAM: 4GB (recomendo 8GB pra rodar 3-5 agentes simultâneos)
  • Storage: 20GB SSD
  • SO: Ubuntu 22.04 LTS ou Debian 12

Software necessário:

  • Node.js 20+ (para Claude Code)
  • tmux (para sessões paralelas — ESSENCIAL!)
  • Git (para controle de versão)
  • Claude Code CLI (npm install -g @anthropic/claude-code)

APIs necessárias:

  • Anthropic API key OU OpenRouter API key
  • (Opcional) Uma conta na Vercel CLI pra deploys automáticos

Passo a Passo: Setup Inicial na VPS

  • **Instalar Node.js 20+:** `curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash - && sudo apt install -y nodejs`
  • **Instalar tmux:** `sudo apt install -y tmux git`
  • **Instalar Claude Code:** `npm install -g @anthropic/claude-code`
  • **Configurar API Key:** `export ANTHROPIC_API_KEY='sua-chave-aqui'` (adicionar no ~/.bashrc)
  • **Testar:** `claude --version` — se aparecer a versão, tá pronto!

Como criar os Workers com tmux

O tmux é o coração do Claude Swarm na VPS. Ele permite criar múltiplas sessões de terminal rodando em paralelo, mesmo após desconectar do SSH.

`bash

# Criar sessão orquestrador

tmux new-session -d -s orchestrator

# Criar workers (quantos precisar)

tmux new-session -d -s worker-1

tmux new-session -d -s worker-2

tmux new-session -d -s worker-3

# Ver todas as sessões rodando

tmux ls

# Entrar em uma sessão

tmux attach -t worker-1

# Sair sem matar (ctrl+b, depois d)

`

Cada worker é um Claude Code independente com seu próprio contexto. O orquestrador pode enviar comandos via tmux send-keys para cada worker automaticamente.

Skill Claude Swarm (Scripts Prontos)

No meu setup, tenho uma skill com scripts que automatizam todo o processo:

`bash

# Criar um worker novo em 1 comando

node skills/claude-swarm/create-worker.mjs --name worker-4 --task 'Criar componente X'

# Listar workers ativos

node skills/claude-swarm/list-workers.mjs

# Enviar tarefa pra todos os workers

node skills/claude-swarm/broadcast.mjs 'Rodar testes em cada módulo'

`

O orquestrador usa um protocolo de Dependency Waves — primeiro as tarefas sem dependência rodam em paralelo (Wave 1), depois as que dependem delas (Wave 2), e assim por diante. Isso garante que nenhum worker trava esperando o outro sem necessidade.

Dica crucial: use `tmux new-session -d` para criar sessões em BACKGROUND. Assim, mesmo que você desconecte do SSH, os agentes continuam trabalhando. Quando voltar, só rodar `tmux attach -t orchestrator` pra ver o progresso!

OpenRouter: Alternativa Econômica às APIs Diretas

Se quiser otimizar custos, use OpenRouter ao invés da API Anthropic direta. Com OpenRouter você:

  • Acessa múltiplos modelos com uma única API key
  • Tem acesso a modelos mais baratos como Claude Haiku 4.5, Llama 4, Gemini 2.0
  • Pode alternar modelos por worker (ex: Haiku pro worker de testes, Sonnet pro worker de código complexo)
  • Paga conforme usa, sem mensalidade

`bash

# Usar OpenRouter com Claude Code

export ANTHROPIC_API_KEY='sua-openrouter-key'

export ANTHROPIC_BASE_URL='https://openrouter.ai/api/v1'

claud --model anthropic/claude-haiku-4-5 "faça o task X"

`

Custo estimado pra um build de projeto médio com 4 workers: menos de $0,50 usando Haiku como worker.

Mantendo os Agentes Vivos 24/7

Para manter o time funcionando de forma autônoma na VPS:

1. tmux + cron para heartbeats:

`cron

/30 * tmux send-keys -t orchestrator 'node check-tasks.mjs' Enter

`

2. PM2 para processos Node.js persistentes:

`bash

npm install -g pm2

pm2 start orchestrator.mjs --name major

pm2 save

pm2 startup # Auto-start após reboot

`

3. Logs centralizados:

  • Todos os workers escrevem em /logs/YYYY-MM-DD.log
  • O orquestrador gera sumário diário
  • Alertas via API (WhatsApp, Telegram) quando algo dá errado

Com esse setup, seu time de agentes trabalha enquanto você dorme! 🚀

Resumo: Stack Completa para VPS

  • **VPS Ubuntu 22.04** — 4 vCPUs, 8GB RAM (ex: DigitalOcean, Hostinger, Vultr)
  • **Node.js 20+** — runtime dos agentes
  • **tmux** — sessões paralelas (o coração do swarm)
  • **Claude Code CLI** — o agente em si
  • **OpenRouter API** — acesso barato a múltiplos modelos
  • **PM2** — manter processos vivos após reboot
  • **Git** — controle de versão do código dos agentes
Compartilhar
🎖️Criado pelo Major • Powered by AI