I Claude Code mods sono piccole funzioni TypeScript o JavaScript che girano dentro la sessione di Claude Code e ne cambiano il comportamento: possono riscrivere un prompt prima che arrivi al modello, bloccare o modificare un comando, aggiungere pannelli e pulsanti all'interfaccia e perfino sostituire funzioni integrate.
Anthropic li ha rilasciati il 1 ottobre 2026 con Claude Code 2.1.287. Sono attivi di default, senza configurazione, nella CLI, nella scheda Code dell'app desktop e nell'estensione VS Code. Ho aggiornato questa guida il 4 novembre 2026 con le novità del primo mese, con il modo per controllare un mod prima di installarlo e per spegnerlo, e con una precisazione importante sulla sicurezza.
In pratica i Claude Code mods trasformano Claude Code da strumento chiuso a piattaforma modificabile, come i mod di un videogioco. Qui trovi cosa sono, come si installano, cosa ci si può fare davvero e, soprattutto, quali rischi controllare prima di installarne uno.
Cosa sono i mod di Claude Code
I Claude Code mods sono funzioni che si agganciano agli eventi della sessione. Ogni volta che Claude Code fa qualcosa, come chiamare uno strumento, chiedere un permesso o disegnare una parte dello schermo, emette un evento.
Il mod può intervenire prima dell'evento, dopo o al suo posto. Viaggia dentro un plugin, quindi si installa e si condivide come qualsiasi plugin di Claude Code.
Con una sola funzione un mod può:
- Riscrivere un prompt prima che arrivi al modello.
- Bloccare, modificare o ripetere una chiamata a uno strumento.
- Approvare o negare una richiesta di permesso.
- Nascondere segreti dall'output di uno strumento prima che Claude lo legga.
Se più mod si agganciano allo stesso evento, girano nell'ordine in cui sono stati caricati. Questo permette di combinare mod di autori diversi.
Mod e hook: cosa cambia davvero
Gli hook di Claude Code esistevano già: lanciano uno script quando succede qualcosa. Anthropic spiega che gli sviluppatori chiedevano più controllo, e gli hook avevano tre limiti che i mod superano:
- Riscrivere l'evento: un hook può reagire a un comando, un mod può cambiarlo prima che parta.
- Disegnare interfaccia: pulsanti, un pannello laterale, una banda sopra il prompt.
- Sostituire una funzione integrata: per esempio il pannello
/diff.
C'è anche una differenza tecnica: un hook riparte da zero a ogni evento, mentre un mod si carica una volta e tiene uno stato per tutta la sessione.
Le funzioni di Claude Code che sono già mod
Alcune funzioni di Claude Code ora sono a loro volta mod: il pannello /diff e il caricamento del file AGENTS.md sono due esempi. Il /diff si può disattivare da /plugin o sostituire con una versione propria.
La lista dei mod integrati sta crescendo: in /plugin, nella scheda Installed sotto Built-in, oggi trovi anche quelli per la telemetria, per scrivere nuovi mod e per i suggerimenti You Should Know. Il codice di alcuni è pubblico nella cartella mods del repository di Claude Code su GitHub.
Cosa può fare un mod di Claude Code: tre esempi ufficiali
Nella guida di lancio Anthropic costruisce tre mod di esempio:
- Token Weather: una banda sopra il prompt che mostra il riempimento della finestra di contesto come una previsione meteo, da sereno a temporale. Circa 80 righe. Se il contesto si riempie troppo in fretta, nella guida per ridurre i token di Claude Code spiego cosa lo occupa.
- Blast Radius: ferma comandi rischiosi come
rm -rf,git reset --hard, force push e migrazioni del database, mostra cosa toccherebbero e chiede Procedi o Annulla. - Replay Theater: registra le modifiche ai file durante un turno e alla fine te le fa rivedere una alla volta con
/replay.
I tre esempi sono pubblici su GitHub, nella cartella claude-code/mods del repository anthropics/claude-code-playground: ognuno è un plugin completo, condiviso così com'è e senza supporto. Nei primi giorni la community ne ha pubblicati di ogni tipo, da pannelli per le pull request di GitHub a filtri per le parole sensibili, fino a giochi da usare mentre l'agente lavora.
Cosa è cambiato nel primo mese
Da ottobre Anthropic ha rilasciato una versione di Claude Code quasi ogni giorno, e diverse riguardano i mod. Quelle che contano per chi li usa:
- I mod disegnano anche in VS Code: dalla versione 2.1.299 dell'estensione, pannelli e pulsanti compaiono anche nel pannello chat di VS Code, non solo nel terminale e nell'app desktop.
- Conferme solo umane: dalla 2.1.304 un mod che controlla le chiamate agli strumenti può chiedere che una conferma arrivi solo da una persona, dalla finestra dei permessi, e non da un altro mod.
- Un nuovo mod integrato, You Should Know: un agente laterale che, quando trova qualcosa che potresti non aver notato, ti lascia una nota sopra il prompt. È spento finché non lo attivi tu.
- Una skill per scrivere mod: il comando
/plugin-authoringcarica il riferimento che Claude usa quando gli chiedi di scriverne uno.
Claude Code mods, skill e MCP: le differenze
- Skill: istruzioni e risorse che insegnano al modello come fare un compito. Cambiano cosa sa fare il modello, non il programma.
- Server MCP: collegano Claude a strumenti e dati esterni, come un CRM o un database.
- Mod: cambiano Claude Code stesso: comportamento, interfaccia e funzioni.
Se vuoi capire quali skill valga la pena installare, ho fatto una selezione nella guida alle migliori skill di Claude Code.
Come installare i Claude Code mods
Un mod si installa come un plugin, da un marketplace: di solito un repository GitHub che elenca i plugin. Servono tre comandi dentro Claude Code:
/plugin marketplace add organizzazione/repository
/plugin install nome-mod@marketplace
/reload-plugins
Gli aggiornamenti arrivano via Git. Dal terminale funziona anche claude plugin install nome-mod@marketplace: se lo lanci mentre una sessione è aperta, in quella sessione serve /reload-plugins. Per condividere un mod lo si impacchetta in un plugin e lo si pubblica in un marketplace.
Requisiti
- Claude Code 2.1.287 o successivo.
- CLI, scheda Code dell'app desktop o estensione VS Code (dalla versione 2.1.299) per vedere pannelli e pulsanti. Con
claude -pe nelle sessioni cloud gli hook del mod girano, ma l'interfaccia che disegna non compare. Nelle sessioni WSL dell'app desktop i mod non girano. - Nessun flag da attivare: il supporto è acceso di default.
Come creare un mod
Non serve conoscere l'API: puoi descrivere a Claude Code cosa vuoi vedere, lui scrive il TypeScript, lo installa e lo ricarica a caldo nella sessione, così chiedi modifiche senza riavviare.
Se preferisci scriverlo a mano, un mod minimo è una cartella con un manifest plugin.json, un file hooks.json che indica il modulo e il modulo stesso, che esporta una funzione register. In locale lo carichi con claude --plugin-dir ./cartella-mod.
Prima di condividerlo, claude plugin validate verifica manifest, tipi e chiamate all'API, mentre claude plugin test esegue i test sul runtime reale.
Lavorando ogni giorno con Claude Code sui progetti dei clienti, il primo mod che ha senso per me non è un gioco ma una guardia: un controllo che chiede conferma prima di ogni comando verso il database di produzione.
Claude Code mods: i rischi da controllare prima di installarli
Anthropic lo scrive chiaramente: i mod non girano in una sandbox. Hanno gli stessi accessi al computer di Claude Code e sono scritti da chi li pubblica, non da Anthropic.
- Installa solo da fonti di cui ti fidi: leggi il repository prima, come faresti con un pacchetto npm sconosciuto.
- Un mod di sicurezza non è un sistema di permessi: Blast Radius legge il testo del comando, quindi un comando nascosto in un alias o in uno script gli sfugge. E vale anche al contrario: su un piano Pro o Max personale, senza impostazioni gestite, un mod può approvare da solo una chiamata che una regola ask ti avrebbe fatto confermare. Per un blocco vero servono le regole deny, che però tengono contro i mod solo dove è attiva la guardia sec-default (ne parlo sotto).
- L'API può cambiare tra una versione e l'altra: un mod interno va mantenuto come qualsiasi altro software.
- Isola l'ambiente: per progetti delicati fai girare Claude Code in una sandbox, come spiego nella guida a Docker Sandbox per Claude Code.
Il rischio non è teorico: poche settimane fa la falla Plugin4Shell ha mostrato quanto la catena dei plugin degli agenti AI sia un bersaglio.
Come controllare un mod prima di installarlo e come spegnerlo
Prima di installare un mod scaricato, clono il repository ed eseguo claude plugin validate ./cartella-mod. Il comando non avvia il mod: elenca nella riga hooks: gli eventi che intercetta e nella riga calls: cosa chiede a Claude Code.
- $.fs.read e $.fs.write: legge o scrive file ovunque arrivi il tuo utente.
- $.process.run e $.process.spawn: avvia programmi a tuo nome.
- $.http.fetch: fa richieste di rete.
- $.env.get e $.settings.read: legge variabili e impostazioni, dove spesso ci sono chiavi API.
- $.model.complete: usa il tuo piano o la tua chiave API per chiamare un modello.
Un mod che mostra solo un pannello non ha motivo di avviare processi o fare richieste di rete. Se le chiede, prima di installarlo voglio capire perché.
Per spegnere i mod hai tre livelli:
- Un solo mod: lo disattivi o lo disinstalli dalla scheda Installed di
/plugin. - Tutti i mod, per una sessione: avvii Claude Code con
claude --safe-mode, utile anche per capire se un problema dipende da un mod. - Tutti i mod, sempre: imposti
"disableAllHooks": truein~/.claude/settings.json. Si fermano anche gli hook nei file di impostazioni e la status line personalizzata.
I mod integrati, come quello di /diff, non si fermano con questi interruttori: ognuno si spegne da /plugin. E se durante l'accesso anticipato avevi impostato la variabile CLAUDE_CODE_ENABLE_FUNCTION_HOOKS, toglila: dalla versione 2.1.287 viene ignorata, quindi metterla a 0 non spegne i mod.
Claude Code mods in azienda: cosa possono fare gli amministratori
Visto che i mod viaggiano dentro i plugin, valgono i controlli sui plugin che esistono già. Sui piani Team ed Enterprise gli amministratori possono consentire o bloccare i marketplace dalla console di amministrazione o dalle impostazioni gestite.
In più c'è un mod integrato chiamato sec-default, che si carica prima dei mod degli utenti e protegge quello che l'azienda gestisce: hook gestiti, istruzioni gestite, server MCP gestiti. Dove è attivo, un mod dell'utente non può approvare una chiamata bloccata da una regola deny. Attenzione però a due limiti: si carica solo sui computer con impostazioni gestite o con un account Team o Enterprise, quindi su un Pro o Max personale non c'è; e non ferma le letture di file o i processi che il mod fa da solo.
Per chi amministra Claude Code in azienda la leva più netta è l'opzione allowManagedModsOnly nelle impostazioni gestite: carica solo i mod dell'organizzazione e quelli integrati, e blocca tutti quelli installati dagli utenti, compresi quelli scritti da Claude durante una sessione.
I mod servono anche a costruire controlli propri. Gli esempi che fa Anthropic sono concreti:
- un pannello con lo stato della pipeline CI/CD accanto alla conversazione;
- una conferma obbligatoria prima di qualsiasi comando che tocca la configurazione di produzione;
- un registro di tutte le chiamate fatte dagli altri mod.
Il mio consiglio è semplice: in azienda sì, se il mod è vostro, scritto e revisionato da voi. No, se sono mod trovati online installati per curiosità sulla macchina con cui lavori sui dati dei clienti.
Se vuoi portare agenti AI come Claude Code nei processi della tua azienda con regole chiare, è il lavoro che faccio con le automazioni AI. Per lavorare con più agenti in parallelo leggi anche come funziona Claude Code Projects, oppure scrivimi.



