Per le specifiche tecniche complete e gli schemi, vedi Riferimento plugin. Per la gestione del marketplace, vedi Marketplace dei plugin.
I plugin ti permettono di estendere Claude Code con funzionalità personalizzate che possono essere condivise tra progetti e team. Installa plugin dai marketplace per aggiungere comandi, agenti, hook e server MCP precostruiti, oppure crea i tuoi per automatizzare i tuoi flussi di lavoro.

​
Guida rapida

Creiamo un semplice plugin di saluto per familiarizzare con il sistema di plugin. Costruiremo un plugin funzionante che aggiunge un comando personalizzato, lo testeremo localmente e comprenderemo i concetti fondamentali.

​
Prerequisiti

  • Claude Code installato sulla tua macchina
  • Familiarità di base con gli strumenti da riga di comando

​
Crea il tuo primo plugin

1

Crea la struttura del marketplace

mkdir test-marketplace
cd test-marketplace
2

Crea la directory del plugin

mkdir my-first-plugin
cd my-first-plugin
3

Crea il manifesto del plugin

Create .claude-plugin/plugin.json
mkdir .claude-plugin
cat > .claude-plugin/plugin.json << 'EOF'
{
"name": "my-first-plugin",
"description": "Un semplice plugin di saluto per imparare le basi",
"version": "1.0.0",
"author": {
"name": "Il Tuo Nome"
}
}
EOF
4

Aggiungi un comando personalizzato

Create commands/hello.md
mkdir commands
cat > commands/hello.md << 'EOF'
---
description: Saluta l'utente con un messaggio personalizzato
---

# Comando Hello

Saluta l'utente calorosamente e chiedi come puoi aiutarlo oggi. Rendi il saluto personale e incoraggiante.
EOF
5

Crea il manifesto del marketplace

Create marketplace.json
cd ..
mkdir .claude-plugin
cat > .claude-plugin/marketplace.json << 'EOF'
{
"name": "test-marketplace",
"owner": {
"name": "Utente Test"
},
"plugins": [
{
  "name": "my-first-plugin",
  "source": "./my-first-plugin",
  "description": "Il mio primo plugin di test"
}
]
}
EOF
6

Installa e testa il tuo plugin

Start Claude Code from parent directory
cd ..
claude
Add the test marketplace
/plugin marketplace add ./test-marketplace
Install your plugin
/plugin install my-first-plugin@test-marketplace
Seleziona “Installa ora”. Dovrai quindi riavviare Claude Code per utilizzare il nuovo plugin.
Try your new command
/hello
Vedrai Claude utilizzare il tuo comando di saluto! Controlla /help per vedere il tuo nuovo comando elencato.
Hai creato e testato con successo un plugin con questi componenti chiave:
  • Manifesto del plugin (.claude-plugin/plugin.json) - Descrive i metadati del tuo plugin
  • Directory dei comandi (commands/) - Contiene i tuoi comandi slash personalizzati
  • Marketplace di test - Ti permette di testare il tuo plugin localmente

​
Panoramica della struttura del plugin

Il tuo plugin segue questa struttura di base: 
my-first-plugin/
├── .claude-plugin/
│   └── plugin.json          # Metadati del plugin
├── commands/                 # Comandi slash personalizzati (opzionale)
│   └── hello.md
├── agents/                   # Agenti personalizzati (opzionale)
│   └── helper.md
└── hooks/                    # Gestori di eventi (opzionale)
    └── hooks.json
Componenti aggiuntivi che puoi aggiungere:
  • Comandi: Crea file markdown nella directory commands/
  • Agenti: Crea definizioni di agenti nella directory agents/
  • Hook: Crea hooks/hooks.json per la gestione degli eventi
  • Server MCP: Crea .mcp.json per l’integrazione di strumenti esterni
Prossimi passi: Pronto ad aggiungere più funzionalità? Vai a Sviluppa plugin più complessi per aggiungere agenti, hook e server MCP. Per le specifiche tecniche complete di tutti i componenti del plugin, vedi Riferimento plugin.

