Cursor: guida pratica all'editor IA per programmare

Cursor e' un editor di codice costruito attorno all'intelligenza artificiale: sembra Visual Studio Code (da cui deriva) ma integra un assistente che capisce l'intero progetto, scrive e modifica il codice, spiega gli errori e puo' agire in autonomia su piu' file. Reso ancora piu' attuale dall'acquisizione da 60 miliardi da parte di SpaceX, e' oggi uno degli strumenti piu' usati per programmare con l'IA. Questa guida ti mostra come sfruttarlo davvero, non solo come autocompletamento.

A chi serve e cosa ti serve per iniziare

La guida e' adatta sia a chi programma da tempo e vuole velocizzare il lavoro, sia a chi sta imparando e vuole un assistente che spieghi mentre costruisce. Serve un computer con Windows, macOS o Linux e una connessione a internet (i modelli girano nel cloud). Cursor ha un piano gratuito con un numero limitato di richieste ai modelli avanzati e completamenti "Tab"; i piani Pro sbloccano piu' richieste e modelli piu' potenti. Non serve un abbonamento separato a OpenAI o Anthropic: Cursor include l'accesso ai modelli, e puoi comunque inserire una tua chiave API se preferisci.

Passo 1: installazione e primo progetto

1. Scarica Cursor dal sito ufficiale e installalo come una normale applicazione.
2. Al primo avvio puoi importare le estensioni e le impostazioni di VS Code con un clic: ritrovi tema, scorciatoie e plugin.
3. Apri una cartella di progetto con File > Open Folder. Cursor indicizza i file per capire il contesto: e' cio' che gli permette di rispondere tenendo conto di tutto il codice, non solo del file aperto.

Passo 2: i tre modi di usare l'IA in Cursor

Cursor offre tre strumenti principali, da usare in situazioni diverse:

• Tab (autocompletamento): mentre scrivi, l'IA suggerisce la riga o il blocco successivo; premi Tab per accettare. Ottimo per il codice ripetitivo e per finire funzioni che hai gia' impostato.
• Chat in linea (Cmd/Ctrl+K): seleziona una porzione di codice, premi la scorciatoia e chiedi una modifica a parole ("aggiungi la gestione degli errori", "trasforma questo in una funzione asincrona"). Cursor mostra la differenza e tu approvi o rifiuti.
• Chat laterale e modalita' Agente (Cmd/Ctrl+L): apri il pannello di conversazione per fare domande sull'intero progetto o dare un compito complesso. In modalita' Agente, Cursor puo' modificare piu' file, creare nuovi file ed eseguire comandi nel terminale per portare a termine il compito.

Passo 3: dare contesto con @ e scegliere il modello

La qualita' delle risposte dipende dal contesto. In chat usa il simbolo @ per indicare esattamente a cosa riferirti:

• @File o @Folder per includere file o cartelle specifici;
• @Code per una funzione o un simbolo preciso;
• @Web per far cercare informazioni aggiornate online;
• @Docs per agganciare la documentazione di una libreria.

In alto nel pannello di chat puoi scegliere il modello: tra le opzioni piu' recenti c'e' Claude Sonnet 5, ottimo per i compiti agentici e per il debug su basi di codice esistenti, ma trovi anche i modelli di OpenAI e di Google. Regola pratica: usa un modello potente per i compiti complessi o l'agente, e uno piu' rapido ed economico per domande semplici, coerentemente con la logica di efficienza.

Passo 4: prompt efficaci, con esempi

Cursor risponde molto meglio a istruzioni precise. Ecco alcuni prompt da copiare e adattare.

Per creare una funzione con requisiti chiari:

"Scrivi in Python una funzione che riceve una lista di dizionari con i campi nome e prezzo e restituisce i tre piu' costosi, ordinati. Gestisci il caso di lista vuota e aggiungi i type hint e una docstring."

Per il debug, sfruttando il contesto del progetto:

"@File src/api.py Questo endpoint restituisce a volte un errore 500. Individua la causa piu' probabile, spiegala e proponi la correzione senza cambiare il comportamento delle altre funzioni."

