Aider: Programa con IA desde la Terminal (Alternativa Barata a Cursor)

Cursor cuesta $20/mes. GitHub Copilot otros $10. Si los dos te parecen caros o se te agotan las peticiones premium, hay una alternativa open source que usa tu propia API key: Aider.

Funciona desde la terminal, edita archivos directamente, hace auto-commits en Git y soporta cualquier modelo de IA. Y pagas solo por los tokens que consumes.

¿Por qué Aider en vez de un IDE con IA?

Característica	Aider	Cursor	Copilot
Precio	Tu API key (pago por uso)	$20/mes (Pro)	$10/mes
Modelo	Cualquiera (OpenAI, Claude, Gemini, Ollama, DeepSeek)	Limitado al plan	GPT-4o + Claude
Funciona por SSH	✅ Perfecto	❌ No	⚠️ Parcial
Git integrado	✅ Auto-commit cada cambio	❌ Manual	❌ Manual
Consumo de tokens	Optimizado (repo map)	Variable	Variable
Límite de peticiones	Sin límite (tu API key)	Cuota mensual	Cuota mensual
Open source	✅ 100%	❌	❌

El caso de uso ideal de Aider: eres un dev que programa mucho con IA y se te acaba la cuota de Cursor a mitad de mes. O trabajas por SSH en servidores y no puedes usar un IDE con IA.

Para una comparativa más detallada de editores, lee Cursor vs Copilot vs Windsurf.

Instalación

Requisitos

• Python 3.10+
• Git
• Una API key (OpenAI, Anthropic o modelo local con Ollama)

Instalar Aider

# Instalar via pip
pip install aider-chat

# O con pipx (recomendado — no contamina tu entorno)
pipx install aider-chat

# Verificar
aider --version

Configurar tu API key

# Para OpenAI
export OPENAI_API_KEY=sk-...

# Para Anthropic (Claude)
export ANTHROPIC_API_KEY=sk-ant-...

# Windows PowerShell
$env:OPENAI_API_KEY = "sk-..."

Tu primera sesión con Aider

# Entra al directorio de tu proyecto
cd mi-proyecto

# Iniciar Aider con GPT-4.1 (buen balance precio/calidad)
aider --model gpt-4.1

# Se abre una sesión interactiva
# ──────────────────────────
# Aider v0.82.0
# Model: gpt-4.1 with diff edit format
# Git repo: .git with 47 files
# Repo-map: using 1024 tokens
# ──────────────────────────

Comandos esenciales

# Añadir archivos al contexto
/add src/auth/login.ts src/auth/types.ts

# Pedir un cambio (Aider edita los archivos directamente)
> Añade validación de email en el login antes de llamar a la API

# Aider edita login.ts, muestra el diff y hace auto-commit

# Deshacer el último cambio
/undo

# Ver qué archivos están en contexto
/ls

# Cambiar de modelo en caliente
/model claude-sonnet-4

# Salir
/exit

Configuración optimizada para ahorrar tokens

1. Limitar el repo map

Aider genera un “mapa” de tu repositorio (funciones, clases, exports) para que la IA entienda la estructura sin enviar todo el código. Limita los tokens del mapa:

# Por defecto usa ~1024 tokens de mapa. Para proyectos grandes:
aider --map-tokens 512

# Para proyectos pequeños, puedes desactivarlo
aider --map-tokens 0

2. Añadir solo los archivos necesarios

# ❌ No hagas esto (envía todo al contexto)
aider --model gpt-4.1 .

# ✅ Añade solo lo que vas a editar
aider --model gpt-4.1
/add src/auth/login.ts
/add src/auth/middleware.ts

3. Usar modelos diferentes por tarea

# Tarea simple → modelo barato
aider --model gpt-4.1-nano
> genera tests unitarios para esta función

# Tarea compleja → modelo potente
aider --model claude-sonnet-4
> refactora este módulo para soportar multi-tenencia

4. Combinar con caveman prompting

Los prompts que escribes en Aider también consumen tokens. Usa caveman prompting:

# ❌ Prompt largo
> Por favor, podrías crear una función que reciba un array de usuarios 
> y devuelva solo los que tienen el campo "activo" en true, ordenados 
> por fecha de registro de más reciente a más antiguo?

# ✅ Caveman
> fn: filtrar usuarios activos, ordenar por fecha desc

Usar Aider con modelos locales (gratis)

Si tienes Ollama instalado, puedes usar Aider completamente gratis:

# Instalar Ollama y descargar modelo
ollama pull deepseek-coder-v3:16b

# Usar Aider con modelo local
aider --model ollama/deepseek-coder-v3:16b

