Prendere in carico il software di altri con Claude Code

Articolo rivisto a settembre 2026: abbiamo tolto le stime di tempo che non avevamo misurato.

Prendere in carico un progetto software scritto da un altro team è una delle attività più delicate nella vita di un sistema informatico. È quella fase che di solito chiamiamo engagement tecnico, o presa in assistenza, e che nasconde sempre una lunga lista di cose da fare: capire l'architettura esistente, leggere il codice, valutare com'è stato implementato, individuare i rischi e mettere in piedi un piano di manutenzione e miglioramento.

Da un paio d'anni gli strumenti basati su AI stanno cambiando il modo in cui affrontiamo questo lavoro. Uno su tutti: Claude Code, l'ambiente di sviluppo assistito da AI di Anthropic. Lo usiamo nel nostro lavoro soprattutto in tre momenti: l'analisi iniziale, l'inserimento di chi entra nel progetto e la documentazione. Ecco come.

Le sfide tipiche nell'acquisizione di un progetto esistente

Quando un nuovo team prende in carico un sistema software, emergono quasi sempre alcune problematiche ricorrenti:

1. Mancanza di documentazione

Molti progetti legacy presentano documentazione incompleta o non aggiornata. Questo rende difficile comprendere:

• architettura del sistema
• flussi applicativi
• dipendenze tra moduli
• logiche di business implementate

2. Complessità del codice

Il codice può essere:

• scritto da più sviluppatori con stili differenti
• poco modulare
• privo di commenti
• difficile da navigare

3. Scarsa conoscenza del dominio

Il nuovo team spesso non possiede una conoscenza approfondita del dominio applicativo (finanza, logistica, sanità, ecc.).

4. Debito tecnico accumulato

Sistemi sviluppati nel tempo possono contenere:

• codice duplicato
• dipendenze obsolete
• vulnerabilità di sicurezza
• architetture che reggono male la crescita

5. Tempi stretti per partire

Il cliente si aspetta che il nuovo team sia operativo presto.

È qui che Claude Code dà una mano.

Cos'è Claude Code

Claude Code è un assistente AI progettato per lavorare direttamente nel contesto di una codebase.

Le sue capacità principali includono:

• comprensione di repository complessi
• analisi semantica del codice
• generazione e miglioramento della documentazione
• spiegazione delle logiche applicative
• supporto alla refactorizzazione
• individuazione di problemi architetturali o di sicurezza

A differenza dei tradizionali strumenti di analisi statica, Claude Code lavora con una comprensione contestuale e semantica del codice.

Come Claude Code aiuta nella presa in carico

1. Analisi iniziale della codebase

Una delle prime attività della presa in carico è capire come è strutturato il progetto.

Claude Code può analizzare l'intero repository e produrre una prima sintesi con:

• overview dell'architettura
• descrizione dei moduli principali
• flussi di dipendenze
• tecnologie utilizzate

Esempio di prompt operativo:

Analizza questo repository e descrivi: architettura generale, moduli principali, pattern architetturali utilizzati, dipendenze esterne.

Il risultato è una prima mappa, da verificare, che fa risparmiare molte ore di lettura a mano. Non la sostituisce: dice da dove cominciare a leggere.

2. Ricostruzione dell'architettura

Molti progetti non possiedono diagrammi architetturali aggiornati.

Claude Code può aiutare a ricostruire:

• architettura a livelli
• microservizi
• interazioni tra componenti
• flussi di dati

Il risultato può essere usato per generare:

• diagrammi architetturali
• diagrammi di sequenza
• diagrammi dei servizi

Questo è particolarmente utile per creare la documentazione tecnica di presa in carico.

3. Comprensione rapida delle logiche di business

Uno degli ostacoli maggiori è capire cosa fa realmente il codice.

Claude Code può:

• spiegare funzioni complesse
• descrivere algoritmi
• identificare regole di business nascoste nel codice

Esempio:

Spiegami la logica di questo modulo di calcolo commissioni e descrivi le regole di business implementate.

Questo permette al team di:

• comprendere rapidamente il dominio
• evitare errori durante modifiche future

4. Generazione della documentazione tecnica

Durante la presa in carico è fondamentale produrre documentazione come:

• documentazione architetturale
• descrizione dei moduli
• guide di manutenzione
• onboarding per nuovi sviluppatori

Claude Code può generare automaticamente:

• README completi
• documentazione API
• commenti nel codice
• wiki tecnici

Così mettere per iscritto quello che si è capito del sistema costa molto meno fatica, e diventa più facile tenerlo aggiornato.

5. Individuazione del debito tecnico

Un progetto preso in assistenza può nascondere numerosi problemi tecnici.

Claude Code può aiutare a identificare:

• codice duplicato
• pattern anti-pattern
• dipendenze obsolete
• violazioni dei principi SOLID
• aree difficili da testare

Il team può quindi costruire un piano di remediation tecnica.

6. Analisi della sicurezza

La sicurezza è un elemento critico quando si prende in carico un sistema esistente.

Claude Code può supportare:

• analisi delle vulnerabilità
• identificazione di input non validati
• controllo di gestione delle credenziali
• uso improprio di librerie

Ne esce una prima analisi di sicurezza, da completare con una revisione fatta da persone secondo le pratiche OWASP.

7. Supporto alla refactorizzazione

Una volta compreso il sistema, il team può iniziare a migliorarlo.

Claude Code può:

• suggerire refactoring
• migliorare la leggibilità del codice
• modularizzare componenti complessi
• introdurre pattern architetturali più moderni

Questo è particolarmente utile nei progetti legacy.

8. Creazione di test automatici

Molti sistemi presi in assistenza hanno copertura di test molto bassa.

Claude Code può generare:

• unit test
• integration test
• test per API

Così si costruisce una rete di sicurezza prima di toccare il codice. I test generati vanno letti uno per uno: un test sbagliato che passa è peggio di nessun test.

Benefici per il team

Chi entra nel progetto arriva prima a orientarsi nel codice. La documentazione migliora, perché costa meno scriverla e tenerla aggiornata. E il team tocca il sistema dopo averlo capito meglio, che è il modo più semplice per rompere meno cose. Quanto tempo si risparmi dipende dal progetto: non abbiamo un numero da darti, e diffidiamo di chi ne dà uno uguale per tutti.

Limiti e buone pratiche

Detto questo, Claude Code va usato con la testa. Le analisi dell'AI vanno sempre verificate da sviluppatori esperti: è un acceleratore, non un oracolo. Prima di caricare repository sensibili conviene valutare con attenzione le policy di sicurezza e privacy. E soprattutto va inteso per quello che è, uno strumento di supporto: non sostituisce l'analisi architetturale umana, la rende più veloce.

In breve

Ereditare un progetto scritto da altri è sempre stato un lavoro lento e pieno di incognite. Claude Code non lo rende banale, ma cambia le proporzioni: si arriva prima a capire il codice, a scrivere una documentazione decente e a far emergere i problemi che altrimenti si scoprirebbero il giorno in cui vanno in produzione.

Manutenzione ed evoluzione di sistemi esistenti, anche scritti da altri, è una parte del lavoro che facciamo dal 2002. L'AI non cambia il metodo: lo rende più veloce nei punti noiosi. Il metodo, con le pratiche di qualità del nostro processo certificato ISO 9001, lo trovi in come lavoriamo.

---

Hai un sistema scritto da altri che nessuno vuole più toccare? Raccontacelo: entro 48 ore ricevi un primo riscontro.