Guida Installazione Claude Code: Script irm, Setup npm e Script https://claude.ai/install.ps1

Introduzione

Claude Code e il mio strumento da riga di comando preferito per il coding assistito dall'AI. Che tu sia su Windows, macOS o Linux, l'installazione e semplice con diverse opzioni:

• Binario Nativo (Raccomandato): curl -fsSL https://claude.ai/install.sh | bash per Linux/macOS
• Windows PowerShell: irm https://claude.ai/install.ps1 | iex per utenti Windows
• Installazione Globale npm: npm install -g @anthropic-ai/claude-code per ambienti Node.js

Questa guida copre ogni metodo di installazione in dettaglio, piu il troubleshooting con il comando claude doctor per diagnosticare e risolvere problemi comuni.

Raccomandato: Binario Nativo

Dal 2025, ci sono diversi runtime in cui Claude e disponibile, inclusi node.js e bun.js. Anthropic raccomanda l'installazione del binario nativo. Questo metodo evita conflitti del package manager ed e il piu stabile.

Installare il Binario Nativo

1. Esegui lo script di installazione:

   curl -fsSL https://claude.ai/install.sh | bash

2. Ricarica la configurazione della tua shell:

   source ~/.bashrc
   # o per utenti zsh:
   source ~/.zshrc

3. Verifica l'installazione:

   claude --version
   claude doctor

E tutto! Claude Code dovrebbe ora essere installato in ~/.claude/bin/claude o ~/.local/bin/claude.

Troubleshooting: Risolvere Installazioni Problematiche

Se stai riscontrando problemi con Claude Code come errori di segmentation fault, probabilmente hai un'installazione mista o obsoleta. Se usi Claude dall'inizio come me, potresti avere versioni node.js o bun.js installate. Ecco come risolvere:

Diagnostica la Tua Installazione Attuale con claude doctor

Il comando claude doctor e il tuo primo stop per il troubleshooting. Analizza la tua installazione e riporta potenziali problemi.

claude doctor

Cosa Controlla claude doctor

Il comando claude doctor ispeziona:

• Metodo di installazione: Binario nativo, npm, Bun, o Homebrew
• Informazioni versione: Versione attuale e stato aggiornamenti
• Capacita auto-aggiornamento: Se gli aggiornamenti possono essere applicati
• Funzionalita di ricerca: Se ripgrep e correttamente bundled/installato
• Configurazione PATH: Se Claude e nel tuo PATH correttamente
• Percorso di esecuzione: L'effettivo binario in esecuzione

Output Problematici Comuni

Fai attenzione a questi segnali di avvertimento nell'output di claude doctor:

• unknown (2.0.0) - Rilevamento versione fallito, probabilmente installazione mista
• Percorsi misti tra Bun, npm e Node.js
• Percorso di invocazione diverso dal percorso di esecuzione
• Auto-aggiornamenti disabilitati o falliti
• Stato ricerca che mostra errori

Controlla anche installazioni multiple che potrebbero essere in conflitto:

which -a claude

Rimuovi TUTTE le Installazioni Esistenti

# Rimuovi installazione Bun
bun uninstall -g @anthropic-ai/claude-code
rm -f ~/.bun/bin/claude

# Rimuovi installazione npm/Node.js
npm uninstall -g @anthropic-ai/claude-code

# Rimuovi installazioni specifiche nvm
# Controlla ogni versione Node nvm che hai
nvm list
# Per ogni versione, passa ad essa e disinstalla
nvm use <version>
npm uninstall -g @anthropic-ai/claude-code

Disinstallazione Brew di Claude Code

Se hai installato Claude Code via Homebrew:

# Disinstalla Claude Code da Homebrew
brew uninstall claude-code

# Pulisci eventuali file in cache
brew cleanup claude-code

Dopo la disinstallazione via brew, puoi passare all'installazione del binario nativo per un miglior supporto auto-aggiornamento.

Step 3: Pulisci Configurazione e Cache

Rimuovi eventuali file di configurazione residui:

# Rimuovi directory config Claude Code
rm -rf ~/.claude-code
rm -rf ~/.config/claude-code
rm -rf ~/.cache/claude-code

Step 4: Installazione Fresca del Binario Nativo

Ora installa il binario nativo:

curl -fsSL https://claude.ai/install.sh | bash

Step 5: Verifica la Correzione

Dopo l'installazione, verifica che tutto funzioni:

# Controlla versione
claude --version

# Esegui diagnostica
claude doctor

Un'installazione sana dovrebbe mostrare:

• Version: native (2.0.x o superiore)
• Config install method: native
• Auto-updates: enabled
• Search: OK (bundled)

Metodi di Installazione Alternativi

Mentre il binario nativo e raccomandato, ecco altre opzioni:

Installazione npm: npm install -g @anthropic-ai/claude-code

Se preferisci usare npm (Node Package Manager), puoi installare Claude Code globalmente. Questo metodo richiede Node.js 18 o superiore.

npm install -g @anthropic-ai/claude-code

Cosa Fa npm install -g

Il flag -g installa il pacchetto globalmente, rendendo claude disponibile come comando ovunque nel tuo terminale. Il pacchetto @anthropic-ai/claude-code e il pacchetto npm ufficiale mantenuto da Anthropic.

