Cómo arreglarlo en Windows, paso a paso
Ollama solo lee la variable OLLAMA_CONTEXT_LENGTH al arrancar, así que primero hay que cerrarlo del todo, también el icono de la bandeja. Luego elige si quieres el cambio solo para esta sesión o para siempre.
- Cierra Ollama: Get-Process ollama* -ErrorAction SilentlyContinue | Stop-Process -Force
- Arráncalo con más contexto solo para esta sesión: $env:OLLAMA_CONTEXT_LENGTH = "32768"; ollama serve
- O déjalo así para siempre en tu usuario: [Environment]::SetEnvironmentVariable("OLLAMA_CONTEXT_LENGTH", "32768", "User") y vuelve a abrir la aplicación de Ollama
- En el opencode.json de tu proyecto, añade Ollama como proveedor: { "provider": { "ollama": { "npm": "@ai-sdk/openai-compatible", "name": "Ollama (local)", "options": { "baseURL": "http://127.0.0.1:11434/v1" }, "models": { "gemma4:12b": { "name": "gemma4 12B local" } } } } }
- En el mismo archivo, añade "model": "ollama/gemma4:12b" y "small_model": "ollama/gemma4:12b"
- Pruébalo: opencode run -m ollama/gemma4:12b "Lee acta.md y crea acciones.md con una tabla de acciones"
Probado con OpenCode 1.19.5 y Ollama 0.40.14, arrancando Ollama solo para la sesión. La opción permanente no se probó aparte, y el paso del small_model se comprobó con otro servidor local, no con Ollama.
Cómo comprobar que ya funciona
No te fíes de que «ahora parece que va». Haz estas comprobaciones con el modelo cargado, mientras OpenCode trabaja o justo después.
- Ejecuta ollama ps: la columna CONTEXT debe mostrar 32768 (o el valor que pusiste) y PROCESSOR, «100% GPU». Si sigue en 4096, Ollama no leyó la variable: no lo cerraste del todo o la pusiste en otra ventana.
- Mira el registro: buscar «truncating input prompt» (el comando está más abajo) no debe dar líneas nuevas desde que lo arrancaste.
- Mira lo que hace: el agente usa sus herramientas (glob, read, write) y el archivo que pediste aparece en la carpeta. Con 32.768, gemma4:12b lo creó en 27 segundos.
- Mira la memoria: con 32.768 de contexto y gemma4:12b, la memoria ocupada de la gráfica rondó los 8,4 GB. Si te acercas al límite de tu tarjeta, lee Ollama no usa la GPU en Windows.
Cómo confirmar que es esto: lo que hace el agente y lo que dice el registro
En pantalla no sale ningún error. Ves un agente que actúa como si no hubiera leído tu mensaje, porque de hecho no lo ha leído. En las pruebas, gemma4:12b se puso a planificar una función «Remember Me» para un formulario de inicio de sesión que no existía y llamó 65 veces a su lista de tareas hasta agotar los 400 segundos de tiempo. qwen3.5:9b, con el mismo encargo, contestó que no tenía acceso a archivos.
La prueba definitiva está en el registro de Ollama. Si usas la aplicación, está en %LOCALAPPDATA%\Ollama\server.log; si lanzas ollama serve a mano, sale en esa misma ventana. Busca el aviso «truncating input prompt», que quiere decir que Ollama ha recortado lo que le llegaba. En las pruebas apareció 66 veces: OpenCode mandaba entre 22.159 y 23.004 tokens y Ollama los dejaba en unos 2.050.
- Select-String -Path "$env:LOCALAPPDATA\Ollama\server.log" -Pattern "truncating input prompt" | Select-Object -Last 5
- Así se ve: level=WARN source=llama_server.go:344 msg="truncating input prompt" limit=2051 prompt=22159 keep=5 new=2051
- Y al arrancar: msg="vram-based default context" total_vram="15.9 GiB" default_num_ctx=4096
Líneas reales del registro de Ollama 0.40.14.
Por qué pasa: 4.096 tokens de contexto frente a unos 23.000 de instrucciones
Ollama decide el contexto por defecto según la memoria de tu gráfica: 4k tokens por debajo de 24 GiB, 32k entre 24 y 48 GiB y 256k a partir de 48 (context length en la documentación de Ollama). Con 16 GB, lo normal en un PC doméstico con buena gráfica, te quedas en 4.096.
Antes de tu mensaje, OpenCode manda sus instrucciones internas, la descripción de cada herramienta (leer, buscar, escribir, ejecutar…) y todo lo que encuentra en tu configuración: AGENTS.md, skills y servidores MCP (conectores con otros programas). En las pruebas eso sumó 22.919 tokens. Con la configuración global vacía bajó a 7.440, medido con otro servidor local y el mismo OpenCode. Ni la versión limpia cabe en 4.096: el problema no es tu configuración, es el valor por defecto.
Por eso la documentación de OpenCode recomienda subir num_ctx a 16k–32k si las herramientas no funcionan (proveedores de OpenCode), y la integración oficial de Ollama con OpenCode pide 64k o más (Ollama + OpenCode). Con 32.768 ya funcionó; 64k ocupa más memoria de la gráfica.
La otra fuga: el small_model y la configuración global
OpenCode usa un segundo modelo, small_model, para tareas ligeras como poner título a la sesión. Según su documentación, si no lo configuras busca uno más barato del mismo proveedor y, si no lo hay, usa el principal (configuración de OpenCode). El problema llega si ya tienes uno definido en la configuración global (~/.config/opencode/opencode.json): los archivos se combinan y ese small_model global sigue activo en un proyecto que creías local.
Con una configuración global cargada (AGENTS.md, skills, un servidor MCP de navegador y un small_model de un proveedor en la nube), el prompt subió a 23.569 tokens. El agente se quedó en bucle, leyendo, pensando y resumiendo la conversación cuatro veces en 11 minutos sin escribir nada, y opencode.exe abrió una conexión HTTPS con ese proveedor. Con la configuración global vacía y model y small_model apuntando al servidor local, el prompt bajó a 7.440 tokens y la tabla salió bien en 2 min 50 s. Esa prueba se hizo con otro servidor local y un modelo mayor, no con Ollama, pero la fuga es cosa de OpenCode, no del servidor.
- $env:XDG_CONFIG_HOME = "C:\opencode-config-vacia"
- $env:OPENCODE_DISABLE_CLAUDE_CODE = "1"
- Comprobar conexiones: Get-NetTCPConnection -State Established -OwningProcess (Get-Process opencode*).Id | Select-Object RemoteAddress, RemotePort
Variables probadas con OpenCode 1.19.5. Con todo en local, solo deberían verse conexiones a 127.0.0.1 (la primera vez descarga además un complemento de npm).
Qué puedes esperar de un modelo local con OpenCode
Arreglar el contexto hace que OpenCode funcione; no hace que un modelo de 9–12B trabaje bien. Con 32.768 tokens, gemma4:12b usó las herramientas, pero puso el número de turno en la columna de fecha y apuntó como responsable a quien hablaba en cada turno, incluido un «Envío al cliente → Marta» que el acta dejaba sin responsable. qwen3.5:9b leyó el archivo y no hizo nada más (17 s). Un modelo local con un agente sirve para tareas pequeñas que puedas comprobar, no para delegar trabajo. Todos los datos y el registro están en la prueba OpenCode con un modelo local de Ollama.
Casos raros
- «does not support tools»: es otro problema. Ollama rechaza las herramientas si el modelo no las declara. Comprueba con ollama show <modelo> que tools aparece entre sus capacidades o usa otro modelo; subir el contexto no lo arregla.
- Respuesta vacía después de un minuto: los modelos que razonan pueden gastarse el contexto pensando. qwen3.5:9b gastó 3.661 de 4.096 tokens razonando y devolvió texto vacío por la API /v1; con reasoning_effort: "none" respondió en 3,6 s. Lo explicamos en Ollama devuelve una respuesta vacía.
- Más contexto no es gratis: ocupa memoria de la gráfica. Si el modelo deja de caber, Ollama lo reparte con la RAM y la velocidad se hunde. Las cuentas están en Cuánta RAM y VRAM necesitas para IA local.
- OpenCode no carga tus skills: van en la carpeta .opencode/skills y necesitan la cabecera YAML. Mira la plantilla de skill.
Preguntas frecuentes
¿Por qué OpenCode dice que Ollama «does not support tools»?Porque el modelo que has elegido no declara herramientas en Ollama. No tiene que ver con el contexto: cambia a un modelo que las admita y compruébalo con ollama show.
¿Cuál es la configuración mínima de OpenCode para Ollama?Un proveedor @ai-sdk/openai-compatible con baseURL http://127.0.0.1:11434/v1 y el modelo declarado, y Ollama arrancado con OLLAMA_CONTEXT_LENGTH a 32.768 o más. Pon también el small_model en el modelo local.
¿Funciona OpenCode con Ollama en local en Windows?Sí: todo lo de esta guía se probó en Windows 11. La condición es el contexto: con 4.096 no funciona, porque ni siquiera caben las instrucciones de OpenCode.
¿Es gratis usar OpenCode con modelos locales?OpenCode y Ollama no cobran por usarlos en tu PC; lo pagas en memoria de la gráfica, electricidad y calidad. Si tu configuración global tiene un small_model en la nube, esa parte sí sale de tu equipo.