# O con Qwen (más ligero, 8GB RAM)
aider --model ollama/qwen2.5-coder:7b

¿Cuándo usar local vs API?

Tarea	Modelo local	API
Añadir docstrings	✅ Perfecto	Innecesario
Generar tests simples	✅ Suficiente	Innecesario
Renombrar variables	✅ Perfecto	Innecesario
Refactoring complejo	❌ Limitado	✅ Claude/GPT-4.1
Nuevo módulo desde cero	❌ Poca calidad	✅ Necesario
Debugging de errores raros	❌ No tiene contexto	✅ Mejor con API

Flujo de trabajo real: mi día con Aider

# Mañana: empezar feature con modelo potente
aider --model gpt-4.1
/add src/payments/stripe.ts src/payments/types.ts
> implementa checkout con Stripe. soporta: tarjeta, SEPA, Apple Pay

# Aider genera el código, lo reviso, y hace commit automático
# git log: "feat: implement Stripe checkout with card, SEPA, Apple Pay"

# Tarde: tests y refactoring con modelo barato
aider --model gpt-4.1-nano
/add src/payments/stripe.test.ts
> genera tests para stripe.ts. cobertura: happy path + errores de pago

# Noche: debugging con modelo potente si hace falta
aider --model claude-sonnet-4
/add src/payments/stripe.ts src/payments/webhook.ts
> el webhook de Stripe falla con "signature verification failed". debug + fix

Comparativa de costes real: Aider vs Cursor

Medí mi uso real durante 4 semanas:

Semana típica: ~150 consultas

Herramienta	Coste semanal	Coste mensual
Cursor Pro	$5.00 (fijo)	$20.00
Aider + GPT-4.1	~$2.40	~$9.60
Aider + GPT-4.1 nano (simple) + GPT-4.1 (complejo)	~$1.20	~$4.80
Aider + Ollama (simple) + GPT-4.1 (complejo)	~$0.80	~$3.20

Uso intensivo: ~500 consultas/semana

Herramienta	Coste semanal	Coste mensual
Cursor Pro	$5-10 (cuota extra)	$20-40
Aider + GPT-4.1	~$7.50	~$30
Aider mixto (nano + 4.1 + local)	~$3.50	~$14

Conclusión: para hasta ~300 consultas/mes, Cursor y Aider cuestan parecido. Para más, Aider mixto gana siempre.

Archivo de configuración .aider.conf.yml

Crea este archivo en la raíz de tu proyecto para no repetir flags:

# .aider.conf.yml
model: gpt-4.1
map-tokens: 768
auto-commits: true
git-commit-verify: true
dark-mode: true
stream: true

# Archivos que Aider nunca debe tocar
ignore:
  - "*.lock"
  - "dist/**"
  - "node_modules/**"
  - ".env"

Integraciones útiles

Con VS Code (como extensión)

# Aider tiene extensión experimental para VS Code
code --install-extension aider.aider

Con tmux/screen (sesiones persistentes)

# Iniciar en tmux para no perder la sesión
tmux new -s aider
aider --model gpt-4.1

# Desconectar: Ctrl+B, D
# Reconectar: tmux attach -t aider

Con scripts de CI/CD

# Aider en modo no-interactivo para automatización
aider --model gpt-4.1-nano --no-auto-commits --message "actualiza deps y fix breaking changes" --yes

Troubleshooting

Error: “Model not found”

# Verifica que el modelo existe
aider --list-models openai/

# Si usas Ollama, verifica que está corriendo
ollama list

Aider edita archivos incorrectos

# Sé específico con los archivos en contexto
/drop *  # Quita todo
/add src/specific-file.ts  # Añade solo lo necesario

Tokens consumidos más de lo esperado

# Revisa cuántos tokens usa el repo map
/tokens

# Reduce el mapa si es muy grande
/map-tokens 256

Si te encuentras errores de rate limit, consulta cómo solucionar el error 429 Too Many Requests.

Conclusión

Aider no reemplaza a Cursor para todos — si te gusta la UX visual y no te importa el coste fijo, Cursor está bien. Pero si:

• Quieres control total sobre qué modelo usas y cuánto pagas
• Trabajas mucho por SSH o terminal
• Se te agotan las peticiones de Cursor/Copilot
• Quieres auto-commits limpios en Git

Aider es la herramienta. Con el setup correcto (modelo mixto + caveman + local para lo simple), puedes programar con IA por $5-15/mes sin límites.

Para ver todos los repos que complementan Aider, revisa los 7 repos de GitHub imprescindibles para devs de IA. Y para la guía completa de ahorro, lee cómo programar con IA sin arruinarte.