Vai al contenuto principale
Per le specifiche tecniche complete e gli schemi, vedi Riferimento Plugin. Per la gestione del marketplace, vedi Marketplace di 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 pre-costruiti, agenti, hook, Skills e server MCP, oppure crea i tuoi per automatizzare i tuoi flussi di lavoro.

​
Guida rapida

Creiamo un semplice plugin di saluto per familiarizzarti 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 manifest del plugin

Create .claude-plugin/plugin.json
mkdir .claude-plugin
cat > .claude-plugin/plugin.json << 'EOF'
{
"name": "my-first-plugin",
"description": "A simple greeting plugin to learn the basics",
"version": "1.0.0",
"author": {
"name": "Your Name"
}
}
EOF
4

Aggiungi un comando personalizzato

Create commands/hello.md
mkdir commands
cat > commands/hello.md << 'EOF'
---
description: Greet the user with a personalized message
---

# Hello Command

Greet the user warmly and ask how you can help them today. Make the greeting personal and encouraging.
EOF
5

Crea il manifest del marketplace

Create marketplace.json
cd ..
mkdir .claude-plugin
cat > .claude-plugin/marketplace.json << 'EOF'
{
"name": "test-marketplace",
"owner": {
"name": "Test User"
},
"plugins": [
{
  "name": "my-first-plugin",
  "source": "./my-first-plugin",
  "description": "My first test plugin"
}
]
}
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 “Install now”. 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:
  • Manifest 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          # Plugin metadata
├── commands/                 # Custom slash commands (optional)
│   └── hello.md
├── agents/                   # Custom agents (optional)
│   └── helper.md
├── skills/                   # Agent Skills (optional)
│   └── my-skill/
│       └── SKILL.md
└── hooks/                    # Event handlers (optional)
    └── hooks.json
Componenti aggiuntivi che puoi aggiungere:
  • Comandi: Crea file markdown nella directory commands/
  • Agenti: Crea definizioni di agenti nella directory agents/
  • Skills: Crea file SKILL.md nella directory skills/
  • 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

Scopri come trovare, 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 di plugin.

​
Installa i plugin

​
Tramite menu interattivo (consigliato per la scoperta)

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

​
Tramite comandi diretti (per l’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 → “Manage Plugins” 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 le istruzioni complete inclusi esempi di configurazione, configurazione del marketplace e best practice di implementazione, vedi Configura marketplace del team.

​
Sviluppa plugin più complessi

Una volta che hai familiarità con i plugin di base, puoi creare estensioni più sofisticate.

​
Aggiungi Skills al tuo plugin

I plugin possono includere Agent Skills per estendere le capacità di Claude. Le Skills sono invocate dal modello—Claude le utilizza autonomamente in base al contesto dell’attività. Per aggiungere Skills al tuo plugin, crea una directory skills/ nella radice del tuo plugin e aggiungi cartelle Skill con file SKILL.md. Le Skills del plugin sono automaticamente disponibili quando il plugin è installato. Per la guida completa alla creazione di Skills, vedi Agent Skills.

​
Organizza plugin complessi

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

​
Testa i tuoi plugin localmente

Quando sviluppi plugin, usa un marketplace locale per testare i cambiamenti in modo iterativo. Questo flusso di lavoro si basa sul modello 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  (you'll create this)
└── my-plugin/                        (your plugin under development)
    ├── .claude-plugin/plugin.json
    ├── commands/
    ├── agents/
    └── hooks/
2

Crea il manifest del marketplace

Create marketplace.json
mkdir .claude-plugin
cat > .claude-plugin/marketplace.json << 'EOF'
{
"name": "dev-marketplace",
"owner": {
"name": "Developer"
},
"plugins": [
{
  "name": "my-plugin",
  "source": "./my-plugin",
  "description": "Plugin under development"
}
]
}
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 perfezionamenti il tuo plugin.
Per più plugin: Organizza i plugin in sottodirectory come ./plugins/plugin-name e aggiorna il tuo marketplace.json di conseguenza. Vedi Plugin sources per i modelli di organizzazione.

​
Esegui il debug dei problemi del plugin

Se il tuo plugin non funziona come previsto:
  1. Controlla la struttura: Assicurati che le tue directory siano nella 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 Debugging and development tools per i comandi CLI e le 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 versionamento semantico nel tuo plugin.json
  3. Crea o usa un marketplace: Distribuisci attraverso i 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 le specifiche tecniche complete, le tecniche di debug e le 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 i plugin: Sfoglia i marketplace della comunità per trovare strumenti utili
  • Adozione del team: Configura plugin a livello di repository per i tuoi progetti
  • Gestione del marketplace: Impara a gestire più fonti di plugin
  • Utilizzo avanzato: Esplora combinazioni e flussi di lavoro di plugin

​
Per gli sviluppatori di plugin

  • Crea il tuo primo marketplace: Guida ai marketplace di plugin
  • Componenti avanzati: Approfondisci componenti specifici del plugin:
    • Comandi slash - Dettagli dello sviluppo dei comandi
    • Subagenti - Configurazione e capacità degli agenti
    • Agent Skills - Estendi le capacità di Claude
    • Hook - Gestione degli eventi e automazione
    • MCP - Integrazione di strumenti esterni
  • Strategie di distribuzione: Pacchetto e condividi i tuoi plugin in modo efficace
  • Contributo della comunità: Considera di contribuire alle raccolte di plugin della comunità

​
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 i flussi di lavoro dei plugin in modo efficace

​
Vedi anche

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