💻 Pre-requisitos: o que voce precisa ter
Antes de instalar qualquer coisa relacionada a swarms, voce precisa garantir que seu ambiente de desenvolvimento esta minimamente configurado. Nao precisa ser expert em terminal — basta ter as ferramentas basicas funcionando. Vamos verificar cada uma.
💡 O que voce precisa ter instalado
- •Terminal: Qualquer terminal funciona — Terminal nativo do macOS, Windows Terminal, iTerm2 ou o terminal integrado do VS Code
- •Node.js 18+: Necessario para algumas dependencias. Verifique com
node --version - •Git: Para versionamento do seu projeto. Verifique com
git --version - •Editor de codigo: VS Code recomendado, mas qualquer editor serve. O OpenCode roda no terminal
📊 Verificacao rapida
Abra seu terminal e execute estes comandos para verificar:
# Verificar Node.js
node --version
# Esperado: v18.x.x ou superior
# Verificar Git
git --version
# Esperado: git version 2.x.x
# Verificar que o terminal funciona
echo "Terminal OK!"Se algum comando falhar, instale a ferramenta antes de continuar. Node.js: nodejs.org | Git: git-scm.com
📦 Passo 1: instalar o OpenCode
O OpenCode e a plataforma base onde o swarm de agentes vai rodar. E um ambiente de desenvolvimento com IA integrada que suporta multiplos provedores e plugins — incluindo o oh-my-openagent que vamos instalar no proximo modulo. Sem o OpenCode, nada funciona.
💡 Instalacao do OpenCode
Acesse opencode.ai e siga as instrucoes para seu sistema operacional. Apos instalar:
# Verificar se OpenCode esta instalado
opencode --version
# Se o comando funcionar, voce vera algo como:
# opencode v1.x.x
# Se nao estiver, instalar conforme opencode.ai
# macOS/Linux: curl ou brew
# Windows: installer ou winget📊 Primeiro teste
Apos instalar, abra o OpenCode em qualquer pasta para confirmar que funciona:
# Criar uma pasta de teste
mkdir ~/meu-primeiro-swarm
cd ~/meu-primeiro-swarm
git init
# Abrir o OpenCode
opencode
# Voce deve ver a interface do OpenCode no terminal
# Com os modos Build e Plan disponiveis
# (Eles vao mudar apos instalar o oh-my-openagent)🔌 Passo 2: conectar seus provedores de IA
Provedores de IA sao os servicos que fornecem os modelos (Claude, GPT, Gemini). Sem pelo menos um provedor conectado, os agentes nao tem "cerebro" para pensar. O OpenCode suporta multiplos provedores simultaneamente, e voce pode usar combinacoes de pagos e gratuitos.
💡 Conectando provedores
Dentro do OpenCode, use o comando /connect para autenticar cada provedor:
# Dentro do OpenCode, digite:
/connect
# O OpenCode vai listar os provedores disponiveis:
# - Anthropic (Claude) ← recomendado
# - OpenAI (GPT)
# - Google (Gemini)
# - OpenCode Zen (gratuito)
# Siga as instrucoes para cada provedor
# Geralmente envolve colar uma API key ou fazer login OAuth📊 Verificar conexao
Apos conectar, verifique que os modelos aparecem:
# Dentro do OpenCode:
/models
# Deve listar os modelos disponiveis, por exemplo:
# anthropic/claude-opus-4-6
# anthropic/claude-sonnet-4-5
# openai/gpt-5.3-codex
# opencode/big-pickle (gratuito)
# opencode/gpt-5-nano (gratuito)Dica: mesmo sem assinaturas pagas, o OpenCode oferece modelos gratuitos (big-pickle, gpt-5-nano). Voce consegue seguir toda a trilha com eles.
📋 Passo 3: verificar modelos disponiveis
Saber exatamente quais modelos voce tem acesso e fundamental para o proximo passo (configurar qual modelo cada agente usa). Os nomes dos modelos seguem o padrao provedor/nome-do-modelo. Voce vai precisar desses nomes exatos no Modulo 4.3.
💡 Listando seus modelos
# No terminal (fora do OpenCode):
opencode models
# Ou dentro do OpenCode:
/models
# A saida vai mostrar algo como:
# ┌─────────────────────────────────┬───────────┬─────────┐
# │ Modelo │ Provedor │ Status │
# ├─────────────────────────────────┼───────────┼─────────┤
# │ anthropic/claude-opus-4-6 │ Anthropic │ ✓ Ativo │
# │ anthropic/claude-sonnet-4-5 │ Anthropic │ ✓ Ativo │
# │ openai/gpt-5.3-codex │ OpenAI │ ✓ Ativo │
# │ opencode/big-pickle │ OpenCode │ ✓ Free │
# │ opencode/gpt-5-nano │ OpenCode │ ✓ Free │
# └─────────────────────────────────┴───────────┴─────────┘📊 Anote seus modelos
Copie os nomes exatos dos modelos que voce tem. Voce vai precisar no Modulo 4.3. Exemplo de anotacao:
- Modelo potente (orquestrador): anthropic/claude-opus-4-6
- Modelo bom (executor): openai/gpt-5.3-codex ou anthropic/claude-sonnet-4-5
- Modelo gratuito (suporte): opencode/big-pickle ou opencode/gpt-5-nano
🔧 Passo 4: instalar o Bun
O Bun e um runtime JavaScript ultra-rapido que o oh-my-openagent utiliza para funcionar. Sem o Bun instalado, o comando bunx nao vai existir e voce nao conseguira instalar o plugin. Este e o erro mais comum de quem esta comecando — nao pule este passo.
💡 Instalando o Bun
# Instalar o Bun (macOS / Linux)
curl -fsSL https://bun.sh/install | bash
# IMPORTANTE: Fechar e reabrir o terminal apos instalar!
# Ou executar:
source ~/.bashrc # Linux
source ~/.zshrc # macOS
# Verificar a instalacao
bun --version
# Esperado: 1.x.x📊 Verificacao final do Bun
# Testar que o bunx funciona (sera usado no proximo modulo)
bunx --version
# Se funcionar, voce esta pronto para instalar o oh-my-openagent
# Se der "command not found", feche e reabra o terminalWindows: visite bun.sh para instrucoes especificas. O Bun suporta Windows via WSL ou nativamente.
✅ Checkpoint: tudo pronto?
Antes de seguir para o proximo modulo, execute esta verificacao final. Cada item deve estar marcado. Se algum falhar, volte ao passo correspondente e resolva antes de continuar — seguir em frente com ambiente incompleto so vai gerar frustracoes desnecessarias.
💡 Checklist de verificacao
# Execute cada comando e confirme que funciona:
# 1. OpenCode instalado e abrindo
opencode --version # ✅ Deve mostrar versao
# 2. Pelo menos 1 provedor conectado
opencode models # ✅ Deve listar modelos
# 3. Bun instalado
bun --version # ✅ Deve mostrar versao
# 4. Pasta do projeto criada
ls ~/meu-primeiro-swarm # ✅ Pasta existe📊 Resultado esperado
- ✅OpenCode instalado e abrindo corretamente
- ✅Pelo menos 1 provedor conectado (/models mostra modelos)
- ✅Bun instalado (bun --version funciona)
- ✅Pasta do projeto criada e com git init
Tudo marcado? Siga para o Modulo 4.2 e instale o oh-my-openagent!
📚 Resumo do Modulo
Proximo Modulo:
4.2 - Instalando o oh-my-openagent