Installare e gestire i plugin di Claude Code: guida pratica

Per installare un plugin in Claude Code apri una sessione nel terminale, scrivi /plugin install nome@marketplace, controlla la scheda che si apre e scegli l'ambito: per te in tutti i progetti, per tutto il repository o solo per te in quel repository. Da lì in poi lo gestisci dal pannello /plugin oppure, fuori dalla sessione, con i comandi claude plugin. Gli aggiornamenti arrivano da soli solo se il marketplace di provenienza ha l'aggiornamento automatico attivo.

Se il concetto di plugin ti è nuovo, parti dall'articolo su plugin e marketplace di Claude Code: in breve, un plugin è un pacchetto di skills, subagenti, hooks e server MCP che si installa con un solo comando. Qui vediamo la parte operativa, comando per comando, così come la descrive la guida ufficiale Install and manage plugins. Tutta la serie è raccolta nella guida ai plugin di Claude Code.

Come si installa un plugin dal terminale?

Avvia Claude Code con claude nella cartella del progetto. Se sei agli inizi, leggi prima cos'è Claude Code e come iniziare. Poi segui questi passaggi, usando come esempio commit-commands, un plugin del marketplace ufficiale che aggiunge comandi per commit, push e pull request:

1. Apri la scheda del plugin con /plugin install commit-commands@claude-plugins-official. In sessione il comando non installa subito: mostra i dettagli per farti decidere.
2. Leggi cosa aggiunge. La sezione Will install elenca comandi, agenti, skills, hooks e server MCP e LSP; per i plugin del marketplace ufficiale trovi anche Last updated e la stima Context cost.
3. Scegli l'ambito tra le tre opzioni proposte. Claude Code installa il plugin insieme alle eventuali dipendenze dichiarate.
4. Leggi il riepilogo finale. Plugin is now active. significa che è già utilizzabile; Run /reload-plugins to apply. che serve un ricaricamento; The plugin couldn't be loaded che qualcosa è andato storto.
5. Verifica: digita / e cerca le skills del plugin nella forma /<plugin>:<skill>, per esempio /commit-commands:commit.

Se non conosci il nome esatto, scrivi solo /plugin: il pannello si apre sulla scheda Discover, dove puoi digitare per cercare e premere Invio su un plugin per aprirne i dettagli. I plugin di un marketplace diverso da quello ufficiale richiedono un passaggio in più: aggiungere prima il marketplace, come vedremo sotto.

Quali schede ha il pannello /plugin?

Il comando /plugin (con gli alias /plugins e /marketplace) apre un pannello a schede, raggiungibili con il tasto Tab:

Nella scheda Installed puoi digitare per filtrare, premere Spazio per abilitare o disabilitare il plugin selezionato e Invio per aprirne i dettagli. I plugin disabilitati finiscono in un gruppo chiuso in fondo all'elenco, e quelli che non usi da tempo compaiono sotto Not used recently.

User, project o local: quale ambito scegliere?

L'ambito decide per chi il plugin è abilitato e in quale file di impostazioni viene scritto: da esso dipende se il plugin resta una tua preferenza o diventa una regola del progetto.

Se lo stesso plugin è impostato in più ambiti, vince il più specifico: local prevale su project, project su user. L'ambito project ha una particolarità che sorprende molti team: salvare la voce in .claude/settings.json abilita il plugin per i colleghi, ma non lo scarica sui loro computer. Ognuno deve eseguire una volta claude plugin install <nome>@<marketplace> --scope project, altrimenti la scheda Errors segnala che il plugin è abilitato nel progetto ma non installato.

Alcuni plugin sono impostati dall'autore per partire spenti, tramite il campo defaultEnabled. In quel caso il plugin risulta installato ma resta disattivato finché non lo accendi con claude plugin enable <nome> o dalla scheda Installed.

Quali comandi claude plugin si usano dalla shell?

Fuori da una sessione, per esempio in uno script, usi i sottocomandi di claude plugin (anche claude plugins). Modificano le stesse impostazioni del pannello:

claude plugin install formatter@your-org --scope project
claude plugin list
claude plugin disable formatter@your-org
claude plugin enable formatter@your-org
claude plugin update formatter@your-org
claude plugin uninstall formatter@your-org --scope project

Qualche regola utile. install e uninstall agiscono per impostazione predefinita sull'ambito user; enable e disable sull'ambito più specifico in cui il plugin è già elencato. I plugin installati dalla shell si caricano alla sessione successiva, o subito con /reload-plugins in una sessione già aperta. Su un computer dove nessuno ha mai aperto una sessione interattiva, il marketplace ufficiale non è ancora registrato: lo script deve prima eseguire claude plugin marketplace add anthropics/claude-plugins-official.

