Mistral Vibe CLI

Un blocco [[providers]] di cinque righe in .vibe/config.toml — api_base, api_key_env_var, api_style — collega Vibe CLI a Kunavo, mantenendo la chiave in una variabile d'ambiente anziché nel file.

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

Passo dopo passo

1. Crea una chiave su /app/keys e copiala: viene mostrata una sola volta.
2. Apri ~/.vibe/config.toml (oppure crea ./.vibe/config.toml nel repository in cui vuoi applicare la configurazione) e incolla il blocco qui sopra. Non c’è alcuna procedura guidata per aggiungere un provider: Mistral indica di modificare questo file manualmente, mentre /config e /model consentono soltanto di passare da un preset già esistente all’altro.
3. Esporta la variabile indicata in api_key_env_var: export KUNAVO_API_KEY="sk-kn-...". La pagina di Mistral dedicata alle credenziali specifica che la CLI carica ~/.vibe/.env all’avvio; l’esempio ufficiale per un provider di terze parti usa il comando shell export per la chiave non Mistral.
4. Aggiungi un preset [[models]] per ogni ID desiderato, ciascuno con il proprio alias, quindi imposta active_model su uno di questi alias. L’alias è locale: è quello elencato da /model, mentre name è l’ID effettivamente inviato all’endpoint.
5. Esegui vibe in una cartella attendibile e assegnagli un’attività che modifichi un file, non un semplice saluto. Un primo turno che legge e modifica un file mette alla prova la chiamata degli strumenti, il punto in cui di solito si manifesta una configurazione errata del provider.

Verificato rispetto a Pagina di configurazione di Vibe Code CLI di Mistral il 21 settembre 2026. Le impostazioni di terze parti cambiano; se il nome di un campo qui non corrisponde più a quello visualizzato, fa fede quella pagina, non questa.

Verifica prima di eseguire il debug del client

Una sola richiesta stabilisce se il problema riguarda l'endpoint, la chiave o il file di configurazione. Se restituisce JSON, lo stesso base URL e la stessa chiave funzionano in 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-..."

Quale model id inserire nel campo

Ogni modello di testo è raggiungibile come model id: l'elenco aggiornato è GET /v1/models e il catalogo con i prezzi è nella pagina dei modelli. Le tariffe sono in USD per 1M di token, input / output.

Non tutto il traffico passa da questo provider

È un aspetto che un blocco di configurazione non può rivelare e che riguarda Vibe, non Kunavo. Nella versione v2.25.5, la CLI indirizza i completamenti di utilità in background — le chiamate minori che assegnano un nome alle conversazioni e agli alberi di lavoro — al modello mistral-vibe-cli-fast di Mistral ogni volta che è disponibile un provider Mistral. Le impostazioni predefinite distribuite ne configurano sempre uno, anche quando la sessione usa attivamente il tuo modello. Il codice sorgente esplicita sia la preferenza sia il ripiego: se non è disponibile alcun provider Mistral, la chiamata di utilità viene indirizzata al modello attivo della sessione.

Quindi, affinché tutte le richieste della sessione raggiungano il provider configurato, deve essere vera una delle seguenti condizioni:

• MISTRAL_API_KEY non è impostato, quindi le credenziali del modello rapido non vengono risolte e la chiamata di utilità ricade sul modello attivo; oppure
• l’alias del modello rapido è escluso tramite allowed_models, ottenendo lo stesso effetto tramite l’elenco consentito anziché tramite la chiave.

Il classificatore Smart Approve va oltre: la voce nel changelog della versione 2.25.1 dice che usa il modello Mistral rapido indipendentemente dal modello attivo della sessione. Perciò, in pratica, una sessione che usa solo Kunavo deve funzionare in modalità accept-edits o plan, non in modalità Smart Approve. Nulla di tutto questo impedisce la configurazione descritta sopra; significa solo che il blocco provider riguarda i turni del tuo modello, non ogni richiesta inviata dal programma.

Gli altri valori di api_style

La documentazione elenca un valore per api_style e lo presenta come esempio: "openai". Il codice sorgente della v2.25.5 ne include altri quattro — "anthropic", "openai-responses", "reasoning" e "vertex-anthropic" — in un semplice dizionario senza convalida. Per questo, un errore di battitura si manifesta al momento della richiesta, non quando viene caricato il file. Considerali valori verificati nel codice sorgente ma non documentati. Se provi il valore Anthropic, fai attenzione a un’insidia: l’endpoint del relativo adattatore è /v1/messages, quindi api_base deve essere l’origine senza suffisso, https://api.kunavo.com, priva di /v1: il contrario del blocco sopra. Kunavo risponde anche a /v1/messages, per gli ID che iniziano con claude-. Questa pagina mostra lo stile openai perché è quello documentato da Mistral.