I Claude Code hooks ti permettono di eseguire comandi shell deterministici su ogni evento chiave del ciclo di vita di Claude Code: prima che uno strumento venga usato, dopo che uno strumento è stato usato, quando un prompt viene inviato, quando un agente si ferma o quando viene inviata una notifica. AgentsRoom è il centro di comando visuale che ti permette di osservare ogni hook attivarsi in tempo reale, su decine di agenti Claude Code, in decine di progetti.
Gli hook sono il modo ufficiale di Anthropic per aggiungere automazione deterministica, salvaguardie, tracciati di audit ed effetti collaterali personalizzati a Claude Code. AgentsRoom non sostituisce i tuoi hook. Esegue il vero Claude Code CLI, quindi ogni hook che configuri in .claude/settings.json continua a funzionare esattamente come previsto. Ciò che AgentsRoom aggiunge è visibilità: una dashboard dal vivo dove puoi vedere ogni attivazione di hook, per agente, per progetto, per esecuzione.
I Claude Code hooks sono comandi shell definiti dall'utente che Claude Code esegue automaticamente in punti specifici durante una sessione d'agente. Sono configurati in .claude/settings.json (condiviso, versionato su git) o .claude/settings.local.json (personale, in gitignore) e ti danno il controllo deterministico sul comportamento dei tuoi agenti Claude Code. Mentre un prompt è probabilistico, un hook è al 100% deterministico: viene eseguito ogni volta che l'evento corrispondente si attiva, senza eccezioni.
Gli hook sono la risposta di Anthropic al bisogno di salvaguardie, automazione, telemetria, logging di audit e integrazioni personalizzate. Puoi usare i Claude Code hooks per formattare il codice automaticamente dopo ogni modifica, bloccare comandi pericolosi prima che vengano eseguiti, registrare ogni chiamata di strumento in un file, inviare una notifica desktop quando l'agente sta aspettando input, attivare un job di CI quando una sessione termina, o trasmettere ogni prompt a un backend di osservabilità. Qualsiasi comando shell tu possa scrivere, puoi collegarlo a un Claude Code hook.
Poiché gli hook vivono nel progetto stesso (.claude/settings.json è versionato su git), viaggiano insieme al tuo codebase. Ogni sviluppatore del team e ogni agente AI generato da quel progetto eredita la stessa rete di sicurezza. AgentsRoom rispetta questo modello da un capo all'altro: l'app desktop non riscrive i tuoi hook, esegue il vero Claude Code CLI come processo figlio, che legge la tua configurazione degli hook automaticamente, proprio come farebbe eseguire claude code da un terminale.
Ogni sessione d'agente Claude Code attiva eventi di hook in punti ben definiti. Ecco cosa significa ogni evento e cosa puoi farci.
L'hook PreToolUse si attiva prima che Claude Code esegua qualsiasi strumento (Bash, Edit, Write, Read, Grep, ecc.). È il posto perfetto per le salvaguardie: bloccare comandi pericolosi, richiedere conferma per operazioni distruttive, applicare regole specifiche del progetto o riscrivere gli argomenti degli strumenti prima dell'esecuzione. Restituisci un codice di uscita diverso da zero dall'hook per bloccare completamente la chiamata allo strumento. PreToolUse è il Claude Code hook numero 1 per team attenti alla sicurezza.
L'hook PostToolUse si attiva immediatamente dopo che qualsiasi strumento di Claude Code termina. È qui che colleghi la post-elaborazione automatica: eseguire un formatter (Prettier, Black, rustfmt) dopo ogni Edit, attivare un linter dopo ogni Write, aggiornare un changelog quando un file viene modificato o inviare eventi di telemetria. PostToolUse è l'hook pane-e-burro per trasformare Claude Code in un membro del team disciplinato che lascia il codebase più pulito di come l'ha trovato.
L'hook UserPromptSubmit si attiva ogni volta che un nuovo prompt viene inviato a un agente Claude Code. Usalo per registrare ogni prompt per audit e compliance, riscrivere i prompt al volo (iniettare contesto, redigere segreti), instradare le richieste a modelli diversi o applicare convenzioni di naming. Combinato con la dashboard multi-agente di AgentsRoom, UserPromptSubmit ti dà un tracciato di audit completo di ogni istruzione inviata a ogni agente Claude Code.
L'hook Stop si attiva quando una sessione d'agente Claude Code termina, sia perché il lavoro è fatto sia perché è stata annullata. È il posto giusto per eseguire job di pulizia, inviare un riepilogo finale a un sistema di tracking, committare artefatti o notificare un umano che la sessione è finita. AgentsRoom completa l'hook Stop con il proprio sistema di notifiche, così vieni notificato sia dal tuo hook personalizzato sia dalle notifiche push desktop + mobile di AgentsRoom.
L'hook Notification si attiva quando Claude Code invia una notifica di sistema — tipicamente quando l'agente sta aspettando input dell'utente o ha terminato un task di lunga durata. Usalo per instradare notifiche verso Slack, Discord, Telegram, email o qualsiasi webhook tu voglia. AgentsRoom mostra già le notifiche di Claude Code nativamente nella sua dashboard multi-agente e come notifiche push sul telefono, quindi l'hook Notification è un posto perfetto per aggiungere integrazioni personalizzate in cima.
L'hook SubagentStop si attiva quando un subagente di Claude Code termina il proprio lavoro e restituisce il controllo al genitore. Se usi i subagenti di Claude Code definiti in .claude/agents/*.md per delegare task specializzati, SubagentStop ti permette di registrare cosa ha fatto ogni subagente, aggregare i loro output o attivare uno step successivo. All'interno di AgentsRoom, gli eventi SubagentStop appaiono nella timeline dal vivo dell'agente così puoi vedere esattamente quali subagenti sono stati eseguiti all'interno di ogni sessione Claude Code.
Gli hook trasformano Claude Code da un'IA impressionante in un agente di coding di livello produttivo su cui tutto il tuo team può fare affidamento.
I prompt sono probabilistici e possono essere aggirati. I Claude Code hooks sono comandi shell deterministici che vengono sempre eseguiti. Un hook PreToolUse può bloccare qualsiasi rm -rf, qualsiasi push --force, qualsiasi migrazione distruttiva — indipendentemente da come l'agente formuli il suo ragionamento. Questo è lo standard d'oro per i deployment di Claude Code critici dal punto di vista della sicurezza.
Collega i Claude Code hooks ai tuoi formatter, linter, test runner, type checker e script di build. Ogni modifica che l'agente fa attiva gli stessi controlli che la tua pipeline di CI esegue — localmente, istantaneamente, automaticamente. I tuoi agenti Claude Code diventano collaboratori auto-disciplinati che non si dimenticano mai di eseguire il formatter.
Ogni prompt, ogni chiamata a strumento, ogni avvio e arresto di sessione può essere registrato dai Claude Code hooks. Combinalo con la timeline visuale di AgentsRoom e ottieni un tracciato di audit completo di ogni azione di un agente di coding AI — essenziale per team con forte esigenza di compliance, aziende attente alla sicurezza e chiunque faccia sul serio con lo sviluppo AI osservabile.
Poiché .claude/settings.json è versionato su git, un singolo set di Claude Code hooks applica le stesse convenzioni per ogni sviluppatore del team e ogni agente AI generato dal progetto. I nuovi membri del team ereditano le salvaguardie nel momento in cui clonano il repo. Aggiorna il comportamento dell'intero tuo team di coding AI con una singola pull request.
I Claude Code hooks producono eventi. AgentsRoom trasforma questi eventi in un feed visuale: ogni attivazione di hook, ogni chiamata di strumento, ogni cambio di stato, trasmesso dal vivo per agente e per progetto. Non devi più seguire i log — osservi la tua flotta Claude Code lavorare in tempo reale.
Senza hook, eseguire Claude Code significa osservare ogni chiamata di strumento. Con gli hook, deleghi l'osservazione a codice deterministico e supervisioni a livello di eccezioni. AgentsRoom amplifica questo: vedi tutti i tuoi agenti Claude Code protetti da hook in una volta sola, e intervieni solo quando qualcosa richiede la tua attenzione.
AgentsRoom è il centro di comando visuale per Claude Code e altre CLI di coding AI. Non fa il fork di Claude Code, non reimplementa gli hook, non intercetta le chiamate agli strumenti. Esegue il vero Claude Code CLI come processo figlio dentro un terminale xterm.js completo, il che significa che ogni hook definito in .claude/settings.json o .claude/settings.local.json viene eseguito esattamente come Anthropic l'ha progettato — senza compromessi, senza sorprese, senza middleware invisibili.
Ciò che AgentsRoom aggiunge è scala e visibilità. Puoi eseguire decine di agenti Claude Code in parallelo, su decine di progetti, ciascuno con la propria configurazione di hook, e vedere ogni attivazione di hook su un'unica dashboard. Combinato con le notifiche per agente di AgentsRoom, l'app compagna mobile e il tracciamento di stato in tempo reale, i Claude Code hooks diventano un layer di osservabilità di prima classe per l'intera tua operazione di coding AI.
AgentsRoom avvia processi claude CLI reali dentro terminali xterm.js completi. Qualsiasi hook configurato in .claude/settings.json, .claude/settings.local.json o nelle impostazioni a livello utente si attiva automaticamente, esattamente come se eseguissi Claude Code dal tuo terminale. Niente patch, niente riscritture, nessuna perdita di fedeltà.
Esegui 10, 20, 50 agenti Claude Code in parallelo con gli hook attivi. La dashboard multi-agente di AgentsRoom mostra le notifiche attivate da hook e i cambi di stato per ogni agente simultaneamente. Le tue salvaguardie PreToolUse, i tuoi formatter PostToolUse e i tuoi handler Stop operano a scala di flotta.
Ogni progetto in AgentsRoom ha il proprio .claude/settings.json e quindi la propria configurazione di Claude Code hook. La sidebar aggrega lo stato dal vivo tra i progetti così puoi individuare quali hook si stanno attivando dove, quali agenti sono bloccati in attesa di input e quali hook Stop hanno appena completato un'esecuzione.
AgentsRoom include notifiche native macOS e notifiche push mobile cifrate end-to-end. L'hook Notification di Claude Code, l'hook Stop e l'hook SubagentStop producono tutti segnali che AgentsRoom fa affiorare direttamente sul tuo desktop e sul telefono. Puoi allontanarti dal computer e sapere comunque quando un hook ti dice di tornare.
Scarica AgentsRoom, apri un progetto con hook in .claude/settings.json, avvia un agente Claude Code e osserva ogni evento di hook scorrere nella dashboard in tempo reale.
App companion: monitora i tuoi agenti in movimento
Funziona con Claude, Codex, OpenCode, Gemini CLI e Aider