Documentación

Roo Code

El proveedor OpenAI Compatible de Roo Code requiere tres campos y un bloque de capacidades del modelo. Ese bloque no es un adorno opcional: es lo que Roo Code utiliza para calcular el presupuesto de contexto.

Selecciona el proveedor OpenAI Compatible, pega la URL base y la clave, y configura la ventana de contexto y la salida máxima del modelo para que el cálculo presupuestario de Roo Code sea correcto.

Panel de configuración de Roo Code

API Provider   OpenAI Compatible
Base URL       https://api.kunavo.com/v1
API Key        sk-kn-...
Model          claude-sonnet-5

Model Configuration
  Context Window     200000
  Max Output Tokens  64000
  Image Support      on

Roo Code usa llamadas nativas a herramientas sin alternativa, así que el modelo que elija debe admitir llamadas a herramientas compatibles con OpenAI. Todos los id de la tabla siguiente las admiten; un modelo solo de texto o multimedia configurado aquí fallará al intentar usar la primera herramienta del agente, no durante la configuración.

Complete Context Window y Max Output Tokens en vez de dejar los valores predeterminados. Roo Code decide cuándo condensar la conversación a partir de esos números: una ventana de contexto demasiado baja hace que trunque el historial antes de que sea necesario, y una demasiado alta produce errores 400 del proveedor en vez de una condensación limpia.

¿Aún no tienes una clave? Crea una cuenta de Kunavo, genera una clave (empieza por sk-kn-) y añade crédito desde $10; las llamadas se pagan con ese saldo y las llamadas fallidas no se facturan. El panel se abre entonces en la configuración de Roo Code.

Paso a paso

Cree una clave en /app/keys y cópiela: se muestra una sola vez.
Abra el panel de configuración de Roo Code y establezca API Provider en OpenAI Compatible.
Introduzca la URL base https://api.kunavo.com/v1 y su clave. El sufijo /v1 debe formar parte de la URL base; Roo Code solo añade la ruta.
Seleccione o escriba el id del modelo, luego abra Model Configuration y establezca la ventana de contexto, el máximo de tokens de salida, la compatibilidad con imágenes y los precios de entrada y salida de la tabla siguiente.
Envíe un mensaje en modo Code. Roo Code utiliza los precios introducidos aquí en su propio indicador de coste por tarea, así que conviene configurarlos correctamente.

Comprobado con Página del proveedor OpenAI Compatible de Roo Code el 6 de septiembre de 2026. La configuración de terceros puede cambiar; si el nombre de un campo ya no coincide con lo que ves, esa página es la autoridad, no esta.

Esta es la versión breve. El tutorial completo —elección del modelo, coste de una sesión real y modos de fallo— está en la guía paso a paso de Roo Code + Claude.

Verifica antes de depurar el cliente

Una solicitud determina si el fallo está en el endpoint, la clave o el archivo de configuración. Si devuelve JSON, la misma URL base y la misma clave funcionan en Roo Code.

# Settles whether a failure is the endpoint, the key, or the client.
curl -sS https://api.kunavo.com/v1/models \
  -H "Authorization: Bearer sk-kn-..."

Qué ID de modelo introducir en el campo

Todos los modelos de texto están disponibles mediante un ID de modelo; la lista activa está en GET /v1/models, y el catálogo con precios está en la página de modelos. Las tarifas son USD por 1M de tokens, entrada / salida.

ID de modelo	Entrada / salida de Kunavo	Dónde encaja en Roo Code
`claude-sonnet-5`	$1.40 / $7.00	Modo Code: el predeterminado y aquel para el que está calibrado el indicador de coste
`claude-opus-5`	$3.50 / $17.50	Modo Architect, donde un plan equivocado cuesta más que los tokens
`claude-haiku-4-5`	$0.70 / $3.50	Modo Ask y lecturas repetidas de archivos
`gpt-5-6-terra`	$0.70 / $4.20	pasadas de contexto largo por un repositorio extenso

La facturación es por token desde un saldo prepago, sin cuota mensual; consulta facturación. Con contexto repetido —que constituye la mayor parte de lo que envía un editor o cliente de chat—, la caché de indicaciones cambia más la factura que la elección del modelo.

Preguntas frecuentes

¿Cómo configuro Roo Code para usar un endpoint OpenAI-compatible personalizado?

En el panel de configuración de Roo Code, establezca API Provider en «OpenAI Compatible», introduzca la URL base y la clave de API de ese endpoint y elija un modelo. La URL base es la raíz /v1 del servicio, ya que Roo Code solo añade la ruta. La documentación de Roo Code califica el campo Base URL de crucial: determina adónde se envía cada solicitud.

¿Qué modelos funcionan con Roo Code a través de un endpoint personalizado?

Cualquier modelo ofrecido por el endpoint que admita llamadas nativas a herramientas compatibles con OpenAI. Roo Code usa exclusivamente llamadas nativas a herramientas y no tiene un modo alternativo, por lo que un modelo sin compatibilidad con herramientas se conectará, pero fallará en cuanto el agente intente leer o escribir un archivo. Todos los modelos de texto Claude y GPT son compatibles; los modelos de imagen, vídeo y audio no lo son.

¿Qué valores debo introducir en Context Window y Max Output Tokens de Roo Code?

Los límites reales del modelo seleccionado, no los valores predeterminados. Roo Code utiliza esos dos números para decidir cuándo condensar la conversación; si el valor es inferior al contexto real del modelo, descartará historial innecesariamente, y si es superior, producirá errores 400 del proveedor en vez de una condensación limpia. Las cifras de cada modelo se encuentran en el catálogo de modelos del endpoint.

¿Por qué Roo Code indica un coste incorrecto para una tarea?

Porque los precios de entrada y salida de Model Configuration se introducen manualmente y, de forma predeterminada, son cero o corresponden a las tarifas de otro proveedor. Roo Code calcula el coste por tarea exclusivamente a partir de esos dos campos; no consulta los precios del endpoint, así que la cifra solo es precisa si los valores introducidos lo son. Copie las tarifas del catálogo del proveedor.