201 201
202Un'aggiunta riuscita stampa `Successfully added marketplace: <name>`.202Un'aggiunta riuscita stampa `Successfully added marketplace: <name>`.
203 203
204<h3 id="invalid-git-url">
205 `Invalid git URL`
206</h3>
207
208È stato aggiunto un marketplace, installato un plugin o eseguito un aggiornamento da un indirizzo git e il comando è fallito con `Invalid git URL` nel suo messaggio.
209
210Claude Code controlla ogni indirizzo git prima di eseguire git. Rifiuta un indirizzo il cui protocollo non supporta. Rifiuta anche un indirizzo che git potrebbe leggere come denominazione di un server o cartella diversa da quella che l'indirizzo mostra.
211
212Il testo dopo l'indirizzo nomina cosa cambiare. Riscrivere l'indirizzo come il messaggio dice ed eseguire di nuovo il comando.
213
214Un rifiuto che invece dice `is blocked by enterprise policy` proviene dalle impostazioni dell'organizzazione. Vedere [Marketplace source is blocked by enterprise policy](#marketplace-source-is-blocked-by-enterprise-policy).
215
204<h3 id="path-does-not-exist">216<h3 id="path-does-not-exist">
205 `Path does not exist: <path>`217 `Path does not exist: <path>`
206</h3>218</h3>
410 422
411`claude plugin install` nella shell stampa un messaggio diverso. Per un plugin già installato nello scope di destinazione, stampa `Plugin "<name>@<marketplace>" is already installed (scope: user)` ed esce con 0. Se la sua directory di cache è mancante, lo stesso comando la scarica di nuovo.423`claude plugin install` nella shell stampa un messaggio diverso. Per un plugin già installato nello scope di destinazione, stampa `Plugin "<name>@<marketplace>" is already installed (scope: user)` ed esce con 0. Se la sua directory di cache è mancante, lo stesso comando la scarica di nuovo.
412 424
425<h3 id="plugin-would-share-its-folder">
426 `"<plugin>" was not installed: it would share its folder with "<other>"`
427</h3>
428
429È stato installato un plugin tramite `claude plugin install`, `/plugin` o un suggerimento di installazione in una sessione e Claude Code l'ha rifiutato con questa riga o con `would share its saved data with`.
430
431L'id del plugin rifiutato e l'id di un plugin installato si mappano sulla stessa cartella su disco: sono uguali una volta che `.` e `@` sono scritti come `-`. Su macOS e Windows, gli id che differiscono solo in maiuscole si mappano sulla stessa cartella anche. Installare entrambi metterebbe i file di un plugin nella cartella dell'altro, quindi Claude Code rifiuta e il plugin installato mantiene i suoi file.
432
433Il messaggio nomina la via d'uscita:
434
435* **L'altro plugin è installato**: il messaggio dice `Only one of the two can be installed.` e nomina il comando `claude plugin uninstall` o il passaggio di disinstallazione in `/plugin` che rimuove l'altro plugin. Eseguirlo, quindi installare di nuovo. Per ciò che la disinstallazione rimuove, vedere [What an uninstall deletes and keeps](/docs/it/plugins/cli-reference#what-an-uninstall-deletes-and-keeps).
436* **Entrambi gli id arrivano in un'installazione**, come un plugin e una dipendenza di cui ha bisogno: nessun ordine di installazione aiuta. Solo un manutentore del marketplace che elenca i due plugin può risolverlo, rinominandone uno. Quando i due provengono da marketplace diversi, un manutentore di uno qualsiasi di essi può.
437
413<h3 id="this-plugin-uses-a-source-type-your-claude-code-version-does-not-suppo">438<h3 id="this-plugin-uses-a-source-type-your-claude-code-version-does-not-suppo">
414 `This plugin uses a source type your Claude Code version does not support`439 `This plugin uses a source type your Claude Code version does not support`
415</h3>440</h3>
790* **`URL is unset or invalid`**: un'opzione `${user_config.*}` che l'URL utilizza non è impostata. Eseguire `/plugin configure <plugin>` per impostarla815* **`URL is unset or invalid`**: un'opzione `${user_config.*}` che l'URL utilizza non è impostata. Eseguire `/plugin configure <plugin>` per impostarla
791* **`has an invalid MCP url`** o **`headersHelper for MCP server '<server>' references ${user_config.*}`**: la configurazione del plugin stesso è in difetto. Correggere l'`url` o `headersHelper` nella configurazione MCP del plugin o segnalarlo all'autore del plugin se il plugin non è vostro. Il caso `headersHelper` ha la sua voce sotto [plugin command references user\_config](/docs/it/errors#plugin-command-references-user-config)816* **`has an invalid MCP url`** o **`headersHelper for MCP server '<server>' references ${user_config.*}`**: la configurazione del plugin stesso è in difetto. Correggere l'`url` o `headersHelper` nella configurazione MCP del plugin o segnalarlo all'autore del plugin se il plugin non è vostro. Il caso `headersHelper` ha la sua voce sotto [plugin command references user\_config](/docs/it/errors#plugin-command-references-user-config)
792 817
818<h4 id="bundled-mcp-server-name-was-not-started-it-needs-configuration">
819 `Bundled MCP server "<name>" was not started: it needs configuration`
820</h4>
821
822Il plugin include il server come un [MCPB bundle](/docs/it/plugins/components#include-a-packaged-mcpb-server) che dichiara `user_config`, e un'impostazione richiesta non ha un valore salvato ancora o un valore salvato fallisce la convalida propria del bundle, quindi Claude Code salta l'avvio del server. Il resto del plugin funziona.
823
824Selezionare il plugin sulla scheda **Installed** di `/plugin` e scegliere **Configure** per fornire i valori. Dopo aver salvato, `/plugin` mostra `Configuration saved.` e si chiude, e Claude Code ricarica i plugin come descritto sotto [Manage installed plugins](/docs/it/plugins/install#manage-installed-plugins). Il server si avvia una volta che quel ricaricamento si applica. Prima della v2.1.285, Claude Code saltava il server senza mostrare questa riga.
825
793<h4 id="server-is-configured-but-never-connects">826<h4 id="server-is-configured-but-never-connects">
794 Server is configured but never connects827 Server is configured but never connects
795</h4>828</h4>
841Un language server che non è configurato per lo spazio di lavoro può segnalare importazioni non risolte per i pacchetti interni. Non c'è nulla da correggere dal lato di Claude Code e le diagnostiche non impediscono a Claude di modificare il codice.874Un language server che non è configurato per lo spazio di lavoro può segnalare importazioni non risolte per i pacchetti interni. Non c'è nulla da correggere dal lato di Claude Code e le diagnostiche non impediscono a Claude di modificare il codice.
842 875
843<h2 id="build-a-plugin">876<h2 id="build-a-plugin">
844 Build a plugin877 Creare un plugin
845</h2>878</h2>
846 879
847Si sta sviluppando un plugin e lo si carica con `--plugin-dir` o lo si installa da un marketplace locale. Queste voci coprono i fallimenti che si incontrano durante lo sviluppo di un plugin. Per i controlli da eseguire dopo ogni modifica, vedere [Test and debug](/docs/it/plugins/create#test-and-debug).880Stai sviluppando un plugin e lo stai caricando con `--plugin-dir` o lo stai installando da un marketplace locale. Queste voci coprono i guasti che incontri durante lo sviluppo di un plugin. Per eseguire i controlli dopo ogni modifica, vedi [Test and debug](/docs/it/plugins/create#test-and-debug).
848 881
849Due fallimenti che raggiungono anche gli utenti di un plugin hanno le loro voci sotto [Plugin installed but not working](#plugin-installed-but-not-working):882Due guasti che raggiungono anche gli utenti di un plugin hanno le loro voci sotto [Plugin installed but not working](#plugin-installed-but-not-working):
850 883
851* **Un hook che non si attiva**: vedere [hooks that don't fire](#failed-to-load-hooks-from-and-hooks-that-dont-fire)884* **Un hook che non si attiva**: vedi [hooks that don't fire](#failed-to-load-hooks-from-and-hooks-that-dont-fire)
852* **Un server MCP che non si avvia**: vedere [MCP servers that don't start](#invalid-mcp-server-config-for-and-mcp-servers-that-dont-start)885* **Un server MCP che non si avvia**: vedi [MCP servers that don't start](#invalid-mcp-server-config-for-and-mcp-servers-that-dont-start)
853 886
854<h3 id="commands-path-not-found">887<h3 id="commands-path-not-found">
855 `commands path not found: <path>`888 `commands path not found: <path>`
857 890
858La scheda **Errors** mostra `commands path not found: <absolute path>` con la guida `Check that the path in your manifest or marketplace config is correct`. Lo stesso messaggio appare per `skills`, `agents` e `hooks`.891La scheda **Errors** mostra `commands path not found: <absolute path>` con la guida `Check that the path in your manifest or marketplace config is correct`. Lo stesso messaggio appare per `skills`, `agents` e `hooks`.
859 892
860Claude Code ha risolto un percorso dal vostro `plugin.json` o dalla voce del marketplace rispetto alla radice del plugin e non ha trovato nulla lì. Il percorso nel messaggio è il percorso assoluto che ha controllato, quindi confrontarlo con ciò che è su disco. Correggere il percorso o creare la directory, quindi eseguire `/reload-plugins`.893Claude Code ha risolto un percorso dal tuo `plugin.json` o dalla voce del marketplace rispetto alla radice del plugin e non ha trovato nulla lì. Il percorso nel messaggio è il percorso assoluto che ha controllato, quindi confrontalo con quello su disco. Correggi il percorso o crea la directory, quindi esegui `/reload-plugins`.
861 894
862I percorsi nel manifest sono relativi alla radice del plugin e iniziano con `./`. Un percorso che si risolve al di fuori della radice del plugin è segnalato come `<component> path escapes plugin directory` al suo posto e viene scartato.895I percorsi nel manifest sono relativi alla radice del plugin e iniziano con `./`. Un percorso che si risolve al di fuori della radice del plugin viene segnalato come `<component> path escapes plugin directory` e viene eliminato.
863 896
864<h3 id="plugin-dir-loads-a-plugin-with-no-components">897<h3 id="plugin-dir-loads-a-plugin-with-no-components">
865 `--plugin-dir` at a marketplace root doesn't load the plugins under `plugins/`898 `--plugin-dir` in una radice del marketplace non carica i plugin sotto `plugins/`
866</h3>899</h3>
867 900
868È stato avviato `claude --plugin-dir <path>` e non si vede alcun errore, ma le skills, gli agent e gli hooks del plugin non sono lì.901Hai avviato `claude --plugin-dir <path>` e non vedi errori, ma le skills, gli agents e gli hooks del plugin non sono lì.
869 902
870`--plugin-dir` prende la directory radice del plugin, quella che contiene `.claude-plugin/plugin.json` e le directory dei componenti come `skills/`. Se lo si punta alla radice di un marketplace al suo posto, Claude Code non legge `marketplace.json`, quindi un plugin sotto `plugins/` non si carica e non si vede alcun errore. Prima della v2.1.281, Claude Code caricava una radice di marketplace come un plugin vuoto denominato dopo quella directory. Puntare il flag alla directory del plugin stesso:903`--plugin-dir` accetta la directory radice del plugin, quella che contiene `.claude-plugin/plugin.json` e le directory dei componenti come `skills/`. Se la punti a una radice del marketplace, Claude Code non legge `marketplace.json`, quindi un plugin sotto `plugins/` non si carica e non vedi errori. Prima della v2.1.281, Claude Code caricava una radice del marketplace come un plugin vuoto denominato dopo quella directory. Punta il flag alla directory del plugin stesso:
871 904
872```shell theme={null}905```shell theme={null}
873claude --plugin-dir ./my-marketplace/plugins/my-plugin906claude --plugin-dir ./my-marketplace/plugins/my-plugin
874```907```
875 908
876Quindi aprire **Installed** in `/plugin`, dove il riquadro dei dettagli del plugin elenca i suoi componenti.909Quindi apri **Installed** in `/plugin`, dove il riquadro dei dettagli del plugin elenca i suoi componenti.
877 910
878<h3 id="files-the-plugin-references-outside-its-directory-arent-found">911<h3 id="files-the-plugin-references-outside-its-directory-arent-found">
879 Files the plugin references outside its directory aren't found912 I file a cui il plugin fa riferimento al di fuori della sua directory non vengono trovati
880</h3>913</h3>
881 914
882Un plugin funziona dalla sua directory di origine con `--plugin-dir` ma fallisce dopo l'installazione, con errori su un percorso come `../shared-utils`.915Un plugin funziona dalla sua directory di origine con `--plugin-dir` ma fallisce dopo l'installazione, con errori su un percorso come `../shared-utils`.
883 916
884Claude Code copia un plugin installato nella sua cache e lo carica da lì, quindi un percorso che raggiunge al di fuori della propria directory del plugin non punta a nulla nella cache. Spostare i file condivisi all'interno della directory del plugin o farvi riferimento attraverso un symlink al suo interno. Per dove è la cache e come i percorsi si risolvono, vedere [Find plugins on disk](/docs/it/plugins/loading#find-plugins-on-disk).917Claude Code copia un plugin installato nella sua cache e lo carica da lì, quindi un percorso che raggiunge al di fuori della directory del plugin stesso non punta a nulla nella cache. Sposta i file condivisi all'interno della directory del plugin o fai riferimento ad essi tramite un symlink al suo interno. Per sapere dove si trova la cache e come si risolvono i percorsi, vedi [Find plugins on disk](/docs/it/plugins/loading#find-plugins-on-disk).
885 918
886<h3 id="claude-plugin-root-shows-forward-slashes-on-windows">919<h3 id="claude-plugin-root-shows-forward-slashes-on-windows">
887 `${CLAUDE_PLUGIN_ROOT}` shows forward slashes on Windows920 `${CLAUDE_PLUGIN_ROOT}` mostra barre oblique in avanti su Windows
888</h3>921</h3>
889 922
890Su Windows, un hook del plugin riceve `${CLAUDE_PLUGIN_ROOT}` come `C:/Users/you/...` piuttosto che `C:\Users\you\...` e uno script che si aspettava backslash si interrompe.923Su Windows, un hook del plugin riceve `${CLAUDE_PLUGIN_ROOT}` come `C:/Users/you/...` anziché `C:\Users\you\...` e uno script che si aspettava barre oblique inverse si interrompe.
891 924
892Claude Code esegue gli hook in forma di shell attraverso Git Bash su Windows e sostituisce la radice del plugin nella forma Win32 con barra in avanti di proposito. I builtin di Bash, gli strumenti MSYS e i binari Windows nativi accettano tutti quella forma.925Claude Code esegue gli hook in forma shell attraverso Git Bash su Windows e sostituisce la radice del plugin nella forma Win32 con barre oblique in avanti di proposito. I builtin di Bash, gli strumenti MSYS e i binari Windows nativi accettano tutti quella forma.
893 926
894Se lo script ha bisogno di backslash, passare l'hook a una delle forme che mantengono i percorsi nativi, descritte sotto [exec form and shell form](/docs/it/hooks#exec-form-and-shell-form):927Se il tuo script ha bisogno di barre oblique inverse, passa l'hook a una delle forme che mantengono i percorsi nativi, descritte sotto [exec form and shell form](/docs/it/hooks#exec-form-and-shell-form):
895 928
896* Un hook in forma exec, che genera il processo direttamente con un array `args`929* Un hook in forma exec, che genera il processo direttamente con un array `args`
897* Un hook con `"shell": "powershell"`930* Un hook con `"shell": "powershell"`
898 931
899<h3 id="plugin-loads-but-its-skills-are-missing">932<h3 id="plugin-loads-but-its-skills-are-missing">
900 Plugin loads but its skills are missing933 Il plugin si carica ma le sue skills sono mancanti
901</h3>934</h3>
902 935
903Il plugin è elencato sotto **Installed** senza errori, ma le sue skills non vengono offerte quando si digita `/`.936Il tuo plugin è elencato sotto **Installed** senza errori, ma le sue skills non vengono offerte quando digiti `/`.
904 937
905Le skills si caricano da `skills/` alla radice del plugin e i comandi da `commands/` alla radice del plugin. Solo `plugin.json` appartiene all'interno di `.claude-plugin/` e una directory `skills/` all'interno di `.claude-plugin/` non viene scansionata. Spostare le directory alla radice del plugin ed eseguire `/reload-plugins`. Successivamente, il riquadro dei dettagli del plugin in `/plugin` elenca le skills e digitare `/` le offre.938Le skills si caricano da `skills/` alla radice del plugin e i comandi da `commands/` alla radice del plugin. Solo `plugin.json` appartiene a `.claude-plugin/` e una directory `skills/` all'interno di `.claude-plugin/` non viene scansionata. Sposta le directory alla radice del plugin ed esegui `/reload-plugins`. Successivamente, il riquadro dei dettagli del plugin in `/plugin` elenca le skills e digitando `/` le offre.
906 939
907Ogni skill è una directory contenente `SKILL.md`. Una voce `skills` nel manifest che punta a un file `SKILL.md` piuttosto che alla sua directory è segnalata come `path is a file; skills entries must be directories containing SKILL.md`.940Ogni skill è una directory contenente `SKILL.md`. Una voce `skills` nel manifest che punta a un file `SKILL.md` anziché alla sua directory viene segnalata come `path is a file; skills entries must be directories containing SKILL.md`.
908 941
909<h3 id="skill-loads-but-claude-never-invokes-the-skill">942<h3 id="skill-loads-but-claude-never-invokes-the-skill">
910 Skill loads but Claude never invokes the skill943 La skill si carica ma Claude non invoca mai la skill
911</h3>944</h3>
912 945
913La skill del plugin viene eseguita quando si digita il comando `/<plugin>:<skill>` ma Claude non la invoca mai in risposta a una richiesta semplice.946La skill del tuo plugin viene eseguita quando digiti il suo comando `/<plugin>:<skill>`, ma Claude non la invoca mai in risposta a una richiesta semplice.
914 947
915Controllare queste cause in ordine:948Controlla queste cause in ordine:
916 949
917* **La skill imposta `disable-model-invocation: true`**: con quel campo impostato, solo voi potete invocare la skill. La skill del modello in [Create your first plugin](/docs/it/plugins/create#create-your-first-plugin) lo imposta. Rimuovere la riga da una skill che volete che Claude invochi da solo. [Control who invokes a skill](/docs/it/skills#control-who-invokes-a-skill) copre il campo950* **La skill imposta `disable-model-invocation: true`**: con quel campo impostato, solo tu puoi invocare la skill. La skill del template in [Create your first plugin](/docs/it/plugins/create#create-your-first-plugin) lo imposta. Rimuovi la riga da una skill che vuoi che Claude invochi da solo. [Control who invokes a skill](/docs/it/skills#control-who-invokes-a-skill) copre il campo
918* **La descrizione non corrisponde a come le persone chiedono**: lavorare attraverso i controlli in [Skill not triggering](/docs/it/skills#skill-not-triggering)951* **La descrizione non corrisponde a come le persone chiedono**: lavora attraverso i controlli in [Skill not triggering](/docs/it/skills#skill-not-triggering)
919* **La descrizione è troncata**: quando molte skills sono installate, Claude Code accorcia le descrizioni per adattarsi al budget dei caratteri dell'elenco, che può spogliare le parole chiave di cui Claude ha bisogno per abbinare una richiesta. Vedere [Skill descriptions are cut short](/docs/it/skills#skill-descriptions-are-cut-short)952* **La descrizione è troncata**: quando molte skills sono installate, Claude Code accorcia le descrizioni per adattarsi al budget dei caratteri dell'elenco, che può eliminare le parole chiave di cui Claude ha bisogno per abbinare una richiesta. Vedi [Skill descriptions are cut short](/docs/it/skills#skill-descriptions-are-cut-short)
920 953
921Per misurare quanto spesso la skill si attiva su prompt realistici piuttosto che controllare uno alla volta, scrivere un caso di eval con un [grader `tool_used: Skill`](/docs/it/plugin-evals#create-your-first-eval-suite) ed eseguirlo con `claude plugin eval` dopo ogni modifica della descrizione.954Per misurare quanto spesso la skill si attiva su prompt realistici anziché controllare uno alla volta, scrivi un caso eval con un [grader `tool_used: Skill`](/docs/it/plugin-evals#create-your-first-eval-suite) ed eseguilo con `claude plugin eval` dopo ogni modifica della descrizione.
922 955
923<h3 id="is-not-a-plugin-or-skill-folder">956<h3 id="is-not-a-plugin-or-skill-folder">
924 `<directory> is not a plugin or skill folder` from `claude plugin eval init`957 `<directory> is not a plugin or skill folder` da `claude plugin eval init`
925</h3>958</h3>
926 959
927È stato eseguito `claude plugin eval init` da una directory che non è la radice di un plugin, come la directory home o la radice di un repository che mantiene il plugin in una sottodirectory. `init` scrive la suite sotto la directory di lavoro, quindi si ferma invece di creare una directory `evals/` che il plugin non vedrebbe mai.960Hai eseguito `claude plugin eval init` da una directory che non è la radice di un plugin, come la tua home directory o la radice di un repository che mantiene il plugin in una sottodirectory. `init` scrive la suite nella directory di lavoro, quindi si ferma invece di creare una directory `evals/` che il plugin non vedrebbe mai.
928 961
929Cambiare alla radice del plugin, la directory che contiene `.claude-plugin/plugin.json` o il `SKILL.md` della skill ed eseguire di nuovo il comando. Per impalcare la suite da qualche parte d'altro di proposito, passare `--eval-dir`. Vedere [Test plugins with evals](/docs/it/plugin-evals).962Cambia alla radice del plugin, la directory che contiene `.claude-plugin/plugin.json` o il `SKILL.md` della skill, ed esegui di nuovo il comando. Per impalcare la suite da qualche altra parte di proposito, passa `--eval-dir`. Vedi [Test plugins with evals](/docs/it/plugin-evals).
930 963
931<h3 id="the-userconfig-dialog-never-appears">964<h3 id="the-userconfig-dialog-never-appears">
932 The `userConfig` dialog never appears965 La finestra di dialogo `userConfig` non appare mai
933</h3>966</h3>
934 967
935Il plugin dichiara opzioni `userConfig` ma nessuna finestra di dialogo di configurazione appare quando lo si installa.968Il tuo plugin dichiara opzioni `userConfig`, ma nessuna finestra di dialogo di configurazione appare quando lo installi.
936 969
937L'installazione interattiva mostra la finestra di dialogo e il comando della shell prende i valori come flag al suo posto:970Se l'installazione chiede i valori dipende da dove lo esegui:
938 971
939* **`/plugin install` in una sessione, o la scheda Discover in `/plugin`**: la finestra di dialogo fa parte di questa installazione interattiva972* **`/plugin install` in una sessione, o la scheda Discover in `/plugin`**: la finestra di dialogo fa parte di questa installazione interattiva
940* **`claude plugin install` nella shell**: non chiede mai i valori di `userConfig`. Salva tutti i valori `--config KEY=VALUE` che si passano e quando le opzioni rimangono non impostate stampa `N userConfig options not yet set — run /plugin configure <plugin>@<marketplace> in Claude Code, or pass --config KEY=VALUE.` Quando una qualsiasi delle opzioni non impostate è obbligatoria, `(M required)` segue `not yet set`.973* **La finestra di dialogo Manage plugins dell'estensione VS Code**: chiede le opzioni non impostate come un modulo dopo l'installazione. Prima della v2.1.285, l'installazione lì non mostrava alcun modulo di opzioni, quindi imposta i valori da una sessione di terminale con `/plugin configure <plugin>@<marketplace>`
974* **`claude plugin install` nella tua shell**: non chiede mai i valori `userConfig`. Salva tutti i valori `--config KEY=VALUE` che passi e quando le opzioni rimangono non impostate stampa `N userConfig options not yet set — run /plugin configure <plugin>@<marketplace> in Claude Code, or pass --config KEY=VALUE.` Quando una qualsiasi delle opzioni non impostate è obbligatoria, `(M required)` segue `not yet set`.
941 975
942Se è stato installato dalla shell, passare i valori con `--config`, un flag per opzione:976Se hai installato dalla shell, passa i valori con `--config`, un flag per opzione:
943 977
944```shell theme={null}978```shell theme={null}
945claude plugin install my-plugin@my-marketplace --config api_url=https://example.com979claude plugin install my-plugin@my-marketplace --config api_url=https://example.com
946```980```
947 981
948Quando ogni opzione è impostata, l'output di installazione non porta alcuna riga `not yet set`. Per aprire la finestra di dialogo in seguito al suo posto, eseguire `/plugin configure my-plugin@my-marketplace` in una sessione.982Quando ogni opzione è impostata, l'output dell'installazione non contiene alcuna riga `not yet set`.
983
984Per aprire la finestra di dialogo successivamente, esegui `/plugin configure my-plugin@my-marketplace` in una sessione. Dalla shell, [`claude plugin configure`](/docs/it/plugins/cli-reference#plugin-configure) mostra quali opzioni sono ancora non impostate e salva i valori inviati su stdin. Richiede Claude Code v2.1.285 o successivo.
985
986Se passi una chiave `--config` che il manifest non dichiara, il plugin si installa comunque e il comando stampa `⚠ Installed, but --config not applied: --config key "<key>" isn't declared in this plugin's userConfig.` seguito dalle chiavi che il plugin dichiara.
949 987
950Se si passa una chiave `--config` che il manifest non dichiara, il plugin si installa comunque e il comando stampa `⚠ Installed, but --config not applied: --config key "<key>" isn't declared in this plugin's userConfig.` seguito dalle chiavi che il plugin dichiara.988Per un plugin che spedisce un [file bundle MCPB](/docs/it/plugins/components#include-a-packaged-mcpb-server) che dichiara il suo `user_config`, il messaggio legge `isn't declared in this plugin's userConfig or by its bundled MCP servers.` invece, e le chiavi note includono le chiavi di quel server, scritte `<server>.<key>`. Un bundle che il manifest riferisce tramite URL non viene letto al momento dell'installazione, quindi le sue chiavi non sono elencate e il messaggio dice di configurarlo in `/plugin`. L'impostazione delle chiavi `<server>.<key>` richiede Claude Code v2.1.285 o successivo.
951 989
952<h3 id="claude-plugin-validate-reports-errors">990<h3 id="claude-plugin-validate-reports-errors">
953 `claude plugin validate` reports errors991 `claude plugin validate` segnala errori
954</h3>992</h3>
955 993
956È stato eseguito `claude plugin validate <path>` o `/plugin validate <path>` in una sessione e ha stampato `Found N errors` e `Validation failed`, quindi è uscito con codice 1.994Hai eseguito `claude plugin validate <path>`, o `/plugin validate <path>` in una sessione, e ha stampato `Found N errors` e `Validation failed`, quindi è uscito con codice 1.
957 995
958Il validatore legge il manifest nel percorso che si fornisce: `.claude-plugin/plugin.json` per una directory di plugin o `.claude-plugin/marketplace.json` per una directory di marketplace. Per un marketplace, prefissa i problemi nel manifest della voce stessa con l'indice della voce, come `plugins[1] plugin.json → json: ...`.996Il validatore legge il manifest nel percorso che fornisci: `.claude-plugin/plugin.json` per una directory di plugin, o `.claude-plugin/marketplace.json` per una directory di marketplace. Per un marketplace, antepone i problemi nel manifest proprio di una voce con l'indice della voce, come `plugins[1] plugin.json → json: ...`.
959 997
960La tabella copre i messaggi che fermano la convalida e due avvisi, `No frontmatter block found` e `Unknown field '<key>'`, che la fermano solo quando si passa `--strict`. Altri avvisi, come una descrizione mancante, non sono elencati.998La tabella copre i messaggi che fermano la convalida e due avvisi, `No frontmatter block found` e `Unknown field '<key>'`, che la fermano solo quando passi `--strict`. Altri avvisi, come una descrizione mancante, non sono elencati.
961 999
962| Message | Cause | Fix |1000| Messaggio | Causa | Correzione |
963| :- | :- | :- |1001| :- | :- | :- |
964| `File not found: <path>` | Il percorso non ha un manifest o non esiste. | Eseguire il comando rispetto alla radice del plugin o del marketplace, la directory che contiene `.claude-plugin/`. |1002| `File not found: <path>` | Il percorso non ha manifest o non esiste. | Esegui il comando rispetto alla radice del plugin o del marketplace, la directory che contiene `.claude-plugin/`. |
965| `No manifest found in directory. Expected .claude-plugin/marketplace.json or .claude-plugin/plugin.json` | La directory non ha alcun manifest `.claude-plugin/`. | Creare il manifest o puntare alla directory giusta. |1003| `No manifest found in directory. Expected .claude-plugin/marketplace.json or .claude-plugin/plugin.json` | La directory non ha manifest `.claude-plugin/`. | Crea il manifest o punta alla directory giusta. |
966| `Invalid JSON syntax: <parse error>` | Il manifest o `hooks/hooks.json` non è JSON valido. | Correggere il JSON. Fino a quando non si corregge `hooks/hooks.json`, una sessione carica il plugin senza gli hook in quel file. |1004| `Invalid JSON syntax: <parse error>` | Il manifest o `hooks/hooks.json` non è JSON valido. | Correggi il JSON. Finché non correggi `hooks/hooks.json`, una sessione carica il plugin senza gli hook in quel file. |
967| `Path not found: <path>. The runtime loader will report this as a load failure.` | Un percorso di componente nel manifest non esiste. | Correggere il percorso o creare la directory. |1005| `Path not found: <path>. The runtime loader will report this as a load failure.` | Un percorso di componente nel manifest non esiste. | Correggi il percorso o crea la directory. |
968| `Path contains ".." which could be a path traversal attempt: <path>` | Un percorso di componente esce dalla directory del plugin. | Utilizzare percorsi all'interno della radice del plugin. |1006| `Path contains ".." which could be a path traversal attempt: <path>` | Un percorso di componente esce dalla directory del plugin. | Usa percorsi all'interno della radice del plugin. |
969| `Path is a file; skills entries must be directories containing SKILL.md` | Una voce `skills` punta a `SKILL.md` invece che alla sua directory. | Puntare alla directory padre o `.` per un `SKILL.md` a livello di radice. |1007| `Path is a file; skills entries must be directories containing SKILL.md` | Una voce `skills` punta a `SKILL.md` anziché alla sua directory. | Punta alla directory padre, o `.` per un `SKILL.md` a livello di radice. |
970| `No frontmatter block found` o `YAML frontmatter failed to parse: <error>` | Un file di skill, agent o comando ha frontmatter YAML mancante o non valido. | Aggiungere o correggere il frontmatter tra i delimitatori `---`. Segnalato durante la convalida di una directory di plugin. |1008| `No frontmatter block found` o `YAML frontmatter failed to parse: <error>` | Un file skill, agent o command ha frontmatter YAML mancante o non valido. | Aggiungi o correggi il frontmatter tra i delimitatori `---`. Segnalato durante la convalida di una directory di plugin. |
971| `Unknown field '<key>'` | Il manifest ha un campo che lo schema non definisce. | Rimuoverlo o utilizzare il nome che il messaggio suggerisce. Claude Code ignora i campi sconosciuti al momento del caricamento. |1009| `Unknown field '<key>'` | Il manifest ha un campo che lo schema non definisce. | Rimuovilo o usa il nome che il messaggio suggerisce. Claude Code ignora i campi sconosciuti al momento del caricamento. |
972 1010
973Eseguire il comando di nuovo dopo ogni correzione fino a quando non stampa alcun errore.1011Esegui il comando di nuovo dopo ogni correzione finché non stampa errori.
974 1012
975I campi `plugin.json` sono sul [manifest reference](/docs/it/plugins/manifest-reference) e i messaggi a livello di marketplace sono sotto [Marketplace validation errors](#marketplace-validation-errors).1013I campi `plugin.json` sono nel [manifest reference](/docs/it/plugins/manifest-reference) e i messaggi a livello di marketplace sono sotto [Marketplace validation errors](#marketplace-validation-errors).
976 1014
977<h3 id="plugin-has-conflicting-manifests">1015<h3 id="plugin-has-conflicting-manifests">
978 `Plugin <name> has conflicting manifests`1016 `Plugin <name> has conflicting manifests`
980 1018
981Il plugin non si carica con `Plugin <name> has conflicting manifests: both plugin.json and marketplace entry specify components.`1019Il plugin non si carica con `Plugin <name> has conflicting manifests: both plugin.json and marketplace entry specify components.`
982 1020
983Il plugin ha il suo `plugin.json` e la sua voce del marketplace imposta `strict: false` mentre dichiara anche uno qualsiasi di `commands`, `agents`, `skills`, `hooks`, `outputStyles` o `themes`. Rimuovere quei campi dalla voce o impostare `strict: true` nella voce in modo che Claude Code li aggiunga a `plugin.json`. Vedere [Strict mode](/docs/it/plugins/marketplace-reference#strict-mode).1021Il plugin ha il suo `plugin.json` e la sua voce del marketplace imposta `strict: false` mentre dichiara anche uno qualsiasi di `commands`, `agents`, `skills`, `hooks`, `outputStyles` o `themes`. Rimuovi quei campi dalla voce o imposta `strict: true` nella voce in modo che Claude Code li aggiunga a `plugin.json`. Vedi [Strict mode](/docs/it/plugins/marketplace-reference#strict-mode).
984 1022
985<h3 id="warning-no-commands-found-in-plugin-custom-directory">1023<h3 id="warning-no-commands-found-in-plugin-custom-directory">
986 `Warning: No commands found in plugin <name> custom directory`1024 `Warning: No commands found in plugin <name> custom directory`
987</h3>1025</h3>
988 1026
989Quando il plugin si carica, il log `claude --debug` su `~/.claude/debug/<session-id>.txt` registra `Warning: No commands found in plugin <name> custom directory: <path>. Expected .md files or SKILL.md in subdirectories.` Nulla appare nella sessione o nella scheda **Errors**.1027Quando il plugin si carica, il log `claude --debug` in `~/.claude/debug/<session-id>.txt` registra `Warning: No commands found in plugin <name> custom directory: <path>. Expected .md files or SKILL.md in subdirectories.` Nulla appare nella sessione o nella scheda **Errors**.
990 1028
991Il percorso `commands` nel manifest esiste ma non contiene file `.md` e nessun `SKILL.md` in una sottodirectory. Aggiungere i file di comando o rimuovere il percorso dal manifest.1029Il percorso `commands` nel manifest esiste ma non contiene file `.md` e nessun `SKILL.md` in una sottodirectory. Aggiungi i file di comando o rimuovi il percorso dal manifest.
992 1030
993<h2 id="host-a-marketplace">1031<h2 id="host-a-marketplace">
994 Host a marketplace1032 Host a marketplace
