Kilo Code con Claude y GPT: configurar un proveedor de API

Respuesta corta

Para usar Kilo Code con APIVAI, abre Settings en Kilo Code, ve a la pestaña Providers, pulsa Custom provider, elige OpenAI Compatible en Provider API, escribe https://api.apivai.com/v1 como Base URL, pega tu clave de APIVAI en API key y añade un ID de modelo como claude-sonnet-4-6 o gpt-5.5. Si solo usas Claude, puedes elegir Anthropic Messages como Provider API, y en Kilo Code esa opción también lleva https://api.apivai.com/v1 con /v1, porque Kilo Code solo añade /messages a la Base URL. A fecha de 2026-10-10, Claude Sonnet 4.6 cuesta $1.15 / $5.74 por millón de tokens de entrada / salida con APIVAI, frente a los $3.00 / $15.00 oficiales. Pagas por token desde un saldo prepago, sin suscripción.

¿Qué es Kilo Code y por qué conectar tu propia clave de API?

Kilo Code es un agente de programación con IA de código abierto que funciona como extensión de VS Code, plugin de JetBrains y herramienta de línea de comandos. Planifica cambios, edita archivos en todo tu proyecto y ejecuta comandos con tu aprobación. Kilo Code necesita un proveedor de modelos, y cada paso de una tarea es una solicitud que factura ese proveedor.

Esta guía sigue la documentación actual de Kilo Code y la extensión de VS Code 7.8 (octubre de 2026), en la que las API de terceros se añaden desde el diálogo Custom provider. Si tu pantalla de configuración no tiene el botón Custom provider, actualiza primero la extensión.

APIVAI te da una sola clave para modelos Claude y GPT, facturada por token (por debajo de los precios oficiales en la mayoría de los modelos), desde un saldo que recargas tú. La misma clave funciona en el formato de OpenAI y en el de Anthropic, así que sirve para todas las opciones de Provider API de Kilo Code.

¿Qué Provider API conviene elegir en Kilo Code?

El diálogo de proveedor personalizado ofrece tres protocolos. Con APIVAI, los tres usan la misma Base URL:

Provider API	Base URL	Modelos	Lista de modelos
OpenAI Compatible	`https://api.apivai.com/v1`	Claude y GPT	Fetch models funciona
Anthropic Messages	`https://api.apivai.com/v1`	Solo Claude	Escribes los IDs tú
OpenAI Responses	`https://api.apivai.com/v1`	GPT	Fetch models funciona

Elige OpenAI Compatible si quieres un solo proveedor para Claude y GPT. Añade un proveedor Anthropic Messages si trabajas sobre todo con Claude: Kilo Code envía entonces solicitudes nativas de Anthropic con marcas cache_control, así que el contexto repetido se cobra al precio de lectura de caché, $0.12 por millón de tokens con Claude Sonnet 4.6, en lugar del precio completo de entrada. Escribir en caché cuesta $1.44 por millón. OpenAI Responses es opcional: los modelos GPT ya funcionan con OpenAI Compatible.

¿Cómo se configura Kilo Code con APIVAI paso a paso?

Paso 1: Crea una clave de APIVAI

Regístrate en apivai.com con tu correo.
Recarga desde $10 con tarjeta, cripto, Alipay o WeChat Pay. No hay prueba gratuita ni suscripción.
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 Kilo Code.

Paso 2: Añade APIVAI como proveedor personalizado

En VS Code, abre el panel de Kilo Code, pulsa el icono del engranaje para abrir Settings y ve a la pestaña Providers.
Desplázate hasta abajo y pulsa Custom provider.
Rellena el diálogo según la tabla y pulsa Submit.

Campo	Valor
Provider ID	`apivai` (minúsculas, números, guiones o guiones bajos)
Display name	APIVAI
Provider API	OpenAI Compatible
Base URL	`https://api.apivai.com/v1`
API key	Tu clave de APIVAI
Models	Pulsa Fetch models y selecciona, por ejemplo, `claude-sonnet-4-6` y `gpt-5.5`

Con la Base URL y la clave rellenadas, Kilo Code llama a GET /v1/models con tu clave y muestra una lista con búsqueda, así que solo añades IDs que APIVAI sirve de verdad. Si la consulta falla, revisa la clave y la URL, o pulsa Add model y escribe el ID exacto. La Base URL contiene /v1 una sola vez; Kilo Code le añade /chat/completions. Después de Submit, elige el modelo en el selector de modelos de Kilo Code.

Puedes comprobar la misma lista desde una terminal:

curl https://api.apivai.com/v1/models \
  -H "Authorization: Bearer YOUR_APIVAI_KEY"

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.

Paso 3 (opcional): Añade un proveedor de Claude con Anthropic Messages

Pulsa Custom provider otra vez.
Pon apivai-claude en Provider ID y "APIVAI Claude" en Display name.
En Provider API, elige Anthropic Messages.
Escribe https://api.apivai.com/v1 como Base URL y pega la misma clave en API key.
En Models, pulsa Add model y escribe cada ID de Claude, por ejemplo claude-sonnet-4-6 y claude-opus-5-5. Fetch models no está disponible para este Provider API.
Pulsa Submit.