​
Installa e gestisci i plugin

Impara come scoprire, installare e gestire i plugin per estendere le capacità di Claude Code.

​
Prerequisiti

  • Claude Code installato e in esecuzione
  • Familiarità di base con le interfacce da riga di comando

​
Aggiungi marketplace

I marketplace sono cataloghi di plugin disponibili. Aggiungili per scoprire e installare plugin:
Add a marketplace
/plugin marketplace add your-org/claude-plugins
Browse available plugins
/plugin
Per la gestione dettagliata del marketplace inclusi repository Git, sviluppo locale e distribuzione del team, vedi Marketplace dei plugin.

​
Installa plugin

​
Tramite menu interattivo (raccomandato per la scoperta)

Open the plugin management interface
/plugin
Seleziona “Sfoglia Plugin” per vedere le opzioni disponibili con descrizioni, funzionalità e opzioni di installazione.

​
Tramite comandi diretti (per installazione rapida)

Install a specific plugin
/plugin install formatter@your-org
Enable a disabled plugin
/plugin enable plugin-name@marketplace-name
Disable without uninstalling
/plugin disable plugin-name@marketplace-name
Completely remove a plugin
/plugin uninstall plugin-name@marketplace-name

​
Verifica l’installazione

Dopo aver installato un plugin:
  1. Controlla i comandi disponibili: Esegui /help per vedere i nuovi comandi
  2. Testa le funzionalità del plugin: Prova i comandi e le funzionalità del plugin
  3. Rivedi i dettagli del plugin: Usa /plugin → “Gestisci Plugin” per vedere cosa fornisce il plugin

​
Configura i flussi di lavoro dei plugin del team

Configura i plugin a livello di repository per garantire strumenti coerenti in tutto il tuo team. Quando i membri del team si fidano della cartella del tuo repository, Claude Code installa automaticamente i marketplace e i plugin specificati. Per configurare i plugin del team:
  1. Aggiungi la configurazione del marketplace e del plugin al .claude/settings.json del tuo repository
  2. I membri del team si fidano della cartella del repository
  3. I plugin si installano automaticamente per tutti i membri del team
Per istruzioni complete inclusi esempi di configurazione, configurazione del marketplace e migliori pratiche di distribuzione, vedi Configura marketplace del team.

​
Sviluppa plugin più complessi

Una volta che ti senti a tuo agio con i plugin di base, puoi creare estensioni più sofisticate.

​
Organizza plugin complessi

Per plugin con molti componenti, organizza la struttura della tua directory per funzionalità. Per layout completi delle directory e pattern di organizzazione, vedi Struttura della directory del plugin.

​
Testa i tuoi plugin localmente

Quando sviluppi plugin, usa un marketplace locale per testare le modifiche in modo iterativo. Questo flusso di lavoro si basa sul pattern della guida rapida e funziona per plugin di qualsiasi complessità.
1

Configura la tua struttura di sviluppo

Organizza il tuo plugin e marketplace per il test:
Create directory structure
mkdir dev-marketplace
cd dev-marketplace
mkdir my-plugin
Questo crea:
dev-marketplace/
├── .claude-plugin/marketplace.json  (lo creerai)
└── my-plugin/                        (il tuo plugin in sviluppo)
    ├── .claude-plugin/plugin.json
    ├── commands/
    ├── agents/
    └── hooks/
2

Crea il manifesto del marketplace

Create marketplace.json
mkdir .claude-plugin
cat > .claude-plugin/marketplace.json << 'EOF'
{
"name": "dev-marketplace",
"owner": {
"name": "Sviluppatore"
},
"plugins": [
{
  "name": "my-plugin",
  "source": "./my-plugin",
  "description": "Plugin in sviluppo"
}
]
}
EOF
3

Installa e testa

