Principiante 8 minOllama

Ollama list, pull, run: los comandos essentielles

Un portátil muestra código junto a una libreta abierta.

Ollama se maneja en gran parte desde la terminal: ollama pull para descargar un modelo, ollama run para conversar con él, ollama list para ver qué está instalado. Esta guía reúne los comandos del día a día (pull, run, list, ps, show, stop, rm, create, cp) con un ejemplo por comando y cómo interpretar lo que muestran. Tenla abierta junto a la terminal durante las primeras semanas.

Por Léa B.·Actualización 2026-11-16·Probado en Windows, macOS y Linux
!
Límite de esta guía
La página oficial de la CLI (docs.ollama.com/cli) y el repositorio de GitHub de Ollama no pudieron revisarse el día de la redacción, el 16 de noviembre de 2026, y ninguna de las salidas siguientes es una captura hecha por QuelLLM: son ejemplos ilustrativos del formato. Los comandos y opciones descritos existen desde hace varias versiones, pero Ollama evoluciona rápido. Antes de fiarte de una opción, compruébala con ollama help u ollama <comando> --help en tu versión.

#Por qué aprender los comandos de Ollama

Ollama se ejecuta en segundo plano (el «servidor», que escucha en http://localhost:11434) y ofrece un pequeño programa de línea de comandos, ollama, que le envía órdenes. Las interfaces gráficas como Open WebUI pasan por el mismo servidor: saben chatear con un modelo, pero no siempre comprobar qué ocupa la memoria de la GPU, inspeccionar los parámetros de un modelo o hacer limpieza en el disco.

Nueve comandos cubren lo esencial. Se agrupan en tres familias: obtener y usar un modelo (pull, run), gestionar los modelos almacenados en el disco (list, show, rm, cp, create) y gestionar los cargados en memoria (ps, stop). Tener clara esta distinción entre disco y memoria evita la mayoría de las confusiones: un modelo puede estar descargado sin estar cargado, y cargado sin que estés hablando con él.

#Prerrequisitos

El kit completo para crear tu propio asistente de IA.

Aprovecha nuestra experiencia y un recorrido guiado para crear tu asistente local y usar tu IA en el día a día.

  • Espacio en línea de por vida
  • PDF + archivos
  • Reembolsado 30 d
Ollama instalado
En Windows, macOS o Linux. Si aún no lo has hecho, sigue primero la guía de instalación (enlace al final de la página).
Un terminal
PowerShell o Terminal Windows, Terminal en macOS, cualquier shell en Linux. Los comandos son idénticos en los tres sistemas.
El servidor en ejecución
La aplicación Ollama en Windows y macOS, o el servicio systemd en Linux. Sin él, la mayoría de los comandos devuelven un error de conexión.
Espacio en el disco
Un modelo pequeño de 3B en Q4_K_M ocupa unos 2 GB; un 7B, unos 5 GB; un 14B, unos 9 GB.
Terminal — comprobar que todo responde
ollama --version
ollama help

El primer comando muestra la versión del cliente y, si el servidor responde, también la suya. El segundo lista todos los comandos disponibles en tu instalación: es la referencia que debes consultar si algún ejemplo de esta guía no te funciona.

#Paso 1 — ollama pull et ollama run: obtener y ejecutar un modelo

#ollama pull: télécharger

ollama pull descarga un modelo desde la biblioteca oficial (ollama.com/library) sin ejecutarlo. El nombre sigue el formato modelo:etiqueta. Sin etiqueta, Ollama usa latest, que en general apunta al tamaño y la cuantización propuestos por defecto, a menudo Q4_K_M.

Terminal
# Télécharger la version par défaut
ollama pull llama3.2

# Télécharger une taille précise
ollama pull llama3.2:1b

# Relancer pull sur un modèle déjà présent le met à jour :
# seules les couches modifiées sont retéléchargées
ollama pull llama3.2

Las etiquetas disponibles (tamaños, cuantizaciones como q8_0 o fp16) aparecen en la página de cada modelo en la biblioteca. Si la descarga se interrumpe, al volver a ejecutar el mismo comando se reanuda donde se había quedado.

#ollama run: conversar con un modelo

ollama run carga el modelo en memoria y abre una sesión de conversación en la terminal. Si el modelo todavía no está en el disco, run empieza por descargarlo: por lo tanto, pull no es obligatorio, pero permite preparar los modelos con antelación.

Terminal
# Session interactive
ollama run llama3.2

# Question unique : la réponse s'affiche, puis la commande se termine
ollama run llama3.2 "Explique la différence entre RAM et VRAM en trois phrases."

# Afficher les statistiques de génération après chaque réponse
ollama run llama3.2 --verbose

En la sesión interactiva, los comandos empiezan con una barra diagonal. Escribe /? para ver la lista completa en tu versión; los más útiles son los siguientes.

/bye
Salir de la sesión (Ctrl+D también funciona). El modelo permanece cargado en memoria unos minutos.
/clear
Borrar el historial de la conversación actual sin salir.
/set parameter num_ctx 8192
Cambiar un parámetro para la sesión, en este caso el tamaño del contexto. Útil para hacer pruebas antes de fijarlo en un Modelfile.
/show info
Mostrar la información del modelo cargado, como ollama show.
"""
Abrir y luego cerrar un bloque de texto de varias líneas, práctico para pegar un fragmento largo.

Con --verbose, Ollama muestra después de cada respuesta tiempos y velocidades (entre ellas eval rate, en tokens por segundo). Es la forma más sencilla de medir la velocidad de un modelo en tu propio equipo, en lugar de fiarte de una cifra encontrada en otro sitio.

→
Enviar un archivo al modelo
En Linux y macOS funciona la redirección del shell: ollama run llama3.2 "Resume este texto:" < notes.txt. El contenido del archivo se añade a la pregunta. Comprueba que el texto quepa en el contexto del modelo; de lo contrario, el principio quedará truncado.

#Paso 2 — ollama list y ollama rm: gestionar los modelos en el disco

#ollama list: voir ce qui est installé

ollama list (o su alias ollama ls) muestra todos los modelos presentes en el disco. Es el comando que debes ejecutar antes de eliminar cualquier cosa y para encontrar el nombre exacto de un modelo que vayas a pasar a los demás comandos.

Terminal
ollama list
Ejemplo de salida (formato orientativo, valores ficticios)
NAME               ID              SIZE      MODIFIED
llama3.2:latest    a80c4f17acd5    2.0 GB    3 days ago
mon-assistant:latest  b2e1d8c90f3a    2.0 GB    2 hours ago
qwen2.5:7b         845dbda0ea48    4.7 GB    2 weeks ago
NAME
Nombre completo con su etiqueta. Es este nombre, tal cual, el que esperan run, show, rm o cp.
ID
Inicio de la huella del manifiesto. Dos nombres con el mismo ID designan el mismo modelo: es lo típico después de un ollama cp.
SIZE
Tamaño de los archivos del modelo en el disco. Da una idea aproximada de la memoria necesaria, pero la memoria que realmente ocupa una vez cargado es mayor (contexto, caché KV): es ollama ps el que la muestra.
MODIFIED
Fecha de la última descarga o de la última creación. Un modelo antiguo no está necesariamente desactualizado: vuelve a ejecutar pull para saber si existe una versión más reciente con la misma etiqueta.

Cuidado al sumar los tamaños: los modelos que comparten capas (un modelo y su copia, o un modelo personalizado creado a partir de otro) solo las almacenan una vez. Por eso, la suma de la columna SIZE puede superar el espacio realmente ocupado en la carpeta de modelos.

#ollama rm: eliminar un modelo

Terminal
ollama rm qwen2.5:7b

rm quita el modelo de la lista y elimina los archivos que ya no usa ningún otro modelo. No hay papelera ni confirmación: para recuperarlo, tendrás que volver a descargarlo. Para liberar espacio en disco a fondo o desinstalar Ollama, la guía de mantenimiento detalla los pasos a seguir según el sistema.

#Paso 3 — ollama ps y ollama stop: gestionar la memoria

Cuando sales de una sesión con /bye, el modelo no se descarga de inmediato: Ollama lo mantiene en memoria durante un tiempo (5 minutos por defecto, configurable con la variable de entorno OLLAMA_KEEP_ALIVE) para que la siguiente pregunta empiece sin espera. ollama ps muestra lo que está cargado en ese momento.

Terminal
ollama ps
Ejemplo de salida (formato orientativo, valores ficticios)
NAME               ID              SIZE      PROCESSOR          UNTIL
llama3.2:latest    a80c4f17acd5    3.1 GB    100% GPU           4 minutes from now
qwen2.5:14b        7cdf5a0187d5    11 GB     27%/73% CPU/GPU    2 minutes from now
SIZE
Memoria ocupada por el modelo cargado, contexto incluido. Es mayor que el tamaño en disco que muestra ollama list.
PROCESSOR
La columna más útil. «100% GPU»: todo cabe en la VRAM, que es el caso ideal. Un reparto CPU/GPU significa que una parte del modelo se desborda a la memoria del sistema: la generación se ralentiza notablemente. «100% CPU»: no se usa ninguna GPU.
UNTIL
Momento en que el modelo se descargará si no recibe más solicitudes.
CONTEXT
Según la versión, una columna indica también el tamaño de contexto asignado. Si no aparece en tu caso, ollama show donne el valor configurado.

Si PROCESSOR indica un reparto CPU/GPU en un modelo que debería caber en tu tarjeta (por ejemplo, un 7B en Q4, de unos 5 GB, en una RTX 3060 de 12 GB), comprueba primero si no hay otro modelo cargado al mismo tiempo o un tamaño de contexto demasiado grande.

#ollama stop: descargar un modelo de la memoria

Terminal
ollama stop qwen2.5:14b

stop libera de inmediato la memoria ocupada por ese modelo, sin eliminarlo del disco. Es útil antes de abrir un juego, un programa de renderizado u otro modelo más grande. No lo confundas con rm: stop actúa sobre la memoria; rm, sobre el disco.

i
Detener el propio servidor
ollama stop no apaga Ollama. Para detener el servidor, cierra la aplicación desde la barra de menús o el área de notificaciones (Windows, macOS), o detén el servicio en Linux: sudo systemctl stop ollama. El comando ollama serve sirve para iniciar el servidor manualmente, en primer plano, por ejemplo para leer sus mensajes de depuración.

#Paso 4 — ollama show: inspeccionar un modelo

ollama show muestra la ficha de un modelo instalado: arquitectura, número de parámetros, longitud máxima de contexto, tamaño del embedding, cuantización, capacidades (herramientas, visión, razonamiento según el modelo), parámetros por defecto y licencia. Es lo primero que debes revisar antes de ajustar el tamaño de contexto o escribir un Modelfile.

Terminal
# Fiche résumée
ollama show llama3.2

# Uniquement les paramètres par défaut (température, stop, num_ctx...)
ollama show llama3.2 --parameters

# Le Modelfile complet qui a servi à construire le modèle
ollama show llama3.2 --modelfile

# Le gabarit de conversation, le prompt système, la licence
ollama show llama3.2 --template
ollama show llama3.2 --system
ollama show llama3.2 --license
--parameters
Parámetros de inferencia fijados por el autor del modelo. Si no aparece nada, se aplican los valores por defecto de Ollama.
--modelfile
Punto de partida ideal para personalizar un modelo: copia la salida en un archivo, modifícala y luego pásala a ollama create.
--template
Formato de mensajes que espera el modelo. Modifícalo solo si sabes por qué: una plantilla incorrecta degrada mucho las respuestas.
--license
Texto de la licencia. Léelo antes de cualquier uso comercial: no todas las licencias de los modelos open-weight son equivalentes.
-v / --verbose
En las versiones recientes, muestra metadatos adicionales del archivo del modelo.

#Paso 5 — ollama create et ollama cp: crear tus variantes

#ollama create: construire un modèle à partir d'un Modelfile

Un Modelfile es un pequeño archivo de texto que parte de un modelo existente y le añade un prompt de sistema, parámetros o una plantilla. ollama create le convierte en un nuevo modelo que aparece en ollama list. Las capas del modelo base se reutilizan: la variante casi no ocupa espacio en disco.

Modelfile
FROM llama3.2
PARAMETER temperature 0.3
PARAMETER num_ctx 8192
SYSTEM "Tu réponds en français, de façon concise et factuelle."
Terminal
ollama create mon-assistant -f ./Modelfile
ollama run mon-assistant

Si el archivo se llama exactamente Modelfile y está en la carpeta actual, la opción -f puede omitirse según la versión. ollama create sait también importar pesos en formato GGUF (FROM ./modele.gguf) o cuantizar un modelo en FP16 con la opción --quantize (-q), por ejemplo -q q4_K_M. Todas las instrucciones del Modelfile se detallan en la guía específica.

#ollama cp: copiar o renombrar

Terminal
# Créer un alias plus court
ollama cp qwen2.5:7b qwen

# « Renommer » = copier puis supprimer l'ancien nom
ollama cp mon-assistant assistant-fr
ollama rm mon-assistant

La copia comparte los mismos archivos que el original (mismo ID en ollama list). Sirve sobre todo para mantener un nombre estable en tus scripts o tu interfaz, o para congelar una versión antes de que un ollama pull qui la reemplace.


#Guía rápida: todos los comandos de Ollama de un vistazo

ollama pull <modelo>
Descargar o actualizar un modelo desde la biblioteca.
ollama run <modelo> ["question"]
Chatear en modo interactivo o hacer una sola pregunta. Descarga el modelo si falta. --verbose para ver las estadísticas.
ollama list / ollama ls
Listar los modelos presentes en el disco: nombre, ID, tamaño, fecha.
ollama ps
Listar los modelos cargados en memoria, cuánta ocupan y el reparto entre CPU y GPU.
ollama show <modelo>
Ficha del modelo; --parameters, --modelfile, --template, --system, --license.
ollama stop <modelo>
Descargar un modelo de la memoria sin eliminarlo.
ollama rm <modelo>
Eliminar un modelo del disco, sin confirmación.
ollama create <nombre> -f Modelfile
Crear un modelo personalizado; -q para cuantizar.
ollama cp <source> <destination>
Copiar un modelo con otro nombre.
ollama serve
Iniciar el servidor en primer plano (útil para depurar).
ollama push <usuario>/<modelo>
Publicar un modelo en ollama.com (se requiere una cuenta).
ollama help [comando]
Ayuda general o de un comando concreto; equivale a --help.

Las versiones recientes añaden otros comandos, relacionados sobre todo con la cuenta de ollama.com y los modelos alojados. Quedan fuera del alcance de esta guía rápida, centrada en el uso local: ollama help los muestra en tu versión.

#Solución de errores comunes

  1. 01
    «could not connect to ollama app» o «connection refused»
    El servidor no está en ejecución. Abre la aplicación Ollama (Windows, macOS) o inicia el servicio (Linux: sudo systemctl start ollama) y vuelve a intentarlo. Como último recurso, ejecuta ollama serve en una terminal aparte para leer los mensajes de error.
  2. 02
    «model not found» o «file does not exist»
    El nombre no corresponde a ningún modelo instalado. Ejecuta ollama list y copia el nombre exacto, etiqueta incluida: qwen2.5 se refiere a qwen2.5:latest, no a qwen2.5:14b.
  3. 03
    ollama list est vide alors que des modèles ont été téléchargés
    Puede que el cliente esté consultando otro servidor u otra carpeta de modelos: una variable OLLAMA_HOST distinta, OLLAMA_MODELS modificada o Ollama instalado dos veces (la aplicación y un contenedor Docker, por ejemplo). En un contenedor, los comandos se ejecutan dentro de él: docker exec -it ollama ollama list.
  4. 04
    El modelo responde muy lentamente
    Ejecuta ollama ps durante una generación. Si la columna PROCESSOR muestra una parte de CPU, el modelo no cabe por completo en la VRAM: descarga los demás modelos con ollama stop, reduce num_ctx o elige un tamaño o una cuantización más pequeños.
  5. 05
    El disco se llena
    Haz un repaso con ollama list y elimina con ollama rm les los modelos que no uses. Para los casos más difíciles (archivos huérfanos, carpeta movida), consulta la guía de mantenimiento.
→
Controlar un servidor remoto
Todos estos comandos aceptan la variable OLLAMA_HOST. Por ejemplo, OLLAMA_HOST=192.168.1.20:11434 ollama ps consulta el Ollama de otra máquina de la red local, siempre que ese servidor escuche en su interfaz de red y no solo en localhost. Nunca expongas este puerto a Internet sin protección: la API no tiene autenticación.

#Para ir más allá

Esta guía rápida trata la línea de comandos. La instalación, el mantenimiento y la personalización avanzada tienen cada uno su propia guía.

Instalar Ollama
Instalación paso a paso en Windows, macOS y Linux: https://quelllm.fr/guide/installer-ollama
Actualizar, eliminar, desinstalar
Actualizaciones según el sistema, recuperación de espacio en disco, desinstalación completa: https://quelllm.fr/guide/maintenance-ollama-update-supprimer
Modelfile
Todas las instrucciones para crear y personalizar un modelo con ollama create: https://quelllm.fr/guide/ollama-modelfile-personnalisation
Entender Ollama
Qué hace Ollama, cómo carga los modelos y a quién va dirigido: https://quelllm.fr/guide/ollama-debutant-c-est-quoi-comment-ca-marche
Fuentes oficiales
Referencia de la CLI: https://docs.ollama.com/cli; código y notas de la versión: https://github.com/ollama/ollama (no revisadas el 16 de noviembre de 2026; consulta el aviso al principio de la guía).
¿Esta guía te ha ayudado?

¿Un comentario, un error, una precisión? Avísanos, eso mejora la guía para todos.