Prepara il posto di lavoro e lo scheletro dell'app

Installi Claude Code, gli dai una cartella e scrivi il primo prompt: alla fine hai lo scheletro dell'app delle spese, con il menu e quattro schermate. E impari a tornare indietro.

Perché conta

Sapere che ogni modifica si può annullare toglie la paura di provare: è la cosa che rende possibile tutto il resto della serie.

In pratica

Sai aprire Claude Code su una cartella, chiedere prima il piano, approvare una modifica alla volta e riavvolgere quando qualcosa non ti piace.

Oggi prepari il posto di lavoro: installi Claude Code, gli dai una cartella e scrivi il tuo primo prompt. Alla fine hai lo scheletro dell'app delle spese, con il menu e le quattro schermate che riempiremo nelle prossime puntate. Non serve saper programmare: serve seguire i passi in ordine, e sapere che ogni modifica si può annullare.

Cosa ti serve

• Un computer con **Windows** oppure un **Mac**: va bene quello di tutti i giorni.
• Un account Claude con l'abbonamento **Pro**. L'app si scarica gratis, ma Claude Code, la parte che scrive il codice, c'è solo negli abbonamenti a pagamento. Se hai già Pro per la chat, non paghi niente in più.
• Nient'altro: niente programmi da sviluppatori, niente finestre nere con i comandi. L'app contiene già tutto.

Claude Code è un aiutante che lavora dentro una cartella del tuo computer. Tu gli scrivi cosa vuoi, come in una chat, e lui crea e modifica i file al posto tuo. Prima di toccarli ti fa vedere cosa sta per fare.

Scarica e installa l'app

1. Apri **claude.com/download** nel browser. Su Windows premi **Scarica per Windows**; su Mac scorri fino a **Desktop** e premi **Scarica** accanto a **macOS**.

2. Su Windows apri il file appena scaricato, nella cartella Download, e segui le schermate. Su Mac apri il file e trascina l'icona di Claude nella cartella Applicazioni (questo passo è preso dalla guida ufficiale: noi abbiamo provato su Windows).

3. Apri Claude e accedi con il tuo account, lo stesso che usi sul sito.

4. In alto a sinistra ci sono due piccoli tasti: il fumetto è la chat, il simbolo **</>** è **Code**. Premi **</>**: da qui in poi si lavora lì. La chat normale resta dov'era.

Prepara la cartella

Il progetto vive in una cartella del tuo computer, come un fascicolo che tiene insieme tutti i fogli di una pratica. L'app la chiama **ambiente**: una cartella con un nome, su cui l'AI lavora.

1. Crea una cartella vuota e chiamala **app-spese**, per esempio dentro Documenti.

2. Nell'app, al centro della pagina, premi **Scegli ambiente** e poi **Nuovo ambiente**.

3. Nella finestra lascia la scheda **Locale** (vuol dire «sul mio computer») e compila: **Nome** App Spese; **Esegui in** Questo computer; **Cartelle**: premi **+ Aggiungi** e scegli la cartella app-spese. Lascia **Worktree** senza spunta: serve a chi lavora su più versioni insieme.

4. Premi **Crea ambiente**. Al centro ora vedi App Spese con la spunta.

Quanta libertà dare all'AI

Sotto il riquadro dove si scrive, accanto ad App Spese, c'è la **modalità**: dice quanto l'AI può fare da sola. All'inizio è su **Auto**, e ogni conversazione nuova riparte da lì. Premila e si apre il menu.

• **Auto**: l'AI decide da sola cosa può fare. L'app la segna come consigliata, perché è la più comoda.
• **Manuale**: propone ogni modifica e aspetta il tuo sì.
• **Accetta modifiche**: modifica i file senza chiedere.
• **Piano**: ti spiega cosa farebbe, senza toccare niente.
• **Ignora autorizzazioni**, in fondo, con il tasto **Abilita**: toglie ogni controllo. Non abilitarlo.

Auto è comoda, ma mentre impari lavora tra **Piano** e **Manuale**. È più lento, e vedi tutto quello che succede: come quando affianchi l'idraulico invece di lasciargli le chiavi di casa.

Il primo prompt

Prima di scrivere, metti la modalità su **Piano**: l'AI ti dirà cosa intende fare, senza toccare niente. È come chiedere un preventivo prima di far partire i lavori. Poi copia questo prompt e incollalo nel riquadro.

Leggi il piano e approvalo

L'AI risponde con il piano in tre punti e, sotto, il riquadro **Claude ha proposto un piano** con quattro tasti.

• **Accetta**: va bene, procedi. Premi questo.
• **Accetta e usa la modalità automatica**: il tasto grande accanto ad **Accetta**, il più in vista (nelle versioni meno recenti dell'app si chiama «Accetta e modalità automatica»). Approva il piano e lascia l'AI libera di fare tutto da sola. Per ora no.
• **Rivedi…**: vuoi cambiare qualcosa. Scrivi cosa, e l'AI rifà il piano.
• **Rifiuta**: non se ne fa niente.

Guarda il nome scritto sul tasto, non il colore: se usi l'app con il tema scuro, i colori sono invertiti rispetto alle nostre schermate.

Prima di proporre il piano l'AI guarda cosa c'è già nella cartella. Se trova un file con lo stesso nome, te lo dice e chiede se sostituirlo: leggere il piano serve anche a questo.

Dopo **Accetta** la modalità passa a **Manuale** e l'AI chiede il permesso prima di creare il file: **Consentire a Claude di scrivere index.html?** Sotto vedi il contenuto del file, riga per riga. In basso ci sono **Nega** e un tasto più grande, con una freccia accanto.

Quello che ti serve è **Consenti una volta**: sì solo a questa modifica, e alla prossima l'AI chiederà di nuovo. Leggi cosa c'è scritto sul tasto grande. Nella nostra prova diceva **Consenti sempre**, cioè sì a questa modifica e a tutte le prossime: in quel caso non premerlo, apri la freccia e scegli **Consenti una volta**. Nelle versioni più recenti dell'app il tasto grande dice già **Consenti una volta**, e basta premerlo.

Controlla il risultato

Spesso l'AI apre la pagina da sola, in un riquadro del browser dentro l'app. Puoi anche aprirla tu: nella cartella app-spese ora c'è il file index.html, e con un doppio clic si apre nel browser.

Prova tu: cambia una cosa e annullala

L'esercizio più importante della puntata. Claude Code ricorda com'erano i file prima di ogni tua richiesta, e puoi tornare indietro.

1. Scrivi: «Cambia il titolo in Spese di casa». Ricarica la pagina: il titolo è cambiato.

2. Ora scrivi **/rewind** nel riquadro. Si apre **Riavvolgi**, con l'elenco dei tuoi messaggi.

3. Scegli «Cambia il titolo in Spese di casa»: vuol dire «torna a prima di questo messaggio».

4. Nella finestra **Tornare a questo messaggio?** lascia **Ripristina: Codice e conversazione** e premi **Riavvolgi**.

5. Ricarica la pagina: il titolo è tornato «Le mie spese».

Cosa hai imparato

• Claude Code lavora dentro una cartella che scegli tu, e non tocca nient'altro.
• Un'app si costruisce a strati: prima lo scheletro, poi una schermata alla volta.
• Una buona richiesta è piccola, precisa e con dei limiti.
• Prima di lavori grossi si chiede il piano; mentre impari, si approva ogni modifica.
• Se qualcosa va storto, si riavvolge.