Registrati

Configurazione e primo avvio

Configurare Claude Code

Nella masterclass «Agentic Coding» hai imparato a lavorare con gli agenti di coding, indipendentemente dallo strumento. In questo corso lo metti in pratica con Claude Code, l'agente di coding di Anthropic. Lo configuri, scopri dove si trovano in Claude Code i concetti della masterclass, lo imposti in modo sicuro e percorri passo dopo passo il progetto di esercitazione.

Aggiornato a ottobre 2026 Claude Code viene sviluppato di continuo, spesso ogni settimana. Questo corso descrive lo stato di ottobre 2026 e si basa sulla documentazione ufficiale su code.claude.com/docs. Se da te una schermata o un comando appare diverso, fa fede la documentazione. In Claude Code, /help ti mostra sempre i comandi attuali.

Cosa ti serve

  • Un abbonamento: Claude Code è incluso nei piani Pro, Max, Ultra, Team ed Enterprise di Anthropic. L'account gratuito non basta. In alternativa puoi pagare a consumo tramite la Claude Console. Per iniziare basta Pro (a ottobre 2026: 20 dollari americani al mese con fatturazione mensile). I prezzi attuali li trovi su claude.com/pricing.
  • Un computer: macOS 13 o successivo, oppure Windows 10 (versione 1809 o successiva) o Windows 11, almeno 4 GB di memoria RAM e una connessione a Internet.
  • Git per il progetto di esercitazione. Come verificare se Git è installato è spiegato nella lezione della masterclass «Ambiente di lavoro e concetti di base».

Due strade: app desktop o terminale

Claude Code esiste in diverse varianti. Due sono importanti per questo corso:

Consigliata per iniziare. L'app Claude per Mac e Windows ha un'area «Code». Lì scegli una cartella di progetto, chatti con Claude Code e vedi le modifiche come diff a colori. Non ti serve un terminale e non devi installare nient'altro.

  1. Scarica l'app da claude.com/download e installala.
  2. Accedi con il tuo account Anthropic.
  3. Clicca in alto su Code. Se l'app ti chiede un upgrade, non hai l'abbonamento giusto.

Più possibilità. Nel terminale avvii Claude Code con il comando claude. Questa variante supporta tutte le funzioni ed è la base della documentazione ufficiale. L'installazione richiede due minuti (vedi sotto).

L'app desktop e il terminale leggono gli stessi file di impostazioni e lo stesso CLAUDE.md. Puoi quindi passare dall'uno all'altro in qualsiasi momento.

Esistono anche estensioni per gli editor di codice Visual Studio Code e JetBrains, oltre a una versione web. I concetti di questo corso valgono ovunque.

Installare nel terminale

Apri il terminale (Mac: il programma «Terminale»; Windows: «PowerShell») e incolla il comando adatto. Proviene dalla documentazione ufficiale:

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

In alternativa con Homebrew: brew install --cask claude-code. Questa variante però non si aggiorna da sola.

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

Il comando è per PowerShell (il prompt inizia con PS C:\). Non ti servono diritti di amministratore. È consigliato anche «Git for Windows». Senza Git for Windows, Claude Code esegue i comandi con PowerShell.

Durante il download l'installer non mostra alcun avanzamento. Poi apri una nuova finestra del terminale e verifica:

claude --version

Se compare un numero di versione, è tutto pronto. Se il terminale segnala «command not found» o «non è riconosciuto», non trova ancora il programma. La documentazione descrive la soluzione in «Risoluzione dei problemi di installazione». Il comando claude doctor verifica l'installazione nel dettaglio.

Consiglio pratico: la versione installata in questo modo si aggiorna da sola in background. Non devi quindi occuparti degli aggiornamenti. Se preferisci una versione un po' più vecchia e collaudata, puoi scegliere il canale «stable» nelle impostazioni.

Primo avvio e accesso

  1. Nel terminale vai in una cartella di progetto, per esempio cd Progetti/hike-planner.
  2. Avvia Claude Code con claude.
  3. Al primo avvio si apre il browser per l'accesso. Accedi con il tuo account Anthropic. Se il browser non si apre, premi c per copiare il link di accesso.
  4. Claude Code chiede se ti fidi dei file in questa cartella. Conferma solo nelle cartelle di cui conosci la provenienza.

Poi vedi una riga di inserimento. Qui scrivi i tuoi incarichi in italiano, come in una chat. /status mostra versione, account e modello, /help tutti i comandi. Esci da Claude Code premendo due volte Ctrl+C o con il comando /exit.

Abbonamento, costi e protezione dei dati

Con un abbonamento paghi un prezzo mensile fisso. L'utilizzo è limitato entro finestre di tempo: se lavori molto, prima o poi raggiungi il limite e devi aspettare. /usage mostra quanta parte della tua quota è usata e cosa consuma di più. La fatturazione a consumo tramite la Claude Console è pensata per team e aziende. Lì puoi impostare limiti di spesa per ogni workspace.

Controlla l'impostazione sulla protezione dei dati Con i piani personali (Free, Pro, Max, Ultra) scegli se Anthropic può usare i tuoi dati per addestrare modelli futuri. Questo riguarda anche il codice che Claude Code legge. Se l'opzione è attiva, Anthropic può conservare i dati molto più a lungo e usarli per l'addestramento. Modifichi l'impostazione su claude.ai/settings/data-privacy-controls. Con i piani aziendali (Team, Enterprise) e con l'API, Anthropic dichiara di non usare i tuoi dati per l'addestramento. Se lavori con codice di clienti, chiarisci prima se il cliente è d'accordo e quale piano e quale impostazione sono adatti. Maggiori informazioni nel corso «IA & protezione dei dati in azienda».
Esercizio: configurazione e primo incarico
  1. Installa Claude Code come app desktop o nel terminale e accedi.
  2. Controlla l'impostazione sulla protezione dei dati del tuo account.
  3. Apri la cartella hike-planner del progetto di esercitazione della masterclass (app desktop: scegli la cartella; terminale: cd nella cartella, poi claude).
  4. Dai l'incarico: «Spiegami questo progetto: a cosa serve, quali file ci sono e cosa fa ciascuno? Non modificare nulla.»
  5. Digita /usage e guarda quanto ha consumato questo primo incarico. Nell'app desktop trovi i comandi anche digitando /.
Quale account non basta per usare Claude Code?
Esatto. Claude Code richiede Pro, Max, Ultra, Team, Enterprise o un account Claude Console. L'account gratuito non include Claude Code.
Non proprio. Pro e Team includono Claude Code. Solo l'account gratuito non basta.
Punti chiave:
  • Claude Code richiede un abbonamento (Pro, Max, Ultra, Team, Enterprise) o un account Claude Console.
  • App desktop per iniziare facilmente, terminale per tutte le funzioni. Entrambi usano le stesse impostazioni.
  • Installazione con un comando, verifica con claude --version. Gli aggiornamenti arrivano automaticamente.
  • Al primo avvio: accesso nel browser e domanda se ti fidi della cartella.
  • Controllare l'impostazione sulla protezione dei dati dell'account prima di lavorare con codice di altre persone.

Questa lezione fa parte di un corso con esame finale e certificato. Vedi il corso «Claude Code in pratica»

Avanti →