Claude Code · L2 · 1
Claude Code · Napolillo · Lezione 2

Oggi cominciamo a costruire.

REC · Lezione registrata

Questa lezione è registrata.

La registriamo perché tu possa rivederla.
Prima di iniziare

Dalla Lezione 1: una cartella, un piano in feature, e le tue prime skill.

  • La tua iniziativa ha una cartella e un piano: piano.md, diviso in feature, ognuna con la sua prova.
  • Il piano l'hai corretto tu: gli ostacoli veri e una modifica tua. Lo schema lo mostra a colpo d'occhio.
  • Hai già tre skill: /project-plan per ogni idea ancora vaga, /schema-piano per lo schema del piano, /coach quando sei bloccato.

Una skill si può avere in tre modi:

ScaricarlaUn file pronto, scritto da altri: la skill /project-plan.
Scriverla in chatIncolli un prompt e chiedi a Claude di salvarlo come skill.
Da quello che hai fattoUna cosa riuscita bene diventa una skill: /schema-piano.
Il tuo piano
ConfrontoGuarda e suggerisci · 2 min

Il tuo piano: si capisce?

Chi mostraApri piano.md o il suo schema. Racconta il piano in breve: cosa costruisci, per chi, le feature in ordine.
TuttiSi capisce? Se qualcosa non è chiaro, oggi è il momento di dirlo.

Oggi cominciamo a costruirlo: deve essere chiaro prima di iniziare.

Collegamenti · 17 min

A cosa arriva Claude Code, oltre la tua cartella?

Perché collegare

Quello che Claude Code può automatizzare dipende da ciò a cui è collegato.

Claude Code La cartella La posta L'archivio online I programmi aziendali Siti e servizi

Senza collegamenti, dei tuoi dati vede solo la cartella. Ogni collegamento è un lavoro in più che può fare per te.

Tre modi di collegare

Tre modi di collegare un servizio: prima il connettore, poi MCP, solo alla fine l'API.

ModoCos'èAccesso.env?
1ConnettoreCome un app store: già pronto e controllato da AnthropicUn clic, poi accediNo
2MCPIl collegamento standard con le piattaforme pensate per l'AILo aggiunge Claude con un link, poi accedi: niente chiaviNo
3APIIl modo tradizionale di collegarsi a un sistema: Claude scrive il codiceUna chiave APISì, solo qui

.env: il file nella cartella del progetto dove sta la chiave API.

Cosa serve a voi

Per la feature 1, cosa vi serve collegare?

Da completare con le vostre risposte alla lezione sui connettori di «Prima della Lezione 2».
Un connettore al lavoro
DemoGuarda · 3 min

Un connettore al lavoro: Claude legge i documenti su Drive e scrive il contesto dell'azienda.

1 · Collego Google Drive+ nella casella del prompt, poi Connettori: cerco Google Drive, accedo con il mio account.
2 · Chiedo il contestoClaude trova i documenti, li legge e scrive un file nella cartella del progetto. Su Drive non cambia niente.

Prompt della demo · il contesto dell'aziendaLeggi i documenti della cartella «napolillo-demo» nel mio Google Drive e scrivi contesto-azienda.md nella cartella del progetto: in una pagina, i clienti principali, i servizi, come funzionano ritiro e consegna e i problemi che tornano più spesso. Non modificare niente su Drive.

I permessi di un connettore

Ogni azione la puoi permettere, approvare o bloccare.

Esempio: le azioni di Gmail

Leggere· Cercare le email· Leggere un messaggio o una conversazione· Vedere bozze ed etichetteConsenti sempre
Scrivere e modificare· Scrivere una bozza· Rispondere, inoltrare, inviare· Mettere etichette, segnare come spamApprovazione richiesta
Eliminare· Spostare email nel cestino· Eliminare un'etichettaBloccato
Anche l'azienda può bloccare. I connettori dal pannello admin; MCP e API con le impostazioni gestite di Claude Code e, per le API, dando o negando la chiave.

Lo imposti una volta: Personalizza › Connettori › Gmail. Con «Personalizzato» scegli azione per azione.

Collega Google Drive
AttivitàTocca a te · 1 min

Tutti colleghiamo Google Drive: basta chiederlo a Claude.

1Scrivi: «Collega il mio Google Drive e dimmi in breve cosa ci vedi.»
2Claude ti mostra un pulsante per collegarlo? Cliccalo e accedi con l'account Google della tua email di lavoro.
Fatto quando
  • Claude ti dice il nome di qualche file del tuo Drive.
Nella Desktop app
Non sai cosa è collegato? Chiedilo a Claude: «Quali connettori hai in questa sessione?»
Quando non c'è un connettore
AttivitàPrima guarda · 1 minTocca a te · 3 min

Connessione di tipo API: la più difficile.

1Incolla il Prompt Meteo in Claude.
2Su weatherapi.com: «Get free API key», poi accedi con Google.
3Nella Dashboard scorri fino ad «API keys» e premi Copy. Non cliccare Buy né Choose a plan.
4Apri .env nella cartella del progetto, incolla la chiave dopo =, salva e dillo a Claude.
Fatto quando
  • Claude ti mostra il risultato del servizio, e la chiave è solo in .env, mai in chat.

Prompt Meteo · le previsioni per Roma da WeatherAPI.com · lo stesso testo è nella scheda, Attività 2Voglio le previsioni per Roma dei prossimi 3 giorni da WeatherAPI.com. Ho una chiave: preparami un file .env dove incollarla, così non la scrivo in chat.

.env
# Le chiavi del progetto. Non si condivide.
WEATHERAPI_KEY=incolla-qui-la-tua-chiave
# Altre chiavi, una per riga:
GESTIONALE_API_KEY=…

.env non si condivide: chi ha la chiave usa il servizio a nome tuo.

Collega il tuo servizio
AttivitàTocca a te · 6 min

Ora il servizio che serve a te: Claude ti dice come si collega, poi lo collega con te.

1Apri una nuova sessione di Claude nella cartella del tuo progetto, quello del piano della Lezione 1.
2Incolla il Prompt Scegli: Claude ti chiede quale servizio e ti dice connettore, MCP o API.
3Nella stessa chat incolla il prompt della tua strada: Connettore, MCP o API.
Fatto quando
  • Claude ti dice cosa vede nel tuo servizio.
Bloccato? Chiedi al coach
Scrivi /coach e racconta cosa succede: ti dà il prossimo passo.
Ti ferma l'azienda?
  • Un'impostazione dell'azienda ti blocca? Scrivilo nella chat: va nella lista dei blocchi.
Modelli ed effort · 5 min

Modelli e livelli di effort.

Quale modello

Quattro modelli: Opus quando non sei sicuro, Sonnet per costruire una feature.

HaikuLavori semplici e ripetitivi, facili da controllare. Per esempio rinominare cinquanta file.QualitàCosto×1
SonnetSai dire in una frase com'è il lavoro finito. Per esempio costruire una feature di piano.md.QualitàCosto×20
Opus predefinitoPianificare, scegliere, valutare, e ogni volta che non sei sicuro. Per esempio il piano della Lezione 1.QualitàCosto×40
FableLavori grandi e aperti, dove la precisione conta. Costa di più. Per esempio rivedere un progetto intero.QualitàCosto×80

Costo in scala sul prezzo; qualità in scala su un indice indipendente. Tutti e due dipendono anche dall'effort. Scegli il modello all'inizio della chat: cambiarlo a metà costa di più.

Quanto effort

L'effort è quanto Claude ragiona prima di rispondere: parti da medio.

Basso
Mediopredefinito
Alto
Extra
Max
Scendi
per le cose molto semplici
Parti da qui
va bene quasi sempre
Sali
quando noti che medio non basta
Quasi mai
costa molto, migliora poco

Più effort: risposte più accurate, ma più lente e più costose.

Model Selector
DemoGuarda · 2 min

Model Selector, un'aggiunta all'app, ti suggerisce modello ed effort: lo installi prima della Lezione 3.

Nei primi tre messaggiUn pop-up ti suggerisce modello ed effort. Scegli Switch (cambia) o Keep (tieni).
Dopo il terzoIl modello resta quello; ti suggerisce solo l'effort.
Quando dici «non va bene»Ti guida: riprova, poi più effort, poi una nuova chat con un modello più grande.
Cos'è un «mod»? Un add-on che cambia come Claude appare e come si comporta. Può essere quello che vuoi: il limite è la tua immaginazione.

