Tutorial Cursor 2026: Agent per principianti in 15 minuti

Questo tutorial spiega come usare Cursor se lo apri per la prima volta. Segue la documentazione ufficiale di Cursor aggiornata al 1 novembre 2026, quando la versione corrente era Cursor IDE 3.27.

Una nota sul metodo: il team NxCode ha scritto questa guida a partire da quei documenti e non ha eseguito i passaggi su un'installazione pulita. NxCode è un nostro prodotto, un AI app builder, ed è separato da Cursor. Dove la guida dice che cosa dovresti vedere, l'informazione viene dalla documentazione, quindi il tuo schermo può differire per piccoli dettagli. Dove le pagine ufficiali si contraddicono o lasciano un vuoto, lo diciamo.

Se hai letto un vecchio tutorial di Cursor, aspettati qualche sorpresa. La modalità Composer, Inline Edit con Cmd+K e la modalità Chat separata sono tutte sparite dalla documentazione attuale.

Il tuo percorso di 15 minuti

Minuti	Che cosa fai	Che cosa ottieni
0–3	Installi, accedi, apri una cartella di prova	Cursor in funzione sul tuo computer
3–5	Impari le due finestre e qualche scorciatoia	Sai dove si trova Agent
5–10	Esegui il primo task con Ask, poi con Agent	Una piccola pagina migliorata da Agent
10–12	Rivedi le modifiche e le provi	Sai che cosa ha fatto davvero Agent
12–14	Ti eserciti a ripristinare un checkpoint	Sai come annullare
14–15	Aggiungi una regola di progetto	Agent segue le tue preferenze

Che cos'è Cursor?

Cursor è un editor di codice con un agente AI integrato. Descrivi un task in linguaggio naturale e Agent legge il tuo progetto, modifica i file e può eseguire comandi.

Se hai usato VS Code, l'editor ti sembrerà familiare. Le normali scorciatoie di modifica sono le stesse e puoi importare estensioni, temi, impostazioni e combinazioni di tasti.

In una giornata normale, dentro Cursor succedono tre cose:

Agent si occupa dei task in tutto il progetto.
Tab prevede ciò che stai per digitare mentre scrivi tu il codice.
Rules dicono ad Agent come va gestito il tuo progetto.

Cursor è adatto a chi vuole lavorare con il codice o vuole imparare a farlo. Chi vuole solo un'app finita e non ha interesse a leggere i diff ha un'esigenza diversa, di cui parliamo più sotto in "Quando usare un altro strumento". NxCode è una delle opzioni in quel caso.

Installa Cursor e aprilo per la prima volta

Passaggio 1: scarica

Vai su cursor.com/download e scegli il tuo sistema.

Sistema	Requisito	Che cosa scaricare
macOS	12 o successivo	`.dmg`, per Apple Silicon o Intel
Windows	10 o successivo	`.exe`, x64 o ARM64, ciascuno con installer System e User
Linux	Debian/Ubuntu o RHEL/Fedora	Prima il repository apt o yum, disponibile anche AppImage

Su Linux, la guida rapida ufficiale preferisce i repository apt e yum perché aggiungono un'icona sul desktop, gli aggiornamenti automatici e lo strumento da riga di comando.

Passaggio 2: apri Cursor e accedi

L'ordine ufficiale è breve: scarica, apri, accedi, scegli una cartella, inizia con un piccolo task. Ti serve un account.

L'accesso a Cursor può portarti a una pagina xAI condivisa con il marchio Grok o xAI. È previsto, perché i nuovi clienti ora partono da The X Subscription, l'abbonamento con cui viene venduto Cursor. Accedere non unisce gli account e non cambia un piano.

Le guide più vecchie elencano "scegli il tuo modello AI" tra i passaggi del primo avvio. La documentazione attuale non ha questo passaggio. Puoi impostare un predefinito in seguito in Cursor Settings > Models, oppure cambiarlo durante una conversazione.

