Kilo Code con la API de Claude: configuración de URL base compatible con OpenAI y enrutamiento por modo

Kilo Code es uno de los agentes de programación de IA de código abierto más utilizados para VS Code y, al igual que sus compañeros de la familia Cline, permite usar tu propio endpoint compatible con OpenAI. Eso significa que puedes ejecutar Claude dentro de tu editor con una sola clave sk-kn-, a aproximadamente un 30% por debajo del precio de lista de Anthropic en los modelos principales. Esta guía explica la configuración de tres campos, qué modelo de Claude elegir para cada tarea y cuánto cuesta realmente una sesión de programación agéntica.

Por qué Kilo Code necesita una clave de API

Kilo Code no incluye un modelo; cada acción (leer un archivo, proponer una edición, ejecutar un comando o comprobar el resultado) es una llamada a la API, facturada por token. Una suscripción de chat como Claude Pro no cubre esto; la extensión necesita acceso directo a la API. Esa es exactamente la modalidad que ofrece Kunavo: pago por uso desde una recarga de $10, una clave para Claude y GPT y un saldo que nunca caduca. Como los bucles agénticos vuelven a enviar el contexto creciente de la tarea en cada paso, la tarifa por token es el factor que más influye en el coste de una sesión; por eso el descuento de aproximadamente ~30% en claude-sonnet-5 se acumula rápidamente.

Los tres campos

Kilo Code expone el proveedor mediante tres campos de configuración:

API Provider   OpenAI Compatible
Base URL       https://api.kunavo.com/v1
API Key        sk-kn-...          # create at kunavo.com/app/keys
Model ID       claude-sonnet-5        # or claude-opus-5 / claude-haiku-4-5

Obtén la clave en el panel después de registrarte y recargar $10; se muestra una sola vez, así que guárdala de inmediato. La gestión completa de claves se explica en la documentación de claves de la API de Claude.

Configuración de Kilo Code

1. Instala Kilo Code desde el marketplace de VS Code y ábrelo desde la barra lateral.
2. Abre la configuración de la extensión (icono de engranaje) y ve a la sección Providers.
3. Establece API Provider en OpenAI Compatible.
4. URL base: https://api.kunavo.com/v1 · clave de API: tu clave sk-kn-… · modelo: claude-sonnet-5.
5. Guarda la configuración y pídele algo pequeño («explica este archivo») para confirmar la conexión antes de permitirle editar código.

Kilo Code admite sustituciones de modelo por modo (Architect / Code / Debug): un buen lugar para dirigir la planificación a un modelo más potente (claude-opus-5) y la ejecución a uno más barato (claude-sonnet-5).

Cline y Roo Code

Kilo Code y Roo Code son forks de la familia Cline, por lo que los tres campos anteriores son idénticos en las tres herramientas: proveedor OpenAI Compatible, URL base https://api.kunavo.com/v1, clave e ID del modelo. Lo que cambia es la función que cada una ofrece para dirigir los modelos, y ahí es donde están los ahorros; por eso cada una tiene su propia guía: Cline con la API de Claude explica su división Plan/Act, y Roo Code con la API de Claude explica sus perfiles de configuración con nombre y la vinculación de modelos por modo.

Las tres herramientas también incluyen un proveedor nativo de Anthropic con una opción de URL base personalizada. Apuntar esa opción a https://api.kunavo.com utiliza en su lugar la API de Messages nativa (/v1/messages); resulta útil porque cache_control se transmite sin traducir y la entrada almacenada en caché se factura al 10% de la tarifa de entrada (consulta la documentación del almacenamiento en caché de prompts). Ambas rutas funcionan; la compatible con OpenAI es la más sencilla para empezar.

Qué modelo de Claude elegir

claude-opus-5 es la opción de razonamiento sólido aquí: es el Opus más reciente de Anthropic y se factura al mismo $3.50 / $17.50 que el claude-opus-4-7 de generación anterior ($3.50 / $17.50), que sigue disponible si lo has fijado. Como el campo del modelo es solo un slug en el mismo endpoint, cambiarlo requiere modificar una sola palabra: no hace falta una clave nueva ni una configuración nueva del proveedor. Las tarifas completas de todos los modelos están en la guía de precios de la API de Claude y en la página de precios.

Cuánto cuesta realmente una sesión

Las herramientas agentivas consumen muchos tokens por diseño: cada paso vuelve a enviar el prompt del sistema, el historial de la tarea y contexto nuevo de archivos. Cifras realistas con las tarifas de Kunavo:

Las cuentas, listas para ejecutar:

# Kunavo Claude rates (USD per 1M tokens): (input, output)
RATES = {
    "claude-haiku-4-5":  (0.70, 3.50),
    "claude-sonnet-5":   (1.40, 7.00),
}

def step_cost(model, in_tokens, out_tokens):
    i, o = RATES[model]
    return in_tokens / 1_000_000 * i + out_tokens / 1_000_000 * o

# One agentic step: the tool resends the task context + file reads.
print(step_cost("claude-sonnet-5", 25_000, 1_200))         # -> $0.0434
# A realistic 20-step task (edit, run, fix, repeat):
print(20 * step_cost("claude-sonnet-5", 25_000, 1_200))    # -> ~$0.87

Cómo reducir la factura

1. Empieza tareas nuevas en vez de prolongar una indefinidamente. La herramienta vuelve a enviar toda la conversación en cada paso, así que una tarea de larga duración resulta costosa de forma cuadrática. Tarea nueva = contexto nuevo y pequeño.
2. Enruta por modo. Kilo Code admite un modelo por modo: Architect en claude-opus-5, Code en claude-sonnet-5 y preguntas rápidas en claude-haiku-4-5. La planificación representa una pequeña parte de los tokens, así que el modelo más potente allí cuesta poco.
3. Usa la ruta nativa de Anthropic para el almacenamiento en caché. La entrada almacenada en caché se factura al 10 % de la tarifa de entrada; en un bucle que reenvía un prefijo estable en cada paso, es el mayor ahorro disponible (cómo funciona).
4. Controla el gasto por clave. Dale al editor su propia clave con un límite de gasto en el panel y consulta el uso para saber cuánto te cuesta realmente una semana de programación agentiva.

Preguntas frecuentes