Questi dieci problemi rappresentano la stragrande maggioranza dei ticket di supporto relativi all'installazione e all'autenticazione di Claude Code. Ogni voce include la soluzione più affidabile.
1. claude: command not found subito dopo l'installazione.
L'installer ha aggiunto claude al tuo PATH, ma la shell corrente non l'ha ancora riconosciuto. Apri un nuovo terminale oppure esegui source ~/.zshrc (o ~/.bashrc). Su Windows, chiudi e riapri PowerShell.
2. npm install fallisce con EACCES / permesso negato.
Questo di solito significa che l'installazione è stata eseguita con sudo, oppure la tua directory npm globale è di proprietà di root. Non usare sudo. Invece, usa l'installer curl, oppure correggi il prefisso di npm con npm config set prefix ~/.npm-global e aggiungi quella directory bin al tuo PATH.
3. "Versione di Node non supportata" o arresto silenzioso all'avvio.
Claude Code richiede Node 18 o versione successiva. Controlla la tua versione con node -v. Se è più vecchia, installa una versione attuale tramite nvm install --lts, oppure usa l'installer curl, che include il suo runtime e evita completamente questo problema.
4. WSL: claude esegue il Node di Windows invece del Node di Linux.
Il PATH di Windows si infiltra in WSL e sostituisce nvm. Anteponi il tuo node Linux al PATH in ~/.bashrc: export PATH="$HOME/.nvm/versions/node/$(nvm current)/bin:$PATH"
5. L'installer si blocca o fallisce dietro una rete aziendale.
L'host di download (storage.googleapis.com) è probabilmente bloccato. Imposta prima il tuo proxy con export HTTPS_PROXY=http://your-proxy:port, quindi esegui di nuovo l'installer. Se non è possibile, chiedi al tuo team IT il pacchetto offline.
6. SELF_SIGNED_CERT_IN_CHAIN o altri errori TLS.
La tua azienda inietta il proprio certificato. Indirizza Node al bundle CA aziendale: export NODE_EXTRA_CA_CERTS=/path/to/company-ca.pem Aggiungilo al tuo profilo shell in modo che persista.
7. /login apre un browser ma il terminale non finisce mai ("In attesa di autenticazione…").
Questo di solito significa che il callback localhost è bloccato, il che è comune su SSH remoto, in devcontainer o dietro un firewall rigoroso. Usa invece il flusso manuale: copia l'URL stampato nel terminale, completa l'accesso in qualsiasi browser, quindi incolla il codice restituito nel terminale.
8. "Non autenticato" anche se hai impostato ANTHROPIC_API_KEY.
Ci sono tre cause comuni: la chiave è stata esportata in una shell diversa (esegui echo $ANTHROPIC_API_KEY per verificare), hai precedentemente eseguito /login e la sessione OAuth ha la precedenza (esegui prima /logout), oppure la chiave è una chiave Console ma la tua organizzazione richiede invece l'accesso SSO.
9. Bedrock / Vertex: "Impossibile caricare le credenziali."
Claude Code utilizza gli SDK del provider standard, quindi la soluzione è la stessa di qualsiasi strumento CLI AWS/GCP. Per Bedrock, conferma che aws sts get-caller-identity funziona e che AWS_REGION è impostato su una regione in cui il tuo modello è abilitato. Per Vertex, conferma che gcloud auth application-default login è stato eseguito e che GOOGLE_CLOUD_PROJECT è impostato.
10. È stato installato e autenticato, ma ogni richiesta genera un errore 403 / "modello non disponibile."
Il tuo account esiste ma non ha accesso al modello che Claude Code sta richiedendo. Per i posti Enterprise, conferma che il tuo posto è attivo nelle impostazioni di amministrazione della tua organizzazione. Su Bedrock o Vertex, conferma che il modello Claude specifico è abilitato in quella regione o progetto. Come soluzione rapida, esegui /model e seleziona un modello a cui sai di avere accesso.
Ancora bloccato?
Esegui claude doctor dalla tua shell normale (non da una sessione Claude). Stampa un rapporto diagnostico che puoi allegare a un ticket di supporto.