Todas las guías
  1. Inicio
  2. Guías técnicas
  3. IA

IANivel básico

Ollama en Windows: instala, descarga un modelo y úsalo con un agente de programación

6 min de lectura

Todas las guías

Ollama en Windows: instala, descarga un modelo y úsalo con un agente de programación

Una guía práctica para tener modelos de IA en tu propio equipo con Ollama: instalarlo en Windows, descargar y probar un modelo, preparar el contexto que necesitan los agentes y conectarlo a OpenCode o Claude Code para programar sin enviar tu código fuera. Todos los comandos están también en el README.md de la izquierda.

¿Qué vas a aprender?

  • Qué es Ollama y para qué sirve tener modelos de IA en tu propio equipo.
  • Instalar Ollama en Windows y comprobar que funciona.
  • Descargar un modelo, probarlo en la terminal y gestionar los modelos descargados.
  • Preparar el contexto que necesitan los agentes de programación.
  • Conectar un agente (OpenCode o Claude Code) a tu modelo local.

Requisitos previos

  • Windows 10 22H2 o posterior (Home o Pro); no hacen falta permisos de administrador. También macOS 14 o posterior y Linux.
  • Una tarjeta gráfica ayuda mucho: NVIDIA con controlador 551.61 o posterior, o AMD compatible. Sin ella funciona con el procesador, más despacio.
  • Espacio en disco: unos 4 GB para Ollama y, además, lo que ocupe cada modelo (de unos pocos GB a cientos).
  • Para el último paso, un agente instalado: OpenCode o Claude Code (ver la guía de configuración básica de un agente de IA).

Paso a paso

1. Entiende qué hace Ollama

Ollama descarga modelos de IA abiertos y los ejecuta en tu equipo, con una API local en http://localhost:11434. Ollama en sí no es un agente: es el «motor» que un agente de programación como OpenCode o Claude Code puede usar en lugar de un modelo en la nube.

La ventaja principal es la privacidad: con modelos locales, tus instrucciones y tu código no salen de tu equipo. A cambio, los modelos que caben en un portátil suelen ser menos capaces que los grandes modelos en la nube.

2. Instala Ollama

En Windows, descarga el instalador desde ollama.com/download (se instala en tu carpeta de usuario y se mantiene actualizado) o instálalo desde PowerShell. Después comprueba la versión y que el servicio responde «Ollama is running»:

# Opción 1: instalador para Windows (OllamaSetup.exe, en https://ollama.com/download)
# Opción 2: desde PowerShell
irm https://ollama.com/install.ps1 | iex

# Comprueba la versión y que el servicio responde
ollama -v
curl.exe http://localhost:11434

En Linux y macOS:

# Linux (y macOS)
curl -fsSL https://ollama.com/install.sh | sh
ollama -v

En PowerShell escribe curl.exe y no curl: curl es un alias de otro comando.

3. Descarga un modelo y pruébalo

Los modelos se descargan por nombre desde la biblioteca de ollama.com/library. ollama run abre un chat en la terminal:

# Descarga un modelo y chatea con él en la terminal (sal con /bye)
ollama pull qwen3.5
ollama run qwen3.5

# Gestiona los modelos
ollama ls                 # los modelos descargados
ollama ps                 # los que están cargados ahora (y si usan GPU o CPU)
ollama stop qwen3.5       # descarga el modelo de la memoria
ollama rm qwen3.5         # borra el modelo del disco

Algunos modelos de la biblioteca orientados a programar, con su tamaño de descarga:

ModeloEtiquetaDescarga aproximada
Qwen3.5qwen3.5 (9b)7 GB
Qwen2.5-Coderqwen2.5-coder:7b · :14b · :32b4,7 GB · 9 GB · 20 GB
Devstraldevstral (24b)14 GB
gpt-ossgpt-oss:20b14 GB
Qwen3-Coderqwen3-coder (30b)19 GB

Empieza por uno pequeño y comprueba con ollama ps si se ejecuta en la GPU (columna PROCESSOR): si aparece CPU, el modelo no cabe en la memoria de tu tarjeta gráfica e irá más lento.

4. Llámalo desde la API

Cualquier aplicación de tu equipo puede usar el modelo a través de la API local:

# API nativa de Ollama (adaptación a PowerShell del ejemplo con curl de la documentación)
Invoke-RestMethod -Uri http://localhost:11434/api/generate -Method Post -ContentType 'application/json' `
  -Body '{"model":"qwen3.5","prompt":"Escribe una función en Python que sume dos números","stream":false}'

# API compatible con OpenAI, para herramientas que ya la usan:
#   http://localhost:11434/v1/   (piden una clave, pero Ollama la ignora)

5. Prepara el contexto para los agentes

Los agentes de programación envían mucho texto en cada petición (archivos, instrucciones, resultados de comandos). OpenCode y Claude Code necesitan un contexto de 64.000 tokens o más, y por defecto Ollama usa menos si tu tarjeta tiene poca memoria. En Windows, se cambia con una variable de entorno:

1. Cierra Ollama desde el icono de la barra de tareas.
2. Busca «variables de entorno» en Configuración y abre «Editar las variables de entorno de tu cuenta».
3. Crea la variable OLLAMA_CONTEXT_LENGTH con el valor 64000.
4. Pulsa Aceptar y vuelve a abrir Ollama desde el menú Inicio.

