Claude Code: la Guida Completa in Italiano (2026)

Claude Code è l'agente AI di Anthropic per il vibe coding. Lanciato nel 2025 e cresciuto esponenzialmente nel 2026, è diventato uno degli strumenti più potenti del settore — e anche uno dei più fraintesi. Questa guida chiarisce cos'è davvero, come si usa, quanto costa, e quando ha senso sceglierlo rispetto ad alternative come 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: lo lanci dentro una cartella di progetto, descrivi cosa vuoi in linguaggio naturale (italiano o inglese), e Claude legge/modifica/crea file autonomamente, esegue comandi, testa e debugga — tutto all'interno del tuo ambiente di sviluppo reale.

Non è un autocompleter. Non è una chat separata. È un collaboratore agente che lavora con te sul codice, con la stessa potenza di ragionamento del modello Claude Opus 4.7 (o delle sue varianti più veloci come Sonnet/Haiku).

Come funziona concretamente (il workflow)

Immagina questa scena: hai un progetto Next.js. Vuoi aggiungere autenticazione via Google OAuth. In passato avresti:

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)

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

Domanda ricorrente. Risposta onesta:

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.

Prezzi e "Ultraplan" — Chiarimenti

Claude Code si paga in due modi:

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

• Pro: 20$/mese — limitato per uso intenso di Claude Code
• Max: 100$/mese — molto più credito, adatto a uso professionale quotidiano
• Ultraplan: 200$/mese — lanciato nel 2026, include Claude Code con limiti ampliati (spesso ~5-10x 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)

1. Prompt troppo vaghi

❌ "Fammi un'app di ricette" ✅ "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.