Tutorial de configuración de Aider

Contenido actualizado: 2026-06-09

Aider es una herramienta muy útil para la programación en pareja desde la terminal, ideal para realizar modificaciones en pasos pequeños dentro de un repositorio Git, revisar diferencias, agregar archivos de contexto y realizar correcciones por rondas. Al integrar con Crazyrouter, la forma más confiable es usar la configuración compatible con OpenAI oficialmente soportada por Aider.

Resumen

Mediante variables de entorno o ~/.aider.conf.yml, Aider puede enviar solicitudes a Crazyrouter:

Protocolo recomendado: OpenAI-compatible API
URL Base: https://api.crazyrouter.com/v1
Variable de autenticación: OPENAI_API_KEY
Modelo predeterminado recomendado: gpt-5.5

Si tu flujo de trabajo diario es “leer código -> modificar algunos puntos -> revisar las diferencias -> ajustar de nuevo”, Aider suele ser una de las herramientas de codificación en terminal más ligeras y fáciles de implementar de forma estable.

¿A quién está dirigido?

Personas que quieran realizar modificaciones de código con pequeños commits desde la terminal
Quienes prefieran controlar de manera clara los archivos de contexto, diferencias y ritmo de commits
Usuarios que deseen separar la facturación de Aider de Codex o Claude Code
Quienes prefieran integrar Crazyrouter utilizando primero el método compatible con OpenAI más directo

Protocolo de uso

Protocolo recomendado: OpenAI-compatible API Aider soporta oficialmente las siguientes opciones de configuración:

OPENAI_API_KEY
OPENAI_API_BASE
openai-api-key
openai-api-base

Sintaxis correspondiente en Crazyrouter:

OPENAI_API_BASE=https://api.crazyrouter.com/v1

También ten en cuenta: El nombre del modelo en Crazyrouter es el ID original que se muestra en la lista de modelos y la página de precios, por ejemplo gpt-5.5 y claude-opus-4-8. En Aider, también debes usar directamente este ID de modelo:

gpt-5.5

No añadas el prefijo openai/ a los nombres de modelos de Crazyrouter. openai/gpt-5.5 no es un nombre de modelo válido aquí y causará model not found o canales no disponibles.

Requisitos del sistema y condiciones previas

Elemento	Descripción
Cuenta Crazyrouter	Regístrate primero en crazyrouter.com
Token Crazyrouter	Se recomienda crear un token exclusivo para Aider
Git	Se recomienda `git 2.23+`
Python	Si usas el método `aider-install`, ten previamente `Python 3.8-3.13`; si usas el instalador automático oficial, este instalará Python 3.12 según lo requiera
Aider	Se recomienda la versión estable más actual
Repositorio Git	Aider funciona mejor dentro de un repositorio Git
Modelos disponibles	Debes habilitar al menos un modelo de codificación

Lista blanca recomendada inicial:

gpt-5.5
claude-opus-4-8
gemini-3.1-pro

Instalación completa según el sistema operativo

Ruta recomendada para Windows

El procedimiento más confiable en Windows es: Git + Python + Instalar Aider con PowerShell + Configurar variables de entorno con PowerShell. Orden sugerido:

Instalar Git
Instalar Python
Ejecutar el script de instalación oficial de Aider en PowerShell, o instalar aider-install primero
Definir variables temporales en PowerShell
Definir variables de usuario permanentes en PowerShell
Abrir una nueva terminal y confirmar que aider comando y las variables funcionen correctamente

Comando de verificación sugerido:

git --version
python --version
pip --version
aider --version
where.exe git
where.exe python
where.exe aider

Si aider --version no reconoce el comando, cierra y vuelve a abrir PowerShell, luego vuelve a intentar.

Ruta recomendada para macOS

En macOS, lo más sencillo suele ser: Xcode Command Line Tools + Homebrew + Git + Python + Script oficial de instalación de Aider + ~/.zshrc para la persistencia de las variables de entorno. Orden sugerido:

Instalar Xcode Command Line Tools
Instalar Homebrew (si aún no lo tienes)
Instalar Git y Python
Ejecutar el script de instalación oficial de Aider, o instalar a través de aider-install / uv
Registrar ~/.zshrc
Abrir una nueva terminal y confirmar las rutas de comando y variables aider

Comando de verificación sugerido:

git --version
python3 --version
pip3 --version
aider --version
which git
which python3
which aider

Notas para Linux

En Linux se puede seguir el método de terminal para macOS, solo que normalmente las variables permanentes se escriben en ~/.bashrc. Si es la primera vez que conectas una máquina de desarrollo local o en la nube, prueba primero con variables temporales en la shell actual y decide posteriormente si las haces permanentes.

