Claude Code: come funziona e perché cambia il modo di programmare
Claude Code è un agente AI da terminale che legge il tuo codice, lo modifica, esegue comandi e fa debug autonomamente. Guida pratica: installazione, comandi base, use case reali.
Pubblicato: 3 giugno 2025
GitHub Copilot suggerisce la riga successiva mentre scrivi. Claude Code è diverso: è un agente che vive nel terminale, legge l’intero progetto, modifica file, esegue comandi shell, legge l’output, corregge gli errori e itera — da solo.
La differenza concreta: con Copilot scrivi // funzione che ordina array e ti completa la funzione. Con Claude Code scrivi “aggiungi autenticazione JWT a questa Express app” e lui legge tutti i file, capisce la struttura, installa le dipendenze mancanti, modifica quello che serve, e ti dice cosa ha fatto. Cursor è più simile a Claude Code, ma rimane dentro l’editor e non esegue comandi shell in autonomia.
Installazione
Node.js 18+ richiesto. Poi:
npm install -g @anthropic-ai/claude-code
claude --version
Al primo avvio si autentica via browser OAuth con il tuo account Anthropic. Nessun file di config da toccare.
Avvio in un progetto:
cd /mio/progetto
claude
Sei nel REPL interattivo. Parli con l’agente in linguaggio naturale.
Come si usa in pratica
Comandi slash utili da sapere:
/add src/ → aggiunge file/cartelle al contesto
/clear → svuota il contesto
/status → mostra i file nel contesto corrente
/commit → crea un commit git con messaggio generato
/bash <cmd> → esegue un comando shell specifico
Esempio reale. Hai un’app Express senza autenticazione:
> /add src/
> Aggiungi autenticazione JWT. Usa jsonwebtoken e bcryptjs.
Crea endpoint /auth/register e /auth/login.
Proteggi le route esistenti con middleware.
Claude Code legge src/, capisce le route esistenti, installa i pacchetti via npm, crea il middleware, modifica app.js, aggiunge la protezione. Se c’è un errore di sintassi o una dipendenza mancante, lo vede nell’output e si corregge prima di mostrarti il risultato. Tu non hai scritto una riga di codice.
Stesso approccio per task sysadmin:
> Scrivi uno script bash che controlla ogni 5 minuti se nginx è attivo,
lo riavvia se necessario, logga tutto in /var/log/nginx_monitor.log con timestamp
Ti scrive lo script, lo rende eseguibile, suggerisce come aggiungerlo a cron.
Quando usarlo e quando no
Funziona bene su progetti di dimensioni medie con struttura chiara. Se hai 500.000 righe di codice legacy senza documentazione, il contesto si perde — meglio isolare la porzione su cui lavorare.
Non dargli accesso a database di produzione con dati reali. Non usarlo se il tuo contesto di sicurezza non permette codice verso server cloud — Claude Code manda i file ai server Anthropic.
Per le modifiche autonome: fai sempre git diff prima di ogni commit per vedere esattamente cosa ha cambiato. L’agente lavora in autonomia, ma tu devi restare nel loop.
Costo
Claude Pro ($20/mese): include Claude Code con rate limiting. Sufficiente per uso occasionale.
Claude Max ($100/mese): uso illimitato, modelli più potenti. Se lo usi 2–3 ore al giorno, si ripaga in tempo risparmiato.
API a consumo: paga per token. Un task medio di refactoring costa qualche centesimo. Ottimo per valutare lo strumento prima di abbonarsi.
Cosa fare
- Installa con
npm install -g @anthropic-ai/claude-codee apri un progetto che conosci bene. - Prova un task semplice prima: “aggiungi gestione degli errori a questa funzione” o “scrivi un test per questo modulo”.
- Scala la complessità solo dopo aver capito come l’agente lavora — e controlla sempre il diff prima del commit.