​
Problemi comuni di installazione

​
Problemi di permessi su Linux

Durante l’installazione di Claude Code con npm, potresti incontrare errori di permessi se il prefisso globale di npm non è scrivibile dall’utente (es. /usr, o /usr/local).

​
Soluzione raccomandata: Creare un prefisso npm scrivibile dall’utente

L’approccio più sicuro è configurare npm per utilizzare una directory all’interno della tua cartella home:

# Prima, salva un elenco dei tuoi pacchetti globali esistenti per la migrazione successiva
npm list -g --depth=0 > ~/npm-global-packages.txt

# Crea una directory per i tuoi pacchetti globali
mkdir -p ~/.npm-global

# Configura npm per utilizzare il nuovo percorso della directory
npm config set prefix ~/.npm-global

# Nota: Sostituisci ~/.bashrc con ~/.zshrc, ~/.profile, o altro file appropriato per la tua shell
echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.bashrc

# Applica la nuova impostazione PATH
source ~/.bashrc

# Ora reinstalla Claude Code nella nuova posizione
npm install -g @anthropic-ai/claude-code

# Opzionale: Reinstalla i tuoi precedenti pacchetti globali nella nuova posizione
# Guarda ~/npm-global-packages.txt e installa i pacchetti che vuoi mantenere

Questa soluzione è raccomandata perché:

  • Evita di modificare i permessi delle directory di sistema
  • Crea una posizione pulita e dedicata per i tuoi pacchetti npm globali
  • Segue le migliori pratiche di sicurezza

​
Recupero del Sistema: Se hai eseguito comandi che modificano la proprietà e i permessi dei file di sistema o simili

Se hai già eseguito un comando che ha modificato i permessi delle directory di sistema (come sudo chown -R $USER:$(id -gn) /usr && sudo chmod -R u+w /usr) e il tuo sistema ora è danneggiato (per esempio, se vedi sudo: /usr/bin/sudo must be owned by uid 0 and have the setuid bit set), dovrai eseguire i passaggi di recupero.

Metodo di Recupero Ubuntu/Debian:

  1. Durante il riavvio, tieni premuto SHIFT per accedere al menu GRUB

  2. Seleziona “Opzioni avanzate per Ubuntu/Debian”

  3. Scegli l’opzione modalità di recupero

  4. Seleziona “Passa alla shell root”

  5. Rimonta il filesystem come scrivibile:

    mount -o remount,rw /

  6. Correggi i permessi:

    # Ripristina la proprietà root
chown -R root:root /usr
chmod -R 755 /usr

# Assicurati che /usr/local sia di proprietà del tuo utente per i pacchetti npm
chown -R TUO_USERNAME:TUO_USERNAME /usr/local

# Imposta il bit setuid per i binari critici
chmod u+s /usr/bin/sudo
chmod 4755 /usr/bin/sudo
chmod u+s /usr/bin/su
chmod u+s /usr/bin/passwd
chmod u+s /usr/bin/newgrp
chmod u+s /usr/bin/gpasswd
chmod u+s /usr/bin/chsh
chmod u+s /usr/bin/chfn

# Correggi la configurazione sudo
chown root:root /usr/libexec/sudo/sudoers.so
chmod 4755 /usr/libexec/sudo/sudoers.so
chown root:root /etc/sudo.conf
chmod 644 /etc/sudo.conf

  7. Reinstalla i pacchetti interessati (opzionale ma raccomandato):

    # Salva l'elenco dei pacchetti installati
dpkg --get-selections > /tmp/installed_packages.txt

# Reinstallali
awk '{print $1}' /tmp/installed_packages.txt | xargs -r apt-get install --reinstall -y

  8. Riavvia:

    reboot
Metodo Alternativo di Recupero con Live USB:

Se la modalità di recupero non funziona, puoi utilizzare una Live USB:

  1. Avvia da una Live USB (Ubuntu, Debian o qualsiasi distribuzione Linux)

  2. Trova la tua partizione di sistema:

    lsblk

  3. Monta la tua partizione di sistema:

    sudo mount /dev/sdXY /mnt  # sostituisci sdXY con la tua partizione di sistema effettiva

  4. Se hai una partizione boot separata, montala anche:

    sudo mount /dev/sdXZ /mnt/boot  # se necessario

  5. Fai chroot nel tuo sistema:

    # Per Ubuntu/Debian:
sudo chroot /mnt

# Per sistemi basati su Arch:
sudo arch-chroot /mnt

  6. Segui i passaggi 6-8 dal metodo di recupero Ubuntu/Debian sopra

Dopo aver ripristinato il sistema, segui la soluzione raccomandata sopra per configurare un prefisso npm scrivibile dall’utente.

​
Problemi con l’auto-aggiornamento

Se Claude Code non può aggiornarsi automaticamente, potrebbe essere dovuto a problemi di permessi con la directory del prefisso globale npm. Segui la soluzione raccomandata sopra per risolvere questo problema.

Se preferisci invece disabilitare l’auto-aggiornamento, puoi utilizzare:

claude config set -g autoUpdaterStatus disabled

​
Permessi e autenticazione

​
Richieste ripetute di permessi

Se ti trovi a dover approvare ripetutamente gli stessi comandi, puoi consentire a strumenti specifici di essere eseguiti senza approvazione:

# Permetti a npm test di essere eseguito senza approvazione
claude config add allowedTools "Bash(npm test)"

# Permetti a npm test e a tutti i suoi sotto-comandi di essere eseguiti senza approvazione
claude config add allowedTools "Bash(npm test:*)"

​
Problemi di autenticazione

Se stai riscontrando problemi di autenticazione:

  1. Esegui /logout per disconnetterti completamente
  2. Chiudi Claude Code
  3. Riavvia con claude e completa nuovamente il processo di autenticazione

Se i problemi persistono, prova:

rm -rf ~/.config/claude-code/auth.json
claude

Questo rimuove le tue informazioni di autenticazione memorizzate e forza un nuovo login pulito.

​
Prestazioni e stabilità

​
Utilizzo elevato di CPU o memoria

Claude Code è progettato per funzionare con la maggior parte degli ambienti di sviluppo, ma può consumare risorse significative quando elabora grandi basi di codice. Se stai riscontrando problemi di prestazioni:

  1. Usa /compact regolarmente per ridurre la dimensione del contesto
  2. Chiudi e riavvia Claude Code tra le attività principali
  3. Considera di aggiungere grandi directory di build ai tuoi file .gitignore e .claudeignore

​
Comandi bloccati o congelati

Se Claude Code sembra non rispondere:

  1. Premi Ctrl+C per tentare di annullare l’operazione corrente
  2. Se non risponde, potrebbe essere necessario chiudere il terminale e riavviare
  3. Per problemi persistenti, esegui Claude con logging dettagliato: claude --verbose

​
Ottenere ulteriore aiuto

Se stai riscontrando problemi non trattati qui:

  1. Usa il comando /bug all’interno di Claude Code per segnalare problemi direttamente ad Anthropic
  2. Controlla il repository GitHub per problemi noti
  3. Esegui /doctor per controllare lo stato della tua installazione di Claude Code

Was this page helpful?

Tutorial su Claude CodeUso del computer (beta)