Theia IDE

Una entrada en ai-features.openAiCustom.customOpenAiModels — model, url y apiKey — coloca Kunavo detrás de Theia Coder, Architect y la finalización en línea.

{
  "ai-features.openAiCustom.customOpenAiModels": [
    {
      "model": "claude-sonnet-5",
      "url": "https://api.kunavo.com/v1",
      "id": "kunavo-sonnet-5",
      "apiKey": "sk-kn-...",
      "developerMessageSettings": "system"
    },
    {
      "model": "claude-haiku-4-5",
      "url": "https://api.kunavo.com/v1",
      "id": "kunavo-haiku-4-5",
      "apiKey": "sk-kn-...",
      "developerMessageSettings": "system"
    }
  ]
}

Paso a paso

1. Cree una clave en /app/keys y cópiela: se muestra una sola vez.
2. Active la función: la documentación de Theia indica que debe ir a Preferences y activar el ajuste «AI-features => AI Enable». Lo que sigue no aparecerá hasta que lo haga.
3. Abra la vista AI Configuration: Alt+A, o seleccione AI Configuration en el menú Manage (icono del engranaje) de la esquina inferior izquierda, justo debajo de Settings. Sus categorías son General, Providers & Models, Model Aliases, Agents, Prompts & Skills, Variables, Tools, Token Usage y MCP Servers.
4. Añade las entradas anteriores. La documentación indica que se hace clic en el enlace de la sección de configuración de OpenAI Compatible Models: la preferencia es una lista estructurada, y Theia señala que las opciones estructuradas sin un editor específico «se remiten a settings.json», el archivo al que llegas. Un objeto por ID de modelo; se repiten url y apiKey.
5. Asígnalo a algo. En Agents, cada agente tiene un selector de Language Model; muchos agentes resuelven un alias de modelo, así que configurar default/code, default/universal, default/code-completion, default/summarize y default/fast en Model Aliases permite cambiar varios agentes a la vez.
6. Envía un mensaje de chat a Theia Coder y luego pídele algo que afecte a un archivo. Los agentes de este IDE dependen de las llamadas a herramientas y del contenido del espacio de trabajo, así que una primera ejecución que lea o edite algo te dirá más que un saludo; además, Token Usage en la misma vista muestra cuántos tokens costó el turno.

Comprobado con la página de funciones de IA del IDE Theia, sección OpenAI Compatible Models el 21 de septiembre de 2026. La configuración de terceros puede cambiar; si el nombre de un campo ya no coincide con lo que ves, esa página es la autoridad, no esta.

Verifica antes de depurar el cliente

Una solicitud determina si el fallo está en el endpoint, la clave o el archivo de configuración. Si devuelve JSON, la misma URL base y la misma clave funcionan en Theia IDE.

# Settles whether a failure is the endpoint, the key, or the client.
curl -sS https://api.kunavo.com/v1/models \
  -H "Authorization: Bearer sk-kn-..."

Qué ID de modelo introducir en el campo

Todos los modelos de texto están disponibles mediante un ID de modelo; la lista activa está en GET /v1/models, y el catálogo con precios está en la página de modelos. Las tarifas son USD por 1M de tokens, entrada / salida.

Lo que Theia afirma sobre este proveedor

La tabla LLM Providers Overview de la página de Theia califica cada proveedor en tres ejes. Esta es la afirmación de Theia sobre Theia, copiada de esa tabla en la fecha indicada arriba; no es un resultado de pruebas de Kunavo. La columna titulada «Lo que requiere del ID de modelo» es la única parte de esta tabla redactada aquí.

Dos párrafos antes de esa tabla, Theia añade una salvedad que conviene repetir porque enmarca honestamente toda esta página: no todos los modelos «pueden funcionar de inmediato, ya que podrían requerir personalizaciones u optimizaciones específicas».

Qué cuesta dinero realmente

El IDE Theia es de código abierto y se puede descargar gratis, y sus funciones de IA no tienen ningún coste propio: lo que cuesta son las llamadas al modelo, facturadas por quien tenga la clave en apiKey. Hay dos opciones de configuración que afectan a esa factura más que la elección del modelo, y ambas se encuentran en la documentación:

1. Automatic Code Completion está activado de forma predeterminada, y la documentación indica que realiza «solicitudes continuas al LLM subyacente mientras programas». Es el agente que se ejecuta miles de veces al día. Asigna default/code-completion a un ID económico, o cambia el agente al modo manual en 'AIFeatures'=>'CodeCompletion' y actívalo con Ctrl+Alt+Space.
2. Max Context Lines, dentro del mismo grupo de configuración, limita cuánto contenido circundante del archivo se incluye en cada solicitud de completado. Cada línea se factura como entrada en cada llamada provocada por una pulsación de tecla.

Los agentes de chat funcionan justo al contrario: hacen menos llamadas, usan un contexto mucho mayor y vuelven a enviar los mismos archivos del espacio de trabajo en cada turno. Para eso sirve la caché de prompts; consulta /docs/caching. Por eso las dos partes de la tabla de modelos anterior se dividen según la frecuencia con la que se ejecuta el agente, no según lo inteligente que sea.

Cuando no logra conectarse

1. 404: la url. Kunavo sirve /v1/chat/completions, así que el campo necesita la raíz de /v1; no funcionan ni un origen sin más ni una .../chat/completions completa.
2. 401: la clave. El Readme de Theia indica que apiKey «se enviará como un Bearer Token en la solicitud de autorización», que es exactamente lo que espera una clave sk-kn-. Ten en cuenta el valor predeterminado documentado: si no hay ningún apiKey, Theia envía no-key, por lo que un campo ausente parece una clave rechazada en lugar de una clave faltante. (true significa «usar la clave global de la API de OpenAI», que no es lo que quieres aquí.)
3. El ID de modelo no aparece en el selector: esa lista procede de tus propias entradas de customOpenAiModels, no del endpoint, así que si falta un ID, falta el objeto correspondiente. El campo id es lo que muestra la interfaz; si lo omites, se usa el nombre del modelo.
4. El primer mensaje del sistema se rechaza o se ignora: ese es developerMessageSettings. Su valor predeterminado es developer, que es un rol con formato de OpenAI; el ejemplo de Theia para un proveedor que no sea de OpenAI establece system, razón por la que el bloque anterior lo hace. user, mergeWithFollowingUserMessage y skip son las alternativas documentadas.
5. No hay respuesta en ninguna parte: comprueba Workspace Trust. Theia condiciona todas las funciones de IA a esta opción, y un espacio de trabajo no confiable desactiva la entrada de chat y el completado en línea, además de mostrar el mensaje AI Features are Restricted.