Configurar OpenCode con Ollama: provider paso a paso

Empieza la configuración de OpenCode con Ollama por una ruta

La búsqueda configuración OpenCode con Ollama suele ocultar tres decisiones: cómo OpenCode descubre Ollama, qué base URL usa y qué etiqueta de modelo solicita. Cambia un valor cada vez para que un error de provider no se convierta en un misterio del modelo.

Si el launcher crea la entrada del provider, revisa la configuración generada antes de añadir otro. Si configuras a mano, prueba primero un solo modelo local y un repositorio sin archivos sensibles.

Requisitos del provider y modelo de OpenCode con Ollama

Antes de editar opencode.json, confirma que Ollama está activo, que el modelo aparece en ollama list y que OpenCode alcanza el mismo endpoint. Un nombre de provider válido no corrige un modelo ausente o un namespace de red incorrecto.

Para una prueba local, elige un modelo que deje memoria para el editor, el contexto del repositorio y el sistema. El mejor modelo es el que termina una tarea real de forma estable, no el tag más grande.

Qué configura el launcher

El menú interactivo muestra integraciones y modelos sugeridos. Al elegir OpenCode, la herramienta prepara la conexión con un modelo servido por Ollama.

Un inicio correcto no significa que cualquier modelo sea adecuado. Los modelos locales consumen RAM o VRAM; los modelos cloud reducen esa carga pero necesitan internet y cambian el tratamiento de los datos.

Configuración manual: provider, base URL y modelo

La configuración manual sirve cuando el launcher no crea el provider necesario o quieres revisar el archivo. Deja explícitos provider, base URL y etiqueta del modelo, y prueba la petición más pequeña antes de añadir herramientas o más contexto.

Trata la etiqueta como un valor verificado en ollama list. Si es incorrecta, cambiar el contexto o los permisos no solucionará la petición.

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

Ajusta el contexto después de conectar OpenCode con Ollama

Una ventana de contexto grande es una optimización distinta de la conexión del provider. Primero demuestra que el modelo responde; después aumenta el contexto solo si la memoria y el tiempo de respuesta lo permiten.

Como ejemplo, pide a OpenCode que lea un archivo pequeño, explique el cambio y muestre un parche antes de permitir escrituras. Así observas provider, modelo y permisos del repositorio.

FROM your-model
PARAMETER num_ctx 65536

Elegir un modelo Ollama para OpenCode

La elección depende de RAM, contexto, capacidad de código y latencia. Compara la clase del modelo con tu máquina; más parámetros no garantizan un mejor flujo de OpenCode.

Solucionar errores de provider y configuración OpenCode Ollama

Si OpenCode no llama a Ollama, revisa provider, base URL, etiqueta, proceso de Ollama y red del runtime en ese orden. Si funciona en una terminal nativa pero falla desde un contenedor o proceso remoto, necesitas otro endpoint para ese runtime.

Si conecta pero la respuesta está vacía o es inválida, confirma la etiqueta exacta y reduce la petición antes de cambiar la ventana de contexto.

Primera tarea segura después de configurar OpenCode con Ollama

Cuando la configuración funciona, empieza con una tarea de solo lectura. Pide explicación, parche propuesto y plan de pruebas; revisa el diff antes de permitir escrituras o comandos.

Usa las guías existentes de agente de código local y memoria cuando la siguiente decisión sea más amplia que provider y Ollama. Esta página debe seguir siendo la ruta de configuración enfocada.