# Come aggiornare Claude Code alla versione più recente nel 2026 > Come controllare la versione di Claude Code, aggiornarla con il comando claude update, installare la build più recente tramite Homebrew o WinGet e cosa fare se non si aggiorna. Source: https://ailoot.ai/blog/it/update-claude-code/ Canonical: https://ailoot.ai/blog/it/update-claude-code/ Language: it Publisher: Ailoot (https://ailoot.ai/) Translation: guide-130 Revision: sha256-a974a0c2330414b8917276ab487d590891930c34cc0b084f33dc5aae75691d02 Claude Code cambia quasi ogni giorno. Apri il changelog più recente e trovi nuovi comandi, bug corretti e miglioramenti di velocità. Nel frattempo, il tuo terminale esegue una build di due settimane fa e metà di quei miglioramenti semplicemente non funziona. Claude non te lo dice, neanche: si avvia come al solito e tu ti chiedi perché gli altri abbiano una funzionalità che a te manca. Ti spiegherò come controllare la tua versione, aggiornarla all’ultima disponibile e cosa fare se l’aggiornamento non si installa. I comandi sono riportati parola per parola dalla documentazione ufficiale di Claude Code e sono stati verificati all’inizio di settembre 2026. In quel momento, l’ultima versione pubblicata era la 2.1.261, ma il tuo numero sarà diverso. Non ha senso inseguire un numero specifico: l’importante è semplicemente usare una build recente. Le informazioni su come lavorare con Ailoot sono disponibili nella [documentazione](https://ailoot.ai/docs/). ## Come aggiornare rapidamente Claude Code alla versione più recente?
Punto chiave La risposta breve è questa. Se hai installato Claude Code con il programma di installazione nativo, si aggiorna da solo in background, quindi non devi fare nulla manualmente. Per aggiornarlo subito senza aspettare il controllo in background, digita claude update nel terminale. Se lo hai installato tramite Homebrew, WinGet o un gestore di pacchetti Linux, non ci sono aggiornamenti automatici: ognuno ha il proprio comando, come brew upgrade claude-code. Puoi sempre controllare se hai la versione più recente eseguendo claude --version.
Di seguito spiego ogni caso nel dettaglio, ma se hai poco tempo, ecco tre comandi che coprono quasi tutte le situazioni. ```bash claude --version # quale versione è installata ora claude update # aggiorna subito (installazione nativa) claude doctor # controlla installazione e aggiornamenti ``` Il primo mostra la tua versione, il secondo la aggiorna e il terzo diagnostica i problemi se qualcosa va storto. Di seguito spiego quando usare ciascuno e perché `claude update` non funziona per alcuni utenti. ## Come controllare quale versione di Claude Code è installata?
Punto chiave Digita claude --version nel terminale. Il comando stampa un numero di versione in un formato come 2.1.211 (Claude Code) e non avvia nulla. È il modo più rapido per capire se la tua build è meno recente dell’ultima disponibile. Se vuoi una diagnostica più dettagliata — lo stato dell’installazione, gli errori di configurazione e gli avvisi — c’è un comando separato, claude doctor, che funziona anche senza avviare una sessione.
Prima di aggiornare, è utile sapere da quale versione parti. Il comando è semplice: ```bash claude --version ``` Otterrai una riga come `2.1.211 (Claude Code)`. Questa è la tua versione attuale. Confronta i primi due numeri con l’ultimo numero nel changelog: se il tuo è molto più basso, è ora di aggiornare. Se vuoi un quadro più ampio, esegui `claude doctor`. Controlla soltanto e non modifica nulla: non avvia una sessione, ma mostra lo stato dell’installazione, gli errori nel file delle impostazioni e gli avvisi con suggerimenti pronti all’uso su cosa correggere. Mostra anche il risultato dell’ultimo tentativo di aggiornamento automatico: utile se sospetti che l’aggiornamento in background non sia riuscito a installarsi senza segnalare l’errore. ## Claude Code si aggiorna da solo?
Punto chiave Se hai installato Claude Code con il programma di installazione nativo (il consueto comando curl con lo script install.sh o install.ps1 su Windows), allora sì: si aggiorna da solo. Claude Code controlla la disponibilità di aggiornamenti all’avvio e di tanto in tanto mentre è in esecuzione, scarica la nuova versione in background e la applica al successivo avvio. Devi solo riavviare la sessione ogni tanto. Le installazioni tramite Homebrew, WinGet e gestori di pacchetti Linux, invece, non si aggiornano da sole: serve un comando manuale.
Dipende tutto da come hai installato Claude Code. L’installazione nativa — quella consigliata da Anthropic e installata dallo script sul sito web — può aggiornarsi da sola, come dichiara esplicitamente la documentazione.