Instalación completa desde cero

Paso 1: Instalar Git

Si la máquina no tiene Git, instálalo primero.

Windows PowerShell
macOS
Ubuntu / Debian

winget install --id Git.Git -e --source winget
git --version
where.exe git

xcode-select --install
git --version

O bien:

brew install git
git --version
which git

sudo apt update
sudo apt install -y git
git --version
which git

Se recomienda completar:

git config --global user.name "Your Name"
git config --global user.email "you@example.com"
git config --global init.defaultBranch main

Paso 2: Instalar Python y pip

El instalador oficial de Aider utilizará Python o preparará automáticamente su propio entorno de Python. Para evitar problemas, confirma primero que Python está disponible en tu máquina.

Windows PowerShell
macOS
Ubuntu / Debian

winget install Python.Python.3.12
python --version
pip --version
where.exe python

brew install python
python3 --version
pip3 --version
which python3

sudo apt update
sudo apt install -y python3 python3-pip python3-venv
python3 --version
pip3 --version
which python3

Paso 3: Instalar Aider

El script de instalación rápida recomendado oficialmente por Aider es el siguiente.

Windows PowerShell
macOS / Linux

powershell -ExecutionPolicy ByPass -c "irm https://aider.chat/install.ps1 | iex"
aider --version
where.exe aider

curl -LsSf https://aider.chat/install.sh | sh
aider --version
which aider

Si prefieres ver de antemano el proceso de instalación, también puedes seguir la ruta aider-install de la documentación oficial de Aider:

Windows PowerShell
macOS / Linux

python -m pip install aider-install
aider-install
aider --version

python3 -m pip install aider-install
aider-install
aider --version

Si tu equipo ya usa uv, sigue la documentación oficial para instalar de esta forma:

python -m pip install uv
uv tool install --force --python python3.12 --with pip aider-chat@latest
aider --version

No se recomienda agregar pip install aider-chat manualmente al entorno del sistema desde el principio. Es preferible usar el script de instalación, aider-install o uv, para una mejor separación de dependencias.

Paso 4: Crear un token dedicado para Aider en Crazyrouter

Crea un token denominado aider en el panel de Crazyrouter. Para la primera vez, solo añade permisos para:

gpt-5.5
claude-opus-4-8
gemini-3.1-pro

Aquí debes colocar los nombres originales de los modelos de Crazyrouter en la lista blanca, sin añadir el prefijo openai/.

Paso 5: Configurar variables de entorno temporales en la terminal actual

Primero configura temporalmente; tras verificar que funciona, escribe la configuración permanente.

macOS / Linux
Windows PowerShell

export OPENAI_API_KEY=sk-xxx
export OPENAI_API_BASE=https://api.crazyrouter.com/v1
echo $OPENAI_API_KEY
echo $OPENAI_API_BASE

$env:OPENAI_API_KEY = "sk-xxx"
$env:OPENAI_API_BASE = "https://api.crazyrouter.com/v1"
echo $env:OPENAI_API_KEY
echo $env:OPENAI_API_BASE

Paso 6: Guardar las variables de entorno en configuración persistente

Linux Bash
macOS / Zsh
Windows PowerShell

echo 'export OPENAI_API_KEY=sk-xxx' >> ~/.bashrc
echo 'export OPENAI_API_BASE=https://api.crazyrouter.com/v1' >> ~/.bashrc
source ~/.bashrc
echo $OPENAI_API_BASE

echo 'export OPENAI_API_KEY=sk-xxx' >> ~/.zshrc
echo 'export OPENAI_API_BASE=https://api.crazyrouter.com/v1' >> ~/.zshrc
source ~/.zshrc
echo $OPENAI_API_BASE

[System.Environment]::SetEnvironmentVariable("OPENAI_API_KEY", "sk-xxx", "User")
[System.Environment]::SetEnvironmentVariable("OPENAI_API_BASE", "https://api.crazyrouter.com/v1", "User")

$env:OPENAI_API_KEY = "sk-xxx"
$env:OPENAI_API_BASE = "https://api.crazyrouter.com/v1"

echo $env:OPENAI_API_BASE

Una vez persistente, se recomienda abrir una nueva terminal y ejecutar nuevamente:

Windows PowerShell
macOS / Linux

aider --version
echo $env:OPENAI_API_BASE

aider --version
echo $OPENAI_API_BASE

Paso 7: Opcionalmente agregar configuración en ~/.aider.conf.yml

Si no quieres añadir parámetros manualmente cada vez, puedes crear un archivo de configuración.

