Documentación

Aider

Aider lee OPENAI_API_BASE y OPENAI_API_KEY. Configúrelas para Kunavo, anteponga openai/ al ID del modelo y podrá cambiar entre Claude y GPT con otro argumento --model.

Dos variables de entorno y un prefijo. Establezca OPENAI_API_BASE en https://api.kunavo.com/v1, OPENAI_API_KEY en su clave de sk-kn-… y luego ejecute Aider con --model openai/<id>. No cambia nada del repositorio ni de la instalación de Aider.

~/.zshrc

export OPENAI_API_BASE=https://api.kunavo.com/v1
export OPENAI_API_KEY=sk-kn-...

# The openai/ prefix is required — it tells Aider to speak the OpenAI
# protocol to OPENAI_API_BASE instead of resolving the id as a known model.
aider --model openai/claude-sonnet-5

El prefijo openai/ es obligatorio y la URL base debe incluir el sufijo /v1. Si omite el prefijo, Aider resuelve el ID con su propia tabla de proveedores y muestra el error «modelo desconocido»; si omite /v1, la solicitud no llega a la ruta.

Paso a paso

Cree una clave en /app/keys y cópiela: se muestra una sola vez.
Exporte OPENAI_API_BASE y OPENAI_API_KEY en el shell desde el que inicia Aider, o añádalas a ~/.aider.conf.yml como se muestra a continuación.
Inicie Aider en su repositorio con aider --model openai/claude-sonnet-5.
Al iniciarse, Aider muestra el modelo que resolvió. Si esa línea indica el ID que solicitó, el endpoint está configurado correctamente.

La referencia de Aider sobre este tema está en la página de API compatibles con OpenAI.

Cómo mantenerlo fuera del perfil del shell

Los mismos dos valores pueden guardarse en el archivo de configuración de Aider, que es una mejor opción si cambia de endpoint según el proyecto.

~/.aider.conf.yml

# ~/.aider.conf.yml — same two values, without exporting them each shell.
openai-api-base: https://api.kunavo.com/v1
openai-api-key: sk-kn-...
model: openai/claude-sonnet-5

Verifique antes de depurar Aider

Una solicitud permite determinar si el fallo está en el endpoint, la clave o la resolución del modelo de Aider. Si devuelve una lista JSON de ID de modelos, la misma URL base y la misma clave funcionarán en Aider; cualquier error restante se debe al prefijo openai/.

# Settles whether a failure is the endpoint, the key, or Aider.
# A JSON list of model ids means the same base URL will work in Aider.
curl -sS https://api.kunavo.com/v1/models \
  -H "Authorization: Bearer sk-kn-..."

Qué modelos elegir

Se puede acceder a todos los modelos de texto de Kunavo como openai/<id>. La lista completa está en la página de modelos y se obtiene en tiempo real desde GET /v1/models. Las tarifas están expresadas en USD por cada millón de tokens, entrada/salida.

ID de modelo	Entrada / salida de Kunavo	Uso recomendado
`claude-haiku-4-5`	$0.70 / $3.50	El Claude más económico: adecuado para las llamadas de Aider al mapa del repositorio y a los mensajes de confirmación
`claude-sonnet-5`	$1.40 / $7.00	El equilibrio predeterminado entre calidad y precio para editar
`claude-opus-5`	$3.50 / $17.50	Nivel de Claude de mayor calidad: para cambios a nivel de arquitectura
`gpt-5-6-terra`	$0.70 / $4.20	La misma clave, otra familia: útil como segunda opinión para cambios complejos

Aider vuelve a enviar el mapa del repositorio y los archivos editados en cada intercambio, así que el gasto en tokens depende del tamaño del contexto, no del tamaño de la edición. Por eso, el almacenamiento en caché de instrucciones es el factor más importante, y --model junto con --weak-model openai/claude-haiku-4-5 forman la combinación más económica: el modelo potente edita, y el más sencillo redacta mensajes de confirmación y resúmenes. Se factura por token con cargo a un saldo prepagado, sin cuota mensual; consulte los detalles en facturación.

Preguntas frecuentes

¿Cómo uso Aider con una API compatible con OpenAI?

Establezca OPENAI_API_BASE como la URL base del endpoint y OPENAI_API_KEY como su clave; después, inicie Aider con el ID del modelo precedido por openai/, por ejemplo, `aider --model openai/claude-sonnet-5`. Para Kunavo, la URL base es https://api.kunavo.com/v1. El prefijo es obligatorio: sin él, Aider intenta resolver el ID con su propia tabla de proveedores en lugar de enviarlo a su endpoint.

¿Puede Aider usar modelos Claude mediante un endpoint compatible con OpenAI?

Sí. Aider se comunica con la dirección a la que apunta OPENAI_API_BASE mediante el protocolo de OpenAI, así que puede acceder a un modelo Claude servido en ese formato sin credenciales de Anthropic; el ID del modelo es simplemente otra cadena de la lista /v1/models. En Kunavo, todos los ID de Claude y GPT usan la misma clave, así que para cambiar entre ellos basta con otro argumento --model, sin cambiar la configuración.

¿Por qué Aider dice que el modelo no se reconoce?

Casi siempre se debe a que falta el prefijo openai/. Aider interpreta un ID sin prefijo como un modelo que debería reconocer y falla cuando no lo reconoce; `openai/<id>` le indica que pase el ID directamente a OPENAI_API_BASE. La segunda causa más frecuente es una URL base sin el sufijo /v1, que provoca un error de conexión o 404, no un error de modelo desconocido.

¿Aider muestra cuánto costó una sesión?

Aider muestra el recuento de tokens y un coste estimado por intercambio, calculado a partir de los metadatos de su propio modelo. Para un endpoint personalizado, esa estimación puede ser incorrecta, porque Aider no conoce las tarifas de su endpoint. Considere fiable el recuento de tokens y consulte el cargo real a su proveedor. En Kunavo, el coste por solicitud aparece en la vista de uso y se factura con cargo a un saldo prepagado, sin cuota mensual.