La documentazione non dice nemmeno se un nuovo account arrivi prima nella Agents Window o nell'editor. La prossima sezione spiega come passare dall'una all'altro, quindi va bene in entrambi i casi.

Passaggio 3: scegli un piano

Inizia con Free ($0, utilizzo limitato), passa a Plus ($8/mese) se i limiti interrompono il tuo lavoro e scegli Premium ($30/mese) solo quando ti servono Cloud Agents, modelli di terze parti o chiavi API personali.

I prezzi sono tasse escluse. I piani superiori sono Super ($100) e Ultra ($200). Per i dettagli, vedi la nostra guida ai prezzi di Cursor o la pagina ufficiale dei prezzi. Acquista solo tramite il sito ufficiale o con acquisto in-app, dato che la pagina dei prezzi riporta "not authorize any resellers or third-party sellers" (Cursor non autorizza rivenditori o venditori terzi).

Passaggio 4: facoltativo, porta la tua configurazione di VS Code

L'importazione delle impostazioni di VS Code non è più descritta come passaggio del primo avvio. Se la vuoi, premi Cmd+Shift+J (Ctrl+Shift+J su Windows e Linux) per aprire Cursor Settings, poi vai in General > Account > VS Code Import > Import.

Le estensioni in Cursor vengono da Open VSX, non dal VS Code Marketplace, e non tutte sono presenti. Se dopo l'importazione ne manca una, è probabile che il motivo sia questo.

Controlla l'editore prima di installare qualsiasi cosa. Il 29 ottobre 2026, Cursor ha segnalato un'estensione malevola che si spacciava per Anthropic.claude-code (versioni 2.1.312 e 2.1.313) nel suo marketplace.

Conosci l'interfaccia

Due finestre: Agents Window e l'editor

Cursor ha due interfacce principali e la documentazione dice che restano supportate entrambe. Puoi tenerle aperte contemporaneamente.

	Agents Window	Editor (IDE)
Costruita attorno a	Agenti	I tuoi file
Ideale per	Più repository, agenti paralleli, lavoro locale, cloud e SSH	Leggere e modificare codice accanto ad Agent
Come arrivarci	Cmd+Shift+P, poi Open Agents Window	Cmd+Shift+P, poi Open IDE

Su Windows e Linux, la palette dei comandi è Ctrl+Shift+P.

Alcune funzioni esistono solo nella Agents Window, tra cui più workspace, la nuova vista diff, i cloud agent paralleli e l'interfaccia nativa di Worktrees.

Per il primo giorno, usa l'editor. Puoi vedere il file e la conversazione fianco a fianco, e così è più facile seguire che cosa sta facendo Agent.

Il pannello Agent

Nell'editor, premi Cmd+I (Ctrl+I) per aprire il pannello laterale. La documentazione lo chiama "Agent panel" e la tabella delle scorciatoie "Sidepanel". Sono la stessa cosa.

Nel pannello userai:

La casella di input per la tua richiesta. Trascina o incolla immagini al suo interno, o usa il microfono per la voce.
Il menu a tendina delle modalità, che passa tra Agent, Ask, Plan e Debug.
Il selettore dei modelli in cima alla casella di input.
@ per indicare qualcosa di specifico e / per richiamare skill e comandi.

L'attuale elenco ufficiale di @ è breve: un file o una cartella come @index.html o @src/components/, @Terminals, @Chats, @Commit (Diff of Working State), @Branch (Diff with Main) e @Browser. Se non sai quale file conta, salta @. La documentazione dice che Agent trova i file rilevanti con la propria ricerca.

I tutorial più vecchi insegnano @codebase, @docs e @web. Questi non sono nell'elenco attuale e non abbiamo potuto confermare se funzionino ancora.

La barra laterale ha anche una pagina Customize, che raccoglie in un unico posto plugin, skill, MCP, subagenti, regole, comandi e hook. La userai più avanti.

Termini da conoscere: che cosa significano oggi i nomi

Molti nomi di Cursor sono cambiati. Questa tabella mostra che cosa significa ciascuno oggi.

