Cline con la API de Claude: configuración de la URL base, enrutamiento de modelos Plan/Act y costes reales

Cline es un agente de programación autónomo de código abierto para VS Code y no incluye un modelo: debes conectarlo a uno, normalmente con tu propia clave de API. Esta guía muestra la configuración exacta para ejecutar Claude en Cline mediante una clave sk-kn- a aproximadamente un 30 % por debajo del precio de lista de Anthropic en los modelos principales: ambas rutas de proveedor, cómo aprovechar los modos Plan/Act para reducir la factura, cuánto cuesta una sesión real y una explicación honesta de lo que cedes frente a llamar directamente a Anthropic.

Por qué Cline necesita una clave de API

Cada acción que realiza Cline —leer un archivo, proponer un diff, ejecutar un comando de terminal, leer la salida e intentarlo de nuevo— es una llamada al modelo. Cline puede ejecutar esas llamadas con una suscripción Claude Pro o Max mediante su proveedor Claude Code, que controla la CLI de Claude y utiliza los límites de tu suscripción en lugar de facturación de API, con los inconvenientes que la documentación de Cline enumera en septiembre de 2026: las respuestas pueden no transmitirse token a token, y las cargas de imágenes y la caché de prompts están limitadas en ese modo. Cualquier otra ruta, incluidos los proveedores OpenAI Compatible y Anthropic que configura esta guía, factura por token mediante una clave de API. En esas rutas, la cuestión no es si pagar por token, sino a qué tarifa; como un bucle agéntico vuelve a enviar el contexto creciente de la tarea en cada paso, la tarifa por token es el factor individual más importante del coste de una sesión. Ese es todo el argumento a favor de una puerta de enlace: pago por uso desde una recarga de $10, una clave que también llega a GPT y un saldo que nunca caduca.

Configuración: los tres campos

Abre el panel de Cline, haz clic en el engranaje de configuración y establece el proveedor de API en OpenAI Compatible. Tres valores:

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

Crea la clave en el panel de control después de registrarte y añadir fondos; se muestra una sola vez, así que guárdala de inmediato. La gestión y rotación de claves y los límites de gasto se describen en el documento sobre claves de la API de Claude. Si Cline solicita metadatos del modelo, como la ventana de contexto o el límite de salida, toma las cifras de la página del modelo en lugar de adivinarlas; una ventana de contexto infravalorada hace que Cline trunque antes de lo necesario.

Antes de permitirle editar nada, pídele algo pequeño (“explica este archivo”) para confirmar la conexión. Un 401 en este punto casi siempre es la clave; un 404 casi siempre es la URL base o un slug de modelo inexistente: Kunavo coincide exactamente con los slugs y no crea alias para nombres con fecha, por lo que claude-sonnet-4-5-20250929 produce un 404 mientras claude-sonnet-4-6 funciona.

Modo Plan y modo Act: la división más económica

La característica definitoria de Cline es que separa Plan (leer el código base, hacer preguntas, proponer un enfoque) de Act (realizar las ediciones, ejecutar los comandos) y permite configurar un modelo diferente para cada uno. Esto encaja casi perfectamente con el coste, porque ambos modos tienen perfiles de tokens muy distintos:

• Plan es corto y exige mucho razonamiento. Un puñado de turnos en los que la calidad del modelo decide si los veinte pasos siguientes serán productivos o desperdiciados. Pon claude-opus-5 aquí: representa una pequeña parte de los tokens, por lo que el modelo más potente cuesta poco en términos absolutos.
• Act es largo y mecánico. Muchos pasos, cada uno reenviando el contexto. Aquí se acumula la tarifa por token, así que el Sonnet más barato corresponde a este modo: claude-sonnet-5 en Kunavo hoy.

Los números desarrollados aparecen en la sección de costes: planificar tres pasos con Opus 5 y ejecutar diecisiete con Sonnet 5 cuesta aproximadamente $1.06 frente a $0.87 en una ejecución totalmente con Sonnet, alrededor de un 23 % más por una planificación considerablemente mejor y mucho menos que ejecutar toda la tarea con Opus.