Benefici dell'installazione npm:

• Workflow familiare per sviluppatori Node.js
• Facile da gestire insieme ad altri pacchetti globali
• Funziona bene in ambienti containerizzati/CI

Svantaggi:

• Richiede runtime Node.js
• Potrebbe essere in conflitto con altri package manager (Bun, pnpm)
• Gli aggiornamenti richiedono npm update -g @anthropic-ai/claude-code manuale

Importante: Non usare mai sudo npm install -g perche causa problemi di permessi. Se ottieni errori EACCES, correggi i permessi npm invece.

Installazione Versione Specifica

Per installare una versione specifica del binario nativo:

# Installa versione piu recente
curl -fsSL https://claude.ai/install.sh | bash -s latest

# Installa versione specifica
curl -fsSL https://claude.ai/install.sh | bash -s 2.0.22

Istruzioni Specifiche per Piattaforma

macOS con Homebrew

brew install claude-code

Nota: Le installazioni Homebrew si auto-aggiornano indipendentemente dalla directory brew.

Windows: Usando irm https://claude.ai/install.ps1 | iex

Per utenti Windows, hai tre opzioni:

1. WSL (Raccomandato): Installa WSL e segui le istruzioni Linux
2. Git Bash: Usa l'installer nativo con Git Bash
3. PowerShell (Windows Nativo):

   irm https://claude.ai/install.ps1 | iex

Capire il Comando irm

Il comando irm e Invoke-RestMethod di PowerShell, che scarica contenuto da un URL. Ecco cosa fa il comando:

• irm https://claude.ai/install.ps1 - Scarica lo script di installazione dai server di Anthropic
• | iex - Passa lo script a Invoke-Expression, che lo esegue

Lo script https://claude.ai/install.ps1 gestisce:

• Rilevamento della tua architettura Windows (x64, ARM64)
• Download del binario Claude Code appropriato
• Installazione nella tua directory utente
• Aggiunta di Claude alla tua variabile d'ambiente PATH

Nota sulla Sicurezza: Verifica sempre di star scaricando dal dominio ufficiale claude.ai prima di eseguire script di installazione.

Alpine Linux

Alpine e altre distribuzioni basate su musl necessitano dipendenze aggiuntive:

apk add libgcc libstdc++ ripgrep
export USE_BUILTIN_RIPGREP=0
curl -fsSL https://claude.ai/install.sh | bash

Setup Post-Installazione

Autenticazione

Dopo l'installazione, autentica Claude Code:

claude

Ti verra chiesto di scegliere il tuo metodo di autenticazione:

• Claude Console (default): Per accesso API con fatturazione su console.anthropic.com
• Claude Pro/Max: Se hai un abbonamento Claude
• Enterprise: Per deployment AWS Bedrock o Google Vertex AI

Uso Base

Inizia a usare Claude Code:

# Naviga al tuo progetto
cd /path/to/your/project

# Avvia Claude Code
claude

# Ottieni aiuto
claude help

# All'interno di una sessione, usa comandi slash
/help    # Mostra comandi disponibili
/clear   # Pulisci conversazione
/exit    # Esci da Claude Code

Gestione Aggiornamenti

Auto-Aggiornamenti

Claude Code si aggiorna automaticamente per default. Gli aggiornamenti sono controllati all'avvio e applicati in background.

Come aggiornare Claude Code

claude update

Aggiungi questo al tuo .bashrc o .zshrc per renderlo permanente.

Problemi Comuni e Soluzioni

Problema: "Insufficient permissions to install update"

Questo succede tipicamente con installazioni npm/Bun. Soluzione: Passa all'installazione del binario nativo.

Problema: "command not found: claude"

Il PATH non e stato aggiornato. Aggiungi alla configurazione della tua shell:

echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bashrc
source ~/.bashrc

Problema: Funzionalita di ricerca non funzionante

Di solito risolto dall'installazione nativa, ma se persiste:

# Installa ripgrep manualmente
sudo apt-get install ripgrep  # Ubuntu/Debian
brew install ripgrep          # macOS

Best Practice

1. Usa sempre il binario nativo a meno che tu non abbia requisiti specifici
2. Evita sudo con qualsiasi metodo di installazione
3. Mantieni gli auto-aggiornamenti abilitati per sicurezza e funzionalita
4. Esegui claude doctor dopo ogni installazione o aggiornamento
5. Pulisci le vecchie installazioni prima di installare nuove versioni

Conclusione

Ricorda: quando hai dubbi, rimuovi tutto e ricomincia da zero con il binario nativo. E il modo piu semplice, veloce e affidabile per eseguire Claude Code.

Letture Correlate

Ora che hai Claude Code installato, mettilo al lavoro:

• Costruisci un Carrello con Flask - Un tutorial pratico dove puoi usare Claude Code per costruire un backend e-commerce completo con Python e Flask

Riferimento Rapido

• Installa: curl -fsSL https://claude.ai/install.sh | bash
• Controlla versione: claude --version
• Diagnostica: claude doctor
• Aggiorna: claude update
• Avvia: claude
• Aiuto: claude help