OpenCode com Ollama: guia passo a passo para código local

Início rápido com ollama launch opencode

Confirme as instalações e o resultado de ollama list. Entre no repositório pelo terminal e execute ollama launch opencode.

O launcher pode baixar o modelo, preparar a integração, definir contexto de 64K e iniciar o OpenCode.

Função de cada camada

OpenCode é o agente e a interface; Ollama serve o modelo. As permissões do repositório continuam sendo uma barreira separada.

Comece em um repositório pequeno, com Git limpo e backup. Libere leitura antes de permitir edição ou shell amplo.

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.

Configuração manual no opencode.json

Use configuração manual quando o modelo não aparece, o endpoint é diferente ou o provider precisa ficar revisado no projeto.

Troque your-model pela tag exata mostrada por ollama list.

{
  "$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" } }
    }
  }
}

Contexto de 64K para código

Contexto pequeno prejudica tools e pode causar falta de memória. Para agentes de código, recomenda-se pelo menos 64K.

O launcher ajusta isso. No modo manual, crie uma variante com Modelfile; com pouca memória reduza modelo e escopo.

FROM your-model
PARAMETER num_ctx 65536

Escolha do modelo por hardware

Escolha o modelo que continua responsivo com editor, índice, testes e cache. Comece menor e aumente só quando a qualidade compensar.

Cloud atende tarefas maiores, mas adiciona rede, conta e processamento remoto.

Solução de problemas em ordem

Se modelos não aparecem, confira serviço, ollama list, http://localhost:11434/v1 e a tag.

Se a análise trava, reduza arquivos ou modelo. Para falhas de comando, revise permissões e diretório.

Primeira tarefa segura

Peça primeiro explicação e plano. Autorize um patch limitado, rode um teste e confira git diff.

Não exponha Ollama sem proteção e não envie secrets nos prompts.