Vai al contenuto principale
Italiano— Scegli una lingua
Menu

Primo avvio di Vibe

Lezione 3 di 16 Aggiornata il 2 novembre 2026 Sviluppatore
In questa pagina
  1. Primo avvio di Vibe
  2. La procedura guidata di configurazione iniziale
  3. L’interfaccia interattiva
  4. Il tuo primo scambio
  5. Avvio con un prompt diretto
  6. Ritorno alla configurazione
  7. Punti chiave

Lezione aggiornata il 2 novembre 2026 sulla base della documentazione di Vibe Code: l’accesso tramite browser è ora l’opzione predefinita, le chiavi vengono salvate nel portachiavi di sistema e il modello integrato è Mistral Medium 3.5 (Devstral 2 è stato rimosso dalle API il 31 luglio 2026). Fonti: Installazione e configurazione · Configurazione · Agenti.

Aggiornamento del 2 novembre 2026 — Devstral. Devstral 2 (devstral-2512) ha raggiunto la data di fine supporto il 31 luglio 2026, e Devstral Small 2 il 31 marzo 2026: le chiamate a questi modelli non sono più garantite. La tabella ufficiale li reindirizza a Mistral Medium 3.5, che è a sua volta deprecato a favore di Mistral Large 4. Codestral (codestral-2508) rimane generalmente disponibile per il completamento del codice. Controlla la tabella dei modelli per vedere dove puntano gli alias -latest prima di riutilizzare questi esempi.

Primo avvio di Vibe

Vibe funziona sempre nel contesto di una directory. Spostati in un progetto esistente, non nella tua home, prima di avviarlo:

cd /percorso/del/tuo/progetto
vibe

Al primo avvio, Vibe esegue diversi passaggi di inizializzazione automatica. Non preoccuparti se il processo richiede alcuni secondi: lo strumento sta creando la sua directory di configurazione e preparando la procedura guidata di setup.

La procedura guidata di configurazione iniziale

La prima volta che esegui Vibe, una procedura guidata interattiva ti accompagna nella configurazione. Inizia con il tema visivo dell’interfaccia del terminale: sono disponibili diverse palette di colori. Scegli quella più leggibile sul tuo terminale. Nulla è definitivo; puoi modificarlo in qualsiasi momento.

Segue il passaggio cruciale: l’accesso ai modelli. La procedura guidata offre due percorsi:

  1. Avvia browser: accedi con il tuo account Mistral nel browser e Vibe utilizza il tuo piano Mistral (Vibe Code è incluso, con limiti d’uso che dipendono dal tuo piano e dalle impostazioni pay-as-you-go). Questo è il percorso predefinito, che non richiede gestione delle chiavi.
  2. Usa una chiave API: genera una chiave da Code › Vibe CLI, oppure usa una chiave di un altro provider compatibile, e incollala in Vibe.

Vibe salva la chiave nel portachiavi del tuo sistema operativo (Portachiavi macOS, Gestione credenziali Windows…) o, in alternativa, in ~/.vibe/.env, leggibile solo da te. Puoi riavviare questa procedura guidata in qualsiasi momento con vibe --setup.

Non ti verrà chiesto di selezionare un modello: Vibe include un modello integrato, Mistral Medium 3.5 (alias mistral-medium-3.5), che la sua documentazione raccomanda per il ragionamento e la programmazione. Il comando /model ti permetterà di sceglierne uno diverso in seguito tra quelli che hai configurato.

L’interfaccia interattiva

Una volta completata la configurazione, ti trovi in modalità interattiva. La schermata è organizzata semplicemente: un’area di input in basso per digitare i messaggi, la cronologia della conversazione sopra e indicatori che mostrano il modello in uso e lo stato della sessione. Non c’è nient’altro da imparare per iniziare a lavorare.

Tuttavia, alcune scorciatoie da tastiera faranno una grande differenza nella velocità del tuo flusso di lavoro. Memorizzale ora invece di cercarle tra un mese:

ScorciatoiaEffetto
Ctrl+J o Shift+EnterNuova riga nel messaggio (per input su più righe)
@Completamento automatico dei file (es. @src/main.py)
!Prefisso per eseguire direttamente un comando shell
Ctrl+GApre un editor esterno per scrivere un messaggio lungo
Ctrl+OMostra o nasconde l’output degli strumenti
Cmd+\ o Alt+\Mostra o nasconde l’elenco delle attività (todo)
Shift+TabAlterna le modalità di approvazione

La scorciatoia più utile per il lavoro quotidiano è senza dubbio @: invece di descrivere dove si trova un file, lo riferisci direttamente e l’agente lo legge.

Il tuo primo scambio

Provala con una richiesta semplice. In un progetto Python, ad esempio, digita:

Spiega la struttura di questo progetto

Osserva cosa succede, perché è qui che diventa visibile la differenza rispetto a un chatbot standard. Vibe scansiona l’albero del progetto—file, cartelle, configurazione—legge lo stato di Git per identificare il branch, i commit recenti e i file modificati, analizza i file chiave come il README, package.json o pyproject.toml, e poi ti fornisce un riepilogo strutturato dell’architettura.

In altre parole, non si limita a rispondere; recupera le informazioni di cui ha bisogno. Fai la stessa domanda in un repository vuoto e la risposta sarà scarna: non c’è nulla da leggere.

Avvio con un prompt diretto

La modalità interattiva non è obbligatoria. Per una singola richiesta, passa la tua query direttamente come argomento:

vibe "Rifattorizza la funzione principale per usare async/await"

Per la modalità programmatica—quella che useresti in uno script o in una pipeline di integrazione continua—l’opzione --prompt combinata con un formato di output utilizzabile funziona meglio:

vibe --prompt "Analizza la copertura dei test" --output json

Due salvaguardie sono particolarmente utili in questo contesto, poiché un agente non supervisionato può entrare in loop o diventare costoso. --max-turns limita il numero di scambi di andata e ritorno, e --max-price impone un tetto alla spesa:

vibe --prompt "Correggi i bug" --max-turns 10 --max-price 0.50

Ritorno alla configurazione

Prima o poi, vorrai cambiare il tema o riconfigurare la tua chiave API. La procedura guidata di setup può essere riavviata su richiesta:

vibe --setup

Durante una sessione, i comandi slash prendono il sopravvento: digita / per vederli apparire. /help o /h visualizza l’aiuto completo, /config apre la configurazione, /theme cambia il tema, /model cambia il modello senza uscire dalla sessione e /clear cancella la cronologia della conversazione quando passi a un argomento completamente diverso.

Punti chiave

  • Avvia Vibe con vibe all’interno della directory del tuo progetto
  • Al primo avvio, la procedura guidata configura il tema e la chiave API
  • La chiave API viene salvata in ~/.vibe/.env
  • Mistral Medium 3.5 è il modello integrato; usa /model per cambiare modello
  • Le scorciatoie da tastiera (@, !, Ctrl+J, Shift+Tab) sono essenziali per l’uso quotidiano
  • Usa vibe "la tua domanda" per uno scambio rapido senza modalità interattiva