OpenCode + Oh-My-OpenCode-Slim: Como configurar orquestração de multiagentes do zero

Existe um mundo de ferramentas de IA para desenvolvimento, onde tudo evolui de forma rápida. Nesse tempo, já testei de tudo: IDEs agênticas como Cursor e Windsurf, assistentes de código como o Blackbox e agentes autônomos, como o Claude Code e Codex. Todas elas, em algum momento, se integraram bem ao meu workflow, mas sempre batiam na mesma tecla: o custo.

No início, o valor entregue justificava. O problema aparecia quando eu passava a depender mais dessas ferramentas. Mesmo com um ambiente personalizado e bem configurado, eu acabava atingindo os limites de uso bem rápido. Além disso, em alguns casos houve grandes mudanças nos modelos de cobrança. Como o Windsurf, que adotou cotas diárias e semanais que me travavam no meio do meu dia, forçando a compra de mais créditos ou upgrades de planos.

Foi então que me deparei com o OpenCode. Ele passou a fazer muito mais sentido para o meu fluxo de trabalho atual. Nas últimas semanas, adotei o OpenCode como meu ambiente principal, utilizando o plugin Oh-My-OpenCode-Slim para orquestração de multiagentes.

Neste artigo, quero apresentar como você pode configurar esse setup e fazer a sua instalação inicial.

Por que o OpenCode?

Um dos maiores ganhos ao migrar para o OpenCode é a liberdade. Como a ferramenta é gratuita e open-source, você deixa de pagar assinaturas mensais e passa a pagar apenas no consumo das APIs. Isso abre grandes possibilidades, permitindo que você experimente diversos modelos sem ficar preso a uma ferramenta fechada.

O próprio OpenCode conta com alguns planos: o Go, focado em baixo custo, e o Zen, uma opção mais completa. Além disso, a flexibilidade é total: você pode conectar diferentes provedores de IA pagando pouco por créditos, como no Claude e Kimi (a partir de 5 dólares), Deepseek (com depósitos mínimos de 2 dólares), além de serviços como o OpenRouter com centenas de modelos.

Outro diferencial é a comunidade. Ela cria soluções que otimizam o uso de diferentes modelos, como é o caso do plugin Oh-My-OpenCode-Slim, que vamos configurar neste tutorial para orquestrar multiagentes. Se você já tem experiência com ferramentas como o Claude Code, a migração para o OpenCode será muito simples e direta.

Guia de Instalação

O OpenCode está disponível para Linux, macOS e Windows em três formas: Interface Gráfica (Desktop), Terminal (TUI) e Extensão de IDE. As opções de download estão na página oficial.

Mesmo utilizando a versão Desktop, instale também a versão via terminal se deseja utilizar os plugins da comunidade, pois alguns necessitam de configurações que só estão disponíveis nessa versão.

E a recomendação para melhor experiência no Windows é executar o OpenCode dentro do ambiente WSL para garantir o melhor desempenho, conforme está na documentação oficial.

1. Versão Terminal (TUI)

A instalação no terminal pode ser feita diretamente via script bash ou gerenciadores de pacote Node.js:

Via Script Bash:

curl -fsSL https://opencode.ai/install | bash

Via Node.js (escolha o seu gerenciador):

# npm
npm install -g opencode-ai

# bun
bun install -g opencode-ai

# pnpm
pnpm install -g opencode-ai

# yarn
yarn global add opencode-ai

2. Versão Desktop

A versão com interface gráfica pode ser baixada diretamente no site oficial, com pacotes nativos para Linux (.deb e .rpm), macOS e Windows.

Setup Inicial e Configuração

Vou focar no uso pelo terminal, o processo de configuração inicial exige apenas dois passos: conectar seus provedores e inicializar o projeto.

Conectando Chaves de API

Para adicionar um provedor de IA, execute o comando interno:

/connect

O terminal exibirá uma lista interativa com os provedores suportados. Ao selecionar uma opção, você poderá definir a chave de API, o modelo padrão e suas variantes.

Você consegue ver todos os providers que você inseriu com suas credenciais no arquivo de auth dentro da pasta do OpenCode que fica no caminho: /home/<seu-usuario>/.local/share/opencode/auth.json.

Existe uma lista grande de providers que tem como você configurar diretamente pelo terminal, mas caso queira utilizar um modelo ou servidor local que não esteja na lista padrão, utilize a opção Custom Provider.

Inicializando um Projeto

Ao utilizar o OpenCode em um projeto, é recomendado pedir para ele fazer uma varredura inicial, analisando a estrutura do repositório para criar o contexto base. Assim, toda vez que você iniciar uma nova sessão, o modelo já conhecerá a arquitetura da sua aplicação.

É recomendado iniciar a construção do seu harness usando o comando nativo que executa um script do próprio OpenCode:

/init

Por trás desse comando, vai ser rodado um prompt que orienta o agente a extrair apenas informações de valor: comandos exatos, ordem de execução de testes e detalhes arquiteturais. O script instrui o modelo a focar em arquivos executáveis e de configuração, ignorar regras genéricas e fazer o mínimo de perguntas possível. Assim garantindo que o arquivo final guarde apenas o contexto que a IA realmente deixaria passar batido.

Ao final esse comando gera o arquivo AGENTS.md na raiz do projeto. Sempre que novas funcionalidades são implementadas, a IA atualiza esse arquivo automaticamente.

Recomendado: Versionar e comitar o arquivo AGENTS.md no seu git para manter o contexto compartilhado entre a equipe e nas execuções futuras.

Como Funcionam os Agentes

O OpenCode vem configurado por padrão com dois agentes nativos. Você pode alternar entre eles usando a tecla Tab ou o comando /agents.

1. Agente Plan

Voltado para análise, arquitetura e planejamento. Ele não altera arquivos no projeto. O objetivo do Plan é fazer perguntas, entender os requisitos e estruturar a estratégia antes de qualquer linha de código ser escrita. É o agente recomendado para tarefas complexas e refatorações.

2. Agente Build

É o agente executor. Ele altera o código, cria arquivos e aplica as modificações necessárias, pode ser usado com uma instrução direta ou seguindo o plano gerado previamente pelo agente Plan.

Agentes Personalizados

Além dos agentes nativos, você pode criar agentes específicos para regras de negócio ou tarefas repetitivas. As definições ficam salvas dentro do diretório /.opencode no projeto.

Para invocar um agente customizado durante a sessão de uso, utilize o caractere @ seguido do nome do agente:

Além desses agentes personalizados, você também pode estender a capacidade do ambiente instalando orquestradores desenvolvidos pela comunidade, como o Oh-My-OpenCode-Slim, que adiciona suporte a fluxos multiagentes avançados.

Setup do Oh-My-OpenCode-Slim

O Oh-My-OpenCode-Slim é um plugin de orquestração multiagente que adiciona seis agentes especializados ao OpenCode. Cada um atua em um cenário específico do desenvolvimento:

• Orchestrator: coordena os demais agentes para concluir as tarefas.
• Explorer: analisa a codebase para mapear o que precisa ser feito.
• Oracle: busca por bugs complexos e fornece orientações de arquitetura.
• Librarian: realiza pesquisa em documentações online.
• Designer: cuida da interface e experiência do usuário (UI/UX).
• Fixer: executa tarefas de codificação em paralelo.

Além dos agentes, o plugin inclui Skills: instruções em prompt adicionadas ao contexto de cada agente que funcionam como roteiros de ação para tarefas específicas.

No repositório oficial do Github você encontra mais sobre cada agente e skill, além de uma lista de modelos recomendados para cada agente (que vou mostrar como configurar mais na frente).

Instalação do Plugin

Antes de realizar a instalação do Oh-My-OpenCode-Slim, há um detalhe importante: mesmo que você utilize a versão desktop, é obrigatório ter a versão por terminal instalado na sua máquina. O instalador do plugin faz essa verificação no sistema para validar o ambiente.

O comando para a instalação é esse:

bunx oh-my-opencode-slim@latest install

Após finalizar a instalação, acesse a pasta raiz do seu OpenCode no caminho ~/.config/opencode/oh-my-opencode-slim.json para encontrar o arquivo de configuração do plugin. Por padrão, ele já vem pré-configurado para uso com o opencode-go e a openai.

O ideal é mapear cada agente para um modelo que você já tenha configurado via API no seu OpenCode. Caso tenha dúvidas sobre qual modelo escolher para cada agente, o repositório do plugin disponibiliza uma lista de modelos testados e recomendados pelos mantenedores.

Para alterar o modelo de um agente, basta ajustar o campo "model" no bloco correspondente. Abaixo está um exemplo de configuração utilizando modelos via OpenRouter:

{
  "$schema": "https://unpkg.com/oh-my-opencode-slim@latest/oh-my-opencode-slim.schema.json",
  "preset": "openrouter",
  "presets": {
    "openrouter": {
      "orchestrator": {
        "model": "openrouter/qwen/qwen3.7-plus",
        "variant": "default",
        "skills": [
          "*"
        ],
        "mcps": [
          "*",
          "!context7"
        ]
      },
      "oracle": {
        "model": "openrouter/z-ai/glm-5.2",
        "variant": "default",
        "skills": [
          "simplify"
        ],
        "mcps": []
      },
      "explorer": {
        "model": "openrouter/deepseek/deepseek-v4-flash",
        "variant": "low",
        "skills": [],
        "mcps": []
      },
      "librarian": {
        "model": "openrouter/deepseek/deepseek-v4-flash",
        "variant": "low",
        "skills": [],
        "mcps": [
          "websearch",
          "context7",
          "gh_grep"
        ]
      },
      "designer": {
        "model": "openrouter/minimax/minimax-m3",
        "variant": "medium",
        "skills": [],
        "mcps": []
      },
      "fixer": {
        "model": "openrouter/moonshotai/kimi-k2.7-code",
        "variant": "high",
        "skills": [],
        "mcps": []
      }
    }
  }
}

Conclusão

Com o OpenCode devidamente configurado e o Oh-My-OpenCode-Slim orquestrando os agentes, você passa a ter um fluxo de trabalho eficiente e sob o seu controle.

O melhor fator que eu vejo nesse fluxo é a previsibilidade de custos aliada à autonomia. Você escolhe qual modelo usar para cada etapa do desenvolvimento, reservando os mais robustos para planejamento ou arquitetura e os mais leves para varreduras rápidas.

Vale a pena testar esse ambiente no seu dia a dia e ajustar as configurações até encontrar a combinação que realmente faz sentido para a sua rotina e para o tipo de projeto que você desenvolve.