Aider con Claude y GPT vía una API compatible con OpenAI

Aider es una herramienta de código abierto para programar en pareja con IA desde la terminal. La inicias dentro de un repositorio git, añades archivos al chat y describes el cambio que quieres; Aider edita los archivos y hace commit del resultado en git. Aider se comunica con los modelos a través de la biblioteca LiteLLM, así que puede usar cualquier API compatible con OpenAI, incluida APIVAI. Pagas por token desde un saldo prepago, sin suscripción.

Aider elige el formato de la API según el prefijo del nombre del modelo:

Elige la vía compatible con OpenAI si quieres una sola configuración para todos los modelos y cambiar libremente entre Claude y GPT. Elige la vía Anthropic si trabajas sobre todo con Claude y quieres la opción --cache-prompts de Aider, que usa el caché de prompts de Claude para que el contexto repetido (el mapa del repositorio y los archivos del chat) se facture al precio más barato de lectura de caché. Ambas vías usan la misma clave de APIVAI.

Cuidado con el /v1: la base URL de OpenAI termina en /v1, la de Anthropic no, porque LiteLLM le añade /v1/messages por su cuenta. ANTHROPIC_API_BASE es una variable de entorno de LiteLLM y no figura en la referencia de opciones de Aider, pero Aider la respeta porque todas las llamadas a modelos pasan por LiteLLM. Los detalles de ambos formatos están en la página API compatible con OpenAI y en la documentación.

1. Regístrate en apivai.com
2. Recarga saldo desde $10 con tarjeta, cripto, Alipay o WeChat Pay
3. Crea una clave en el Dashboard (puedes asignarle su propio límite de presupuesto) y cópiala

La documentación de Aider recomienda este instalador:

En macOS o Linux:

En Windows:

Después de setx, abre una ventana de terminal nueva: la ventana donde lo ejecutaste no ve los valores nuevos.

Escribe el ID del modelo exactamente después del prefijo openai/. Para usar GPT, arranca con --model openai/gpt-5.5 o cambia dentro de la sesión con /model openai/gpt-6-sol.

Por qué --edit-format diff: Aider elige un formato de edición según el nombre del modelo. Con nombres que no reconoce recurre a whole, donde el modelo reescribe cada archivo editado completo, lo que cuesta muchos más tokens de salida. diff envía solo los bloques modificados y funciona bien con los modelos actuales de Claude y GPT.

Aider lee un archivo .env de tu directorio personal, de la raíz del repositorio git y del directorio actual. Con este archivo basta con ejecutar aider:

El modelo débil (weak model) redacta los mensajes de commit y resume el historial del chat, así que un modelo barato ahí ahorra dinero sin afectar a la calidad del código. No subas la clave a git: deja el archivo en tu directorio personal o añade .env a .gitignore.

En Windows, usa setx como en el paso 3. Pasa siempre --model: sin él, Aider elige su propio modelo por defecto, que puede no ser el que quieres.

Precios por 1M de tokens de entrada / salida a fecha de 2026-10-07. La lista de modelos cambia con el tiempo, así que toma los IDs de GET https://api.apivai.com/v1/models o de la página de precios en lugar de copiar nombres antiguos.

Una buena opción por defecto es Claude Sonnet 4.6 como modelo principal y Claude Haiku 4.5 como weak model. Para una tarea difícil, el modo architect de Aider deja que un modelo potente planifique y otro más barato escriba las ediciones, por ejemplo aider --architect --model openai/claude-opus-5-5 --editor-model openai/claude-sonnet-4-6.

Cada petición de Aider envía el mapa del repositorio, los archivos añadidos al chat y la conversación hasta ese momento. Supongamos una petición típica de unos 15.000 tokens de entrada y 1.500 de salida (los tokens de razonamiento cuentan como salida) con Claude Sonnet 4.6:

• Una petición: $0.0234 ($0.0675 al precio oficial).
• Una jornada de 60 peticiones: $1.41 ($4.05 al precio oficial).
• Un mes de 22 jornadas así (1.320 peticiones): $30.93 ($89.10 al precio oficial).

El mismo mes con Claude Haiku 4.5 saldría por $10.38, y con GPT-6 Luna por $0.437. Para gastar menos, quita con /drop los archivos que ya no necesitas, limpia historiales largos con /clear y usa --cache-prompts en la vía Anthropic. El Dashboard muestra cada petición con sus tokens y su coste; la comparativa de precios de la API de Claude recoge todos los modelos junto a los precios oficiales.

• 401 / AuthenticationError: la clave es incorrecta, se ha borrado o no le queda presupuesto, o la variable no está definida en esta terminal. Tras setx en Windows, abre una ventana nueva.
• 404 / NotFoundError: la base URL es incorrecta. OPENAI_API_BASE debe terminar en /v1 exactamente una vez (ni /v1/v1 ni sin él). ANTHROPIC_API_BASE no debe contener /v1.
• "LLM Provider NOT provided": el nombre del modelo no lleva prefijo. Escribe openai/claude-sonnet-4-6, no claude-sonnet-4-6.
• Model not found: el ID tras el prefijo debe coincidir exactamente con un ID de GET /v1/models, no con un nombre comercial.
• Respuestas vacías o cortadas: el razonamiento (thinking) está activado por defecto y sus tokens consumen el límite de salida. Sube el límite para todos los modelos en .aider.model.settings.yml (directorio personal o raíz del repositorio):

• 429: el límite por defecto es de 60 peticiones por minuto por clave. Espera un momento o pide al soporte un límite mayor.
• "Unknown context window size and costs, using sane defaults": aviso inofensivo con modelos que Aider no conoce. Ocúltalo con --no-show-model-warnings. Por este motivo, Aider puede mostrar un coste de $0.00; las cifras reales están en el Dashboard.

Sí. Con la vía compatible con OpenAI, una clave y una base URL cubren ambos; cambia con /model openai/gpt-5.5 o /model openai/claude-sonnet-4-6.

No. Solo necesitas una clave de APIVAI y saldo prepago. No hay suscripción y pagas solo por los tokens que usas.

Permite usar --cache-prompts, que abarata el mapa del repositorio y los archivos que se reenvían. Si también quieres modelos GPT, la vía compatible con OpenAI es más sencilla.

No. El contenido de las peticiones y respuestas no se registra; solo se guardan datos de uso como modelo, tokens y coste para la facturación.

Con cualquier herramienta que acepte un endpoint compatible con OpenAI o con Anthropic, por ejemplo Continue en VS Code y JetBrains, o Claude Code (consulta la guía de configuración de Claude Code).

Crea una cuenta, recarga desde $10 y pega tu clave en Aider.