Ajustes principales
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
Requisitos adicionales
- Instala Python
Instalación
Instala Aider
Ejecuta estos comandos en una terminal:Configuración manual
Configura BetterToken en la terminal actual
- macOS / Linux
- Windows PowerShell
YOUR_API_KEY por tu BetterToken API Key. YOUR_MODEL_ID es solo un ejemplo. Sustitúyelo por un ID de modelo de un proveedor compatible 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:
.env a .gitignore para no incluir la API Key en los commits. Entra en el directorio del proyecto y ejecuta:
Opcional: usa .aider.conf.yml
Para conservar únicamente ajustes no sensibles, crea.aider.conf.yml en tu directorio personal o en el del proyecto:
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 de un proveedor compatible vigente: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 campoModel de la configuración. Usa el ID de modelo exacto de la model plaza y reinicia la sesión actual.
Errores frecuentes
Preguntas de configuración
¿Qué Base URL debe usar Aider? Usahttps://www.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
Proveedores compatibles
Los estados se aplican al método de configuración de BetterToken descrito en esta página.
Qué significa cada método de configuración
Qué significa cada método de configuración
- Configuración manual: introduce la API Key, la Base URL y el Model.
- No compatible: todavía no hay un método de conexión directa verificado.
Guías relacionadas
- Configurar un modelo personalizado en Continue CLI
- Configurar un proveedor personalizado en Codex CLI
- Configurar una API, Base URL y API Key personalizadas en Cursor
- Configurar una API compatible con OpenAI en Cline
Detalles técnicos
Protocolo, endpoint y campos internos del proveedor
Protocolo, endpoint y campos internos del proveedor
Esta configuración usa
https://www.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.