Como instalar Aider paso a paso

Que es Aider?

Aider es un asistente de programación en pareja basado en terminal. Trabaja directamente con Git, haciendo commits automáticos de cada cambio. Es la herramienta más madura para programación asistida por IA en terminal, con soporte para múltiples modelos y proveedores.

En esta guia completa te enseñaremos a instalarlo desde cero, configurarlo con diferentes proveedores de IA, asegurarlo correctamente, y sacarle el maximo partido con consejos profesionales y flujos de trabajo reales. Al final, como bonus, te explicamos como potenciarlo con las 1136 skills de SKILLSBUNDLE.

Requisitos del sistema

Antes de empezar, asegurate de que tu sistema cumple estos requisitos:

• Sistema operativo: macOS 12+, Windows 10+ (64-bit) o Ubuntu 20+ / Debian 11+ / Fedora 38+
• RAM: 8 GB minimo (16 GB recomendado para proyectos grandes)
• Disco: 500 MB para la herramienta + espacio para tus proyectos
• Node.js 18+ (si la instalacion es via npm)
• Python 3.9+ (para herramientas como Aider y Hermes Agent)
• Git (para herramientas que trabajan con repositorios)
• Conexion a internet (para descargar e instalar; para IA en la nube)
• Terminal: bash, zsh o PowerShell

Metodos de instalacion

Hay varias formas de instalar Aider. Elige la que mejor se adapte a tu sistema y preferencias:

pip (recomendado)

pip install aider-chat # Python 3.9+
O con uv: uv tool install --python python3.12 aider-chat@latest

Instalador rápido

python -m pip install aider-install && aider-install
Este método instala la última versión y configura el comando 'aider'.

Desde GitHub

git clone https://github.com/paul-gauthier/aider.git
cd aider && python -m pip install -e .

Verificar la instalacion

Una vez instalado, verifica que todo funciona:

aider --version

Si ves un error, revisa la seccion de solucion de problemas al final de la guia.

Configurar autenticacion y proveedores de IA

La mayoria de herramientas de IA requieren configurar al menos un proveedor de modelos. Aqui tienes las opciones disponibles para Aider:

OpenAI API Key

export OPENAI_API_KEY=sk-...
Aider usará GPT-4 por defecto. Puedes cambiar el modelo con --model.

Anthropic API Key

export ANTHROPIC_API_KEY=sk-ant-...
aider --model claude-opus-4.5

OpenRouter

export OPENROUTER_API_KEY=sk-or-...
aider --model openrouter/anthropic/claude-opus-4.5
OpenRouter te da acceso a 300+ modelos con una sola API key.

DeepSeek

export DEEPSEEK_API_KEY=sk-...
aider --model deepseek/deepseek-coder
Excelente relación calidad/precio para tareas de código.

Ollama (local)

export OLLAMA_API_BASE=http://localhost:11434
aider --model ollama_chat/qwen2.5-coder:14b
Completamente offline, sin coste de API.

Groq

export GROQ_API_KEY=gsk_...
aider --model groq/llama-3.3-70b
Inferencia ultrarrápida, ideal para tareas simples.

Proveedores alternativos

No tienes por que limitarte a un solo proveedor. Aqui tienes una comparativa de los principales proveedores de IA que puedes usar:

Seguridad: mejores practicas

La seguridad es critica cuando usas herramientas de IA que tienen acceso a tu sistema. Sigue estas recomendaciones:

• Aider trabaja con Git: cada cambio se commit automaticamente. Puedes revertir cualquier cambio con git revert.
• API keys: configúralas en ~/.aider.conf.yml o como variables de entorno. Nunca las incluyas en el código.
• Modo `--no-auto-commits`: desactiva commits automáticos si prefieres revisar cada cambio manualmente.
• Modo `--lint`: Aider verifica el código con linters antes de aplicar cambios.
• Archivos sensibles: añade rutas a .aiderignore para que Aider no los modifique ni los lea.
• Modo `--dry-run`: simula cambios sin aplicar nada. Útil para revisar lo que Aider haría.
• Para entornos compartidos: usa `--no-git` para no interferir con el historial de Git del equipo.
• El archivo de configuración ~/.aider.conf.yml puede contener API keys. Protégelo con chmod 600.