Termine	Che cosa significa oggi	Se un vecchio tutorial dice
Composer	Il modello proprietario di Cursor, attualmente Composer 2.5, descritto come veloce ed efficiente nei costi	"Modalità Composer": non è più nella documentazione, usa Agent
Agent	La modalità predefinita e il modo principale di lavorare	"Passa ad Agent in Composer": nessun passaggio necessario
Chat	Non è una modalità separata. La documentazione scrive "Agent (Chat)"	"Apri Chat per fare domande": usa Ask, la modalità di sola lettura
Inline Edit	Ritirata; vedi sotto	"Seleziona il codice e premi Cmd+K per modificare sul posto": seleziona il codice, premi Cmd+K o Cmd+L e passa ad Agent
Tab	Completamento automatico, nome invariato	"Supermaven": la parola non compare nella documentazione ufficiale che abbiamo letto
Free	Il piano da $0 per i nuovi clienti	"Hobby": un piano legacy mantenuto per chi lo aveva già
Regola `.mdc`	Il tipo di file richiesto per le regole di progetto	"`.cursorrules`": legacy e destinato alla deprecazione

La pagina di assistenza di Cursor dice che Cmd+K "used to open inline edit, which has been replaced by this workflow" (apriva inline edit, che è stata sostituita da questo flusso di lavoro). Un post dello staff di Cursor sul forum ufficiale indica la data, 26 ottobre 2026, e dice che questo include la generazione di comandi con Cmd+K nel terminale. Il sostituto suggerito è Cmd+I e chiedere ad Agent. Una pagina di assistenza, sul terminale, parla ancora di generare comandi in linguaggio naturale, quindi la documentazione non è del tutto coerente su questo punto. Questa guida segue il post dello staff.

Scorciatoie per il primo giorno

La tabella di riferimento di Cursor elenca solo i tasti Mac e le pagine di assistenza aggiungono alcuni tasti per Windows e Linux. Dove non c'è nulla, lo diciamo invece di tirare a indovinare. In quei casi, controlla le impostazioni delle scorciatoie nell'app (Cmd+R poi Cmd+S, oppure Ctrl+R poi Ctrl+S).

Azione	Mac	Windows / Linux
Aprire o chiudere il pannello Agent	Cmd+I, Cmd+L o Cmd+K	Ctrl+I, Ctrl+L o Ctrl+K
Inviare il codice selezionato a una nuova chat	Cmd+L o Cmd+K	Ctrl+L o Ctrl+K
Aggiungere il codice selezionato alla chat corrente	Cmd+Shift+L	Non indicato, controlla nell'app
Scorrere le modalità	Shift+Tab	Shift+Tab
Aprire il menu delle modalità	Cmd+.	Ctrl+.
Scorrere i modelli	Cmd+/	Ctrl+/
Accettare un suggerimento di Tab	Tab	Tab
Accettare Tab parola per parola	Cmd+→	Ctrl+→
Rifiutare un suggerimento di Tab	Escape, o continua a scrivere	Escape, o continua a scrivere
Accettare tutte le modifiche	Cmd+Return	Non indicato, controlla nell'app
Rifiutare tutte le modifiche	Cmd+Shift+Backspace	Non indicato, controlla nell'app
Cursor Settings	Cmd+Shift+J	Ctrl+Shift+J
Palette dei comandi	Cmd+Shift+P	Ctrl+Shift+P

Due tasti dipendono da dove ti trovi. Cmd+K apre il pannello nell'editor, ma nella Agents Window apre una palette dei comandi. Anche Cmd+Return ha diversi significati a seconda del contesto, come mostra il riferimento alle scorciatoie da tastiera. Cmd+Shift+Backspace è indicata anche per annullare una risposta in corso, quindi premila con attenzione.

Il primo task passo per passo: migliora un piccolo progetto con Agent

Questo esempio usa una singola pagina web, quindi non ti servono strumenti oltre a Cursor e a un browser. Prima farai domande, poi lascerai che Agent apporti le modifiche.

Passaggio 1: crea il progetto di prova