Start Claude Code from parent directory
cd ..
claude
Add your development marketplace
/plugin marketplace add ./dev-marketplace
Install your plugin
/plugin install my-plugin@dev-marketplace
Testa i componenti del tuo plugin:
  • Prova i tuoi comandi con /command-name
  • Controlla che gli agenti appaiano in /agents
  • Verifica che gli hook funzionino come previsto
4

Itera sul tuo plugin

Dopo aver apportato modifiche al codice del tuo plugin:
Uninstall the current version
/plugin uninstall my-plugin@dev-marketplace
Reinstall to test changes
/plugin install my-plugin@dev-marketplace
Ripeti questo ciclo mentre sviluppi e perfeziona il tuo plugin.
Per plugin multipli: Organizza i plugin in sottodirectory come ./plugins/plugin-name e aggiorna il tuo marketplace.json di conseguenza. Vedi Sorgenti dei plugin per i pattern di organizzazione.

​
Debug dei problemi del plugin

Se il tuo plugin non funziona come previsto:
  1. Controlla la struttura: Assicurati che le tue directory siano alla radice del plugin, non dentro .claude-plugin/
  2. Testa i componenti individualmente: Controlla ogni comando, agente e hook separatamente
  3. Usa strumenti di validazione e debug: Vedi Strumenti di debug e sviluppo per comandi CLI e tecniche di risoluzione dei problemi

​
Condividi i tuoi plugin

Quando il tuo plugin è pronto per essere condiviso:
  1. Aggiungi documentazione: Includi un README.md con istruzioni di installazione e utilizzo
  2. Versiona il tuo plugin: Usa il versioning semantico nel tuo plugin.json
  3. Crea o usa un marketplace: Distribuisci attraverso marketplace di plugin per un’installazione facile
  4. Testa con altri: Fai testare il plugin ai membri del team prima di una distribuzione più ampia
Per specifiche tecniche complete, tecniche di debug e strategie di distribuzione, vedi Riferimento plugin.

​
Prossimi passi

Ora che comprendi il sistema di plugin di Claude Code, ecco i percorsi suggeriti per diversi obiettivi:

​
Per gli utenti di plugin

  • Scopri plugin: Sfoglia i marketplace della community per strumenti utili
  • Adozione del team: Configura plugin a livello di repository per i tuoi progetti
  • Gestione del marketplace: Impara a gestire più sorgenti di plugin
  • Utilizzo avanzato: Esplora combinazioni e flussi di lavoro dei plugin

​
Per gli sviluppatori di plugin

  • Crea il tuo primo marketplace: Guida ai marketplace dei plugin
  • Componenti avanzati: Approfondisci componenti specifici del plugin:
    • Comandi slash - Dettagli dello sviluppo dei comandi
    • Subagenti - Configurazione e capacità degli agenti
    • Hook - Gestione degli eventi e automazione
    • MCP - Integrazione di strumenti esterni
  • Strategie di distribuzione: Impacchetta e condividi i tuoi plugin efficacemente
  • Contributo alla community: Considera di contribuire alle collezioni di plugin della community

​
Per i responsabili del team e gli amministratori

  • Configurazione del repository: Configura l’installazione automatica dei plugin per i progetti del team
  • Governance dei plugin: Stabilisci linee guida per l’approvazione e la revisione della sicurezza dei plugin
  • Manutenzione del marketplace: Crea e mantieni cataloghi di plugin specifici dell’organizzazione
  • Formazione e documentazione: Aiuta i membri del team ad adottare efficacemente i flussi di lavoro dei plugin

​
Vedi anche

  • Marketplace dei plugin - Creazione e gestione di cataloghi di plugin
  • Comandi slash - Comprensione dei comandi personalizzati
  • Subagenti - Creazione e utilizzo di agenti specializzati
  • Hook - Automazione dei flussi di lavoro con gestori di eventi
  • MCP - Connessione a strumenti e servizi esterni
  • Impostazioni - Opzioni di configurazione per i plugin