Per un compito da agente su piu' file:

"Aggiungi il supporto alla lingua inglese all'interfaccia: estrai le stringhe italiane in un file di traduzioni, crea l'equivalente in inglese e collega un selettore di lingua. Mostrami il piano prima di modificare i file."

Il risultato atteso, in modalita' agente, e' un elenco di modifiche proposte file per file, che puoi rivedere e approvare singolarmente prima che vengano applicate.

Passo 5: le Cursor Rules per risultati coerenti

Per evitare di ripetere le stesse indicazioni a ogni richiesta, crea un file di regole del progetto. Aggiungi una cartella .cursor/rules con le tue convenzioni, ad esempio:

# Regole del progetto
- Usa sempre TypeScript, non JavaScript.
- Commenta il codice in italiano.
- Preferisci funzioni piccole e pure.
- Non aggiungere dipendenze senza chiedere conferma.

Cursor terra' conto di queste regole in ogni interazione, rendendo il codice generato coerente con lo stile del progetto. E' una delle funzioni che distingue un uso professionale dello strumento da uno occasionale, come spiega la documentazione ufficiale.

Errori comuni e buone pratiche

• Accettare tutto senza leggere: l'IA sbaglia. Rivedi sempre le differenze prima di approvarle, soprattutto in modalita' agente che tocca piu' file.
• Contesto insufficiente: se la risposta e' generica, non hai dato abbastanza contesto. Usa @File e @Folder per puntare al codice giusto.
• Compiti troppo grandi in un colpo: spezza le richieste. "Riscrivi tutta l'app" produce risultati fragili; "aggiungi questa funzione al modulo X" e' gestibile e verificabile.
• Dati sensibili: ricorda che il codice inviato in chat transita dai server dei modelli. Per progetti riservati, valuta la modalita' che limita l'invio di dati o l'uso di modelli locali.

Passo 6: capire un progetto nuovo e generare i test

Due casi d'uso in cui Cursor fa risparmiare piu' tempo meritano un cenno a parte. Il primo e' orientarsi in una base di codice sconosciuta: quando apri un progetto altrui, invece di leggere decine di file, chiedi in chat una mappa d'insieme. Un prompt efficace e':

"@Folder src Spiegami l'architettura di questo progetto: quali sono i punti d'ingresso, come sono organizzati i moduli e dove avviene la gestione dei dati. Fai un elenco puntato e indicami i tre file da leggere per primi."

Il risultato atteso e' una sintesi che ti fa capire in un minuto cio' che altrimenti richiederebbe un'ora, con i riferimenti ai file reali su cui cliccare.

Il secondo caso e' la generazione dei test, un compito spesso trascurato ma dove l'IA e' particolarmente utile. Seleziona una funzione e chiedi:

"Scrivi i test unitari per questa funzione con il framework gia' usato nel progetto. Copri i casi limite: input vuoto, valori negativi e tipi errati. Non modificare la funzione, solo aggiungi il file di test."

Cursor riconosce il framework di test presente (pytest, Jest, JUnit e cosi' via) e produce un file coerente con le convenzioni del progetto. E' anche un ottimo modo per scoprire bug: scrivere i test costringe il modello — e te — a ragionare sui comportamenti attesi. Ricorda comunque di eseguire i test generati: servono a verificare il codice, non vanno accettati sulla fiducia.

Alternative e quando non usare Cursor

Cursor non e' l'unica strada. GitHub Copilot dentro VS Code e' piu' integrato nell'ecosistema Microsoft; Claude Code lavora da terminale ed e' potentissimo sugli agenti; strumenti come Windsurf o Zed offrono esperienze simili. Se lavori su progetti piccoli o hai bisogno solo di un aiuto occasionale, il piano gratuito di Cursor o Copilot bastano. Se invece programmi tutti i giorni e vuoi delegare interi compiti all'IA mantenendo il controllo, un piano a pagamento di Cursor si ripaga in fretta in tempo risparmiato. Il consiglio finale e' lo stesso di ogni strumento IA: usalo come un collaboratore veloce ma da supervisionare, non come un pilota automatico.