Vai al contenuto

Claude Desktop Linux: come installare la beta su Ubuntu e Debian

Illustrazione 3D di una postazione di lavoro con laptop e il pinguino di Linux sul tavolo.
Immagine generata con IA

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: curl e gnupg, 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):

  1. Virtualizzazione hardware attiva nelle impostazioni del firmware. Senza, Cowork mostra «Cowork requires hardware virtualization (KVM)».
  2. QEMU e firmware UEFI: qemu-system-x86, ovmf e virtiofsd su x86_64, oppure qemu-system-arm, qemu-efi-aarch64 e virtiofsd su 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 pacchetto virtiofsd, quindi lì l’app usa una copia inclusa.
  3. Il gruppo kvm, che dà accesso a /dev/kvm e 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. Lanciate sudo apt update dopo averlo aggiunto, controllate con cat che il file contenga la riga deb e che l’architettura sia amd64 o arm64. Cercate nell’output di apt update errori 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 installable con suffisso :amd64 o :arm64: avete scaricato il .deb per un’architettura diversa da quella della macchina. Ricontrollate con dpkg --print-architecture e scaricate il pacchetto giusto, oppure usate il repository, che sceglie da solo.
  • Remote file name has no length con 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-keyring e 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:

Leggi anche

  • Claude Code
  • Claude Desktop
  • Ubuntu