macOS / Linux
Windows PowerShell

cat > ~/.aider.conf.yml <<'EOF'
model: gpt-5.5
openai-api-base: https://api.crazyrouter.com/v1
EOF
cat ~/.aider.conf.yml

@'
model: gpt-5.5
openai-api-base: https://api.crazyrouter.com/v1
'@ | Set-Content -Path "$HOME/.aider.conf.yml"

Get-Content $HOME/.aider.conf.yml

Si te preocupa más la seguridad, puedes colocar la clave solo en variables de entorno y dejar únicamente model y openai-api-base en el archivo de configuración.

Paso 8: Preparar el repositorio Git y hacer la primera instantánea

Aider funciona mejor dentro de un repositorio Git. Si el directorio actual no es un repo Git:

git init
git add .
git commit -m "chore: initial snapshot before Aider"

Si ya es un repositorio existente, mira primero:

git status

Paso 9: Iniciar Aider y completar la primera validación

Después de entrar en el directorio del proyecto, ejecuta:

cd /path/to/your/project
aider --model gpt-5.5

Para la primera verificación, sigue este orden:

Resume únicamente la estructura del repositorio actual, sin modificar archivos
Lee el README y sugiere cambios mínimos, sin aplicarlos todavía
Confirma que puedes ver correctamente el diff antes de realizar cambios mayores

Si quieres probar temporalmente otro modelo, utiliza el mismo formato, por ejemplo aider --model claude-opus-4-8.

Configuración recomendada de modelos

Escenario de uso	Sintaxis recomendada en Aider	Motivo
Codificación principal por defecto	`gpt-5.5`	Usa el ID original del modelo de Crazyrouter, ideal para la compatibilidad base con OpenAI en Aider
Alternativa al estilo Claude	`claude-opus-4-8`	Adecuado para explicaciones de contexto extenso y colaboración estable de múltiples rondas
Gemini como respaldo	`gemini-3.1-pro`	Útil como segunda vía de verificación de compatibilidad

Primero utiliza gpt-5.5; después de verificar el funcionamiento, agrega claude-opus-4-8 o gemini-3.1-pro según el escenario.

Mejores prácticas para la configuración de Token

Configuración	Recomendación	Descripción
Token exclusivo	Obligatorio	No compartas el token de Aider con otros IDE o CLI
Lista blanca de modelos	Muy recomendado	Mantén el conjunto mínimo de modelos para evitar uso accidental de modelos de alto costo
Restricción por IP	Activa según el entorno	Habilítalo para servidores fijos; úsalo con precaución en equipos móviles
Límite de cuota	Muy recomendado	Las sesiones largas y múltiples rondas de corrección pueden consumir el límite rápidamente
Aislamiento de entornos	Recomendado	Usa tokens separados para desarrollo local, máquinas remotas y CI
Gestión de fugas	Cambiar inmediatamente	Si se filtra en `.aider.conf.yml`, historial de shell o grabación de pantalla, cambia la clave enseguida

Lista de comprobación de la verificación

Errores comunes y soluciones

Síntoma	Causa común	Solución
`aider: command not found`	Aider no instalado correctamente, o el instalador no añadió el ejecutable al PATH	Vuelve a ejecutar el instalador oficial y abre una nueva terminal antes de intentarlo nuevamente
Confusión de versiones de Python	Conflicto entre el Python del sistema y el entorno de ejecución de Aider	Usa preferentemente el script de instalación, `aider-install` o `uv` y no mezcles dependencias manualmente
401 unauthorized	API Key incorrecto, expirado o incompleto	Genera un nuevo token y vuelve a configurar
403 / model not allowed	El token no tiene permitido el modelo actual	Agrega el modelo en la configuración del token de Crazyrouter
404	URL Base incorrecta, falta `/v1`	Corrige a `https://api.crazyrouter.com/v1`
`model not found`	Nombre de modelo incorrecto, uso de un prefijo `openai/` inexistente, o el modelo no está habilitado	Usa el ID de modelo original presente en la página de precios o lista de modelos, ejemplo `gpt-5.5` o `claude-opus-4-8`
Inconsistencias en archivo de configuración y variables de entorno	Conflicto de configuración en ambos lugares	Deja una sola fuente principal de configuración y reinicia Aider
Coste sube demasiado rápido	Sesiones largas o exceso de archivos de contexto	Limpia el contexto puntualmente y limita la cuota de tokens

Consejos sobre rendimiento y costes