Crea una cartella vuota chiamata cursor-practice, poi sceglila come cartella in Cursor. Crea un file chiamato index.html e incolla questo:

<!doctype html>
<html>
  <head><meta charset="utf-8"><title>Tip calculator</title></head>
  <body>
    <h1>Tip calculator</h1>
    <label>Bill <input id="bill" type="number"></label>
    <button onclick="calculate()">Calculate 15% tip</button>
    <p id="result"></p>
    <script>
      function calculate() {
        const bill = Number(document.getElementById("bill").value);
        document.getElementById("result").textContent = "Tip: " + (bill * 0.15);
      }
    </script>
  </body>
</html>

Salva il file e aprilo nel browser. Premi il pulsante con il conto (Bill) vuoto e ottieni "Tip: 0". È questo il piccolo problema che risolverai.

Passaggio 2: chiedi prima di cambiare qualcosa

Premi Cmd+I (Ctrl+I). Apri il menu a tendina delle modalità e scegli Ask, oppure premi Shift+Tab finché non compare. Scrivi:

Explain what index.html does in plain language.
Then list the problems a user could run into.

(Il prompt chiede di spiegare in linguaggio semplice che cosa fa index.html e di elencare i problemi in cui si potrebbe imbattere chi lo usa.)

Che cosa dovresti vedere: una risposta scritta nel pannello. Il tuo file non cambia, perché Ask è di sola lettura. La risposta probabilmente citerà il conto vuoto. La formulazione esatta varia da un'esecuzione all'altra, quindi non aspettarti una risposta fissa.

Passaggio 3: dai ad Agent un task specifico

Torna ad Agent. Cambiare modalità apre una nuova finestra di contesto, quindi scrivi la richiesta in modo che stia in piedi da sola:

In @index.html, improve the tip calculator:
1. If the bill is empty, zero or negative, show "Enter a bill above 0".
2. Show the tip with two decimal places.
3. Add a dropdown for 10%, 15% and 20%, with 15% selected by default.
Keep everything in this one file. Do not add libraries.

(In sintesi: se il conto è vuoto, zero o negativo, mostra il messaggio indicato; mostra la mancia con due decimali; aggiungi un menu a tendina con 10%, 15% e 20%, con 15% selezionato di default; tieni tutto in questo file e non aggiungere librerie.)

Che cosa dovresti vedere: Agent legge il file e inizia a modificarlo. Il punto importante per chi inizia è che le modifiche vengono applicate mentre Agent lavora. Non approvi ogni modifica in anticipo. Rivedi il risultato dopo, in una vista diff.

Agent può anche voler eseguire un comando. Come viene gestito dipende dalla modalità di esecuzione, impostata in Cursor Settings > Agents > Approvals & Execution. Le opzioni sono Auto-review (predefinita), Allowlist e Run Everything. Per ora lascia il valore predefinito.

Passaggio 4: rivedi il diff

Cursor mostra le modifiche in una vista diff. La documentazione non indica il pulsante esatto, quindi cercalo intorno al file modificato e al pannello Agent. Leggilo riga per riga. Un diff mostra le righe rimosse e quelle aggiunte, così vedi esattamente che cosa è cambiato. Per questo task, cerca:

un controllo sul valore del conto
un menu a tendina con tre percentuali
una mancia arrotondata a due decimali
niente di estraneo, come un nuovo file che non hai chiesto

Rifiuta tutto ciò che non vuoi. Per accettare o rifiutare tutto in una volta su Mac, usa Cmd+Return o Cmd+Shift+Backspace. Per Windows e Linux, controlla nell'app, come indicato sopra.

Passaggio 5: provalo di persona

Ricarica la pagina nel browser e prova questi casi:

Input	Risultato atteso
Conto vuoto	Il messaggio "Enter a bill above 0"
-5	Lo stesso messaggio
100 al 15%	Tip: 15.00, o simile
100 al 20%	Tip: 20.00, o simile

