Panoramica dei mod

​

Cosa può fare un mod

• Disegnare un’interfaccia che puoi usare: un riquadro accanto alla trascrizione o una banda sopra il prompt, con schede, pulsanti e campi di testo. Vedi Disegnare nell’interfaccia.
• Ridisegnare l’interfaccia di Claude Code: sostituire o modificare lo stile di parti che Claude Code disegna stesso, come la riga di una chiamata di strumento, lo spinner o la finestra di dialogo in cui Claude pone domande. Vedi Cambiare quello che Claude Code disegna già.
• Intervenire in una chiamata di strumento o una richiesta: ad esempio, trattenere una chiamata di strumento mentre chiedi all’utente una domanda, rispondere senza eseguire lo strumento o inviare una richiesta a un modello diverso. Vedi Proteggere o modificare una chiamata di strumento e Seguire un turno.
• Eseguire il tuo codice su un comando: un /command che esegue la tua funzione immediatamente, senza un turno di Claude, anche mentre Claude sta lavorando. Vedi Aggiungere un comando o uno strumento.
• Condividere dati tra hook: gli hook di un mod condividono le variabili nel suo file, quindi quello che un hook registra, un altro può mostrare. Ad esempio, un hook può contare le chiamate di strumento mentre un altro mostra il conteggio accanto allo spinner, oppure uno può leggere l’utilizzo dei token di ogni richiesta mentre un altro lo rappresenta graficamente in un riquadro. Vedi Reagire agli eventi.

​

Ottenere un mod

• Usarne uno che hai già: alcune funzioni di Claude Code sono mod, come /diff. Vedi Mod integrati in Claude Code.
• Crearne uno: descrivi quello che vuoi in una sessione di Claude Code e Claude scrive il mod. Vedi Chiedere a Claude un mod. Per imparare come funziona il codice di un mod, scrivi uno tu stesso.
• Installarne uno: vedi Installare o aggiornare un mod

​

Installare o aggiornare un mod

• In una sessione di Claude Code, esegui /plugin install token-chart@your-org.
• Nella tua shell, esegui claude plugin install token-chart@your-org.

​

Decidere se fidarsi di un mod

​

Cosa può raggiungere un mod

• Agire sulla tua macchina come te: leggere e scrivere file ovunque il tuo account utente possa, avviare programmi e fare richieste di rete
• Leggere i tuoi segreti: variabili di ambiente e file di impostazioni, inclusa una chiave API che mantieni in uno di essi
• Vedere la tua sessione: ogni prompt che invii e ogni chiamata di strumento che Claude fa
• Modificare la tua sessione: riscrivere un prompt o una chiamata di strumento, inviare un prompt come se l’avessi digitato, o inviare un messaggio a un’altra delle tue sessioni
• Agire senza chiederti: approvare una chiamata di strumento prima che ti venga chiesto
• Spendere il tuo utilizzo: chiamare un modello sul tuo piano o sulla tua chiave API

​

Elencare cosa fa un mod prima di installarlo

claude plugin validate ./some-mod

​

Attivare o disattivare i mod

• Un mod: disabilita o disinstalla il suo plugin dalla scheda Installed in /plugin
• Ogni mod installato, per una sessione: avvia Claude Code con --safe-mode, che lascia fuori anche le tue altre personalizzazioni
• Ogni mod che hai installato, in ogni sessione: imposta "disableAllHooks": true in ~/.claude/settings.json. I tuoi settings hook e la riga di stato personalizzata si fermano anche. Quello che la tua organizzazione gestisce continua a funzionare.

​

Vedere quali mod una sessione ha caricato

​

Come funziona un mod

first-mod/
├── .claude-plugin/
│   └── plugin.json
└── hooks/
    ├── hooks.json
    └── register.js

• plugin.json: il manifest del plugin
• hooks.json: punta al tuo file di codice
• register.js: il tuo codice, chiamato il modulo hooks. Dice a Claude Code su quali eventi eseguire le tue funzioni.

// The count, shared by the two hooks below
let calls = 0

// Claude Code calls this once when the mod loads
export function register(on) {
  // Runs each time Claude is about to use a tool
  on('tool.call', async ($, e, next) => {
    calls += 1
    // Ask Claude Code to draw the interface again, so the new count shows
    $.ui.invalidate('ui.render')
    // Let the tool run as usual
    return next(e)
  })

  // Runs each time Claude Code draws the spinner
  on('ui.render', { component: 'Spinner' }, async ($, e, next) => {
    // Keep Claude Code's spinner, with the count added after its word
    return next({ ...e, props: { ...e.props, suffix: ' · tool calls: ' + calls + '…' } })
  })
}

• L’hook tool.call viene eseguito ogni volta che Claude sta per usare uno strumento. Aggiunge uno a calls, chiede a Claude Code di disegnare di nuovo l’interfaccia e lascia che lo strumento funzioni come al solito.
• L’hook ui.render viene eseguito ogni volta che Claude Code disegna lo spinner. Mantiene lo spinner di Claude Code e aggiunge il conteggio dopo la parola.

​

Cosa può fare un hook con un evento

• Osservare: notare cosa sta succedendo e lasciarlo continuare invariato, come fa l’hook tool.call nell’esempio
• Riscrivere: cambiare l’evento prima che continui, come fa l’hook ui.render quando aggiunge il conteggio allo spinner
• Rispondere: gestire l’evento stesso, quindi il comportamento usuale non viene eseguito, come rifiutare un comando

​

Dove vengono eseguiti i mod

​

Controllare i mod per la tua organizzazione

​

Confrontare mod, settings hook, skills e server MCP

​

Mod integrati in Claude Code

​

Leggere il codice sorgente dei mod integrati

• diff: il riquadro /diff, con pulsanti associati ad azioni da tastiera e scorrimento che il mod gestisce da solo
• agents-md: carica AGENTS.md come istruzioni di progetto, con un’opzione userConfig
• sec-default: il guard descritto in Sapere cosa accade per impostazione predefinita, un modello per un mod che applica la politica
• telemetry: aggiunge metodi che altri mod possono chiamare e spedisce i loro tipi

​

Passaggi successivi

• Creare un mod: costruisci uno che conta le chiamate di strumento, mostra il conteggio accanto allo spinner e aggiunge un comando, e impara il ciclo di modifica e ricaricamento
• Disegnare nell’interfaccia: riquadri, la banda sopra il prompt, pulsanti, campi di testo e stato
• Reagire agli eventi: chiamate di strumento, prompt, turni e l’ordine in cui i mod vengono eseguiti
• Usare l’API dei mod: comandi, strumenti, chiamate di modello, timer e file
• Testare un mod: test automatizzati che vengono eseguiti senza una sessione
• Risolvere i problemi di un mod: i motivi per cui un mod non fa nulla e il log di debug
• Gestire i mod per la tua organizzazione: impostazioni predefinite, impostazioni gestite, revisione di un mod e mod di politica
• Riferimento dei mod: ogni evento, metodo, elemento e limite