Claude Code in italiano: cos'è e come iniziare davvero

Da data engineer ho passato anni a costruire pipeline e a rimettere le mani in codice scritto da altri. La prima volta che ho aperto Claude Code mi ha spiazzato una cosa banale: gli parli come a un collega, non come a uno strumento. Gli dici cosa vuoi ottenere e lui si muove. Ci ho lavorato su progetti veri, nel finance, nelle assicurazioni, nel wellness. Qui ti dico cos'è, come ragiona e da dove conviene partire.

Cos'è, senza giri di parole

Claude Code è un agente di sviluppo che vive nel terminale. «Agente» è una parola abusata, quindi mi spiego. Non ti completa la riga mentre scrivi, come l'assistente dentro l'editor. Riceve un obiettivo, apre i file del progetto, esegue comandi, scrive test e arriva ad aprire una pull request. La differenza pratica è tutta qui: l'autocomplete conosce le righe intorno al cursore, l'agente conosce il repository e ci si muove dentro.

E gli parli in italiano, se preferisci. Gli dici «guarda come funziona l'autenticazione e aggiungi il login con Google»: lui legge i file giusti, ti propone un piano, lo esegue. La prima volta fa un certo effetto.

Come ragiona

Sotto il cofano ripete sempre lo stesso ciclo, finché il lavoro non è chiuso:

• Legge il contesto: apre i file che servono, cerca nel codice, capisce le convenzioni.
• Decide i passi, e per i lavori grossi te li mostra prima di toccare qualcosa.
• Agisce: modifica i file, lancia comandi, esegue i test.
• Controlla l'output e, se qualcosa si rompe, si corregge da solo.

Da ex saltatore in alto questo ciclo lo riconosco: è la rincorsa prima del salto. Il salto si vede, ma è la preparazione a decidere se passi l'asticella. La conseguenza pratica è una sola: più il contesto che gli dai è pulito, meglio lavora. Vale la stessa regola di un brief a un collega. Un buon brief all'inizio ti risparmia dieci correzioni dopo.

Installarlo e partire

Serve Node.js. Da lì l'installazione è una riga; poi apri il terminale nella cartella del progetto e avvii l'agente:

npm install -g @anthropic-ai/claude-code
cd il-tuo-progetto
claude

Al primo avvio ti autentichi e sei operativo. Su un progetto nuovo la prima cosa che faccio è /init: legge il codice e scrive una bozza di CLAUDE.md, il file di cui parlo qui sotto.

/init

CLAUDE.md, la memoria del progetto

CLAUDE.md è un file di testo nella radice del progetto con le regole che l'agente deve rispettare sempre: com'è organizzato il codice, quali comandi usare per test e build, cosa non toccare mai. È la differenza tra un collaboratore che ogni mattina riparte da zero e uno che il tuo progetto lo conosce già. /init ne scrive una prima versione, poi la sistemi a mano.

Il pilota resti tu

L'agente è potente, ma il controllo resta in mano tua. Claude Code chiede il permesso prima delle azioni delicate, e tu decidi quanto guinzaglio lasciargli. Il tasto ESC lo ferma in qualsiasi momento. L'ho imparato a mie spese: lasciarlo correre senza guardare è il modo più rapido per ritrovarti con codice che compila e sbaglia lo stesso. Quando prende la piega sbagliata, ESC e lo rimetti in riga senza perdere il lavoro fatto.

Dal task alla pull request

Il modo più onesto di capirlo è vederlo chiudere un ciclo intero. Su una piccola feature di solito va così:

• Gli descrivo il task a parole, con il contesto e il risultato che voglio.
• Se il lavoro non è banale, gli chiedo prima il piano e lo approvo.
• Implementa a piccoli passi, aggiornando i test man mano.
• Lancia i test, sistema ciò che si rompe, mi mostra le modifiche.
• Gli chiedo il commit con un messaggio chiaro e l'apertura della pull request.

Gioco a scacchi, e la cosa che mi torna sempre in mente è questa: non muovi il primo pezzo che ti capita, prima pensi e poi muovi. Con l'agente è identico. Il punto non è «l'AI scrive il codice al posto tuo», ma che governi un collaboratore velocissimo senza fargli saltare i passaggi: test, revisione, diff piccoli e verificabili. È lì che si gioca la differenza tra andare veloce e accumulare debito tecnico.

Da dove partire sul serio

Una guida ti dà la mappa; l'autonomia arriva praticando, con qualcuno che ti corregge il tiro. Nel percorso Claude Code dell'Academy si parte dal terminale vuoto e si arriva a gestire un flusso di sviluppo completo, su progetti reali, con i materiali già pronti. La prima lezione la guardi gratis: se vuoi passare dal «ho capito cos'è» al «lo uso ogni giorno», parti da lì.