Salta ai contenuti

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 porta su ogni macchina i file del plugin, e su ogni macchina il plugin viene installato e attivato.

Dove si trovano

I plugin personalizzati stanno nella cartella custom-plugins, dentro la cartella di Claude Code (~/.claude). La cartella contiene anche:

  • il file custom-plugins.json, l’elenco dei plugin del team;
  • un README che spiega come preparare un plugin;
  • un file .knmsyncignore, che indica quali file non devono viaggiare (vedi Cosa resta sulla macchina più sotto).

Come creare e distribuire un plugin (maintainer)

  1. Crea la cartella del plugin dentro custom-plugins.
  2. Aggiungi il plugin a custom-plugins.json con il nome, lo stato (attivo o no), l’eventuale script di preparazione e una nota facoltativa.
  3. Registralo anche nel file .claude-plugin/marketplace.json della stessa cartella, come indica il README.
  4. Premi Sincronizza ora. Il plugin parte verso il repository del team e da lì raggiunge le altre macchine.

Dalla dashboard il maintainer apre con un click l’elenco dei plugin e il README.

Cosa succede su ogni macchina

Su ogni macchina tutto avviene da solo, senza premere pulsanti. A ogni sincronizzazione ogni plugin nuovo o modificato, se è attivo, viene installato e abilitato in Claude Code.

  • Se il plugin ha uno script di preparazione, questo viene eseguito per installare ciò che serve. Lo script può avere una versione per ciascun sistema operativo.
  • Se la preparazione non riesce, il plugin resta installato e la dashboard lo segnala con Setup non riuscito. La sincronizzazione prosegue normalmente.
  • Un plugin disattivato o tolto dall’elenco viene disinstallato su tutte le macchine.

Nella dashboard

Scheda Plugin

I plugin personalizzati compaiono anche nella scheda Plugin, in sola lettura, ciascuno con il suo stato (Installato, In attesa o Setup non riuscito) e la nota Gestiscili in Sistema Claude › Plugin personalizzati.

La scheda Plugin: i plugin personalizzati in sola lettura, ciascuno con lo stato Installed, Pending o Setup failed e la nota che rimanda a Claude system › Custom plugins I plugin personalizzati nella scheda Plugin; si gestiscono da Sistema Claude › Plugin personalizzati.

Scheda Sistema Claude › Plugin personalizzati

Nella scheda Sistema Claude, la sezione Plugin personalizzati raccoglie i plugin del team, con il numero di plugin e il pulsante Apri cartella. Per ogni plugin trovi nome, note, stato e Apri.

  • Il maintainer ha l’interruttore per attivarlo o disattivarlo e il pulsante Elimina, con conferma a doppio click: entrambi valgono per tutto il team alla sincronizzazione successiva.
  • Come le skill, un plugin personalizzato si può condividere con il team o tenere per sé (etichetta Solo tue).
  • I membri vedono lo stato, il pulsante Apri e se il plugin è attivo, senza poterlo modificare.

Un plugin eliminato per tutto il team sparisce da ogni macchina. In fondo alla sezione il maintainer trova l’elenco Eliminato dal team, con Ripristina accanto a ogni nome: Ripristina riabilita il nome, così il plugin può essere condiviso di nuovo. I file precedenti si recuperano dalla cronologia del repository o da un backup.

La sezione Plugin personalizzati nella scheda Sistema Claude: ogni plugin con le note, lo stato e i controlli Open e Delete del maintainer La sezione Plugin personalizzati vista dal maintainer (esempio su edizione Team).

Accendere o spegnere i plugin personalizzati su una macchina

Nella scheda Sistema, la card Plugin personalizzati ha l’interruttore Sync plugin personalizzati. Lo stato scelto dal maintainer vale come predefinito per il team e le nuove macchine lo ereditano; ogni macchina, di qualsiasi ruolo, può comunque spegnerlo per sé.

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

Cosa resta sulla macchina

Un plugin viaggia come sorgente, senza i file che la compilazione produce. Per questo la cartella contiene già un .knmsyncignore, con la stessa sintassi di un .gitignore (vedi Cosa sincronizza). Esclude i file più comuni che non hanno senso su un’altra macchina: node_modules/, bin/, obj/, dist/, .git/ e le librerie compilate come *.exe, *.dll, *.so, *.dylib. Puoi modificarlo: aggiungi ciò che il tuo plugin genera, oppure togli una regola che non ti serve. Il maintainer lo apre direttamente dalla dashboard.

I programmi di cui un plugin ha bisogno conviene installarli con il suo script di preparazione, invece di metterli nel pacchetto.

Vedi anche