Qué es Kilo Code
Kilo Code es un asistente de programación con IA para IDEs y terminales. Puede usar Capriole AI a través del proveedor compatible con OpenAI de Kilo, que envía solicitudes a la API compatible con Chat Completions de Capriole AI.Requisitos previos
Antes de empezar, asegúrate de tener:- Una cuenta de Capriole AI (Regístrate aquí)
- Una clave API de Capriole AI (Obtén tu clave)
- Kilo Code instalado en VS Code o como Kilo CLI
Instalación
Extensión de VS Code
Instala Kilo Code desde la vista Extensions de VS Code. BuscaKilo Code e instala la versión pre-release.
Kilo CLI
Configuración
Validación de modelos
Kilo Code 7.3.16:anthropic/claude-fable-5-1, google/gemini-3.8-flash y zai/glm-5.3-flash superan las pruebas locales de lectura de archivos y respuesta final. claude-latest se resuelve a Fable 5.1. Los IDs concretos anteriores siguen disponibles.
Las pruebas de Gemini 3.8 Flash usan "tool_call": true.
xai/grok-4.6 acepta solicitudes de Chat Completions, pero no superó las pruebas de tareas de agentes, por lo que no se incluye en la configuración siguiente. Las pruebas directas al proveedor también detectaron un uso de herramientas inconsistente con Grok 4.5; completar una solicitud API no demuestra que la respuesta del agente sea correcta.
Crea o actualiza tu archivo de configuración de Kilo:
- Configuración global:
~/.config/kilo/kilo.jsonc - Configuración del proyecto:
kilo.jsonco.kilo/kilo.jsoncen la raíz de tu proyecto
Ejecutar Kilo Code
Define tu clave API y luego inicia Kilo desde el directorio de tu proyecto:kilo run:
Modelos compatibles
Empieza conopenai-latest en las configuraciones nuevas de Kilo Code. Usa claude-latest o google-latest cuando quieras que Capriole AI enrute a nuestro modelo insignia recomendado de Claude o Gemini, y usa un ID de modelo concreto cuando necesites una versión exacta.
La documentación de Kilo usa el mismo orden de familias que el selector de modelos de Capriole AI: OpenAI, Anthropic y luego Google. Las integraciones de la API pública excluyen presets solo del chat web como Fable 5 Thinking y Opus 5 Thinking.
openai-latestopenai/gpt-6-astraopenai/gpt-5.6-terraopenai/gpt-5.6-lunaopenai/gpt-5.5claude-latestanthropic/claude-fable-5-1anthropic/claude-fable-5anthropic/claude-opus-5anthropic/claude-opus-4-8anthropic/claude-opus-4-7anthropic/claude-opus-4-6anthropic/claude-sonnet-4-6google-latestgoogle/gemini-3.1-pro-previewgoogle/gemini-3.8-flashxai/grok-4.5zai/glm-5.3-flashzai/glm-5.2moonshot/kimi-k3
GET /v1/models también se pueden configurar cuando quieras probarlos. Valida el uso de herramientas antes de usar un modelo en flujos de trabajo de edición de código.
Solución de problemas
¿Por qué Kilo Code devuelve un error de autenticación?
Confirma queCAPRIOLE_AI_API_KEY está exportada en el mismo shell antes de ejecutar kilo.
¿Qué archivo de configuración debo editar?
Usa~/.config/kilo/kilo.jsonc para la Kilo CLI y la extensión de VS Code actuales. Ejecuta kilo config check después de editarlo.
¿Por qué las solicitudes fallan con errores de endpoint?
Confirma quebaseURL es https://api.caprioletech.com/v1. Kilo envía solicitudes de Chat Completions a /v1/chat/completions.
¿Por qué Kilo Code dice que falta el modelo?
Confirma que el modelo seleccionado usa el formatoopenai-compatible/<model-id> y que provider.openai-compatible.models contiene la entrada de modelo coincidente. Por ejemplo, openai-compatible/openai-latest se asigna a la clave de configuración openai-latest.
¿Por qué falla el uso de herramientas?
Para las entradas de GPT, Claude, Gemini 3.1 Pro, Gemini 3.8 Flash y alias latest, confirma que la entrada del modelo incluye"tool_call": true. Kilo Code ejecuta las herramientas en local y envía solicitudes de seguimiento de Chat Completions a Capriole AI.
Notas
- Capriole AI expone Kilo Code a través de
POST /v1/chat/completions. - Kilo Code ejecuta las herramientas de programación en local. Capriole AI solo gestiona la solicitud de modelo.
- Kilo Code 7.3.16 completa una llamada streaming a una herramienta bash y el turno de asistente de seguimiento con Kimi K3.
- Mantén primero la configuración del proveedor al mínimo. Añade límites de modelo de Kilo u otras opciones de modelo solo cuando quieras de forma intencionada la gestión de contexto del lado del cliente.
- Referencias oficiales: Kilo OpenAI Compatible provider, Kilo settings, Kilo custom models, Kilo CLI y Gemini function calling.