Apunta Aider a una API base compatible con OpenAI.

Respuesta rápida: dos variables de entorno y un prefijo de modelo.

La ruta compatible con OpenAI que documenta Aider es exactamente esta: exporta OPENAI_API_BASE con tu endpoint, exporta OPENAI_API_KEY con la clave correspondiente, y antepón openai/ al nombre del modelo para que Aider hable el protocolo de chat-completions con esa base. La cadena que sigue al prefijo se pasa tal cual al endpoint, así que cualquier id que sirva el gateway es válido, incluidos los ids de Claude y DeepSeek. Esa es toda la conexión. En Mac y Linux usa export; en Windows usa setx y abre una nueva shell, ya que setx no afecta a la sesión actual. Los mismos valores pueden vivir en el archivo de configuración de Aider o en un .env si prefieres configuración por proyecto en lugar de estado de shell.

export OPENAI_API_BASE=https://api.apisrouter.com/v1
export OPENAI_API_KEY=sk-APIsRouter-...

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

Cómo resuelve Aider modelos y proveedores.

Aider (Aider-AI en GitHub, unas 47K estrellas) es el pair programmer de terminal original: mapea tu repositorio git, recibe solicitudes de cambio por chat, edita archivos directamente y hace commit del resultado. Por debajo enruta las llamadas a modelos a través de litellm, por eso importa el prefijo openai/: litellm lee el prefijo para elegir un protocolo de proveedor, y openai/ significa "chat-completions contra lo que diga OPENAI_API_BASE". Un nombre de modelo sin prefijo se infiere del proveedor a partir de su ortografía, lo que enruta un id de Claude hacia la API nativa de Anthropic y tu ANTHROPIC_API_KEY en lugar de tu gateway. Hay un comportamiento específico de Aider que conviene conocer antes de tu primera sesión: mantiene su propio registro de capacidades de modelos, y un modelo que no reconoce dispara el aviso "Unknown context window size and costs, using sane defaults", tras lo cual Aider asume una ventana de contexto ilimitada y coste cero. La sesión sigue funcionando, pero dos subsistemas útiles se degradan: la gestión de presupuesto de tokens no puede avisarte antes de que superes el límite real de contexto, y el indicador de coste en sesión marca cero. La solución es un pequeño archivo de metadatos, que se cubre más abajo, y merece los dos minutos. Aider también ejecuta más de un modelo por sesión. El modelo main hace la codificación; un modelo weak se encarga de los mensajes de commit y el resumen del chat; y en modo architect, un modelo editor separado aplica el plan. Cada uno acepta el mismo prefijo openai/, así que los tres pueden enrutarse por el gateway con una sola clave.

Configuración completa: conexión más metadatos de modelo.

La conexión son las dos variables de arriba. El refinamiento es registrar metadatos para que Aider trate los modelos del gateway como cantidades conocidas. Crea .aider.model.metadata.json en tu directorio home, en la raíz del repositorio git o en el directorio de trabajo (o pasa --model-metadata-file), indexado por el nombre completo incluyendo el prefijo openai/; el campo litellm_provider debe coincidir con ese prefijo. Con max_input_tokens registrado, la gestión de presupuesto de contexto de Aider trabaja contra la ventana real del modelo en lugar de asumir que es infinita. Un segundo archivo opcional, .aider.model.settings.yml, ajusta el comportamiento por modelo: edit_format controla cómo pide Aider los cambios de código (variantes de diff para modelos que las manejan bien, archivo completo para los que no), y use_repo_map controla la inclusión de contexto del repositorio. Aider no puede inferir el mejor edit_format para un modelo que no reconoce, así que declararlo marca la diferencia entre que un modelo parezca mediocre o rinda a su nivel real.

{
  "openai/claude-sonnet-4-6": {
    "max_input_tokens": 200000,
    "max_output_tokens": 64000,
    "litellm_provider": "openai",
    "mode": "chat"
  },
  "openai/deepseek-v4-pro": {
    "max_input_tokens": 128000,
    "max_output_tokens": 16000,
    "litellm_provider": "openai",
    "mode": "chat"
  }
}

Elegir modelos main, weak y editor.

Las sesiones de Aider son largas e iterativas, lo que hace que la comparación de modelos sea inusualmente honesta aquí: corre la misma rama de feature con dos modelos main en días distintos y la diferencia se nota en cuántas veces escribes /undo. Un solo endpoint convierte cada candidato en un cambio de flag, y el uso por clave pone precio a cada experimento.

