Scopri soluzioni ai problemi comuni con l’installazione e l’uso di Claude Code.
npm
di Windows. Prova:
npm config set os linux
prima dell’installazionenpm install -g @anthropic-ai/claude-code --force --no-os-check
(NON usare sudo
)exec: node: not found
quando esegui claude
, il tuo ambiente WSL potrebbe utilizzare un’installazione Windows di Node.js. Puoi confermarlo con which npm
e which node
, che dovrebbero puntare a percorsi Linux che iniziano con /usr/
piuttosto che /mnt/c/
. Per risolvere questo, prova a installare Node tramite il gestore di pacchetti della tua distribuzione Linux o tramite nvm
.
Conflitti di versione nvm: Se hai nvm installato sia in WSL che in Windows, potresti riscontrare conflitti di versione quando cambi versioni Node in WSL. Questo accade perché WSL importa il PATH di Windows per impostazione predefinita, causando che nvm/npm di Windows abbiano priorità sull’installazione WSL.
Puoi identificare questo problema:
which npm
e which node
- se puntano a percorsi Windows (che iniziano con /mnt/c/
), vengono utilizzate le versioni Windows~/.bashrc
, ~/.zshrc
, ecc.):
appendWindowsPath = false
) poiché questo interrompe la capacità di chiamare facilmente eseguibili Windows da WSL. Allo stesso modo, evita di disinstallare Node.js da Windows se lo usi per lo sviluppo Windows.PATH
potrebbero impedire l’accesso a claude
.
Potresti anche incontrare errori di permessi se il tuo prefisso globale npm non è scrivibile dall’utente (es. /usr
, o /usr/local
).
~/.local/bin/claude
.
~/.claude/local/
e imposta un alias nella configurazione della tua shell. Non è richiesto sudo
per aggiornamenti futuri.
Dopo la migrazione, riavvia la tua shell, e poi verifica la tua installazione:
Su macOS/Linux/WSL:
/permissions
. Vedi Documentazione Permessi.
/logout
per disconnetterti completamenteclaude
e completa nuovamente il processo di autenticazione/compact
regolarmente per ridurre la dimensione del contesto.gitignore
@file
, gli agenti personalizzati e i comandi slash personalizzati non funzionano, installa ripgrep
di sistema:
USE_BUILTIN_RIPGREP=0
nel tuo ambiente.
/doctor
mostrerà Search come OK in questo caso./home/
) piuttosto che nel filesystem Windows (/mnt/c/
).
.wslconfig
nella tua directory utente Windows:
wsl --shutdown
da PowerShell.
prettier
o script di formattazione personalizzati sui file markdown generati.
/bug
all’interno di Claude Code per segnalare problemi direttamente ad Anthropic/doctor
per controllare la salute della tua installazione Claude Code