Claude Desktop Linux: come installare la beta su Ubuntu e Debian
La versione Linux di Claude Desktop è una beta: Anthropic lo scrive nella prima riga della sua documentazione. Funziona su Ubuntu e Debian, si installa da un repository apt o da un pacchetto .deb e offre le stesse schede Chat, Cowork e Code che ci sono su macOS e Windows. I comandi sono quelli della documentazione ufficiale, elencata in fondo.
Cosa serve
- Sistema: Ubuntu 22.04 o successiva, oppure Debian 12 o successiva. Altre distribuzioni basate su Debian con gli stessi requisiti potrebbero funzionare, ma Anthropic non le ha testate ufficialmente. Per Fedora, Arch e le altre distribuzioni che non derivano da Debian non c’è un pacchetto ufficiale: la documentazione indica di usare la CLI di Claude Code.
- Architettura: x86_64 o arm64. Il repository non pubblica pacchetti per altre architetture.
- Strumenti:
curlegnupg, che un’installazione appena fatta di Debian o Ubuntu potrebbe non avere. - Account: un account Anthropic. Chat è disponibile anche con il piano Free; per Code e Cowork serve un piano Pro, Max, Ultra, Team o Enterprise. Le organizzazioni possono accedere con il single sign-on (SSO, l’accesso unico).
- Per Cowork: virtualizzazione hardware attiva nel firmware, i pacchetti di QEMU e del firmware UEFI e l’utente nel gruppo
kvm(i dettagli sono più avanti). - Un utente normale: l’app non va avviata come root.
Su macOS e Windows l’app si installa invece con l’installer che si scarica dalle pagine di download. Chi lavora su Windows con WSL 2 deve installare l’app per Windows e far girare le sessioni dentro la propria distribuzione.
Controllare l’architettura e installare curl e gnupg
Questo comando stampa l’architettura vista dal gestore dei pacchetti:
dpkg --print-architecture
Deve rispondere amd64 oppure arm64. Con qualunque altro valore il repository non ha un pacchetto per voi.
Il passaggio successivo scarica la chiave di firma con curl e la verifica con gpg. Se uno dei due comandi risponde command not found, installate entrambi i pacchetti:
sudo apt install curl gnupg
Scaricare e verificare la chiave di firma di Anthropic
Il repository è firmato, e senza la chiave giusta apt non lo accetta. Il comando che segue scarica la chiave da downloads.claude.ai e la scrive, con i permessi di amministratore, in /usr/share/keyrings/claude-desktop-archive-keyring.asc. Controllate di averlo copiato intero: è un file di sistema, e apt lo userà per decidere di quali pacchetti fidarsi.
sudo curl -fsSLo /usr/share/keyrings/claude-desktop-archive-keyring.asc https://downloads.claude.ai/claude-desktop/key.asc
Se tutto va bene il comando non stampa nulla; se qualcosa va storto compare un messaggio che comincia con curl:. Il silenzio però non dimostra che il file sia quello giusto. Leggete la chiave scaricata:
gpg --show-keys /usr/share/keyrings/claude-desktop-archive-keyring.asc
L’unica impronta (fingerprint, la sequenza che identifica la chiave) che gpg deve mostrare è 31DDDE24DDFAB679F42D7BD2BAA929FF1A7ECACE. Se gpg dice che non riesce ad aprire il file, o che il file non contiene dati OpenPGP validi, il download è fallito o ha restituito un contenuto sbagliato: controllate che la rete raggiunga downloads.claude.ai e ripetete il download. Saltare questa verifica ha una conseguenza precisa: con una chiave mancante o sbagliata, più avanti apt update fallisce con l’errore NO_PUBKEY BAA929FF1A7ECACE.
Aggiungere il repository apt di Anthropic
Registrare il repository serve a far arrivare gli aggiornamenti insieme a quelli normali del sistema. Il comando scrive una riga nel file /etc/apt/sources.list.d/claude-desktop.list, che apt legge tra le sue sorgenti. Con tee il file viene sovrascritto se esiste già, ma il nome è specifico di Claude Desktop, quindi le altre sorgenti restano come sono.
echo "deb [arch=amd64,arm64 signed-by=/usr/share/keyrings/claude-desktop-archive-keyring.asc] https://downloads.claude.ai/claude-desktop/apt/stable stable main" | sudo tee /etc/apt/sources.list.d/claude-desktop.list
Per controllare, stampate il file:
cat /etc/apt/sources.list.d/claude-desktop.list
Deve contenere la riga che comincia con deb [arch=amd64,arm64, identica a quella del comando precedente. Se il file è vuoto o non c’è, ripetete il passaggio.
Installare il pacchetto claude-desktop
Ora apt deve rileggere le sorgenti, altrimenti non vede il repository appena aggiunto. Il comando aggiorna l’elenco dei pacchetti e poi installa l’app.
sudo apt update && sudo apt install claude-desktop
apt installa di default anche i pacchetti raccomandati, tra cui QEMU e il firmware UEFI che servono a Cowork. Se di solito installate con --no-install-recommends, o se il sistema è un’immagine minimale che salta i raccomandati, quei pacchetti non arrivano: se ne parla nella sezione su Cowork.
Installare da un .deb scaricato (claude desktop deb)
Se non potete usare il repository, la pagina su Claude Desktop per Linux riporta un comando che cerca nell’indice del repository il pacchetto più recente per la vostra architettura e lo scarica nella cartella corrente. Lo trovate lì, nella sezione «Install from a downloaded file».
Il .deb contiene già la chiave di firma di Anthropic e la installa nello stesso percorso visto sopra. Di default registra anche da solo il repository in /etc/apt/sources.list.d/claude-desktop.list, così gli aggiornamenti successivi arrivano con quelli di sistema. Se non volete che lo faccia, il file che lo impedisce va creato prima di installare il pacchetto. Si chiama /etc/default/claude-desktop. Per crearlo serve un editor di testo aperto con i permessi di amministratore, perché /etc/default è una cartella di sistema. Il file deve contenere solo questa riga:
CLAUDE_DESKTOP_ADD_REPO="false"
Non c’è nulla da sostituire: la riga va scritta così com’è. Il prezzo di questa scelta è che senza repository apt non porta le nuove versioni. Per aggiornare bisogna riscaricare il pacchetto e reinstallarlo, oppure registrare il repository in un secondo momento.
Il pacchetto scaricato si apre con l’installatore grafico, per esempio GNOME Software, oppure si installa con apt dalla cartella in cui si trova il file:
sudo apt install ./claude-desktop_*.deb
Avviare Claude e accedere con l’account Anthropic
L’app compare nel menu delle applicazioni come «Claude». Dal terminale si avvia con:
claude-desktop
Lanciatela da utente normale: se la avviate come root, l’app si chiude con il messaggio Running as root without --no-sandbox is not supported. L’accesso funziona come su macOS e Windows, con un abbonamento claude.ai oppure con l’SSO dell’organizzazione. Per usare l’app con una chiave API di Claude o con piattaforme di terze parti come Amazon Bedrock o Microsoft Foundry, la documentazione rimanda a una pagina dedicata, «Claude Desktop on 3P».
L’app salva l’accesso nel portachiavi del desktop (il keyring, come GNOME Keyring o KDE Wallet). Se non trova un portachiavi sbloccato, a ogni avvio vi chiede di accedere di nuovo. Su un desktop diverso da KDE Plasma installato senza pacchetti raccomandati il portachiavi può mancare del tutto. In quel caso si installa GNOME Keyring:
sudo apt install gnome-keyring
Dopo la correzione riavviate l’app, accedete, chiudetela e riapritela: se risultate ancora collegati, l’accesso è stato salvato.
Le schede Chat, Cowork e Code
L’interfaccia dipende dall’aggiornamento ricevuto dall’account. Nella nuova esperienza, in distribuzione graduale, Chat e Cowork sono unificati: basta descrivere il compito nella conversazione, e la scheda Code resta disponibile. Gli account non ancora aggiornati mantengono Chat e Cowork separati.
- Chat è la conversazione con Claude.
- Code è Claude Code con un’interfaccia grafica: si chiede a Claude di lavorare sul codice di una cartella e poi si rivedono le modifiche, senza passare dal terminale. Per la prima sessione la guida introduttiva all’app desktop indica questi passaggi: nella riga sotto la casella del prompt si apre il selettore dell’ambiente e si sceglie la prima voce del gruppo «Local», poi con il controllo accanto si seleziona «Open folder…» e la cartella del progetto. L’app include già Claude Code, quindi non servono Node.js né la CLI. Richiede un abbonamento Pro, Max, Ultra, Team o Enterprise: senza, cliccando su Code compare l’invito a passare a un piano a pagamento.
- Cowork è la parte dell’app dedicata a Dispatch e ai lavori agentici più lunghi, nelle parole della documentazione «longer agentic work».
Le pagine consultate non indicano quali piani servono per Chat e Cowork: per queste due schede la guida introduttiva rimanda al Claude Help Center. Il resto della scheda Code (modalità dei permessi, sessioni parallele, revisione delle differenze) è descritto nella pagina di riferimento di Claude Code Desktop.
Preparare Cowork su Linux (claude cowork linux)
Dal 6 ottobre 2026, sui piani Pro, Max e Ultra i nuovi compiti Cowork vengono eseguiti nel cloud di Anthropic e non si può scegliere l’esecuzione locale; i compiti locali avviati prima restano sul computer. Per accedere alle cartelle collegate, le sessioni cloud richiedono Claude Desktop aperto e trasferiscono nel cloud una copia dei file necessari. Quanto segue riguarda le sessioni locali: su Linux Cowork le esegue in una macchina virtuale che l’app gestisce con QEMU e KVM. Per questo ha requisiti in più rispetto al resto dell’app, tra cui circa 25 GB di spazio libero per l’immagine dell’ambiente e almeno 8 GB di RAM (l’ambiente ne usa 4 GB mentre è in esecuzione):
- Virtualizzazione hardware attiva nelle impostazioni del firmware. Senza, Cowork mostra «Cowork requires hardware virtualization (KVM)».
- QEMU e firmware UEFI:
qemu-system-x86,ovmfevirtiofsdsu x86_64, oppureqemu-system-arm,qemu-efi-aarch64evirtiofsdsu arm64. apt li installa di default come raccomandati; se mancano, Cowork mostra «Cowork requires QEMU» insieme al comando apt da lanciare. Ubuntu 22.04 non ha il pacchettovirtiofsd, quindi lì l’app usa una copia inclusa. - Il gruppo kvm, che dà accesso a
/dev/kvme a/dev/vhost-vsock.
Il comando seguente aggiunge il vostro utente al gruppo kvm. $USER non va sostituito: è una variabile che la shell riempie con il nome dell’utente con cui siete collegati. L’opzione -a aggiunge il gruppo a quelli che avete già; senza, l’utente perderebbe gli altri gruppi. Per questo il comando va copiato intero.
sudo usermod -aG kvm $USER
Fatelo anche se /dev/kvm funziona già: alcuni ambienti desktop danno accesso a /dev/kvm senza il gruppo, ma /dev/vhost-vsock lo possono aprire solo i membri di kvm. Poi uscite dalla sessione e rientrate. L’app controlla i requisiti una sola volta all’avvio, quindi va riavviata anche dopo aver installato i pacchetti.
Se Cowork segnala «Cowork requires the vhost_vsock kernel module», caricate il modulo e riavviate l’app:
sudo modprobe vhost_vsock
Così il modulo resta caricato solo fino al prossimo riavvio del computer. Per caricarlo a ogni avvio, il comando seguente crea il file /etc/modules-load.d/vhost_vsock.conf con il nome del modulo:
echo vhost_vsock | sudo tee /etc/modules-load.d/vhost_vsock.conf
C’è un caso senza soluzione. Se /dev/vhost-vsock manca e il kernel in uso non ha una cartella dei moduli sotto /lib/modules, Cowork avvisa che il kernel non include il supporto alla virtualizzazione e che non si può aggiungere a mano. Secondo la documentazione succede spesso su ChromeOS e negli ambienti Linux basati su container.
Cosa manca nella beta per Linux
La documentazione elenca le funzioni che la beta non ha ancora:
- Computer Use: il controllo delle app e dello schermo non c’è su Linux.
- Dettatura: l’input vocale non c’è nell’app per Linux; si può usare la dettatura vocale della CLI.
- Scorciatoia globale di Quick Entry: funziona su X11. Su Wayland nativo richiede il portale GlobalShortcuts dell’ambiente desktop.
- Fedora e RHEL: per ora sono supportate solo le distribuzioni basate su Debian. Anthropic scrive che il supporto ad altre distribuzioni arriverà, ma nella pagina non ci sono date.
Per ciò che l’app non fa ancora, la documentazione indica la CLI, che usa lo stesso motore di Claude Code e funziona su più distribuzioni.
Aggiornare Claude Desktop
Su Linux l’app non si aggiorna da sola: le nuove versioni arrivano con gli aggiornamenti normali del sistema, se il repository è registrato.
sudo apt update && sudo apt upgrade
Le trova anche il programma grafico di aggiornamento della distribuzione. Chi ha installato il .deb senza registrare il repository deve invece riscaricare il pacchetto e reinstallarlo.
Disinstallare Claude Desktop
Per rimuovere l’app:
sudo apt remove claude-desktop
Togliendo il pacchetto si tolgono anche la voce del repository e la chiave di firma che il pacchetto stesso aveva registrato. Se invece il repository l’avevate aggiunto voi con il comando echo visto sopra, va cancellato anche il suo file. Il comando che segue elimina in modo definitivo il file /etc/apt/sources.list.d/claude-desktop.list. Controllate il percorso prima di premere Invio: con un errore di battitura potreste cancellare la sorgente di un altro programma.
sudo rm /etc/apt/sources.list.d/claude-desktop.list
Se qualcosa va storto
E: Unable to locate package claude-desktop: apt non ha trovato il repository. Lanciatesudo apt updatedopo averlo aggiunto, controllate concatche il file contenga la rigadebe che l’architettura siaamd64oarm64. Cercate nell’output diapt updateerrori relativi a downloads.claude.ai: un errore di rete o di chiave vuol dire che il repository c’è, ma non è raggiungibile o non si riesce a verificarlo. Se nulla funziona, resta l’installazione dal .deb scaricato.- Dipendenze non soddisfatte con
libc6 (>= 2.34): la distribuzione è troppo vecchia. Ubuntu 20.04, per esempio, ha libc6 2.31; serve Ubuntu 22.04 o Debian 12, o versioni successive. - Tutte le dipendenze
not installablecon suffisso:amd64o:arm64: avete scaricato il .deb per un’architettura diversa da quella della macchina. Ricontrollate condpkg --print-architecturee scaricate il pacchetto giusto, oppure usate il repository, che sceglie da solo. Remote file name has no lengthcon il comando di download del .deb: la ricerca nell’indice non ha restituito nessun pacchetto. Può essere che la rete blocchi downloads.claude.ai, oppure che non ci sia un pacchetto per la vostra architettura.E: Unsupported file ./claude-desktop_*.deb given on commandline: nella cartella corrente non c’è un .deb. Controllate che il download sia finito e lanciate il comando dalla cartella che contiene il file.- L’accesso non resta salvato su KDE Plasma: se oltre a KDE Wallet è installato anche GNOME Keyring, i due portachiavi entrano in conflitto e l’avviso può comparire anche se KDE Wallet funziona. La documentazione indica di rimuovere quello in più con
sudo apt remove gnome-keyringe di riavviare il computer subito dopo. Se invece il portachiavi è installato ma bloccato, basta sbloccarlo. - «Claude doesn’t have permission to use virtualization (/dev/kvm)»: aggiungete l’utente al gruppo
kvm, poi uscite dalla sessione e rientrate.
Documentazione di riferimento
Pagine ufficiali consultate il 17 novembre 2026:
- Claude Code Docs — Claude Desktop on Linux (beta)
- Claude Code Docs — Get started with the desktop app
- Claude Code Docs — Use Claude Code Desktop


