Como Montar um Time de Agentes IA na Sua VPS
Guia completo: Claude Swarm + tmux + OpenRouter rodando 24/7 no seu servidor
Preparei isso pra você, @jdstrikerbr!
Espero que esse conteúdo te ajude, jdstrikerbr! Se tiver dúvidas, me chama no X.
Ver tweet originalOuç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
Ecossistema Caio Vicentino
Quer ir mais fundo?
← Deslize para ver mais →
Ecossistema
Quer ir mais fundo?
Conheça os produtos do Caio Vicentino



