Come creare un sito web con Claude Code: guida per principianti

Cos'è Claude Code, in parole semplici

Claude Code è un assistente di Anthropic che non si limita a rispondere: lavora sui file del tuo computer. Gli scrivi in italiano cosa vuoi, lui propone come farlo, crea e modifica i file, e ti chiede il permesso prima di toccare qualcosa.

Per un sito semplice, come una vetrina con chi sei, cosa fai e come contattarti, è uno strumento potente anche per chi non ha mai scritto una riga di codice. Ma attenzione: il giudizio resta tuo. Claude Code esegue bene se gli spieghi bene, e va sempre controllato.

In questa guida costruiamo un sito «statico»: poche pagine HTML, senza database. È il modo più semplice, veloce e sicuro per cominciare.

Cosa ti serve

• Un abbonamento a Claude che includa Claude Code: Pro, Max, Team o Enterprise. In alternativa, un account della Console di Anthropic con credito prepagato. Il piano gratuito non basta.
• Un computer con Windows 10 o successivo, oppure macOS 13 o successivo.
• Mezz'ora di tempo per la prima volta, e le idee chiare su cosa deve dire il sito.

1. Installare Claude Code

Ci sono due strade.

La più semplice: l'app Claude per computer. La scarichi da claude.com/download, entri con il tuo account e usi Claude Code dalla sua scheda dedicata, senza aprire il terminale.

Dal terminale. Su Windows apri PowerShell e scrivi:

irm https://claude.ai/install.ps1 | iex

Su Mac apri il Terminale e scrivi:

curl -fsSL https://claude.ai/install.sh | bash

Poi apri un terminale nuovo e controlla che sia tutto a posto con claude --version: deve comparire un numero di versione. Su Windows la documentazione consiglia anche di installare Git for Windows.

2. La cartella del sito e il file CLAUDE.md

Crea una cartella vuota, ad esempio il-mio-sito, e avvia Claude Code lì dentro (dal terminale: entri nella cartella e scrivi claude). Al primo avvio si apre il browser per entrare con il tuo account.

Ora il passo che fa la differenza: il file CLAUDE.md. È un promemoria che Claude Code legge all'inizio di ogni sessione, così non devi ripetergli ogni volta chi sei e come vuoi lavorare. Puoi farlo creare dal comando /init e poi correggerlo, oppure scriverlo tu. Un esempio:

# Il sito della Pizzeria da Anna
- Lingua: italiano, tono caldo e semplice
- Chi siamo: pizzeria a Lecce dal 1985, forno a legna
- Pagine: home, menu, contatti
- Contatti: WhatsApp e telefono ben visibili
- Stile: colori caldi, leggibile sul telefono
- Regole: chiedimi prima di cancellare file;
  spiegami ogni scelta in parole semplici

Tienilo breve e concreto: se è troppo lungo, le istruzioni importanti si perdono.

3. Prima il piano, poi il lavoro

L'errore più comune è chiedere subito «fammi il sito». Meglio chiedere prima un piano. Claude Code ha una modalità apposta: premi Maiusc+Tab fino a vedere la modalità piano, poi scrivi ad esempio:

Voglio un sito di 3 pagine per la mia pizzeria
(home, menu, contatti). Leggi il CLAUDE.md e
proponimi un piano: pagine, sezioni, colori.
Non creare ancora nessun file.

Leggi il piano, correggi quello che non ti convince, e solo quando sei d'accordo dai il via. Sembra tempo perso: è tempo guadagnato.

4. Costruire una pagina alla volta

Procedi per piccoli passi: prima la home, poi il menu, poi i contatti. Più sei preciso, meglio lavora. Confronta:

• generico: «aggiungi i contatti»;
• preciso: «nella pagina contatti aggiungi un pulsante verde per scriverci su WhatsApp al numero 333 123 4567, il telefono cliccabile e gli orari, con lo stesso stile della home».

Prima di creare o modificare file, Claude Code può chiederti il permesso: leggi sempre cosa sta per fare prima di dire sì. Se prende una strada sbagliata, premi Esc e correggilo subito, senza aspettare che finisca.

5. Controllare il risultato

Apri il file index.html con un doppio clic: il sito si vede nel tuo browser. Controllalo come farebbe un cliente:

• si legge bene sul telefono? Nel browser, stringi la finestra o usa la vista per dispositivi mobili;
• i pulsanti funzionano, il numero è giusto, gli orari sono aggiornati?
• si capisce in cinque secondi cosa fai e come contattarti?

Quando trovi un problema, descrivilo a Claude Code con parole tue: «sul telefono il menu copre il titolo, sistemalo». Se una modifica non ti piace, premendo due volte Esc (o con il comando /rewind) puoi tornare a un punto precedente.

6. Mettere il sito online

Un sito statico è solo una cartella di file: per pubblicarlo basta caricarli sullo spazio web del tuo hosting, di solito dal suo «file manager», con il dominio collegato. Claude Code può prepararti l'elenco dei file e i passaggi, ma gli accessi all'hosting li fai tu: password e codici non si danno all'intelligenza artificiale.

Prima di pubblicare, tre controlli che spesso si dimenticano:

• la privacy policy, e il banner dei cookie se usi statistiche come Google Analytics;
• il titolo e la descrizione di ogni pagina, quelli che compaiono su Google;
• la velocità: immagini leggere, niente file inutili.

I comandi che ti servono davvero

• Esc: ferma Claude Code mentre lavora.
• Esc due volte, oppure /rewind: torna a un punto precedente.
• Maiusc+Tab: cambia modalità, compresa quella del piano.
• /init: crea una prima versione del CLAUDE.md.
• /clear: ricomincia una conversazione pulita, quando passi a un lavoro diverso.
• /compact: riassume la conversazione quando diventa lunga.
• /usage: mostra i consumi. /help: tutti gli altri comandi.

Quando conviene farsi aiutare

Con questa guida un sito vetrina semplice lo porti a casa. Ma un sito che porta clienti chiede anche altro: le parole giuste per Google, la scheda Google collegata, la privacy in regola, la velocità sul telefono, la sicurezza. Sono cose che Claude Code sa fare, se qualcuno gli sa chiedere le cose giuste e sa controllare il risultato.

Se vuoi imparare a usarlo bene nel tuo lavoro ci sono i miei corsi di intelligenza artificiale. Se preferisci che il sito lo faccia io, trovi tutto nella pagina sui siti web.