Le installazioni native si aggiornano automaticamente in background per mantenerti sulla versione più recente.

— Claude Code Docs, Configurazione avanzata, Documentazione ufficiale
Ecco come funziona: Claude Code controlla la disponibilità di aggiornamenti all’avvio e periodicamente mentre è in esecuzione. Se trova una nuova versione, la scarica e la installa in background, quindi la applica al successivo avvio. Ti basta chiudere e riaprire la sessione ogni due giorni circa per tornare aggiornato. Puoi controllare com’è andato l’ultimo tentativo in background usando lo stesso comando `claude doctor`. Ti mostrerà se l’aggiornamento non è riuscito a installarsi per qualche motivo. Se però hai installato Claude Code tramite un gestore di pacchetti — Homebrew su un MacBook, WinGet su Windows, apt o dnf su Linux — non ci sono aggiornamenti in background. Queste installazioni si aggiornano con il consueto comando di aggiornamento; più avanti trovi una sezione dedicata. Una versione recente di Claude Code è una base, ma da sola non ti porterà lontano. I risultati costanti non dipendono dalla versione dello strumento, ma da come ci lavori. ## Come aggiornare Claude Code manualmente con un solo comando?
Punto chiave Digita claude update. Il comando applica subito l’aggiornamento senza aspettare il controllo in background. Se trova una nuova versione, vedrai un messaggio che conferma il passaggio dalla versione precedente a quella nuova. Se hai già la versione più recente, vedrai la riga Claude Code is up to date con il numero attuale. Il comando funziona sia con le installazioni native sia con i gestori di pacchetti, ma Homebrew e WinGet restituiscono una risposta leggermente diversa.
Non devi aspettare il controllo in background per accorgerti che c’è una nuova versione. C’è un comando che la aggiorna subito: ```bash claude update ``` Ci sono due possibili esiti. Se viene trovato e installato un aggiornamento, Claude Code mostrerà una riga come `Successfully updated from to version `. Se hai già la build più recente, vedrai `Claude Code is up to date ()`: significa che non c’è nulla da aggiornare. C’è una particolarità nell’uso di questo comando con i gestori di pacchetti. Se Claude Code è stato installato tramite Homebrew, WinGet o apk, `claude update` restituisce una risposta più breve — `Claude is up to date!` — e non sempre recupera da solo la nuova build. Per queste installazioni è più affidabile usare il comando di aggiornamento del gestore di pacchetti, descritto di seguito. ## Come aggiornare Claude Code installato tramite Homebrew o WinGet?
Punto chiave I gestori di pacchetti non aggiornano Claude Code automaticamente, quindi devi eseguire tu il comando di aggiornamento. Su un MacBook con Homebrew, il comando è brew upgrade claude-code. Su Windows con WinGet, è winget upgrade Anthropic.ClaudeCode. Su Linux con apt, dnf o apk, l’aggiornamento arriva con il normale aggiornamento del sistema. Se vuoi che Claude Code esegua da solo l’aggiornamento tramite Homebrew e WinGet, imposta su uno la variabile d’ambiente CLAUDE_CODE_PACKAGE_MANAGER_AUTO_UPDATE.
Se hai installato Claude Code tramite un gestore di pacchetti invece che con lo script del sito web, spetta a te aggiornarlo. Ecco i comandi per ciascun sistema. Su macOS con Homebrew: ```bash brew upgrade claude-code ``` Con Homebrew ci sono due opzioni. Claude Code viene installato in due varianti. La variante `claude-code` segue il canale stabile: una versione vecchia di circa una settimana, che salta le release con problemi gravi. La variante `claude-code@latest` riceve la versione più recente appena viene pubblicata. Aggiorna quella che hai installato: se hai `claude-code@latest`, il comando sarà `brew upgrade claude-code@latest`. Su Windows con WinGet: ```powershell winget upgrade Anthropic.ClaudeCode ``` Con WinGet, a volte l’aggiornamento non riesce mentre Claude Code è in esecuzione perché Windows sta usando il file eseguibile. Claude Code ti mostrerà semplicemente il comando manuale; chiudilo ed esegui di nuovo l’aggiornamento. Su Linux con apt, dnf o apk non c’è un comando separato da imparare: la versione più recente arriva con il normale aggiornamento del sistema, perché Claude Code pubblica repository firmati. | Metodo di installazione | Comando di aggiornamento | |----------------------|----------------| | Programma di installazione nativo | si aggiorna da solo oppure `claude update` | | Homebrew (macOS) | `brew upgrade claude-code` | | WinGet (Windows) | `winget upgrade Anthropic.ClaudeCode` | | apt / dnf / apk (Linux) | normale aggiornamento del sistema | Se non vuoi ricordarti tutto questo, c’è la variabile d’ambiente `CLAUDE_CODE_PACKAGE_MANAGER_AUTO_UPDATE`. Impostala su `1` e Claude Code eseguirà l’aggiornamento in background tramite Homebrew e WinGet, poi suggerirà di riavviare dopo un aggiornamento riuscito. La documentazione include un’avvertenza: a volte Claude Code ti avvisa di una nuova versione prima che questa sia effettivamente disponibile nel gestore di pacchetti. Se l’aggiornamento non trova nulla, aspetta un po’ e riprova. A proposito, se stai ancora scegliendo come installare Claude Code, c’è una guida dettagliata in un articolo separato su [come installare Claude Code](https://ailoot.ai/blog/it/install-claude-code/), compreso il motivo per cui il programma di installazione nativo è più comodo dei gestori di pacchetti. ## Perché Claude Code non si aggiorna e cosa dovresti fare?
Punto chiave Di solito ci sono tre possibili cause. Primo, hai più installazioni di Claude Code che entrano in conflitto: il comando ne aggiorna una, ma ne viene avviata un’altra. Secondo, la cartella globale di npm non è scrivibile, quindi l’aggiornamento in background non riesce a installarsi senza segnalare l’errore. Terzo, potresti aver sostituito il launcher con un tuo script. Inizia la diagnosi con claude doctor e il comando which -a claude: mostrano esattamente dov’è il problema.
A volte aggiorni più volte, ma `claude --version` continua ostinatamente a mostrare il vecchio numero. Esaminerò le cause principali, a partire dalla più comune. La prima cosa da controllare è se hai più installazioni di Claude Code contemporaneamente. Può succedere se prima lo hai installato tramite npm e poi lo hai reinstallato in modalità nativa. Il comando aggiorna una copia, ma il terminale ne avvia un’altra, quindi la versione sembra non cambiare. Controlla quante copie hai: ```bash which -a claude ``` Claude Code può trovarsi in tre posizioni: `~/.local/bin/claude` è il programma di installazione nativo, `~/.claude/local/` è la vecchia installazione locale di npm delle prime versioni, mentre il pacchetto globale di npm viene mostrato dal comando `npm -g ls @anthropic-ai/claude-code`. Se ne trovi più di una, tienine una sola, preferibilmente l’installazione nativa. Rimuovi le altre così: ```bash npm uninstall -g @anthropic-ai/claude-code rm -rf ~/.claude/local ``` La seconda causa comune è una cartella globale di npm non scrivibile. Se hai installato Claude Code globalmente con npm e non ha il permesso di scrivere nella sua cartella, l’aggiornamento in background non si installa. All’avvio, Claude Code mostra una notifica una tantum e `claude doctor` elenca esattamente cosa correggere. È un altro motivo per preferire l’installazione nativa: scrive nella cartella home e non richiede quei permessi. La terza situazione è che in passato hai sostituito il launcher `~/.local/bin/claude` con un tuo script o collegamento simbolico. A partire dalla versione 2.1.207, gli aggiornamenti automatici lasciano intatto un launcher di questo tipo: le nuove versioni vengono comunque installate nella cartella `~/.local/share/claude/versions/`, ma è il tuo script a decidere quale avviare. Non eliminare l’unico launcher per poi richiamare `claude update` per nome. Conserva prima il launcher personalizzato e, se è un collegamento simbolico, anche la destinazione in una posizione di backup separata e inutilizzata. Spostalo dal percorso originale solo dopo aver verificato la copia. Ripristina il launcher nativo con l’[installer ufficiale](https://code.claude.com/docs/en/setup#install-claude-code), che non dipende da un comando `claude` già esistente: ```bash # macOS, Linux o WSL: installer nativo ufficiale curl -fsSL https://claude.ai/install.sh | bash ``` Al termine apri un nuovo terminale e verifica: ```bash claude --version claude doctor ``` Il primo comando deve mostrare un numero di versione. Esamina gli avvisi di doctor sul launcher o su PATH prima di continuare; non eliminare il launcher conservato finché quello sostitutivo non funziona. Un altro sintomo è che `claude update` o `claude doctor` si blocca subito dopo la riga `Checking for updates`. Nelle versioni meno recenti (precedenti alla 2.1.214), a volte succedeva quando uno dei file di configurazione della shell, come `~/.zshrc`, era una cartella invece che un file. Le build recenti ora ignorano questo problema, quindi aggiornare all’ultima versione corregge anche il bug. ## Come scegliere un canale di aggiornamento: latest o stable?
Punto chiave Claude Code ha due canali di aggiornamento. Latest è il canale predefinito: le nuove funzionalità arrivano appena vengono rilasciate. Stable è una versione vecchia di circa una settimana che salta le release con problemi gravi. Se per te contano di più le funzionalità nuove, resta su latest. Se preferisci la prevedibilità e non vuoi ritrovarti con build instabili, passa a stable. Puoi cambiare questa impostazione tramite il parametro autoUpdatesChannel nel file settings.json o con il comando /config.
Aggiornare alla versione più recente non significa sempre installare il giorno stesso la build appena uscita. Claude Code ti permette di scegliere tra due canali, e la scelta determina esattamente cosa ricevi quando aggiorni. Il canale `latest` è quello predefinito. Le nuove funzionalità arrivano appena vengono rilasciate: è comodo se vuoi provarle per primo. Il canale `stable` fornisce una versione vecchia di circa una settimana: ha avuto il tempo di assestarsi e salta le release con problemi gravi. È la scelta di chi preferisce la tranquillità alla velocità. Il modo più semplice per cambiare canale è usare il comando `/config` dentro Claude Code, alla voce Auto-update channel. Oppure puoi inserirlo manualmente nel file delle impostazioni `settings.json`: ```json { "autoUpdatesChannel": "stable" } ``` Se stai configurando Claude Code in base alle tue abitudini, trovi una guida separata alla [personalizzazione di Claude Code](https://ailoot.ai/blog/it/claude-personalization-profile-memory/), che tratta l’intero file delle impostazioni, non solo il canale di aggiornamento. ## Come installare una versione specifica o impostare una versione minima?
Punto chiave Il programma di installazione nativo accetta sia il nome di un canale sia un numero di versione esatto. Per installare una build specifica, aggiungi il suo numero alla fine del comando di installazione, per esempio bash -s 2.1.89. Puoi installare il canale stable al posto di latest nello stesso modo. Per impedire che gli aggiornamenti ti riportino mai sotto una certa versione, imposta il parametro minimumVersion in settings.json. È il limite minimo che né gli aggiornamenti in background né claude update supereranno verso il basso.
A volte ti serve una versione specifica invece dell’ultima, per esempio per tornare a una build con cui il tuo flusso di lavoro funzionava sicuramente. Il programma di installazione nativo lo consente: accetta sia il nome di un canale sia un numero di versione esatto. Installa una build specifica così: ```bash curl -fsSL https://claude.ai/install.sh | bash -s 2.1.89 ``` Su Windows, l’equivalente in PowerShell è leggermente diverso: ```powershell & ([scriptblock]::Create((irm https://claude.ai/install.ps1))) 2.1.89 ``` Puoi installare allo stesso modo il canale stable: scrivi `stable` al posto di un numero. Il canale scelto durante l’installazione diventa quello predefinito per i futuri aggiornamenti automatici. Se vuoi evitare di tornare a una versione più vecchia, imposta una versione minima in `settings.json`: ```json { "autoUpdatesChannel": "stable", "minimumVersion": "2.1.100" } ``` Questo è il limite minimo. Né un aggiornamento in background né `claude update` installeranno una versione inferiore a quella specificata. È utile quando passi a stable e non vuoi tornare indietro da una build più recente che stai già usando. ## Come disattivare gli aggiornamenti automatici se sono d’intralcio?
Punto chiave Se non ti servono gli aggiornamenti in background di Claude Code, disattivali con la variabile DISABLE_AUTOUPDATER nel blocco env del file settings.json. Interrompe solo il controllo in background: il comando claude update continuerà a funzionare se vuoi aggiornare manualmente. Se devi bloccare ogni modalità di aggiornamento, compresi quelli manuali, usa l’altra variabile, DISABLE_UPDATES. È utile quando distribuisci Claude Code al tuo team e vuoi che tutti usino la stessa versione.
A volte gli aggiornamenti in background sono d’intralcio, per esempio quando vuoi mantenere il team su un’unica versione precisa. Puoi disattivarli tramite il file delle impostazioni: ```json { "env": { "DISABLE_AUTOUPDATER": "1" } } ``` Un dettaglio importante: `DISABLE_AUTOUPDATER` disattiva solo il controllo in background. Il comando `claude update` continuerà a funzionare, quindi potrai ancora aggiornare manualmente. Se devi bloccare ogni modalità di aggiornamento contemporaneamente, compresi quelli manuali, c’è una variabile più restrittiva, `DISABLE_UPDATES`. Si usa quando distribuisci Claude Code tramite un tuo canale e vuoi che gli utenti mantengano esattamente la build che hai fornito. Per l’uso personale normale è meglio non modificare queste variabili: una versione recente di Claude Code è quasi sempre migliore di una vecchia e un aggiornamento può includere una correzione di sicurezza. Mantenere aggiornato lo strumento aiuta a conservare l’accesso e a evitare bug insoliti; un articolo separato spiega [come evitare di perdere il tuo account Claude](https://ailoot.ai/blog/it/claude-account-suspension-appeal/). ## Da dove dovresti iniziare?
Punto chiave Inizia controllando la versione con claude --version e confrontandola con l’ultimo numero nel changelog. Se hai fatto un’installazione nativa, aggiorna con claude update e riavvia la sessione. Se hai installato Claude Code tramite Homebrew o WinGet, esegui il comando di aggiornamento del gestore di pacchetti. Se la versione non cambia, esegui claude doctor e which -a claude per verificare la presenza di conflitti dovuti a installazioni multiple. Infine, scegli quale canale usare: latest per le funzionalità più nuove, stable per stare tranquillo.
Ecco un breve piano. 1. Controlla la versione attuale: `claude --version`. Confrontala con l’ultimo numero nel changelog. 2. Aggiorna. Installazione nativa: `claude update`. Homebrew: `brew upgrade claude-code`. WinGet: `winget upgrade Anthropic.ClaudeCode`. 3. Riavvia la sessione di Claude Code affinché la nuova versione diventi effettiva. 4. Se la versione non è cambiata, esegui `claude doctor` e `which -a claude`. Probabilmente hai più installazioni oppure una cartella npm non scrivibile. 5. Scegli il canale più adatto: `latest` se vuoi le nuove funzionalità appena arrivano oppure `stable` se per te conta di più la prevedibilità. Cambialo tramite `/config`. Una versione recente corregge bug e aggiunge nuovi comandi, ma uno strumento aggiornato non costruirà il tuo progetto al posto tuo. La guida alle [alternative a Claude Code](https://ailoot.ai/blog/it/claude-code-alternatives/) spiega in cosa Claude Code differisce dagli altri agenti da terminale e quando può avere senso valutare delle alternative.
### Fonti - [Claude Code - Configurazione avanzata, documentazione ufficiale](https://docs.claude.com/en/docs/claude-code/setup) - aggiornamenti automatici per le installazioni native, il comando claude update, i canali latest e stable, le impostazioni autoUpdatesChannel e minimumVersion, DISABLE_AUTOUPDATER, installazione di una versione specifica - [Claude Code - Risoluzione dei problemi di installazione, documentazione ufficiale](https://docs.claude.com/en/docs/claude-code/troubleshoot-install) - conflitti tra installazioni multiple, which -a claude, permessi della cartella npm, launcher personalizzati, blocco di claude update - [Claude Code - CHANGELOG su GitHub](https://github.com/anthropics/claude-code/blob/main/CHANGELOG.md) - elenco delle versioni e delle modifiche in ogni build; dove controllare l’ultimo numero
Scopri [Ailoot](https://ailoot.ai/). ## Domande frequenti ### Perché claude update continua ad avviare il mio vecchio wrapper? L’aggiornamento nativo conserva un launcher personalizzato, quindi quel wrapper continua a scegliere il programma. Salva wrapper e destinazione prima di ripararlo; usa l’installer nativo documentato anziché eliminare l’unico comando e richiamarlo subito dopo. ### Come verifico che il recupero del launcher sia riuscito? Apri un nuovo terminale ed esegui claude --version: deve stampare un numero di versione. Poi usa claude doctor per esaminare installazione e avvisi sul launcher. Se il comando manca, correggi PATH prima di continuare. ## Ailoot · L’azienda e il suo portafoglio di progetti Ailoot si basa su un’esperienza operativa consolidata, un’ampia base di clienti, un servizio stabile e un controllo costante dei KPI. L’azienda e il suo portafoglio di progetti: milioni di clienti; vendite nell’ordine dei miliardi ogni mese. Ailoot mette questa esperienza operativa al servizio dell’accesso API alle funzioni AI nei prodotti dei clienti, negli agenti, nelle applicazioni e nelle automazioni.