Cos'è Claude Code e come funziona

Claude Code è lo strumento a riga di comando (CLI) sviluppato da Anthropic che porta l'intelligenza artificiale direttamente nel terminale. Non è un chatbot, non è un assistente da browser: è un agente AI che lavora dentro il tuo progetto, legge i tuoi file, scrive codice, esegue comandi e fa modifiche reali al codebase.

In breve: Claude Code è un agente di programmazione che lavora sui tuoi file invece di limitarsi a suggerire codice in chat. Si installa con un comando, funziona con un abbonamento Claude Pro o superiore (o con l'API) e si usa da terminale, dalle estensioni per VS Code e JetBrains, dall'app desktop e dal browser.

Se hai sentito parlare di agenti AI per sviluppatori negli ultimi mesi, probabilmente hai incrociato Claude Code. Ma cosa lo rende diverso da tutti gli altri strumenti?

Come funziona Claude Code

Il metodo consigliato da Anthropic è l'installer nativo, che si aggiorna da solo in background. Su macOS, Linux e WSL:

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

Su Windows c'è l'equivalente per PowerShell, oppure winget install Anthropic.ClaudeCode; su Mac vale anche Homebrew (brew install --cask claude-code). Resta disponibile pure l'installazione via npm (npm install -g @anthropic-ai/claude-code), che oggi richiede Node.js 22 o successivo.

Una volta avviato, ha accesso all'intera struttura del progetto: può leggere file, modificarli, creare nuovi file, eseguire comandi di shell, fare operazioni git e persino installare dipendenze.

La differenza fondamentale rispetto a ChatGPT o al Claude standard nel browser è questa: Claude Code non ti restituisce solo il codice da copiare e incollare. Lo scrive direttamente nei file, chiede conferma prima di ogni modifica potenzialmente distruttiva e mantiene il contesto dell'intero progetto durante tutta la sessione.

Cosa può fare Claude Code in pratica

• Editing multi-file: modifica contemporaneamente più file del progetto, mantenendo la coerenza tra di essi. Se rinomini una funzione, aggiorna tutti i file che la chiamano.
• Integrazione git: legge la storia dei commit, crea branch, fa commit con messaggi sensati, gestisce merge.
• Esecuzione comandi: lancia build, test, script npm, comandi bash — tutto senza uscire dalla sessione di Claude Code.
• Navigazione codebase: analizza strutture complesse, capisce architetture, trova la causa di bug, suggerisce refactoring.
• Integrazione MCP: si connette a servizi esterni (database, API, filesystem remoto) tramite il protocollo Model Context Protocol.
• Slash commands: comandi predefiniti come /help, /clear, /compact per gestire la sessione.

Dove si usa Claude Code

Il terminale è la casa d'origine, ma il motore è lo stesso in tutte le superfici, quindi file di istruzioni, impostazioni e server MCP funzionano ovunque:

• Terminale: la versione più completa
• VS Code e JetBrains: estensione con diff direttamente nell'editor
• App desktop: scheda Code, utile per rivedere i diff a colpo d'occhio e tenere più sessioni in parallelo
• Web (claude.ai/code): per lanciare task lunghi senza installare nulla, anche da telefono

Personalizzarlo: CLAUDE.md, skill e hook

Tre strumenti fanno la differenza tra un uso occasionale e un flusso di lavoro serio. Il primo è CLAUDE.md, un file di testo nella radice del progetto che Claude legge a ogni sessione: ci metti le regole del progetto, le librerie da usare, le cose da non toccare. Le skill impacchettano procedure ripetibili (una revisione, un deploy) richiamabili con un comando. Gli hook eseguono comandi automatici prima o dopo le azioni dell'agente, per esempio una formattazione dopo ogni modifica. In più puoi delegare a più subagenti in parallelo e programmare attività ricorrenti.

La differenza con Claude nel browser

Quando parli con Claude su claude.ai, stai facendo una conversazione. Claude risponde con testo, suggerisce codice che devi copiare manualmente, non vede i tuoi file e non può eseguire nulla.

Claude Code è diverso per natura. Ha accesso al filesystem, può agire in autonomia su task multi-step, mantiene il contesto dell'intero progetto. È la differenza tra avere un consulente che ti da consigli al telefono e avere qualcuno seduto accanto a te alla tastiera.

Per approfondire le differenze, leggi anche: Claude Code vs Claude Desktop: quali differenze ci sono.

Il sistema di permessi

Claude Code non agisce di nascosto. Prima di modificare file o lanciare comandi ti mostra cosa intende fare e aspetta la tua approvazione: puoi accettare, rifiutare o chiedere spiegazioni.

Per non approvare a mano le stesse operazioni cento volte puoi definire regole permanenti nelle impostazioni: consentire sempre certe letture o comandi sicuri e tenere la conferma obbligatoria per quelli rischiosi, come cancellare file o toccare la produzione. Conviene scrivere le regole in modo preciso: una regola troppo larga approva anche varianti che non volevi.

Per chi è fatto Claude Code

Claude Code non è per chi vuole solo "chiedere qualcosa all'AI". È pensato per:

• Sviluppatori che vogliono accelerare il lavoro quotidiano senza uscire dal terminale
• Builder digitali che costruiscono prodotti web, app, SaaS
• Founder tecnici che gestiscono il codice del proprio prodotto
• Chiunque pratichi vibe coding in modo professionale

Non è adatto a chi non ha mai visto del codice. Capire quando approvare o rifiutare le modifiche richiede una base tecnica minima.

Quanto costa Claude Code

Il piano gratuito di Claude non include Claude Code. Ti serve uno di questi:

• Claude Pro: $20 al mese ($17 con pagamento annuale). Basta per un uso personale o professionale moderato, ma ha limiti d'uso a finestre: non è illimitato.
• Claude Max: da $100 al mese per chi lavora tutto il giorno con l'agente (5 volte l'uso di Pro), fino a $200 con il livello 20x.
• Team e Enterprise: per aziende; nel piano Team Claude Code è disponibile sui posti Premium.
• API Anthropic a consumo: si paga per token, conviene per uso saltuario molto intenso o per automazioni.

Ho messo tutti i numeri e i confronti aggiornati nella guida ai prezzi e piani di Claude Code.

Limiti da conoscere

Claude Code è potente ma non infallibile:

• Contesto limitato: su progetti molto grandi può perdere il filo delle dipendenze tra file
• Non sostituisce la comprensione: approvare codice che non capisci porta a problemi difficili da debuggare
• Richiede internet: non funziona offline
• Curva di apprendimento: i primi giorni serve familiarizzare con il workflow di approvazione

Come iniziare subito

Se vuoi partire, il percorso pratico è questo:

1. Crea un account su anthropic.com e scegli un piano a pagamento (il gratuito non include Claude Code)
2. Installa Claude Code con il comando nativo qui sopra (Node.js non serve)
3. Entra in un progetto di test (non in produzione per le prime volte)
4. Avvia Claude con claude e descrivi cosa vuoi fare

Per una guida pratica su come costruire un'app da zero, leggi: Come creare un'app con Claude Code.