Documentación

Kilo Code

El proveedor personalizado de Kilo Code tiene cuatro campos. Rellénalos y la extensión se comunicará con Claude y GPT mediante una sola clave, sin conocer nunca qué proveedor está detrás del endpoint.

Providers → Custom provider → OpenAI Compatible, URL base con /v1 e ID del modelo Claude introducido — Kilo Code nunca sabe qué proveedor hay detrás.

Configuración → Proveedores → Proveedor personalizado

Provider ID    kunavo
Display name   Kunavo
Provider API   OpenAI Compatible
Base URL       https://api.kunavo.com/v1
API key        sk-kn-...
Models         claude-sonnet-5
               claude-opus-5
               claude-haiku-4-5

La URL base conserva aquí el sufijo /v1: Kilo Code solo añade la ruta, y el ejemplo documentado por la propia herramienta termina en /v1. Es lo contrario de lo que ocurre con los clientes de estilo Anthropic, que requieren el origen sin sufijo.

Provider API es un selector de protocolo, no de proveedor. Elegir OpenAI Compatible y luego introducir un ID de modelo de Claude es la combinación prevista: el ID se resuelve en el endpoint, no en la extensión.

¿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 Kilo Code.

Paso a paso

Cree una clave en /app/keys y cópiela: se muestra una sola vez.
Abre la configuración de Kilo Code (el icono del engranaje), ve a la pestaña Providers, desplázate hasta el final y haz clic en Custom provider.
Rellena Provider ID, Display name, Provider API = OpenAI Compatible, Base URL y API key como se indica arriba.
En Models, añade los ID manualmente o elígelos de la lista obtenida automáticamente: Kunavo responde a GET /v1/models, así que la lista se completa sola.
Selecciona el proveedor en el selector del modo de chat y envía un mensaje. Asigna un modelo económico a los modos que se ejecutan constantemente y uno caro a los modos de planificación.

Comprobado con La página de proveedores compatibles con OpenAI de Kilo 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 de Kilo 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 Kilo 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 Kilo Code
`claude-sonnet-5`	$1.40 / $7.00	Modos Code y Architect: el modelo de trabajo predeterminado
`claude-opus-5`	$3.50 / $17.50	Modo Architect para refactorizaciones grandes, donde un plan erróneo resulta caro
`claude-haiku-4-5`	$0.70 / $3.50	Ask y clasificación rápida de archivos, donde predomina el volumen
`gpt-5-6-sol`	$2.00 / $12.00	una segunda opinión de una familia distinta, con la misma clave

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 añado un proveedor personalizado a Kilo Code?

Abre la configuración de Kilo Code con el icono del engranaje, ve a la pestaña Providers, desplázate hasta el final de la lista y haz clic en «Custom provider». Introduce un Provider ID y un Display name, establece Provider API en «OpenAI Compatible», pega la URL base y la clave de API del endpoint, y luego añade los ID de modelo manualmente o desde la lista obtenida automáticamente. El proveedor aparecerá en el selector de modos como cualquier proveedor integrado.

¿Puede Kilo Code usar modelos de Claude sin una cuenta de Anthropic?

Sí. Provider API «OpenAI Compatible» de Kilo Code indica el protocolo de comunicación, no el proveedor, y transmite el ID del modelo directamente a la URL base que configuraste. Por tanto, el ID de Claude se resuelve en ese endpoint y no en la extensión, así que las credenciales que tienes son las del endpoint, no las de Anthropic.

¿La URL base de Kilo Code debe terminar en /v1?

Sí, para un endpoint compatible con OpenAI. Kilo Code solo añade la ruta — /chat/completions, /models —, así que la URL base debe ser la raíz /v1; por ejemplo, https://api.kunavo.com/v1. El ejemplo documentado por la propia herramienta lleva el mismo sufijo. Si falta /v1, se produce un error 404, no un error de autenticación.

¿Por qué Kilo Code no muestra modelos después de añadir un proveedor?

La lista de modelos se obtiene de la ruta /v1/models del endpoint con la clave que introdujiste, así que una lista vacía suele indicar que la clave o la URL base son incorrectas, no que el proveedor carezca de modelos. Prueba el mismo par con un curl directo a /v1/models: si recibes JSON, el problema está en la configuración de la extensión; un 401 indica un problema con la clave y un 404, con la URL. También puedes escribir los modelos manualmente en cualquier momento.