Saltar al contenido principal
Kilo Code es un agente de programación de IA de código abierto disponible en VS Code, JetBrains, CLI, Slack y Cloud. Se conecta a OrcaRouter a través de su Custom provider (proveedor personalizado) (un endpoint compatible con OpenAI). Esta guía cubre tanto la extensión de VS Code (la forma más habitual de usar Kilo Code) como la CLI (@kilocode/cli, para uso headless).
Protocolo: compatible con OpenAI
  • URL base: https://api.orcarouter.ai/v1 (incluye /v1)
  • Los IDs de modelo usan el formato vendor/model — el más sencillo es orcarouter/auto

​
Extensión de VS Code

  1. Instala Kilo Code desde el Marketplace de VS Code (abre el panel de Extensiones y busca “Kilo Code”), luego ábrelo desde el icono de Kilo Code en la barra de actividad (Activity Bar) (la franja de iconos de la izquierda). En el panel, haz clic en el ⚙ engranaje de la esquina superior derecha para abrir los ajustes.
El panel de Kilo Code con el engranaje de ajustes resaltado
  1. Ve a Providers (proveedores). En Popular providers (proveedores populares), busca Custom provider (proveedor personalizado) (“Add an OpenAI-compatible provider by base URL”) y haz clic en + Connect.
La entrada Custom provider en los ajustes de Providers de Kilo Code
  1. Rellena los campos del proveedor:
    • Provider ID: orcarouter (solo letras minúsculas, números, guiones o guiones bajos — sin barras; orcarouter/auto se rechaza aquí).
    • Display name: OrcaRouter (lo que prefieras).
    • Base URL: https://api.orcarouter.ai/v1
    • API key: tu clave de OrcaRouter (sk-orca-...).
Provider ID, base URL y API key de OrcaRouter en Kilo Code
  1. Elige tus modelos. Una vez que la clave y la URL base sean válidas, Kilo Code obtiene la lista de modelos en vivo de OrcaRouter — marca los que quieras (o Select all), luego haz clic en Submit. Para usar el enrutamiento automático, además usa + Add model con el ID de modelo orcarouter/auto (es un alias de enrutamiento, por lo que no aparecerá en la lista obtenida).
Selector de modelos de Kilo Code mostrando los modelos obtenidos de OrcaRouter
  1. El proveedor ahora aparece en Connected providers (proveedores conectados) como OrcaRouter (CUSTOM).
OrcaRouter listado en Connected providers en Kilo Code
  1. Selecciona el modelo de OrcaRouter en el selector de modelos del panel de chat y envía un mensaje de prueba — una respuesta confirma la conexión.
Kilo Code respondiendo a través de OrcaRouter
En un repositorio grande, es posible que Kilo Code primero te pregunte si quieres esperar a que su sistema de instantáneas se inicialice — elige Disable for this project para omitirlo (git sigue rastreando todo) y así la solicitud pasa.
El complemento de JetBrains usa el mismo Custom provider (proveedor personalizado) con los mismos valores de URL base / clave / modelo.

​
CLI

Para uso headless / mediante scripts, instala la CLI.

​
Instalación

npm install -g @kilocode/cli
El comando es kilo.

​
Configuración

Archivo de configuración: ~/.config/kilo/kilo.jsonc (también acepta kilo.json; el ./kilo.jsonc a nivel de proyecto tiene prioridad). 
{
  "$schema": "https://app.kilo.ai/config.json",
  "provider": {
    "orcarouter": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "OrcaRouter",
      "options": { "baseURL": "https://api.orcarouter.ai/v1", "apiKey": "sk-orca-..." },
      "models": { "orcarouter/auto": { "name": "OrcaRouter Auto" } }
    }
  },
  "model": "orcarouter/orcarouter/auto"
}
Sustitúyelo por un modelo específico si lo prefieres, p. ej. anthropic/claude-opus-4.8 o google/gemini-2.5-flash. Los IDs de modelo usan el formato vendor/model.

​
Ejecución

echo "Reply with exactly: OK" | kilo run --auto --format json
Esperado: un evento JSON con "type":"text" y "text":"OK".

​
Notas

  • La base_url incluye /v1.
  • Las referencias de modelo usan provider/model. Como el proveedor se llama orcarouter y el ID de modelo también lleva un prefijo vendor, la referencia tiene tres segmentos: orcarouter/orcarouter/auto (o orcarouter/anthropic/claude-opus-4.8).
  • El modo headless es kilo run "<prompt>" --auto (o pasa el prompt vía stdin). --format json da un flujo de eventos legible por máquina.
  • Razonamiento/thinking: usa el flag --variant <name> para el esfuerzo de razonamiento específico del proveedor (p. ej. high, max, minimal), y --thinking para mostrar los bloques de razonamiento.
Problema conocido: --auto tiene casos reportados de quedarse colgado tras completarse / cuando falta la clave (kilocode issues). Envuélvelo con un timeout en CI y asegúrate de que la clave esté cargada.