discover-plugins.md +0 −651 deleted
File Deleted View Diff
1> ## Documentation Index
2> Fetch the complete documentation index at: https://code.claude.com/docs/llms.txt
3> Use this file to discover all available pages before exploring further.
4
5# Scopri e installa plugin precostruiti tramite marketplace
6
7> Trova e installa plugin dai marketplace per estendere Claude Code con nuove skills, agenti e funzionalità.
8
9I plugin estendono Claude Code con skills, agenti, hooks e MCP servers. I marketplace dei plugin sono cataloghi che vi aiutano a scoprire e installare queste estensioni senza doverle costruire da soli.
10
11Potete anche abilitare i plugin su claude.ai, per voi stessi o tramite la vostra organizzazione. Claude Code sincronizza quelli nelle vostre sessioni senza un'installazione da marketplace, come [Plugin sincronizzati da claude.ai](/docs/it/plugins-reference#synced-plugins) descrive.
12
13Cercate di creare e distribuire il vostro marketplace? Consultate [Creare e distribuire un marketplace di plugin](/docs/it/plugin-marketplaces).
14
15<h2 id="how-marketplaces-work">
16 Come funzionano i marketplace
17</h2>
18
19Un marketplace è un catalogo di plugin che qualcun altro ha creato e condiviso. Utilizzare un marketplace è un processo in due fasi:
20
21<Steps>
22 <Step title="Aggiungere il marketplace">
23 Questo registra il catalogo con Claude Code in modo che possiate sfogliare ciò che è disponibile. Nessun plugin viene installato ancora.
24 </Step>
25
26 <Step title="Installare singoli plugin">
27 Sfogliate il catalogo e installate i plugin che desiderate.
28 </Step>
29</Steps>
30
31<h2 id="official-anthropic-marketplace">
32 Marketplace ufficiale Anthropic
33</h2>
34
35Il marketplace ufficiale Anthropic (`claude-plugins-official`) viene aggiunto automaticamente da Claude Code la prima volta che lo avviate in modo interattivo. Se Claude Code non riesce ad aggiungerlo, ad esempio perché la vostra rete blocca il download o una [politica del marketplace](/docs/it/plugin-marketplaces#managed-marketplace-restrictions) ha bloccato un tentativo precedente, aggiungetelo voi stessi con `/plugin marketplace add anthropics/claude-plugins-official`.
36
37Per sfogliare ciò che è disponibile, eseguite `/plugin` e andate alla scheda **Discover**, oppure visualizzate il catalogo su [claude.com/plugins](https://claude.com/plugins).
38
39Per installare un plugin dal marketplace ufficiale, utilizzate `/plugin install <name>@claude-plugins-official`. Ad esempio, per installare l'integrazione GitHub:
40
41```shell theme={null}
42/plugin install github@claude-plugins-official
43```
44
45`/plugin` apre un pannello interattivo nella CLI del terminale. Se Claude risponde che `/plugin` non è disponibile in questo ambiente, installate il plugin in un altro modo:
46
47* **App desktop Claude**: utilizzate il [browser dei plugin](/docs/it/desktop#install-plugins).
48* **Estensione VS Code**: installate dalla [finestra di dialogo **Manage plugins**](/docs/it/vs-code#manage-plugins).
49* **Sessioni cloud**: abilitate il plugin per il vostro account claude.ai in modo che Claude Code lo carichi come [plugin sincronizzato](/docs/it/plugins-reference#synced-plugins).
50
51Se l'installazione non riesce, abbinate il messaggio che Claude Code segnala:
52
53* `Marketplace "claude-plugins-official" not found`: aggiungete il marketplace con `/plugin marketplace add anthropics/claude-plugins-official`, quindi riprovate l'installazione.
54* Il plugin [non è trovato nel marketplace](#install-plugins): controllate il nome del plugin.
55
56<Note>
57 Il marketplace ufficiale è curato da Anthropic e l'inclusione è a discrezione di Anthropic. I moduli di invio in-app aggiungono plugin al [marketplace della comunità](#community-marketplace), non a quello ufficiale. Per distribuire plugin in modo indipendente, [create il vostro marketplace](/docs/it/plugin-marketplaces) e condividetelo con gli utenti.
58</Note>
59
60Il marketplace ufficiale include diverse categorie di plugin:
61
62<h3 id="code-intelligence">
63 Code intelligence
64</h3>
65
66I plugin di code intelligence abilitano lo strumento LSP integrato di Claude Code, dando a Claude la capacità di saltare alle definizioni, trovare riferimenti e vedere errori di tipo immediatamente dopo le modifiche. Questi plugin configurano connessioni [Language Server Protocol](https://microsoft.github.io/language-server-protocol/), la stessa tecnologia che alimenta la code intelligence di VS Code. Nelle [sessioni cloud](/docs/it/claude-code-on-the-web), Claude Code non avvia i language server dei plugin, quindi Claude non ottiene lo strumento LSP lì.
67
68Installate il binario del language server dalla tabella sottostante prima di utilizzare questi plugin; il plugin non lo installa per voi. Se avete già un language server installato, Claude potrebbe chiedervi di installare il plugin corrispondente quando aprite un progetto.
69
70| Linguaggio | Plugin | Binario richiesto |
71| :--------- | :------------------ | :--------------------------- |
72| C/C++ | `clangd-lsp` | `clangd` |
73| C# | `csharp-lsp` | `csharp-ls` |
74| Go | `gopls-lsp` | `gopls` |
75| Java | `jdtls-lsp` | `jdtls` |
76| Kotlin | `kotlin-lsp` | `kotlin-language-server` |
77| Lua | `lua-lsp` | `lua-language-server` |
78| PHP | `php-lsp` | `intelephense` |
79| Python | `pyright-lsp` | `pyright-langserver` |
80| Rust | `rust-analyzer-lsp` | `rust-analyzer` |
81| Swift | `swift-lsp` | `sourcekit-lsp` |
82| TypeScript | `typescript-lsp` | `typescript-language-server` |
83
84Potete anche [creare il vostro plugin LSP](/docs/it/plugins-reference#lsp-servers) per altri linguaggi.
85
86<Note>
87 Se vedete `Executable not found in $PATH` nella scheda `/plugin` Errors dopo aver installato un plugin, installate il binario che la tabella [code intelligence](#code-intelligence) elenca per quel plugin.
88</Note>
89
90<h4 id="what-claude-gains-from-code-intelligence-plugins">
91 Cosa Claude guadagna dai plugin di code intelligence
92</h4>
93
94Una volta che un plugin di code intelligence è installato e il suo binario del language server è disponibile, Claude guadagna due capacità:
95
96* **Diagnostica automatica**: dopo ogni modifica di file che Claude fa, il language server segnala errori e avvisi, quindi Claude vede errori di tipo, import mancanti e problemi di sintassi senza eseguire un compilatore o linter. Se Claude introduce un errore, lo nota e lo corregge nello stesso turno.
97* **Navigazione del codice**: Claude può utilizzare il language server per saltare alle definizioni, trovare riferimenti, ottenere informazioni sul tipo al passaggio del mouse, elencare simboli, trovare implementazioni e tracciare gerarchie di chiamate. Queste operazioni danno a Claude una navigazione più precisa rispetto alla ricerca basata su grep, anche se la disponibilità può variare a seconda del linguaggio e dell'ambiente.
98
99Non è necessario configurare la diagnostica oltre all'installazione del plugin. Per leggerla voi stessi, premete **Ctrl+O** quando Claude Code mostra un indicatore come **Found 3 new diagnostic issues in 2 files**.
100
101Se riscontrate problemi, consultate [Risoluzione dei problemi di code intelligence](#code-intelligence-issues).
102
103<h3 id="external-integrations">
104 Integrazioni esterne
105</h3>
106
107Questi plugin raggruppano [MCP servers](/docs/it/mcp) preconfigurati in modo che possiate connettere Claude a servizi esterni senza configurazione manuale:
108
109* **Controllo del codice sorgente**: `github`, `gitlab`
110* **Gestione dei progetti**: `atlassian` (Jira/Confluence), `asana`, `linear`, `notion`
111* **Design**: `figma`
112* **Infrastruttura**: `vercel`, `firebase`, `supabase`
113* **Comunicazione**: `slack`
114* **Monitoraggio**: `sentry`
115
116<h3 id="automatic-security-review">
117 Revisione automatica della sicurezza
118</h3>
119
120Il plugin `security-guidance` esamina ogni modifica che Claude fa per individuare vulnerabilità comuni e istruisce Claude a correggere ciò che trova nella stessa sessione. Consultate [Rilevare problemi di sicurezza mentre Claude scrive il codice](/docs/it/security-guidance) per vedere cosa controlla e come aggiungere regole specifiche del progetto.
121
122<h3 id="development-workflows">
123 Flussi di lavoro di sviluppo
124</h3>
125
126Plugin che aggiungono skills e agenti per attività di sviluppo comuni:
127
128* **commit-commands**: Flussi di lavoro di commit Git inclusi commit, push e creazione di PR
129* **pr-review-toolkit**: Agenti specializzati per la revisione delle pull request
130* **agent-sdk-dev**: Strumenti per la costruzione con Claude Agent SDK
131* **plugin-dev**: Toolkit per la creazione dei vostri plugin
132
133<h3 id="output-styles">
134 Stili di output
135</h3>
136
137Personalizzate come Claude risponde:
138
139* **explanatory-output-style**: Approfondimenti educativi sulle scelte di implementazione
140* **learning-output-style**: Modalità di apprendimento interattivo per la costruzione di competenze
141
142<h2 id="community-marketplace">
143 Marketplace della comunità
144</h2>
145
146Il marketplace della comunità su [`anthropics/claude-plugins-community`](https://github.com/anthropics/claude-plugins-community) ospita plugin di terze parti che hanno superato la convalida automatica e lo screening di sicurezza di Anthropic. Ogni plugin è fissato a uno specifico commit SHA nel catalogo. A differenza del marketplace ufficiale, lo aggiungete manualmente:
147
148```shell theme={null}
149/plugin marketplace add anthropics/claude-plugins-community
150```
151
152Quindi installate i plugin da esso utilizzando il nome del marketplace `claude-community`:
153
154```shell theme={null}
155/plugin install <plugin-name>@claude-community
156```
157
158Per inviare il vostro plugin al marketplace della comunità, consultate [Inviare il vostro plugin al marketplace della comunità](/docs/it/plugins#submit-your-plugin-to-the-community-marketplace) nella guida di creazione dei plugin.
159
160<h2 id="try-it-add-the-demo-marketplace">
161 Provate: aggiungere il marketplace demo
162</h2>
163
164Anthropic mantiene anche un [marketplace di plugin demo](https://github.com/anthropics/claude-code/tree/main/plugins) (`claude-code-plugins`) con plugin di esempio che mostrano cosa è possibile con il sistema di plugin. A differenza del marketplace ufficiale, dovete aggiungere questo manualmente.
165
166<Steps>
167 <Step title="Aggiungere il marketplace">
168 Da Claude Code, eseguite il comando `plugin marketplace add` per il marketplace `anthropics/claude-code`:
169
170 ```shell theme={null}
171 /plugin marketplace add anthropics/claude-code
172 ```
173
174 Questo scarica il catalogo del marketplace e rende i suoi plugin disponibili per voi.
175 </Step>
176
177 <Step title="Sfogliare i plugin disponibili">
178 Eseguite `/plugin` per aprire il gestore dei plugin. Questo apre un'interfaccia a schede che potete scorrere utilizzando **Tab**, o **Shift+Tab** per andare indietro:
179
180 * **Discover**: sfogliate i plugin disponibili da tutti i vostri marketplace
181 * **Installed**: visualizzate e gestite i vostri plugin installati
182 * **Marketplaces**: aggiungete, rimuovete o aggiornate i vostri marketplace aggiunti
183 * **Errors**: visualizzate eventuali errori di caricamento dei plugin
184 * **Stats**: consultate [quanto costa ogni vostra skill in contesto e con quale frequenza viene utilizzata](/docs/it/skills#find-unused-skills), nelle sessioni in cui `/skill-doctor` è disponibile
185
186 Andate alla scheda **Discover** per vedere i plugin dal marketplace che avete appena aggiunto. Quando l'amministratore ha inserito il marketplace nella lista consentita tramite l'impostazione gestita [`pluginSuggestionMarketplaces`](/docs/it/settings-reference#pluginsuggestionmarketplaces), i plugin contrassegnati come rilevanti per la vostra directory di lavoro corrente sono fissati in alto con un'etichetta **suggested for this directory**.
187 </Step>
188
189 <Step title="Installare un plugin">
190 Selezionate un plugin per visualizzare i suoi dettagli. Il riquadro dei dettagli mostra cosa contiene il plugin e quanto costa:
191
192 * Una stima di **Context cost** in modo da poter vedere quanti token il plugin aggiungerà alla vostra [finestra di contesto](/docs/it/features-overview#understand-context-costs) ad ogni turno
193 * La data di **Last updated** del plugin
194 * Una sezione **Will install** che elenca i comandi, gli agenti, le skills, gli hook e i server MCP e LSP del plugin, in modo che possiate rivedere esattamente cosa aggiunge prima di installare
195
196 Non tutti i plugin forniscono i dati dietro questi campi. Per i plugin da marketplace locali o personalizzati, potreste non vedere le righe **Context cost** e **Last updated**, e la sezione **Will install** potrebbe mostrare **Components will be discovered at installation** invece.
197
198 Scegliete un ambito di installazione:
199
200 * **User scope**: installate per voi stessi in tutti i progetti
201 * **Project scope**: installate per tutti i collaboratori su questo repository
202 * **Local scope**: installate per voi stessi solo in questo repository
203
204 Ad esempio, selezionate **commit-commands**, un plugin che aggiunge skills di flusso di lavoro git, e installatelo nel vostro ambito utente.
205
206 Potete anche avviare l'installazione dalla riga di comando:
207
208 ```shell theme={null}
209 /plugin install commit-commands@claude-code-plugins
210 ```
211
212 Consultate [File di impostazioni](/docs/it/settings#where-settings-live) per saperne di più sugli ambiti.
213 </Step>
214
215 <Step title="Utilizzare il vostro nuovo plugin">
216 Se il riepilogo dell'installazione riporta `Run /reload-plugins to activate.`, Claude Code esegue quindi quel ricaricamento per voi. Se il ricaricamento avverte che il vostro prossimo messaggio rileggerebbe la conversazione, eseguite `/reload-plugins --force` per attivare il plugin.
217
218 Le skills dei plugin sono nello spazio dei nomi del nome del plugin, quindi **commit-commands** fornisce skills come `/commit-commands:commit`.
219
220 Provate eseguendo una modifica a un file e eseguendo:
221
222 ```shell theme={null}
223 /commit-commands:commit
224 ```
225
226 Questo mette in stage le vostre modifiche, genera un messaggio di commit e crea il commit.
227
228 Ogni plugin funziona diversamente. Controllate i dettagli del plugin nella scheda **Discover** per vedere i comandi e le skills che fornisce, oppure visitate la sua homepage per indicazioni sull'utilizzo.
229 </Step>
230</Steps>
231
232<h2 id="add-marketplaces">
233 Aggiungere marketplace
234</h2>
235
236Utilizzate il comando `/plugin marketplace add` per aggiungere marketplace da diverse fonti.
237
238<Tip>
239 **Scorciatoie**: Potete utilizzare `/plugin market` invece di `/plugin marketplace` e `rm` invece di `remove`.
240</Tip>
241
242* **Repository GitHub**: formato `owner/repo`, ad esempio `anthropics/claude-code`
243* **URL Git**: qualsiasi URL di repository git, inclusi GitLab, Bitbucket e server self-hosted
244* **Percorsi locali**: directory o percorsi diretti ai file `marketplace.json`
245* **URL remoti**: URL diretti ai file `marketplace.json` ospitati
246* **claude.ai**: marketplace ospitati su claude.ai per il vostro account, come la libreria di plugin della vostra organizzazione, che [aggiungete per nome dalla scheda **Marketplaces** o dalla vostra shell](#add-from-claude-ai) piuttosto che per fonte
247
248<h3 id="add-from-github">
249 Aggiungere da GitHub
250</h3>
251
252Aggiungete un repository GitHub che contiene un file `.claude-plugin/marketplace.json` utilizzando il formato `owner/repo`, dove `owner` è il nome utente GitHub o l'organizzazione e `repo` è il nome del repository.
253
254Ad esempio, `anthropics/claude-code` si riferisce al repository `claude-code` di proprietà di `anthropics`:
255
256```shell theme={null}
257/plugin marketplace add anthropics/claude-code
258```
259
260<h3 id="add-from-other-git-hosts">
261 Aggiungere da altri host Git
262</h3>
263
264Aggiungete un repository git marketplace fornendo l'URL completo. Per un URL `https://`, se includere il suffisso `.git` dipende dall'host:
265
266* **`github.com` e `gitlab.com`**: Claude Code riconosce un URL di repository con o senza il suffisso `.git` e lo clona. L'aggiunta di un URL `gitlab.com` senza il suffisso richiede Claude Code v2.1.232 o versioni successive. Prima della v2.1.232, Claude Code lo trattava come un collegamento diretto a un file `marketplace.json` ospitato.
267* **Azure DevOps**: omettete il suffisso. Claude Code clona qualsiasi URL il cui percorso contiene `/_git/`. Se aggiungete `.git` a un percorso `/_git/`, il clone fallisce.
268* **Ogni altro host, inclusi server GitLab auto-gestiti**: includete il suffisso `.git` in modo che Claude Code cloni il repository piuttosto che trattare l'URL come un collegamento diretto a un file `marketplace.json` ospitato. Per un host i cui URL di clone non portano il suffisso, come AWS CodeCommit, aggiungete il marketplace come voce git in [`extraKnownMarketplaces`](/docs/it/settings-reference#extraknownmarketplaces). Claude Code clona una voce git indipendentemente dal fatto che il suo URL termini con `.git`.
269
270Claude Code clona anche un URL `gitlab.com` con sottogruppi annidati, come `https://gitlab.com/group/subgroup/project`.
271
272Includete il prefisso `https://`. Claude Code v2.1.196 e versioni successive rifiutano un host digitato senza di esso, come `gitlab.com/company/plugins.git`, come una scorciatoia GitHub `owner/repo` non valida, e l'errore vi dice di aggiungere il prefisso. Le versioni precedenti lo leggono male come un percorso di repository GitHub e falliscono al momento del clone.
273
274Utilizzando HTTPS:
275
276```shell theme={null}
277/plugin marketplace add https://gitlab.com/company/plugins.git
278```
279
280Utilizzando SSH:
281
282```shell theme={null}
283/plugin marketplace add git@gitlab.com:company/plugins.git
284```
285
286Claude Code clona un indirizzo SSH indipendentemente dal fatto che termini con `.git`.
287
288Per aggiungere un branch o tag specifico, aggiungete `#` seguito dal ref:
289
290```shell theme={null}
291/plugin marketplace add https://gitlab.com/company/plugins.git#v1.0.0
292```
293
294<h3 id="add-from-local-paths">
295 Aggiungere da percorsi locali
296</h3>
297
298Aggiungete una directory locale che contiene un file `.claude-plugin/marketplace.json`:
299
300```shell theme={null}
301/plugin marketplace add ./my-marketplace
302```
303
304Potete anche aggiungere un percorso diretto a un file `marketplace.json`:
305
306```shell theme={null}
307/plugin marketplace add ./path/to/marketplace.json
308```
309
310<h3 id="add-from-remote-urls">
311 Aggiungere da URL remoti
312</h3>
313
314Aggiungete un file `marketplace.json` remoto tramite URL:
315
316```shell theme={null}
317/plugin marketplace add https://example.com/marketplace.json
318```
319
320<Note>
321 I marketplace basati su URL hanno alcune limitazioni rispetto ai marketplace basati su Git. Se riscontrate errori durante l'installazione di plugin da un marketplace basato su URL, consultate [Risoluzione dei problemi](/docs/it/plugin-marketplaces#plugins-with-relative-paths-fail-in-url-based-marketplaces).
322</Note>
323
324<h3 id="add-from-claude-ai">
325 Aggiungere da claude.ai
326</h3>
327
328Nelle sessioni di terminal in cui [i plugin si sincronizzano dal vostro account claude.ai](/docs/it/plugins-reference#synced-plugins), claude.ai può anche elencare i marketplace per voi, come la libreria di plugin della vostra organizzazione e i vostri caricamenti su claude.ai. `claude plugin marketplace list` li stampa in una sezione `From claude.ai:`, e la scheda **Marketplaces** di `/plugin` li elenca. Selezionatene uno lì per aggiungerlo. L'aggiunta di un marketplace da claude.ai richiede Claude Code v2.1.273 o versioni successive.
329
330Per aggiungerne uno dalla vostra shell, eseguite `claude plugin marketplace add` con il flag `--claudeai` e il nome mostrato nell'elenco:
331
332```bash theme={null}
333claude plugin marketplace add --claudeai claudeai-organization-library
334```
335
336Claude Code registra il marketplace con un nome locale che inizia con `claudeai-`, derivato dal nome con cui claude.ai lo elenca: un marketplace elencato come "Organization library" si registra come `claudeai-organization-library`. Installate i suoi plugin con quel nome, ad esempio con `claude plugin install <plugin>@claudeai-organization-library`.
337
338Se vi disconnettete o vi connettete con un account diverso, il marketplace rimane configurato ma non mostra plugin, e i plugin che avete già installato da esso continuano a caricarsi.
339
340La sezione `From claude.ai:` può anche elencare marketplace basati su git condivisi tramite claude.ai. Li aggiungete con il comando ordinario `marketplace add`, utilizzando la fonte che l'elenco stampa.
341
342<h2 id="install-plugins">
343 Installare plugin
344</h2>
345
346Una volta aggiunti i marketplace, potete installare un plugin per nome. Per un marketplace che non avete ancora aggiunto, potete invece [aggiungerlo e installare in un unico comando](#add-a-marketplace-and-install-in-one-command).
347
348Per installare per nome:
349
350```shell theme={null}
351/plugin install plugin-name@marketplace-name
352```
353
354Il comando apre i dettagli di quel plugin, dove scegliete un [ambito di installazione](/docs/it/settings#where-settings-live). Vedrete le stesse scelte quando eseguite `/plugin`, andate alla scheda **Discover** e premete **Enter** su un plugin:
355
356* **User scope**: installate per voi stessi in tutti i progetti
357* **Project scope**: installate per tutti i collaboratori su questo repository, che aggiunge il plugin a `.claude/settings.json`
358* **Local scope**: installate per voi stessi solo in questo repository, non condiviso con i collaboratori
359
360Per installare senza un passaggio interattivo, utilizzate il comando shell [`claude plugin install`](/docs/it/plugins-reference#plugin-install), che installa nell'ambito utente a meno che non passiate `--scope`. Per un plugin con una [fonte `command`](/docs/it/plugin-marketplaces#how-users-accept-the-command), passate `--yes` per accettare il comando che visualizza.
361
362Potete anche vedere plugin con ambito **managed**. Questi sono installati dagli amministratori tramite [impostazioni gestite](/docs/it/managed-settings) e non possono essere modificati.
363
364Claude Code cerca il plugin nella sua copia locale del catalogo del marketplace. Il modo in cui nominate il plugin controlla se Claude Code aggiorna prima quella copia:
365
366* **Con un nome di marketplace**: quando installate `plugin-name@marketplace-name`, in una sessione o con `claude plugin install`, Claude Code aggiorna quel marketplace prima della ricerca. Claude Code esegue l'aggiornamento anche se avete disattivato [l'aggiornamento automatico](#configure-auto-updates) per il marketplace o impostato `DISABLE_AUTOUPDATER`. Prima della v2.1.232, Claude Code non aggiornava il marketplace prima della ricerca. Claude Code salta questo aggiornamento quando:
367 * Il marketplace non è stato [aggiunto da GitHub, un altro host Git, un URL remoto](#add-marketplaces), o [claude.ai](#add-from-claude-ai).
368 * Una [directory seed](/docs/it/plugin-marketplaces#pre-populate-plugins-for-containers) fornisce il marketplace.
369 * Claude Code ha aggiornato il marketplace negli ultimi 30 secondi.
370 * Avete impostato [`CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC`](/docs/it/env-vars).
371 * [Le impostazioni gestite](/docs/it/plugin-marketplaces#managed-marketplace-restrictions) bloccano il marketplace, nel qual caso Claude Code rifiuta anche l'installazione.
372* **Solo nome del plugin**: quando eseguite `/plugin install plugin-name` in una sessione, Claude Code aggiorna solo i marketplace che [aggiorna anche in background](#configure-auto-updates), e solo dopo che la ricerca non ha avuto successo. Quando eseguite `claude plugin install plugin-name`, Claude Code legge i cataloghi memorizzati nella cache senza aggiornare. Per installare un plugin pubblicato dopo il vostro ultimo aggiornamento, eseguite `/plugin marketplace update <marketplace-name>` in una sessione o [`claude plugin marketplace update <marketplace-name>`](/docs/it/plugin-marketplaces#plugin-marketplace-update) nella vostra shell, quindi riprovate l'installazione.
373
374Se l'aggiornamento prima di un'installazione denominata non riesce, ad esempio perché siete offline, Claude Code cerca il plugin nel catalogo memorizzato nella cache comunque. `claude plugin install` segnala `marketplace not refreshed` nel suo messaggio di successo, e `/plugin install` mostra l'errore sopra i dettagli del plugin o nel suo messaggio di non trovato.
375
376Quando installate dall'interfaccia `/plugin`, il riepilogo dell'installazione vi dice se il plugin è attivo nella vostra sessione corrente:
377
378* `Plugin is now active.`: Claude Code ha attivato il plugin come parte dell'installazione.
379* `Run /reload-plugins to activate.`: il plugin non è ancora attivo, perché attivarlo [invaliderebbe la cache del prompt](/docs/it/prompt-caching#enabling-or-disabling-a-plugin) o perché il tentativo di attivazione non è riuscito. Claude Code quindi esegue `/reload-plugins` per voi. Se quel ricaricamento avverte sulla cache del prompt, eseguite `/reload-plugins --force` per [attivare il plugin comunque](#apply-plugin-changes-without-restarting).
380* Se il plugin non riesce a caricarsi, il riepilogo segnala l'errore e la scheda **Errors** di `/plugin` mostra il dettaglio.
381
382Prima della v2.1.221, nessuna installazione aveva effetto nella sessione corrente finché non eseguivate `/reload-plugins` o riavviavate.
383
384Il comando shell `claude plugin install` non viene eseguito in una sessione, quindi Claude Code carica i plugin che installa la prossima volta che avviate Claude Code, o quando eseguite `/reload-plugins` in una sessione già aperta.
385
386<Warning>
387 Assicuratevi di fidarvi di un plugin prima di installarlo. Anthropic non controlla quali MCP server, file o altro software sono inclusi nei plugin e non può verificare che funzionino come previsto. Controllate la homepage di ogni plugin per ulteriori informazioni.
388</Warning>
389
390<h3 id="add-a-marketplace-and-install-in-one-command">
391 Aggiungere un marketplace e installare in un unico comando
392</h3>
393
394Per installare un plugin da un marketplace che non avete ancora aggiunto, nominate la fonte del marketplace con `--marketplace`. Richiede Claude Code v2.1.275 o successivo.
395
396```shell theme={null}
397/plugin install quality-review-plugin --marketplace your-org/plugins
398```
399
400La fonte assume [le stesse forme di `/plugin marketplace add`](#add-marketplaces), come GitHub `owner/repo`, un URL git o un percorso locale, tranne che non può contenere spazi. Fornite il nome del plugin senza un suffisso `@marketplace`.
401
402Claude Code mostra la fonte che ha risolto e vi chiede di confermare prima di aggiungere il marketplace. Rifiutare annulla l'installazione e non aggiunge nulla. Una volta aggiunto il marketplace, i dettagli del plugin si aprono e scegliete un [ambito di installazione](/docs/it/settings#where-settings-live). Se la fonte corrisponde a un marketplace che avete già aggiunto, Claude Code salta la conferma e apre i dettagli del plugin in quel marketplace.
403
404<h2 id="manage-installed-plugins">
405 Gestire i plugin installati
406</h2>
407
408Eseguite `/plugin` e andate alla scheda **Installed** per visualizzare, abilitare, disabilitare o disinstallare i vostri plugin. L'elenco è raggruppato per ambito e ordinato in modo che vediate prima i problemi: i plugin con errori di caricamento o dipendenze non risolte appaiono in alto, seguiti dai vostri preferiti, con i plugin disabilitati ripiegati dietro un'intestazione compressa in fondo.
409
410Dall'elenco potete:
411
412* premere `f` per contrassegnare come preferito o rimuovere il contrassegno dal plugin selezionato
413* digitare per filtrare per nome o descrizione del plugin
414* premere Enter per aprire la vista dettagli di un plugin e abilitare, disabilitare o disinstallarlo
415
416Claude Code elenca anche i [plugin sincronizzati dal vostro account claude.ai](/docs/it/plugins-reference#synced-plugins) nella scheda **Installed**, con `synced` come loro fonte. Potete abilitare o disabilitare uno lì a meno che la vostra organizzazione non lo abbia contrassegnato come obbligatorio. Per rimuoverne uno, disattivatelo su claude.ai. I plugin sincronizzati appaiono nelle sessioni di terminale su Claude Code v2.1.273 o versioni successive.
417
418Quando disinstallate un plugin che il `.claude/settings.json` di un progetto abilita, Claude Code chiede quale ambito intendete: disabilitarlo solo per voi, il che scrive un override nel vostro `.claude/settings.local.json` e lascia il plugin installato per il progetto, oppure disinstallarlo per tutti, il che lo rimuove dal `.claude/settings.json` condiviso.
419
420La vista dettagli mostra i componenti che il plugin contribuisce: comandi, skills, agenti, hooks, server MCP e server LSP. Lo stesso inventario è disponibile dalla riga di comando con `claude plugin details`.
421
422Claude Code elenca anche i plugin del marketplace che avete installato voi stessi ma non avete utilizzato negli ultimi due settimane, in un arco di almeno 10 sessioni, sotto un'intestazione **Not used recently** nella scheda **Installed**. La vista dettagli mostra una riga **Last used** per ogni plugin. Utilizzate questi elementi per trovare i plugin che aggiungono ancora costi di avvio e contesto anche se non li utilizzate più, quindi disabilitateli o disinstallateli.
423
424Due tipi di plugin non vengono mai elencati come inutilizzati:
425
426* plugin che la vostra organizzazione gestisce o che caricate con `--plugin-dir`
427* plugin che contribuiscono un tema, uno stile di output, un monitor o un workflow, poiché forniscono valore senza un'invocazione da tracciare
428
429L'intestazione **Not used recently** e la riga **Last used** sono entrambe nascoste quando la vostra organizzazione limita i marketplace con [`strictKnownMarketplaces`](/docs/it/settings-reference#strictknownmarketplaces).
430
431Un [language server](/docs/it/plugins#add-lsp-servers-to-your-plugin) di un plugin conta come utilizzato quando fornisce diagnostica o risponde a una richiesta di navigazione del codice, quindi un plugin LSP il cui server è attivo nelle vostre sessioni non viene elencato come inutilizzato. Prima di v2.1.203, l'attività del language server non poteva essere conteggiata come utilizzo, quindi i plugin che contribuiscono un server LSP erano esenti dal gruppo interamente, allo stesso modo in cui i plugin di tema e stile di output lo sono ancora.
432
433La prima sessione su una versione che conta l'attività del language server reimposta anche il record di utilizzo di ogni plugin LSP che non aveva ancora registrato alcun utilizzo, quindi Claude Code non giudica un plugin che avete installato in precedenza come inutilizzato in base ai dati registrati prima che l'attività del suo server fosse tracciata.
434
435Quando installate un plugin che dichiara dipendenze, l'output dell'installazione elenca quali dipendenze sono state installate automaticamente insieme ad esso.
436
437Potete anche gestire i plugin con comandi diretti:
438
439* Quando eseguite `/plugin disable`, `/plugin enable` o `/plugin uninstall`, Claude Code apre il pannello dei plugin per applicare la modifica e lo lascia aperto. Premete **Esc** per chiudere il pannello prima di digitare un altro comando. [Applicare le modifiche dei plugin senza riavviare](#apply-plugin-changes-without-restarting) descrive quando la modifica ha effetto nella vostra sessione.
440* Per gli script, utilizzate invece i comandi shell `claude plugin`, che non aprono il pannello.
441
442Elencate i plugin installati senza aprire il menu:
443
444```shell theme={null}
445/plugin list
446```
447
448Passate `--enabled` o `--disabled` per mostrare solo i plugin in quello stato.
449
450Disabilitate un plugin senza disinstallarlo:
451
452```shell theme={null}
453/plugin disable plugin-name@marketplace-name
454```
455
456Riabilitate un plugin disabilitato:
457
458```shell theme={null}
459/plugin enable plugin-name@marketplace-name
460```
461
462In questi identificatori, `plugin-name` è il `name` del plugin nella [voce del marketplace](/docs/it/plugin-marketplaces#plugin-entries), che può differire dal `name` nel `plugin.json` del plugin stesso.
463
464A partire da Claude Code v2.1.195, **Enable** e **Disable** nell'interfaccia `/plugin` funzionano per i plugin i cui due nomi differiscono, e `/plugin enable` e `/plugin disable` accettano entrambi i nomi. Quando disabilitate un tale plugin in una versione precedente, Claude Code segnala `already disabled` e lo lascia abilitato.
465
466Rimuovete completamente un plugin:
467
468```shell theme={null}
469/plugin uninstall plugin-name@marketplace-name
470```
471
472L'opzione `--scope` vi consente di indirizzare un ambito specifico con comandi CLI:
473
474```shell theme={null}
475claude plugin install formatter@your-org --scope project
476claude plugin uninstall formatter@your-org --scope project
477```
478
479<h3 id="apply-plugin-changes-without-restarting">
480 Applicare le modifiche dei plugin senza riavviare
481</h3>
482
483Quando chiudete il menu `/plugin`, Claude Code esegue `/reload-plugins` per voi per applicare le modifiche che avete apportato, come l'installazione, l'abilitazione, la disabilitazione e la disinstallazione dei plugin. Se il ricaricamento invaliderebbe la [cache del prompt](/docs/it/prompt-caching#enabling-or-disabling-a-plugin), avvisa e lascia le modifiche in sospeso; eseguite `/reload-plugins --force` per applicarle comunque. Se Claude sta ancora rispondendo quando chiudete il menu, il ricaricamento viene eseguito dopo che la risposta è terminata.
484
485Per le modifiche dei plugin che avvengono al di fuori del menu, eseguite `/reload-plugins` voi stessi. Queste modifiche includono:
486
487* Un comando `claude plugin` che avete eseguito in un altro terminale
488* Modifiche a un plugin che avete caricato con [`--plugin-dir`](/docs/it/plugins#test-your-plugins-locally) mentre lo sviluppate
489* Un plugin [aggiornamento automatico](#configure-auto-updates) la cui notifica vi chiede di ricaricare
490* Una [sincronizzazione dal vostro account claude.ai](/docs/it/plugins-reference#synced-plugins) che ha aggiunto, aggiornato o rimosso un plugin e ha mostrato una notifica che vi chiede di ricaricare
491* Una modifica in una cartella [`--plugin-dir`](/docs/it/plugins#test-your-plugins-locally) che Claude Code ha mantenuto perché applicarla invaliderebbe la cache del prompt
492
493Prima di v2.1.268, i plugin che avete abilitato, disabilitato o disinstallato nel menu, e le installazioni che non si sono attivate durante l'installazione, rimanevano in sospeso fino a quando non eseguivate `/reload-plugins`.
494
495`/reload-plugins` viene eseguito anche in sessioni senza un terminale interattivo, come l'app desktop, l'Agent SDK e la [modalità non interattiva](/docs/it/headless) con `-p`. Richiede Claude Code v2.1.260 o versioni successive. Due limiti si applicano in quelle sessioni:
496
497* Il comando viene eseguito solo quando lo digitate direttamente nella sessione, ad esempio nel prompt `-p` o nella casella di prompt dell'app desktop. Quando lo inviate tramite una connessione remota, ad esempio [Remote Control](/docs/it/remote-control) o un messaggio di chat inoltrato, il comando rifiuta senza ricaricare nulla.
498* Il ricaricamento non connette o disconnette i server MCP dei plugin. Quelle modifiche avranno effetto nella vostra prossima sessione.
499
500Claude Code ricarica tutti i plugin attivi e mostra i conteggi per i plugin, le skills, gli agenti, gli hooks, i server MCP dei plugin e i server LSP dei plugin, omettendo il conteggio dei server MCP dei plugin in una sessione senza un terminale interattivo. Nel conteggio delle skills, Claude Code include ogni skill che un plugin fornisce: sia le sue voci `commands/` che le sue skills `SKILL.md`. Prima di v2.1.246, Claude Code conteggiava solo le voci `commands/`, quindi poteva ricaricare le skills `SKILL.md` di un plugin e comunque segnalare `0 skills` nel riepilogo.
501
502Il ricaricamento ha un costo in token sulla richiesta successiva: i componenti appena caricati si annunciano nel contenuto aggiunto alla conversazione, mentre la cronologia esistente continua a leggere dalla cache del prompt. Un plugin che fornisce server MCP costa di più quando i suoi strumenti non sono differiti dalla [ricerca degli strumenti](/docs/it/mcp#scale-with-mcp-tool-search): il cambiamento invalida la cache e la richiesta successiva rilegge l'intera conversazione. Consultate [abilitazione o disabilitazione di un plugin](/docs/it/prompt-caching#enabling-or-disabling-a-plugin) per i dettagli.
503
504<h2 id="manage-marketplaces">
505 Gestire i marketplace
506</h2>
507
508Potete gestire i marketplace tramite l'interfaccia interattiva `/plugin` o con comandi CLI.
509
510<h3 id="use-the-interactive-interface">
511 Utilizzare l'interfaccia interattiva
512</h3>
513
514Eseguite `/plugin` e andate alla scheda **Marketplaces** per:
515
516* Visualizzare tutti i vostri marketplace aggiunti con le loro fonti e stato
517* Aggiungere nuovi marketplace
518* Aggiornare gli elenchi dei marketplace per recuperare i plugin più recenti
519* Rimuovere i marketplace di cui non avete più bisogno
520
521<h3 id="use-cli-commands">
522 Utilizzare comandi CLI
523</h3>
524
525Potete anche gestire i marketplace con comandi diretti.
526
527Elencate tutti i marketplace configurati:
528
529```shell theme={null}
530/plugin marketplace list
531```
532
533Aggiornate gli elenchi dei plugin da un marketplace:
534
535```shell theme={null}
536/plugin marketplace update marketplace-name
537```
538
539Rimuovete un marketplace:
540
541```shell theme={null}
542/plugin marketplace remove marketplace-name
543```
544
545<Warning>
546 La rimozione di un marketplace disinstallerà tutti i plugin che avete installato da esso.
547</Warning>
548
549<h3 id="configure-auto-updates">
550 Configurare gli aggiornamenti automatici
551</h3>
552
553Claude Code può aggiornare automaticamente i marketplace e i loro plugin installati in background dopo l'avvio. Quando l'aggiornamento automatico è abilitato per un marketplace, Claude Code aggiorna i dati del marketplace e aggiorna i plugin installati alle loro versioni più recenti su disco.
554
555Claude Code verifica gli aggiornamenti del marketplace e dei plugin dopo l'avvio della sessione, con un ritardo casuale fino a dieci minuti, quindi la sessione in esecuzione continua a utilizzare le versioni caricate all'avvio. Se sono stati aggiornati plugin, vedrete una notifica che vi chiede di eseguire `/reload-plugins`, oppure le nuove versioni si caricano al prossimo avvio.
556
557L'aggiornamento automatico esclude anche un plugin la cui voce del marketplace dichiara un `headersHelper`: Claude Code [non esegue il comando né scarica l'archivio](/docs/it/plugin-marketplaces#installs-and-updates-that-refuse-the-command-instead-of-asking) su quel percorso; quella sezione dice quando Claude Code elenca il plugin nella scheda Errors di `/plugin` in modo che possiate aggiornarlo dalla sua vista.
558
559Claude Code aggiorna i plugin che hanno una [fonte `command`](/docs/it/plugin-marketplaces#command-sources) secondo una cadenza separata dall'impostazione di aggiornamento automatico del marketplace e da `DISABLE_AUTOUPDATER`. Invece, [riesegue il comando una volta per sessione](/docs/it/plugin-marketplaces#when-claude-code-re-runs-the-command) e installa l'output come nuova versione del plugin quando il suo [hash](/docs/it/plugins-reference#version-management) è cambiato.
560
561Attivate/disattivate l'aggiornamento automatico per singoli marketplace tramite l'interfaccia utente:
562
5631. Eseguite `/plugin` per aprire il gestore dei plugin
5642. Selezionate **Marketplaces**
5653. Scegliete un marketplace dall'elenco
5664. Selezionate **Enable auto-update** o **Disable auto-update**
567
568`claude-plugins-official`, la maggior parte degli altri marketplace ufficiali Anthropic e [marketplace aggiunti da claude.ai](#add-from-claude-ai) hanno l'aggiornamento automatico abilitato per impostazione predefinita. I marketplace di terze parti e di sviluppo locale hanno l'aggiornamento automatico disabilitato per impostazione predefinita.
569
570Gli amministratori possono anche impostare `"autoUpdate": true` su ogni voce [`extraKnownMarketplaces`](/docs/it/settings-reference#extraknownmarketplaces) nelle impostazioni gestite per abilitare l'aggiornamento automatico per un marketplace dell'organizzazione senza richiedere a ogni utente di attivarlo.
571
572Per disabilitare gli aggiornamenti automatici per Claude Code e per i plugin recuperati dai marketplace, impostate la variabile di ambiente `DISABLE_AUTOUPDATER`. I plugin con una [fonte `command`](/docs/it/plugin-marketplaces#command-sources) seguono la loro propria risoluzione una volta per sessione. Consultate [Aggiornamenti automatici](/docs/it/setup#auto-updates) per i dettagli.
573
574Per mantenere gli aggiornamenti automatici dei plugin abilitati mentre disabilitate gli aggiornamenti di Claude Code, impostate `FORCE_AUTOUPDATE_PLUGINS=1` insieme a `DISABLE_AUTOUPDATER`:
575
576```bash theme={null}
577export DISABLE_AUTOUPDATER=1
578export FORCE_AUTOUPDATE_PLUGINS=1
579```
580
581<h2 id="configure-team-marketplaces">
582 Configurare i marketplace del team
583</h2>
584
585Gli amministratori del team possono configurare l'installazione automatica del marketplace per i progetti aggiungendo la configurazione del marketplace a `.claude/settings.json`. Una volta che un membro del team [si fida della cartella del repository](/docs/it/permissions#what-runs-before-you-trust-a-folder), Claude Code aggiunge questi marketplace senza un ulteriore prompt.
586
587A partire da Claude Code v2.1.195, l'aggiunta del marketplace non installa i plugin che provengono da una fonte esterna, su qualsiasi percorso che carica i plugin. Un plugin che solo il file `.claude/settings.json` del progetto abilita, e che proviene da una fonte esterna come un repository GitHub o un pacchetto npm, non si carica fino a quando il membro del team non lo installa. Fino ad allora, Claude Code segnala il plugin come non installato e mostra il comando `claude plugin install` da eseguire.
588
589Aggiungete `extraKnownMarketplaces` al file `.claude/settings.json` del vostro progetto:
590
591```json theme={null}
592{
593 "extraKnownMarketplaces": {
594 "my-team-tools": {
595 "source": {
596 "source": "github",
597 "repo": "your-org/claude-plugins"
598 }
599 }
600 }
601}
602```
603
604Per le opzioni di configurazione complete incluse `extraKnownMarketplaces` e `enabledPlugins`, consultate [Impostazioni dei plugin](/docs/it/settings-reference#plugin-settings).
605
606<h2 id="security">
607 Sicurezza
608</h2>
609
610I plugin e i marketplace sono componenti altamente affidabili che possono eseguire codice arbitrario sulla vostra macchina con i vostri privilegi utente. Installate solo plugin e aggiungete marketplace da fonti di cui vi fidate. Le organizzazioni possono limitare quali marketplace gli utenti sono autorizzati ad aggiungere utilizzando [restrizioni gestite dei marketplace](/docs/it/plugin-marketplaces#managed-marketplace-restrictions).
611
612<h2 id="troubleshooting">
613 Risoluzione dei problemi
614</h2>
615
616<h3 id="/plugin-command-not-recognized">
617 Comando /plugin non riconosciuto
618</h3>
619
620Se vedete "unknown command" o il comando `/plugin` non appare:
621
6221. **Controllate la vostra versione**: Eseguite `claude --version` per vedere cosa è installato.
6232. **Aggiornate Claude Code**:
624 * **Homebrew**: `brew upgrade claude-code`, oppure `brew upgrade claude-code@latest` se avete installato quel cask
625 * **npm**: `npm install -g @anthropic-ai/claude-code@latest`
626 * **Programma di installazione nativo**: Rieseguite il comando di installazione da [Setup](/docs/it/setup)
6273. **Riavviate Claude Code**: dopo l'aggiornamento, riavviate il vostro terminale ed eseguite `claude` di nuovo.
628
629<h3 id="common-issues">
630 Problemi comuni
631</h3>
632
633Se le skill dei plugin non appaiono, cancellate la cache con `rm -rf ~/.claude/plugins/cache`, riavviate Claude Code e reinstallate il plugin.
634
635Per la risoluzione dettagliata dei problemi con soluzioni, consultate [Risoluzione dei problemi](/docs/it/plugin-marketplaces#troubleshooting) nella guida del marketplace. Per gli strumenti di debug, consultate [Strumenti di debug e sviluppo](/docs/it/plugins-reference#debugging-and-development-tools).
636
637<h3 id="code-intelligence-issues">
638 Problemi di code intelligence
639</h3>
640
641* **Language server non avviato**: verificate che il binario sia installato e disponibile nel vostro `$PATH`. Controllate la scheda `/plugin` Errors per i dettagli.
642* **Utilizzo elevato della memoria**: i language server come `rust-analyzer` e `pyright` possono consumare memoria significativa su progetti di grandi dimensioni. Se riscontrate problemi di memoria, disabilitate il plugin con `/plugin disable <plugin-name>` e affidatevi invece agli strumenti di ricerca integrati di Claude.
643* **Diagnostica falsa positiva nei monorepo**: i language server possono segnalare errori di import non risolti per i pacchetti interni se l'area di lavoro non è configurata correttamente. Questi non influiscono sulla capacità di Claude di modificare il codice.
644
645<h2 id="next-steps">
646 Passaggi successivi
647</h2>
648
649* **Costruite i vostri plugin**: Consultate [Plugin](/docs/it/plugins) per creare skills, agenti e hook
650* **Create un marketplace**: Consultate [Creare un marketplace di plugin](/docs/it/plugin-marketplaces) per distribuire plugin al vostro team o comunità
651* **Riferimento tecnico**: Consultate [Riferimento dei plugin](/docs/it/plugins-reference) per le specifiche complete