Real Python spiega i Claude Code hooks per automatizzare il flusso di lavoro

Real Python mostra come fissare regole certe con i Claude Code hooks: autoformattare ogni file appena modificato, far rispettare gli strumenti approvati, inviare una notifica quando un task finisce¹.

Il tutorial parte da un punto pratico. Chiedere al modello di ricordare istruzioni ricorrenti funziona finché non smette di funzionare. I hook risolvono così: rendono le azioni deterministiche, perché scattano quando si verifica un evento scelto, ogni volta¹. Non aspettano la decisione del modello. Sono comandi registrati che partono su un evento specifico¹.

C’è un esempio visivo subito chiaro. L’auto-formatter entra in azione nel momento in cui Claude modifica un file. Applica gli standard del progetto, senza passaggi manuali aggiuntivi e senza ripetere richieste al modello¹. Il risultato resta coerente a ogni edit.

Il tutorial spiega anche la struttura. Ogni hook ha tre parti. A queste si aggiunge un contratto di exit code che stabilisce l’esito dell’azione. L’hook può bloccare ciò che il modello sta per fare o reindirizzarlo, in base al codice di uscita restituito¹.

Gli esempi coprono casi concreti. Un desktop notifier avvisa quando termina un’attività lunga. Un pip guard fa rispettare gli strumenti approvati dal progetto. L’auto-formatter pulisce il codice dopo ogni modifica. Il sito fornisce il codice di esempio, scaricabile, per costruire questi tre hook all’interno del progetto seguito nel tutorial¹.

L’obiettivo è evitare di ripetere le stesse istruzioni a ogni giro. Se vuoi che il progetto rispetti gli strumenti approvati, lo affidi a un guard. Se vuoi file formattati, lo affidi all’auto-formatter. Se vuoi sapere quando un lavoro è finito, attivi un notifier. Tutto accade senza richiedere al modello di scegliere di farlo, perché l’evento selezionato fa partire il comando registrato¹.

La guida chiarisce il comportamento all’arrivo degli exit code. L’exit code comunica se procedere, fermare o deviare ciò che il modello sta per fare¹. Questo contratto definisce l’effetto del hook in modo esplicito.

Per verificare di aver compreso i concetti, Real Python propone un quiz interattivo da 7 domande, senza limite di tempo. Ogni risposta corretta vale un punto e il punteggio massimo è 100%². Il quiz, firmato da Joseph Peart, riprende la composizione di un hook, gli eventi che scattano prima e dopo una chiamata a uno strumento, e gli exit code che consentono di bloccare o reindirizzare ciò che Claude sta per fare².

Il tutorial include un link per scaricare il codice di esempio usato per costruire il desktop notifier, il pip guard e l’auto-formatter. Il pacchetto serve per replicare i passaggi descritti e collegarli agli eventi scelti nel progetto che si sta seguendo¹.