​
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 flussi di lavoro PR (opzionale)
  • Rete: Connessione Internet richiesta per autenticazione e elaborazione AI
  • Posizione: Disponibile solo nei paesi supportati

​
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

cd your-project-directory
3

Avvia Claude Code

claude
4

Completa l'autenticazione

Claude Code offre multiple opzioni di autenticazione:

  1. Anthropic Console: L’opzione predefinita. Connettiti tramite la Console Anthropic e completa il processo OAuth. Richiede fatturazione attiva su console.anthropic.com.
  2. Claude App (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

claude
2

Esegui un comando semplice

> summarize this project
3

Genera una guida progetto CLAUDE.md

/init
4

Committa il file CLAUDE.md generato

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

​
Risoluzione dei problemi

​
Risoluzione dei problemi di installazione WSL

Attualmente, Claude Code non funziona direttamente in Windows, e invece richiede WSL.

Potresti incontrare i seguenti problemi in WSL:

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)

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.

​
Ottimizza la configurazione del tuo terminale

Claude Code funziona meglio quando il tuo terminale è configurato correttamente. Segui queste linee guida per ottimizzare la tua esperienza.

Shell supportate:

  • Bash
  • Zsh
  • Fish

​
Temi e aspetto

Claude non può controllare il tema del tuo terminale. Questo è gestito dalla tua applicazione terminale. Puoi abbinare il tema di Claude Code al tuo terminale durante l’onboarding o in qualsiasi momento tramite il comando /config

​
Interruzioni di riga

Hai diverse opzioni per inserire interruzioni di riga in Claude Code:

  • Escape rapido: Digita \ seguito da Invio per creare una nuova riga
  • Scorciatoia da tastiera: Premi Option+Invio (Meta+Invio) con la configurazione appropriata

Per configurare Option+Invio nel tuo terminale:

Per Mac Terminal.app:

  1. Apri Impostazioni → Profili → Tastiera
  2. Spunta “Usa Option come tasto Meta”

Per iTerm2 e terminale VSCode:

  1. Apri Impostazioni → Profili → Tasti
  2. Sotto Generale, imposta il tasto Option Sinistro/Destro su “Esc+”

Suggerimento per utenti iTerm2 e VSCode: Esegui /terminal-setup all’interno di Claude Code per configurare automaticamente Shift+Invio come alternativa più intuitiva.

​
Configurazione notifiche

Non perdere mai quando Claude completa un’attività con la configurazione appropriata delle notifiche:

​
Notifiche campanello terminale

Abilita avvisi sonori quando le attività si completano:

claude config set --global preferredNotifChannel terminal_bell

Per utenti macOS: Non dimenticare di abilitare i permessi di notifica in Impostazioni di Sistema → Notifiche → [La Tua App Terminale].

​
Notifiche di sistema iTerm 2

Per avvisi iTerm 2 quando le attività si completano:

  1. Apri le Preferenze di iTerm 2
  2. Naviga a Profili → Terminale
  3. Abilita “Silenzia campanello” e Filtra Avvisi → “Invia avvisi generati da sequenza di escape”
  4. Imposta il tuo ritardo di notifica preferito

Nota che queste notifiche sono specifiche per iTerm 2 e non sono disponibili nel Terminale macOS predefinito.

​
Gestione di input grandi

Quando lavori con codice esteso o istruzioni lunghe:

  • Evita incollaggio diretto: Claude Code potrebbe avere difficoltà con contenuto incollato molto lungo
  • Usa flussi di lavoro basati su file: Scrivi il contenuto in un file e chiedi a Claude di leggerlo
  • Sii consapevole delle limitazioni di VS Code: Il terminale VS Code è particolarmente incline a troncare incolli lunghi

​
Modalità Vim

Claude Code supporta un sottoinsieme di keybinding Vim che può essere abilitato con /vim o configurato tramite /config.

Il sottoinsieme supportato include:

  • Cambio modalità: Esc (a NORMALE), i/I, a/A, o/O (a INSERIMENTO)
  • Navigazione: h/j/k/l, w/e/b, 0/$/^, gg/G
  • Modifica: x, dw/de/db/dd/D, cw/ce/cb/cc/C, . (ripeti)