Clave de API de Kilo Code: configura tu propia clave en kilo.json

Pasos de configuración

mkdir -p "$(dirname "$HOME/.config/kilo/kilo.json")"
cat > "$HOME/.config/kilo/kilo.json" << 'EOF'
{
  "$schema": "https://app.kilo.ai/config.json",
  "model": "aicodewith/claude-haiku-4-5-20251001",
  "provider": {
    "aicodewith": {
      "npm": "@ai-sdk/openai-compatible",
      "name": "AI Code With",
      "options": {
        "baseURL": "https://api.aicodewith.ai/v1",
        "apiKey": "sk-***"
      },
      "models": {
        "claude-haiku-4-5-20251001": {
          "name": "Claude Haiku 4.5"
        },
        "gpt-5.5": {
          "name": "GPT-5.5"
        }
      }
    }
  }
}
EOF

Estos pasos se probaron en Linux (bash). macOS y Windows aún no se han probado, por lo que no se incluyen.

1. 1¿Aún no tienes Kilo Code? Instálalo (omítelo si ya está instalado)

   Ejecuta npm i -g @kilocode/cli y luego kilo --version. Un número de versión significa que está instalado.

   Clic para ampliar

2. 2Pega la configuración en kilo.json y añade tu clave de API

   Abre ~/.config/kilo/kilo.json, pega el bloque de la parte superior de esta página y reemplaza sk-*** con tu clave de API (Obtén una clave de API). Después de guardar, el archivo tiene una línea "apiKey": "sk-…", y se conserva al abrir una terminal nueva o reiniciar.

   Clic para ampliar

3. 3Abre una terminal nueva y prueba Kilo Code

   Abre una terminal nueva y ejecuta kilo run -m aicodewith/claude-haiku-4-5-20251001 "Reply with exactly: OK". OK significa que Kilo Code está usando tu clave de API.

   Clic para ampliar

4. 4¿No ves OK? Compara tu error

   Compara el error en tu terminal con Errores comunes a continuación. Cada uno indica la causa y la solución.

5. 5Cambia de modelo en Kilo Code: cambia el nombre después de -m

   Después de -m, escribe aicodewith/ más un modelo listado bajo models en kilo.json, por ejemplo aicodewith/gpt-5.5. Para añadir un modelo, lista primero su ID de modelo bajo models; consulta Modelos y precios.

Errores comunes

Sin clave configurada: Error: Unauthorized: 请在请求中提供有效的 API Key。

Qué ves

Error: Unauthorized: 请在请求中提供有效的 API Key。
(Inglés: "Please provide a valid API key in the request.")

Causa

apiKey en kilo.json es {env:AICODEWITH_API_KEY}, y la nueva terminal no tiene esa variable

Cómo corregirlo

Escribe tu clave directamente en apiKey, como en el paso 2

Volver al paso 2: Pega la configuración en kilo.json →

Clic para ampliar

Clave incorrecta: Error: Unauthorized: 请在请求中提供有效的 API Key。

Qué ves

Error: Unauthorized: 请在请求中提供有效的 API Key。
(Inglés: "Please provide a valid API key in the request.")

Causa

apiKey es incorrecta; el error es el mismo que cuando no hay clave

Cómo corregirlo

Copia la clave de la consola de nuevo y reemplaza el valor entre las comillas de apiKey

Volver al paso 2: Pega la configuración en kilo.json →

Clic para ampliar

Error: Model not found

Qué ves

Error: Model not found

Causa

El modelo después de -m no aparece en models dentro de kilo.json (por ejemplo, aicodewith/no-such-model), así que Kilo Code se detiene antes de enviar una solicitud

Cómo corregirlo

Usa un modelo listado en models, por ejemplo aicodewith/gpt-5.5

Volver al paso 3: Abre una nueva terminal y prueba Kilo Code →

Clic para ampliar

Preguntas frecuentes