Instalación de Aider y configuración de OmniProxy

Aider es una herramienta que ayuda a modificar código desde la terminal. Crea un mapa de todo el código fuente para ayudar al modelo a entender proyectos más grandes. Git es una herramienta de control de versiones que registra los cambios en el código, permitiéndote inspeccionar las diferencias y restaurar versiones anteriores. Después de asignar una tarea a Aider, esta la procesa paso a paso y escribe mensajes de confirmación (commit). Si no te gustan los cambios, puedes deshacerlos con /undo.

Antes de comenzar

Existen dos opciones comunes de instalación:

Si tu computadora ya tiene Python 3.8 a 3.13, instala aider-install primero. Python es el entorno de ejecución requerido por Aider.
Si no tienes una versión adecuada de Python, usa el comando de instalación de una sola línea. También configurará Python 3.12 cuando sea necesario.

Mac y Linux

install.sh

Ejecutar con sh después de curl
Instala Python si es necesario
Usar wget si curl no está disponible

Windows

install.ps1

Ejecutar en PowerShell
Reabrir la terminal después de la instalación
Establecer variables de entorno con setx

Python ya instalado

aider-install

Instalar primero este paquete con pip
Luego ejecutar aider-install
Crea su propio entorno

El instalador de una sola línea configura Python 3.12 cuando es necesario. Instalar aider-chat directamente con pip es menos confiable.

Asegúrate de que OmniProxy esté en ejecución. Después de la instalación, ingresa al directorio del proyecto que planeas modificar antes de iniciar Aider.

Instalación y primer inicio

Si ya tienes Python 3.8 a 3.13

Ejecuta estos comandos en orden:

python -m pip install aider-install
aider-install

aider-install instala Aider en un entorno de Python separado para que no interfiera con otros proyectos de Python en tu computadora. Cuando es necesario, también instala Python 3.12 para que Aider lo utilice.

Instalación de una sola línea

En Mac y Linux, ejecuta:

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

Si curl no está instalado, usa:

wget -qO- https://aider.chat/install.sh | sh

En Windows PowerShell, ejecuta:

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

Estos comandos de una sola línea se basan en uv, un programa para instalar y gestionar herramientas y entornos de Python. También puedes usar el siguiente comando:

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

También puedes usar pipx. Al instalar directamente con python -m pip install aider-chat, las versiones de Python compatibles son de la 3.9 a la 3.12. Sin embargo, este es un método de instalación alternativo, por lo que es preferible usar los métodos descritos anteriormente. Los paquetes de Aider de los gestores de paquetes del sistema pueden tener discrepancias de dependencias, por lo que no deberían ser tu primera opción.

El 09-10-2026, el comando de instalación de una sola línea instaló Aider v0.86.2. Durante la instalación, es posible que veas un mensaje indicando que el caché y el destino están en discos diferentes y que los archivos se copiarán. La instalación se completará de todos modos.

Después de la instalación, ingresa al directorio del proyecto. Una API compatible es una interfaz que se comunica con otros servicios de modelos utilizando el formato de OpenAI. Inicia Aider usando este patrón:

aider --model openai/<model-name>

Reemplaza <model-name> con el ID completo del modelo copiado de OmniProxy en la siguiente sección. Un ID de modelo es el nombre utilizado para identificar un modelo con precisión.

Obtener la configuración de conexión de OmniProxy

Necesitas establecer las siguientes dos variables de entorno. Las variables de entorno pueden entenderse como un conjunto de configuraciones de conexión leídas por los programas de la terminal:

export OPENAI_API_BASE=https://your-omniproxy-origin.example/v1
export OPENAI_API_KEY=<YOUR_OMNIPROXY_API_KEY>

OPENAI_API_BASE es el punto de conexión (endpoint) de la API y debe incluir /v1. OPENAI_API_KEY es la clave utilizada para acceder a la API.

En Windows, usa setx para guardar las variables. Debes reabrir la terminal después de hacerlo:

setx OPENAI_API_BASE https://your-omniproxy-origin.example/v1
setx OPENAI_API_KEY <YOUR_OMNIPROXY_API_KEY>

Copia el nombre completo del modelo de la lista actual de OmniProxy, incluyendo cualquier barra diagonal en el ID del modelo. Al iniciar Aider, agrega openai/ antes del ID completo.

A fecha del 09-10-2026, los dos IDs de referencia en la documentación del proveedor son gemini-3.8-flash y grok-4.7. Si estos nombres no están en la lista actual, no los copies directamente. Usa un ID completo que realmente aparezca en la lista.

Dirección

OPENAI_API_BASE

Apúntalo a OmniProxy
Incluir /v1
No lo pongas en el repositorio

Clave

OPENAI_API_KEY

Usa la proporcionada por la puerta de enlace (gateway)
Reabrir terminales de Windows después de cambiarla
Mantén las claves del proveedor en la puerta de enlace