Demo 1 · con Fable · domanda semplicissimaTraduci in inglese questa frase: «Il ritiro della biancheria è domani alle 8.»

Demo 2 · con Haiku · lavoro molto complessoProgetta il sistema per gestire i ritiri e le consegne di una lavanderia industriale con 40 clienti (hotel, cliniche, ristoranti) e 3 furgoni. Ogni cliente ha orari e giorni diversi, alcuni hanno penali per i ritardi. Voglio: le tabelle dei dati, come assegnare i giri ai furgoni ogni mattina, cosa succede quando un furgone si ferma, e i rischi principali del progetto. Prima di scrivere codice, fammi un piano e dimmi cosa non è chiaro.

Se un risultato non va, scrivilo chiaro: Model Selector se ne accorge solo se lo dici.

Round 1 · 8 min

Prima di costruire, guarda come sarà il risultato.

Cos'è un mockup

Un mockup è una pagina con dati inventati: anche per un Excel o un documento, ti mostra come sarà.

Come un pittore: prima lo schizzo, veloce e facile da cambiare. Poi dipingi. Il mockup è lo schizzo.

Se sarà una paginaLa pagina come sarà, con dati inventati. Per esempio un calendario con i problemi in rosso.
Se sarà un documentoUna pagina che disegna il documento. Per esempio un preventivo, già impaginato.
Se sarà un ExcelUna pagina che disegna il foglio. Per esempio i totali per cliente.
Se sarà un reportUna pagina che disegna il report. Per esempio il riepilogo del lunedì.

Lo guardi nel browser integrato, prima di costruire niente di vero.

Round 1 · Mockup
AttivitàPrima guarda · 2 minTocca a te · 4 min

Claude ti mostra come sarà la feature 1, con dati inventati, prima di costruirla.

1Rinfrescati la memoria: nella cartella del progetto scrivi /schema-piano e rileggi la feature 1 sullo schema della Lezione 1.
2Apri una nuova sessione nella cartella del progetto, scegli Sonnet e incolla il Prompt Mockup.↑ dalla Lezione 3 lo fa Model Selector
3Clicca il nome della pagina nella risposta di Claude: si apre accanto alla chat.
4Qualcosa non ti torna? Dillo a Claude con parole tue.
Fatto quando
  • Guardi il mockup e dici: sì, è questo che voglio.
Nella Desktop app
Il browser integrato è dentro l'app: la pagina resta accanto alla chat mentre chiedi le modifiche.

Prompt Mockup · come sarà la feature 1 · lo stesso testo è nel gruppo WhatsAppFammi un mockup della feature 1 del mio piano, con dati inventati, da aprire nel browser integrato. Se non c'è un piano, chiedimi cos'è la feature 1.

Round 2 · 15 min

Costruisci la feature 1, poi decidi come andare avanti.

Round 2 · Costruisci
AttivitàPrima guarda · 1 minTocca a te · 7 min

Claude costruisce la feature 1 come nel mockup, e ti chiede i file che gli servono.

1Nella stessa sessione del mockup incolla il Prompt Costruisci.
2Ti chiede dei file? Copiali nella cartella che ti indica, poi scrivi «Fatto.»
Fatto quando
  • Claude ti ha detto quali file servono (o che non ne servono) e ha iniziato a costruire.
Nella Desktop app
Guarda la lista delle cose da fare nella sessione: Claude spunta un passo alla volta. E l'indicatore del contesto: si riempie piano piano, è la memoria di questa chat.

Prompt Costruisci · la feature 1, come nel mockup · lo stesso testo è nel gruppo WhatsAppCostruisci la feature 1 come nel mockup. Se ti servono dei file, dimmi quali e dove metterli.

Round 2 · La prova
AttivitàPrima guarda · 1 minTocca a te · 3 min

Quando Claude ha finito, nella stessa sessione chiedi come provarla.

1Aspetta che Claude finisca di costruire.
2Nella stessa sessione incolla il Prompt Prova.
3Segui i passi e guarda se funziona.
Fatto quando
  • Sai come provarla e cosa devi vedere.

Prompt Prova · come provi la feature 1 · lo stesso testo è nel gruppo WhatsAppCome posso provare che questa feature funziona?

