Hai sentito parlare di Claude Code e vuoi capire come iniziare concretamente? Sei nel posto giusto. Questo tutorial ti guida passo dopo passo dall'installazione al tuo primo progetto funzionante, senza dare nulla per scontato dal punto di vista tecnico.

Alla fine di questa guida avrai installato Claude Code, lanciato la tua prima sessione, capito i comandi essenziali e creato un piccolo progetto di cui andare fiero. Tutto in italiano, step by step.

Cos'è Claude Code?

Claude Code è uno strumento di assistenza allo sviluppo creato da Anthropic, l'azienda dietro l'IA Claude. A differenza di un semplice chatbot, può davvero toccare i tuoi file: creare codice, modificarlo, eseguire comandi, testare e persino deployare.

Concretamente, lanci Claude Code in una cartella, gli spieghi cosa vuoi (in italiano, con frasi normali) e si mette al lavoro. Vedi i file apparire, convalidi, chiedi aggiustamenti. È un collega più che uno strumento.

Ecco cosa lo rende unico rispetto a competitor come Cursor o GitHub Copilot:

  • Esegue davvero azioni nel tuo ambiente (non solo suggerimenti).
  • Capisce progetti completi, non solo la riga che stai scrivendo.
  • Ha una modalità "piano" che ti propone un piano prima di codificare.
  • Parla un italiano perfetto e si adatta al tuo livello.

Installa Claude Code in 5 minuti

L'installazione di Claude Code è semplice e funziona su Mac, Windows e Linux.

Passaggio 1 — Crea o accedi al tuo account Claude

Vai su claude.ai e crea un account se non ne hai uno. Un abbonamento Claude Pro (circa 20 euro al mese) è necessario per usare Claude Code comodamente. Gli studenti possono beneficiare di tariffe ridotte attraverso programmi specifici.

Passaggio 2 — Scarica Claude Code

Vai su claude.ai/code. Vedrai un pulsante "Scarica Claude Code". Scegli la tua piattaforma (macOS, Windows, Linux). Il file è circa 50 MB e l'installer è ufficialmente firmato da Anthropic.

Su macOS, Claude Code si installa come un'app normale nella cartella Applicazioni. Su Windows, un installer classico ti guida. Su Linux, usi un pacchetto deb o rpm a seconda della tua distribuzione.

Passaggio 3 — Lancia la tua prima sessione

Apri un terminale (Terminal su Mac, PowerShell su Windows), vai nella cartella dove vuoi lavorare con cd /percorso/verso/cartella, poi digita:

claude

La prima volta, Claude Code ti chiederà di accedere. Si apre un browser, convalidi, e torni nel terminale. Sei pronto.

Il tuo primo progetto con Claude Code

Il miglior progetto per imparare è una piccola pagina web che puoi vedere subito nel tuo browser.

Crea una cartella vuota sulla scrivania, ad esempio mio-primo-progetto. Apri il terminale dentro e lancia claude. Poi scrivi questa richiesta:

Voglio creare una homepage semplice per il mio caffè fittizio "La Volpe". Una foto di sfondo, un titolo, un paragrafo che descrive il caffè, gli orari e un pulsante per prenotare un tavolo. Non so nulla di codice, guidami.

Claude probabilmente ti farà 2 o 3 domande (che atmosfera, quali colori, ecc.). Rispondi naturalmente. Poi creerà i file: index.html, styles.css, a volte script.js. Li vedrai apparire nella cartella.

Apri index.html facendo doppio clic. Il tuo browser mostra il risultato. Potrebbe non essere perfetto, ed è normale. Torna nel terminale e chiedi modifiche: "Rendi il titolo più grande", "Metti uno sfondo blu notte", "Aggiungi un logo in alto a sinistra". Ad ogni iterazione, ricarica e vedi il cambiamento.

In 30-45 minuti avrai una pagina che ti piace.

I 10 comandi Claude Code da conoscere

Alcuni comandi speciali ti permettono di sfruttare al massimo Claude Code senza leggere tutta la documentazione. Ecco quelli che userai l'80% del tempo.

Comando Cosa fa
/help Mostra l'elenco dei comandi disponibili
/clear Cancella la cronologia della sessione corrente
/model Cambia il modello utilizzato (Opus, Sonnet, Haiku)
/init Crea un file CLAUDE.md per documentare il progetto
/plan Attiva la modalità piano prima di eseguire
/compact Riassume la conversazione per liberare memoria
/exit Chiude correttamente la sessione
Trascinare un file Aggiunge il file al contesto (come un'immagine)
Scrivere @nomefile Fa leggere a Claude un file specifico
!comando Esegue un comando shell senza passare per Claude

Per l'elenco completo e i dettagli di ogni comando, il nostro articolo i 20 comandi Claude Code da conoscere fa il giro completo.

Il file CLAUDE.md, il tuo miglior alleato

Il file CLAUDE.md è un piccolo documento dove scrivi le regole del tuo progetto perché Claude se le ricordi ad ogni sessione. È come lasciare un post-it al tuo futuro io e a Claude.

Puoi metterci:

  • Lo stack utilizzato (React, Next.js, Python, ecc.)
  • I comandi di test e build
  • Le convenzioni di codice da rispettare
  • Le regole di lingua (es: "tutti i testi utente in italiano con accenti")
  • Le zone da non toccare mai

Claude legge automaticamente questo file ad ogni nuova sessione. È il segreto per non ripetere le stesse istruzioni ogni volta. Inizia piccolo (5-10 righe) e arricchisci man mano che identifichi cosa ti serve.

La modalità piano: riflettere prima di agire

La modalità piano è una funzionalità unica che chiede a Claude di proporti un piano prima di eseguire qualsiasi cosa. Su compiti importanti, evita sorprese spiacevoli.

Digita /plan nella tua sessione, poi formula la tua richiesta. Claude analizzerà, farà domande se necessario, poi ti presenterà un piano strutturato in più step. Puoi accettarlo, modificarlo o rifiutarlo completamente. Una volta validato, Claude esegue il piano step by step.

È particolarmente utile quando non sai ancora bene cosa vuoi: Claude ti aiuta a inquadrare.

Errori da principiante da evitare

Ecco i 4 trabocchetti che bloccano sistematicamente i principianti e come evitarli.

  • Lanciare Claude nella tua cartella home: lancialo sempre in una sottocartella dedicata. Altrimenti ha accesso a tutto.
  • Chiedere più feature contemporaneamente: "Fai un sito e-commerce completo" → suddividi in piccoli step.
  • Non leggere le domande di Claude: quando fa una domanda, vuole davvero la tua risposta. Non saltare.
  • Dimenticare di salvare in git: usa git per mantenere uno storico del tuo progetto. Claude può aiutarti a installarlo.

Per andare oltre

Claude Code è uno strumento profondo: c'è sempre qualcosa da imparare. Ma non hai bisogno di sapere tutto per iniziare a creare cose utili. La progressione è continua: ogni progetto ti rende migliore.

Se vuoi un percorso strutturato in italiano, il programma Vibe Coding di Skilzy ti guida da zero a un vero progetto deployato, con esercizi gamificati e guidati passo dopo passo.

L'unica cosa che ti separa dal tuo primo progetto è aprire un terminale oggi.