SpyBara
Go Premium

desktop-quickstart.md 2026-11-09 23:02 UTC to 2026-11-10 21:57 UTC

No changes for this document in this history range.

2026

Iniziare con l'app desktop

Installa l'app desktop di Claude, apri la scheda Code e avvia la tua prima sessione di Claude Code su una cartella di progetto sul tuo computer.

L'app desktop ti offre Claude Code con un'interfaccia grafica. Puoi chiedere a Claude di lavorare sul codice in una cartella sul tuo computer e poi rivedere tu stesso le modifiche, senza usare un terminale.

Claude Code si trova nella scheda Code nella parte superiore della barra laterale dell'app. Questa pagina illustra l'installazione dell'app e l'avvio della tua prima sessione in quella scheda. Claude Code richiede un abbonamento Pro, Max, Ultra, Team o Enterprise.

[card] Scarica per macOS

Build universale per Intel e Apple Silicon

[card] Scarica per Windows

Per processori x64

[card] Ottieni Claude per Linux (beta)

apt o .deb per Ubuntu e Debian

Per Windows ARM64, scarica l'installer ARM64. Su Linux, installa con apt; vedi Claude Desktop su Linux.

[!NOTE]

Questi casi sono trattati in altre pagine:

Installa

1. Installa e accedi

Su macOS e Windows, scarica il programma di installazione dai link sopra ed eseguilo. Su Linux, segui i passaggi di installazione in Claude Desktop su Linux. Avvia Claude dalla cartella Applicazioni su macOS, dal menu Start su Windows, o dal tuo launcher di applicazioni su Linux, quindi accedi con il tuo account Anthropic.

2. Apri la scheda Code

Fai clic sulla scheda Code nella parte superiore della barra laterale. Se le schede mostrano solo icone, passa il mouse su una per vederne il nome. Se dopo aver fatto clic su Code compare un prompt o un errore, segui la soluzione corrispondente:

L'app desktop include Claude Code, quindi non è necessario installare Node.js o la CLI per utilizzare la scheda Code.

Avvia la tua prima sessione

Con la scheda Code aperta, scegli un progetto e dai a Claude qualcosa da fare.

1. Scegli un ambiente e una cartella

Nella riga sotto la casella del prompt, fai clic sul primo controllo, il selettore dell'ambiente, e seleziona la prima voce nel gruppo Local. Poi fai clic sul controllo della cartella del progetto accanto al selettore dell'ambiente, seleziona Open folder… e scegli la directory del tuo progetto.

Se una nuova sessione non mostra alcun ambiente sotto la casella del prompt, hai il layout precedente. Vedi Verifica quale layout hai.

[!TIP]

Inizia con un piccolo progetto che conosci bene. È il modo più veloce per vedere cosa può fare Claude Code.

Puoi anche selezionare:

  • Cloud: Esegui sessioni nel cloud che continuano anche se chiudi l'app. Vedi Usa Claude Code nel cloud per sapere come funzionano le sessioni cloud.
  • SSH: Connettiti a una macchina remota tramite SSH, come i tuoi server, VM cloud o dev container. Prima aggiungi una connessione. Desktop installa Claude Code sulla macchina remota automaticamente la prima volta che ti connetti. Un'attività in esecuzione può continuare mentre Desktop è disconnesso, ma con un account Claude può interrompersi quando il suo accesso scade.
  • WSL (Windows): Esegui la sessione all'interno di una distribuzione WSL 2; Claude Code, gli strumenti e git vengono eseguiti sul lato Linux con percorsi nativi.

2. Scegli un modello

Seleziona un modello dal selettore dei modelli verso l'estremità destra della riga sotto la casella del prompt. Vedi modelli per un confronto dei modelli disponibili. Puoi cambiare il modello in seguito dal selettore dei modelli.

3. Dì a Claude cosa fare

Digita quello che vuoi che Claude faccia:

  • Find a TODO comment and fix it
  • Add tests for the main function
  • Create a CLAUDE.md with instructions for this codebase

Una sessione è una conversazione con Claude sul tuo codice. Ogni sessione tiene traccia del suo proprio contesto e delle sue modifiche.

4. Rivedi e accetta le modifiche

Controlla la tua modalità di permesso nella riga sotto la casella del prompt per vedere se Claude attende la tua approvazione:

  • Auto o Accept edits: Claude applica le sue modifiche ai file e appare un indicatore come +12 -1 in modo che tu possa esaminarle nella vista diff
  • Manual: Claude propone ogni modifica e attende la tua approvazione prima di applicarla