Iniciar

openai/modelo

cd al directorio del proyecto
Prefija el nombre del modelo con openai/
Usa el nombre de la lista de la puerta de enlace

Las dos variables de entorno, junto con un nombre de modelo prefijado por openai/, forman la sintaxis de API compatible.

Ingresar la configuración de la herramienta

No necesitas crear un archivo de configuración separado. Ingresa al directorio del proyecto, inicia Aider y reemplaza el ID del modelo con un nombre que realmente exista en la lista actual de OmniProxy:

cd /path/to/your/project
aider --model openai/gemini-3.8-flash

Para usar el otro modelo de ejemplo, ejecuta:

aider --model openai/grok-4.7

Cuando Aider encuentra un modelo desconocido, muestra una advertencia. Esta advertencia no significa por sí misma que el punto de conexión sea incorrecto. Revisa los registros de solicitudes de OmniProxy para confirmar si la solicitud apareció.

Aider solo agrega al contexto los archivos que ya están rastreados por Git. El contexto es el código y la información que el modelo puede leer durante la tarea actual. Si el directorio actual aún no es un repositorio de Git, Aider creará uno, pero los archivos que Git no rastrea aún no podrán ser leídos. Usa git add para agregar los archivos y confirmarlos (commit) antes de iniciar Aider.

Aider aún puede modificar archivos. --no-auto-commits solo deshabilita las confirmaciones automáticas; no impide las modificaciones de archivos. Cuando uses Aider por primera vez, elige un repositorio sin importancia y ejecuta git diff después de la tarea para revisar los cambios reales.

No pongas claves reales en archivos de proyecto o páginas públicas. Almacena las claves de los proveedores solo en OmniProxy. Si la puerta de enlace no valida las claves, puedes establecer OPENAI_API_KEY en una cadena de marcador de posición utilizada solo en tu computadora local.

Verificar con una tarea real

Primero, asegúrate de que el archivo que quieres que Aider lea haya sido confirmado en Git. Luego, ejecuta el siguiente comando desde el directorio del proyecto. Reemplaza el ID del modelo con un ID completo de la lista actual de OmniProxy:

aider --model openai/gemini-3.8-flash --message "What is the first line of this file? Do not modify the file." --no-auto-commits

--message envía una tarea directamente a Aider, mientras que --no-auto-commits le indica a Aider que no cree confirmaciones de Git automáticamente durante esta ejecución.

El 09-10-2026, Aider v0.86.2 leyó con éxito la primera línea de un archivo rastreado. Si el archivo no está rastreado por Git, Aider dirá que no puede ver el contenido. Esto no significa que el punto de conexión de la API sea incorrecto. Después de completar la consulta, revisa los registros de solicitudes de OmniProxy para verificar la fuente de la solicitud y el ID del modelo.

Iniciar

Aider se inicia

El comando está disponible
Las variables de entorno están activas
En el directorio del proyecto

Tarea

Inspeccionó el archivo

Preguntar sobre un archivo específico
Revisar su explicación
Los modelos desconocidos pueden activar una advertencia

Registros

Visibles en la puerta de enlace

La fuente es Aider
El ID del modelo coincide
La clave no se ingresó en la página

Confirma que las variables de entorno estén activas y el comando disponible, luego completa una consulta real.

Errores comunes

No se puede encontrar aider: Reabre la terminal primero. Si lo instalaste directamente con pip, intenta python -m aider.
Windows sigue conectándose al punto de conexión antiguo después de cambiar las variables: Debes reabrir la terminal después de ejecutar setx. Solo una ventana nueva leerá las variables actualizadas.
El nombre del modelo no comienza con openai/: La API compatible requiere el formato openai/<model-name>.
Aparece una advertencia de modelo desconocido: Esta es una advertencia normal y no significa que la conexión falló. Verifica si OmniProxy recibió la solicitud.
El ID del modelo no es válido: Copia el ID completo nuevamente de la lista actual de OmniProxy. Mantén el prefijo openai/ y cualquier barra diagonal ya presente en el ID.
Aider dice que no hay contenido de archivo: Asegúrate de que el archivo esté rastreado por Git. Los archivos en un repositorio vacío o los archivos no rastreados no se agregan al contexto.

Referencias oficiales

Para los pasos de instalación, consulta Instalación de Aider. Para las variables de entorno y el prefijo del modelo, consulta APIs compatibles con OpenAI. Los IDs de modelos de ejemplo se pueden encontrar en la lista de modelos de Gemini y en la página de modelos de xAI.

Reemplaza cada marcador de posición con valores de tu propia configuración de OmniProxy. Nunca publiques una clave real.

Un resultado guardado o HTTP 200 por sí solo no prueba la compatibilidad completa del Agente. Verifica el origen y el modelo en el registro de llamadas de OmniProxy.

Fuentes oficiales · Aider ↗