Mistral Vibe CLI

Un bloque [[providers]] de cinco líneas en .vibe/config.toml — api_base, api_key_env_var, api_style — dirige Vibe CLI a Kunavo, con la clave almacenada en una variable de entorno en lugar del archivo.

# ./.vibe/config.toml (project) or ~/.vibe/config.toml (user).
# "Project-level configuration takes precedence over user-level
# configuration", and the project file loads only in a trusted folder.
active_model = "sonnet-kunavo"

[[providers]]
name = "kunavo"
api_base = "https://api.kunavo.com/v1"
api_key_env_var = "KUNAVO_API_KEY"
api_style = "openai"
backend = "generic"

[[models]]
name = "claude-sonnet-5"
provider = "kunavo"
alias = "sonnet-kunavo"
# Optional, and documented on the api-keys-profiles page:
#   temperature   sampling temperature
#   input_price   indicative per-input cost, fed to --max-price
#   output_price  indicative per-output cost, fed to --max-price
# Take the two prices from the table further down this page if you want
# --max-price to mean anything.

# The key never goes in config.toml. api_key_env_var names the variable:
#   export KUNAVO_API_KEY="sk-kn-..."

Paso a paso

1. Cree una clave en /app/keys y cópiela: se muestra una sola vez.
2. Abre ~/.vibe/config.toml (o crea ./.vibe/config.toml en el repositorio donde quieras aplicar esta configuración) y pega el bloque anterior. No hay ninguna opción que puedas seleccionar para añadir el proveedor: Mistral indica que este archivo se edita a mano, y /config y /model solo permiten cambiar entre los ajustes preestablecidos que ya existen.
3. Exporta la variable que nombraste en api_key_env_var: export KUNAVO_API_KEY="sk-kn-...". La página de credenciales de Mistral indica que la CLI carga ~/.vibe/.env al iniciarse para obtener las credenciales, y su propio ejemplo con un proveedor externo usa un export de terminal para la clave que no es de Mistral.
4. Añade un ajuste preestablecido [[models]] por cada ID que quieras usar, cada uno con su propio alias, y luego asigna active_model a uno de esos alias. El alias es local: es lo que muestra /model en la lista; name es el ID que realmente se envía al endpoint.
5. Ejecuta vibe en una carpeta de confianza y asígnale una tarea que modifique un archivo, no un saludo. Una primera interacción que lea y edite un archivo permite comprobar el uso de herramientas, que suele ser donde se revela una configuración incorrecta del proveedor.

Comprobado con página de configuración de Vibe Code CLI de Mistral 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 Mistral Vibe 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.

No todo el tráfico pasa por este proveedor

Este es el aspecto que no se puede deducir del bloque de configuración y que depende de Vibe, no de Kunavo. En la versión v2.25.5, cuando hay un proveedor Mistral disponible, la CLI dirige las solicitudes de finalización de “utilidad” en segundo plano —las llamadas pequeñas que asignan nombres a conversaciones y árboles de trabajo— al modelo mistral-vibe-cli-fast propio de Mistral. Los valores predeterminados incluidos siempre configuran uno, incluso cuando el modelo activo de la sesión es el tuyo. El código fuente especifica tanto la preferencia como la alternativa: si no hay ningún proveedor Mistral disponible, la llamada de utilidad se dirige al modelo activo de la sesión.

Por tanto, si quieres que todas las solicitudes de la sesión lleguen al proveedor que configuraste, debe cumplirse una de estas condiciones:

• MISTRAL_API_KEY no está configurado, de modo que no se pueden resolver las credenciales del modelo rápido y la llamada de utilidad usa la alternativa; o
• el alias del modelo rápido está excluido mediante allowed_models, lo que tiene el mismo efecto por la lista de permitidos en lugar de por la clave.

El clasificador Smart Approve va más allá: la entrada de su registro de cambios de la versión 2.25.1 indica que usa el modelo rápido de Mistral independientemente del modelo activo de la sesión. Por eso, en la práctica, una sesión que use únicamente Kunavo se ejecutará en accept-edits o plan, y no en Smart Approve. Nada de esto invalida la configuración anterior; solo significa que el bloque de proveedor cubre los turnos de tu modelo, no todas las solicitudes que envía el binario.

Los otros valores de api_style

La documentación enumera un valor para api_style y lo presenta como ejemplo: "openai". El código fuente de la versión v2.25.5 incluye cuatro valores más —"anthropic", "openai-responses", "reasoning" y "vertex-anthropic"— en un diccionario sin validación. Por eso, un error tipográfico solo se detecta al enviar una solicitud, no al cargar el archivo. Considéralos verificados en el código fuente, pero no documentados. Si pruebas el valor de Anthropic, ten en cuenta este detalle: el endpoint de su adaptador es /v1/messages, así que api_base debe ser el origen sin más, https://api.kunavo.com, sin /v1; justo lo contrario del bloque anterior. Kunavo sí responde a /v1/messages para los ID que comienzan con claude-. Esta página muestra el estilo openai porque es el que documenta Mistral.