Plugin personalizzati

I plugin personalizzati sono i plugin di Claude Code che il tuo team scrive da sé, invece di installarli da un marketplace pubblico. Claude Sync li porta su ogni macchina: non solo il fatto che siano installati, ma i file del plugin stessi viaggiano attraverso il repository del team.

Da non confondere con il dominio Plugin

Il dominio Plugin sincronizza l’inventario dei plugin installati da un marketplace pubblico o git: installi una volta e il plugin compare ovunque, lo rimuovi e sparisce ovunque — ma il pacchetto arriva sempre dal marketplace. I plugin personalizzati sono un’altra cosa: qui è il plugin in sé a viaggiare, perché lo hai scritto tu e non esiste su nessun marketplace. Per il quadro completo dei domini vedi Cosa sincronizza.

Dove vivono

I plugin personalizzati vivono in una cartella custom-plugins dentro la cartella di configurazione di Claude Code (~/.claude). Quella cartella funziona come un piccolo marketplace locale per Claude Code e contiene anche:

• il manifesto del team custom-plugins.json, che elenca i plugin condivisi;
• un README che spiega il formato di un pacchetto;
• un file .knmsyncignore che dichiara quali file non vengono portati tra le macchine (vedi Limiti e disponibilità più sotto).

Il ciclo di vita

Creazione (maintainer)

Creare un plugin personalizzato è un’operazione basata su file, riservata al maintainer:

• aggiungi la cartella del pacchetto dentro custom-plugins;
• dichiaralo in custom-plugins.json con nome, stato (attivo o disattivo), un eventuale script di setup e note facoltative.

Il README nella cartella descrive il formato da seguire. Dalla dashboard, il maintainer ha pulsanti di accesso rapido per aprire il manifesto e il README. Non esiste nessuna procedura guidata in-app: la creazione è volutamente manuale, sui file.

Pubblicazione

Alla sincronizzazione successiva il pacchetto viene spedito al repository del team. Da lì raggiunge tutte le altre macchine.

Ricezione (ogni macchina, automatica)

Su ogni macchina la ricezione è completamente automatica, senza premere alcun pulsante. A ogni sincronizzazione ciascun plugin nuovo o modificato e attivo viene registrato presso Claude Code, installato e abilitato.

• Se il plugin dichiara uno script di setup, viene eseguito per preparare i prerequisiti (sono supportate varianti per sistema operativo, così ogni macchina esegue quella giusta per Windows, macOS o Linux).
• Se il setup fallisce, il plugin resta installato ma viene contrassegnato come Setup fallito nella dashboard: la sincronizzazione non si blocca mai per questo.
• Un plugin disattivato o rimosso dal manifesto viene disinstallato automaticamente su tutte le macchine.

Nella dashboard

Scheda Plugin

I plugin personalizzati compaiono anche nella scheda Plugin come specchio in sola lettura, ognuno con una pillola di stato — Installato, In attesa o Setup fallito — e la nota Gestiscili in Sistema Claude › Plugin personalizzati, che ti indica dove si gestiscono.

I plugin personalizzati compaiono nella scheda Plugin come specchio in sola lettura; si gestiscono da Sistema Claude › Plugin personalizzati.

Scheda Sistema Claude → Plugin personalizzati

Nella scheda Sistema Claude un accordion Plugin personalizzati raccoglie i plugin del team: conteggio, la descrizione «Plugin del team installati su ogni macchina» e il pulsante per aprire la cartella. Per ogni plugin trovi nome, note, pillola di stato e un pulsante Apri. Il maintainer ha in più, per ciascun plugin, l’interruttore di abilitazione e un pulsante di eliminazione (armato, con conferma a doppio click): entrambi agiscono per tutto il team alla sincronizzazione successiva. I membri vedono soltanto le pillole di stato, in sola lettura.

Un’eliminazione per tutto il team resta: una macchina rimasta indietro non reinstalla più il plugin in seguito. In fondo all’accordion il maintainer trova un elenco Eliminato dal team con un pulsante Ripristina accanto a ogni nome rimosso — Ripristina ri-consente il nome, così il plugin può essere condiviso di nuovo; non riporta indietro i vecchi file (recuperali dalla cronologia git o da un backup).

L’accordion Plugin personalizzati nella scheda Sistema Claude (esempio su edizione Team), con lo stato per plugin e i controlli del maintainer.

La scheda del dominio

Una scheda dedicata Plugin personalizzati, accanto agli interruttori degli hook, offre l’interruttore on/off del dominio (impostazione: «Sincronizza i plugin Claude Code personalizzati del team tra le macchine»).

Governance

L’interruttore del maintainer è il valore predefinito del team: le nuove macchine lo ereditano. Ma ogni macchina — di qualsiasi ruolo — può disattivare la propria copia in locale per escludersi dal dominio. In breve: l’interruttore del maintainer è il default del team; ogni macchina può disattivarlo localmente.

L’impostazione separata di installazione automatica dei plugin riguarda solo l’inventario dei plugin del marketplace, non i plugin personalizzati.

Limiti e disponibilità

Un pacchetto è pensato per portare il sorgente del plugin, non l’output di build che un plugin compilato accumula. Per tenere a casa quell’output, la cartella include un file .knmsyncignore già pronto — la stessa dichiarazione in stile .gitignore descritta in Cosa sincronizza. Per impostazione predefinita esclude gli artefatti non portabili più comuni (node_modules/, bin/, obj/, dist/, .git/ e le librerie compilate come *.exe, *.dll, *.so, *.dylib). È una dichiarazione modificabile, non una regola fissa: estendila per coprire ciò che il tuo bundle genera, oppure riducila se ti serve. Puoi aprire e modificare il file direttamente dalla dashboard.

I binari di cui un plugin ha davvero bisogno conviene trattarli come prerequisiti installati dal suo script di setup, invece di spedirli dentro il pacchetto.

Edizioni Pro e Team

La sincronizzazione dei plugin personalizzati è inclusa nelle edizioni Pro e Team, non in Starter. Senza una licenza che la includa — o se disattivi il dominio — le sue schede e i suoi controlli non compaiono affatto nella dashboard: non sono disabilitati, semplicemente non ci sono.

Vedi anche

• Cosa sincronizza — i domini e cosa viaggia in ognuno, incluso il dominio Plugin da cui distinguere questo.
• Edizioni — quali edizioni sbloccano i plugin personalizzati.
• Gestire la configurazione — attivare e disattivare i domini di sincronizzazione.
• La dashboard — le schede Plugin e Sistema Claude, una per una.