Claude Code: un resoconto di esperienza su due progetti reali

La produzione aumentata, concretamente, si presenta così: il sito su cui state leggendo queste righe — il restyling completo di mcva.ch — e FiscalDoc, l'applicazione locale che gestisce la mia fiscalità, sono stati realizzati con Claude Code. Non in pilota automatico. In dialogo, con guadagni netti, perdite di tempo evitabili e una disciplina senza la quale lo strumento delude. Ecco cosa mi hanno insegnato questi due progetti.

Articolo pubblicato a marzo 2026, rielaborato il 25 maggio 2026, rivisto il 7 luglio 2026.

Claude Code, di cosa si tratta esattamente?

Claude Code è un assistente di sviluppo a riga di comando, creato da Anthropic, che lavora a livello dell'intero progetto: naviga tra i file, comprende l'architettura, esegue comandi e modifica più file in modo coerente.

La differenza rispetto agli assistenti integrati in un editor sta proprio in questa visione d'insieme. Un assistente da editor vede il file aperto e completa la riga corrente; Claude Code vede il progetto, le sue convenzioni, le sue dipendenze. È ciò che gli permette di condurre modifiche trasversali che uno strumento con contesto locale non riesce a coordinare. Il contraltare è una curva di apprendimento più marcata per chi non ha mai lavorato in un terminale — e nessuna delle due categorie è superiore in ogni situazione.

Cosa mi hanno mostrato due progetti reali

Nel restyling di mcva.ch — un sito multilingue di diverse decine di pagine, in quattro lingue, con dati strutturati — il guadagno più netto si è visto sulla struttura. Creare un componente, una rotta, un modello di pagina coerente con le convenzioni del progetto richiede pochi minuti di dialogo invece di un'intera sessione di lavoro. Poi il refactoring multi-file: rinominare, migrare, ristrutturare decine di file in un colpo solo, con un'affidabilità che mi ha sorpreso. Mantengo la decisione sull'operazione; delego l'esecuzione.

Anche la correzione dei bug mi ha colpito. Descrivere un sintomo in linguaggio naturale — «il selettore di lingua perde la pagina corrente» — spesso basta perché lo strumento risalga da solo alla causa radice navigando nel codice. E la generazione dei test fornisce una base solida da affinare, invece di una pagina bianca.

FiscalDoc racconta l'altro lato della medaglia: uno strumento completo — analisi di documenti, classificazione fiscale, ricerca, assistente locale — che ha preso forma in tre serate di dialogo. Non l'ho scritto; l'ho costruito dialogando. Ho descritto le mie esigenze, iterato, corretto. Il racconto completo è pubblicato in FiscalDoc, o come sostituire un SaaS con un'IA locale.

Dove lo strumento mi ha fatto perdere tempo

Sono emersi tre limiti in questi due progetti, e nessuno è trascurabile.

Anzitutto la perdita di contesto. Oltre le circa due ore di sessione, lo strumento perde progressivamente il filo: può proporre modifiche incoerenti con quanto deciso in precedenza, o dimenticare un vincolo architetturale posto all'inizio del dialogo. È una dinamica legata alla finestra di contesto dei modelli generativi, per cui oggi non esiste una soluzione puramente tecnica.

Poi la falsa sicurezza. Il codice generato spesso compila al primo colpo e ha un aspetto professionale che abbassa la vigilanza. Questo aspetto può nascondere bug sottili, falle non gestite, scelte discutibili che solo una rilettura attenta rivela. Accettare senza rileggere significa accumulare un debito che si vede solo più tardi.

Infine l'architettura. Per le scelte strutturali, lo strumento propone ciò che funziona nel caso generale, non necessariamente ciò che si adatta al vostro contesto specifico. Queste decisioni restano mie, e una migliore formulazione dei prompt non cambia nulla.

La disciplina che rende redditizio lo strumento

Ciò che ho consolidato su questi due progetti si riassume in poche cose — che fanno quasi tutto il risultato.

• Sessioni brevi, un obiettivo. Da trenta a quarantacinque minuti, un compito preciso, poi una nuova sessione. Oltre questa soglia la qualità del dialogo crolla; ripartire da zero costa meno che rincorrere gli errori.
• Una revisione sistematica. Ogni modifica viene riletta come il contributo di un collega: logica, sicurezza, prestazioni, coerenza con l'esistente. La qualità formale del codice non dispensa mai da questa rilettura.
• Istruzioni di progetto scritte. Un file di istruzioni che lo strumento rilegge a ogni sessione — convenzioni, divieti, architettura — evita di ripetere tutto e capitalizza ciò che funziona. È il prompt documentato su scala di progetto.

