Claude Code: "claude" non trovato su Windows

In breve: su Windows, il programma di installazione di Claude Code mette claude.exe in %USERPROFILE%\.local\bin ma non sempre aggiunge quella cartella al tuo PATH — così digitando claude compare “‘claude’ non è riconosciuto…” e non riesci ad accedere né a collegarlo. Risolvi in uno di due modi: eseguilo una volta dalla sua cartella per accedere subito, poi aggiungi quella cartella al PATH in modo che funzioni ovunque.

Nota

Qui si parla del comando claude in sé che non parte su Windows — il passaggio prima di collegarlo a Thunderbird. Se invece claude funziona nel tuo terminale ma atbridge non riesce a trovarlo quando lo colleghi, vedi Quando atbridge non trova la tua IA da riga di comando.

Perché succede

I programmi di Windows sono eseguibili per nome solo se la loro cartella è nel tuo PATH. Il programma di installazione di Claude Code viene completato con successo e deposita claude.exe in %USERPROFILE%\.local\bin, ma non sempre mette quella cartella nel PATH del tuo utente — così un terminale appena aperto non sa dove si trova claude. È un passaggio comune e previsto, non un’installazione difettosa. (Anthropic lo documenta come il caso “command not found” dopo l’installazione.)

Installato invece con npm?

Se hai installato Claude Code con npm install -g @anthropic-ai/claude-code, il comando si trova nella cartella del tuo prefix di npm anziché in .local\bin. Individuala con npm config get prefix e usa quel percorso al posto di %USERPROFILE%\.local\bin in tutti i passaggi qui sotto.

Come risolvere

1. Eseguilo una volta dalla sua cartella — per accedere subito. Apri PowerShell ed esegui:

   cd $env:USERPROFILE\.local\bin
   .\claude

   Questo avvia Claude Code anche se non è ancora nel PATH, così puoi accedere con il tuo account. (Preferisci sistemare prima il PATH? Fai il passaggio 2, apri un nuovo terminale, poi esegui semplicemente claude.)

2. Aggiungi la cartella al tuo PATH — così claude funziona ovunque.

   PowerShell

   $p = [Environment]::GetEnvironmentVariable('PATH', 'User')
   [Environment]::SetEnvironmentVariable('PATH', "$p;$env:USERPROFILE\.local\bin", 'User')

   Questo aggiorna definitivamente il PATH del tuo utente. Poi chiudi e riapri il terminale in modo che recepisca la modifica.

   Impostazioni (GUI)

   Premi Start, digita “variabili di ambiente” e apri Modifica le variabili di ambiente del sistema → Variabili d’ambiente…. In Variabili dell’utente, seleziona Path → Modifica → Nuovo e aggiungi:

   %USERPROFILE%\.local\bin

   Fai clic su OK in ogni finestra, poi chiudi e riapri il terminale.

3. Verifica. Apri un terminale nuovo ed esegui:

   claude --version

   Una stringa di versione significa che Windows ora trova claude. claude doctor stampa un controllo di integrità in sola lettura se vuoi confermare l’installazione.

Attenzione

Le modifiche al PATH si applicano solo ai terminali appena aperti — la finestra in cui l’hai modificato non vedrà la modifica. Apri un nuovo PowerShell o Prompt dei comandi prima di fare la prova.

Poi collegalo in Thunderbird

Una volta che claude funziona in un terminale e hai effettuato l’accesso almeno una volta, collegalo come IA dietro la Chat IA di atbridge — scegli Claude Code CLI in atbridge Impostazioni → Provider IA. Passaggi completi: Collegare un abbonamento CLI.

Se atbridge continua a non vederlo dopo questo, si tratta del rilevamento lato atbridge — un solo comando lo risolve: Quando atbridge non trova la tua IA da riga di comando.

Dove andare adesso

• Collegare un abbonamento CLI
• Quando atbridge non trova la tua IA da riga di comando
• Windows blocca atbridge (SmartScreen)

Più veloce: chiedi alla community

Per le domande del tipo «come faccio a…» di solito otterrai una risposta più rapida — e aiuterai la prossima persona con la stessa domanda — su Discord. Qualsiasi cosa legata al tuo account, alla fatturazione o a un bug è meglio inviarla come ticket di supporto, dove rispondiamo via email.