Usa Claude Code Desktop - Claude Code Docs

L’app Claude Desktop ha tre schede: Chat per le conversazioni, Cowork per Dispatch e lavoro agentico più lungo, e Code per lo sviluppo software. Questa pagina è il riferimento per la scheda Code.

Download for macOS

Universal build for Intel and Apple Silicon

Download for Windows

For x64 processors

For Windows ARM64, download the ARM64 installer. The desktop app is not available on Linux; use the CLI instead. Dopo l’installazione, avvia Claude, accedi e fai clic sulla scheda Code. La prima volta che lo apri su Windows, hai bisogno di Git for Windows installato; riavvia l’app dopo averlo installato. Per una procedura dettagliata della tua prima sessione, consulta la guida introduttiva. Nella scheda Code, ogni conversazione è una sessione: ha la sua propria cronologia chat, cartella di progetto e modifiche al codice, indipendente da qualsiasi altra sessione. La barra laterale elenca le tue sessioni e ti consente di eseguirne diverse in parallelo. All’interno di una sessione puoi:

Rivedere e commentare i diff, quindi monitorare il PR risultante attraverso CI
Visualizzare in anteprima la tua app in esecuzione in un browser integrato mentre Claude verifica le sue stesse modifiche
Organizzare i pannelli per la chat, diff, anteprima, terminale e editor di file uno accanto all’altro
Porre una domanda laterale che utilizza il contesto della sessione senza deviare da essa
Connettere strumenti esterni come GitHub, Slack e Linear
Consentire a Claude di aprire app e controllare il tuo schermo
Eseguire sulla tua macchina, nel cloud, o su SSH

Per lavoro ricorrente pianificato, scorciatoie da tastiera, o invio di attività dal tuo telefono, consulta le pagine e le sezioni collegate. Se utilizzi già il CLI basato su terminale, consulta il confronto CLI per vedere cosa si trasferisce.

Avvia una sessione

Prima di inviare il tuo primo messaggio, configura quattro cose nell’area del prompt:

Ambiente: scegli dove Claude viene eseguito. Seleziona Local per la tua macchina, Remote per sessioni cloud ospitate da Anthropic, o una connessione SSH per una macchina remota che gestisci. Vedi configurazione dell’ambiente.
Cartella del progetto: seleziona la cartella o il repository su cui Claude lavora. Per le sessioni remote, puoi aggiungere più repository.
Modello: scegli un modello dal menu a discesa accanto al pulsante di invio. Puoi cambiare questo durante la sessione.
Modalità di autorizzazione: scegli quanta autonomia ha Claude dal selettore di modalità. Puoi cambiare questo durante la sessione.

Digita il tuo compito e premi Invio per iniziare. Ogni sessione traccia il suo proprio contesto e le modifiche in modo indipendente.

Lavora con il codice

Dai a Claude il contesto giusto, controlla quanto fa da solo e rivedi cosa ha cambiato.

Usa la casella del prompt

Digita quello che vuoi che Claude faccia e premi Invio per inviare. Claude legge i file del tuo progetto, apporta modifiche ed esegue comandi in base alla tua modalità di autorizzazione. Puoi interrompere Claude in qualsiasi momento: fai clic sul pulsante di arresto o digita la tua correzione e premi Invio. Claude smette di fare quello che sta facendo e si adatta in base al tuo input. Il pulsante + accanto alla casella del prompt ti dà accesso agli allegati di file, skills, connettori e plugin.

Aggiungi file e contesto ai prompt

La casella del prompt supporta due modi per portare contesto esterno:

@mention file: digita @ seguito da un nome di file per aggiungere un file al contesto della conversazione. Claude può quindi leggere e fare riferimento a quel file. @mention non è disponibile nelle sessioni remote.
Allega file: allega immagini, PDF e altri file al tuo prompt usando il pulsante di allegato, o trascina e rilascia i file direttamente nel prompt. Questo è utile per condividere screenshot di bug, mockup di design o documenti di riferimento.

Scegli una modalità di autorizzazione

Le modalità di autorizzazione controllano quanta autonomia ha Claude durante una sessione: se chiede prima di modificare file, eseguire comandi o entrambi. Puoi cambiare modalità in qualsiasi momento usando il selettore di modalità accanto al pulsante di invio. Inizia con Chiedi autorizzazioni per vedere esattamente cosa fa Claude, quindi passa a Accetta automaticamente modifiche o Plan mode man mano che acquisisci familiarità.

Modalità	Chiave di impostazione	Comportamento
Chiedi autorizzazioni	`default`	Claude chiede prima di modificare file o eseguire comandi. Vedi un diff e puoi accettare o rifiutare ogni modifica. Consigliato per i nuovi utenti.
Accetta automaticamente modifiche	`acceptEdits`	Claude accetta automaticamente le modifiche ai file e i comandi comuni del filesystem come `mkdir`, `touch` e `mv`, ma chiede comunque prima di eseguire altri comandi di terminale. Usa questo quando ti fidi delle modifiche ai file e vuoi un’iterazione più veloce.
Plan mode	`plan`	Claude legge i file ed esegue comandi per esplorare, quindi propone un piano senza modificare il tuo codice sorgente. Buono per compiti complessi dove vuoi rivedere l’approccio prima.
Auto	`auto`	Claude esegue tutte le azioni con controlli di sicurezza in background che verificano l’allineamento con la tua richiesta. Riduce i prompt di autorizzazione mantenendo la supervisione. Abilita in Impostazioni → Claude Code. Vedi requisiti di disponibilità di seguito.
Bypass permissions	`bypassPermissions`	Claude viene eseguito senza alcun prompt di autorizzazione, equivalente a `--dangerously-skip-permissions` nella CLI. Abilita in Impostazioni → Claude Code sotto “Allow bypass permissions mode”. Usa solo in container sandbox o VM. Gli amministratori aziendali possono disabilitare questa opzione.

La modalità di autorizzazione dontAsk è disponibile solo nella CLI. Auto mode è un’anteprima di ricerca disponibile su piani Max, Team, Enterprise e API. Non è disponibile su piani Pro o provider di terze parti. Su piani Team, Enterprise e API richiede Claude Sonnet 4.6, Opus 4.6 o Opus 4.7. Su piani Max richiede Claude Opus 4.7.

Inizia compiti complessi in Plan mode in modo che Claude mappi un approccio prima di apportare modifiche. Una volta approvato il piano, passa a Accetta automaticamente modifiche o Chiedi autorizzazioni per eseguirlo. Vedi esplora prima, poi pianifica, poi codifica per ulteriori informazioni su questo flusso di lavoro.

Le sessioni remote supportano Accetta automaticamente modifiche e Plan mode. Chiedi autorizzazioni non è disponibile perché le sessioni remote accettano automaticamente le modifiche ai file per impostazione predefinita, e Bypass permissions non è disponibile perché l’ambiente remoto è già sandbox. Gli amministratori aziendali possono limitare quali modalità di autorizzazione sono disponibili. Vedi configurazione aziendale per i dettagli.

Anteprima della tua app

Claude può avviare un server di sviluppo e aprire un browser incorporato per verificare le sue modifiche. Questo funziona per app web frontend così come per server backend: Claude può testare endpoint API, visualizzare log del server e iterare su problemi che trova. Nella maggior parte dei casi, Claude avvia il server automaticamente dopo aver modificato i file del progetto. Puoi anche chiedere a Claude di visualizzare un’anteprima in qualsiasi momento. Per impostazione predefinita, Claude verifica automaticamente le modifiche dopo ogni edit. Il pannello di anteprima può anche aprire file HTML statici, PDF, immagini e video dal tuo progetto. Fai clic su un percorso HTML, PDF, immagine o video nella chat per aprirlo in anteprima. Dal pannello di anteprima, puoi:

