Roo Code con Claude y GPT: configurar una API propia

Roo Code es un agente de programación con IA de código abierto para VS Code. Trabaja por modos, como Code, Architect y Ask, lee y edita archivos de tu proyecto y ejecuta comandos con tu aprobación. Roo Code no incluye un modelo: conectas un proveedor de API y cada paso de una tarea es una solicitud que factura ese proveedor.

APIVAI te da una sola clave para modelos Claude y GPT, facturada por token por debajo de los precios oficiales, desde un saldo que recargas tú. La misma clave funciona en el formato de OpenAI y en el de Anthropic, así que sirve para las dos opciones de proveedor relevantes en Roo Code, y puedes asignar un modelo distinto a cada modo sin gestionar varias cuentas.

Elige OpenAI Compatible si quieres modelos GPT o un ID de Claude que la lista integrada de Roo Code aún no muestra. Elige Anthropic si solo usas Claude: el proveedor Anthropic de Roo Code añade marcas cache_control al prompt de sistema y a los mensajes recientes, así que el contexto repetido puede leerse de la caché a $0.10 por millón de tokens con Claude Sonnet 4.6, en lugar del precio completo de entrada. Escribir en caché cuesta $1.31 por millón. Con los perfiles (más abajo) puedes tener ambos y cambiar según el modo.

1. Regístrate en apivai.com con tu correo.
2. Recarga desde $10 con tarjeta, cripto, Alipay o WeChat Pay. No hay prueba gratuita ni suscripción.
3. En el Dashboard, crea una clave y cópiala. Ponle un límite de presupuesto si quieres un tope firme para lo que puede gastar Roo Code.

1. En VS Code, abre el panel de Roo Code, pulsa el icono del engranaje y entra en Providers.
2. En API Provider, elige OpenAI Compatible.
3. Rellena los campos de la tabla y guarda.

La Base URL termina en /v1 una sola vez; Roo Code le añade /chat/completions. La configuración del modelo también incluye Context Window, Image Support y Computer Use; déjalos por defecto salvo que tengas un motivo para cambiarlos. Los campos de precio solo cambian la estimación de coste que muestra Roo Code; los cargos reales están en el Dashboard.

Roo Code usa exclusivamente llamadas a herramientas nativas, así que el modelo debe admitir function calling. APIVAI transmite las llamadas a herramientas en /v1/chat/completions, y los modelos Claude y GPT recomendados más abajo las admiten.

Comprueba qué IDs puede usar tu clave:

Los modelos se añaden y se retiran con el tiempo, así que copia los IDs de esta lista o de la página de precios.

1. En Providers, pulsa el botón + junto al selector de perfiles y ponle nombre al nuevo perfil, por ejemplo "APIVAI Claude".
2. En API Provider, elige Anthropic.
3. Pega tu clave de APIVAI en Anthropic API Key.
4. Marca Use custom base URL e introduce https://api.apivai.com.
5. Elige un modelo Claude en el desplegable Model.

No añadas /v1: Roo Code pasa esta dirección al SDK de Anthropic, que agrega /v1/messages por su cuenta, así que https://api.apivai.com/v1 se convertiría en /v1/v1/messages y devolvería 404. Consulta la página del proxy de la API de Claude para el formato de Anthropic.

Roo Code recuerda qué perfil de configuración usaste por última vez en cada modo, y en la configuración de los modos puedes asignar un perfil de forma explícita. Un reparto sensato: un perfil con Claude Opus 5.5 para Architect (planificación), Claude Sonnet 4.6 para Code y uno barato con Claude Haiku 4.5 o GPT-6 Luna para Ask. Todos los perfiles pueden usar la misma clave de APIVAI.

Precios por 1M de tokens de entrada / salida a fecha de 2026-10-07:

Los modelos GPT necesitan el proveedor OpenAI Compatible. Si una tarea da vueltas en círculo con Sonnet, cambia el perfil de esa tarea a Opus en lugar de convertir Opus en tu modelo por defecto.

Cada paso de una tarea de Roo Code reenvía la conversación y los archivos leídos hasta ese momento, así que los tokens de entrada son la mayor parte del gasto. Dos ejemplos calculados:

• Una tarea en modo Code con Claude Sonnet 4.6: unas 25 solicitudes de 35.000 tokens de entrada y 2.000 de salida cada una. Coste: $1.17 con APIVAI, $3.38 a precios oficiales.
• Un mes de trabajo con tres tareas así al día durante 22 días (1.650 solicitudes): $77.29 con APIVAI, $223 a precios oficiales. Pasar 20 preguntas diarias del modo Ask a Claude Haiku 4.5 (8.000 tokens de entrada y 800 de salida cada una, 440 al mes) solo añade $1.84.

Estas cifras no incluyen la caché de prompts, que abarata el contexto repetido cuando usas el proveedor Anthropic. Los tokens de razonamiento se cuentan como tokens de salida. Tus cifras reales por solicitud están en el Dashboard. Para una comparación más amplia, lee los precios de la API de Claude en 2026.

• 401 / clave no válida: la clave está incompleta, se eliminó o superó su límite de presupuesto; revisa el Dashboard. Con el proveedor Anthropic, comprueba que Use custom base URL esté marcado; si no, la clave va directamente a Anthropic.
• 404 Not Found: /v1 incorrecto. OpenAI Compatible: https://api.apivai.com/v1, sin /chat/completions al final. Anthropic: https://api.apivai.com, sin /v1.
• Modelo no encontrado: usa el ID exacto, como claude-sonnet-4-6, no un nombre comercial. Compáralo con GET /v1/models.
• Errores de llamadas a herramientas: elige un modelo que admita function calling, como los de la tabla anterior.
• Respuestas vacías o truncadas: el razonamiento está activado por defecto y consume tokens de salida. Pon Max Output Tokens en 8192 (mínimo 4096).
• 429 Too Many Requests: el límite por defecto es de 60 solicitudes por minuto por clave. Espera un poco o pide a soporte que lo amplíe.

Hay más información sobre los formatos de solicitud en la documentación y en la página de API compatible con OpenAI.

Sí. Una clave de APIVAI sirve para todos los modelos. Crea un perfil por modelo o cambia el campo Model en un perfil OpenAI Compatible.

Usa OpenAI Compatible para los modelos GPT y para cualquier ID que falte en la lista de Roo Code. Usa Anthropic para trabajar solo con Claude, donde Roo Code solicita caché de prompts; la URL base va sin /v1.

Sí. Roo Code vincula los perfiles de configuración a los modos, así que Architect puede usar Opus mientras Code usa Sonnet, todo con la misma clave.

No. El contenido de las solicitudes y respuestas no se registra; solo se conservan datos de uso como el modelo, los tokens y el coste para la facturación.

Casi igual. Consulta la guía de configuración de Cline; los nombres de los campos y las URL son los mismos.

Crea una cuenta, recarga desde $10 y pega tu clave en Roo Code.