Se uno fallisce, di' ad Agent esattamente che cosa è successo: "Con un conto di -5 la pagina mostra Tip: -0.75. Dovrebbe mostrare il messaggio." Funziona molto meglio di "non funziona".

Passaggio 6: esercitati ad annullare

Ora fai una modifica che intendi buttare via:

Change the page background to bright green and make all text 40px.

(Questo prompt rende verde acceso lo sfondo della pagina e porta tutto il testo a 40px.)

Ricarica il browser per vederla. Poi scorri verso l'alto nella conversazione e fai clic su Restore Checkpoint su quella richiesta. Una pagina di assistenza chiama questo pulsante Revert. Ricarica di nuovo e il verde dovrebbe sparire. Se non sparisce, ripristina dalla richiesta precedente. Agent crea checkpoint prima delle modifiche significative, quindi se non vedi alcun pulsante per una modifica così piccola, rifiutala invece nel diff. I tuoi messaggi restano nella conversazione, perché un ripristino riporta indietro solo i file.

Questo è l'intero ciclo quotidiano: chiedi, dai istruzioni, rivedi, prova, annulla se serve. Se leggere i diff è la parte che non vuoi mai fare, è utile scoprirlo presto. Può essere segno che NxCode, il nostro app builder, sia più adatto a te di un editor.

Quando usare Agent, Ask, Plan e Debug

Ci sono quattro modalità. Passa da una all'altra con Shift+Tab o con il menu a tendina nel pannello Agent.

Modalità	Usala quando	Può modificare i file?	Prompt di esempio
Agent	Vuoi costruire, rifattorizzare o correggere qualcosa. È la modalità predefinita	Sì	"Aggiungi un pulsante di reset e cancella il risultato quando viene premuto."
Ask	Vuoi capire il codice	No, sola lettura	"Come viene calcolata qui la mancia?"
Plan	Il task è grande o poco chiaro e vuoi controllare prima l'approccio	Dopo la tua approvazione	"Pianifica come dividere questa pagina in file HTML, CSS e JS separati."
Debug	Un bug richiede prove dal programma in esecuzione	Sì	"La mancia è sbagliata dopo che cambio la percentuale. Trova la causa."

Un modo semplice per scegliere:

Non l'hai ancora capito? Ask.
Sai che cosa vuoi e la modifica è piccola? Agent.
Tocca molti file, o hai dubbi sull'approccio? Plan.
Un bug che non riesci a spiegare leggendo il codice? Debug.

In Plan mode, Agent fa domande di chiarimento, analizza il tuo codice e scrive un piano. Non viene costruito nulla finché non fai clic su Build. I piani vengono salvati per impostazione predefinita nella tua home directory, e Save to workspace ne sposta uno nel progetto. Cursor può anche suggerire Plan quando la tua richiesta sembra complessa.

In Debug mode, Agent formula ipotesi, aggiunge log e usa le informazioni di esecuzione per trovare la causa.

Rivedere e annullare le modifiche

Checklist di revisione

Usala prima di tenere qualsiasi modifica di Agent:

Leggi l'intero diff, non solo il riepilogo.
Ogni file modificato è collegato al task.
Sai spiegare ogni modifica. Se non ci riesci, chiedi in modalità Ask.
Non è stato eliminato nulla che doveva restare.
Nel codice non compaiono password, chiavi o altri segreti.
Hai provato di persona, compreso un input errato.

Oltre alla tua revisione, Cursor ha Agent Review, che si avvia con /agent-review o dalla scheda Source Control.

Come funzionano i checkpoint

Agent crea automaticamente un checkpoint prima delle modifiche significative. I checkpoint sono salvati in locale e sono separati da Git.

Ci sono tre modi per ripristinare:

Fai clic su un checkpoint nella cronologia della chat per vederne l'anteprima, poi ripristina.
Fai clic su Restore Checkpoint su una richiesta precedente.
Passa il mouse su un messaggio e fai clic sul pulsante +.

Il ripristino riporta indietro i file ma non elimina i messaggi. Per accorciare anche la conversazione, crea un fork da un messaggio precedente.

