Claude Code: la Guida Completa in Italiano (2026)

Claude Code è l'agente AI di Anthropic per il vibe coding. Lanciato nel 2025, nel 2026 è tra gli strumenti più usati del settore e tra quelli su cui circolano più fraintendimenti. Questa guida spiega cos'è, come si usa, quanto costa e quando conviene sceglierlo rispetto a Cursor o Lovable.

Se sei arrivato qui cercando "Claude Code cos'è", "Claude Code come si usa" o "Claude Code ultraplan", trovi tutto spiegato in modo pratico e diretto.

Cos'è Claude Code in 3 righe

Claude Code è un agente AI che lavora nel tuo terminale. È un'applicazione CLI (Command Line Interface, interfaccia a riga di comando): la lanci dentro una cartella di progetto, descrivi cosa vuoi in italiano o in inglese, e Claude legge i file, li modifica, ne crea di nuovi, esegue comandi, testa e corregge, restando dentro il tuo ambiente di sviluppo reale.

Lavora con te sul codice con la stessa capacità di ragionamento del modello Claude Opus 4.7, o delle sue varianti più veloci come Sonnet e Haiku.

Come funziona concretamente (il workflow)

Il flusso è sempre lo stesso: apri il terminale nella cartella del progetto, lanci claude, descrivi in italiano cosa ti serve. Claude legge i file per capire com'è fatto il progetto, propone le modifiche, le applica dopo la tua conferma e ti dice cosa resta da completare a mano.

Il caso concreto: un progetto Next.js a cui aggiungere l'autenticazione Google OAuth. Senza un agente il percorso era:

1. Cercato su Google/Stack Overflow
2. Trovato 3 tutorial datati
3. Copiato pezzi
4. Adattato per ore

Con Claude Code:

cd miei-progetti/miaapp
claude

Si apre una sessione interattiva. Scrivi:

"Aggiungi autenticazione Google OAuth usando Clerk. Proteggi la route /dashboard. Crea un tasto di login nel Header."

Claude risponde analizzando il progetto (legge package.json, app/layout.tsx, struttura cartelle), poi:

1. Installa il pacchetto @clerk/nextjs
2. Crea .env.local.example con le chiavi necessarie
3. Modifica app/layout.tsx per aggiungere <ClerkProvider>
4. Crea il middleware di protezione route
5. Modifica il Header per aggiungere bottone
6. Spiega cosa ha fatto e cosa devi completare manualmente (es. creare account Clerk)

In 90 secondi. Senza mai lasciare il terminale.

Installazione: da zero in 2 minuti

Claude Code funziona su macOS, Linux e Windows (WSL).

Step 1: installa via npm (globale)

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

Step 2: autentica

Al primo lancio in una cartella:

claude

Ti verrà chiesto di fare login. Due opzioni:

• Claude.ai Pro/Max subscription: login con account Anthropic (incluso se sei già abbonato a Claude)
• API key: genera una chiave API dalla console Anthropic (pay-per-use)

Step 3: inizia

Ora in qualsiasi cartella di progetto:

cd mio-progetto
claude

E la sessione parte. Tutto qui.

I comandi che usi davvero (il 90% del tempo)

I comandi che contano sono pochi. Per la maggior parte del lavoro scrivi la richiesta in italiano. Poi servono /init per creare il file di istruzioni del progetto, /compact quando la sessione si allunga, /cost per controllare la spesa e @nomefile per puntare Claude su un file preciso. Il resto si usa di rado.

Dentro una sessione Claude Code:

Il comando @file è particolarmente potente: invece di lasciare a Claude indovinare cosa leggere, gli dici esattamente il file. Risparmia token e aumenta precisione.

Il file CLAUDE.md: perché è fondamentale

Eseguire /init crea un file CLAUDE.md nella radice del progetto. Questo file viene letto automaticamente da Claude all'inizio di ogni sessione futura.

Dentro ci scrivi:

• Il tech stack usato (es. "Next.js 16, Tailwind v4, Prisma")
• Convenzioni di codice ("usa sempre cn() per classi condizionali")
• Path aliases (@/ = root)
• Pattern di progetto ("per le API uso sempre il pattern Zod + try/catch")
• Cose da NON fare ("mai modificare prisma/schema.prisma senza chiedere")

