Aider es la herramienta de codificación con IA de terminal de código abierto que constantemente ocupa los primeros lugares en los puntos de referencia de codificación. Es agnóstica respecto al modelo, nativa de git y cuesta solo lo que gastas en llamadas a API — sin suscripción. Esta guía te lleva desde la instalación hasta un flujo de trabajo productivo.
Instalación
# Recomendado: pipx (entorno aislado)
pipx install aider-chat
# Alternativa: pip
pip install aider-chat
# Verificar
aider --version
Aider requiere Python 3.9+ y git instalado en tu ruta.
Configuración de Claves de API
Aider funciona con prácticamente cualquier LLM. Configura el/los que desees:
# Anthropic (Claude)
export ANTHROPIC_API_KEY=sk-ant-xxxxx
# OpenAI (GPT-4o)
export OPENAI_API_KEY=sk-xxxxx
# Google (Gemini)
export GEMINI_API_KEY=xxxxx
# Para modelos locales vía Ollama
# No se necesita clave de API — Aider se conecta a localhost:11434
Añade estos a tu .bashrc, .zshrc o configuración de shell para que persistan.
Tu Primera Sesión
cd your-project
aider
Aider se inicia, indexa tu repositorio y construye un mapa de tu base de código. Verás un prompt donde puedes escribir comandos o instrucciones en lenguaje natural.
Añade archivos a la conversación:
/add src/routes/users.ts src/services/userService.ts
Solo los archivos añadidos pueden ser editados por Aider. Otros archivos en el repositorio son visibles como referencia (a través del mapa del repositorio) pero no serán modificados.
Describe lo que quieres:
Add email validation to the user registration endpoint.
Use Zod for validation and return a 400 error with a clear
message if the email format is invalid or the domain doesn't
have MX records.
Aider edita los archivos, te muestra el diff y crea un commit de git con un mensaje descriptivo. Cada cambio es un commit — tu historial de git se mantiene limpio.
Elegir el Modelo Correcto
La flexibilidad de modelos de Aider es una de sus mayores fortalezas. Inicia con un modelo específico:
# Claude Sonnet (mejor en general para la mayoría de tareas)
aider --model claude-sonnet-4-20250514
# Claude Opus (razonamiento pesado, refactorización compleja)
aider --model claude-opus-4-20250514
# GPT-4o (rápido, bueno para tareas más simples)
aider --model gpt-4o
# DeepSeek (modelo de codificación fuerte, costo más bajo)
aider --model deepseek/deepseek-coder
# Modelo local vía Ollama
aider --model ollama/codellama:34b
Estrategia rentable: Usa Claude Sonnet como tu predeterminado. Cambia a Opus solo para trabajo arquitectónico complejo. Usa modelos locales para refactorizaciones simples y trabajo exploratorio donde la calidad puede ser menor pero no quieres costos de API.
Archivo de Configuración
Crea .aider.conf.yml en la raíz de tu proyecto para configuraciones persistentes:
# Modelo predeterminado
model: claude-sonnet-4-20250514
# Auto-commit de cambios (predeterminado: true)
auto-commits: true
# Mostrar diffs en el chat
show-diffs: true
# Codificación para tus archivos
encoding: utf-8
# Archivos a incluir siempre
read:
- README.md
- ARCHITECTURE.md
# Modo oscuro para la interfaz de terminal
dark-mode: true
# Estilo de mensaje de commit de git
attribute-author: false
attribute-committer: false
Comandos Esenciales
Los comandos comienzan con / en el prompt de Aider:
/add file.ts — añadir archivo al contexto editable
/drop file.ts — eliminar archivo del contexto
/read-only file.ts — añadir solo como referencia (no editable)
/ls — listar archivos en contexto
/tokens — mostrar uso de tokens y costos
/undo — deshacer el último cambio (git reset)
/diff — mostrar cambios sin confirmar actuales
/test npm test — ejecutar pruebas y corregir fallos
/lint npm run lint — ejecutar linter y corregir problemas
/run <command> — ejecutar cualquier comando de shell
/clear — limpiar historial de conversación
/model <name> — cambiar modelo en mitad de sesión
/help — listar todos los comandos
El Flujo de Trabajo de Git que Hace Especial a Aider
Cada edición que Aider hace crea un commit de git. Esto significa:
# Ver qué hizo Aider
git log --oneline -10
# ¿No te gusta el último cambio? Deshaz al instante
/undo
# ¿Quieres revisar todos los cambios generados por IA?
git log --author="aider" --oneline
# Cherry-pick de cambios específicos
git cherry-pick <commit-hash>
# Squash de múltiples commits de Aider antes de hacer push
git rebase -i HEAD~5
Este enfoque nativo de git significa que nunca estás atrapado con una salida de IA deficiente. La reversión siempre está a un comando de distancia.
Flujos de Trabajo Avanzados
Desarrollo Dirigido por Pruebas con Aider
/test npm test
Here are the failing tests. Fix the implementation in
src/services/orderService.ts to make all tests pass.
Don't modify the test files.
Aider lee los fallos de prueba, entiende qué se espera y corrige la implementación. Si las pruebas aún fallan, itera automáticamente.
Refactorización de Múltiples Archivos
/add src/api/*.ts src/services/*.ts src/types/*.ts
Refactor all API routes to use a consistent error handling pattern:
1. Wrap each handler in a tryCatch utility
2. Use typed AppError class for known errors
3. Log unexpected errors to console.error with request ID
4. Return { error: string, code: string, requestId: string }
Apply this to all route files. Keep the business logic unchanged.
Aider procesa cada archivo sistemáticamente, aplicando el mismo patrón consistentemente.
Usando Contexto Web
/web https://supabase.com/docs/reference/javascript/auth-signup
Implement user registration using this Supabase auth approach.
Follow the official documentation pattern.
Aider extrae la página y la usa como contexto. Esto es útil para implementar características basadas en documentación actual en lugar de datos de entrenamiento.
Codificación por Voz
aider --voice
Aider soporta entrada de voz. Describe tus cambios hablando en lugar de escribir. Útil para instrucciones complejas donde hablar es más rápido que escribir.
Gestión de Costos
Ya que pagas por llamada de API, monitorear costos es importante:
/tokens
Muestra el uso de tokens de la sesión actual y el costo estimado. Estrategias para mantener costos bajos:
- Añade solo archivos relevantes — no hagas
/addde todo tu proyecto - Usa el mapa del repositorio — Aider referencia otros archivos automáticamente sin añadirlos al contexto editable
- Cambia a modelos más baratos para tareas simples
- Usa
/clearpara reiniciar el contexto al cambiar de tarea - Usa modelos locales (Ollama) para trabajo exploratorio y ediciones simples
Un día típico de uso activo de Aider con Claude Sonnet podría costar $2-5 en tarifas de API. Mucho menos que una suscripción mensual a Cursor si eres consciente de los costos.
Hacer que Aider Funcione para Equipos
Para uso en equipo:
- Confirma
.aider.conf.ymlen el repositorio para que todos usen la misma configuración - Añade
ARCHITECTURE.mdcon documentación del sistema de alto nivel que Aider pueda referenciar - Establece una convención para mensajes de commit de Aider para que sean identificables en el historial de git
- Usa comandos
/testy/lintpara asegurar que los cambios de IA cumplan tus estándares de calidad antes de hacer push
¿Qué combinaciones de modelo y flujo de trabajo funcionan mejor para ti? Comparte tu configuración de Aider. 