Le pagine ufficiali si contraddicono su un nome. La documentazione di Agent chiama il pulsante Restore Checkpoint, mentre la pagina di assistenza di Plan lo chiama Revert, seguito da Confirm. Cerca una delle due etichette.

Usa Git per tutto ciò che vuoi tenere

Il consiglio di Cursor è "use Git for permanent version control" (usa Git per il controllo di versione permanente). I checkpoint sono un annullamento rapido, e Git è la tua cronologia a lungo termine. Prima di un task più grande con Agent, salva uno stato funzionante:

git init
git add .
git commit -m "Working version before Agent task"

git init serve solo una volta per progetto.

Aggiungi regole al tuo progetto

Le regole sono istruzioni permanenti, così non devi ripeterti. Aggiungine una al progetto di prova. Ci sono tre modi per creare una regola di progetto:

Scrivi /create-rule nella chat.
Vai su Customize > Rules > Add Rule.
Esegui New Cursor Rule dalla palette dei comandi.

Oppure crea il file da te in .cursor/rules/practice.mdc:

---
description: Conventions for this practice project
globs:
alwaysApply: true
---

- Keep everything in index.html unless asked otherwise.
- Do not add libraries.
- Use clear variable names and short comments.

Ora chiedi ad Agent un'altra piccola modifica. Dovrebbe seguire queste regole senza che tu glielo dica.

Quattro cose da sapere:

L'estensione deve essere .mdc. I file che terminano in .md vengono ignorati dal sistema di regole in quella cartella.
AGENTS.md è l'opzione più semplice. È Markdown semplice, da mettere nella root del progetto o in una sottocartella. Cursor legge CLAUDE.md allo stesso modo.
Le regole si applicano solo ad Agent. Non influenzano Tab né Bugbot.
Tienile brevi. Cursor suggerisce meno di 500 righe per regola.

Le regole hanno quattro tipi: Always Apply, Apply Intelligently, Apply to Specific Files e Apply Manually (con una menzione @). La precedenza è Team, poi Project, poi User. .cursorrules è legacy e sarà deprecato, quindi non iniziare un nuovo progetto con questo file.

MCP, Skills, Subagents e Cloud Agents in breve

Il primo giorno non ti serve nulla di tutto questo. È solo per farti riconoscere i nomi.

MCP collega Agent a strumenti e servizi esterni. Installa da Customize > MCPs > Add to Cursor, oppure configura .cursor/mcp.json in un progetto o ~/.cursor/mcp.json a livello globale. Se entrambi definiscono lo stesso nome, vince il progetto. La nostra guida a Cursor MCP approfondisce.
Skills sono cartelle con un file SKILL.md che insegnano ad Agent una procedura. Agent le usa quando sono pertinenti, oppure ne richiami una con /. Tra gli esempi integrati ci sono /create-rule, /review e /shell.
Subagents hanno un proprio contesto e possono funzionare in parallelo. Quelli integrati sono Explore e Browser. Quelli personalizzati vanno in .cursor/agents/.
Cloud Agents funzionano su macchine cloud isolate, quindi non dipendono dal fatto che il tuo computer resti online. Scegli Cloud dal menu a tendina nella casella di input dell'agente. Prima chi amministra deve collegare GitHub, GitLab, Bitbucket o Azure DevOps, e ti serve l'accesso in lettura e scrittura al repository. Non sono disponibili su Free o Plus.

La riga di comando: `agent`

Cursor ha anche una CLI e il comando è agent. Installala con:

# macOS, Linux, WSL
curl https://cursor.com/install -fsS | bash

# Windows PowerShell
irm 'https://cursor.com/install?win32=true' | iex

Verificala con agent --version e accedi con agent login. Poi esegui agent in una cartella di progetto per una sessione interattiva, oppure agent -p "your request" per una singola esecuzione non interattiva. Legge gli stessi file .cursor/rules, AGENTS.md e CLAUDE.md dell'editor. Chi inizia può lasciarla per dopo.

