In questo articolo Indice dei contenuti 3 sezioni
Correggere un bug non è mai un’operazione neutra, e chi lavora su applicazioni già in produzione lo sa bene. Con Claude Code il momento della correzione diventa qualcosa di più di una semplice patch veloce, perché l’agente può ragionare sulle conseguenze di ogni intervento. Nelle lezioni precedenti abbiamo visto come usarlo per individuare bug e analizzare errori applicativi attraverso un processo di debugging guidato. Adesso entriamo nella fase successiva, quella della correzione assistita e del refactoring sicuro.
Mettere le mani su un’applicazione esistente significa toccare comportamenti consolidati. Il rischio è concreto, ovvero introdurre regressioni, effetti collaterali imprevisti o addirittura nuove vulnerabilità. Ed è qui che il coding agentico mostra il suo lato più interessante. Non ci si limita a chiedere come sistemare un problema, ma si chiede all’agente di valutare cosa succede dopo la modifica. Un piccolo cambio di prospettiva che trasforma Claude Code in un vero collaboratore tecnico.
Correggere un bug senza rompere quello che già funziona
La tentazione, quando si trova un problema, è applicare la soluzione più rapida. Peccato che una modifica in apparenza banale possa mandare in tilt altre parti del sistema. Pensiamo a una funzione che compone nome e cognome di un utente. Durante alcuni test salta fuori che genera errori quando il parametro user è null.
A Claude Code si può chiedere una correzione che mantenga il comportamento attuale. La proposta tipica sarà un controllo che, se user manca, restituisce una stringa vuota. Fin qui tutto lineare. Ma il lavoro non dovrebbe fermarsi qui. La vera domanda è un’altra, ovvero se quella stringa vuota vada davvero bene per tutte le parti dell’applicazione che usano la funzione.
Basta chiedere all’agente quali effetti collaterali potrebbe portare la modifica. Questo tipo di dialogo permette di ragionare sull’intero contesto, non solo sul singolo bug. Claude Code non sostituisce il giudizio dello sviluppatore, lo amplia.
Cosa significa davvero fare refactoring
Molti pensano che il refactoring sia riscrivere il codice. In realtà si tratta di migliorare la struttura interna di un programma senza cambiarne il comportamento esterno. Una funzione che calcola un prezzo applicando sconti premium, sconti di categoria e IVA può essere corretta oggi, ma diventare un incubo domani quando arrivano nuove regole commerciali.
Chiedendo a Claude Code un refactoring a comportamento invariato, la proposta spezza quella funzione monolitica in tante funzioni più piccole e leggibili. Una per lo sconto premium, una per la categoria, una per l’IVA. Il risultato è identico dal punto di vista del calcolo, ma il codice diventa più leggibile, testabile e facile da estendere.
Il discorso vale ancora di più con il codice legacy, quello scritto anni fa da qualcuno che ormai non è più nel team. Funzioni con nomi come p, variabili chiamate r, logiche criptiche. Qui l’agente si rivela prezioso, perché può spiegare cosa fa quel codice e proporre una versione con nomi chiari e struttura comprensibile. Il guadagno principale, in questo caso, riguarda chi metterà mano al progetto in futuro.
Meglio piccoli passi che grandi salti
Uno degli insegnamenti più utili riguarda la dimensione degli interventi. Invece di lanciarsi in un refactoring enorme tutto in una volta, conviene procedere con cambiamenti piccoli e verificabili. Claude Code aiuta proprio in questo, suddividendo un intervento complesso in fasi progressive, ognuna testabile.
Si può chiedere all’agente un piano di refactoring in più fasi, con ogni passaggio verificabile tramite test. Così non produce soltanto codice, ma contribuisce a pianificare l’intervento. Un approccio che abbatte il rischio di regressioni e rende molto più semplice tornare indietro se qualcosa va storto.
Il valore vero del coding agentico non sta nella generazione automatica di righe di codice. Sta nell’avere accanto un agente capace di ragionare sul contesto, segnalare criticità e proporre alternative progettuali. La responsabilità della validazione tecnica e architetturale, però, resta saldamente nelle mani dello sviluppatore. Nella prossima lezione il tema sarà la sicurezza del codice, con Claude Code impiegato per scovare vulnerabilità comuni e riconoscere pattern rischiosi.