Aquí hay que mantener /v1. El cliente Anthropic Messages de Kilo Code trata la Base URL como el prefijo versionado de la API (su propio valor por defecto es https://api.anthropic.com/v1) y solo añade /messages, así que tus solicitudes van a https://api.apivai.com/v1/messages. Es lo contrario de Claude Code y Roo Code, donde la URL base de Anthropic es https://api.apivai.com sin /v1. Encontrarás más sobre el formato de Anthropic en la página del proxy de la API de Claude.

Paso 4: Define los límites de tokens en el archivo de configuración

El diálogo no define límites de contexto ni de salida. La documentación de Kilo Code recomienda fijar limit.context y limit.output para los modelos personalizados: si faltan los dos, valen 0 y la compactación automática del contexto queda desactivada. Edita el proveedor (el diálogo enlaza a Edit advanced settings in the JSON config file) o abre la configuración global ~/.config/kilo/kilo.json y añade los límites en tu proveedor:

{
  "provider": {
    "apivai": {
      "npm": "@ai-sdk/openai-compatible",
      "options": {
        "baseURL": "https://api.apivai.com/v1"
      },
      "models": {
        "claude-sonnet-4-6": {
          "name": "Claude Sonnet 4.6",
          "tool_call": true,
          "limit": { "context": 200000, "output": 16384 }
        }
      }
    }
  },
  "model": "apivai/claude-sonnet-4-6"
}

Pon en limit.context la ventana de contexto que indica la página del modelo y deja limit.output en 16384 (mínimo 4096). La clave que escribiste en el diálogo sigue donde Kilo Code la guardó; si prefieres leerla de una variable de entorno, añade "apiKey": "{env:APIVAI_API_KEY}" a options (funciona en la configuración global, no en un kilo.json del proyecto). La CLI de Kilo lee el mismo archivo.

¿Qué modelo conviene elegir en Kilo Code?

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

ID de modelo	Precio (entrada / salida)	Ideal para
`claude-sonnet-4-6`	$1.15 / $5.74	Programación diaria: la opción por defecto
`claude-sonnet-5-5`	$0.77 / $3.82	Programar con el Sonnet más reciente
`claude-opus-5-5`	$1.54 / $7.65	Planificación, los bugs más difíciles
`claude-haiku-4-5`	$0.38 / $1.92	Preguntas rápidas y baratas, cambios pequeños
`gpt-6-sol`	$0.30 / $1.52	Alternativa GPT para programar o revisar
`gpt-6-luna`	$0.0144 / $0.0768	Preguntas muy baratas

Los agentes de Kilo Code llaman a herramientas en casi cada paso, así que elige modelos que admitan function calling; todos los de la tabla lo hacen. Si una tarea da vueltas en círculo con Sonnet, cambia esa tarea a Opus en lugar de convertir Opus en tu modelo por defecto.

¿Cuánto cuesta Kilo Code con APIVAI?

Cada paso de una tarea del agente 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 de programación con Claude Sonnet 4.6: unas 25 solicitudes de 35.000 tokens de entrada y 2.000 de salida cada una. Coste: $1.29 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): $85.35 con APIVAI, $223 a precios oficiales. Enviar 20 preguntas rápidas al día a Claude Haiku 4.5 (8.000 tokens de entrada y 800 de salida cada una, 440 al mes) añade $2.01.

Estas cifras no incluyen la caché de prompts, que abarata el contexto repetido con el proveedor Anthropic Messages. 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.

¿Cómo se solucionan los errores habituales de Kilo Code?

"Authentication failed" al obtener los modelos, o 401: la clave está incompleta, se eliminó o superó su límite de presupuesto; revisa el Dashboard y vuelve a pegar la clave sin espacios.
404 Not Found: /v1 incorrecto. En Kilo Code, todos los Provider API usan https://api.apivai.com/v1. Sin /v1, Anthropic Messages llama a /messages y OpenAI Compatible a /chat/completions en una ruta equivocada.
Anthropic Messages no encuentra modelos: es lo esperado; este Provider API no consulta la lista. Añade los IDs de Claude con Add model.
Modelo no encontrado: usa el ID exacto, como claude-sonnet-4-6, no un nombre comercial. Compáralo con GET /v1/models.
Respuestas vacías o truncadas: el razonamiento está activado por defecto y consume tokens de salida. Pon limit.output en 16384 (mínimo 4096).
El contexto nunca se compacta en tareas largas: define limit.context y limit.output como en el paso 4.
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.

Preguntas frecuentes

¿Puedo usar Claude y GPT en Kilo Code con una sola clave?

Sí. Una clave de APIVAI sirve para todos los modelos. Un solo proveedor OpenAI Compatible puede listar IDs de Claude y de GPT juntos.

¿Uso OpenAI Compatible o Anthropic Messages?

Usa OpenAI Compatible para los modelos GPT o para tener un solo proveedor. Añade Anthropic Messages para trabajar sobre todo con Claude, donde Kilo Code usa la caché de prompts; su Base URL también es https://api.apivai.com/v1.

¿Por qué Kilo Code necesita /v1 para Anthropic y Claude Code no?

El cliente de Claude Code añade /v1/messages a la URL base, mientras que el cliente Anthropic Messages de Kilo Code solo añade /messages. Ambos terminan en https://api.apivai.com/v1/messages.

¿Sirve la misma configuración en la CLI de Kilo?

Sí. La CLI lee el proveedor de kilo.json, así que el bloque de configuración del paso 4 también funciona allí.

¿APIVAI guarda mi código?

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.

¿En qué se diferencia de Roo Code o Cline?

Los modelos y la clave son los mismos, pero las pantallas cambian. Consulta la guía de Roo Code y la guía de Cline.

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