Workbranch › Guide

Come installare i plugin in Claude Code

I plugin raccolgono skill, agenti, hook e server MCP in un'unica installazione. Questa guida spiega da dove arrivano i plugin, come installarne uno dal terminale, quale ambito scegliere e come aggiornarlo o rimuoverlo in seguito.

Aggiornato 30 ottobre 2026

I passaggi qui sotto seguono la documentazione di Claude Code di Anthropic a ottobre 2026. Valgono per il terminale; l'app desktop e VS Code hanno le loro schermate per i plugin, descritte brevemente più avanti. Sei alle prime armi con Claude Code? Parti da come iniziare con Claude Code.

Marketplace: da dove arrivano i plugin

Un marketplace è un catalogo di plugin. Claude Code registra il marketplace ufficiale di Anthropic, claude-plugins-official, la prima volta che apri una sessione interattiva nel terminale, quindi i suoi plugin sono subito pronti da installare. Tutto il resto (il catalogo di un collega, il marketplace della community di Anthropic, un repository aziendale) va aggiunto una volta prima di poterne installare i plugin.

1. Avvia Claude Code con claude.
2. Esegui /plugin marketplace add seguito dalla sorgente:
   • Un repository GitHub: /plugin marketplace add owner/repo (aggiungi #v1.2.0 per fissare un tag o un branch)
   • Qualsiasi altro host git: l'URL di clone completo, compreso https://
   • Una cartella sul tuo computer: un percorso che inizia con ./ o ../
   • Un file di catalogo ospitato online: l'URL https:// del suo marketplace.json
3. Cerca il messaggio Successfully added marketplace. I suoi plugin ora compaiono nella scheda Discover.

Per un repository privato, Claude Code usa le credenziali git già presenti sul tuo computer e non chiede mai una password, quindi assicurati prima che un normale git clone del repository funzioni.

Installare un plugin

1. Esegui /plugin install name@marketplace, per esempio /plugin install commit-commands@claude-plugins-official. In una sessione questo apre i dettagli del plugin invece di installarlo subito. Per sfogliare, esegui /plugin da solo, scrivi per cercare in Discover e premi Enter (Invio) su un plugin.
2. Leggi il pannello dei dettagli. Will install (verrà installato) elenca i comandi, gli agenti, le skill, gli hook e i server che aggiunge. Per i plugin del marketplace ufficiale di Anthropic mostra anche Last updated (ultimo aggiornamento) e, quando apri il plugin con il comando di installazione o dalla scheda Marketplaces, una stima del Context cost (costo in contesto) in token.
3. Scegli un ambito (vedi la tabella qui sotto).
4. Leggi l'ultima riga del riepilogo dell'installazione. Plugin is now active significa che hai finito. Se dice di eseguire /reload-plugins, Claude Code lo fa per te quando il pannello si chiude. Se un server incluso va configurato, apri il plugin nella scheda Installed (installati) e scegli Configure (configura).
5. Verifica che abbia funzionato: digita / e cerca le skill del plugin nella forma /plugin-name:skill, oppure esegui claude plugin list nella tua shell.

Scorciatoia per un marketplace che non hai ancora aggiunto: /plugin install name --marketplace owner/repo lo aggiunge (dopo averti chiesto conferma) e apre il plugin in un colpo solo. In una sessione questo richiede Claude Code v2.1.275 o successivo.

Quale ambito scegliere

L'ambito progetto attiva il plugin per i colleghi ma non lo scarica per loro: ognuno esegue una volta claude plugin install name@marketplace --scope project. Quando un plugin è impostato in più ambiti, local prevale su project e project prevale su user.

Aggiornare i plugin

• Automatico: attivo per impostazione predefinita per il marketplace ufficiale di Anthropic, disattivato per i marketplace della community, di terze parti e locali. Attivalo o disattivalo per ogni marketplace nella scheda Marketplaces di /plugin con Enable auto-update o Disable auto-update.
• Cosa vedrai: la sessione in corso mantiene la versione vecchia. Un messaggio ti dice di eseguire /reload-plugins; altrimenti la sessione successiva usa la nuova versione.
• Un solo plugin, subito: aprilo nella scheda Installed e seleziona Update now (aggiorna ora), oppure esegui claude plugin update name@marketplace.
• Tutti i plugin di un marketplace: seleziona il marketplace nella scheda Marketplaces e scegli Update marketplace. Non esiste un comando che aggiorni in un colpo solo tutti i tuoi plugin di tutti i marketplace.

Disattivare o disinstallare un plugin

1. Esegui /plugin e premi Tab per arrivare a Installed.
2. Premi Space (barra spaziatrice) su un plugin per disattivarlo o riattivarlo, oppure premi Enter e scegli Disable plugin o Uninstall.
3. Dalla shell, usa claude plugin disable, enable o uninstall con name@marketplace; aggiungi --scope project dove serve.

L'intestazione Not used recently (non usati di recente) nella scheda Installed è un modo rapido per trovare i plugin che consumano ancora contesto in ogni sessione. Rimuovere un intero marketplace (/plugin marketplace remove name) disinstalla anche tutti i plugin che hai installato da lì.

Da sapere

• Fiducia: un plugin può eseguire hook e server MCP sul tuo computer. Leggi il pannello dei dettagli prima di installare qualcosa da un marketplace che non conosci.
• Altre app: nella scheda Code dell'app desktop, fai clic su + accanto alla casella del prompt e scegli Add plugins. In VS Code, digita /plugins per aprire Manage plugins.
• Plugin di claude.ai: i plugin attivati sul tuo account claude.ai si sincronizzano nelle sessioni del terminale e compaiono come name@synced. Quelli vanno rimossi su claude.ai.
• Regole aziendali: i plugin installati dalla tua organizzazione mostrano l'ambito Managed (gestito) e non puoi rimuoverli tu.

Se non funziona

• L'URL del marketplace viene rifiutato: includi https://. Un semplice gitlab.example.com/group/repo.git viene letto come abbreviazione GitHub e fallisce.
• I comandi non compaiono dopo l'installazione: esegui /reload-plugins. Se il riepilogo diceva The plugin couldn't be loaded, apri la scheda Errors in /plugin per vedere il motivo.
• "/plugin isn't available in this environment": sei in un'esecuzione non interattiva come claude -p. Usa invece i comandi di shell claude plugin.
• Manca il plugin di progetto di un collega: è attivato nel repository ma non installato sul suo computer; deve eseguire il comando di installazione con --scope project.

Tieni traccia di ciò che ogni sessione lascia in sospeso

Se lavori su molte sessioni di Claude Code, il plugin Workbranch per Claude Code si installa come qualsiasi altro plugin. Di' "save this to Workbranch" (salva questo su Workbranch) e Claude archivia i compiti, le decisioni e le domande aperte della sessione in un progetto, e quando avvii una sessione in una cartella collegata a quel progetto, mostra cosa è ancora aperto. I dettagli sono nella pagina Workbranch per Claude.

Fonti

• Claude Code user FAQ (Claude Help Center, verificato il 30 ottobre 2026)
• Install and manage plugins (Claude Code Docs, verificato il 30 ottobre 2026)

Domande frequenti