Instalación de Aider y configuración de OmniProxy

Aider es una herramienta que ayuda a modificar código desde el terminal. Crea un mapa de todo el código fuente para ayudar al modelo a comprender proyectos de mayor envergadura. 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 redacta los mensajes de confirmación (commit). Si no te gustan los cambios, puedes deshacerlos con /undo.

Antes de empezar

Existen dos opciones de instalación comunes:

Si tu ordenador 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 de Python adecuada, utiliza el comando de instalación de una sola línea. Este también configurará Python 3.12 cuando sea necesario.

Mac y Linux

install.sh

Ejecutar con sh tras curl
Instala Python si es necesario
Usar wget si curl no está disponible

Windows

install.ps1

Ejecutar en PowerShell
Reabrir el terminal tras 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 fiable.

Asegúrate de que OmniProxy esté en ejecución. Tras la instalación, entra en el directorio del proyecto que planeas modificar antes de iniciar Aider.

Instalación y primer lanzamiento

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 independiente para que no interfiera con otros proyectos de Python en tu ordenador. 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, utiliza:

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 utilizar 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 la caché y el destino están en discos diferentes y que los archivos se copiarán. La instalación se completará de todos modos.

Tras la instalación, entra en el directorio del proyecto. Una API compatible es una interfaz que se comunica con otros servicios de modelos utilizando el formato de OpenAI. Inicia Aider utilizando este patrón:

aider --model openai/<model-name>

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

Obtener los ajustes de conexión de OmniProxy

Necesitas establecer las siguientes dos variables de entorno. Las variables de entorno pueden entenderse como un conjunto de ajustes de conexión leídos por los programas del 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, utiliza setx para guardar las variables. Debes reabrir el terminal después:

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 inclinada en el ID del modelo. Al iniciar Aider, añade openai/ antes del ID completo.

A fecha de 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. Utiliza un ID completo que aparezca realmente en la lista.

Dirección

OPENAI_API_BASE

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

Clave

OPENAI_API_KEY

Usar la proporcionada por la pasarela
Reabrir terminales de Windows tras cambiarla
Mantener las claves del proveedor en la pasarela

Lanzar

openai/model

cd al directorio del proyecto
Prefijar el nombre del modelo con openai/
Usar el nombre de la lista de la pasarela

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

Introducir la configuración de la herramienta

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

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

Para utilizar 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. Comprueba los registros de solicitudes de OmniProxy para confirmar si la solicitud apareció.

Aider solo añade al contexto los archivos ya 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 Git, Aider creará uno, pero los archivos que Git no rastrea seguirán sin poder leerse. Utiliza git add para añadir los archivos y confirmarlos (commit) antes de iniciar Aider.

Aider aún puede modificar archivos. --no-auto-commits solo desactiva las confirmaciones automáticas; no impide las modificaciones de archivos. Cuando utilices 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 pasarela no valida las claves, puedes establecer OPENAI_API_KEY en una cadena de marcador de posición utilizada solo en tu ordenador 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.

A fecha de 09-10-2026, Aider v0.86.2 leyó correctamente 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, comprueba los registros de solicitudes de OmniProxy para verificar el origen de la solicitud y el ID del modelo.

Lanzar

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 pasarela

El origen es Aider
El ID del modelo coincide
La clave no se introdujo en la página

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

Errores comunes

No se puede encontrar aider: Reabre el terminal primero. Si lo instalaste directamente con pip, intenta python -m aider.
Windows sigue conectándose al punto de conexión antiguo tras cambiar las variables: Debes reabrir el 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 haya fallado. Comprueba si OmniProxy recibió la solicitud.
El ID del modelo no es válido: Copia el ID completo de nuevo de la lista actual de OmniProxy. Mantén el prefijo openai/ y cualquier barra inclinada 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 añaden 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 total del Agente. Comprueba el origen y el modelo en el registro de llamadas de OmniProxy.

Fuentes oficiales · Aider ↗