Errori comuni

Seguire un vecchio tutorial. Se una guida dice di aprire la modalità Composer, premere Cmd+K per modificare sul posto o scegliere un modello al primo avvio, descrive un Cursor più vecchio.

Dare per scontato che nulla cambi finché non accetti. Le modifiche di Agent sono già applicate mentre lavora. Controlla il diff prima di proseguire e non eseguire il codice sulla fiducia.

Scrivere richieste vaghe. "Sistema questo" dà ad Agent poco su cui lavorare. Di' che cosa succede, che cosa dovrebbe succedere e dove: "Quando il conto è vuoto, la pagina mostra Tip: 0. Dovrebbe invece mostrare un messaggio."

Partire troppo in grande. Non iniziare con un'app completa. Usa prima piccoli task e usa Plan mode per tutto ciò che è più grande.

Trattare i checkpoint come backup. Sono locali e separati da Git. Fai il commit di tutto ciò che ti interessa.

Salvare una regola come .md. Sembra corretta e non fa nulla. Usa .mdc, oppure AGENTS.md nella root del progetto.

Cambiare la modalità di esecuzione il primo giorno. Lascia il valore predefinito finché non capisci che cosa esegue Agent sul tuo computer e quale permesso concede ogni opzione.

Scegliere un modello di terze parti senza controllare il costo. Su Premium e superiori, i modelli di terze parti consumano crediti prepagati al prezzo di listino API dalla prima richiesta. Non usano il tuo pool settimanale.

Accettare codice che non sai spiegare. La modalità Ask esiste per questo. Chiedi "che cosa fa questa modifica, passo per passo?" prima di tenerla.

Risoluzione dei problemi

Interfaccia e configurazione

Che cosa vedi	Motivo probabile	Che cosa fare
Nessuna modalità Composer da nessuna parte	Non esiste più come modalità	Usa Agent con Cmd+I (Ctrl+I)
Cmd+K non modifica sul posto	Inline Edit è stata ritirata	Seleziona il codice, premi Cmd+K, poi descrivi la modifica in Agent
Cmd+K apre una palette dei comandi	Sei nella Agents Window	Usa Cmd+Shift+P, poi Open IDE per tornare all'editor
Compare una pagina di login Grok o xAI	Accesso condiviso	È previsto. Accedere non unisce gli account
Manca un'estensione	Potrebbe non essere su Open VSX	Cerca un'alternativa su Open VSX
Una regola viene ignorata	Estensione o posizione errata	Usa `.cursor/rules/name.mdc` e controlla il suo tipo
Agent dimentica il contesto precedente	Hai cambiato modalità	Ogni cambio apre una nuova finestra di contesto, quindi ribadisci i punti chiave
Una scorciatoia non fa nulla su Windows	Può essere diversa dal tasto Mac	Controlla le impostazioni delle scorciatoie con Ctrl+R poi Ctrl+S

Modelli, piani e CLI

Che cosa vedi	Motivo probabile	Che cosa fare
Mancano Claude o GPT	Piano o regione	Free e Plus escludono i modelli di terze parti. Alcuni modelli sono anche nascosti in certe regioni
I Cloud Agents non sono disponibili	Piano o configurazione del repository	Servono Premium o superiore, un provider Git collegato e l'accesso al repository
Raggiungi un limite di utilizzo	Limite del piano raggiunto	Controlla Usage su grok.com/dashboard. Sui piani a pagamento, aspetta il reset settimanale, usa crediti prepagati o fai l'upgrade
Non trovi la fatturazione	La fatturazione si è spostata	The X Subscription usa grok.com/dashboard/billing. I piani legacy usano cursor.com/dashboard/spending
`agent: command not found`	`~/.local/bin` non è nel tuo PATH	Aggiungilo al PATH, poi apri un nuovo terminale

Quando usare un altro strumento

Cursor è uno strumento per lavorare con il codice. Questi scenari possono indicare altro:

