Cos'è Claude Code
e perché cambia tutto
Claude Code è l'assistente AI di Anthropic pensato per chi scrive codice. Non è un chatbot a cui incolli frammenti di codice — vive nel tuo terminale, legge l'intero progetto, scrive file reali, esegue comandi, gestisce Git. È come avere un collega sviluppatore sempre disponibile.
Con ChatGPT o GitHub Copilot descrivi un problema e ricevi del codice. Con Claude Code dici "aggiungi il login con Google al mio progetto" e Claude legge tutti i tuoi file, capisce l'architettura, scrive le modifiche giuste, installa le dipendenze e testa che funzioni. Tu approvi ogni passo.
Claude Code vs altri tool AI per sviluppatori — 2026
| Funzione | Claude Code | GitHub Copilot | Cursor |
|---|---|---|---|
| Legge l'intero progetto | ✅ (1M token) | Parziale | ✅ |
| Esegue comandi terminale | ✅ | ❌ | Parziale |
| Gestisce Git in autonomia | ✅ | ❌ | Parziale |
| Funziona da terminale | ✅ | ❌ (solo IDE) | ❌ (solo IDE) |
| Piano Free disponibile | ✅ | ❌ | ❌ |
| CLAUDE.md (memoria progetto) | ✅ | ❌ | Parziale |
| MCP integrations | ✅ | ❌ | Parziale |
Claude Code ha raggiunto 29 milioni di installazioni giornaliere. Nel sondaggio Pragmatic Engineer (febbraio 2026, 15.000 sviluppatori) ha ottenuto il 46% di "più amato" — il punteggio più alto tra tutti gli strumenti AI per sviluppatori. Il 70% delle aziende Fortune 100 lo usa.
I 5 modi per usare
Claude Code
Claude Code non è solo un terminale. Puoi usarlo in 5 modi diversi, ognuno pensato per un contesto diverso. Tutti usano lo stesso modello Opus 4.7 — cambia solo dove lavori.
Se non sai da dove iniziare: usa il tab Code in Claude Desktop — non richiede installazione extra e funziona subito. Quando ti senti pronto per il terminale, passa al CLI: è più veloce e potente.
Installare Claude Code
CLI — passo per passo
Se vuoi usare Claude Code da terminale (la via più potente), hai bisogno di Node.js installato sul tuo computer. Se preferisci evitare il terminale, salta questa sezione e usa il tab Code di Claude Desktop.
Passo 1 — Installa Node.js
Node.js è il motore su cui gira Claude Code. Vai su nodejs.org — il sito riconosce automaticamente il tuo sistema operativo e ti mostra la versione giusta da scaricare.
# Apri il terminale e digita: node --version # Se vedi v18.x.x o superiore, Node.js è già installato # Se vedi "command not found", devi installarlo
Passo 2 — Installa Claude Code
# Installa Claude Code globalmente npm install -g @anthropic-ai/claude-code # Verifica installazione claude --version # Se "claude" non viene trovato, apri un nuovo terminale
Passo 3 — Autenticazione
# Avvia il login (apre il browser) claude login # Completa il login nel browser con il tuo account Anthropic # Torna al terminale: vedrai "Logged in as [tua email]" # Entra nella tua prima sessione cd ~/Desktop claude
| Metodo auth | Quando usarlo | Costo |
|---|---|---|
| Login con account | Uso personale quotidiano | Incluso nel piano (Free/Pro) |
| API Key (console.anthropic.com) | Team, script, automazioni | Pay-per-token (~$3/M input) |
Scrivi claude nel terminale. Se vedi il prompt >>> e puoi digitare messaggi, Claude Code è installato e funzionante. Prova con: "Ciao! Di' che sei pronto."
Il file CLAUDE.md:
il libretto istruzioni del progetto
CLAUDE.md è un file di testo che metti nella cartella principale del tuo progetto. Claude lo legge all'inizio di ogni sessione — è come dargli un briefing completo su cosa sta per fare, senza doverlo rispiegare ogni volta.
Immagina di assumere un nuovo sviluppatore. Il primo giorno gli dai un documento con: come è strutturato il progetto, le convenzioni di codice, cosa non toccare, i comandi per avviare l'app. CLAUDE.md è esattamente questo documento — scritto per Claude.
Cosa mettere in CLAUDE.md
# File: CLAUDE.md (nella cartella root del progetto) ## Progetto Sito e-commerce per negozio di abbigliamento. Stack: HTML, CSS, JavaScript + PHP backend. Database: MySQL. Hosting: Aruba. ## Comandi essenziali - Avvia il server: php -S localhost:8000 - Test database: php test_db.php - Deploy: ./deploy.sh (richiede VPN) ## Convenzioni importanti - I prezzi sono sempre in euro con 2 decimali - I nomi delle variabili sono in italiano - Non modificare mai il file config_produzione.php ## Struttura cartelle - /src — codice sorgente - /assets — immagini e font - /api — endpoint backend - /docs — documentazione
Regole d'oro per un buon CLAUDE.md
- ✅Scrivi solo cose non ovvieNon scrivere "questo è un sito web" — Claude lo capisce da solo. Scrivi solo le cose specifiche del tuo progetto che non si deducono dal codice.
- ✅Includi i comandi di avvioCome si avvia il progetto, come si testano le funzioni, come si fa il deploy. Claude li userà autonomamente.
- ❌Non riempirlo troppoOgni riga di CLAUDE.md viene caricata ad ogni sessione e usa token. Tienilo sotto una pagina. Metti il resto nel README.
- ❌Non metterci password o chiavi APICLAUDE.md potrebbe finire nel repository Git pubblico. Le credenziali vanno in file .env separati, mai in CLAUDE.md.
Se stai solo iniziando, salta CLAUDE.md per ora. Inizia a usare Claude Code, impara i comandi base, e quando noti che ripeti sempre le stesse istruzioni all'inizio delle sessioni — quello è il momento giusto per creare il tuo CLAUDE.md.
Plan Mode: pensa prima
di agire
Plan Mode è una delle funzioni più importanti di Claude Code, specialmente per chi inizia. Invece di modificare subito il codice, Claude prima spiega cosa ha intenzione di fare e aspetta la tua approvazione. Zero sorprese.
Senza Plan Mode, Claude potrebbe modificare 10 file prima che tu capisca cosa sta facendo. Con Plan Mode, prima leggi il piano completo, capisci ogni passaggio e solo dopo dici "vai". È come avere un preventivo prima di fare partire i lavori.
Come si attiva
# Metodo 1 — Flag da terminale claude --plan # Metodo 2 — Durante una sessione attiva # Premi Shift+Tab per attivare/disattivare Plan Mode # Metodo 3 — Nel messaggio "Prima di fare qualsiasi modifica, mostrami il piano dettagliato di cosa cambieresti e aspetta la mia conferma."
Come funziona in pratica
- 1Scrivi il tuo compito"Aggiungi la funzione di ricerca al sito."
- 2Claude analizza e presenta il pianoVedrai: "Modificherò 3 file: index.html (aggiungo form), script.js (aggiungo funzione di ricerca), style.css (stili del form). Nessun file verrà eliminato."
- 3Approvi o correggiSe il piano va bene, scrivi "procedi". Se vuoi cambiare qualcosa, di' a Claude cosa modificare nel piano.
- 4Claude esegueSolo dopo la tua approvazione Claude tocca i file. Ogni modifica è tracciata e reversibile.
Hai sempre una via di uscita. Scrivi undo nella sessione per annullare l'ultima operazione, oppure usa Git: git checkout . per tornare allo stato precedente all'inizio della sessione.
Connettere strumenti esterni
con MCP
MCP (Model Context Protocol) permette a Claude Code di parlare con strumenti e servizi esterni — database, API, strumenti di project management, cloud — direttamente dalla sessione di codice.
Senza MCP, Claude Code conosce solo i file del tuo progetto. Con MCP, puoi dirgli: "Leggi i dati da questo database PostgreSQL" o "Guarda i ticket aperti su Jira" o "Deploya questo sul server AWS". Claude lo fa direttamente, senza che tu cambi finestra.
Configurare un MCP Server
# Aggiungi un MCP server (es. filesystem locale) claude mcp add filesystem --scope project # Aggiungi un server MCP custom con URL claude mcp add mio-server "https://mio-server.example.com/mcp" # Vedi i server MCP configurati claude mcp list # Rimuovi un server claude mcp remove mio-server
MCP Server più utili per iniziare
| Server MCP | Cosa aggiunge | Quando usarlo |
|---|---|---|
| filesystem | Accesso a cartelle extra del computer | Sempre — il primo da configurare |
| github | Legge/scrive issue, PR e repository GitHub | Sviluppo con team |
| postgres | Query dirette al database PostgreSQL | App con database |
| google-drive | Accede a file su Google Drive | Documentazione e dati |
| context7 | Documentazione sempre aggiornata dei framework | Quando si usa React, Vue, Next.js |
| slack | Legge canali e invia messaggi Slack | Notifiche automatiche al team |
I server MCP sono potenti ma non necessari per iniziare. Impara prima i comandi base di Claude Code senza MCP. Aggiungili quando hai un bisogno specifico — ad esempio quando vuoi che Claude legga direttamente dal tuo database invece di copiarci i dati a mano.
Prima app: da zero
con un prompt
In questo esercizio costruirai una piccola applicazione web completa partendo da zero — solo con descrizioni in italiano, nessuna riga di codice scritta a mano.
- Crea una cartella sul Desktop chiamata
lista-spesa. Aprila nel terminale:cd ~/Desktop/lista-spesapoi avvia Claude Code:claude - Attiva Plan Mode:
claude --plan(oppure premi Shift+Tab). Leggi sempre il piano prima di procedere. - Scrivi il primo prompt:
Prompt inizialeCrea una piccola app web per la lista della spesa. Deve avere: campo per aggiungere un prodotto, lista dei prodotti con checkbox per spuntarli, pulsante per eliminare quelli spuntati, e il salvataggio automatico nel browser. Tutto in un unico file HTML.
- Leggi il piano che Claude presenta. Se va bene, scrivi "procedi".
- Apri il file
index.htmlnel browser. Testa l'app: aggiungi prodotti, spuntali, ricarica la pagina — i dati devono essere ancora lì. - Migliora l'app: "Aggiungi la possibilità di specificare la quantità (es. '2 kg farina') e una sezione separata per i prodotti già acquistati."
- Bonus: "Aggiungi un pulsante 'Condividi lista' che copia il contenuto negli appunti come testo semplice."
Claude Code può costruire applicazioni funzionanti da una descrizione in italiano. Plan Mode ti ha mostrato ogni passo prima di eseguirlo. Le richieste di miglioramento si aggiungono naturalmente come messaggi successivi — è una conversazione, non un comando singolo.
Gestione dati e file:
leggi, analizza, modifica
Claude Code eccelle nel lavorare con dati: legge CSV, genera report, trasforma formati, crea visualizzazioni. In questi esercizi impari a farlo senza scrivere Python o JavaScript a mano.
Nella sessione Claude Code, chiedi: "Crea un file vendite.csv con 30 righe: data (ultimi 3 mesi), prodotto (3 categorie: abbigliamento/accessori/calzature), quantità, prezzo unitario, regione (5 regioni italiane)."
- Nella sessione Claude Code, scrivi:
Prompt analisiLeggi il file vendite.csv. Dimmi: fatturato totale, prodotto più venduto per quantità, regione con più vendite, andamento mensile (fatturato per mese). Mostra tutto nel terminale.
- Osserva come Claude scrive ed esegue lo script di analisi in autonomia, poi ti mostra i risultati.
- Chiedi un approfondimento: "Qual è il prezzo medio per categoria? C'è correlazione tra regione e categoria più venduta?"
- Scrivi:
Prompt dashboardDal file vendite.csv crea una pagina HTML con dashboard vendite. Include: 4 card KPI (fatturato totale, unità vendute, valore medio ordine, regione top), grafico a barre del fatturato mensile, tabella interattiva con filtro per regione e categoria. Salva come dashboard.html
- Apri dashboard.html nel browser. Testa i filtri. Se qualcosa non funziona, segnalalo a Claude: "Il filtro per regione non funziona, correggilo."
- Chiedi a Claude di introdurre errori: "Aggiungi al CSV 5 righe con valori mancanti, 3 con prezzi negativi e 2 con date errate."
- Poi avvia la pulizia:
Prompt puliziaLeggi vendite.csv, identifica tutti i dati anomali o mancanti, mostrami cosa hai trovato, poi crea una versione pulita come vendite_pulito.csv e un log delle modifiche come modifiche.txt
- Verifica il file modifiche.txt — troverai un log dettagliato di ogni correzione effettuata.
Workflow Git automatico:
scrivi → testa → commit → PR
Claude Code gestisce Git in autonomia — crea branch, fa commit con messaggi sensati, apre Pull Request. In questo esercizio impari il flusso di lavoro professionale con Git, guidato da Claude.
Git installato sul tuo computer (git --version per verificare) e un account GitHub (gratuito). Se non hai Git, Claude Code te lo dirà e ti guiderà nell'installazione.
- Entra nella cartella lista-spesa del Esercizio 1:
cd ~/Desktop/lista-spesae avviaclaude. Se non hai fatto l'Esercizio 1, chiedi a Claude di crearlo ora. - Inizializza il repository: "Inizializza un repository Git in questa cartella, crea un .gitignore appropriato e fai il primo commit con messaggio 'Initial commit: app lista spesa'."
- Richiedi la nuova funzionalità in Plan Mode:
Prompt nuova featureCrea un branch chiamato "feature/categorie", poi aggiungi la possibilità di categorizzare i prodotti (es. Frutta, Latticini, Bevande). Ogni categoria deve avere un colore diverso. Implementa, testa che funzioni e poi fai commit con un messaggio descrittivo.
- Osserva Claude mentre crea il branch, scrive il codice, verifica che funzioni e fa il commit con un messaggio professionale automatico.
- Chiedi a Claude di tornare al main e fare il merge: "Torna al branch main, fai il merge di feature/categorie e scrivi un changelog di cosa è cambiato."
- Bonus con GitHub: Se hai GitHub configurato, aggiungi: "Fai push del repository su GitHub come repo privato e apri una Pull Request con descrizione delle modifiche."
Quando questo workflow ti è naturale, prova il MCP GitHub: Claude potrà leggere i tuoi issue aperti, assegnarsi un task, scrivere il codice, fare il commit e aprire la PR — tutto con un unico prompt.
Tutti i termini spiegati
dal più semplice al più tecnico
Non serve memorizzarli tutti subito. Torna qui quando incontri un termine che non conosci.
npm install -g @anthropic-ai/claude-code. Viene installato automaticamente con Node.js.