Saltar al contenido principal
Con una sola clave API de Capriole AI, usas GPT-6.2 Astra, Claude Fable 5.1, Opus 5.5 y Gemini 4 Carbon en Kilo Code pagando hasta un 92% menos que los precios oficiales de la API.

Qué es Kilo Code

Kilo Code es un agente de programación de IA para VS Code y la terminal. Esta configuración añade Capriole AI como un único proveedor personalizado. Cada uno de sus modelos usa el protocolo de API que Capriole AI sirve para esa familia de modelos.

Requisitos previos

Antes de empezar, asegúrate de tener:
  • Una cuenta de Capriole AI (Regístrate aquí)
  • Un plan Premium (USD 9 al mes, también incluye chat web ilimitado) o un plan Team, necesario para la clave API (Suscríbete)
  • Una clave API de Capriole AI (Obtén tu clave)

Instalación

Kilo CLI

Verifica la instalación:

Extensión de VS Code

Instala Kilo Code desde la vista Extensions de VS Code. La extensión lee el mismo archivo de configuración global que la CLI.

Configuración

Validación de modelos

Kilo CLI 7.8.15 supera una prueba de lectura de archivos, escritura de archivos y respuesta final a través de Capriole AI con todos los modelos de la sección Modelos compatibles, usando la configuración siguiente. Crea o actualiza ~/.config/kilo/kilo.jsonc:
Qué hace cada ajuste:
  • npm: "@ai-sdk/openai-compatible" es el paquete por defecto del proveedor, así que Gemini, Grok, GLM y Kimi usan Chat Completions.
  • Cada modelo GPT sustituye provider.npm por @ai-sdk/openai, que usa la API Responses. Cada modelo Claude lo sustituye por @ai-sdk/anthropic, que usa Anthropic Messages.
  • {env:CAPRIOLE_AI_API_KEY} lee tu clave del entorno. La cabecera Authorization la envía como token Bearer con todos los paquetes.
  • tool_call: true permite que el modelo llame a las herramientas de Kilo.
  • limit define la ventana de contexto y el límite de salida de cada modelo. Sin él, Kilo trata ambos como 0 y no compacta las sesiones largas.
Mantén este proveedor en tu configuración global. Kilo no resuelve las referencias {env:...} en una configuración a nivel de proyecto. Ejecuta kilo config check después de editar el archivo.

Ejecutar Kilo Code

Define tu clave API y luego inicia Kilo desde el directorio de tu proyecto:
Inicia con un modelo concreto:
Para una solicitud puntual, pasa un prompt a kilo run:

Modelos compatibles

Las referencias de modelo usan el formato capriole-ai/<model-id>. openai-latest, claude-latest y google-latest siempre apuntan a nuestro modelo insignia más reciente de cada familia, actualmente GPT-6.2 Astra, Claude Fable 5.1 y Gemini 4 Carbon.

Solución de problemas

¿Por qué Kilo Code devuelve un error de autenticación?

Confirma que CAPRIOLE_AI_API_KEY está exportada en el mismo shell antes de ejecutar kilo y que el proveedor está en ~/.config/kilo/kilo.jsonc, no en una configuración de proyecto.

¿Por qué las solicitudes de Claude fallan con Unsupported Claude Messages model?

Los modelos Claude que usan @ai-sdk/anthropic necesitan los IDs de Claude sin prefijo, como claude-opus-5-5. Los IDs con el prefijo anthropic/ son para Chat Completions.

¿Por qué Kilo Code indica que falta el modelo?

Confirma que el modelo seleccionado usa el formato capriole-ai/<model-id> y que provider.capriole-ai.models tiene una entrada que coincide. Ejecuta kilo models capriole-ai para ver los modelos que Kilo ha cargado.

¿Por qué falla el uso de herramientas?

Confirma que la entrada del modelo incluye "tool_call": true.

Notas

  • Kilo Code ejecuta las herramientas de programación en tu equipo. Capriole AI procesa las solicitudes al modelo.
  • Para añadir otro modelo de Capriole AI, copia la entrada de un modelo de la misma familia y cambia el ID. GET https://api.caprioletech.com/v1/models devuelve la lista de todos los IDs de modelo.
  • Gemini 4 Carbon razona más tiempo que Gemini 4 Argon, así que cada turno puede tardar más y usar más tokens. Para turnos más rápidos, usa google/gemini-4-argon.
  • Para usar la misma clave en tus otros agentes de programación, consulta Usa una sola clave API con agentes de programación.
  • Referencias oficiales: Kilo CLI, modelos personalizados de Kilo, ajustes de Kilo y proveedores de OpenCode.
Última modificación el 18 de noviembre de 2026