Vai al contenuto principale
Italiano— Scegli una lingua
Menu

Chiave API e Variabili d'Ambiente

Lezione 5 di 16 Aggiornata il 2 novembre 2026 Sviluppatore
In questa pagina
  1. Ottieni la tua Chiave API Mistral
  2. Tre Metodi di Configurazione
  3. Ordine di Priorità
  4. Sicurezza della Chiave API
  5. Verifica che la Chiave Funzioni
  6. Punti chiave

Lezione aggiornata il 2 novembre 2026 sulla base di Chiavi API e profili: la chiave inserita durante l’installazione viene salvata nel portachiavi di sistema (il file ~/.vibe/.env funge solo da fallback), l’accesso tramite browser è proposto di default e /status o /whoami indicano la fonte utilizzata. Fonte: API keys and profiles.

Ottieni la tua Chiave API Mistral

Per utilizzare Vibe, ti serve una chiave API Mistral. Questa chiave autentica le tue richieste e permette a Vibe di comunicare con i modelli Mistral. Senza di essa, lo strumento si installa e si avvia, ma nessuna generazione è possibile. Crei la chiave sulla Console Mistral in sei passaggi:

  1. Vai su console.mistral.ai
  2. Crea un account o accedi
  3. Naviga nella sezione API Keys
  4. Clicca su Create new key
  5. Assegnale un nome descrittivo (es. “vibe-cli-dev”)
  6. Copia la chiave immediatamente: non verrà più mostrata

Quest’ultimo punto non è una formalità: la chiave è visibile una sola volta. Se chiudi la scheda troppo presto, dovrai generarne una nuova. La chiave segue il formato sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx e deve rimanere confidenziale. Chiunque la possieda può utilizzare la tua quota API e, di conseguenza, spendere il tuo budget.

Tre Metodi di Configurazione

Vibe accetta tre modi per fornire questa chiave. La tua scelta dipende interamente dal tuo contesto di lavoro.

Metodo 1: Configurazione Interattiva

Questo è il metodo predefinito al primo avvio e il più semplice per una workstation personale. Vibe ti chiede direttamente la chiave e la salva:

vibe
# → "Please enter your Mistral API key:"
# Incolla la tua chiave, premi Invio

La chiave viene archiviata nel tuo portachiavi di sistema (Keychain di macOS, Gestione Credenziali di Windows…). Se nessun portachiavi è disponibile, il sistema ripiega sul file ~/.vibe/.env, leggibile solo da te. Nota che al primo avvio, l’accesso tramite browser con il tuo account Mistral spesso elimina completamente la necessità di una chiave. Per vedere quale fonte sta effettivamente utilizzando Vibe, digita /status o /whoami durante una sessione.

# Se la chiave è nel file .env (nessun portachiavi disponibile)
cat ~/.vibe/.env
# MISTRAL_API_KEY=...

Metodo 2: Variabile d’Ambiente

Non appena esci dall’ambiente della workstation personale, come in una pipeline CI/CD, uno script automatizzato o un server condiviso, una variabile d’ambiente diventa preferibile perché non scrive nulla su disco:

export MISTRAL_API_KEY="sk-your-key-here"

Per renderla persistente sulla tua macchina, aggiungi questa riga al file di configurazione della tua shell:

# In ~/.bashrc, ~/.zshrc, o ~/.profile
export MISTRAL_API_KEY="sk-your-key-here"

La variabile d’ambiente ha priorità sul file .env. Questo abilita un modello d’uso molto pratico: cambiare chiave temporaneamente senza apportare modifiche permanenti. Potresti lavorare con la tua chiave di sviluppo, quindi anteporre una chiave diversa a un singolo comando per un’operazione sensibile:

# Chiave di sviluppo
export MISTRAL_API_KEY="sk-dev-xxxx"
vibe "Analyze this code"

# Chiave di produzione (temporanea)
MISTRAL_API_KEY="sk-prod-yyyy" vibe "Deploy migrations"

Metodo 3: File config.toml

Infine, puoi riferirti alla variabile d’ambiente nel file di configurazione TOML di Vibe:

# ~/.vibe/config.toml
api_key_env_var = "MISTRAL_API_KEY"

Nota che questo parametro non contiene la chiave stessa, ma solo il nome della variabile da leggere. Questa indirezione ha senso quando si lavora con più provider, ognuno con la propria variabile: api_key_env_var dice a Vibe quale usare per la chiave predefinita.

Ordine di Priorità

Quando più metodi sono configurati simultaneamente, Vibe applica questo ordine:

  1. Variabile d’ambiente MISTRAL_API_KEY (se definita nella shell)
  2. File .env in ~/.vibe/.env
  3. Portachiavi di sistema, dove la procedura guidata di installazione salva la chiave

Per un provider personalizzato, api_key_env_var in config.toml designa semplicemente la variabile da leggere, seguendo lo stesso ordine.

Ricorda la prima riga sopra: se una richiesta fallisce l’autenticazione anche se il tuo .env contiene una chiave valida, controlla prima se una vecchia variabile è rimasta nella tua shell e la sta sovrascrivendo.

Sicurezza della Chiave API

La prima regola è non fare mai commit della tua chiave in un repository Git. Aggiungi .env al tuo .gitignore prima ancora di creare il file. Un segreto inviato su un repo pubblico è considerato compromesso, anche se elimini il commit in seguito. Per la stessa logica, non condividere la tua chiave in chiaro in un messaggio o documento. Se sospetti una fuga di dati, rigenerala immediatamente.

A livello organizzativo, usa chiavi separate per lo sviluppo e la produzione. Se una viene compromessa, puoi revocarla senza interrompere l’altra. Infine, imposta limiti di spesa sulla Console Mistral. Questa è la rete di sicurezza più efficace contro uno script in loop o una chiave esposta: la fatturazione si interrompe automaticamente.

Verifica che la Chiave Funzioni

Dopo la configurazione, non dare nulla per scontato. Testa con una richiesta minima:

vibe "Say hello"

Se la chiave è valida, Vibe risponde normalmente. Se non è valida o è scaduta, riceverai un chiaro errore di autenticazione, risparmiandoti la caccia alla causa nell’installazione.

Se configuri provider aggiuntivi come OpenRouter, ognuno necessita della propria variabile. I due coesistono senza problemi:

export MISTRAL_API_KEY="sk-mistral-xxxx"
export OPENROUTER_API_KEY="sk-or-xxxx"

Tratteremo la configurazione di provider di terze parti in dettaglio nella lezione dedicata.

Punti chiave

  • Ottieni la tua chiave API Mistral su console.mistral.ai
  • Tre metodi di configurazione: setup interattivo, variabile d’ambiente, config.toml
  • La variabile d’ambiente ha priorità sul file .env
  • Non fare mai commit della tua chiave su Git
  • Imposta limiti di spesa sulla Console Mistral