Anthropic questo mese ha pubblicato un'anteprima desktop di Claude Code — un'app desktop nativa che porta i workflow di codifica basati su agenti di Anthropic fuori dal terminale e in un ambiente grafico, con supporto integrato per eseguire in parallelo più sessioni di codifica isolate. La preview desktop è pensata per affiancare le versioni web e mobile di Claude Code e si concentra su due problemi pratici per gli sviluppatori: eseguire più agenti di IA sullo stesso repository senza intralciarsi a vicenda e rendere più semplice avviare sessioni locali o cloud da un'unica GUI.
Che cos'è Claude Code su Desktop?
Claude Code su Desktop è l'applicazione desktop nativa (preview) che consente agli sviluppatori di eseguire sessioni Claude Code in locale o sull'infrastruttura cloud sicura di Anthropic tramite una GUI invece che solo tramite la CLI. Combina le capacità principali di codifica basata su agenti di Claude Code con le comodità del desktop: gestione delle sessioni, integrazione con l'ambiente locale e avvio con un clic delle sessioni web. L'app è esplicitamente posizionata come complemento delle offerte CLI e web di Claude Code; include un runtime stabile di Claude Code e gestisce le versioni per garantirti un'esperienza coerente e stabile.
Perché è importante? Storicamente, gli strumenti di codifica IA funzionavano o esclusivamente nel terminale (sviluppatori a proprio agio con i workflow CLI) o esclusivamente nel cloud (interfacce browser). L'app desktop colma questo divario abilitando esecuzioni locali a bassa latenza e consentendoti di passare senza soluzione di continuità a sessioni (web) ospitate da Anthropic quando hai bisogno di calcolo isolato nel cloud o di controlli a livello enterprise. La preview desktop è particolarmente notevole per il supporto del parallelismo multi-sessione — puoi eseguire contemporaneamente diversi agenti Claude Code indipendenti sullo stesso repository, ciascuno nel proprio worktree Git (spazio di lavoro di branch isolato), così che gli agenti non vadano in conflitto tra loro. Questa è la funzionalità di punta che molte squadre troveranno immediatamente utile.
In che modo l'edizione desktop si rapporta alle versioni web e CLI?
Claude Code è nato come strumento da riga di comando ed è poi stato esteso alle interfacce web e mobile; la preview desktop si basa su queste fondamenta. L'app desktop rispecchia molte delle funzionalità disponibili sul web (avvio di sessioni, connessioni ai repository, avanzamento visualizzabile) ma si concentra sull'ergonomia del flusso di lavoro locale — UX da desktop, installazione nativa e integrazioni più strette con i repository Git locali tramite worktree — così che le sessioni possano essere eseguite in parallelo senza interferire tra loro sullo stato dei file.
Vedi anche Claude Code Web: cos'è e come usarlo
7 funzionalità eccellenti di Claude Code su Desktop
1) Parallelismo multi-sessione
Claude Code per Desktop supporta l'esecuzione simultanea di più sessioni Claude indipendenti. Ciò significa che puoi avere una sessione focalizzata su una correzione di bug, un'altra che scrive i test e una terza che genera la documentazione — tutte eseguite contemporaneamente anziché in coda in un'unica sessione. Questo parallelismo accelera i flussi di lavoro e ti consente di delegare compiti diversi in parallelo.
Ad esempio:
Supponiamo che tu abbia un progetto chiamato my-app e che tu voglia:
- Far modificare a Claude la homepage in una finestra;
- Far ottimizzare a Claude la logica del database in un'altra finestra.
Claude Desktop creerà automaticamente per te:
~/.claude-worktrees/my-app/homepage/
~/.claude-worktrees/my-app/database/
Due copie indipendenti (senza conflitti). È come eseguire due branch di sviluppo simultaneamente, con Claude che gestisce ciascuna per te.
2. .worktreeinclude: Rendere Claude consapevole dei file ignorati
A volte il tuo progetto ha file come .env o .local, che di solito sono ignorati da .gitignore e non vengono copiati nella directory di lavoro di Claude. I file elencati in .gitignore non vengono copiati automaticamente nei nuovi worktree. Claude fornisce un nuovo meccanismo: puoi creare un file .worktreeinclude nella directory root del progetto, indicandogli quali file devono essere copiati — un elenco in stile .gitignore che specifica quali file ignorati devono essere copiati nei worktree appena creati (ad esempio i file .env locali o impostazioni specifiche dello sviluppatore). Vengono copiati solo i file che compaiono sia in .worktreeinclude sia in .gitignore, evitando di duplicare accidentalmente file tracciati. Questo è fondamentale per preservare i file di segreto o di ambiente per sessione senza inserirli in Git.
Ad esempio:
.env
.env.local
.env.production
**/.claude/settings.local.json
Questo significa: quando Claude crea la directory di lavoro, verranno copiati anche questi file.
Nota:
- Vengono copiati solo i file presenti sia in .gitignore che in .worktreeinclude;
- Evita di copiare accidentalmente importanti file tracciati.
3) Avvio e sincronizzazione con sessioni web/cloud
L'app desktop può fungere da launcher per sessioni web/cloud — il che significa che puoi avviare sessioni Claude Code basate sul cloud dall'interfaccia desktop e monitorarle o indirizzarle localmente. Questa modalità ibrida è utile se desideri la comodità dei controlli locali con il modello di scalabilità o di permessi delle esecuzioni in cloud.
Nota:
- Quando gira nel cloud, le attività di Claude verranno eseguite sul server di sicurezza di Anthropic.
- Il passaggio tra ambiente locale e cloud è senza soluzione di continuità.
- Per creare una sessione, seleziona semplicemente "remote environment".
4) Avvio e sincronizzazione con sessioni web/cloud
L'app desktop può fungere da launcher per sessioni web/cloud — il che significa che puoi avviare sessioni Claude Code basate sul cloud dall'interfaccia desktop e monitorarle o indirizzarle localmente. Questa modalità ibrida è utile se desideri la comodità dei controlli locali con il modello di scalabilità o di permessi delle esecuzioni in cloud (locale per attività rapide, cloud per attività rischiose o ad alto consumo di risorse).
5) Versione integrata e configurazione enterprise
La versione Desktop include un runtime stabile di Claude Code, scaricato al primo avvio e gestito automaticamente. Gli amministratori enterprise possono disabilitare l'uso locale di Claude Code se necessario (policy enterprise isClaudeCodeForDesktopEnabled). I pacchetti di installazione Desktop supportano formati di distribuzione enterprise comuni (MSIX per Windows, PKG per macOS) e gli amministratori possono controllare aggiornamenti e accesso alle estensioni. Questi controlli sono pensati per facilitare l'adozione da parte di grandi team.
Nota:
- L'applicazione verrà scaricata automaticamente al primo avvio;
- L'app desktop gestisce automaticamente gli aggiornamenti di versione;
- Pulisce automaticamente le vecchie versioni per mantenere il sistema ordinato;
- Anche se hai installato la versione CLI sul tuo computer, userà comunque la propria versione (per maggiore stabilità).
- La versione desktop privilegia stabilità e compatibilità; la CLI (versione da riga di comando) può aggiornarsi più rapidamente, ma le nuove funzionalità potrebbero non essere immediatamente sincronizzate sulla versione desktop.
6) Variabili d'ambiente personalizzate
Claude Desktop ti consente di impostare variabili proprio come i file .env.
Queste variabili hanno effetto solo all'interno della sessione Claude, rendendole ideali per la configurazione del progetto.
Ad esempio:
API_KEY=abcd123
DEBUG=true
CERT="-----BEGIN CERT-----
MIIE...
-----END CERT-----"
7) Integrazione con strumenti e ambienti locali
Quando esegui sessioni locali, l'app desktop estrae il tuo $PATH della shell così i processi di sessione possono usare lo stesso node, npm, yarn, Python o altri strumenti CLI su cui fai affidamento. Fornisce anche un'interfaccia per aggiungere variabili d'ambiente personalizzate (in formato .env), con valori mascherati per la sicurezza. Questo rende più fluida l'esecuzione di test o build all'interno di una sessione basata su agenti, perché l'agente può invocare la stessa toolchain del tuo terminale.
Come installo Claude Code su Desktop?
Questa sezione illustra il processo di installazione con il minimo attrito. Le istruzioni seguenti sono aggiornate per la preview desktop e rimandano agli installer canonici.
Prerequisiti e configurazione dell'account
- Account Anthropic e workspace: Claude Code si integra con l'Anthropic Console. Dovrai completare un flusso OAuth nella Claude Console e avere una fatturazione attiva o accesso di anteprima per la ricerca secondo quanto richiesto dal modello di workspace di Anthropic. Claude Code usa uno workspace interno nella console per tracciare l'utilizzo; non puoi creare chiavi API per quello spazio di lavoro — è gestito per l'uso di Claude Code.
- Git e preparazione del repo: Assicurati che Git sia installato e che il progetto su cui vuoi operare sia un repository Git (o inizializza Git). L'app desktop si aspetta repo validi per funzionalità come i worktree; se apri una cartella senza Git inizializzato, un worktree non verrà creato.
- Specifiche OS: Le installazioni su macOS e Linux sono generalmente binari nativi; per gli utenti Windows è consigliato usare WSL per la piena compatibilità dei comandi in molti workflow. Alcune guide della community coprono configurazioni avanzate Windows/WSL nel caso riscontrassi problemi di PATH o della distribuzione.
Installazione passo-passo (breve)
- Apri la pagina di download di Claude e scegli l'installer corretto per la tua piattaforma.
- Esegui l'installer (PKG su macOS, MSIX o EXE su Windows). Per flotte enterprise, usa i pacchetti MSIX/PKG forniti per la distribuzione centralizzata.
- Avvia l'app Claude Desktop ed effettua l'accesso con il tuo account Anthropic/Claude. Le tue conversazioni e preferenze si sincronizzano tra desktop, web e mobile.
- Al primo avvio l'app scaricherà un runtime di Claude Code incluso. Consenti il completamento del download; è necessario e assicura l'uso di una versione stabile e gestita.
Verifiche post-installazione
• Apri Impostazioni > Ambienti e conferma che l'app desktop abbia estratto il tuo $PATH della shell.
• Scegli se vuoi abilitare le sessioni locali (se la tua macchina e le policy lo consentono) oppure se il tuo flusso di lavoro creerà sessioni web.
Metodo di installazione opzionale, quale scegliere
- Installer nativo (consigliato): usa l'installer nativo del sistema operativo per l'esperienza più semplice e integrata.
- Homebrew (macOS): comodo per gli utenti macOS che gestiscono le app con Homebrew.
- Installer basati su NPM o script: utili per setup più automatizzati o scriptati (CI o provisioning), o per distribuzioni Linux dove è preferibile uno script di installazione semplice.
Installazione: macOS, Linux, WSL (flusso consigliato)
- Scarica l'installer della preview desktop dalla pagina di download di Claude Code (la documentazione in-app fornisce il link all'installer).
- Esegui l'installer e apri l'app desktop Claude.
- Completa l'accesso OAuth tramite il flusso della Claude Console in-app.
- Configura la posizione predefinita dei worktree e le preferenze di esecuzione locale/remota nelle impostazioni desktop.
- Apri una cartella di progetto o clona un repo dall'interfaccia per iniziare.
Apri un terminale e, se ti fidi della fonte, esegui lo script di installazione fornito da Anthropic (questa è l'opzione di comodità tipicamente consigliata). Esempio (parafrasi):
# macOS / Linux / WSL (example convenience installer)
curl -fsSL https://claude.ai/install.sh | bash
In alternativa, se preferisci Homebrew su macOS:
brew install --cask claude-code
Installazione: Windows
WSL：
- Installa WSL (Ubuntu è comune) e configura un ambiente WSL pulito. Risolvi i problemi di PATH e interop in modo che l'integrazione WSL dell'app desktop possa accedere alla distribuzione.
- Installa Git e qualsiasi runtime linguistico in WSL di cui Claude potrebbe aver bisogno per esecuzioni locali (node, python, ecc.).
- Installa o esegui l'app desktop su Windows, puntala alla tua directory di progetto in WSL (o avvia l'app desktop all'interno di WSL se supportato) e segui lo stesso flusso OAuth.
Esempio PowerShell (parafrasi):
# PowerShell (example convenience installer)
irm https://claude.ai/install.ps1 | iex
Esempio CMD (parafrasi):
curl -fsSL https://claude.ai/install.cmd -o install.cmd && install.cmd && del install.cmd
Come usare Claude Code su Desktop nella pratica quotidiana?
Quali sono i pattern consigliati per la creazione di sessioni?
Attività brevi e indipendenti vs refactor di lunga durata
- Per attività brevi e circoscritte (bugfix, modifica di un singolo file, piccolo refactor), crea una sessione per attività e lascia che Claude produca un commit mirato. Rivedi e integra tempestivamente.
- Per iniziative di lunga durata (refactor ampi, sviluppo di funzionalità), considera la creazione di una sessione che faccia checkpoint frequenti e usa i controlli di avanzamento dell'interfaccia desktop per indirizzare o mettere in pausa il lavoro. Mantieni le sessioni su branch di feature per evitare merge accidentali.
Mantieni un file CLAUDE.md o un template di prompt nel tuo repo per standardizzare come le sessioni dovrebbero essere istruite (contesto, test da eseguire, regole di stile). Questa pratica riduce la variabilità e aiuta Claude a produrre risultati coerenti tra sessioni. Molti team memorizzano prompt standard o vincoli nei metadati del repo per garantire un comportamento prevedibile dell'agente.
Avviare e denominare una sessione
- Apri l'app desktop e seleziona o clona un repository.
- Clicca su “New Session” (o equivalente) e dai alla sessione un nome descrittivo (es.
bugfix/cs-142oadd-tests-login). La denominazione ti aiuta a distinguere in interfaccia le sessioni simultanee. - Scegli la modalità di esecuzione locale o remota, seleziona un branch di destinazione (o lascia che l'agente crei un branch in un nuovo worktree) e avvia la sessione. L'app crea automaticamente un worktree Git dedicato per la sessione.
Guidare l'agente: prompt e attività
- Usa prompt chiari e circoscritti. Esempio: “Trova il test unitario fallito per
AuthServicee crea una correzione che preservi l'API pubblica esistente; esegui i test e riporta i risultati.” - Per attività incrementali, chiedi a Claude di generare prima un piano (una breve checklist), poi richiedi le modifiche al codice specifiche passo dopo passo. I progressi incrementali riducono il rischio di allucinazioni e rendono i diff più facili da rivedere. Anthropic raccomanda questo approccio come buone pratiche.
Monitorare l'avanzamento e interagire
L'interfaccia desktop mostra i log delle azioni e i diff mentre l'agente lavora. Puoi mettere in pausa una sessione, cambiare le istruzioni o annullare un job in esecuzione. Quando l'agente propone modifiche, l'interfaccia mostra i diff dei file e una spiegazione di ciò che è cambiato. Approva, modifica o rifiuta i diff proposti prima del commit.
Flussi di commit, branch e PR
Una volta approvate le modifiche, l'app desktop può effettuare il commit nel branch del worktree della sessione. Da lì puoi eseguire il push verso origin e aprire una pull request tramite l'interfaccia (se hai autorizzato l'accesso a GitHub). Il branch di ciascuna sessione rimane isolato fino al merge, il che rende la revisione umana semplice.
Come funzionano in pratica l'isolamento Git e il parallelismo multi-sessione?
Worktree Git: il meccanismo di isolamento
Il desktop di Anthropic utilizza i worktree di Git per creare copie per sessione dell'albero di lavoro di un repository collegate a branch separati. I worktree sono più leggeri dei clone completi — condividono gli stessi metadati .git dove opportuno ma forniscono directory di lavoro indipendenti, così le modifiche concorrenti non vanno in conflitto né trapelano tra sessioni. Il desktop posiziona questi worktree creati automaticamente in una directory configurabile (predefinita ~/.claude-worktrees). Questo design abilita una concorrenza sicura per le operazioni basate su agenti.
Perché i worktree rispetto ai clone
I worktree sono più veloci da creare e più facili da correlare al medesimo storico Git sottostante, pur fornendo la separazione del filesystem necessaria ad evitare contaminazioni tra sessioni. Per la maggior parte dei flussi di lavoro questo è preferibile a molteplici clone completi; tuttavia, se ti servono ambienti runtime completamente isolati con dipendenze diverse, potrebbe essere comunque desiderabile un clone separato o un container.
Coordinamento e gestione dei conflitti
Poiché ogni sessione lavora in un branch/worktree isolato, i conflitti sono ridotti al minimo. Se due sessioni modificano indipendentemente lo stesso codice logico e entrambe vengono poi integrate nello stesso branch di destinazione, si applicherà la normale gestione dei conflitti di merge di Git — che è il punto corretto per la revisione e la risoluzione umana. Il modello di Anthropic presenta intenzionalmente i commit come PR revisionabili, mantenendo gli umani nel loop del merge.
Procedure comuni di risoluzione dei problemi e limitazioni
Se una sessione non si avvia o si blocca
- Conferma che i token di accesso al repository siano validi e non soggetti a limitazione di frequenza.
- Verifica spazio su disco e permessi per la directory dei worktree (ad esempio
~/.claude-worktrees). - Controlla i log dell'app desktop per messaggi di errore; l'app in genere espone una vista di diagnostica o un file di log.
Se le sessioni si contaminano a vicenda
- Conferma che l'app desktop stia creando worktree separati (ispeziona la directory
~/.claude-worktreeso la posizione dei worktree impostata nelle preferenze dell'app). - Se vedi stato condiviso, assicurati di usare l'ultima preview desktop o consulta la documentazione di Anthropic — questa release affronta specificamente l'isolamento delle sessioni.
Se i file ignorati non sono disponibili per le sessioni
Aggiungi i nomi dei file alla configurazione .worktreeinclude (o all'equivalente nell'interfaccia desktop) così l'app copierà in sicurezza i file ignorati necessari (ad esempio .env) in ciascun worktree. Evita di archiviare segreti nei worktree o di esporli senza una corretta gestione delle credenziali.
Conclusione
La preview desktop di Claude Code rappresenta un'evoluzione significativa nel modo in cui gli strumenti di codifica basati su agenti si inseriscono nei flussi di lavoro degli sviluppatori: mantiene velocità ed espressività degli agenti IA risolvendo diversi problemi pratici di coordinamento che gli sviluppatori affrontano quando più agenti devono operare sullo stesso codebase. Che tu lo adotti per la produttività del singolo sviluppatore o per coordinare più attività tra agenti in un team, comprendere i worktree di Git, .worktreeinclude e la distinzione tra sessioni locali e web renderà la tua prima settimana con la preview desktop molto più produttiva.
Pronti a usare la CLI di Claude Code? consulta la guida API per istruzioni dettagliate.
Gli sviluppatori possono accedere a Claude Opus 4.5 API ecc. tramite CometAPI, la versione più recente del modello è sempre aggiornata con il sito ufficiale. Per iniziare, esplora le funzionalità del modello nel Playground e consulta la guida API per istruzioni dettagliate. Prima di accedere, assicurati di aver effettuato l'accesso a CometAPI e di aver ottenuto la chiave API. CometAPI offre un prezzo di molto inferiore a quello ufficiale per aiutarti nell'integrazione.
Pronti a iniziare?→ Prova gratuita di Claude opus 4.5 !
Se vuoi scoprire altri suggerimenti, guide e novità sull'IA seguici su VK, X e Discord!