🚀 Conectando Aider a modelos personalizados de CodingPlanX

> Introducción: Esta guía te muestra cómo usar Aider, el popular programador en pareja de IA de código abierto, con la API de CodingPlanX.ai para una experiencia de codificación de IA basada en terminal de primer nivel.

Aider es un asistente de codificación de IA CLI líder (más de 39K estrellas en GitHub). Se ejecuta en tu terminal y admite más de 100 idiomas. Al configurar variables de entorno simples, puedes conectar Aider a CodingPlanX.ai.

✨ ¿Por qué Aider?

🆓 Completamente de código abierto: Paga solo por el uso de la API a través de CodingPlanX.ai.
🧠 Modo arquitecto: Un sistema de modelo dual donde un modelo planifica y otro escribe código.
🌳 Mapa del repositorio: Usa tree-sitter para comprender la estructura completa de tu base de código.
🔗 Integración con Git: Crea automáticamente commits descriptivos de Git para cada cambio de la IA.
⚡ Configuración mínima: Conéctate en segundos con solo dos variables de entorno.

🛠️ Instalación

1. Requisitos previos

Python 3.8+ instalado.
Clave API de CodingPlanX.ai (comienza con cr_).

2. Instalar Aider

# Recomendado: Instalar a través de pipx
pipx install aider-chat

# Alternativa: pip estándar
pip install aider-chat

⚙️ Configuración

Método 1: Variables de entorno (🌟 Recomendado)

Temporal (Sesión de terminal actual):

export OPENAI_API_BASE="https://api.codingplanx.ai/v1"
export OPENAI_API_KEY="cr_your_api_key"

Permanente (Agregar al archivo de configuración): Agrega esto a tu ~/.zshrc o ~/.bashrc:

echo 'export OPENAI_API_BASE="https://api.codingplanx.ai/v1"' &gt;&gt; ~/.zshrc
echo 'export OPENAI_API_KEY="cr_your_api_key"' &gt;&gt; ~/.zshrc
source ~/.zshrc

Método 2: Argumentos de línea de comandos

aider --openai-api-base "https://api.codingplanx.ai/v1" \
      --openai-api-key "cr_your_api_key" \
      --model openai/claude-sonnet-4-6

💻 Primeros pasos

Uso básico

cd /ruta/a/tu/proyecto

# Iniciar Aider con Claude Sonnet
aider --model openai/claude-sonnet-4-6

Modo arquitecto (🌟 Altamente recomendado)

El modo arquitecto usa un modelo "planificador" (como Opus) y un modelo "editor" (como Sonnet) para mejorar la calidad mientras se gestionan los costos.

# Enfoque de calidad: Opus planifica + Sonnet edita
aider --architect --model openai/claude-opus-4-6 --editor-model openai/claude-sonnet-4-6

⌨️ Comandos de barra inclinada comunes

Comando	Descripción
`/add file.py`	Agrega un archivo al contexto de la IA
`/drop file.py`	Elimina un archivo del contexto para ahorrar tokens
`/run pytest`	Ejecuta pruebas y devuelve errores a la IA para que los solucione
`/undo`	Revierte el último cambio de código de la IA

⚖️ Aider vs. Claude Code CLI

Característica	🤖 Aider	💻 Claude Code CLI
Código abierto	Sí	No (Propietario)
Integración con Git	Commit automático	Commit manual
Flujo de trabajo	Multimodelo (Arquitecto)	Modelo único
Contexto	Mapa del repo (AST)	Ventana masiva de tokens

❓ Resolución de problemas (Preguntas frecuentes)

P: ¿Error de "Model not found" (Modelo no encontrado)? R: Asegúrate de incluir el prefijo openai/.

✅ Correcto: openai/claude-sonnet-4-6

P: ¿Tiempo de espera de la API agotado? R: Aumenta el límite de tiempo de espera:

aider --model openai/claude-sonnet-4-6 --timeout 120