Configurar Roo Code: API Key, Base URL y modelos

Para conectar Roo Code 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
Modelo	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

• VS Code instalado

Instalación

Instala Roo Code

Abre VS Code, busca Roo Code en el marketplace de extensiones e instálalo.

Configuración manual

Completa esta configuración en la interfaz de ajustes de Roo Code. No necesitas editar un archivo de configuración.

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

Pasos de configuración

Elimina las variables de entorno en conflicto

unset OPENAI_API_KEY
unset OPENAI_BASE_URL

Abre los ajustes de Roo Code

Abre el panel Settings de Roo Code.

Configura el proveedor de API

Completa estos campos:

• API Provider → OpenAI Compatible
• Base URL → https://bettertoken.ai/v1
• API Key → tu BetterToken API Key
• Model → un ID de modelo disponible copiado desde la model plaza

Configura cabeceras adicionales solo si la documentación oficial las exige

El material oficial de Roo Code que revisamos se centra en configuraciones de API compatibles con OpenAI o personalizadas, pero no considera un User-Agent adicional un paso obligatorio para BetterToken.

Si también usas un gateway personalizado, enrutamiento por tenant, observabilidad o una capa de caché, añade cabeceras únicamente según la documentación oficial de ese servicio original.

Guarda y empieza a usarlo

Haz clic en Save y Done y selecciona el modelo configurado.

Reinicia Roo Code

Después de guardar la configuración, reinicia VS Code o recarga la extensión Roo Code antes de seleccionar el modelo configurado.

Roo Code requiere llamadas nativas a herramientas compatibles con OpenAI. No dispone de una alternativa basada en XML, así que elige un modelo y un endpoint que admitan llamadas nativas a herramientas. Añade cabeceras adicionales solo cuando tu gateway original las requiera.

Verifica 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.

Después, pide a Roo Code que lea un archivo del proyecto y lo resuma. Comprueba que ejecute la herramienta de lectura y use su resultado; una respuesta de texto por sí sola no verifica el uso de herramientas del agente.

Cambia 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 habituales

Error	Qué comprobar
401 o Unauthorized	Comprueba la BetterToken API Key y elimina los espacios iniciales o finales.
404	Comprueba la Base URL y no añadas una ruta específica de endpoint.
model not found	Copia un ID de modelo vigente desde la model plaza.
Los cambios no se aplican	Guarda la configuración y reinicia la herramienta por completo.

• API compatible con OpenAI frente a API compatible con Anthropic

• MCP frente a API Key y Base URL

• ¿Qué son model_provider, base_url y wire_api?

• Cómo configurar una API compatible con OpenAI en Cline

• Compara todas las herramientas compatibles

• Errores de API, códigos de estado y límites de solicitudes

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.