Configurar OpenCode com Ollama: provider passo a passo

Comece a configuração do OpenCode com Ollama por uma rota

Configurar OpenCode com Ollama envolve três decisões: como o OpenCode encontra o Ollama, qual base URL usa e qual tag de modelo solicita. Altere um valor por vez para não transformar erro de provider em dúvida sobre o modelo.

Se o launcher criar a entrada do provider, revise o config gerado antes de adicionar outro. Se usar config manual, teste primeiro um modelo local e um repositório sem arquivos sensíveis.

Requisitos do provider e do modelo OpenCode Ollama

Antes de editar opencode.json, confirme que o Ollama está ativo, que o modelo aparece em ollama list e que o OpenCode alcança o mesmo endpoint. Um provider correto não resolve modelo ausente nem namespace de rede errado.

Para o primeiro teste, escolha um modelo que deixe memória para editor, contexto do repositório e sistema. O maior tag não garante o melhor fluxo.

O que o launcher configura

O menu interativo mostra integrações e modelos sugeridos. Ao escolher OpenCode, a conexão com o modelo Ollama é preparada.

Modelos locais consomem RAM ou VRAM; cloud reduz a carga local, mas exige internet e muda a privacidade.

Config manual: provider, base URL e modelo

A configuração manual é útil quando o launcher não cria o provider necessário ou quando o arquivo precisa ser revisado. Deixe provider, base URL e tag explícitos e teste a menor requisição antes de adicionar ferramentas ou contexto.

Trate a tag como um valor confirmado por ollama list. Se estiver errada, mudar contexto ou permissões não corrigirá a requisição.

{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
    "ollama": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "Ollama (local)",
      "options": { "baseURL": "http://localhost:11434/v1" },
      "models": { "your-model": { "name": "your-model" } }
    }
  }
}

Ajuste o contexto depois de conectar OpenCode e Ollama

Uma janela de contexto grande é uma otimização diferente da conexão do provider. Prove primeiro que o modelo responde; aumente o contexto só quando memória e tempo de resposta permitirem.

Como primeiro exemplo, peça para o OpenCode ler um arquivo pequeno, explicar a alteração e mostrar um patch antes de permitir escrita. Isso deixa visíveis provider, modelo e permissões do repositório.

FROM your-model
PARAMETER num_ctx 65536

Escolher um modelo Ollama para OpenCode

A escolha depende de RAM, contexto, capacidade de código e latência. Compare a classe do modelo com sua máquina; mais parâmetros não significam automaticamente um fluxo melhor.

Corrigir erros de provider e config no OpenCode Ollama

Se o OpenCode não chamar o Ollama, verifique provider, base URL, tag, processo do Ollama e rede do runtime nessa ordem. Um endpoint nativo que funciona no terminal pode ser diferente no container ou processo remoto.

Se conectar mas a resposta vier vazia ou inválida, confirme a tag exata e reduza a requisição antes de mudar a janela de contexto.

Primeira tarefa segura após configurar OpenCode com Ollama

Depois que a configuração passar, comece com uma tarefa de leitura. Peça explicação, patch proposto e plano de teste; revise o diff antes de permitir escrita ou shell.

Para decisões mais amplas, use os guias existentes de agente de código local e memória. Esta página deve continuar focada na configuração OpenCode mais Ollama.