La ruta nativa de Anthropic (y por qué podrías quererla)

Cline también incluye un proveedor nativo Anthropic con un campo de URL base personalizado. Apuntarlo a Kunavo utiliza la API Messages nativa (/v1/messages) en lugar del endpoint compatible con OpenAI:

API Provider   Anthropic
Base URL       https://api.kunavo.com   # origin only — the client appends /v1/messages
API Key        sk-kn-...
Model ID       claude-sonnet-5

Ten en cuenta que la URL base difiere entre ambas rutas. El proveedor compatible con OpenAI requiere https://api.kunavo.com/v1; el proveedor Anthropic requiere el origen sin más, https://api.kunavo.com, porque ese cliente añade /v1/messages por sí mismo. Pegar la forma /v1 en el proveedor Anthropic produce un 404 que parece indicar que falta el modelo.

Lo que ofrece la ruta nativa es la caché de prompts: cache_control se transmite sin traducir y la entrada almacenada en caché se factura al 10 % de la tarifa de entrada (consulta el documento sobre caché de prompts). En un bucle que reenvía un prefijo estable en cada paso, ese es el mayor ahorro disponible, superior al de cualquier cambio de modelo. Ambas rutas funcionan; la compatible con OpenAI es más sencilla para empezar y cambiar después solo requiere modificar la configuración.

Qué modelo Claude establecer

Cambiarlo requiere modificar una sola palabra en el campo del modelo: misma clave, misma configuración del proveedor y mismo endpoint. Las tarifas completas por modelo frente a la lista oficial de Anthropic están en la lista de precios de la API de Anthropic Claude, y el catálogo actual está en la página de precios.

Cline en Kunavo frente a llamar directamente a Anthropic

La comparación honesta, incluido cuándo es mejor llamar directamente:

Lee esa fila de capacidad tal como está escrita. Si tu equipo necesita una cuota garantizada, un SLA contractual o una relación de compras con el proveedor del modelo, ve directamente al proveedor: eso es por lo que pagas la diferencia. Para un desarrollador individual o un equipo pequeño que ejecuta Cline, la compensación suele ser la contraria.

Cuánto cuesta realmente una sesión de Cline

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),
    "claude-opus-5":     (3.50, 17.50),
}

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 Act-mode step: Cline resends the task context plus the files it read.
print(step_cost("claude-sonnet-5", 25_000, 1_200))         # -> $0.0434
# A realistic 20-step task (edit, run, read the error, fix, repeat):
print(20 * step_cost("claude-sonnet-5", 25_000, 1_200))    # -> ~$0.87
# The same task planned on Opus 5, executed on Sonnet 5:
print(3 * step_cost("claude-opus-5", 25_000, 1_200)
      + 17 * step_cost("claude-sonnet-5", 25_000, 1_200))   # -> ~$1.06

Cómo reducir la factura

1. Inicia tareas nuevas en lugar de prolongar una para siempre. Cline reenvía toda la conversación en cada paso, por lo que una tarea de larga duración crece cuadráticamente en coste. Una tarea nueva es un contexto nuevo y pequeño; este es el hábito con mayor impacto de la lista.
2. Divide Plan y Act entre modelos. Se ha explicado arriba: es un campo de configuración, no un problema de disciplina.
3. Utiliza la ruta nativa de Anthropic para el almacenamiento en caché. La entrada almacenada en caché al 10 % de la tarifa de entrada es el mayor ahorro estructural en un bucle que reenvía un prefijo estable.
4. Asigna al editor una clave propia con límite de gasto. Crea una clave separada en el panel de control, establece en ella un límite de gasto mensual y observa el uso: una semana de programación agéntica real es la única estimación honesta de lo que esto te cuesta. El límite se comprueba antes de cada solicitud y se restablece con el mes natural, y la clave puede revocarse por separado, así que detener el editor es una sola acción en lugar de rotarlo todo.
5. ¿Sigues eligiendo entre las dos herramientas? Cline frente a Claude Code compara las formas de facturación en lugar de las listas de funciones; ambas funcionan contra este mismo endpoint, así que la elección sigue siendo reversible.

Preguntas frecuentes