Hook

Un hook è uno script che Claude Code esegue in un momento specifico — prima di mandare un prompt, dopo che un tool ha finito, all’inizio della sessione, al salvataggio di un file. I plugin forniscono hook per aggiungere comportamento in quei momenti. La sezione Hook di CLACOROO è la tua vista unica di ogni hook attualmente configurato, raggruppato per evento, con una scomposizione chiara di chi lo fornisce e da cosa dipende.

Questa sezione è principalmente in sola lettura: gli hook arrivano da file hooks.json dentro ai plugin, quindi il modo di attivare o disattivare un hook è attivare o disattivare il plugin che lo possiede.

Panoramica

Gli hook sono raggruppati sotto il loro evento — Claude Code li lancia in momenti specifici del ciclo di vita. Ogni card mostra cosa esegue, chi lo fornisce e se può davvero girare su questa macchina.

Una topbar sopra i gruppi ti permette di filtrare per evento, per plugin, per scope, e cercare per comando. Lo switcher di vista funziona esattamente come nelle altre sezioni.

Cosa mostra

Gruppi per evento

Claude Code definisce un insieme finito di eventi hook. I più comuni:

Evento	Si attiva quando
PreToolUse	Subito prima che un tool (Bash, Edit, Read, …) parta
PostToolUse	Subito dopo che un tool finisce
UserPromptSubmit	Quando invii un nuovo messaggio
SessionStart	All’inizio di una nuova sessione Claude Code
PreCompact	Prima che Claude Code compatti il contesto
Stop	Quando l’assistente si ferma a fine turno

Ogni gruppo mostra il conteggio degli hook attaccati; collassi ed espandi i gruppi per concentrarti su quello che ti interessa.

Card dell’hook

Dentro un gruppo, ogni card di hook porta:

• Matcher — su cosa il hook gira (es. * per tutto, Bash solo per comandi shell, Edit|Write per entrambi)
• Comando — lo script che gira, esattamente come Claude Code lo eseguirà
• Badge plugin — quale plugin contribuisce questo hook
• Scope — global, project, local
• Dipendenze — i tool CLI da cui dipende il comando (git, jq, curl, …) con check di disponibilità
• Campi opzionali — type (command / shell / async), timeout, condizione di esecuzione

Check delle dipendenze

Per ogni tool CLI che il comando dell’hook menziona (rilevato dal testo del comando), CLACOROO controlla se è installato e raggiungibile sulla tua macchina. I tool mancanti vengono mostrati come badge giallo con un suggerimento di install (es. “installa jq · brew install jq”).

Se un hook dipende da un tool che non hai, l’hook fallirà in silenzio quando si attiva — il KPI Hook con dep mancanti della Dashboard li conta per te.

Filtri

• Evento — tieni solo PreToolUse, solo PostToolUse, ecc.
• Plugin — solo hook di un plugin specifico
• Scope — global, project, local
• Cerca — matcha il testo del comando

Operazioni comuni

Come scoprire cosa parte quando invio un messaggio

1. Filtra per evento: UserPromptSubmit
2. Ogni card nella lista risultante si attiverà quando invii un prompt
3. Leggi la colonna Comando per sapere esattamente cosa esegue ognuno

Come disattivare un singolo hook

In CLACOROO non disattivi un hook direttamente — al suo posto disattivi il plugin che lo possiede (usa il badge sulla card per identificarlo, poi salta a Gestione plugin). Se l’hook è nel hooks.json locale del tuo progetto, modifica quel file direttamente.

Come sistemare un warning “dipendenza mancante”

1. Guarda il badge dipendenze sulla card (es. missing: jq)
2. Clicca sul suggerimento di install per il comando specifico per la tua piattaforma
3. Installa il tool sulla tua macchina
4. Clicca Aggiorna nella topbar — CLACOROO ri-esegue il check

Come leggere il comando completo di un hook

Se il comando è troppo lungo per la card, cliccalo: un modal espande il comando completo in un blocco di codice che puoi copiare.

Come vedere quale plugin contribuisce più hook

1. Passa alla vista Compatta per densità
2. Ordina per Plugin A→Z
3. I plugin ora raggruppano visivamente i loro hook insieme — conta a occhio, o apri Gestione plugin e leggi il contatore hook di ogni plugin

Suggerimenti e scorciatoie

• Il check delle dipendenze è il tuo audit più utile: a colpo d’occhio sai se un hook farà davvero qualcosa o resterà in no-op silenzioso
• Il KPI Dashboard Hook · N plugin ti dice la distribuzione: 20 hook su 2 plugin è concentrato; 20 hook su 12 plugin è diffuso
• Le card hook con async girano in parallelo al flusso principale di Claude Code — non bloccano il tuo prompt
• Gli hook con un campo command lungo tendono ad essere script shell inline — aprili nel modal di anteprima per leggerli comodamente
• Cmd / Ctrl + K poi “hook” ti porta qui

Casi limite ed errori

• Non appare nessun hook. Nessuno dei tuoi plugin fornisce hook, o sono tutti in plugin disattivati. Apri Gestione plugin per verificare.
• Un hook continua a mostrare “dep mancante” dopo aver installato il tool. Claude Code cerca i tool via PATH. Riavvia la shell (e CLACOROO) così il nuovo PATH è visibile.
• Il comando di un hook sembra malformato. Il hooks.json del plugin ha un errore di sintassi. Apri il plugin in VS Code e controlla hooks.json.
• Disattivare un plugin non rimuove i suoi hook dalla lista. Aggiorna la sezione — se gli hook restano, il plugin li possiede via un hooks.json di fallback fuori dal suo stato disabilitato. Ispeziona i path del file nell’azione Apri hooks.json.
• Un hook si attiva più volte. Due plugin potrebbero condividere lo stesso matcher sullo stesso evento. Filtra per evento per vedere i duplicati affiancati.

Correlati

• Gestione plugin — per attivare/disattivare i plugin (e quindi i loro hook)
• Server MCP — l’altro punto di estensione esposto da Claude Code
• Dashboard — i KPI Hook e Hook con dep mancanti arrivano da questa sezione
• Concetti — skill vs agent vs hook vs MCP, riassunti