Junie CLI

Junie CLI acepta un endpoint personalizado como perfil JSON en $JUNIE_HOME/models/, donde baseUrl es la URL completa del endpoint y fasterModel decide dónde se dirige el tráfico auxiliar.

{
  "id": "claude-sonnet-5",
  "baseUrl": "https://api.kunavo.com/v1/chat/completions",
  "displayName": "Kunavo",
  "providerName": "Kunavo",
  "apiType": "OpenAICompletion",
  "apiKey": "${KUNAVO_API_KEY}",
  "fasterModel": {
    "id": "claude-haiku-4-5"
  }
}

Paso a paso

1. Crea una clave en /app/keys y cópiala: se muestra una sola vez. Expórtala como KUNAVO_API_KEY en el shell desde el que iniciarás Junie o incluye una clave literal en el archivo; JetBrains señala que «Los valores que no incluyen ninguna referencia $${...} se usan tal cual».
2. Guarda el JSON anterior como $JUNIE_HOME/models/kunavo.json para tu cuenta o como .junie/models/kunavo.json para compartirlo con un repositorio. El nombre del archivo, sin .json, pasa a ser el id del perfil; por eso el selector de abajo muestra custom:kunavo.
3. Configura id con el id del modelo que realmente quieras usar. Se describe como «El identificador del modelo que espera el endpoint de API», así que puedes usar directamente un identificador de Kunavo de la tabla de abajo. Los ids se resuelven en el endpoint, no dentro de Junie.
4. Inicia Junie y selecciona el perfil: junie --model custom:kunavo o el comando /model en una sesión interactiva. Los modelos personalizados «aparecen en la lista de selección de modelos después de los proveedores integrados».
5. Asígnale una tarea que edite un archivo en lugar de un saludo. Junie es un cliente con capacidades de agente y depende de las llamadas a herramientas para casi todo lo que hace, así que una primera ejecución que lea y escriba algo te dirá mucho más que una sola respuesta.

Comprobado con Página de JetBrains sobre los LLM personalizados para Junie 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 Junie CLI.

# 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.

Los otros dos valores de apiType que Kunavo admite

apiType especifica un formato de solicitud, no un proveedor, y Junie acepta cuatro valores: OpenAICompletion, OpenAIResponses, Google y Anthropic. Kunavo ofrece tres rutas, así que dos de los otros tres valores tienen aquí una baseUrl correspondiente. Como Junie no añade ninguna ruta, cambiar el formato implica cambiar la URL en la misma edición:

1. "apiType": "OpenAICompletion" con https://api.kunavo.com/v1/chat/completions: el perfil de arriba y el que recomienda esta página, porque esta ruta es la más usada de las tres.
2. "apiType": "Anthropic" con https://api.kunavo.com/v1/messages: Kunavo responde en esa ruta con el formato Messages.
3. "apiType": "OpenAIResponses" con https://api.kunavo.com/v1/responses.

Determinar cuál de los tres formatos de Junie funciona mejor con un modelo es justamente el tipo de pregunta que responde una prueba en tiempo de ejecución, pero no una lectura de la documentación; por eso, esta página no los clasifica más allá de lo dicho en la primera línea. Elige uno y mantén la URL y apiType sincronizados. Si un perfil con una clave definida devuelve 401, especifica la credencial en lugar de hacer conjeturas sobre la cabecera de Junie: JetBrains solo documenta apiKey en negativo —«Si se omite, las solicitudes se envían sin una cabecera Authorization»— y nunca indica qué esquema se usa cuando está presente. extraHeaders se documenta como «cabeceras HTTP adicionales que se incluirán en cada solicitud» y acepta las mismas referencias $${VAR}, por lo que "extraHeaders": {"Authorization": "Bearer $${KUNAVO_API_KEY}"} es la forma inequívoca.