Verifica i requisiti di sistema

  • Sistemi operativi: macOS 10.15+, Ubuntu 20.04+/Debian 10+, o Windows tramite WSL
  • Hardware: 4GB RAM minimo
  • Software:
    • Node.js 18+
    • git 2.23+ (opzionale)
    • GitHub o GitLab CLI per i flussi di lavoro PR (opzionale)
  • Rete: Connessione Internet richiesta per l’autenticazione e l’elaborazione AI
  • Posizione: Disponibile solo nei paesi supportati

Risoluzione dei problemi di installazione WSL

Attualmente, Claude Code non funziona direttamente in Windows e richiede invece WSL. Se riscontri problemi in WSL:

  1. Problemi di rilevamento OS/piattaforma: Se ricevi un errore durante l’installazione, WSL potrebbe utilizzare npm di Windows. Prova:

    • Esegui npm config set os linux prima dell’installazione
    • Installa con npm install -g @anthropic-ai/claude-code --force --no-os-check (NON utilizzare sudo)
  2. Errori Node non trovato: Se vedi 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.

Installa e autentica

1

Installa Claude Code

Install NodeJS 18+, then run:

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

Do NOT use sudo npm install -g as this can lead to permission issues and security risks. If you encounter permission errors, see configure Claude Code for recommended solutions.

2

Naviga al tuo progetto

bash cd your-project-directory

3

Avvia Claude Code

bash claude
4

Completa l'autenticazione

Claude Code offre multiple opzioni di autenticazione: 1. Console Anthropic: L’opzione predefinita. Connettiti tramite la Console Anthropic e completa il processo OAuth. Richiede fatturazione attiva su console.anthropic.com. 2. App Claude (con piano Pro o Max): Iscriviti al piano Pro o Max di Claude per un abbonamento unificato che include sia Claude Code che l’interfaccia web. Ottieni più valore allo stesso prezzo gestendo il tuo account in un unico posto. Accedi con il tuo account Claude.ai. Durante il lancio, scegli l’opzione che corrisponde al tuo tipo di abbonamento. 3. Piattaforme enterprise: Configura Claude Code per utilizzare Amazon Bedrock o Google Vertex AI per distribuzioni enterprise con la tua infrastruttura cloud esistente.

Inizializza il tuo progetto

Per gli utenti alle prime armi, raccomandiamo:

1

Avvia Claude Code

bash claude
2

Esegui un comando semplice

bash summarize this project
3

Genera una guida progetto CLAUDE.md

bash /init
4

Committa il file CLAUDE.md generato

Chiedi a Claude di committare il file CLAUDE.md generato nel tuo repository.