Interagire con la tua app in esecuzione direttamente nel browser incorporato
Guardare Claude verificare automaticamente le sue stesse modifiche: scatta screenshot, ispeziona il DOM, fa clic su elementi, compila moduli e corregge i problemi che trova
Avviare o arrestare server dal menu a discesa Preview nella barra degli strumenti della sessione
Persistere cookie e archiviazione locale tra i riavvii del server selezionando Persist sessions nel menu a discesa, in modo da non dover effettuare di nuovo l’accesso durante lo sviluppo
Modificare la configurazione del server o arrestare tutti i server contemporaneamente

Claude crea la configurazione iniziale del server in base al tuo progetto. Se la tua app utilizza un comando dev personalizzato, modifica .claude/launch.json per adattarlo alla tua configurazione. Vedi Configura server di anteprima per il riferimento completo. Per cancellare i dati della sessione salvati, attiva/disattiva Persist preview sessions in Impostazioni → Claude Code. Per disabilitare completamente l’anteprima, attiva/disattiva Preview in Impostazioni → Claude Code.

Rivedi le modifiche con la visualizzazione diff

Dopo che Claude apporta modifiche al tuo codice, la visualizzazione diff ti consente di rivedere le modifiche file per file prima di creare una pull request. Quando Claude modifica i file, appare un indicatore di statistiche diff che mostra il numero di righe aggiunte e rimosse, come +12 -1. Fai clic su questo indicatore per aprire il visualizzatore diff, che visualizza un elenco di file a sinistra e le modifiche per ogni file a destra. Per commentare righe specifiche, fai clic su qualsiasi riga nel diff per aprire una casella di commento. Digita il tuo feedback e premi Invio per aggiungere il commento. Dopo aver aggiunto commenti a più righe, invia tutti i commenti contemporaneamente:

macOS: premi Cmd+Invio
Windows: premi Ctrl+Invio

Claude legge i tuoi commenti e apporta le modifiche richieste, che appaiono come un nuovo diff che puoi rivedere.

Rivedi il tuo codice

Nella visualizzazione diff, fai clic su Review code nella barra degli strumenti in alto a destra per chiedere a Claude di valutare le modifiche prima di eseguire il commit. Claude esamina i diff attuali e lascia commenti direttamente nella visualizzazione diff. Puoi rispondere a qualsiasi commento o chiedere a Claude di rivedere. La revisione si concentra su problemi ad alto segnale: errori di compilazione, errori logici definitivi, vulnerabilità di sicurezza e bug ovvi. Non contrassegna stile, formattazione, problemi preesistenti o qualsiasi cosa che un linter catturebbe.

Monitora lo stato della pull request

Dopo aver aperto una pull request, una barra di stato CI appare nella sessione. Claude Code utilizza GitHub CLI per eseguire il polling dei risultati dei controlli e visualizzare i guasti.

Auto-fix: quando abilitato, Claude tenta automaticamente di correggere i controlli CI non riusciti leggendo l’output del guasto e iterando.
Auto-merge: quando abilitato, Claude unisce il PR una volta che tutti i controlli passano. Il metodo di merge è squash. Auto-merge deve essere abilitato nelle impostazioni del tuo repository GitHub affinché questo funzioni.

Usa gli interruttori Auto-fix e Auto-merge nella barra di stato CI per abilitare una delle due opzioni. Claude Code invia anche una notifica desktop quando CI termina. Per archiviare la sessione automaticamente una volta che il PR si unisce o si chiude, attiva auto-archive in Impostazioni → Claude Code.

Il monitoraggio dei PR richiede che GitHub CLI (gh) sia installato e autenticato sulla tua macchina. Se gh non è installato, Desktop ti chiede di installarlo la prima volta che tenti di creare un PR.

Organizza l’area di lavoro

La scheda Code è costruita attorno a pannelli che puoi organizzare in qualsiasi layout: chat, diff, anteprima, terminale, file, plan, tasks e subagent. Trascina un pannello dal suo header per riposizionarlo, o trascina un bordo del pannello per ridimensionarlo. Premi Cmd+\ su macOS o Ctrl+\ su Windows per chiudere il pannello focalizzato. Apri pannelli aggiuntivi dal menu Views nella barra degli strumenti della sessione.

Il layout del pannello, il terminale, l’editor di file e le modalità di visualizzazione in questa sezione richiedono Claude Desktop v1.2581.0 o successivo. Apri Claude → Check for Updates su macOS o Help → Check for Updates su Windows per aggiornare.

Esegui comandi nel terminale

