Configuración de Coding Agents

Configurar Kilo Code: API Key, Base URL y modelos

Instala Kilo Code, configura la Base URL y la API Key de BetterToken, elige un modelo disponible y corrige los errores habituales. Más.

Para conectar Kilo Code con BetterToken, prepara una API Key, introduce la Base URL indicada a continuación y elige un ID de modelo vigente en la model plaza.

Tres pasos para la primera solicitud

Obtén una API Key de BetterToken y elige un Model ID en la model plaza.
Añade un Custom provider en los ajustes Providers de Kilo Code, elige OpenAI Compatible e introduce la API Key, https://bettertoken.ai/v1 y el Model ID.
Guarda la configuración, reinicia la extensión y envía una solicitud breve en un chat nuevo.

Ajustes principales

Campo	Valor
API Key	BetterToken API Key
Base URL	`https://bettertoken.ai/v1`
Modelo	Un ID de modelo vigente de la model plaza

Requisitos previos

La versión actual de la herramienta está instalada
Una BetterToken API Key: regístrate y obtén una
Un ID de modelo de la model plaza

Regístrate y obtén una BetterToken API Key

¿Ya tienes una cuenta? Inicia sesión, recarga el saldo y crea una clave en la consola.

Requisitos adicionales

VS Code instalado

Instalación

Si Kilo Code ya está instalado, ve directamente a la configuración manual para introducir tu BetterToken API Key, Base URL y Model ID.

Si todavía necesitas instalar la extensión o quieres contexto sobre la instalación y el uso regional, consulta la guía en inglés de instalación y API personalizada de Kilo Code y vuelve aquí para usar los campos de configuración actuales.

Configuración manual

Completa esta configuración en la interfaz de ajustes de Kilo Code. No necesitas editar un archivo de configuración.

Campo	Valor
API Key	BetterToken API Key
Base URL	`https://bettertoken.ai/v1`
Modelo	Un ID de modelo vigente de la model plaza

Pasos de configuración

Elimina las variables de entorno en conflicto

unset OPENAI_API_KEY
unset OPENAI_BASE_URL

Abre los ajustes de Kilo Code

Abre Settings (icono de engranaje), selecciona Providers y haz clic en Custom provider al final de la lista.

Configura el proveedor de API

Completa estos campos:

Provider ID → bettertoken
Display name → BetterToken
Provider API → OpenAI Compatible
Base URL → https://bettertoken.ai/v1
API Key → tu BetterToken API Key
Models → añade manualmente un ID de modelo copiado desde la model plaza y usa ese mismo ID como nombre visible

Haz clic en Submit para guardar el proveedor. Estos son los campos de la extensión de VS Code descritos en la guía oficial de modelos personalizados.

Configura cabeceras adicionales solo si la documentación oficial las exige

El material oficial de Kilo Code que revisamos menciona cabeceras personalizadas opcionales para proveedores compatibles con OpenAI, pero no considera User-Agent un paso obligatorio para configurar BetterToken.

Si también usas un gateway personalizado, enrutamiento por tenant, observabilidad o una capa de caché, añade cabeceras únicamente según la documentación oficial de ese servicio original.

Reinicia Kilo Code

Después de cambiar la configuración, reinicia VS Code o recarga la extensión Kilo Code para aplicar los nuevos ajustes.

Verifica la conexión

Abre un chat nuevo en Kilo Code y envía un prompt breve, por ejemplo: Responde con una palabra: OK. Si responde sin errores de autenticación ni de Model ID, la primera solicitud ha funcionado. Reinicia VS Code o la extensión después de cambiar la configuración. Si falla, consulta Errores habituales.

Kilo CLI

Instala el Kilo CLI oficial por separado de la extensión. En pruebas en macOS con un modelo GPT, Kilo CLI 7.8.17 completó solicitudes de texto y llamadas a herramientas de lectura de archivos mediante /v1/chat/completions.

Define tu BetterToken API Key en el terminal:

export BETTERTOKEN_API_KEY="YOUR_API_KEY"

Crea kilo.json en tu proyecto. Sustituye cada YOUR_MODEL_ID por el ID exacto de la model plaza:

{
  "provider": {
    "bettertoken": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "BetterToken",
      "options": {
        "baseURL": "https://bettertoken.ai/v1",
        "apiKey": "{env:BETTERTOKEN_API_KEY}"
      },
      "models": {
        "YOUR_MODEL_ID": { "name": "YOUR_MODEL_ID" }
      }
    }
  },
  "model": "bettertoken/YOUR_MODEL_ID",
  "permission": { "read": "allow", "edit": "deny", "bash": "deny" },
  "agent": { "build": { "steps": 4 } }
}

Asigna esa ruta a KILO_CONFIG y ejecuta una prueba de texto sin interfaz:

export KILO_CONFIG="$PWD/kilo.json"
kilo run --format json -m bettertoken/YOUR_MODEL_ID "Reply with only: OK"

Comprueba que la respuesta final contenga OK. Esta configuración permite leer archivos y bloquea cambios y comandos shell. Al pasar el archivo mediante KILO_CONFIG, se convierte en una fuente de confianza que permite resolver referencias {env:...}. Una configuración de proyecto cargada solo desde el repositorio no resuelve referencias a variables de entorno; mantén la selección explícita de KILO_CONFIG indicada arriba.

Cambia de modelo

Abre el selector de modelos o cambia el campo Model de la configuración. Usa el ID de modelo exacto de la model plaza y reinicia la sesión actual.

Errores habituales

Error	Qué comprobar
`401` o `Unauthorized`	Comprueba la BetterToken API Key y elimina los espacios iniciales o finales.
`404`	Comprueba la Base URL y no añadas una ruta específica de endpoint.
`model not found`	Copia un ID de modelo vigente desde la model plaza.
Los cambios no se aplican	Guarda la configuración y reinicia la herramienta por completo.

Detalles técnicos

Protocolo, endpoint y campos internos del proveedor

Esta configuración usa https://bettertoken.ai/v1. La herramienta añade la ruta del endpoint compatible con OpenAI. No añadas /chat/completions ni /responses salvo que un campo concreto lo exija explícitamente.