Il piano dice cosa provare; Claude, che l'ha appena costruita, ti dice come, passo per passo.

Round 2 · E adesso?
DiscussioneTutti · 11 min

La feature 1 c'è. Come ti sei trovato, e come costruiresti il resto?

1 · Come ti trovi con questo processo?Mockup, costruisci, prova: cosa ti è stato facile? Qualche difficoltà?
2 · Come andresti avanti per costruire tutto?Con le feature che restano del tuo piano.

Ogni blocco che nominate va in una lista: dopo la lezione la mandiamo a chi può sbloccarlo in azienda.

Round 2 · Come è fatto un sistema
DiscussioneTutti · 4 min

Ogni sistema ha gli stessi pezzi, come un ristorante.

LA SALAFrontendQuello che vedi e tocchi:pagine, pulsanti, moduli.IL CAMERIEREAPIPorta le richieste tra i pezzi,anche verso altri servizi.LA CUCINABackendLe regole e i calcoliche non vedi.LA DISPENSADatabaseDove restano i dati,anche quando chiudi tutto.L'INDIRIZZOHostingDove vive il sistema:sul tuo computersolo tuonlineanche i colleghi

La tua feature 1 quali pezzi ha? Chiedilo a Claude: «Quali di questi pezzi ha il mio progetto?»

Round 2 · Esempio: il cruscotto turni
DiscussioneTutti · nello stesso tempo

Il cruscotto turni: lo stesso ristorante, con i suoi nomi.

La sala · FrontendLa pagina: carichi l'Excel, scegli la settimana, vedi i problemi e chi può coprire.Oggi: controllo-turni.html
Il cameriere · APIPorta i dati avanti e indietro tra la pagina e Supabase.Già pronto, non va costruito
La cucina · BackendI controlli: turni scoperti, doppi, ferie, oltre 40 ore, 100 kg = 1 persona.Girano dentro la pagina
La dispensa · DatabaseSupabase: personale, ferie, minimi per reparto, chili previsti.L'Excel dei turni no: lo carichi ogni volta
L'indirizzo · Hosting Cloudflare, da collegare: senza, la pagina vive solo sul tuo computer; con Cloudflare è online e la apri anche dal telefono.

Il backend non è un server a parte: oggi i calcoli girano nella pagina stessa.

Round 2 · Le altre feature
DemoGuarda · 1 min

Le altre feature: Claude apre una sessione per ognuna, in parallelo.

Questa sessionecoordinaFeature 2 · mockupuna sessione suaFeature 3 · mockupuna sessione suaFeature 4 · mockupuna sessione sua

Prompt Orchestra · solo per la demoabbiamo già costruito la feature 1. adesso voglio creare un mockup di tutte le altre features. tu sarai la sessione orchestratrice. crea tutti i threads che consideri necessari per avanzare in parallelo.

Oggi guardi soltanto. Prima della Lezione 3 lo fai tu, sul tuo progetto, con un prompt come questo.

Quiz di chiusura · 3 domande · 1 min Quiz

Tre domande su quello che hai visto oggi.

1 · Scegli con che nome apparire2 · Rispondi alle tre e invia3 · Contano le risposte giuste e la rapidità
Da ricordare

Oggi: la feature 1 vista, costruita e corretta.

  • Prima di costruire hai visto la feature 1: il mockup, con dati inventati.
  • L'hai costruita e corretta guardando lo schermo, con la prova del tuo piano.md, o sai cosa ti manca.
  • Sai quale collegamento ti serve, e come scegliere modello ed effort.
Prima della Lezione 3Installi Model Selector. Claude fa in parallelo un mockup per ogni feature: tu li rivedi e li accetti. Colleghi quello che serve, chiedi a Claude quali feature costruire insieme e in che gruppi, crei un account GitHub e uno Cloudflare con l'email aziendale, e lo scrivi nel tuo diario. Non costruisci ancora. Bloccato? /coach in una chat laterale (/btw), poi il gruppo.
Lezione 3 · Costruisci, gruppo per gruppoCostruisci un gruppo di feature alla volta: Claude le costruisce e le prova, tu le provi e le approvi. Poi le salvi su GitHub e metti la pagina online, con una password.