E la riservatezza del codice?

Usare Claude Code implica inviare il codice analizzato ai server dell'editore per l'elaborazione. Per mcva.ch, sito vetrina pubblico, la questione si è risolta rapidamente. Per uno strumento aziendale che tocca dati clienti o know-how strategico, la si affronta in fase di definizione del perimetro: gli impegni contrattuali di Anthropic su trattamento e conservazione dei dati variano a seconda dell'offerta sottoscritta^[1], e non sostituiscono la propria analisi. Per alcuni perimetri, modelli aperti eseguiti su un'infrastruttura controllata offrono un profilo di sovranità diverso — un arbitraggio che pongo sistematicamente all'inizio di un progetto di soluzione su misura.

Cosa cambia per una PMI svizzera

L'aspetto più interessante va oltre il mio caso personale. Questo tipo di strumentazione abbassa il costo di produzione del software al punto da rimettere il su misura alla portata di strutture che si credevano escluse — è il cuore di ciò che propongo in soluzioni, ed è la ragione per cui il quadro d'insieme è delineato in Cosa deve fare una PMI svizzera di fronte all'IA nel 2026?. Lo stesso restyling di mcva.ch illustra il primo pilastro di questa logica: siti pensati per essere trovati e citati, realizzati con questa strumentazione.

Per un team, l'adozione segue un percorso ragionevole: un pilota su un perimetro limitato con uno sviluppatore motivato, una formazione breve ma strutturata, poi una governance tecnica esplicita — cosa può essere delegato allo strumento, cosa richiede una revisione, cosa rientra in vincoli normativi. Nulla di tutto ciò trasforma un team dall'oggi al domani. Lo strumento rende più produttivo un team disciplinato, e rivela in modo più crudo i punti in cui il rigore mancava già.

Da ricordare

— Claude Code lavora a livello dell'intero progetto; è questa la sua forza distintiva rispetto agli assistenti integrati in un editor. — I vantaggi sono reali su struttura, refactoring e indagine dei bug; la rilettura umana resta non negoziabile. — Sessioni brevi, revisione sistematica, istruzioni di progetto scritte: la disciplina pesa più dello strumento.

FAQ

Bisogna saper programmare per usare Claude Code? Per esplorare e prototipare, no: il dialogo basta a produrre qualcosa che funziona. Per un prodotto destinato a utenti reali, qualcuno deve poter rileggere e valutare il codice prodotto. Ho approfondito questo confine nel mio articolo su vibe coding e prototipazione.

Il mio codice finisce presso l'editore? Sì: il codice analizzato viene elaborato sui server di Anthropic. Gli impegni di trattamento e conservazione variano a seconda dell'offerta sottoscritta e non costituiscono una garanzia generale. Per codice sensibile, effettuate l'analisi prima di adottare lo strumento, oppure valutate modelli eseguiti sulla vostra infrastruttura.

Claude Code sostituisce uno sviluppatore o un fornitore? Comprime l'esecuzione; il giudizio — architettura, arbitraggi, sicurezza, responsabilità — resta umano. Una persona competente e ben attrezzata produce sensibilmente di più rispetto a prima. Un'organizzazione priva di disciplina di revisione produce soprattutto debito, più in fretta.

Quanto costa? Lo strumento funziona in abbonamento presso l'editore, nell'ordine di qualche decina a qualche centinaio di franchi al mese a seconda dell'intensità d'uso. Rapportato al tempo di esecuzione guadagnato su un progetto reale, questa voce è marginale. Il vero costo è il tempo di rilettura — ed è l'ultima voce su cui risparmiare.

E nei vostri progetti software? La Diagnosi d'Uso dell'IA: sessanta minuti per definire i vostri flussi reali, identificare cosa merita il su misura, cosa resta in SaaS, e cosa non ha bisogno di IA. Prenotare una diagnosi

Fonti

[1] Anthropic, Claude Code documentation — CLI usage. docs.anthropic.com/en/docs/claude-code/cli-usage [↩]

Jérôme Deshaie è CEO e fondatore di MCVA Consulting SA, agenzia aumentata con sede in Vallese. Quindici anni al servizio di grandi marchi internazionali, ora in prima linea per le PMI svizzere. Percorso.