In modalità Manual, vedrai:

  1. Un diff che mostra esattamente cosa cambierà
  2. Pulsanti per approvare o rifiutare ogni modifica
  3. Aggiornamenti in tempo reale mentre Claude elabora la tua richiesta

E ora?

Hai fatto la tua prima modifica. Per il riferimento completo su tutto ciò che Desktop può fare, consulta Usare Claude Code Desktop. Ecco alcune cose da provare dopo.

Interrompi e reindirizza. Puoi reindirizzare Claude in qualsiasi momento. Fai clic sul pulsante di stop per interrompere immediatamente, oppure digita una correzione e premi Enter per inviarla senza fermare l'azione in corso. In entrambi i casi, non devi aspettare che finisca né ricominciare da capo.

Dai a Claude più contesto. Digita @filename nella casella del prompt per includere un file specifico nella conversazione. Più contesto ha Claude, migliori sono i risultati. Consulta Aggiungere file e contesto.

Usa le skill per le attività ripetibili. Digita / o fai clic su + → Slash commands per sfogliare i comandi integrati, le skill personalizzate e le skill dei plugin. Le skill sono prompt riutilizzabili che puoi richiamare ogni volta che ti servono, come checklist per la code review o passaggi di deploy.

Rivedi le modifiche prima di fare commit. Dopo che Claude modifica i file, compare un indicatore +12 -1. Fai clic su di esso per aprire la vista diff, rivedere le modifiche file per file e commentare righe specifiche. Claude legge i tuoi commenti e apporta revisioni. Per far rivedere le modifiche a Claude stesso, inserisci /code-review nella casella del prompt.

Regola il livello di controllo. La tua modalità di permesso stabilisce quanto Claude può fare senza chiedere approvazione:

  • Auto: un classificatore esamina le azioni in background e blocca quelle rischiose invece di chiederti conferma.
  • Manual: Claude chiede prima di modificare file o eseguire comandi.
  • Accept edits: Claude accetta automaticamente le modifiche ai file per iterazioni più rapide.
  • Plan: Claude propone un approccio senza modificare alcun file, utile prima di un refactoring di grandi dimensioni.

Aggiungi plugin per ulteriori funzionalità. Installa plugin che aggiungono skill, agenti, server MCP e altro ancora.

Organizza il tuo workspace. Trascina i riquadri di chat, diff, terminale, file e browser nel layout che preferisci. Apri il terminale con Ctrl+` per eseguire comandi accanto alla tua sessione, oppure fai clic su un percorso di file per aprirlo. Consulta Organizzare il tuo workspace.

Visualizza l'anteprima della tua app. Quando esegui il tuo server di sviluppo nel desktop, la tua app si apre nel riquadro Browser, che può anche aprire siti esterni. Claude può visualizzare l'app in esecuzione, testare gli endpoint, ispezionare i log e iterare in base a ciò che vede. Consulta Visualizzare l'anteprima della tua app.

Monitora la tua pull request. Dopo aver aperto una PR, Claude Code monitora i risultati dei controlli CI e può correggere automaticamente gli errori. Consulta Monitorare lo stato della pull request.

Pianifica il lavoro di Claude. Configura attività pianificate per eseguire Claude automaticamente su base ricorrente: una code review quotidiana ogni mattina, un audit settimanale delle dipendenze o un briefing che attinge dai tuoi strumenti collegati.

Espanditi quando sei pronto. Apri sessioni parallele dalla barra laterale per lavorare su più attività contemporaneamente, facoltativamente ciascuna nel proprio worktree Git, e apri il riquadro delle attività per osservare i subagent e i comandi in background che una sessione ha in esecuzione. Apri una chat laterale per fare una domanda senza deviare il thread principale. Invia il lavoro di lunga durata al cloud in modo che continui anche se chiudi l'app, oppure sposta nel cloud una sessione che hai già avviato se un'attività richiede più tempo del previsto. Collega strumenti esterni come GitHub, Slack e Linear per unificare il tuo workflow.

Cosa fare dopo

  • Usa Claude Code Desktop: modalità di autorizzazione, sessioni parallele, visualizzazione diff, connettori e configurazione aziendale
  • Provieni dalla CLI?: esegui Desktop e la CLI sullo stesso progetto, e confronta le funzionalità, gli equivalenti dei flag e ciò che non è disponibile in Desktop
  • Risoluzione dei problemi: soluzioni agli errori comuni e ai problemi di configurazione
  • Best practices: suggerimenti per scrivere prompt efficaci e ottenere il massimo da Claude Code
  • Flussi di lavoro comuni: tutorial per il debug, il refactoring, i test e altro ancora