Alcuni plugin si installano eseguendo un comando indicato dal marketplace. Claude Code te lo mostra e chiede conferma; in uno script, dove nessuno può rispondere, si aggiunge --yes, ma solo dopo aver letto quel comando. La sintassi completa di ogni sottocomando è nel riferimento dei comandi per i plugin.

Come si aggiunge un marketplace diverso da quello ufficiale?

Con /plugin marketplace add seguito dalla sorgente: un repository GitHub nella forma proprietario/repository, l'URL completo di un repository git su qualsiasi host, un percorso locale che inizia con ./ o ../, oppure l'URL di un file marketplace.json pubblicato online. Dopo il cancelletto puoi fissare un branch o un tag:

/plugin marketplace add your-org/plugins#v1.2.0

Si aggiunge una volta sola. Per fare tutto in un passaggio, le versioni recenti accettano anche /plugin install deploy-helper --marketplace your-org/plugins, che chiede conferma prima di aggiungere il catalogo. Per i repository privati, le credenziali e la gestione di un catalogo aziendale rimandiamo all'articolo sul marketplace privato per il team; per distinguere i cataloghi di Anthropic da quelli di terzi, a quello sul marketplace ufficiale e community.

Come funzionano aggiornamenti e /reload-plugins?

I plugin si aggiornano da soli quando il loro marketplace ha l'aggiornamento automatico attivo. È attivo per impostazione predefinita su claude-plugins-official e sugli altri marketplace ufficiali di Anthropic (con alcune eccezioni indicate nella documentazione) e sui marketplace aggiunti da claude.ai; è spento sul marketplace community, su quelli di terze parti e su quelli locali. Lo cambi nella scheda Marketplaces con Enable auto-update o Disable auto-update.

L'aggiornamento avviene in background dopo l'inizio della sessione e tocca solo i file sul disco: la sessione in corso continua con le versioni già caricate e ti avvisa con Plugin updated: <name> · Run /reload-plugins to apply. Per aggiornare a mano un plugin usa Update now nella scheda Installed o claude plugin update; per tutti i plugin di un catalogo, Update marketplace nella scheda Marketplaces.

/reload-plugins applica alla sessione aperta i cambiamenti in sospeso, senza riavviare. Quando chiudi il pannello /plugin dopo una modifica viene eseguito da solo. Se però il ricaricamento cambierebbe i server MCP disponibili e invaliderebbe la cache del prompt, Claude Code si ferma e avvisa: con /reload-plugins --force lo applichi comunque, al prezzo di una richiesta senza cache. Il costo in token dei plugin è il tema dell'articolo su costo e test dei plugin.

Come si disabilita o si rimuove un plugin?

Disabilitare lascia il plugin installato ma fuori dalle sessioni; disinstallare lo rimuove dalle impostazioni. Tre casi meritano attenzione:

• Plugin abilitato dal progetto: se scegli Uninstall, Claude Code chiede se disabilitarlo solo per te (tasto y, scrive false in .claude/settings.local.json) o toglierlo a tutti (tasto u, lo rimuove dal .claude/settings.json condiviso).
• Dipendenze: se un plugin ne ha installati altri come dipendenze, questi restano dopo la disinstallazione finché non esegui claude plugin prune; con --dry-run vedi prima cosa verrebbe rimosso.
• Rimozione di un marketplace: disinstalla tutti i plugin che avevi preso da lì, dopo averteli elencati.

Se dubiti di un plugin, la procedura di rimozione completa, compresi i dati salvati e i file in cache, è nell'articolo sulla sicurezza dei plugin.

E nell'app desktop, in VS Code e nelle sessioni cloud?

• App desktop, sessioni locali o SSH nella scheda Code: pulsante + accanto al campo del prompt, poi Add plugins (o Plugins e Browse plugins), quindi scelta dell'ambito.
• VS Code: /plugins apre Manage plugins; se l'elenco è vuoto, aggiungi anthropics/claude-plugins-official nella scheda Marketplaces.
• Esecuzioni non interattive con claude -p: /plugin non è disponibile, ma i plugin già installati si caricano; si gestiscono con claude plugin.
• Sessioni cloud, compresa claude.ai/code nel browser: non caricano né i plugin installati sul tuo computer né quelli attivati dal .claude/settings.json del repository.

Terminale, app desktop in locale ed estensione VS Code sullo stesso computer leggono gli stessi file di impostazioni: un plugin installato in ambito user in uno dei tre è disponibile anche negli altri due. A parte vanno i plugin attivati sul tuo account claude.ai, che arrivano in Claude Code come <nome>@synced: li trovi nell'articolo sui plugin su claude.ai e Cowork.

Cosa fare adesso

Installa un plugin in ambito local in un progetto di prova e verifica che le sue skills compaiano con /. Quando sei sicuro che serve, spostalo nell'ambito giusto; se lo adotta il team, scegliete l'ambito project e mettete nel README il comando di installazione per i colleghi. Le opzioni cambiano spesso: verifica la documentazione aggiornata.