Come si crea un'app con Claude Code?

Si parte installando Claude Code con npm install -g @anthropic-ai/claude-code, si entra nella directory del progetto e si avvia con il comando claude. Da lì si descrive in linguaggio naturale cosa si vuole costruire e Claude Code propone le modifiche da approvare.

Quanto tempo ci vuole per costruire un'app con Claude Code?

Dipende dalla complessità. Un MVP funzionante con landing page, backend e database può richiedere poche ore di lavoro con Claude Code. Il vantaggio principale è la velocità di iterazione: si passa dall'idea al codice funzionante molto più rapidamente che scrivendo tutto a mano.

Claude Code può deployare l'app in produzione?

Claude Code può eseguire comandi di deploy se gli dai i permessi necessari. Può fare git push, eseguire script di build, interagire con CLI di piattaforme cloud. La raccomandazione è approvare esplicitamente ogni azione di deploy prima che venga eseguita.

Come creare un'app con Claude Code: guida pratica

Costruire un'applicazione con Claude Code è diverso da qualsiasi altra esperienza di sviluppo. Non stai scrivendo codice riga per riga, non stai incollando snippet da StackOverflow. Stai descrivendo cosa vuoi, approvando le modifiche e guidando un agente AI che lavora in autonomia.

Questa guida mostra il workflow reale — quello che uso per costruire i prodotti di AiNextStudio come FunnelManager e ColloquioAI.

Prerequisiti

Node.js installato (versione 18 o superiore)
Account Anthropic con piano Pro o chiave API
Conoscenza base del terminale (navigare directory, leggere output)
Git installato (fortemente consigliato)

Non serve saper programmare in modo approfondito. Serve capire la logica di base di cosa stai costruendo e saper leggere il codice che Claude propone — anche solo superficialmente.

Installazione

npm install -g @anthropic-ai/claude-code

Al primo avvio (claude da terminale) ti chiederà di autenticarti con il tuo account Anthropic. Segui le istruzioni — è una procedura di due minuti.

Prima di iniziare: definisci bene il progetto

Il punto che fa la differenza più grande nei risultati non è tecnico — è la qualità della descrizione iniziale.

Descrizione vaga → risultato mediocre:

"Crea una landing page per il mio servizio."

Descrizione precisa → risultato eccellente:

"Crea una landing page in PHP per uno studio di consulenza fiscale a Roma. Struttura: nav con logo e link, hero con headline e sottotitolo e CTA 'Prenota una consulenza', sezione servizi con 3 card (dichiarazioni redditi, partite IVA, contabilità), sezione chi siamo con foto placeholder, form contatto con nome/email/telefono/messaggio che invia email via mail() a info@studio.it. Design: sfondo scuro navy (#1e293b), testo chiaro, accenti in oro (#c8a84b). Font Google Montserrat. Mobile responsive. Senza framework CSS esterni."

Più dettagli dai all'inizio, meno iterazioni servono dopo.

Il workflow in 5 fasi

Fase 1: Struttura base

Inizia chiedendo solo lo scheletro. Non chiedere tutto insieme.

claude

> Crea la struttura base del progetto: index.php con HTML semantico, 
  le sezioni definite, senza stile ancora. Voglio vedere l'ossatura prima.

Claude mostrerà cosa intende creare. Approva con y, rifiuta con n, chiedi spiegazioni con il testo libero.

Fase 2: Stile

Una volta validata la struttura, aggiungi il CSS:

> Ora aggiungi il CSS inline nel tag <style>. Design dark, 
  sfondo #1e293b, accenti in #c8a84b, font Montserrat da Google Fonts, 
  completamente responsive mobile-first.

Fase 3: Funzionalità

Implementa la logica un pezzo alla volta:

> Aggiungi la gestione del form: PHP che valida i campi lato server, 
  invia email via mail() e mostra un messaggio di conferma senza ricaricare 
  la pagina (usa fetch API e una risposta JSON).

Fase 4: Review e debug

Testa nel browser. Se c'è un errore, incollalo direttamente in Claude Code:

> Ho questo errore nel browser: 
  "Uncaught TypeError: Cannot read properties of null (reading 'addEventListener')"
  
  Cosa sta succedendo e come si risolve?

Claude analizzerà il codice esistente nel tuo progetto e proporrà la correzione diretta nel file corretto.

Fase 5: Ottimizzazione

> Aggiungi meta description, og:title, og:image e schema JSON-LD 
  di tipo LocalBusiness. Aggiungi anche il tag canonical.

Comandi utili durante la sessione

/help — elenco di tutti i comandi disponibili
/clear — resetta il contesto (utile se la sessione diventa confusa)
/compact — compatta il contesto per sessioni lunghe
!ls, !git status — esegui comandi shell senza uscire
Ctrl+C — interrompi un'operazione in corso

Cosa funziona molto bene

Costruire landing page da zero in PHP: eccellente
Aggiungere feature a progetti esistenti: molto buono
Refactoring e pulizia del codice: ottimo
Debug di errori con stack trace: ottimo
Integrazione API di terze parti: buono
Scrittura di query SQL: molto buono

Cosa richiede attenzione

File di configurazione: leggi sempre prima di approvare modifiche a .env, nginx.conf, package.json
Operazioni distruttive: cancellazione file, reset database — chiedi sempre conferma esplicita
Codice di sicurezza: input utenti, autenticazione — revisionali manualmente
Sessioni troppo lunghe: dopo molte ore di sessione il contesto degrada. Usa /compact o inizia una nuova sessione

Usa sempre git

Prima di ogni sessione di Claude Code:

git add -A && git commit -m "checkpoint pre-claude-session"

Se qualcosa va storto, puoi tornare indietro in qualsiasi momento. È la rete di sicurezza più importante.

Un esempio reale

Ho costruito la landing page di FunnelManager con Claude Code in una sessione di circa 3 ore. Il risultato: oltre 600 righe di PHP/CSS, responsive, con GA4, Meta Pixel CAPI, cookie banner GDPR-compliant, schema JSON-LD e sitemap XML dinamica. Tempo stimato senza AI: 2-3 giorni di lavoro.

Non ho scritto una singola riga di codice manualmente. Ho descritto, approvato, testato, corretto. Questo è il vibe coding che funziona davvero.

Prossimi passi

Ora che sai come iniziare, approfondisci: