Vibe coding per principianti: guida pratica

Cos’è davvero il vibe coding

Il termine si è diffuso per descrivere un modo di programmare in cui spieghi cosa vuoi e un’IA scrive il codice. Invece di digitare le istruzioni riga per riga, conversi: chiedi una funzione, guardi il risultato, chiedi una modifica.

È un modo di lavorare reale, con strumenti come Cursor, Claude Code, Lovable, Bolt o Replit, ma non è una scorciatoia per evitare di capire ciò che costruisci. Più sai spiegare ciò che ti serve e verificare il risultato, migliori saranno i tuoi progetti.

Cosa ti serve per iniziare

• Un’idea piccola e concreta: una calcolatrice, un modulo di contatto, un elenco con i filtri.
• Uno strumento di IA per il codice. Alcuni sono editor con l’IA integrata, altri generatori di app che funzionano nel browser; controlla cosa include ciascuno, i suoi limiti, i prezzi e le condizioni attuali.
• La pazienza di provare e correggere: la prima versione raramente è quella definitiva.
• Un modo per salvare le versioni (Git, o la cronologia dello strumento) così da poter tornare indietro quando qualcosa si rompe.

Non serve saper programmare per cominciare, ma col tempo dovresti imparare a leggere ciò che vedi: nomi dei file, messaggi di errore, cosa fa ogni parte. È questo che ti permette di guidare l’IA con criterio.

Il ciclo in quattro passaggi

• Descrivi una sola funzione e il risultato che ti aspetti, non l’app intera.
• Chiedi all’IA di realizzarla e di spiegarti in parole semplici cosa ha fatto.
• Provala con dati normali e con dati che dovrebbero provocare un errore.
• Se non funziona, copia il messaggio di errore completo, spiega cosa ti aspettavi e cosa è successo, e chiedi una correzione. Poi salva una versione.

Ripeti il ciclo. Ogni giro aggiunge un piccolo pezzo verificato, invece di una montagna di codice che nessuno ha controllato.

Un prompt per aggiungere una nuova funzione

Questo schema funziona in un editor con l’IA o in una chat. Le parti importanti sono il contesto, i limiti e un modo per verificare il risultato:

Sto creando [breve descrizione del progetto] con [tecnologia, se la conosci].

Voglio aggiungere questa funzione: [cosa deve fare, in una o due frasi].

Come capirò che funziona: [esempio di input e risultato atteso].

Regole:
- Modifica solo ciò che serve per questa funzione.
- Non eliminare né riscrivere codice che non c’entra.
- Non inserire password, chiavi o dati personali nel codice.
- Quando hai finito, spiega in parole semplici quali file hai modificato e come provare la funzione.

Se ti servono altre informazioni, chiedimele prima di scrivere codice.

Cosa fare quando qualcosa si rompe

Gli errori fanno parte del processo. Conta il modo in cui li descrivi: «non funziona» costringe l’IA a tirare a indovinare, mentre un messaggio di errore e il comportamento atteso le danno qualcosa di concreto su cui lavorare.

Quando [l’azione che compi], ottengo questo errore:

[incolla qui il messaggio di errore completo]

Mi aspettavo che [cosa dovrebbe succedere], invece [cosa succede].

Prima spiega quale pensi sia la causa, poi proponi la correzione più piccola possibile. Non modificare parti del progetto che non c’entrano con l’errore.

Se dopo due o tre tentativi l’IA gira a vuoto, fermati e chiedile di riassumere il problema e ciò che ha già provato. A volte la mossa migliore è tornare a una versione salvata e affrontare il problema in un altro modo.

Errori comuni dei principianti

• Chiedere troppo in una volta sola, e poi non sapere quale modifica ha rotto qualcosa.
• Accettare ogni modifica senza leggere il riepilogo dell’IA su ciò che ha toccato.
• Non salvare le versioni e perdere una che funzionava.
• Incollare chiavi API, password o dati personali nella chat o nel codice.
• Pubblicare senza aver provato dati sbagliati, lo schermo di un telefono e una persona che non ha costruito il progetto.
• Dare per scontato che sia sicuro solo perché «funziona».

Se il progetto avrà utenti reali o memorizzerà dati personali, prima verifica le norme sulla protezione dei dati che ti riguardano attraverso fonti ufficiali e, se i dati sono sensibili, fai controllare il lavoro a una persona esperta.

Modelli per non partire da una pagina bianca

Il modello di PromptNow per chiedere una funzione a Cursor o a Claude Code raccoglie in un modulo il progetto, la funzione e i limiti, e produce un prompt pronto da incollare. Il modello per correggere gli errori fa lo stesso con il messaggio di errore e il comportamento atteso.

Se sei ancora alla fase dell’idea, il modello di prompt master per Lovable o Bolt ti aiuta a descrivere l’intera app in un colpo solo. In ogni caso sono un punto di partenza: devi comunque rivedere e provare ciò che l’IA produce.