Roo Code con la API de Claude: configuración del proveedor y un modelo por modo

Roo Code es un agente de programación autónomo de código abierto para VS Code, un fork de la familia Cline, distinguido por su sistema de modos y el enrutamiento de modelos por modo. No incluye ningún modelo propio, por lo que necesita una clave de API. Esta guía explica la configuración exacta para ejecutar Claude en Roo Code con una clave sk-kn- a aproximadamente un 30% por debajo del precio de lista de Anthropic en los modelos principales, cómo utilizar perfiles de configuración para gastar en modelos potentes solo donde compensa, cuánto cuesta una sesión y cuál es honestamente la diferencia frente a llamar directamente a Anthropic.

Por qué Roo Code necesita una clave de API

Cada paso que realiza Roo Code —leer un archivo, escribir un diff, ejecutar un comando y leer el resultado— es una llamada de modelo facturada por token. Una suscripción claude.ai Pro o Max no lo cubre: los planes de chat y el acceso a la API son productos independientes, y Roo Code se comunica con la API. Como un bucle agéntico reenvía el contexto creciente de la tarea en cada paso, la tarifa por token es la mayor palanca del coste de la sesión; ese es el caso de una pasarela: pago por uso desde una recarga de $10, una clave que también permite acceder a GPT y un saldo que nunca caduca.

Configuración: los tres campos

Abre Settings → Providers 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 después de registrarte y recargar saldo; se muestra una sola vez, así que guárdala inmediatamente; el documento de la clave de la API de Claude explica la rotación y los límites de gasto. Si Roo Code solicita metadatos del modelo, como la ventana de contexto o el límite de salida, toma los valores de la página del modelo; una ventana de contexto declarada por debajo de la real hará que trunque antes de lo necesario.

Prueba primero con algo pequeño antes de permitirle editar código. Un 401 aquí casi siempre corresponde a la clave; un 404 casi siempre corresponde a la URL base o a un slug de modelo inexistente: Kunavo coincide exactamente con los slugs y no crea alias para nombres con sufijo de fecha, por lo que claude-sonnet-4-5-20250929 devuelve 404 mientras que claude-sonnet-4-6 se resuelve.

Modos y perfiles de configuración: la palanca de costes

Roo Code incluye varios modos integrados —Code, Architect, Ask y Debug—, además de modos personalizados que defines tú. Lo importante para el coste es que Roo Code almacena perfiles de configuración de API con nombre y recuerda qué perfil utilizaste por última vez en cada modo. Así, el modelo se convierte en una propiedad del modo, en lugar de algo que debas recordar cambiar:

# One API configuration profile per job, all on the same sk-kn- key.
# Roo Code remembers the profile you last used in each mode.

Profile "strong"         model claude-opus-5        -> bind to Architect and Debug
Profile "code-default"   model claude-sonnet-5      -> bind to Code mode
Profile "ask-cheap"      model claude-haiku-4-5     -> bind to Ask mode

Esto funciona porque los modos tienen perfiles de tokens muy diferentes. Architect consiste en unos pocos turnos con mucho razonamiento, en los que la calidad del modelo determina si los siguientes veinte pasos serán productivos: representa una pequeña parte del total de tokens, por lo que un modelo potente cuesta poco en términos absolutos. Code consiste en muchos pasos mecánicos, cada uno reenviando el contexto, y ahí es donde se acumula la tarifa por token. Ask suele ser de una sola respuesta y no necesita en absoluto un modelo de vanguardia.

Los cálculos detallados aparecen a continuación: tres pasos de Architect en Opus 5 más diecisiete pasos de Code en Sonnet 5 suman aproximadamente $1.06 frente a $0.87 para una ejecución completa en Sonnet; aproximadamente un 23% más por una planificación materialmente mejor y mucho más barato que ejecutarlo todo en Opus.

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

Roo Code también ofrece un proveedor nativo Anthropic con un campo de URL base personalizado. Al dirigirlo a https://api.kunavo.com —solo el origen, sin /v1, porque ese cliente añade /v1/messages por su cuenta—, las solicitudes pasan por la Messages API nativa. Pegar aquí la forma /v1 produce un 404 que parece indicar que falta el modelo.

Lo que ofrece esa ruta es el almacenamiento en caché de prompts: cache_control pasa sin traducir y la entrada almacenada en caché se factura al 10 % de la tarifa de entrada (cómo funciona). En un bucle que reenvía un prefijo estable en cada paso, este es el mayor ahorro disponible, superior al de cualquier cambio de modelo. Ambas rutas funcionan; OpenAI Compatible es más sencilla para empezar, y cambiar entre ellas solo requiere modificar la configuración.

A qué modo vincular cada modelo Claude

Todos utilizan la misma clave y el mismo endpoint; solo difiere el slug del modelo, por lo que un perfil se cambia con una sola palabra. 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 actualizado está en la página de precios.

Roo Code en Kunavo frente a llamar directamente a Anthropic

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

Esa fila de capacidad es la verdadera compensación, expresada claramente. Si necesitas una cuota garantizada, un SLA contractual o una relación de compras con el proveedor del modelo, llama directamente: eso es lo que compras con la diferencia de precio. Para un desarrollador individual o un equipo pequeño que ejecuta Roo Code, la compensación suele inclinarse en la dirección opuesta.

Cuánto cuesta realmente una sesión de Roo Code

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 Code-mode step: Roo 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 on the Code-mode default:
print(20 * step_cost("claude-sonnet-5", 25_000, 1_200))    # -> ~$0.87
# Architect mode on Opus 5 for 3 steps, Code mode on Sonnet 5 for 17:
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 indefinidamente. Roo Code 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 tiene un contexto nuevo y pequeño: el hábito con mayor impacto aquí.
2. Vincula un perfil por modo. Como se explicó arriba, convierte el enrutamiento de modelos en configuración, en lugar de algo que debas recordar a mitad de la tarea.
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 y comprueba el uso después de una semana real; esa es la única estimación honesta de lo que te cuesta.

Preguntas frecuentes