Al iniciar, valida primero en un repositorio pequeño
Por defecto usa gpt-5.5; añade claude-opus-4-8 solo para pruebas cruzadas
Recomienda separar tokens por tipo de proyecto para facilitar la gestión de costes
Si la sesión se extiende demasiado, limpia el contexto y evita cargar archivos innecesarios repetidas veces
Después de grandes cambios, revisa siempre el diff generado por Aider y los logs de Crazyrouter

Preguntas frecuentes

¿Qué Base URL debo poner en Aider?

Pon https://api.crazyrouter.com/v1.

¿Por qué no debe escribirse el modelo como `openai/gpt-5.5`?

Porque los modelos de Crazyrouter no llevan prefijo de proveedor; aquí se reconoce el ID original del modelo como gpt-5.5. openai/gpt-5.5 será considerado otro modelo, el cual no existe en esta plataforma.

¿Es mejor usar variables de entorno o archivos de configuración?

Ambos funcionan. Para comenzar, las variables de entorno son más rápidas; para uso prolongado, agrega también ~/.aider.conf.yml.

¿Por qué se recomienda hacer un snapshot de Git la primera vez?

Porque Aider modifica archivos, genera diferencias y realiza o sugiere commits automáticos. Si tienes un snapshot previo, será más fácil diagnosticar problemas y revertir cambios.

¿Cuál es el primer modelo recomendado?

Empieza con gpt-5.5.

¿Es obligatorio usar Aider dentro de un repositorio Git?

No es estrictamente necesario, pero la experiencia es mucho mejor y la revisión de cambios más sencilla dentro de un repositorio Git.

Si buscas una herramienta de terminal muy ligera y especialmente adecuada para hacer pequeños cambios frecuentes en tu código, Aider sigue siendo una opción prioritaria dentro de las guías de apps para Crazyrouter.

Páginas relacionadas

Guía de integración de Aider (instalación rápida, Base URL, modelos recomendados)

Claves API y gestión de la consola

SDK y ejemplos de código

Integraciones

Tutorial de configuración de Aider

Resumen

¿A quién está dirigido?

Protocolo de uso

Requisitos del sistema y condiciones previas

Instalación completa según el sistema operativo

Ruta recomendada para Windows

Ruta recomendada para macOS

Notas para Linux

Instalación completa desde cero

Configuración recomendada de modelos

Mejores prácticas para la configuración de Token

Lista de comprobación de la verificación

Errores comunes y soluciones

Consejos sobre rendimiento y costes

Preguntas frecuentes

¿Qué Base URL debo poner en Aider?

¿Por qué no debe escribirse el modelo como `openai/gpt-5.5`?

¿Es mejor usar variables de entorno o archivos de configuración?

¿Por qué se recomienda hacer un snapshot de Git la primera vez?

¿Cuál es el primer modelo recomendado?

¿Es obligatorio usar Aider dentro de un repositorio Git?

Páginas relacionadas

​Resumen

​¿A quién está dirigido?

​Protocolo de uso

​Requisitos del sistema y condiciones previas

​Instalación completa según el sistema operativo

​Ruta recomendada para Windows

​Ruta recomendada para macOS

​Notas para Linux

​Instalación completa desde cero

​Configuración recomendada de modelos

​Mejores prácticas para la configuración de Token

​Lista de comprobación de la verificación

​Errores comunes y soluciones

​Consejos sobre rendimiento y costes

​Preguntas frecuentes

​¿Qué Base URL debo poner en Aider?

​¿Por qué no debe escribirse el modelo como openai/gpt-5.5?

​¿Es mejor usar variables de entorno o archivos de configuración?

​¿Por qué se recomienda hacer un snapshot de Git la primera vez?

​¿Cuál es el primer modelo recomendado?

​¿Es obligatorio usar Aider dentro de un repositorio Git?

​Páginas relacionadas

Resumen

¿A quién está dirigido?

Protocolo de uso

Requisitos del sistema y condiciones previas

Instalación completa según el sistema operativo

Ruta recomendada para Windows

Ruta recomendada para macOS

Notas para Linux

Instalación completa desde cero

Configuración recomendada de modelos

Mejores prácticas para la configuración de Token

Lista de comprobación de la verificación

Errores comunes y soluciones

Consejos sobre rendimiento y costes

Preguntas frecuentes

¿Qué Base URL debo poner en Aider?

¿Por qué no debe escribirse el modelo como `openai/gpt-5.5`?

¿Es mejor usar variables de entorno o archivos de configuración?

¿Por qué se recomienda hacer un snapshot de Git la primera vez?

¿Cuál es el primer modelo recomendado?

¿Es obligatorio usar Aider dentro de un repositorio Git?

Páginas relacionadas