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 repositorio para que el modelo pueda comprender proyectos grandes; Git, por su parte, es una herramienta de control de versiones que registra los cambios en el código y permite revisar las diferencias y restaurar modificaciones. Cuando asignas una tarea a Aider, la procesa paso a paso y redacta mensajes de commit. Si no te gustan los cambios, puedes deshacerlos con /undo.

Preparación antes de instalar

Hay dos métodos habituales de instalación:

Si el equipo ya tiene Python 3.8 a 3.13: instala primero aider-install. Python es el entorno que Aider necesita para ejecutarse.
Si no tienes una versión adecuada de Python: utiliza el comando de instalación de una línea, que también preparará Python 3.12 cuando sea necesario.

Mac y Linux

install.sh

Ejecuta con sh después de curl
Instalará Python si es necesario
Si no tienes curl, puedes usar wget

Windows

install.ps1

Ejecuta con PowerShell
Vuelve a abrir el terminal tras la instalación
Configura las variables de entorno con setx

Python ya instalado

aider-install

Primero instala este paquete con pip
Después ejecuta aider-install
Creará su propio entorno

La instalación de una línea preparará Python 3.12 cuando sea necesario. Instalar aider-chat directamente con pip es una opción menos fiable.

Asegúrate de que OmniProxy esté en ejecución. Cuando termine la instalación, entra primero en el directorio del proyecto que vas a modificar y después inicia 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 independiente para evitar que se mezcle con otros proyectos de Python del equipo. Cuando sea necesario, también instalará Python 3.12 para uso de Aider.

Instalación de una línea

En Mac y Linux, ejecuta:

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

Si el equipo no tiene curl, puedes utilizar:

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 línea se basan en uv, un programa utilizado para instalar y administrar herramientas y entornos de Python. También puedes utilizar este comando:

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

Otra opción es utilizar pipx. Si instalas Aider directamente mediante python -m pip install aider-chat, las versiones compatibles de Python son de la 3.9 a la 3.12, pero este se considera un método de instalación alternativo; da prioridad a los métodos anteriores. Las versiones de Aider incluidas en los gestores de paquetes del sistema pueden presentar incompatibilidades de dependencias, por lo que no se recomienda utilizarlas como primera opción.

El 2026-10-09, el comando de instalación de una línea instaló Aider v0.86.2. Si durante la instalación aparece un aviso que indica que la caché y el destino no están en el mismo disco y que se copiarán los archivos, la instalación se completará igualmente.

Cuando termine la instalación, entra en el directorio del proyecto. Una interfaz compatible es una interfaz que utiliza el formato de OpenAI para comunicarse con otros servicios de modelos. La forma de iniciar Aider es la siguiente:

aider --model openai/<model-name>

Sustituye <model-name> por el ID completo del modelo copiado de OmniProxy en la siguiente sección. El ID del modelo es el nombre utilizado para identificarlo con precisión.

Obtener los parámetros de conexión de OmniProxy

Debes configurar las dos variables de entorno siguientes. Las variables de entorno pueden entenderse como un conjunto de ajustes de conexión que leen 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 la dirección de la interfaz y debe incluir /v1. OPENAI_API_KEY es la clave utilizada para acceder a la interfaz.

En Windows, utiliza setx para guardar las variables. Después de ejecutarlo, debes volver a abrir el terminal:

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, conservando también las barras que contenga el ID. Cuando inicies Aider, añade openai/ delante del ID completo.

El 2026-10-09, los dos ID de referencia de la documentación de los proveedores eran gemini-3.8-flash y grok-4.7. Si esos nombres no aparecen en la lista actual, no los copies directamente; utiliza un ID completo que exista realmente en la lista.

Dirección

OPENAI_API_BASE

Apunta a OmniProxy
Incluye /v1
No lo guardes en el repositorio

Clave

OPENAI_API_KEY

Usa la que te proporcionó la puerta de enlace
En Windows, vuelve a abrir el terminal después de cambiarla
Las claves de los proveedores permanecen en la puerta de enlace

Inicio

openai/modelo

Haz cd al directorio del proyecto
Añade openai/ al nombre del modelo
Usa el nombre de la lista de la puerta de enlace

Las dos variables de entorno y un nombre de modelo con el prefijo openai/ forman la sintaxis de la interfaz compatible.

Introducir la configuración de la herramienta

No necesitas crear otro archivo de configuración. Entra primero en el directorio del proyecto, inicia Aider y sustituye 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 cambiar al otro modelo de ejemplo, ejecuta:

aider --model openai/grok-4.7

Cuando Aider encuentra un modelo que no reconoce, muestra una advertencia en la interfaz. Esta advertencia no significa por sí sola que la dirección sea incorrecta. Comprueba en el registro de solicitudes de OmniProxy si aparece la petición.

Aider solo incluye en el contexto los archivos que Git ya está siguiendo. El contexto es el código y la información que el modelo puede leer durante la tarea actual. Si el directorio actual todavía no es un repositorio Git, Aider creará uno, pero seguirá sin poder leer los archivos que Git no esté siguiendo. Añade primero los archivos con git add, crea un commit y después inicia Aider.

Aider aún puede modificar archivos. --no-auto-commits solo desactiva los commits automáticos; no impide que se modifiquen archivos. La primera vez, se recomienda utilizar un repositorio que no sea importante y ejecutar git diff al finalizar la tarea para revisar los cambios reales.

No escribas claves reales en los archivos del proyecto ni en páginas públicas. Las claves de los proveedores deben almacenarse únicamente en OmniProxy. Si la puerta de enlace no valida la clave, puedes introducir en OPENAI_API_KEY una cadena de caracteres de relleno que solo utilices localmente.

Verificar una tarea real

Primero confirma que el archivo que se va a leer ya se haya incluido en un commit de Git. Después, ejecuta el comando siguiente en el directorio del proyecto. Sustituye el ID del modelo por el ID completo incluido en la lista actual de OmniProxy:

aider --model openai/gemini-3.8-flash --message "¿Cuál es la primera línea de este archivo? No modifiques el archivo." --no-auto-commits

--message permite asignar directamente una tarea a Aider, mientras que --no-auto-commits indica que no debe crear automáticamente un commit de Git durante esta ejecución.

El 2026-10-09, se verificó con Aider v0.86.2 que podía leer la primera línea de un archivo seguido por Git. Si Git todavía no está siguiendo el archivo, Aider responderá que no puede ver el contenido; esto no significa que la dirección de la interfaz sea incorrecta. Después de completar la consulta, comprueba en el registro de solicitudes de OmniProxy el origen de la petición y el ID del modelo.

Inicio

aider puede iniciarse

Se encuentra el comando
Las variables de entorno están activas
Estás en el directorio del proyecto

Tarea

Ha revisado el archivo

Pregunta por un archivo concreto
Revisa su explicación
Los modelos no reconocidos mostrarán una advertencia

Registro

Es visible en la puerta de enlace

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

Comprueba que las variables de entorno estén activas, que el comando esté disponible y completa después una consulta real.

Errores comunes

No se encuentra aider: vuelve a abrir el terminal. Si lo instalaste directamente con pip, puedes probar python -m aider.
Windows sigue conectándose a la dirección anterior después de cambiar las variables: tras ejecutar setx, debes volver a abrir el terminal para que la nueva ventana lea las variables actualizadas.
Falta openai/ delante del nombre del modelo: la interfaz compatible requiere el formato openai/<model-name>.
Aparece una advertencia sobre un modelo desconocido: es un aviso normal y no significa que la conexión haya fallado. Comprueba después si OmniProxy recibió la petición.
El ID del modelo no es válido: vuelve a copiar el ID completo de la lista actual de OmniProxy, conservando el prefijo openai/ y las barras originales del ID.
Indica que no hay contenido de archivos: confirma primero que Git ya esté siguiendo el archivo. Un repositorio vacío o los archivos no seguidos no se incluirán en el contexto.

Referencias oficiales

Consulta los pasos de instalación en Aider installation. Las variables de entorno y el prefijo del modelo se describen en OpenAI compatible APIs. Los ID de modelo utilizados como ejemplos pueden consultarse 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 demuestra compatibilidad total con el Agente. Verifica el origen y el modelo en el registro de llamadas de OmniProxy.

Fuentes oficiales · Aider ↗