Il terminale integrato ti consente di eseguire comandi insieme alla tua sessione senza passare a un’altra app. Aprilo dal menu Views o premi Ctrl+` su macOS o Windows. Il terminale si apre nella directory di lavoro della tua sessione e condivide lo stesso ambiente di Claude, quindi comandi come npm test o git status vedono gli stessi file che Claude sta modificando. Per aprire una seconda scheda del terminale, fai clic su + nell’header del pannello del terminale o fai clic con il pulsante destro su una cartella nella chat per scegliere Open in terminal. Il terminale è disponibile solo nelle sessioni locali.

Apri e modifica file

Fai clic su un percorso di file nella chat o nel visualizzatore diff per aprirlo nel pannello file. I percorsi HTML, PDF, immagine e video si aprono nel pannello di anteprima invece. Fai modifiche spot e fai clic su Save per scriverle di nuovo. Se il file è cambiato su disco da quando l’hai aperto, il pannello ti avverte e ti consente di sovrascrivere o scartare. Fai clic su Discard per ripristinare le tue modifiche, o fai clic sul percorso nell’header del pannello per copiare il percorso assoluto. Il pannello file è disponibile nelle sessioni locali e SSH. Per le sessioni remote, chiedi a Claude di apportare la modifica.

Apri file in altre app

Fai clic con il pulsante destro su qualsiasi percorso di file nella chat, nel visualizzatore diff o nel pannello file per aprire un menu di contesto:

Attach as context: aggiungi il file al tuo prossimo prompt
Open in: apri il file in un editor installato come VS Code, Cursor o Zed
Show in Finder su macOS, Show in Explorer su Windows: apri la cartella contenente
Copy path: copia il percorso assoluto negli appunti

Cambia modalità di visualizzazione

Le modalità di visualizzazione controllano quanti dettagli appaiono nella trascrizione della chat. Cambia modalità dal menu a discesa Transcript view accanto al pulsante di invio, o premi Ctrl+O su macOS o Windows per scorrere tra loro.

Modalità	Cosa mostra
Normal	Chiamate di strumenti compresse in riepiloghi, con risposte di testo completo
Verbose	Ogni chiamata di strumento, lettura di file e passaggio intermedio che Claude compie
Summary	Solo le risposte finali di Claude e le modifiche che ha apportato

Usa Verbose quando esegui il debug del motivo per cui Claude ha intrapreso una particolare azione. Usa Summary quando stai eseguendo più sessioni e vuoi scansionare i risultati rapidamente.

Scorciatoie da tastiera

Premi Cmd+/ su macOS o Ctrl+/ su Windows per vedere tutte le scorciatoie disponibili nella scheda Code. Su Windows, usa Ctrl al posto di Cmd per le scorciatoie di seguito. Il ciclo della sessione, l’interruttore del terminale e l’interruttore della modalità di visualizzazione usano Ctrl su ogni piattaforma.

Scorciatoia	Azione
`Cmd` `/`	Mostra scorciatoie da tastiera
`Cmd` `N`	Nuova sessione
`Cmd` `W`	Chiudi sessione
`Ctrl` `Tab` / `Ctrl` `Shift` `Tab`	Sessione successiva o precedente
`Cmd` `Shift` `]` / `Cmd` `Shift` `[`	Sessione successiva o precedente
`Esc`	Arresta la risposta di Claude
`Cmd` `Shift` `D`	Attiva/disattiva pannello diff
`Cmd` `Shift` `P`	Attiva/disattiva pannello di anteprima
`Cmd` `Shift` `S`	Seleziona un elemento in anteprima
`Ctrl` `	Attiva/disattiva pannello terminale
`Cmd` `\`	Chiudi pannello focalizzato
`Cmd` `;`	Apri chat laterale
`Ctrl` `O`	Scorrere le modalità di visualizzazione
`Cmd` `Shift` `M`	Apri menu modalità di autorizzazione
`Cmd` `Shift` `I`	Apri menu modello
`Cmd` `Shift` `E`	Apri menu sforzo
`1`–`9`	Seleziona elemento in un menu aperto

Queste scorciatoie si applicano solo alla scheda Code. Le scorciatoie della modalità interattiva basata su terminale, come Shift+Tab per scorrere le modalità, non si applicano in Desktop.

Controlla l’utilizzo

Fai clic sull’anello di utilizzo accanto al selettore di modello per vedere l’utilizzo della finestra di contesto corrente e l’utilizzo del piano per il periodo. L’utilizzo del contesto è per sessione; l’utilizzo del piano è condiviso su tutte le tue superfici Claude Code.

Lascia che Claude usi il tuo computer

L’utilizzo del computer consente a Claude di aprire le tue app, controllare lo schermo e lavorare direttamente sulla tua macchina come faresti tu. Chiedi a Claude di testare un’app nativa in un simulatore mobile, interagire con uno strumento desktop che non ha CLI, o automatizzare qualcosa che funziona solo tramite una GUI.

L’utilizzo del computer è un’anteprima di ricerca su macOS e Windows che richiede un piano Pro o Max. Non è disponibile su piani Team o Enterprise. L’app Claude Desktop deve essere in esecuzione.

L’utilizzo del computer è disabilitato per impostazione predefinita. Abilitalo in Impostazioni prima che Claude possa controllare lo schermo. Su macOS, devi anche concedere i permessi di Accessibilità e Registrazione dello schermo.

A differenza dello strumento Bash sandbox, l’utilizzo del computer viene eseguito sul tuo desktop effettivo con accesso a tutto ciò che approvi. Claude controlla ogni azione e contrassegna potenziali iniezioni di prompt dal contenuto sullo schermo, ma il limite di fiducia è diverso. Vedi la guida alla sicurezza dell’utilizzo del computer per le best practice.

Quando si applica l’utilizzo del computer

Claude ha diversi modi per interagire con un’app o un servizio, e l’utilizzo del computer è il più ampio e lento. Prova prima lo strumento più preciso:

Se hai un connettore per un servizio, Claude usa il connettore.
Se l’attività è un comando shell, Claude usa Bash.
Se l’attività è lavoro nel browser e hai Claude in Chrome configurato, Claude usa quello.
Se nessuno di questi si applica, Claude usa l’utilizzo del computer.

I livelli di accesso per app rafforzano questo: i browser sono limitati a sola visualizzazione, e i terminali e gli IDE a solo clic, indirizzando Claude verso lo strumento dedicato anche quando l’utilizzo del computer è attivo. Il controllo dello schermo è riservato a cose che nient’altro può raggiungere, come app native, pannelli di controllo hardware, simulatori mobili o strumenti proprietari senza un’API.

Abilita l’utilizzo del computer

L’utilizzo del computer è disabilitato per impostazione predefinita. Se chiedi a Claude di fare qualcosa che ne ha bisogno mentre è disabilitato, Claude ti dice che potrebbe fare l’attività se abiliti l’utilizzo del computer in Impostazioni.

Aggiorna l'app desktop

Assicurati di avere l’ultima versione di Claude Desktop. Scarica o aggiorna su claude.com/download, quindi riavvia l’app.

Attiva l'interruttore

Nell’app desktop, vai a Impostazioni > Generale (sotto App Desktop). Trova l’interruttore Utilizzo del computer e attivalo. Su Windows, l’interruttore ha effetto immediatamente e la configurazione è completa. Su macOS, continua al passaggio successivo.Se non vedi l’interruttore, conferma che sei su macOS o Windows con un piano Pro o Max, quindi aggiorna e riavvia l’app.

Concedi i permessi macOS

Su macOS, concedi due permessi di sistema prima che l’interruttore abbia effetto:

Accessibilità: consente a Claude di fare clic, digitare e scorrere
Registrazione dello schermo: consente a Claude di vedere cosa c’è sullo schermo

La pagina Impostazioni mostra lo stato attuale di ogni permesso. Se uno è negato, fai clic sul badge per aprire il riquadro Impostazioni di sistema pertinente.

Permessi delle app

La prima volta che Claude ha bisogno di usare un’app, appare un prompt nella tua sessione. Fai clic su Allow for this session o Deny. Le approvazioni durano per la sessione corrente, o 30 minuti nelle sessioni generate da Dispatch. Il prompt mostra anche quale livello di controllo Claude ottiene per quell’app. Questi livelli sono fissi per categoria di app e non possono essere modificati:

Livello	Cosa può fare Claude	Si applica a
View only	Vedere l’app negli screenshot	Browser, piattaforme di trading
Click only	Fare clic e scorrere, ma non digitare o usare scorciatoie da tastiera	Terminali, IDE
Full control	Fare clic, digitare, trascinare e usare scorciatoie da tastiera	Tutto il resto

Le app con ampia portata, come terminali, Finder o File Explorer, e Impostazioni di sistema o Impostazioni, mostrano un avviso aggiuntivo nel prompt in modo che tu sappia cosa approvare loro concede. Puoi configurare due impostazioni in Impostazioni > Generale (sotto App Desktop):

Denied apps: aggiungi app qui per rifiutarle senza chiedere. Claude potrebbe comunque influenzare un’app negata indirettamente tramite azioni in un’app consentita, ma non può interagire direttamente con l’app negata.
Unhide apps when Claude finishes: mentre Claude sta lavorando, le tue altre finestre sono nascoste in modo che interagisca solo con l’app approvata. Quando Claude finisce, le finestre nascoste vengono ripristinate a meno che non disattivi questa impostazione.

Gestisci le sessioni

Ogni sessione è una conversazione indipendente con il suo proprio contesto e modifiche. Puoi eseguire più sessioni in parallelo, diramazioni di chat laterali, inviare il lavoro al cloud, o lasciare che Dispatch avvii sessioni per te dal tuo telefono.

Lavora in parallelo con le sessioni

Fai clic su + New session nella barra laterale, o premi Cmd+N su macOS o Ctrl+N su Windows, per lavorare su più compiti in parallelo. Premi Ctrl+Tab e Ctrl+Shift+Tab per scorrere le sessioni nella barra laterale. Per i repository Git, ogni sessione ottiene la sua copia isolata del tuo progetto usando Git worktrees, in modo che le modifiche in una sessione non influiscano su altre sessioni fino a quando non le esegui il commit. Per visualizzare due sessioni contemporaneamente, tieni premuto Cmd su macOS o Ctrl su Windows e fai clic su una sessione nella barra laterale. La sessione si apre in un secondo riquadro accanto a quello che hai già aperto. Mentre la divisione è attiva, facendo clic su un’altra sessione della barra laterale si sostituisce il riquadro che ha il focus. Premi Cmd+\ su macOS o Ctrl+\ su Windows per chiudere il riquadro con focus e tornare a una singola sessione. I worktree sono archiviati in <project-root>/.claude/worktrees/ per impostazione predefinita. Puoi cambiare questo in una directory personalizzata in Impostazioni → Claude Code sotto “Worktree location”. Puoi anche impostare un prefisso di ramo che viene anteposto a ogni nome di ramo worktree, il che è utile per mantenere organizzati i rami creati da Claude. Per rimuovere un worktree quando hai finito, passa il mouse sulla sessione nella barra laterale e fai clic sull’icona di archivio. Per avere sessioni che si archiviano automaticamente quando il loro pull request si unisce o si chiude, attiva Auto-archive after PR merge or close in Impostazioni → Claude Code. Auto-archive si applica solo alle sessioni locali che hanno finito di funzionare. Per includere file gitignored come .env nei nuovi worktree, crea un file .worktreeinclude nella radice del tuo progetto.

L’isolamento della sessione richiede Git. La maggior parte dei Mac include Git per impostazione predefinita. Esegui git --version in Terminal per verificare. Su Windows, Git è richiesto affinché la scheda Code funzioni: scarica Git per Windows, installalo e riavvia l’app. Se riscontri errori Git, chiedi a Claude nella scheda Cowork di aiutarti a risolvere i problemi della tua configurazione.

Usa i controlli in cima alla barra laterale per filtrare le sessioni per stato, progetto o ambiente, e per raggruppare le sessioni per progetto. Per rinominare una sessione, fai clic sul titolo della sessione nella barra degli strumenti in cima alla sessione attiva. Per controllare l’utilizzo del contesto, vedi Controlla l’utilizzo. Quando il contesto si riempie, Claude riassume automaticamente la conversazione e continua a lavorare. Puoi anche digitare /compact per attivare la compattazione prima e liberare spazio di contesto. Vedi la finestra di contesto per i dettagli su come funziona la compattazione. L’app desktop invia una notifica del sistema operativo quando una sessione Code termina un’attività e non stai visualizzando quella sessione.

Chiedi una domanda laterale senza deviare la sessione

Una chat laterale ti consente di chiedere a Claude una domanda che utilizza il contesto della tua sessione ma non aggiunge nulla di nuovo alla conversazione principale. Usala quando vuoi capire un pezzo di codice, verificare un’assunzione o esplorare un’idea senza sterzare la sessione fuori rotta. Premi Cmd+; su macOS o Ctrl+; su Windows per aprire una chat laterale, o digita /btw nella casella del prompt. La chat laterale può leggere tutto nel thread principale fino a quel punto. Quando hai finito, chiudi la chat laterale e continua la sessione principale da dove l’hai lasciata. Le chat laterali sono disponibili nelle sessioni locali e SSH.

Guarda le attività in background

Il pannello attività mostra il lavoro in background in esecuzione all’interno della sessione corrente: subagent, comandi shell in background e flussi di lavoro. Aprilo dal menu Views o trascinalo nel tuo layout. Fai clic su qualsiasi voce per vedere il suo output nel pannello subagent o fermarlo. Per vedere cosa stanno facendo altre sessioni, usa la barra laterale.

Esegui attività a lunga esecuzione in remoto

Per grandi refactor, suite di test, migrazioni o altre attività a lunga esecuzione, seleziona Remote invece di Local quando avvii una sessione. Le sessioni remote vengono eseguite sull’infrastruttura cloud di Anthropic e continuano anche se chiudi l’app o spegni il computer. Torna indietro in qualsiasi momento per vedere i progressi o indirizzare Claude in una direzione diversa. Puoi anche monitorare le sessioni remote da claude.ai/code o dall’app Claude iOS. Le sessioni remote supportano anche più repository. Dopo aver selezionato un ambiente cloud, fai clic sul pulsante + accanto alla pillola del repo per aggiungere repository aggiuntivi alla sessione. Ogni repo ottiene il suo selettore di ramo. Questo è utile per compiti che si estendono su più codebase, come l’aggiornamento di una libreria condivisa e dei suoi consumatori. Vedi Claude Code sul web per ulteriori informazioni su come funzionano le sessioni remote.

Continua su un’altra superficie

Il menu Continue in, accessibile dall’icona VS Code in basso a destra della barra degli strumenti della sessione, ti consente di spostare la tua sessione su un’altra superficie:

Claude Code sul web: invia la tua sessione locale per continuare l’esecuzione in remoto. Desktop esegue il push del tuo ramo, genera un riepilogo della conversazione e crea una nuova sessione remota con il contesto completo. Puoi quindi scegliere di archiviare la sessione locale o mantenerla. Questo richiede un albero di lavoro pulito e non è disponibile per le sessioni SSH.
Il tuo IDE: apre il tuo progetto in un IDE supportato nella directory di lavoro corrente.

Sessioni da Dispatch

Dispatch è una conversazione persistente con Claude che vive nella scheda Cowork. Invii a Dispatch un’attività, e decide come gestirla. Un’attività può finire come una sessione Code in due modi: chiedi direttamente una, come “apri una sessione Claude Code e correggi il bug di accesso”, o Dispatch decide che l’attività è lavoro di sviluppo e ne genera una automaticamente. Le attività che tipicamente vengono indirizzate a Code includono correzione di bug, aggiornamento delle dipendenze, esecuzione di test o apertura di pull request. La ricerca, la modifica di documenti e il lavoro con fogli di calcolo rimangono in Cowork. In entrambi i casi, la sessione Code appare nella barra laterale della scheda Code con un badge Dispatch. Ricevi una notifica push sul tuo telefono quando finisce o ha bisogno della tua approvazione. Se hai l’utilizzo del computer abilitato, le sessioni Code generate da Dispatch possono usarlo anche. Le approvazioni delle app in quelle sessioni scadono dopo 30 minuti e ripromptano, piuttosto che durare l’intera sessione come le sessioni Code regolari. Per la configurazione, l’accoppiamento e le impostazioni di Dispatch, vedi l’articolo di aiuto di Dispatch. Dispatch richiede un piano Pro o Max e non è disponibile su piani Team o Enterprise. Dispatch è uno dei diversi modi per lavorare con Claude quando sei lontano dal tuo terminale. Vedi Piattaforme e integrazioni per confrontarlo con Remote Control, Channels, Slack e attività pianificate.

Estendi Claude Code

Connetti servizi esterni, aggiungi flussi di lavoro riutilizzabili, personalizza il comportamento di Claude e configura server di anteprima. Per gestire connettori, skills e plugin in un unico posto, fai clic su Customize nella barra laterale.

Connetti strumenti esterni

Per le sessioni locali e SSH, fai clic sul pulsante + accanto alla casella del prompt e seleziona Connectors per aggiungere integrazioni come Google Calendar, Slack, GitHub, Linear, Notion e altri. Puoi aggiungere connettori prima o durante una sessione. Il pulsante + non è disponibile nelle sessioni remote, ma le routine configurano i connettori al momento della creazione della routine. Per gestire o disconnettere i connettori, vai a Impostazioni → Connectors nell’app desktop, o seleziona Manage connectors dal menu Connectors nella casella del prompt. Una volta connesso, Claude può leggere il tuo calendario, inviare messaggi, creare problemi e interagire direttamente con i tuoi strumenti. Puoi chiedere a Claude quali connettori sono configurati nella tua sessione. I connettori sono MCP servers con un flusso di configurazione grafico. Usali per l’integrazione rapida con i servizi supportati. Per le integrazioni non elencate in Connectors, aggiungi MCP servers manualmente tramite file di impostazioni. Puoi anche creare connettori personalizzati.

Usa skills

Skills estendono quello che Claude può fare. Claude le carica automaticamente quando rilevante, o puoi invocarne una direttamente: digita / nella casella del prompt o fai clic sul pulsante + e seleziona Slash commands per sfogliare cosa è disponibile. Questo include comandi incorporati, le tue skill personalizzate, skill del progetto dal tuo codebase e skill da qualsiasi plugin installato. Selezionane uno e appare evidenziato nel campo di input. Digita il tuo compito dopo di esso e invia come al solito.

Installa plugin

Plugins sono pacchetti riutilizzabili che aggiungono skills, agent, hooks, MCP servers e configurazioni LSP a Claude Code. Puoi installare plugin dall’app desktop senza usare il terminale. Per le sessioni locali e SSH, fai clic sul pulsante + accanto alla casella del prompt e seleziona Plugins per vedere i tuoi plugin installati e i loro skills. Per aggiungere un plugin, seleziona Add plugin dal sottomenu per aprire il browser dei plugin, che mostra i plugin disponibili dai tuoi marketplace configurati incluso il marketplace ufficiale di Anthropic. Seleziona Manage plugins per abilitare, disabilitare o disinstallare plugin. I plugin possono essere limitati al tuo account utente, a un progetto specifico o solo locali. Se la tua organizzazione gestisce i plugin centralmente, quei plugin sono disponibili nelle sessioni desktop nello stesso modo in cui lo sono nella CLI. I plugin non sono disponibili per le sessioni remote. Per il riferimento completo dei plugin inclusa la creazione dei tuoi plugin, vedi plugin.

Configura server di anteprima

Claude rileva automaticamente la tua configurazione del server di sviluppo e archivia la configurazione in .claude/launch.json alla radice della cartella che hai selezionato quando hai avviato la sessione. Preview utilizza questa cartella come directory di lavoro, quindi se hai selezionato una cartella padre, le sottocartelle con i loro stessi server di sviluppo non verranno rilevate automaticamente. Per lavorare con il server di una sottocartella, avvia una sessione in quella cartella direttamente o aggiungi una configurazione manualmente. Per personalizzare come il tuo server si avvia, ad esempio per usare yarn dev invece di npm run dev o per cambiare la porta, modifica il file manualmente o fai clic su Edit configuration nel menu a discesa Preview per aprirlo nel tuo editor di codice. Il file supporta JSON con commenti.

{
  "version": "0.0.1",
  "configurations": [
    {
      "name": "my-app",
      "runtimeExecutable": "npm",
      "runtimeArgs": ["run", "dev"],
      "port": 3000
    }
  ]
}

Puoi definire più configurazioni per eseguire server diversi dallo stesso progetto, come un frontend e un’API. Vedi gli esempi di seguito.

Auto-verify changes

Quando autoVerify è abilitato, Claude verifica automaticamente le modifiche al codice dopo aver modificato i file. Scatta screenshot, controlla gli errori e conferma che le modifiche funzionano prima di completare la sua risposta. Auto-verify è abilitato per impostazione predefinita. Disabilitalo per progetto aggiungendo "autoVerify": false a .claude/launch.json, o attiva/disattivalo dal menu a discesa Preview.

{
  "version": "0.0.1",
  "autoVerify": false,
  "configurations": [...]
}

Quando disabilitato, gli strumenti di anteprima sono ancora disponibili e puoi chiedere a Claude di verificare in qualsiasi momento. Auto-verify lo rende automatico dopo ogni modifica.

Configuration fields

Ogni voce nell’array configurations accetta i seguenti campi:

Campo	Tipo	Descrizione
`name`	string	Un identificatore univoco per questo server
`runtimeExecutable`	string	Il comando da eseguire, come `npm`, `yarn` o `node`
`runtimeArgs`	string[]	Argomenti passati a `runtimeExecutable`, come `["run", "dev"]`
`port`	number	La porta su cui il tuo server ascolta. Predefinito a 3000
`cwd`	string	Directory di lavoro relativa alla radice del tuo progetto. Predefinito alla radice del progetto. Usa `${workspaceFolder}` per fare riferimento alla radice del progetto esplicitamente
`env`	object	Variabili di ambiente aggiuntive come coppie chiave-valore, come `{ "NODE_ENV": "development" }`. Non mettere segreti qui poiché questo file viene eseguito il commit nel tuo repo. Per passare segreti al tuo server di sviluppo, impostali nell’editor di ambiente locale invece.
`autoPort`	boolean	Come gestire i conflitti di porta. Vedi di seguito
`program`	string	Uno script da eseguire con `node`. Vedi quando usare `program` vs `runtimeExecutable`
`args`	string[]	Argomenti passati a `program`. Usato solo quando `program` è impostato

When to use `program` vs `runtimeExecutable`

Usa runtimeExecutable con runtimeArgs per avviare un server di sviluppo tramite un gestore di pacchetti. Ad esempio, "runtimeExecutable": "npm" con "runtimeArgs": ["run", "dev"] esegue npm run dev. Usa program quando hai uno script autonomo che vuoi eseguire con node direttamente. Ad esempio, "program": "server.js" esegue node server.js. Passa flag aggiuntivi con args.

Port conflicts

Il campo autoPort controlla cosa succede quando la tua porta preferita è già in uso:

true: Claude trova e utilizza una porta libera automaticamente. Adatto per la maggior parte dei server di sviluppo.
false: Claude fallisce con un errore. Usa questo quando il tuo server deve usare una porta specifica, come per i callback OAuth o gli allowlist CORS.
Non impostato (predefinito): Claude chiede se il server ha bisogno di quella porta esatta, quindi salva la tua risposta.

Quando Claude sceglie una porta diversa, passa la porta assegnata al tuo server tramite la variabile di ambiente PORT.

Examples

Queste configurazioni mostrano configurazioni comuni per diversi tipi di progetto:

Next.js
Multiple servers
Node.js script

Questa configurazione esegue un’app Next.js usando Yarn sulla porta 3000:

{
  "version": "0.0.1",
  "configurations": [
    {
      "name": "web",
      "runtimeExecutable": "yarn",
      "runtimeArgs": ["dev"],
      "port": 3000
    }
  ]
}

Per un monorepo con un frontend e un server API, definisci più configurazioni. Il frontend usa autoPort: true in modo che scelga una porta libera se 3000 è occupata, mentre il server API richiede la porta 8080 esattamente:

{
  "version": "0.0.1",
  "configurations": [
    {
      "name": "frontend",
      "runtimeExecutable": "npm",
      "runtimeArgs": ["run", "dev"],
      "cwd": "apps/web",
      "port": 3000,
      "autoPort": true
    },
    {
      "name": "api",
      "runtimeExecutable": "npm",
      "runtimeArgs": ["run", "start"],
      "cwd": "server",
      "port": 8080,
      "env": { "NODE_ENV": "development" },
      "autoPort": false
    }
  ]
}

Per eseguire uno script Node.js direttamente invece di usare un comando del gestore di pacchetti, usa il campo program:

{
  "version": "0.0.1",
  "configurations": [
    {
      "name": "server",
      "program": "server.js",
      "args": ["--verbose"],
      "port": 4000
    }
  ]
}

Configurazione dell’ambiente

L’ambiente che scegli quando avvii una sessione determina dove Claude viene eseguito e come ti connetti:

Local: viene eseguito sulla tua macchina con accesso diretto ai tuoi file
Remote: viene eseguito sull’infrastruttura cloud di Anthropic. Le sessioni continuano anche se chiudi l’app.
SSH: viene eseguito su una macchina remota a cui ti connetti tramite SSH, come i tuoi stessi server, VM cloud o dev container

Local sessions

L’app desktop non sempre eredita il tuo ambiente shell completo. Su macOS, quando avvii l’app dal Dock o Finder, legge il tuo profilo shell, come ~/.zshrc o ~/.bashrc, per estrarre PATH e un insieme fisso di variabili Claude Code, ma altre variabili che esporti lì non vengono raccolte. Su Windows, l’app eredita variabili di ambiente utente e di sistema ma non legge i profili PowerShell. Per impostare variabili di ambiente per le sessioni locali e i server di sviluppo su qualsiasi piattaforma, apri il menu a discesa dell’ambiente nella casella del prompt, passa il mouse su Local e fai clic sull’icona dell’ingranaggio per aprire l’editor di ambiente locale. Le variabili che salvi qui vengono archiviate crittografate sulla tua macchina e si applicano a ogni sessione locale e server di anteprima che avvii. Puoi anche aggiungere variabili alla chiave env nel tuo file ~/.claude/settings.json, anche se queste raggiungono solo le sessioni Claude e non i server di sviluppo. Vedi variabili di ambiente per l’elenco completo delle variabili supportate. Extended thinking è abilitato per impostazione predefinita, il che migliora le prestazioni su compiti di ragionamento complesso ma utilizza token aggiuntivi. Per disabilitare completamente il thinking, imposta MAX_THINKING_TOKENS a 0 nell’editor di ambiente locale. Su modelli con ragionamento adattivo, qualsiasi altro valore MAX_THINKING_TOKENS viene ignorato perché il ragionamento adattivo controlla la profondità del thinking. Su Opus 4.6 e Sonnet 4.6, imposta CLAUDE_CODE_DISABLE_ADAPTIVE_THINKING a 1 per usare un budget di thinking fisso; Opus 4.7 usa sempre il ragionamento adattivo e non ha una modalità di budget fisso.

Remote sessions

Le sessioni remote continuano in background anche se chiudi l’app. L’utilizzo conta verso i limiti del tuo piano di abbonamento senza costi di calcolo separati. Puoi creare ambienti cloud personalizzati con diversi livelli di accesso alla rete e variabili di ambiente. Seleziona il menu a discesa dell’ambiente quando avvii una sessione remota e scegli Add environment. Vedi l’ambiente cloud per i dettagli sulla configurazione dell’accesso alla rete e delle variabili di ambiente.

SSH sessions

Le sessioni SSH ti consentono di eseguire Claude Code su una macchina remota mentre usi l’app desktop come tua interfaccia. Questo è utile per lavorare con codebase che vivono su VM cloud, dev container o server con hardware o dipendenze specifiche. Per aggiungere una connessione SSH, fai clic sul menu a discesa dell’ambiente prima di avviare una sessione e seleziona + Add SSH connection. La finestra di dialogo chiede:

Name: un’etichetta amichevole per questa connessione
SSH Host: user@hostname o un host definito in ~/.ssh/config
SSH Port: predefinito a 22 se lasciato vuoto, o utilizza la porta dal tuo SSH config
Identity File: percorso della tua chiave privata, come ~/.ssh/id_rsa. Lascia vuoto per usare la chiave predefinita o il tuo SSH config.

Una volta aggiunta, la connessione appare nel menu a discesa dell’ambiente. Selezionala per avviare una sessione su quella macchina. Claude viene eseguito sulla macchina remota con accesso ai suoi file e strumenti. La macchina remota deve eseguire Linux o macOS. L’app desktop installa Claude Code sulla macchina remota automaticamente la prima volta che ti connetti. Una volta connesso, le sessioni SSH supportano modalità di autorizzazione, connettori, plugin e MCP server.

Pre-configure SSH connections for your team

Gli amministratori possono distribuire connessioni SSH ai membri del team aggiungendo sshConfigs a un file di impostazioni gestite. Le connessioni definite in questo modo appaiono nel menu a discesa dell’ambiente di ogni utente automaticamente e vengono mostrate come gestite, quindi gli utenti possono selezionarle ma non possono modificarle o eliminarle nell’app. L’esempio seguente pre-configura una singola connessione che si apre in ~/projects sull’host remoto:

{
  "sshConfigs": [
    {
      "id": "shared-dev-vm",
      "name": "Shared Dev VM",
      "sshHost": "user@dev.example.com",
      "sshPort": 22,
      "sshIdentityFile": "~/.ssh/id_ed25519",
      "startDirectory": "~/projects"
    }
  ]
}

Ogni voce richiede id, name e sshHost. I campi sshPort, sshIdentityFile e startDirectory sono facoltativi. Gli utenti possono anche aggiungere sshConfigs al loro ~/.claude/settings.json, che è dove vengono archiviate le connessioni aggiunte tramite la finestra di dialogo.

Restrict which SSH hosts users can connect to

Gli amministratori possono limitare le sessioni SSH di Desktop a un insieme approvato di host aggiungendo sshHostAllowlist a un file di impostazioni gestite. Quando impostato, gli utenti possono connettersi solo a host il cui nome host risolto corrisponde a uno dei modelli. Impostalo su un array vuoto per disabilitare completamente le sessioni SSH. L’esempio seguente consente connessioni a qualsiasi host sotto devboxes.example.com e a un singolo host bastion denominato:

{
  "sshHostAllowlist": ["*.devboxes.example.com", "bastion.example.com"]
}

I modelli sono case-insensitive. * corrisponde a qualsiasi host, e *.example.com corrisponde a example.com e a qualsiasi sottodominio. Tutto il resto è una corrispondenza esatta. Il controllo viene eseguito sul nome host dopo la risoluzione di ~/.ssh/config tramite ssh -G, quindi gli alias Host e le voci ProxyCommand/ProxyJump sono consentiti purché il HostName risolto corrisponda. sshHostAllowlist viene letto solo dalle impostazioni gestite; i valori nelle impostazioni utente o progetto vengono ignorati. Solo l’app Claude Desktop onora questa impostazione; la CLI Claude Code e le estensioni IDE non la leggono, e non limita i comandi ssh eseguiti tramite lo strumento Bash. Governa a quali host l’app Desktop si connette, non l’uscita di rete, quindi abbinalo ai controlli di rete della tua organizzazione o zero-trust se hai bisogno di un confine rigido.

Configurazione aziendale

Le organizzazioni su piani Team o Enterprise possono gestire il comportamento dell’app desktop tramite controlli della console di amministrazione, file di impostazioni gestiti e criteri di gestione dei dispositivi.

Controlli della console di amministrazione

Queste impostazioni sono configurate tramite la console delle impostazioni di amministrazione:

Code in the desktop: controlla se gli utenti della tua organizzazione possono accedere a Claude Code nell’app desktop
Code in the web: abilita o disabilita le sessioni web per la tua organizzazione
Remote Control: abilita o disabilita Remote Control per la tua organizzazione
Disable Bypass permissions mode: impedisci agli utenti della tua organizzazione di abilitare la modalità bypass permissions

Impostazioni gestite

Le impostazioni gestite sovrascrivono le impostazioni del progetto e dell’utente e si applicano quando Desktop genera sessioni CLI. Puoi impostare queste chiavi nel file impostazioni gestite della tua organizzazione o inviarle in remoto tramite la console di amministrazione.

Chiave	Descrizione
`permissions.disableBypassPermissionsMode`	imposta su `"disable"` per impedire agli utenti di abilitare la modalità bypass permissions.
`disableAutoMode`	imposta su `"disable"` per impedire agli utenti di abilitare la modalità Auto. Rimuove Auto dal selettore di modalità. Accettato anche sotto `permissions`.
`autoMode`	personalizza cosa il classificatore della modalità auto si fida e blocca in tutta la tua organizzazione. Vedi Configura la modalità auto.
`sshConfigs`	pre-configura le connessioni SSH che appaiono nel menu a discesa dell’ambiente. Gli utenti non possono modificare o eliminare le connessioni gestite.
`sshHostAllowlist`	limita le sessioni SSH agli host il cui nome host risolto corrisponde a uno di questi modelli. Un array vuoto disabilita le sessioni SSH. Letto solo dalle impostazioni gestite.
`managedMcpServers`	invia le configurazioni del server MCP a tutti gli utenti in una distribuzione di terze parti. Ogni voce specifica un trasporto di `"http"`, `"sse"` o `"stdio"`, i dettagli della connessione e facoltativamente una mappa `toolPolicy` che limita quali strumenti in quel server gli utenti possono invocare. Disponibile solo nelle distribuzioni Desktop di terze parti (3P).

Un file di impostazioni gestite distribuito su disco su ogni macchina si applica alle sessioni Desktop. Le impostazioni gestite inviate in remoto tramite la console di amministrazione attualmente raggiungono solo le sessioni CLI e IDE, quindi per le distribuzioni Desktop distribuisci il file tramite MDM o utilizza i controlli della console di amministrazione sopra. permissions.disableBypassPermissionsMode e disableAutoMode funzionano anche nelle impostazioni dell’utente e del progetto, ma metterli nelle impostazioni gestite impedisce agli utenti di sovrascriverli. autoMode viene letto dalle impostazioni dell’utente, .claude/settings.local.json e impostazioni gestite, ma non da .claude/settings.json controllato: un repo clonato non può iniettare le sue stesse regole del classificatore. Per l’elenco completo delle impostazioni solo gestite incluse allowManagedPermissionRulesOnly e allowManagedHooksOnly, vedi impostazioni solo gestite.

Criteri di gestione dei dispositivi

I team IT possono gestire l’app desktop tramite MDM su macOS o criteri di gruppo su Windows. I criteri disponibili includono l’abilitazione o la disabilitazione della funzione Claude Code, il controllo degli aggiornamenti automatici e l’impostazione di un URL di distribuzione personalizzato.

macOS: configura tramite il dominio di preferenza com.anthropic.Claude usando strumenti come Jamf o Kandji
Windows: configura tramite il registro in SOFTWARE\Policies\Claude

Autenticazione e SSO

Le organizzazioni aziendali possono richiedere SSO per tutti gli utenti. Vedi autenticazione per i dettagli a livello di piano e Configurazione di SSO per la configurazione SAML e OIDC.

Gestione dei dati

Claude Code elabora il tuo codice localmente nelle sessioni locali o sull’infrastruttura cloud di Anthropic nelle sessioni remote. Le conversazioni e il contesto del codice vengono inviati all’API di Anthropic per l’elaborazione. Vedi gestione dei dati per i dettagli sulla conservazione dei dati, la privacy e la conformità.

Distribuzione

Desktop può essere distribuito tramite strumenti di distribuzione aziendale:

macOS: distribuisci tramite MDM come Jamf o Kandji usando il programma di installazione .dmg
Windows: distribuisci tramite pacchetto MSIX o programma di installazione .exe. Vedi Distribuisci Claude Desktop per Windows per le opzioni di distribuzione aziendale inclusa l’installazione silenziosa

Per la configurazione della rete come impostazioni proxy, allowlist del firewall e gateway LLM, vedi configurazione della rete. Per il riferimento completo della configurazione aziendale, vedi la guida alla configurazione aziendale.

Provieni dalla CLI?

Se usi già la CLI di Claude Code, Desktop esegue lo stesso motore sottostante con un’interfaccia grafica. Puoi eseguire entrambi contemporaneamente sulla stessa macchina, anche sullo stesso progetto. Ognuno mantiene una storia di sessione separata, ma condividono configurazione e memoria del progetto tramite file CLAUDE.md. Per spostare una sessione CLI in Desktop, esegui /desktop nel terminale. Claude salva la tua sessione e l’apre nell’app desktop, quindi esce dalla CLI. Questo comando è disponibile solo su macOS e Windows.

Quando usare Desktop vs CLI: usa Desktop quando vuoi gestire sessioni parallele in una finestra, organizzare pannelli uno accanto all’altro, o rivedere le modifiche visivamente. Usa la CLI quando hai bisogno di scripting, automazione o preferisci un flusso di lavoro di terminale.

Equivalenti dei flag CLI

Questa tabella mostra l’equivalente dell’app desktop per i flag CLI comuni. I flag non elencati non hanno equivalente desktop perché sono progettati per scripting o automazione.

CLI	Equivalente desktop
`--model sonnet`	Menu a discesa del modello accanto al pulsante di invio
`--resume`, `--continue`	Fai clic su una sessione nella barra laterale
`--permission-mode`	Selettore di modalità accanto al pulsante di invio
`--dangerously-skip-permissions`	Modalità Bypass permissions. Abilita in Impostazioni → Claude Code → “Allow bypass permissions mode”. Gli amministratori aziendali possono disabilitare questa impostazione.
`--add-dir`	Aggiungi più repo con il pulsante + nelle sessioni remote
`--allowedTools`, `--disallowedTools`	Nessun equivalente per sessione. Le regole di autorizzazione nei file di impostazioni si applicano ancora.
`--verbose`	Modalità di visualizzazione Verbose nel menu a discesa della vista Transcript
`--print`, `--output-format`	Non disponibile. Desktop è solo interattivo.
`ANTHROPIC_MODEL` env var	Menu a discesa del modello accanto al pulsante di invio
`MAX_THINKING_TOKENS` env var	Imposta nell’editor di ambiente locale. Vedi configurazione dell’ambiente.

Configurazione condivisa

Desktop e CLI leggono gli stessi file di configurazione, quindi la tua configurazione viene trasferita:

I file CLAUDE.md e CLAUDE.local.md nel tuo progetto vengono utilizzati da entrambi
I MCP servers configurati in ~/.claude.json o .mcp.json funzionano in entrambi
Hooks e skills definiti nelle impostazioni si applicano a entrambi
Impostazioni in ~/.claude.json e ~/.claude/settings.json sono condivise. Le regole di autorizzazione, gli strumenti consentiti e altre impostazioni in settings.json si applicano alle sessioni Desktop.
Modelli: Sonnet, Opus e Haiku sono disponibili in entrambi. In Desktop, seleziona il modello dal menu a discesa accanto al pulsante di invio. Puoi cambiare il modello durante una sessione dal stesso menu a discesa.

MCP servers: app desktop chat vs Claude Code: i MCP servers configurati per l’app desktop chat Claude in claude_desktop_config.json sono separati da Claude Code e non appariranno nella scheda Code. Per usare MCP servers in Claude Code, configurali in ~/.claude.json o nel file .mcp.json del tuo progetto. Vedi configurazione MCP per i dettagli.

Confronto delle funzionalità

Questa tabella confronta le capacità principali tra CLI e Desktop. Per un elenco completo dei flag CLI, vedi il riferimento CLI.

Funzionalità	CLI	Desktop
Modalità di autorizzazione	Tutte le modalità inclusa `dontAsk`	Chiedi autorizzazioni, Accetta automaticamente modifiche, Plan mode, Auto e Bypass permissions tramite Impostazioni
`--dangerously-skip-permissions`	Flag CLI	Modalità Bypass permissions. Abilita in Impostazioni → Claude Code → “Allow bypass permissions mode”
Provider di terze parti	Bedrock, Vertex, Foundry	API di Anthropic per impostazione predefinita. Le distribuzioni aziendali possono configurare Vertex AI e provider gateway. Vedi la guida alla configurazione aziendale.
MCP servers	Configura nei file di impostazioni	UI Connectors per sessioni locali e SSH, o file di impostazioni
Plugins	Comando `/plugin`	UI gestore plugin
@mention file	Basato su testo	Con autocomplete; sessioni locali e SSH solo
Allegati di file	Non disponibile	Immagini, PDF
Isolamento della sessione	Flag `--worktree`	Worktree automatici
Sessioni multiple	Terminali separati	Schede della barra laterale
Attività ricorrenti	Cron job, pipeline CI	Attività pianificate
Utilizzo del computer	Abilita tramite `/mcp` su macOS	Controllo di app e schermo su macOS e Windows
Integrazione Dispatch	Non disponibile	Sessioni Dispatch nella barra laterale
Scripting e automazione	`--print`, Agent SDK	Non disponibile

Cosa non è disponibile in Desktop

Le seguenti funzionalità sono disponibili solo nella CLI o nell’estensione VS Code:

Provider di terze parti: Desktop si connette all’API di Anthropic per impostazione predefinita. Le distribuzioni aziendali possono configurare Vertex AI e provider gateway tramite impostazioni gestite. Per Bedrock o Foundry, usa la CLI.
Linux: l’app desktop è disponibile solo su macOS e Windows. Su Linux, usa la CLI.
Suggerimenti di codice inline: Desktop non fornisce suggerimenti in stile autocomplete. Funziona tramite prompt conversazionali e modifiche di codice esplicite.
Team di agent: l’orchestrazione multi-agent è disponibile tramite la CLI e Agent SDK, non in Desktop.

Troubleshooting

Le sezioni di seguito coprono i problemi specifici dell’app desktop. Per gli errori API di runtime che appaiono nella chat come API Error: 500, 529 Overloaded, 429 o Prompt is too long, vedi il riferimento degli errori. Questi errori e le loro correzioni sono gli stessi su CLI, desktop e web.

Check your version

Per vedere quale versione dell’app desktop stai eseguendo:

macOS: fai clic su Claude nella barra dei menu, quindi About Claude
Windows: fai clic su Help, quindi About

Fai clic sul numero di versione per copiarlo negli appunti.

403 or authentication errors in the Code tab

Se vedi Error 403: Forbidden o altri errori di autenticazione quando usi la scheda Code:

Esci e accedi di nuovo dal menu dell’app. Questo è il fix più comune.
Verifica di avere un abbonamento a pagamento attivo: Pro, Max, Team o Enterprise.
Se la CLI funziona ma Desktop no, esci completamente dall’app desktop, non solo chiudere la finestra, quindi riapri e accedi di nuovo.
Controlla la tua connessione Internet e le impostazioni del proxy.

Blank or stuck screen on launch

Se l’app si apre ma mostra una schermata vuota o non reattiva:

Riavvia l’app.
Controlla gli aggiornamenti in sospeso. L’app si aggiorna automaticamente al lancio.
Su Windows, controlla Event Viewer per i log di crash sotto Windows Logs → Application.

”Failed to load session”

Se vedi Failed to load session, la cartella selezionata potrebbe non esistere più, un repository Git potrebbe richiedere Git LFS che non è installato, o i permessi dei file potrebbero impedire l’accesso. Prova a selezionare una cartella diversa o riavvia l’app.

Session not finding installed tools

Se Claude non riesce a trovare strumenti come npm, node o altri comandi CLI, verifica che gli strumenti funzionino nel tuo terminale regolare, controlla che il tuo profilo shell configuri correttamente PATH e riavvia l’app desktop per ricaricare le variabili di ambiente.

Git and Git LFS errors

Su Windows, Git è richiesto affinché la scheda Code avvii sessioni locali. Se vedi “Git is required,” installa Git per Windows e riavvia l’app. Se vedi “Git LFS is required by this repository but is not installed,” installa Git LFS da git-lfs.com, esegui git lfs install e riavvia l’app.

MCP servers not working on Windows

Se gli interruttori del server MCP non rispondono o i server non riescono a connettersi su Windows, controlla che il server sia configurato correttamente nelle tue impostazioni, riavvia l’app, verifica che il processo del server sia in esecuzione in Task Manager e rivedi i log del server per gli errori di connessione.

App won’t quit

macOS: premi Cmd+Q. Se l’app non risponde, usa Force Quit con Cmd+Option+Esc, seleziona Claude e fai clic su Force Quit.
Windows: usa Task Manager con Ctrl+Shift+Esc per terminare il processo Claude.

Windows-specific issues

PATH not updated after install: apri una nuova finestra di terminale. Gli aggiornamenti di PATH si applicano solo alle nuove sessioni di terminale.
Concurrent installation error: se vedi un errore su un’altra installazione in corso ma non ce n’è una, prova a eseguire il programma di installazione come Amministratore.

”Branch doesn’t exist yet” when opening in CLI

Le sessioni remote possono creare rami che non esistono sulla tua macchina locale. Fai clic sul nome del ramo nella barra degli strumenti della sessione per copiarlo, quindi recuperalo localmente:

git fetch origin <branch-name>
git checkout <branch-name>

Still stuck?

Cerca o segnala un bug su GitHub Issues
Visita il centro di supporto Claude

Quando segnali un bug, includi la versione dell’app desktop, il tuo sistema operativo, il messaggio di errore esatto e i log pertinenti. Su macOS, controlla Console.app. Su Windows, controlla Event Viewer → Windows Logs → Application.

Guida introduttiva

Concetti fondamentali

Usa Claude Code

Piattaforme e integrazioni

Documentation Index

Download for macOS

Download for Windows

​Avvia una sessione

​Lavora con il codice

​Usa la casella del prompt

​Aggiungi file e contesto ai prompt

​Scegli una modalità di autorizzazione

​Anteprima della tua app

​Rivedi le modifiche con la visualizzazione diff

​Rivedi il tuo codice

​Monitora lo stato della pull request

​Organizza l’area di lavoro

​Esegui comandi nel terminale

​Apri e modifica file

​Apri file in altre app

​Cambia modalità di visualizzazione

​Scorciatoie da tastiera

​Controlla l’utilizzo

​Lascia che Claude usi il tuo computer

​Quando si applica l’utilizzo del computer

​Abilita l’utilizzo del computer

​Permessi delle app

​Gestisci le sessioni

​Lavora in parallelo con le sessioni

​Chiedi una domanda laterale senza deviare la sessione

​Guarda le attività in background

​Esegui attività a lunga esecuzione in remoto

​Continua su un’altra superficie

​Sessioni da Dispatch

​Estendi Claude Code

​Connetti strumenti esterni

​Usa skills

​Installa plugin

​Configura server di anteprima

​Auto-verify changes

​Configuration fields

When to use program vs runtimeExecutable

​Port conflicts

​Examples

​Configurazione dell’ambiente

​Local sessions

​Remote sessions

​SSH sessions

​Pre-configure SSH connections for your team

​Restrict which SSH hosts users can connect to

​Configurazione aziendale

​Controlli della console di amministrazione

​Impostazioni gestite

​Criteri di gestione dei dispositivi

​Autenticazione e SSO

​Gestione dei dati

​Distribuzione

​Provieni dalla CLI?

​Equivalenti dei flag CLI

​Configurazione condivisa

​Confronto delle funzionalità

​Cosa non è disponibile in Desktop

​Troubleshooting

​Check your version

​403 or authentication errors in the Code tab

​Blank or stuck screen on launch

​”Failed to load session”

​Session not finding installed tools

​Git and Git LFS errors

​MCP servers not working on Windows

​App won’t quit

​Windows-specific issues

​”Branch doesn’t exist yet” when opening in CLI

​Still stuck?

Avvia una sessione

Lavora con il codice

Usa la casella del prompt

Aggiungi file e contesto ai prompt

Scegli una modalità di autorizzazione

Anteprima della tua app

Rivedi le modifiche con la visualizzazione diff

Rivedi il tuo codice

Monitora lo stato della pull request

Organizza l’area di lavoro

Esegui comandi nel terminale

Apri e modifica file

Apri file in altre app

Cambia modalità di visualizzazione

Scorciatoie da tastiera

Controlla l’utilizzo

Lascia che Claude usi il tuo computer

Quando si applica l’utilizzo del computer

Abilita l’utilizzo del computer

Permessi delle app

Gestisci le sessioni

Lavora in parallelo con le sessioni

Chiedi una domanda laterale senza deviare la sessione

Guarda le attività in background

Esegui attività a lunga esecuzione in remoto

Continua su un’altra superficie

Sessioni da Dispatch

Estendi Claude Code

Connetti strumenti esterni

Usa skills

Installa plugin

Configura server di anteprima

Auto-verify changes

Configuration fields

When to use `program` vs `runtimeExecutable`

Port conflicts

Examples

Configurazione dell’ambiente

Local sessions

Remote sessions

SSH sessions

Pre-configure SSH connections for your team

Restrict which SSH hosts users can connect to

Configurazione aziendale

Controlli della console di amministrazione

Impostazioni gestite

Criteri di gestione dei dispositivi

Autenticazione e SSO

Gestione dei dati

Distribuzione

Provieni dalla CLI?

Equivalenti dei flag CLI

Configurazione condivisa

Confronto delle funzionalità

Cosa non è disponibile in Desktop

Troubleshooting

Check your version

403 or authentication errors in the Code tab

Blank or stuck screen on launch

”Failed to load session”

Session not finding installed tools

Git and Git LFS errors

MCP servers not working on Windows

App won’t quit

Windows-specific issues

”Branch doesn’t exist yet” when opening in CLI

Still stuck?