Volver al blog

Herramientas e integracionesGuía

Archivo de configuración de Aider para tu propia clave de API: .aider.conf.yml y setx en Windows

Mantén tu propia clave de API y URL base en .aider.conf.yml, acierta con el orden de carga y evita la trampa de setx en Windows, con una estimación del coste de una sesión.

Por CheapTokens TeamPublicado el 4 min de lectura

Terminal con los comandos que conectan Aider a una API compatible con OpenAI
En esta página
  1. Windows: setx y una terminal nueva
  2. Qué modelo para qué ediciones
  3. Ejecuta una primera edición
  4. Deja de reescribir: .aider.conf.yml
  5. Cuánto cuesta una sesión
  6. Si no funciona

Dos variables, OPENAI_API_BASE y OPENAI_API_KEY, y un argumento de modelo como openai/<model id> son suficientes para apuntar Aider a CheapTokens. Los conceptos básicos paso a paso (instalación, primera petición, 401/404/400/402) están en Cómo conectar Aider a CheapTokens; esta página cubre lo que esa guía deja fuera: Windows setx, el archivo de configuración y su orden de carga, y una estimación del coste de una sesión.

Fuente: la documentación de Aider para APIs compatibles con OpenAI (página consultada el 26 de octubre de 2026; la documentación no muestra fecha ni versión, y la última aider-chat en PyPI ese día era 0.86.2).

Windows: setx y una terminal nueva#

En Mac y Linux export las dos variables. En Windows (PowerShell o cmd) usa setx:

bat
setx OPENAI_API_BASE https://api.cheaptokens.dev/v1
setx OPENAI_API_KEY <your CheapTokens key>

En Windows hay una trampa. setx escribe las variables para sesiones futuras, no para la que estás usando, así que cierra la terminal y abre una nueva antes de iniciar Aider. Si configuras las variables y Aider sigue pidiendo una clave, esta suele ser la razón.

Qué modelo para qué ediciones#

El argumento de modelo es openai/ más el id completo, así que para CheapTokens tiene dos barras:

bash
cd your-git-repo
aider --model openai/MiniMaxAI/MiniMax-M2.7

MiniMax-M2.7 tiene un contexto de 180K y responde hasta 8.192 tokens, adecuado para ediciones pequeñas y medianas donde las respuestas son cortas. Si tus ediciones vuelven como diffs largos, el otro modelo que vale la pena probar es DeepSeek-V4-Flash: hasta 32.768 tokens por respuesta, un contexto de 380K y un único precio a cualquier hora del día.

bash
aider --model openai/deepseek-ai/DeepSeek-V4-Flash-0731

Copia el id completo de la documentación de CheapTokens o de la lista de modelos en precios.

Ejecuta una primera edición#

Aider funciona dentro de un repositorio git, así que empieza en uno. Añade un archivo y pide algo pequeño:

text
> /add app.py
> Add a --verbose flag that prints each file before it is processed

Cuando Aider responde con una edición al archivo, la clave, la URL base y el id del modelo son correctos.

El id de modelo incorrecto junto al id completo que funciona, luego la primera edición
Id incorrecto frente a id completo, y la primera petición

Deja de reescribir: .aider.conf.yml#

Aider lee .aider.conf.yml desde tu directorio home, luego la raíz del repositorio git, luego el directorio actual, y los archivos posteriores tienen prioridad. Así, un archivo global puede contener la clave y la base, y un archivo del repositorio puede elegir el modelo. Si quieres un archivo específico y nada más, aider --config <file> carga solo ese.

Un archivo en el directorio home (ejemplo, pon tu propia clave):

yaml
openai-api-base: https://api.cheaptokens.dev/v1
openai-api-key: <your CheapTokens key>
model: openai/MiniMaxAI/MiniMax-M2.7

Ahora aider por sí solo arranca con el endpoint y el modelo correctos. Si haces commit del archivo en un repositorio, deja fuera la clave y mantenla en la variable de entorno o en un archivo .env; las líneas de la clave son para tu propio directorio home.

Para un modelo que Aider no conoce, la documentación describe un model-settings-file (.aider.model.settings.yml) donde puedes especificar sus ajustes.

Cuánto cuesta una sesión#

Aider reenvía los archivos que añadiste y el historial del chat con cada mensaje, así que los tokens de entrada crecen más rápido que los de salida. Digamos que una sesión de trabajo de unos 20 mensajes envía 400.000 tokens de entrada y recibe 40.000 tokens de salida (una suposición para el ejemplo; pon tus propios números). En MiniMax-M2.7 eso es $0.026, y más barato que OpenRouter en total, contando entrada y salida juntas. La tabla de abajo ejecuta la misma sesión con nuestros modelos:

Modelo Costo OpenRouter
GLM-5.3-Flash $0.0096 $0.0196
DeepSeek-V4-Flash $0.01 $0.0253
MiniMax-M2.7 $0.026 $0.168

400.000 tokens de entrada y 40.000 tokens de salida en total. Los precios por 1M de tokens son actuales y cambian junto con nuestras tarifas; la columna de OpenRouter muestra precios de referencia para la misma carga de trabajo.

Cómo mantener pequeño el lado de la entrada (archivos de solo lectura, /drop, tamaño del mapa del repositorio) se cubre en Cuánto cuesta Aider. Los precios actuales están siempre en la página de precios.

Si no funciona#

  • Aider pide una clave de API o habla con el servicio equivocado. Las variables no son visibles para el proceso. En Windows, reinicia la terminal después de setx; en Mac y Linux, ejecuta echo $OPENAI_API_BASE en el mismo shell.
  • Tu configuración parece ignorarse. Recuerda el orden: home, raíz del repositorio, directorio actual. Un archivo más cercano a ti anula el global.
  • Modelo no encontrado, 404 o un error de autenticación. Se cubren en Cómo conectar Aider a CheapTokens.

La misma dirección compatible con OpenAI funciona en otras herramientas; si también usas un agente de editor, consulta conectar OpenCode o el resumen de dónde conectar tu propia clave de API.

Etiquetas: