Configuración de Coding Agents

Configurar Aider: API Key, Base URL y modelos

Instala Aider, configura la Base URL y la API Key de BetterToken, elige un modelo disponible y corrige los errores habituales. Con ejemplos.

Para conectar Aider con BetterToken, prepara una API Key, introduce la Base URL indicada a continuación y elige un ID de modelo vigente en la model plaza.

Ajustes principales

Campo	Valor
API Key	BetterToken API Key
Base URL	`https://bettertoken.ai/v1`
Model	Un ID de modelo vigente de la model plaza

Requisitos previos

La versión actual de la herramienta está instalada
Una BetterToken API Key: regístrate y obtén una
Un ID de modelo de la model plaza

Regístrate y obtén una BetterToken API Key

¿Ya tienes una cuenta? Inicia sesión, recarga el saldo y crea una clave en la consola.

Requisitos adicionales

Instala Python

Instalación

Instala Aider

Ejecuta estos comandos en una terminal:

python -m pip install aider-install
aider-install

Después de instalarlo, confirma que Aider esté disponible:

aider --help

Configuración manual

Campo	Valor
API Key	BetterToken API Key
Base URL	`https://bettertoken.ai/v1`
Model	Un ID de modelo vigente de la model plaza

Configura BetterToken en la terminal actual

macOS / Linux

export OPENAI_API_BASE="https://bettertoken.ai/v1"
export OPENAI_API_KEY="YOUR_API_KEY"

cd /path/to/your/project
aider --model openai/YOUR_MODEL_ID

Windows PowerShell

setx OPENAI_API_BASE "https://bettertoken.ai/v1"
setx OPENAI_API_KEY "YOUR_API_KEY"

Después de ejecutar setx, cierra PowerShell y vuelve a abrirlo. Entra en el directorio del proyecto y ejecuta:

aider --model openai/YOUR_MODEL_ID

Sustituye YOUR_API_KEY por tu BetterToken API Key. YOUR_MODEL_ID es solo un ejemplo. Sustitúyelo por un ID de modelo disponible vigente en la model plaza y conserva el prefijo openai/.

Guarda la configuración con .env

Para no tener que definir las variables cada vez que abres una terminal, crea un archivo .env en la raíz Git del proyecto:

OPENAI_API_BASE=https://bettertoken.ai/v1
OPENAI_API_KEY=YOUR_API_KEY
AIDER_MODEL=openai/YOUR_MODEL_ID

Añade .env a .gitignore para no incluir la API Key en los commits. Entra en el directorio del proyecto y ejecuta:

aider

Para usar otro archivo en un proyecto, indícalo de forma explícita:

aider --env-file ./aider-bettertoken.env

Opcional: usa .aider.conf.yml

Para conservar únicamente ajustes no sensibles, crea .aider.conf.yml en tu directorio personal o en el del proyecto:

model: openai/YOUR_MODEL_ID
openai-api-base: "https://bettertoken.ai/v1"

Guarda la API Key en la variable de entorno OPENAI_API_KEY, no en un archivo YAML compartido.

Cambiar el Model ID

Sustituye el modelo del comando de inicio por un ID de modelo disponible vigente:

aider --model openai/YOUR_MODEL_ID

No elimines el prefijo openai/. El ID del modelo debe ser compatible con el endpoint configurado.

Verificar la conexión

Envía un prompt de prueba breve. Si la herramienta responde sin errores de autenticación ni de ID del modelo, la conexión funciona. Reinicia por completo la herramienta después de cambiar la configuración.

Cambiar de modelo

Abre el selector de modelos o cambia el campo Model de la configuración. Usa el ID de modelo exacto de la model plaza y reinicia la sesión actual.

Errores frecuentes

Síntoma	Qué hacer
`401`, `Unauthorized` o `Invalid API key`	Comprueba `OPENAI_API_KEY`, confirma que sea una BetterToken API Key y elimina los espacios adicionales.
`model not found` o modelo no disponible	Copia un ID de modelo disponible vigente desde la model plaza y pásalo a Aider como `openai/model-id`.
URL de solicitud incorrecta o `404`	Confirma que `OPENAI_API_BASE` sea `https://bettertoken.ai/v1`. No añadas `/chat/completions`.
Windows no lee las variables nuevas	`setx` solo afecta a las terminales abiertas posteriormente. Cierra la ventana actual de PowerShell y abre otra.
Aider indica que el modelo es desconocido	Comprueba primero el ID del modelo y el proveedor de API. Aider puede mostrar una advertencia para un modelo nuevo, pero debes usar un ID vigente de la model plaza.

Preguntas de configuración

¿Qué Base URL debe usar Aider?

Usa https://bettertoken.ai/v1. Es la Base URL de BetterToken compatible con OpenAI.

¿Por qué necesita el nombre del modelo el prefijo openai/?

Aider usa este prefijo para identificar un modelo compatible con OpenAI. Si lo omites, Aider puede seleccionar el proveedor equivocado.

¿Puedo incluir la API Key en .aider.conf.yml?

No lo recomendamos. Usa variables de entorno o un archivo .env ignorado por Git para reducir el riesgo de exponer una API Key en los archivos del proyecto.

Configuración avanzada

Guías relacionadas

Detalles técnicos

Protocolo, endpoint y campos internos del proveedor

Esta configuración usa https://bettertoken.ai/v1. La herramienta añade la ruta del endpoint compatible con OpenAI. No añadas /chat/completions ni /responses salvo que un campo concreto lo exija explícitamente.