• El modelo main carga con cada edición. Lee el mapa del repositorio, razona sobre tus archivos y produce diffs, así que aquí es donde encajan claude-sonnet-4-6 o gpt-5.5; un modelo que se traba con la sintaxis de diff te cuesta tiempo de revisión en cada cambio.
• El modelo weak (--weak-model) escribe mensajes de commit y resume el historial del chat. Se dispara constantemente y nunca toca código, así que enrútalo a un id rápido y barato a través del mismo gateway en lugar de dejar que caiga en otro sitio por defecto.
• El modo architect separa la planificación de la edición: el modelo main planifica, el modelo editor (--editor-model) aplica. Un razonador fuerte planificando junto con un id afinado para código como kimi-k2.7-code aplicando es una combinación que ninguna clave de un solo proveedor puede ofrecer.
• deepseek-v4-pro y gpt-5.4 merecen probarse como modelos main de uso diario en trabajo intensivo de refactorización, donde el volumen de tokens por sesión hace que la diferencia de precio se acumule.

Pago por uso · por debajo del precio oficial

Selected models are priced below official list prices. Exact input, output, cache, and per-request prices are shown for each model.

Modos de fallo específicos de Aider.

Confiar en los "sane defaults". El fallback de modelo desconocido asume contexto ilimitado y coste cero. En la práctica, eso significa que Aider dejará que una sesión larga crezca más allá de la ventana real del modelo hasta que el gateway rechace la petición o el modelo pierda silenciosamente el contexto temprano, y el indicador de coste no muestra nada en todo ese tiempo. Registra los metadatos; ambos problemas desaparecen. Omitir el prefijo openai/. Sin él, litellm infiere el proveedor a partir del nombre del modelo. Los ids de Claude se enrutan hacia la API de Anthropic y fallan por falta de ANTHROPIC_API_KEY, lo que parece un problema de clave cuando en realidad es un problema de prefijo. Metadatos que no coinciden. Las entradas en .aider.model.metadata.json se indexan por el nombre completo, prefijo incluido, y litellm_provider debe concordar con ese prefijo. Una clave con el id pelado o un campo provider desajustado falla en aplicarse en silencio, y vuelves a los valores por defecto sin ningún error que lo indique. Estado de shell en Windows. setx escribe la variable solo para shells futuras. Ejecutar aider en la misma terminal donde acabas de correr setx usa el entorno antiguo, y el 401 resultante es un problema de ciclo de vida de la shell, no un problema de credenciales. El edit_format equivocado. Un modelo no registrado recibe un edit_format por defecto que puede no ser el que mejor maneja. Si un modelo fuerte sigue produciendo ediciones que Aider rechaza, define edit_format explícitamente en .aider.model.settings.yml antes de concluir que el modelo no sabe programar.

Quién enruta Aider a través de un gateway.

• Usuarios habituales de Aider que quieren Claude, GPT y DeepSeek intercambiables por sesión con --model, sin mantener una cuenta de proveedor por familia de modelos.
• Desarrolladores que combinan un modelo main de vanguardia con un modelo weak rápido para mensajes de commit, ambos facturados a una sola clave con visibilidad por sesión.
• Usuarios de modo architect que combinan un modelo de planificación y un modelo de edición de distintos proveedores en la misma sesión.
• Equipos que dan de alta ingenieros con un solo secreto en lugar de una lista de claves por proveedor, con el uso por clave como informe de gasto.
• Desarrolladores sin acceso a la facturación de un proveedor concreto. El acceso mediante recarga sin necesidad de tarjeta elimina la dependencia de registrarse en cada proveedor.

Verifica el endpoint y depura la primera sesión.

Lista los modelos del gateway antes de empezar; el id tras openai/ debe coincidir exactamente con un id servido, sufijos de versión incluidos. Los fallos de primera sesión se identifican rápido. Un 401 significa que OPENAI_API_KEY no es visible para la shell que lanzó aider (solo shells nuevas en Windows tras setx; comprueba con echo en la misma terminal). Un error de modelo no encontrado desde el gateway es un error tipográfico en el id. Un error que menciona la clave de otro proveedor significa que un nombre de modelo sin prefijo se enrutó de forma nativa. Y el aviso de modelo desconocido al arrancar no es un error, pero es tu señal para añadir el archivo de metadatos antes de una sesión larga, no después de haber topado con el límite real de contexto. En sesión, el indicador propio de tokens y coste de Aider se vuelve preciso una vez registrados los metadatos, y la consola de APIsRouter muestra las mismas sesiones desde el lado del endpoint: modelo por petición, recuento de tokens y gasto. Para alguien que programa en pareja todo el día, esa vista por clave es la respuesta honesta a cuánto cuesta realmente una semana de Aider.

curl -s https://api.apisrouter.com/v1/models \
  -H "Authorization: Bearer $OPENAI_API_KEY" | head -50

Preguntas frecuentes