Aider + Ollama: programar en el terminal con un agente 100 % local

#Por qué usar Aider en el terminal

Mientras que Cline o Continue viven en VS Code, Aider apuesta por el terminal. Permaneces en tu shell, en la raíz de tu repositorio git, y dialogas con el modelo como si estuvieras hablando con un compañero que tuviera acceso al código. Es un flujo de trabajo diferente, más cercano a la línea de comandos, que gusta a quienes viven en tmux y no quieren dejar el teclado.

Centrado en git

Cada modificación aceptada se convierte en un commit limpio, con un mensaje redactado por Aider. Tu historial sigue siendo legible y puedes deshacer cualquier cambio con un simple git revert.

Mapa de repositorio automático

Aider construye un mapa de tu repositorio (firmas de funciones, clases, estructura) que envía al modelo junto con los archivos abiertos. El modelo entiende el contexto sin que cargues todo el proyecto.

Independiente del editor

Aider modifica los archivos en disco. Sigues usando tu editor habitual en paralelo: Aider ve tus cambios y tú ves los suyos.

100 % local con Ollama

Conectado a Ollama, el modelo corre en tu GPU. Tu código y tus prompts nunca abandonan el equipo, lo que cambia todo para código propietario o bajo NDA.

#Prerrequisitos e instalación

Tres componentes: Python para Aider, Ollama en ejecución con un modelo de código cargado y un repositorio git. Aider necesita un repositorio git para funcionar plenamente: es Aider quien gestiona los commits.

1. 01
   Verifica Ollama

   Ollama debe escuchar en su puerto predeterminado. Ejecuta ollama list para confirmar que responde y ver los modelos ya instalados.
2. 02
   Instala Aider

   El método recomendado es mediante pipx o el script de instalación oficial, que aísla Aider en su propio entorno para evitar conflictos de dependencias de Python.
3. 03
   Colócate en un repositorio git

   Abre un terminal en la raíz de un proyecto bajo control de versiones. Si el proyecto aún no está bajo git, ejecuta git init antes: Aider lo necesita para registrar sus modificaciones mediante commits.

# Via pipx (isole Aider, n'encombre pas votre Python système)
python -m pip install --user pipx
pipx install aider-chat

# Vérifier l'installation
aider --version

#Configurar Aider para Ollama

Aider se comunica con Ollama a través de su endpoint compatible con OpenAI. Hay dos cosas que configurar: la URL base de Ollama (variable de entorno) y el modelo que se va a utilizar. Lo más limpio es crear un archivo .aider.conf.yml en la raíz del proyecto (o en tu carpeta personal para una configuración global), para no tener que volver a escribir las opciones en cada inicio.

# Indique à Aider où trouver l'API Ollama
export OLLAMA_API_BASE=http://127.0.0.1:11434

# Lancer Aider avec un modèle Ollama (préfixe ollama/)
aider --model ollama/qwen3.5:9b

Para no tener que volver a escribirlo, guarda estos ajustes en un archivo de configuración. Aider lee automáticamente un .aider.conf.yml encontrado en la raíz del repositorio o en tu carpeta personal.

# Modèle principal servi par Ollama (préfixe ollama/ obligatoire)
model: ollama/devstral:24b

# Modèle léger pour les tâches annexes (messages de commit, résumés)
weak-model: ollama/qwen3.5:9b

# Auto-commit des modifications acceptées (comportement par défaut)
auto-commits: true

# Ne pas committer automatiquement les fichiers que VOUS modifiez
dirty-commits: false

- name: ollama/devstral:24b
  extra_params:
    num_ctx: 8192

#¿Qué modelo según la VRAM?

Aider envía mucho contexto (archivos añadidos + mapa de repositorio) y espera un parche bien formado a cambio. Un modelo demasiado pequeño produce diffs rotos que Aider no puede aplicar. Busca el mayor modelo de codificación que tu tarjeta pueda cargar cómodamente, manteniendo margen para el contexto.

#Flujo de trabajo de principio a fin

Este es el ciclo típico de una modificación, desde el inicio de Aider hasta el commit. Una vez que adquieres este ritmo, encadenas los cambios sin salir nunca del terminal.

1. 01
   Inicia Aider en la raíz del repositorio

   Aider arranca, lee la configuración, construye el repo-map y muestra un indicador de entrada. Indica el modelo activo y el número de archivos detectados.
2. 02
   Agrega los archivos afectados con /add

   Agrega solo los archivos que la tarea debe modificar. Cuantos menos archivos haya en el contexto, más preciso será el modelo. El repo-map ya da al modelo una visión del resto del proyecto.
3. 03
   Describe la modificación en francés

   Escribe tu solicitud en lenguaje natural: «agrega la validación del correo electrónico en el formulario de inscripción». Aider reflexiona y luego propone un parche.
4. 04
   Relee el diff propuesto

   Aider muestra el diff antes de aplicar los cambios. Revísalo. Si algo no va bien, responde para corregirlo: «no, usa una regex más estricta».
5. 05
   Deja que Aider cree los commits

   Una vez aplicado el parche, Aider crea automáticamente un commit con un mensaje descriptivo. Tu historial de git permanece limpio y cada cambio es rastreable.
6. 06
   Itera o deshaz los cambios

   Sigue con la modificación siguiente. Si un commit de Aider no te convence, /undo anula el último commit que ha creado, sin tocar el resto.

$ aider
Aider v0.x — model: ollama/devstral:24b
Repo-map: 42 fichiers

> /add src/auth/register.py
Added src/auth/register.py to the chat

> Ajoute la validation de l'email dans le formulaire d'inscription

[Aider propose un diff, l'applique, puis :]
Commit a1b2c3d  feat: valider le format de l'email à l'inscription

#Comandos clave para el día a día

Aider se maneja mediante comandos con barra (/) en su línea de entrada. Unos pocos bastan para cubrir el 90 % de los usos.

/add fichier

Añade uno o varios archivos al contexto de edición. Aider escribirá en estos archivos. Limítate a lo estrictamente necesario.

/drop fichier

Elimina un archivo del contexto. Útil cuando cambias de tarea para empezar desde un contexto limpio.

/architect

Activa el modo de planificación seguido de código: el modelo razona primero sobre el enfoque y después genera el diff. Ideal para cambios no triviales.

/diff

Muestra los cambios desde el último commit, para repasar lo que Aider ha modificado antes de continuar.

/undo

Anula el último commit creado por Aider. Red de seguridad inmediata si una modificación sale mal.

/run commande

Ejecuta un comando de shell (pruebas, linter) y vuelve a insertar la salida en el chat. Aider puede entonces corregir basándose en los errores reales.

/ask question

Plantea una pregunta sobre el código SIN desencadenar modificaciones ni commits. Para entender antes de actuar.

#Limitaciones de la ejecución local frente a la nube

Seamos honestos: un modelo local que se ejecuta con entre 8 y 16 GB de memoria no iguala a un modelo puntero en la nube. Conocer las limitaciones evita la frustración y ayuda a elegir la herramienta adecuada según la tarea.

Diffs a veces mal formados

Los pequeños modelos a veces producen un parche que Aider no puede aplicar (formato dañado). Aumentar el tamaño del modelo o ampliar num_ctx reduce considerablemente este problema.

Contexto más corto

Un modelo en la nube procesa decenas de archivos. En local, mantén el contexto acotado: añade pocos archivos con /add a la vez y apóyate en el repo-map en lugar de cargarlo todo.

Razonamiento multiarchivo

Las refactorizaciones que afectan a muchos archivos a la vez siguen siendo el punto débil de los modelos locales. Divide el trabajo en varias tareas pequeñas o pasa a /architect para estructurarlo.

Velocidad dependiente del GPU

La latencia depende de tu tarjeta. Un 32B en una tarjeta modesta será lento. Si la rapidez de respuesta es prioritaria, un 7B o 14B bien ajustado es más agradable en el día a día.

#Preguntas frecuentes