Personalizza Claude Code con le mod

Oggi introduciamo le mod, le piccole funzioni di TypeScript che cambiano il modo in cui Claude Code funziona. Una mod può riscrivere un prompt, aggiungere una nuova interfaccia utente, sostituire una funzionalità di default o aggiungere funzionalità completamente nuove. Scrivi direttamente una mod o chiedi a Claude Code di scriverne una per te. Le mod sono integrate nei plugin, così puoi installarle e condividerle come qualsiasi altro plugin. Funzionano nella CLI di Claude Code e nell'app desktop.

Le mod vengono eseguite con lo stesso accesso al tuo computer di Claude Code. Non sono soggette a sandboxing. Inoltre, installa le mod solo da fonti di cui ti fidi, allo stesso modo in cui installeresti qualsiasi codice sul tuo computer.

Per scoprire cosa possono fare le mod, leggi la nostra guida per creare la tua prima mod.

Perché abbiamo sviluppato le mod?

Molti sviluppatori e sviluppatrici ci hanno chiesto di poter avere un maggiore controllo sul funzionamento di Claude Code, senza dover aspettare l'uscita di nuove funzionalità. Gli hook hanno aiutato gli utenti a ottenere in parte questo livello di controllo, tuttavia, non consentono di riscrivere gli eventi, disegnare nuove interfacce utente o sostituire le funzionalità. È qui che entrano in gioco le mod.

Vogliamo che Claude Code sia davvero personalizzabile, così può adattarsi al tuo modo di lavorare. Abbiamo condiviso il design per le mod su GitHub prima del lancio per ottenere il feedback degli sviluppatori. Ringraziamo tutte le persone che hanno contribuito al progetto.

Come funzionano le mod?

Ogni volta che Claude Code esegue qualcosa, emette un evento. Ad esempio, potrebbe chiamare uno strumento, chiedere il permesso e disegnare parte dello schermo. Una mod è una funzione che si aggancia a uno di questi eventi e può essere eseguita prima dell'evento, dopo o al suo posto. Può anche completare l'evento, eseguendo il codice sia prima, sia dopo. Con una sola funzione, una mod può:

• Riscrivere un prompt prima che raggiunga il modello.
• Bloccare, riscrivere o riprovare la chiamata di uno strumento.
• Approvare o negare una richiesta di permesso.
• Correggere i segreti dall'output degli strumenti prima che Claude li legga.

Le mod possono anche cambiare ciò che vedi. Ad esempio, possono modificare o sostituire parte dell'interfaccia progettata da Claude Code, come il risultato di uno strumento o una domanda di Claude. Possono aggiungere pulsanti e input e altre mod possono rispondere quando vengono premute. Oggi, le mod possono essere indirizzate al terminale, all'app desktop o a entrambi.

Quando diverse mod agganciano lo stesso evento, vengono eseguite nell'ordine di caricamento. La prima mod caricata vede l'evento per primo e il risultato per ultimo. Questo consente di combinare le mod di autori diversi.

Puoi anche utilizzare Claude Code per modificare Claude Code. Chiedi a Claude di creare una mod e sarà in grado di scrivere il TypeScript, installarlo e caricarlo direttamente nella tua sessione.

Scambia le funzionalità integrate con le tue

Alcune funzionalità integrate di Claude Code sono ora disponibili come mod. Ad esempio, la funzionalità integrata /diff ora è disponibile come mod, quindi puoi disattivarla (in /plugin) o sostituirla con la tua versione. Abbiamo in programma di trasferire nelle mod sempre più funzionalità predefinite, così potrai ridurre Claude Code a un nucleo essenziale e reintegrare solo ciò che desideri.

Mod per team e aziende

Le mod vengono integrate nei plugin, così da poter applicare i controlli esistenti dei plugin. Gli amministratori possono consentire o bloccare i marketplace per i plugin. Per i piani Team ed Enterprise, è l'utente proprietario a poter impostare questa opzione nella console di amministrazione. Sui piani Claude API e di terze parti, gli amministratori possono inviare le impostazioni gestite ai computer degli utenti.

Sui piani Team ed Enterprise, e su qualsiasi macchina con impostazioni gestite, viene caricata in primis la mod integrata sec-default (“sicurezza predefinita“). Essa impedisce alle mod installate dagli utenti di fare cose rischiose, come ignorare le regole di denial-permission. Puoi visualizzare il codice sorgente per vedere cosa viene limitato. Gli amministratori possono invece caricare prima le proprie mod. In tal caso, aggiungi sec-default al tuo elenco per mantenere le restrizioni.

I team possono inoltre utilizzare le mod per creare i propri controlli e funzionalità. Ad esempio:

• Stato CI/CD: può mostrare lo stato della pipeline in un riquadro accanto alla conversazione e aggiornarlo man mano che le build vengono completate o meno.
• Garanzie di produzione: può richiedere la conferma prima che qualsiasi comando tocchi la configurazione di produzione.
• Audit logging: caricata per prima, può registrare ogni chiamata effettuata da qualsiasi altra mod.

Per iniziare

Le mod sono disponibili già da oggi nella CLI di Claude Code e nell'app desktop. Installa i plugin che includono le mod dalla directory di Claude o eseguendo /plugin nella CLI. Per condividere una mod, crea un pacchetto plugin e inviala alla directory.

Per creare le tue mod, leggi la guida introduttiva o consulta la documentazione di riferimento.