Consejos profesionales

Una vez que Aider funciona, estos consejos te ayudaran a usarlo como un experto:

• Aider funciona con Git: cada cambio se commitca automáticamente. Puedes navegar el historial con git log.
• Usa /add para añadir archivos al contexto de la conversación. Aider usará ese contexto para sus sugerencias.
• Comando /undo: revierte el último cambio de Aider. Es seguro porque cada cambio es un commit.
• Comando /diff: muestra el diff de los cambios pendientes.
• Comando /run: ejecuta comandos de terminal sin salir de Aider.
• Configuración por proyecto: crea .aider.conf.yml en la raíz del proyecto con opciones específicas.
• Modo arquitecto: aider --architect primero planifica y luego implementa. Ideal para tareas complejas.
• Puedes cambiar de modelo en medio de una sesión con /model nombre-del-modelo.

Flujos de trabajo recomendados

Estos son los casos de uso mas potentes de Aider:

• Pair programming: describe una feature y Aider la implementa con commits organizados
• Bug fixing: 'encuentra y arregla el bug en esta función' - Aider localiza el error, lo corrige y hace commit
• Refactorización: 'mejora la estructura de este módulo siguiendo principios SOLID'
• Code review: 'revisa los últimos 5 commits y encuentra problemas de seguridad o rendimiento'
• Documentación: 'genera docstrings para todas las funciones públicas siguiendo el formato Google'
• Testing: 'crea tests unitarios con pytest para este módulo, cubriendo casos normales, error y borde'
• Automatización: 'crea un script que automatice el proceso de build y deploy'
• Migración de código: 'traduce este código de Python a Rust manteniendo la funcionalidad'

Solucion de errores comunes

command not found: aider

pip install no añadió el binario al PATH. Solución: python -m pip install aider-install && aider-install o usa python -m aider.

Error: 'API key not configured'

Necesitas configurar al menos una API key. Solución: export OPENAI_API_KEY=... o configúrala en ~/.aider.conf.yml

Aider no hace commits

El repositorio actual no es un repo Git. Solución: git init o git clone primero. Aider requiere Git para funcionar.

Error de conexión con Ollama

Verifica que Ollama esté corriendo: ollama serve. Y que el modelo esté descargado: ollama pull qwen2.5-coder:14b

El modelo no entiende el contexto

Añade más archivos al contexto con /add. Aider solo ve los archivos que le añades explícitamente.

Aider sugiere cambios incorrectos

Puedes revertir con /undo. También puedes usar --no-auto-commits para revisar antes de commitear.

Error: 'Model not found for provider'

Verifica que el nombre del modelo sea correcto. Ejemplo: aider --model claude-opus-4.5 (no 'claude-opus').

Consumo excesivo de tokens

Usa --max-chat-history-tokens para limitar el contexto histórico. O usa /clear para reiniciar el contexto.

Preguntas frecuentes

¿Puedo usar varios proveedores a la vez?

Si, la mayoria de herramientas permiten configurar multiples modelos. Puedes usar uno rapido (Haiku, GPT-4o-mini) para tareas simples y uno potente (Opus, GPT-5) para tareas complejas.

¿Funciona sin conexion a internet?

Solo si usas modelos locales con Ollama, LM Studio o llama.cpp. Los modelos en la nube requieren conexion permanente.

¿Cual es el mejor proveedor para empezar?

OpenRouter: una sola API key, 300+ modelos, facturación consolidada. Puedes probar todos los modelos sin comprometerte con uno.

¿Como protejo mis API keys?

Usa variables de entorno (export CLAVE=valor), nunca las incluyas en el codigo, anade .env a .gitignore, y usa un gestor de secrets como 1Password o Bitwarden.

¿Puedo compartir mi configuracion con el equipo?

Comparte el archivo de configuracion sin las API keys. Usa variables de entorno para los secrets y documenta que variables necesita cada miembro del equipo.

Comparativa: como se compara con otras herramientas

Cada herramienta de IA tiene sus fortalezas. La mejor eleccion depende de tu flujo de trabajo: si trabajas en terminal, busca un agente CLI; si usas IDE, busca una extension; si valoras la privacidad, busca soporte para modelos locales como Ollama.

Configuracion avanzada

La mayoria de herramientas de IA ofrecen opciones de configuracion avanzada que mejoran la productividad:

• Archivo de reglas de proyecto: define el estilo de codigo, frameworks y convenciones para que la IA los siga automaticamente.
• Variables de entorno: usa export CLAVE=valor para configurar API keys, URLs base, y opciones de red.
• Multi-modelo: configura un modelo rapido para tareas simples y uno potente para tareas complejas.
• Logs y debug: activa logging detallado para diagnosticar problemas de conexion o rendimiento.
• Modo offline: si usas modelos locales, configura la herramienta para funcionar sin conexion a internet.

Ejemplos de uso reales

Estos son prompts reales que puedes usar para empezar a trabajar inmediatamente con tu herramienta recien instalada. Copia y pega, adapta segun tu proyecto:

# 1. Prompt de ejemplo para desarrollo
"Implementa un endpoint REST para gestion de usuarios con:
- CRUD completo con validacion de datos
- Autenticacion JWT con refresh tokens
- Tests unitarios y de integracion
- Documentacion OpenAPI"

# 2. Prompt de ejemplo para debugging
"El siguiente error ocurre en produccion: TypeError: Cannot read property 'id' of undefined
en src/services/userService.ts:45
Encuentra la causa raiz, propon una solucion y escribe un test que prevenga la regresion."

# 3. Prompt de ejemplo para documentacion
"Genera documentacion tecnica completa para el proyecto incluyendo:
- README con instrucciones de instalacion y uso
- JSDoc para todas las funciones exportadas
- Diagrama de arquitectura en Mermaid
- Guia de contribucion"

# 4. Prompt de ejemplo para testing
"Crea tests unitarios para el modulo de pagos cubriendo:
- Happy path: pago exitoso con tarjeta valida
- Error: tarjeta rechazada por fondos insuficientes
- Edge case: timeout de conexion con Stripe
- Seguridad: token de tarjeta invalido"

Bonus: Potencia Aider con 1136 skills de SKILLSBUNDLE

Ahora que Aider funciona perfectamente con tu proveedor de IA favorito, es momento de llevarlo al siguiente nivel. SKILLSBUNDLE te ofrece 1136 skills profesionales listos para usar.

Los skills son archivos de instrucciones que tu herramienta carga automaticamente segun el contexto. Con SKILLSBUNDLE obtienes:

• 40 verticales: marketing, finanzas, desarrollo web, SEO, diseno, y mas
• 15 tipos de uso: creacion de contenido, analisis de datos, automatizacion
• Skills transversales: code review, testing, documentacion, seguridad
• Optimizados y probados: cada skill ha sido refinado para dar resultados consistentes

Instalar los skills es directo:

# 1. Compra SKILLSBUNDLE en skillsbundle.com
# 2. Descarga skills.zip
# 3. Descomprime y copia las skills al directorio de tu herramienta
unzip skills.zip -d ~/skillsbundle-pack
cp -r ~/skillsbundle-pack/skills/* ~/aider/skills/
# 4. Verifica
ls ~/aider/skills/ | wc -l   # Deberias ver 1136

Una vez copiados, cada vez que uses Aider con un prompt que toque una vertical, la skill correspondiente se cargara automaticamente.

Incluye 1136 skills, actualizaciones gratuitas y soporte prioritario