Esempio minimo:

# Progetto MyApp

## Tech Stack
- Next.js 16 (App Router)
- Prisma + PostgreSQL
- Tailwind CSS v4
- Clerk per auth

## Convenzioni
- Usa `'use client'` solo quando strettamente necessario
- Prediligi Server Components
- Tutti i fetch in `lib/queries.ts`

## Da non fare
- Mai modificare migrations esistenti
- Mai committare `.env`

Un CLAUDE.md ben scritto migliora la qualità del codice generato del 40-60%.

Claude Code vs Cursor vs Lovable: quando usare cosa

In sintesi: Claude Code per intervenire su progetti esistenti e complessi dal terminale, Cursor per scrivere codice vedendolo in un editor visuale, Lovable per partire da zero e andare online senza gestire infrastruttura. I tre si usano spesso insieme, in quest'ordine. Sotto trovi i criteri per ciascuno.

Usa Claude Code quando:

• Hai un progetto grande esistente e vuoi modifiche chirurgiche
• Sei a tuo agio col terminale
• Vuoi il miglior ragionamento sul codice complesso
• Devi fare refactoring / migration / code review
• Vuoi esecuzione autonoma (l'agente completa task end-to-end)

Usa Cursor quando:

• Vuoi vedere il codice mentre viene scritto (GUI)
• Preferisci un editor visivo con AI integrata
• Lavori su progetti medi e alterni codice manuale + AI
• Il team ha già VS Code come standard

Usa Lovable quando:

• Stai creando da zero e vuoi deploy immediato
• L'UI visuale conta (Lovable genera design più curato)
• Non vuoi gestire infrastruttura
• Sei non-developer o designer che prototipa

La verità: molti dei nostri studenti VibeDojo usano tutti e tre. Lovable per il prototipo iniziale → esporta codice → lo continuano con Claude Code per il lavoro serio.

Quanto costa Claude Code: prezzi, piani e Ultraplan

Lo strumento si installa gratis: quello che paghi è l'uso del modello. Per un uso leggero basta il piano Pro da 20 dollari al mese; per un uso quotidiano serve Max a 100; Ultraplan a 200 è pensato per chi lavora tutto il giorno sul codice. L'API a consumo conviene solo se sai già quanto consumi.

Claude Code si paga quindi in due modi:

1. Subscription Claude.ai (Pro / Max / Ultraplan)

• Pro: 20$/mese, limitato per un uso intenso di Claude Code
• Max: 100$/mese, molto più credito, adatto a un uso professionale quotidiano
• Ultraplan: 200$/mese, lanciato nel 2026, include Claude Code con limiti ampliati (spesso 5-10 volte il Max)

2. API pay-per-use (Anthropic Console)

Paghi per token consumati:

• Opus 4.7: ~$15/MTok input, $75/MTok output
• Sonnet 4.6: $3/MTok input, $15/MTok output
• Haiku: $1/MTok input, $5/MTok output

Quale scegliere?

• Uso leggero (1-2 ore/settimana): Pro va bene
• Uso quotidiano: Max
• Uso intensivo / produzione: Ultraplan o API con Sonnet per la maggior parte dei task
• Team/azienda: valuta credit package enterprise

Nel corso Cintura Bianca VibeDojo insegniamo a ottimizzare i costi scegliendo il modello giusto task per task (Sonnet per l'80% dei casi, Opus solo per ragionamenti complessi).

Esempio pratico: costruisci un blog in 20 minuti

Scenario: hai una cartella vuota, vuoi un blog Next.js con Tailwind.

mkdir mio-blog && cd mio-blog
claude

Prompt:

"Crea un blog statico con Next.js 16, Tailwind v4, e shadcn/ui. I post sono in markdown dentro content/posts/. Homepage con lista post ordinati per data. Pagina /post/[slug] con rendering del markdown. Include un layout minimalista con font Inter."

Claude (in ~3-5 minuti):

1. Esegue npx create-next-app@latest . --typescript --tailwind --app
2. Installa gray-matter, next-mdx-remote, reading-time
3. Crea struttura content/posts/, lib/posts.ts, app/post/[slug]/page.tsx
4. Aggiunge shadcn/ui config
5. Crea un primo post di esempio
6. Ti dice come lanciare: npm run dev

A quel punto tu fai npm run dev, apri http://localhost:3000, vedi il blog funzionante. Se manca qualcosa, dici "sistema questo" e continua.

Qualità del codice: production-ready nel 70-80% dei casi. Quel 20-30% richiede iterazione.

I 5 errori più comuni (e come evitarli)

Gli errori che vediamo più spesso sono sempre gli stessi cinque: prompt troppo vaghi, nessun file CLAUDE.md nel progetto, modifiche accettate senza leggere il diff, troppe cose chieste insieme e nessun controllo sul consumo di token. Costano tempo e credito, e si evitano tutti con qualche minuto di attenzione.

1. Prompt troppo vaghi

Sbagliato: "Fammi un'app di ricette"

Giusto: "Crea un'app Next.js per gestire ricette personali. Utente autenticato con Clerk. Salva su Supabase. Campi: titolo, ingredienti, procedimento, tempo. Possibilità di cercare per ingrediente."

2. Non usare CLAUDE.md

Senza contesto, Claude fa scelte generiche. Spendi 5 minuti a scrivere un CLAUDE.md all'inizio: ti risparmierà ore di correzioni.

3. Accettare cambi senza revisione

Claude mostra il diff prima di applicare. Leggilo. Se qualcosa non ti torna, premi Esc e correggi il prompt.

4. Lasciarlo lavorare su troppo in parallelo

"Aggiungi auth, crea il pagamento, fai la landing page e modifica il tema" → risultato mediocre. Dividi i task.

5. Ignorare il consumo credit/token

Claude Code può bruciare tanti token su progetti grossi. Usa /cost regolarmente, usa Sonnet per task semplici, Opus per i complessi.

FAQ

Claude Code è gratuito? No. Serve almeno un abbonamento Claude.ai Pro (20$/mese) o crediti API. Esiste un trial breve per provarlo.

Posso usare Claude Code senza conoscere il terminale? Tecnicamente sì, ma non lo consigliamo. Anche solo per installarlo servono comandi base. Se il terminale ti spaventa, inizia con Lovable o Cursor, poi passi a Claude Code dopo 2-3 mesi.

Claude Code legge i miei file privati? Sì, all'interno del progetto in cui lo lanci. I file sono inviati ad Anthropic come parte del prompt. Non lanciarlo in cartelle con segreti non gitignorati.

Il codice generato è mio o di Anthropic? Tuo. Anthropic lo dichiara esplicitamente nei ToS: il codice generato appartiene all'utente.

Funziona con linguaggi non inglesi? Sì. Puoi scrivere prompt in italiano, francese, spagnolo, tedesco. Claude risponde nella stessa lingua del prompt (anche se il codice generato usa convenzioni inglesi come standard).

Cos'è "Ultraplan"? Un piano subscription introdotto nel 2026 da Anthropic che offre accesso espanso a Claude Code con limiti 5-10x rispetto al piano Max. Pensato per chi usa Claude Code ogni giorno per ore.

Differenza tra Claude Code e Claude Desktop? Claude Desktop è l'app GUI standard per chattare con Claude. Claude Code è un agente CLI che lavora sul filesystem reale. Casi d'uso diversi: chat generica vs sviluppo software agentico.

Posso usare Claude Code in VS Code? Sì. Esiste un'estensione ufficiale che integra Claude Code nel terminale VS Code. Funzionalità identica al CLI.

Vuoi imparare Claude Code con un percorso strutturato?

Claude Code è potente ma ha una curva di apprendimento. Nel nostro Corso Cintura Bianca di VibeDojo insegniamo:

• Come configurare Claude Code per progetti italiani
• Pattern di prompt che funzionano
• Come combinarlo con Cursor, Lovable, Replit
• Ottimizzazione costi
• Workflow agentico avanzato

È gratuito, in italiano, con community dedicata.

Inizia la Cintura Bianca, gratis

Articolo a cura di Federico Costa e il team VibeDojo. Aggiornato: aprile 2026. Le informazioni su piani, prezzi e modelli sono verificate a questa data e soggette a cambiamenti da parte di Anthropic.