Non vuoi affatto scrivere o rivedere codice. Vuoi un'app funzionante a partire da una descrizione. È a questo che serve NxCode, un nostro prodotto. Lo produciamo noi, quindi tienine conto mentre leggi, e vedi il nostro confronto con Cursor e Copilot.
Vivi nel terminale. Prova prima il comando agent di Cursor, oppure confrontalo con il flusso di lavoro del nostro tutorial su Claude Code.
Usi JetBrains. Potresti non dover cambiare editor, perché l'agente di Cursor si collega a JetBrains tramite ACP.
Stai ancora confrontando gli strumenti. La nostra classifica degli strumenti di AI coding illustra le opzioni.

Provare Cursor su Free non costa nulla, quindi un piccolo task reale è un modo ragionevole per decidere. Se il flusso di lavoro qui sopra ti è sembrato naturale, resta. Se era il codice stesso a intralciarti, il primo scenario probabilmente fa per te.

FAQ

Come si inizia a usare Cursor per la prima volta?

Scarica Cursor da cursor.com/download, aprilo, accedi e scegli una cartella. Poi premi Cmd+I (Ctrl+I su Windows e Linux) per aprire Agent e chiedigli di spiegare il codice. La guida rapida di Cursor consiglia di iniziare con un piccolo task come questo.

Che fine ha fatto la modalità Composer in Cursor?

La modalità Composer non compare nella documentazione attuale di Cursor. Composer è ora il nome del modello proprietario di Cursor, attualmente Composer 2.5. Le quattro modalità sono Agent, Ask, Plan e Debug. Per il lavoro su più file che i vecchi tutorial facevano nella modalità Composer, usa Agent.

Che fine ha fatto la modifica inline con Cmd+K in Cursor?

Inline Edit è stata ritirata. Un post dello staff di Cursor sul forum ufficiale la data al 26 ottobre 2026. Nell'editor, seleziona il codice e premi Cmd+K o Cmd+L (Ctrl+K o Ctrl+L su Windows e Linux) per portare la selezione in Agent, poi descrivi lì la modifica.

Cursor è gratis?

Sì, esiste un piano Free a $0 con utilizzo limitato di Agent, Chat e Tab. Cursor non pubblica un numero per questi limiti. L'attuale pagina dei prezzi non dice se serva una carta di credito, quindi controlla al momento della registrazione. I piani a pagamento partono da Plus a $8 al mese, tasse escluse.

Quali modelli AI posso usare in Cursor?

I modelli propri di Cursor sono Grok 4.7, che definisce il suo modello di punta, Grok 4.6, Grok 4.5 e Composer 2.5. I modelli di terze parti come Claude, GPT e Gemini richiedono Premium o superiore e vengono addebitati al prezzo di listino API dai crediti prepagati. Free e Plus non li includono.

Cursor Agent modifica i miei file prima che io approvi?

Sì. Agent applica le modifiche mentre lavora e tu le rivedi dopo in una vista diff, dove puoi rifiutare ciò che non vuoi. Agent crea anche checkpoint prima delle modifiche significative, quindi puoi ripristinare stati precedenti dei file.

Devo saper programmare per usare Cursor?

Puoi provarlo senza molta esperienza perché la modalità Ask spiega il codice in linguaggio semplice, ma devi comunque leggere i diff e valutare il risultato. Se preferisci descrivere un'app e non lavorare affatto con il codice, NxCode, un nostro prodotto, è pensato per questo.

Dove posso acquistare Cursor, e posso abbonarmi dalla Cina continentale?

Cursor dice che gli abbonamenti sono venduti solo tramite il suo sito ufficiale o con acquisto in-app, e che non autorizza rivenditori. L'acquisto in-app su iOS copre le regioni dell'App Store tranne la Cina continentale. Non è stato possibile verificare dalle pagine ufficiali se gli abbonamenti web siano limitati nella Cina continentale.

Fonti

Tutte le pagine sono state controllate il 1 novembre 2026. Scorciatoie, piani e nomi possono cambiare, quindi considera l'app e le pagine ufficiali come riferimento definitivo.