Modulo 3 — Claude Code
L'agente che agisce
nel tuo computer
3.1 · Installazione
3.2 · CLAUDE.md
3.3 · Le Skill
3.4 · Gli Hook
3.5 · Il Workflow
Al termine di questa lezione saprai:
- Installare Claude Code sul tuo computer in 10 minuti
- Capire la differenza tra Claude Code e claude.ai
- Eseguire il tuo primo comando da terminale con Claude
Da chatbot ad agente — un salto di categoria
Fino ad ora hai usato Claude come un chatbot avanzato: scrivi, lui risponde, tu copi il risultato. Utile. Ma limitato.
Claude Code è un'altra cosa. È un agente AI che gira nel tuo terminale e può: leggere file sul tuo computer, scrivere codice, eseguire comandi, modificare siti web, analizzare database, inviare richieste a API. Non risponde — agisce.
La differenza in una frase
Claude.ai è come parlare al telefono con un consulente. Claude Code è come avere quel consulente seduto alla tua scrivania, con accesso al tuo computer, che fa il lavoro mentre parli con lui.
Cosa ti serve per iniziare
Hai bisogno di tre cose: un account Claude Pro (o Max), Node.js installato, e 10 minuti di tempo. Non serve essere programmatori.
1
Installa Node.js
Vai su nodejs.org, scarica la versione LTS (la stabile) e installala. È il motore che fa girare Claude Code. Nessuna configurazione richiesta.
2
Installa Claude Code
Apri il terminale (su Mac: Terminal, su Windows: PowerShell o Command Prompt) e digita:
npm install -g @anthropic-ai/claude-code
3
Autentica il tuo account
Nella cartella del tuo progetto, digita claude e premi invio. Si aprirà una schermata di login. Accedi con il tuo account Claude Pro.
4
Primo comando
Sei dentro. Digita la tua prima istruzione in italiano: "Analizza i file in questa cartella e dimmi cosa c'è". Claude Code risponderà e potrà anche leggere i file per te.
Le capacità di Claude Code — cosa può fare
Leggere e scrivere file
Legge qualsiasi file sul tuo computer — codice, testi, dati — e può scrivere o modificare file direttamente.
Eseguire comandi
Può eseguire comandi nel terminale, avviare server, installare dipendenze, eseguire script — con controllo sui passaggi.
Navigare il web
Con i giusti MCP server (vedi Modulo 4), può aprire browser, navigare pagine, compilare form, fare ricerche.
Lavorare in loop
Può eseguire compiti iterativi: "correggi tutti i file HTML di questa cartella" — li processa uno a uno con revisione nei punti importanti.
Sicurezza — leggi prima di usarlo
Claude Code ha accesso al tuo file system. Per attività rischiose (cancellare file, modificare sistemi critici), chiede conferma. Non lasciarlo mai lavorare su file importanti senza una copia di backup. Nella lezione 3.4 vediamo come gestire i permessi con gli Hook.
Esercizio 3.1
Installa e fai girare Claude Code
- Installa Node.js da nodejs.org (versione LTS)
- Apri il terminale e digita:
npm install -g @anthropic-ai/claude-code
- Naviga in una cartella di lavoro:
cd percorso/cartella
- Digita
claude e accedi con il tuo account Pro
- Chiedi: "Elenca tutti i file in questa cartella e dimmi il tipo di ognuno"
Punti chiave
- Claude Code non è un chatbot — è un agente che agisce nel tuo computer
- Installazione: 3 passi, 10 minuti, nessuna competenza tecnica richiesta
- Parti sempre da una cartella di test — mai su file critici senza backup
Al termine di questa lezione saprai:
- Creare un file CLAUDE.md che dice a Claude tutto del tuo progetto
- Non dover rispiegare il contesto ad ogni sessione
- Strutturare le istruzioni per ottenere comportamenti consistenti
Il problema della memoria con Claude Code
Ogni volta che avvii una nuova sessione di Claude Code, riparte da zero. Non ricorda la sessione precedente, non sa com'è strutturato il tuo progetto, non conosce le tue preferenze di lavoro.
La soluzione è il file CLAUDE.md — un file di testo che metti nella cartella del tuo progetto e che Claude Code legge in automatico all'avvio di ogni sessione. È la memoria permanente del tuo progetto.
Analogia
CLAUDE.md è il manuale di istruzioni che daresti a un collaboratore il primo giorno di lavoro. Non glielo spieghi ogni mattina — lo ha letto, lo conosce, si comporta di conseguenza ogni giorno.
Struttura di un CLAUDE.md efficace
# [Nome del Progetto]
## Chi sono
Sono [il tuo nome], [il tuo ruolo]. Lavoro su [tipo di progetto/business].
Il mio livello tecnico: [principiante / intermedio / avanzato].
## Cos'è questo progetto
[Descrizione in 2-3 righe di cosa fa il progetto, a chi è rivolto, qual è l'obiettivo principale.]
## Stack tecnologico
- Linguaggio: [es. Python 3.11, JavaScript ES6, ecc.]
- Framework: [es. Flask, React, WordPress, ecc.]
- Database: [es. MySQL, MongoDB, SQLite]
- Hosting: [es. VPS Ubuntu, Vercel, Netlify]
## Struttura cartelle
[Descrivi brevemente le cartelle principali e a cosa servono]
## Come lavoriamo insieme
- Lingua: sempre in italiano
- Quando fai modifiche a file esistenti, dimmi PRIMA cosa cambierai
- Non installare pacchetti senza chiedermi
- Dopo ogni blocco di lavoro, dammi un riassunto di cosa hai fatto
## Convenzioni del progetto
[Es. nomi variabili in snake_case, commenti in italiano, tab di 2 spazi, ecc.]
## Cose da NON fare mai
- Non cancellare file senza conferma esplicita
- Non modificare il file di configurazione principale senza chiedere
- [Aggiungi le tue]
CLAUDE.md per chi non è sviluppatore
Anche se non scrivi codice, il CLAUDE.md è utilissimo. Puoi usarlo per qualsiasi tipo di progetto — un sito web, una campagna marketing, un progetto editoriale.
## Chi sono
Sono la proprietaria di una boutique di abbigliamento a Milano.
Non sono tecnica — preferisco spiegazioni semplici.
## Regole di comunicazione
- Spiega sempre COSA stai facendo in linguaggio semplice
- Se devi fare qualcosa di rischioso, chiedi conferma
- Preferisco molti piccoli passi sicuri a pochi grandi cambiamenti
## Il mio sito
WordPress con WooCommerce. Hosting Aruba.
Tema: Flatsome. Non cambiare il tema principale.
CLAUDE.md globale vs. per progetto
Puoi avere un CLAUDE.md globale (nella tua home directory) con le preferenze che valgono sempre, e un CLAUDE.md per progetto (nella cartella specifica) con dettagli tecnici di quel progetto. Claude li legge entrambi e li combina.
Esercizio 3.2
Crea il tuo primo CLAUDE.md
- Apri un editor di testo (anche il blocco note va bene)
- Usa il template sopra come base e adattalo al tuo progetto/lavoro
- Salvalo come
CLAUDE.md nella cartella dove lavori con Claude Code
- Avvia una nuova sessione di Claude Code in quella cartella
- Chiedi: "Leggi il CLAUDE.md e dimmi cosa hai capito del mio progetto" — vedrai che sa già tutto
Punti chiave
- CLAUDE.md è la memoria permanente del progetto — crealo sempre prima di iniziare
- Più è dettagliato, meno dovrai spiegare ogni volta
- Usa CLAUDE.md globale per preferenze personali, locale per dettagli tecnici
Al termine di questa lezione saprai:
- Creare Skill personalizzate che insegnano a Claude come lavori tu
- Automatizzare sequenze di azioni ripetitive con un solo comando
- Costruire la tua libreria di Skill riutilizzabili
Le Skill — comandi riutilizzabili
Le Skill (chiamate anche "slash commands" personalizzati) sono uno dei strumenti più potenti di Claude Code — e molti utenti non le configurano.
Una Skill è un file di testo nella cartella .claude/commands/ che definisce una sequenza di azioni che Claude deve eseguire quando invochi un comando specifico. In pratica: insegni a Claude una sequenza di lavoro che si ripete, e poi la richiami con un solo comando.
Analogia
Le Skill sono procedure riutilizzabili per Claude Code: descrivi una sequenza una volta, la richiami con un comando e la mantieni nel tempo.
Come funzionano le Skill
Ogni Skill è un file Markdown nella cartella .claude/commands/ del tuo progetto. Il nome del file diventa il comando.
tuo-progetto/
├──.claude/
│ └── commands/
│ ├── pubblica-post.md
│ ├── analizza-sito.md
│ └── crea-report.md
└── CLAUDE.md
Esempio pratico: Skill per pubblicare contenuti
Sei il mio assistente editoriale.
Quando ricevi questo comando, segui questi passi nell'ordine:
1. Chiedi il titolo e il contenuto del post se non li hai già
2. Rifinisci il testo per la leggibilità: frasi brevi, paragrafi corti, CTA chiara
3. Genera 5 varianti del titolo SEO-friendly
4. Suggerisci 3 immagini descrittive che potrei usare (non generarle)
5. Crea le versioni per: Blog (500 parole) · LinkedIn (200 parole) · Instagram caption (150 parole)
6. Genera i meta-tag SEO: title, description, 5 keyword principali
7. Presenta tutto in un documento strutturato pronto per il copia-incolla
Da questo momento, ogni volta che digiti /pubblica-post in Claude Code, lui esegue in automatico tutti e 7 i passi. Meno istruzioni ripetute, più consistenza.
Skill utili da creare subito
/analizza-competitor
Chiede URL, analizza il sito, confronta con il tuo, restituisce una lista di gap e opportunità.
/crea-email-campaign
Poche info sul prodotto, genera: oggetto, preheader, corpo email, CTA, versione mobile.
/review-contratto
Carica PDF contratto, identifica rischi, clausole problematiche, punti da negoziare.
/weekly-report
Chiede i dati della settimana, genera report formattato con trend, anomalie, raccomandazioni.
Esercizio 3.3
Crea la tua prima Skill
- Pensa a una sequenza di azioni che ripeti spesso con Claude (analisi, scrittura, elaborazione dati)
- Crea la cartella
.claude/commands/ nel tuo progetto
- Crea un file
nome-skill.md con le istruzioni passo-passo
- In Claude Code, digita
/nome-skill e vedi come esegue seguendo regole definite
- Raffina il file finché il risultato è adatto, poi usala ogni volta
Punti chiave
- Le Skill raccolgono sequenze ripetitive in un singolo comando
- Bastano pochi minuti per crearle — si ripagano in pochi utilizzi
- Costruisci la tua libreria di Skill per ogni area di lavoro ricorrente
Al termine di questa lezione saprai:
- Controllare esattamente cosa Claude Code può e non può fare
- Configurare Hook per notifiche e automazioni automatiche
- Lavorare in sicurezza anche su progetti critici
Il controllo che non sapevi di volere
Claude Code è utile, ma va configurato con confini chiari. Gli Hook sono il sistema che ti permette di definire esattamente i confini entro cui Claude Code può operare — e di far scattare azioni automatiche quando certi eventi accadono.
Cosa sono gli Hook
Gli Hook sono comandi (script) che si eseguono in automatico prima o dopo certe azioni di Claude Code. Ci sono 4 tipi principali:
PreToolUse — Prima di usare uno strumento
Si esegue prima che Claude usi qualsiasi strumento (scrittura file, esecuzione comandi). Puoi usarlo per: chiedere conferma, loggare l'azione, bloccarla se non soddisfa certi criteri.
PostToolUse — Dopo aver usato uno strumento
Si esegue dopo ogni azione. Utile per: notifiche ("Claude ha modificato il file X"), backup automatici, log delle operazioni.
Stop — Prima di fermarsi
Si esegue quando Claude Code finisce il suo lavoro. Puoi far sì che mandi una notifica sul telefono, mandi un'email, aggiorni un documento di log.
Notification — Notifiche
Ricevi notifiche in tempo reale su cosa sta facendo Claude Code — utile nei task lunghi, quando vuoi tenere traccia dello stato.
Come configurare gli Hook
Gli Hook si configurano nel file settings.json dentro la cartella .claude/ del tuo progetto.
{
"hooks": {
"Stop": [
{
"hooks": [
{
"type": "command",
"command": "echo 'Claude ha finito il lavoro'"
}
]
}
]
}
}
Uso pratico per non sviluppatori
Anche se non capisci il JSON, puoi chiedere a Claude Code stesso: "Configurami un Hook che mi avvisi con un beep quando finisci il lavoro" e lui scriverà il codice per te. Usa Claude Code per configurare Claude Code.
Esercizio 3.4
Configura il tuo primo Hook
- Apri Claude Code nella tua cartella di lavoro
- Scrivi: "Configurami un Hook che mostri un messaggio di notifica quando finisci ogni task"
- Claude Code creerà o modificherà il settings.json per te
- Testa dando un piccolo compito e verifica che la notifica arrivi
- Bonus: chiedi di configurare un Hook che logga ogni file modificato in un file di log
Punti chiave
- Gli Hook sono il sistema di controllo di Claude Code — usali sempre su progetti importanti
- Non devi scriverli manualmente — chiedi a Claude Code di configurarli per te
- Il Hook di notifica "Stop" è il minimo indispensabile per lavorare su task lunghi
Al termine di questa lezione saprai:
- Strutturare la tua giornata di lavoro con Claude Code
- Delegare task complessi e ricevere output pronti all'uso
- Costruire un sistema di lavoro che si migliora nel tempo
Il workflow del professionista
Avere gli strumenti giusti non basta. La differenza tra un utente medio e un power user è il sistema di lavoro — la routine che rende Claude Code il centro produttivo della giornata.
Quello che segue è il workflow che uso personalmente ogni giorno. Non è utile per tutti, ma è un punto di partenza concreto da cui puoi adattare il tuo.
La routine mattutina (15 minuti)
Briefing del giorno
Prima cosa: apri Claude Code nel tuo progetto principale e scrivi: "Buongiorno. Ecco cosa devo fare oggi: [lista]. Aiutami a prioritizzare e dimmi da dove iniziare." Claude analizza, suggerisce l'ordine, identifica dipendenze.
Revisione pendenti
Se hai lasciato lavoro in sospeso il giorno prima, chiedi: "Leggi il file TODO.md e dimmi lo stato di ogni task." Claude legge il file e ti fa un briefing completo.
Durante la giornata — come delegare bene
La regola d'oro: più dettagli dai, meno giri dovrai fare. Prima di dare un task a Claude Code, pensa a: l'obiettivo finale, i vincoli (cosa NON fare), il formato dell'output che vuoi, come verificherai che è fatto bene.
"[OBIETTIVO]: cosa deve produrre alla fine
[CONTESTO]: informazioni che gli servono per farlo bene
[VINCOLI]: cosa non deve toccare, limiti di tempo/budget/complessità
[OUTPUT]: formato esatto che voglio (file, struttura, lunghezza)
[VERIFICA]: come saprò che è fatto correttamente"
Esempio:
"Obiettivo: aggiorna le descrizioni prodotto nel file products.json
Contesto: sono descrizioni per e-commerce beauty, target 30-50 anni, tono professionale ma caldo
Vincoli: max 150 parole per prodotto, non cambiare prezzi e SKU
Output: file products-updated.json con le stesse struttura dati ma descrizioni nuove
Verifica: confronta i file e mostrami un diff delle modifiche"
Il ciclo di miglioramento continuo
Ogni settimana, dedica 20 minuti a questo ciclo:
1
Identifica i task ripetitivi
Cosa hai fatto più di una volta questa settimana con Claude Code? Quelli sono candidati per diventare Skill.
2
Aggiorna il CLAUDE.md
Hai imparato qualcosa di nuovo sul tuo progetto? Una convenzione che funziona meglio? Aggiornalo. Il CLAUDE.md deve essere un documento vivo.
3
Crea una nuova Skill
Per ogni task ripetitivo identificato, crea la Skill corrispondente. In 20 minuti puoi costruirne 2-3.
Il vantaggio composto
Ogni Skill che crei, ogni miglioramento al CLAUDE.md, ogni Hook configurato — si accumula. Dopo 30 giorni, hai un sistema personalizzato che lavora nel tuo modo specifico. Questo è il vantaggio competitivo che non si può comprare — si costruisce un pezzo alla volta.
Esercizio 3.5
Progetta il tuo workflow personalizzato
- Scrivi una lista di 10 task che fai ripetutamente nel tuo lavoro
- Identifica i 3 che richiedono più tempo e dove Claude Code può aiutare
- Per ognuno, scrivi: obiettivo, contesto, vincoli, output atteso
- Crea una Skill per almeno uno di questi task
- Per una settimana, usa questo sistema e nota il tempo risparmiato
Punti chiave
- Il workflow batte i singoli strumenti — un sistema mediocre usato bene supera strumenti eccellenti usati male
- La delega efficace richiede: obiettivo, contesto, vincoli, output, verifica
- Il ciclo settimanale di miglioramento è ciò che ti porta da utente a esperto in 30 giorni
Prossimo modulo
Modulo 4 — MCP: Claude nel mondo reale
Connetti Claude a database, email, social, calendari, API. Tutto.
→