Un contexto mayor ocupa más memoria: si el modelo pasa a ejecutarse en CPU, prueba con uno más pequeño.

6. Conecta un agente de programación

La forma más sencilla es ollama launch, que abre el agente ya configurado para usar Ollama:

# Abre un agente ya conectado a Ollama (si no indicas modelo, te deja elegir)
ollama launch opencode --model qwen3.5
ollama launch claude --model qwen3.5

# Solo configurar OpenCode para usar Ollama, sin abrirlo
ollama launch opencode --config

OpenCode también detecta Ollama por sí solo si está en marcha: en OpenCode, /connect, elige Ollama y luego el modelo con /models. Con Claude Code también puedes hacerlo a mano, apuntándolo a la API de Ollama:

# Claude Code contra Ollama, a mano (solo para esta ventana de PowerShell)
$env:ANTHROPIC_AUTH_TOKEN = "ollama"
$env:ANTHROPIC_API_KEY = ""
$env:ANTHROPIC_BASE_URL = "http://localhost:11434"
claude --model qwen3.5
# Dentro de Claude Code, /status muestra a qué se está conectando

7. Mantén Ollama solo en tu equipo

Por defecto Ollama solo escucha en tu propio equipo (127.0.0.1:11434). Si cambias OLLAMA_HOST a 0.0.0.0, cualquiera que llegue a tu equipo por la red podrá usar tus modelos: la API local no comprueba claves. Hazlo solo en una red de confianza y con un cortafuegos.

Errores habituales

curl.exe http://localhost:11434 no responde

Ollama no está en marcha. Ábrelo desde el menú Inicio (debe aparecer su icono en la barra de tareas) y vuelve a probar. Revisa los registros en %LOCALAPPDATA%\Ollama (server.log y app.log).

El modelo va muy lento

Mira ollama ps: si la columna PROCESSOR indica CPU o un reparto entre CPU y GPU, el modelo no cabe en la memoria de tu tarjeta gráfica. Usa un modelo más pequeño o reduce el contexto. Comprueba también que el controlador de NVIDIA es el 551.61 o posterior.

El agente no usa bien las herramientas o «olvida» lo anterior

El contexto es demasiado pequeño. Sube OLLAMA_CONTEXT_LENGTH a 64000 o más (paso 5) y reinicia Ollama. También ayuda usar un modelo pensado para programar.

He cambiado una variable de entorno y no hace nada

Ollama lee las variables al arrancar. Ciérralo desde el icono de la barra de tareas (no basta con cerrar la ventana) y vuelve a abrirlo desde el menú Inicio.

Me quedo sin espacio en disco

Revisa lo descargado con ollama ls y borra lo que no uses con ollama rm. Los modelos se guardan en C:\Users\<usuario>\.ollama\models; para guardarlos en otro disco, define OLLAMA_MODELS como en el paso 5.

No descarga modelos detrás del proxy de la empresa

Define la variable HTTPS_PROXY con la dirección del proxy (no uses HTTP_PROXY) y reinicia Ollama.

Siguientes pasos

  • Configurar el agente, su contexto y sus permisos (ver la guía de configuración básica para programar con un agente de IA).
  • Comparar varios modelos de la biblioteca con una misma tarea de tu proyecto antes de elegir uno.
  • Integrar la API local en tus aplicaciones con la compatibilidad con OpenAI (http://localhost:11434/v1/).
  • Combinar modelos locales para tareas con datos sensibles y modelos en la nube para las más complejas.

Compartir

Más guías sobre

Ver todas las guías

Otras guías técnicas

Ver todas las guías

APIsIntermedio

Estructura básica de una API en IBM API Connect 10

Cómo se estructura una API en IBM API Connect 10: contrato OpenAPI con x-ibm-configuration, Client ID y Client Secret, producto con planes y límites, y validación y publicación con el CLI apic.

Leer la guía 7 min de lectura

IntegraciónIntermedio

Comandos básicos de administración de TIBCO ActiveSpaces 5.2

Los comandos del día a día en TIBCO ActiveSpaces 5.2: servicio de realm sobre servidores FTL, tibdg, definición del grid, tablas, arranque de procesos, estado, escalado con copysets, checkpoints y logs.

Leer la guía 8 min de lectura

DevOpsBásico

Estructura básica de un CI/CD con GitHub Actions

Un pipeline completo con GitHub Actions: pruebas en cada push y pull request, imagen Docker en GitHub Container Registry y despliegue a un entorno protegido, con un workflow listo para copiar.

Leer la guía 6 min de lectura

DesarrolloBásico

Buenas prácticas de desarrollo en Java con Spring Boot

Las prácticas que más se notan en un servicio Spring Boot: estructura, inyección por constructor, DTOs, validación, errores, configuración, transacciones, logs, comentarios, pruebas y calidad automatizada.

Leer la guía 8 min de lectura

Contacto

Construye hoy tu próxima ventaja competitiva

Hablemos sobre cómo podemos ayudarte. Te respondemos con una propuesta técnica clara, sin compromiso.

Solicita información

Los campos marcados con son obligatorios.