Skip to main content
Esegui i comandi plugin come claude plugin dalla tua shell o da uno script, oppure come /plugin e /reload-plugins all’interno di una sessione Claude Code. Questo riferimento fornisce i flag, i valori predefiniti, l’output e i codici di uscita di ogni comando, insieme ai due flag che caricano un plugin per una sola sessione. Esegui claude plugin --help sulla tua build per confermare quali sottocomandi ha la tua versione.
Questi casi sono trattati su altre pagine:

​
Comandi claude plugin

Esegui claude plugin <subcommand> dalla tua shell o da uno script, al di fuori di una sessione Claude Code. Questi sottocomandi installano e gestiscono i plugin senza aprire il pannello /plugin. claude plugins è un alias per claude plugin. Ogni sottocomando condivide questi codici di uscita, argomenti plugin e valori di ambito:
  • Codici di uscita: 0 in caso di successo e 1 in caso di errore. validate aggiunge l’uscita 2 per un errore inaspettato, e eval aggiunge i codici elencati nella sua sezione.
  • Argomenti plugin: un argomento <plugin> è un plugin name o name@marketplace. Quando due marketplace offrono lo stesso nome, usa la forma qualificata.
  • Ambiti: --scope accetta user, project o local, e nomina il file di impostazioni in cui il comando scrive. update accetta anche managed.

​
plugin init

Crea lo scaffolding di un nuovo plugin in ~/.claude/skills/<name>/. Si carica nella tua prossima sessione come <name>@skills-dir senza alcun passaggio di installazione. new è un alias per init. Per il flusso di lavoro di creazione, test e modifica che inizia con questo comando, vedi Crea un plugin.
<name> diventa il nome della directory sotto ~/.claude/skills/ e il name del plugin nel suo manifest. Il comando non ha un flag per un’altra posizione. Per creare lo scaffolding all’interno di un progetto, vedi Crea un plugin. Crea lo scaffolding di un plugin con file skill e hook starter:
Claude Code convalida ciò che ha scritto e stampa Created plugin "my-helper" at ~/.claude/skills/my-helper, seguito dall’id con cui si carica e dal comando claude plugin disable che lo disattiva. Claude Code esce con 1 senza scrivere quando non può creare lo scaffolding in sicurezza, e il messaggio nomina il motivo. Questi sono motivi comuni:
  • Un valore --with sconosciuto
  • Uno scaffolding esistente al target senza --force
  • Un’impostazione gestita che blocca i plugin della directory skills

​
plugin install

Installa un plugin da un marketplace che hai aggiunto. i è un alias per install.
La maggior parte dei plugin si installa senza un prompt. Per un plugin il cui entry del marketplace esegue un comando per installarlo o imposta un headersHelper per il suo download, Claude Code prima stampa il comando e chiede Run this command now? [y/N]. Passa -y dal tuo terminale per accettare il comando visualizzato senza il prompt. Ecco cosa succede senza un TTY e quando Claude esegue il comando:
  • stdin o stdout non è un TTY, e non passi né -y né --accept-command: l’installazione viene rifiutata. L’output dice che il comando è stato solo visualizzato, e il codice di uscita è 1
  • Claude esegue il comando attraverso il suo strumento Bash: -y viene ignorato. Esegui il comando dal tuo terminale invece
Installa un plugin per tutti coloro che clonano il progetto:
Claude Code stampa Successfully installed plugin: formatter@my-marketplace (scope: project). Quando nulla di nuovo viene installato, l’output dice perché:
  • Già installato a quell’ambito: l’output è Plugin "formatter@my-marketplace" is already installed (scope: project) e il codice di uscita è 0
  • Rifiuti un prompt di origine comando: l’output è Aborted. e il codice di uscita è 1
  • Rifiuti un prompt headersHelper, o non può essere confermato senza un TTY: l’output è Aborted — the command was not run. e il codice di uscita è 1

​
Formato risultato JSON

Quando passi --json a plugin install, l’ultima riga di stdout è un oggetto JSON. Analizza solo quella riga, perché Claude Code stampa qualsiasi comando che il marketplace dichiara prima di essa. Tre campi sono sempre presenti:
  • command: il sottocomando che è stato eseguito, ad esempio install
  • outcome: ok o failed
  • message: una descrizione leggibile del risultato
Altri campi, come pluginId, scope e failureCode, appaiono solo quando si applicano. Un errore di utilizzo, come uno --scope non valido, non stampa alcuna riga di risultato ed esce con 1 con il motivo su stderr.

​
Accetta un comando di installazione visualizzato

Quando un’esecuzione --json visualizza un comando dichiarato dal marketplace e non lo esegue, il risultato failed porta anche un oggetto shownCommand. I suoi campi includono il comando come visualizzato, il plugin a cui appartiene, e lo sha256 del comando. Per accettare esattamente quel comando, esegui di nuovo con quello sha256 come --accept-command dal tuo terminale, perché il flag non ha effetto all’interno di una sessione Claude Code. Richiede Claude Code v2.1.271 o successivo. Lo sha256 conta come accettazione per esattamente quel comando, plugin e catalogo marketplace. Se uno di essi è cambiato dal momento in cui il comando è stato visualizzato, Claude Code non accetta lo sha256 e mostra di nuovo il comando. Un cambiamento che l’aggiornamento del marketplace della stessa esecuzione recupera conta anche come tale cambiamento. Se shownCommand.acceptCommandMatched è false, lo sha256 che hai passato non corrisponde al comando ora visualizzato. Rivedi quel comando prima di eseguire di nuovo con il suo sha256.

​
plugin uninstall

Rimuovi un plugin installato da un ambito. remove e rm sono alias per uninstall.
Disinstalla un plugin dall’ambito del progetto:
Claude Code stampa Successfully uninstalled plugin: formatter (scope: project). Quando il plugin non è installato a quell’ambito, il comando stampa una riga che inizia con Failed to uninstall plugin "formatter@my-marketplace": ed esce con 1.

​
plugin enable

Abilita un plugin disabilitato. Per un plugin sincronizzato da claude.ai, passa <name>@synced come plugin.
Senza --scope, il comando controlla i tuoi file di impostazioni nell’ordine local, project, user, e usa il primo ambito che menziona il plugin. Se passi uno --scope dove il plugin non è dichiarato, il comando scrive un override o fallisce:
  • Un ambito che ha precedenza su quello dichiarante: Claude Code scrive un override all’ambito che hai passato. Ad esempio, claude plugin disable formatter --scope local disattiva un plugin abilitato a livello di progetto solo per te
  • Qualsiasi altro ambito: il comando fallisce con Plugin "formatter" is installed at project scope, not user. Use --scope project or omit --scope to auto-detect.
Se il plugin è già abilitato all’ambito risolto, il comando stampa Plugin "formatter" is already enabled ed esce con 1. Con --json, il risultato ha "failureCode": "already_in_goal_state" e "alreadyInGoalState": true, quindi uno script può trattare quel caso come successo. Quando il plugin dichiara dipendenze, Claude Code le abilita anche. Il comando fallisce in questi casi:
  • Una dipendenza non è installata: enable fallisce e stampa il comando claude plugin install per ogni dipendenza mancante
  • Una dipendenza è bloccata dalla politica dei plugin della tua organizzazione: enable fallisce e nomina la dipendenza bloccata
  • Una dipendenza è impostata a false a un ambito con precedenza più alta dell’ambito target: enable fallisce. Abilita la dipendenza a quell’ambito, o passa --scope per scrivere lì
Riabilita un plugin ovunque sia dichiarato:
Claude Code stampa Successfully enabled plugin: formatter (scope: project), nominando l’ambito che ha rilevato.

​
plugin disable

Disabilita un plugin senza disinstallarlo. Per un plugin sincronizzato da claude.ai, passa <name>@synced come plugin.
Senza --scope, l’ambito è auto-rilevato nello stesso ordine local, project, user di plugin enable. Se non passi né un nome di plugin né --all, Claude Code stampa Please specify a plugin name or use --all to disable all plugins ed esce con 1. Disabilitare un plugin che è già disabilitato stampa Plugin "formatter" is already disabled ed esce con 1, come plugin enable fa per un plugin già abilitato. Il comando fallisce per un plugin che è ancora richiesto:
  • Un altro plugin abilitato dipende da esso: il comando fallisce e nomina i dipendenti da disabilitare prima
  • La tua organizzazione lo richiede come plugin sincronizzato: il comando fallisce e non salva nulla
Disabilita un plugin:
Claude Code stampa Successfully disabled plugin: formatter (scope: project).

​
plugin update

Aggiorna un plugin all’ultima versione che il suo marketplace offre. La nuova versione si carica nella tua prossima sessione, o dopo che esegui /reload-plugins in una sessione in esecuzione.
managed è l’unico ambito che puoi aggiornare ma non installare. Per i plugin installati dall’amministratore, vedi Gestisci i plugin per la tua organizzazione. Aggiorna un plugin:
Claude Code stampa Checking for updates for plugin "formatter@my-marketplace"…, poi il risultato. Quando nulla è più recente, stampa formatter is already at the latest version (1.0.0). ed esce con 0. Puoi passare un nome di plugin semplice, che il comando abbina ai tuoi plugin installati. Quando i plugin installati da diversi marketplace condividono il nome, il comando rifiuta l’aggiornamento ed elenca i comandi plugin-name@marketplace-name qualificati da eseguire invece. L’aggiornamento per nome semplice richiede Claude Code v2.1.246 o successivo.

​
plugin list

Elenca i plugin installati con la loro versione, ambito e stato.
Claude Code raggruppa l’output leggibile per come ogni plugin si carica:
  • Installed plugins:: plugin che hai installato da un marketplace
  • Session-only plugins (--plugin-dir / --plugin-url):: plugin caricati da quei flag nello stesso comando, come in claude --plugin-dir ./my-plugin plugin list
  • Skills-directory plugins (.claude/skills/*):: plugin che Claude Code ha trovato in una directory skills
  • Synced from claude.ai: plugin sincronizzati dal tuo account claude.ai
Con nulla in nessun gruppo, Claude Code stampa No plugins installed. Use `claude plugin install` to install a plugin.

​
Output JSON

Con --json, Claude Code stampa un array con un oggetto per installazione. Ogni oggetto porta i campi sottostanti. id, version, scope, enabled e installPath sono sempre presenti, e gli altri appaiono solo quando si applicano. Con --json --available, Claude Code stampa un oggetto invece di un array. Il suo campo installed contiene l’array di oggetti plugin installati, e il suo campo available contiene un oggetto per plugin marketplace non installato con i campi sottostanti.

​
plugin details

Mostra l’inventario dei componenti di un plugin e il suo costo token previsto. Il plugin deve essere caricato: installato, trovato in una directory skills, o passato con --plugin-dir o --plugin-url nello stesso comando. Il <name> è un plugin name o name@marketplace.
Il comando non accetta flag oltre a --help. Mostra cosa contribuisce un plugin installato:
Claude Code stampa il nome, la versione, la descrizione e la source del plugin, poi queste sezioni:
  • Component inventory: le skills, gli agents, gli hooks, i server MCP e i server LSP del plugin
  • Projected token cost: i token sempre attivi che il plugin aggiunge a ogni sessione
  • Per-component (rounded): stime sempre attive e on-invoke per ogni skill, agent e comando. Omesso quando il plugin non ne ha
Per cosa significano le due figure di costo, vedi Misura il costo e l’utilizzo del plugin. Per un plugin che non è caricato, Claude Code stampa Plugin "formatter" not found. Run `claude plugin list` to see installed plugins, or pass --plugin-dir <path> to load one from disk. ed esce con 1.

​
plugin prune

Rimuovi le dipendenze auto-installate che nessun plugin installato necessita più. Il comando non rimuove mai un plugin che hai installato tu stesso. autoremove è un alias per prune.
Anteprima cosa un prune rimuoverebbe:
Claude Code elenca le dipendenze orfane e termina con (dry run — nothing removed). Con nulla da rimuovere, stampa una riga che inizia con Nothing to prune. Senza --dry-run, il comando rimuove le dipendenze orfane solo dopo che confermi al prompt o passi -y. Il codice di uscita è 0 qualunque sia la tua risposta al prompt. Cosa fa prune dipende dal fatto che un terminale sia collegato e se passi -y:

​
plugin eval

Esegui i casi eval di un plugin e riporta i risultati valutati. Richiede Claude Code v2.1.269 o successivo. Ogni caso è un prompt più grader. Claude Code lo esegue più volte in una sessione isolata con solo il plugin target caricato, e per impostazione predefinita anche senza il plugin in modo che il rapporto mostri la differenza. Vedi Testa i plugin con evals per il formato del caso, i grader, i risultati e l’utilizzo in CI.
Il target opzionale predefinito è la directory corrente e accetta uno di questi moduli:
  • Una directory plugin
  • Un singolo file prompt.md o case.yaml
  • Un plugin installato come name o name@marketplace
  • name@skills-dir
Metti il target prima di --tag, --allow-tools e --json. Ognuna di queste opzioni prende le parole che la seguono come suo valore, quindi un target scritto dopo una di esse viene letto come un tag, un nome di strumento o il percorso di output JSON invece che come target. Questa tabella elenca le opzioni che la maggior parte delle esecuzioni usa. Esegui claude plugin eval --help per l’insieme completo, inclusi --case, --tag, --output-dir, --report, --allow-real-servers, --keep-temp e --verbose. Il codice di uscita riporta come è terminata l’esecuzione. Per agire su di esso in una pipeline, vedi Esegui evals in CI.

​
plugin eval init

Crea una suite eval per il plugin nella directory corrente. Richiede Claude Code v2.1.269 o successivo. Vedi Crea la tua prima suite eval.
In un terminale, il comando apre una sessione Claude Code interattiva per un’intervista di authoring. Nell’intervista, Claude fa quanto segue:
  1. Legge il plugin
  2. Ti chiede cosa dovrebbe fare bene
  3. Propone casi e grader
  4. Scrive i file dei casi
  5. Esegue i casi e rivede i voti con te per verificare che i grader puntino come faresti tu
Con --bare, o senza un terminale, il comando scrive un template di caso singolo vuoto. Quando Claude esegue il comando dall’interno di una sessione Claude Code, il comando stampa le istruzioni dell’intervista per quella sessione da seguire piuttosto che scrivere un template. Il name opzionale è un nome di caso. È richiesto con --bare o senza un terminale, perché il comando scrive il template vuoto per quel caso. L’intervista non ne ha bisogno. Il comando accetta queste opzioni:

​
plugin tag

Crea un tag git annotato denominato <name>--v<version> per un rilascio di plugin. Prima di taggare, il comando controlla che il plugin.json del plugin e qualsiasi entry del marketplace che lo elenca siano d’accordo sulla versione. Per quando taggare un rilascio, vedi Pubblica un plugin.
Il [path] è la directory del plugin, predefinito alla directory corrente. Il comando trova l’entry del marketplace camminando su da quella directory a un .claude-plugin/marketplace.json che elenca il plugin. Anteprima il tag per un plugin in un checkout marketplace:
Claude Code stampa il piano:
  • Il nome del plugin
  • La versione e da quale file proviene
  • L’entry del marketplace corrispondente, quando ce n’è uno
  • Il nome del tag
  • I comandi git tag e git push che eseguirebbe
Senza --dry-run, Claude Code stampa Created tag formatter--v1.0.0 e sia Pushed to origin o il comando push da eseguire tu stesso. Se il push fallisce, il tag è ancora creato localmente e il comando esce con un errore. Il comando esce con 1 e stampa il motivo quando non può taggare in sicurezza. I motivi comuni sono:
  • Nessun version in plugin.json o nell’entry del marketplace
  • Il tag esiste già
  • L’albero di lavoro è sporco

​
plugin validate

Convalida un manifest plugin, un manifest marketplace, o le skills, gli agents e i comandi in una directory, ed esci con un codice su cui un lavoro CI può agire. Per il flusso di lavoro di creazione, test e modifica, vedi Crea un plugin. Per cosa il validatore controlla in ogni manifest, vedi il riferimento manifest plugin e il riferimento marketplace.
Convalida un plugin prima di eseguirne il commit:

​
Convalida una directory

Il <path> è un file manifest o una directory. Data una directory, Claude Code sceglie cosa convalidare da quello che trova lì:
  • .claude-plugin/marketplace.json, quando esiste
  • Altrimenti .claude-plugin/plugin.json
  • Altrimenti i file dei componenti, scelti dal nome della directory. La convalida dei file dei componenti senza un manifest richiede Claude Code v2.1.233 o successivo:
    • Una directory denominata skills, agents o commands: i file al suo interno
    • Una directory denominata .claude: le directory skills, agents e commands al suo interno
    • Qualsiasi altra directory: quelle tre directory sotto il suo .claude
Claude Code non segue i symlink all’interno della directory che nomini. Cosa fa dipende da dove si trova il link:
  • Una directory skills, agents o commands collegata sotto la root del plugin o .claude: Claude Code avverte che nulla in essa è stato letto.
  • Un’entry collegata all’interno di una directory skills, agents o commands: Claude Code la salta e avverte, per directory, quante entry ha saltato che una sessione caricherà.
  • La directory skills, agents o commands che nomini è essa stessa un symlink, o la sua directory padre .claude è: Claude Code riporta un errore e non controlla nulla in essa. Nomina la directory reale invece.
Alcuni file non vengono letti da un’esecuzione di convalida:
  • Un SKILL.md alla root del plugin: quando esegui claude plugin validate su una directory plugin, Claude Code non controlla un SKILL.md alla root del plugin
  • Un CLAUDE.md alla root del plugin: in un’esecuzione plugin, Claude Code avverte anche di un CLAUDE.md alla root del plugin
  • File plugin in un’esecuzione marketplace: da una directory marketplace, Claude Code non apre i file skill, agent, command o hook dei plugin. Per trovare errori in quei file, convalida ogni directory plugin

​
Output e codici di uscita

Claude Code stampa il file che ha convalidato, eventuali errori e avvertimenti con i loro percorsi, e una riga di verdetto. Il codice di uscita segue il verdetto: Con --json, Claude Code scrive il rapporto su stdout come un oggetto JSON con questi campi di livello superiore:
  • success: lo stesso verdetto che il codice di uscita fornisce
  • strict: se l’esecuzione ha trattato gli avvertimenti come errori
  • target: il percorso risolto che Claude Code ha convalidato
  • manifest: il risultato del manifest stesso, o null per un’esecuzione senza manifest
  • contents: risultati per file, ognuno nominando il suo file e portando array errors, warnings e notes
All’uscita 2, il comando non scrive nulla su stdout. Il messaggio di errore va su stderr.

​
Comandi claude plugin marketplace

Esegui claude plugin marketplace <subcommand> dalla tua shell per aggiungere, elencare, aggiornare e rimuovere i marketplace da cui installi i plugin. Per cosa è un marketplace e come Claude Code lo memorizza nella cache, vedi Riferimento caricamento plugin.

​
plugin marketplace add

Aggiungi un marketplace da un repository GitHub, un URL git, un marketplace.json ospitato o un percorso locale, e dichiaralo in un file di impostazioni. Dopo averlo aggiunto, Claude Code installa qualsiasi dipendenza che i tuoi plugin installati stavano perdendo.
<source> accetta uno qualsiasi dei moduli nella tabella sottostante, e il suo modulo decide il tipo di fonte e come Claude Code recupera il marketplace. Per l’oggetto source risultante, vedi il riferimento marketplace. Per un host i cui URL di clone non portano il suffisso .git, come AWS CodeCommit, aggiungi il marketplace come entry git in extraKnownMarketplaces. Claude Code clona un’entry git indipendentemente dal fatto che il suo URL termini in .git. Claude Code clona anche un URL gitlab.com con sottogruppi annidati, come https://gitlab.com/group/subgroup/project. Aggiungi un marketplace e condividilo con il progetto:
Claude Code stampa Successfully added marketplace: your-marketplace (declared in project settings), usando il name dal manifest del marketplace stesso. Un’aggiunta ripetuta o una fonte non valida stampa uno di questi risultati:
  • Marketplace già su disco: l’output è Marketplace 'your-marketplace' already on disk — declared in project settings e il codice di uscita è 0
  • Fonte non riconosciuta: l’output è Invalid marketplace source format. Try: owner/repo, https://..., or ./path e il codice di uscita è 1
  • Host semplice come gitlab.example.com/team/plugins: l’aggiunta fallisce come una scorciatoia owner/repo non valida, e il messaggio ti dice di aggiungere https:// o usare un percorso locale
Aggiungi un marketplace ospitato su claude.ai per il nome stampato nella sezione From claude.ai: di claude plugin marketplace list:
Con --claudeai, il comando rifiuta --scope e --sparse. Il marketplace è ospitato per il tuo account, non dichiarato in un file di impostazioni, quindi non puoi condividerlo attraverso il .claude/settings.json di un progetto.

​
plugin marketplace list

Elenca ogni marketplace che hai aggiunto, con la sua fonte.
Claude Code stampa Configured marketplaces: e una riga Source: per marketplace, o No marketplaces configured. Con --json, Claude Code stampa un array con un oggetto per marketplace, portando i campi sottostanti. Ogni campo è una stringa. Un marketplace claude.ai aggiunto non ha un clone locale, quindi la sua entry porta i suoi identificatori claude.ai, marketplaceId e organizationUuid, al posto di installLocation. Porta anche scope quando uno è registrato, e status. Se le tue sessioni di terminale sincronizzano i plugin dal tuo account claude.ai, l’elenco di testo termina con una sezione From claude.ai:. Quella sezione nomina i marketplace che claude.ai elenca per il tuo account che non hai aggiunto, sia basati su git che ospitati. Richiede Claude Code v2.1.273 o successivo. Per aggiungere un marketplace da quella sezione, vedi Aggiungi un marketplace da claude.ai. L’output --json copre solo i marketplace configurati e lascia la sezione fuori.

​
plugin marketplace remove

Rimuovi la dichiarazione di un marketplace dalle tue impostazioni. rm è un alias per remove.
Quando rimuovi un marketplace dall’ultimo ambito che lo dichiara, Claude Code elimina anche la sua cache e disinstalla ogni plugin che hai installato da esso. Senza --scope, il comando rimuove la dichiarazione da ogni ambito. Per aggiornare un marketplace senza perdere i suoi plugin, esegui plugin marketplace update.
Il <name> è il nome del marketplace che plugin marketplace list mostra, non la fonte che hai passato a add. Rimuovi un marketplace da ogni ambito:
Claude Code stampa Successfully removed marketplace: your-marketplace, aggiungendo (from project settings) quando lo hai scoped. Se scopi a un file di impostazioni che non dichiara il marketplace, il comando fallisce con Marketplace 'your-marketplace' is not declared in project settings. Omit --scope to remove it from all scopes.

​
plugin marketplace update

Aggiorna un marketplace, o ogni marketplace, dalla sua fonte per recuperare nuovi plugin e versioni. Un marketplace aggiunto con un ramo o tag ref si aggiorna al commit più recente di quel ref, non al ramo predefinito del repository.
Il comando non accetta flag oltre a --help. Aggiorna un marketplace:
Claude Code stampa Successfully updated marketplace: your-marketplace. Quando ometti il nome, stampa un conteggio come Successfully updated 2 marketplaces. Senza marketplace aggiunti, stampa No marketplaces configured ed esce con 0.

​
/plugin in una sessione

All’interno di una sessione interattiva, /plugin apre il pannello plugin. Ogni sottocomando apre il pannello su una scheda, esegue un’azione lì, o stampa un risultato inline. /plugins e /marketplace sono alias per /plugin. Puoi eseguire questi comandi solo in una sessione di terminale interattiva. In un’esecuzione non interattiva come claude -p, Claude Code risponde che /plugin non è disponibile in questo ambiente. Per quali superfici hanno /plugin, come installare senza di esso, e cosa mostra ogni scheda del pannello, vedi Installa e gestisci i plugin. Un <plugin> è un plugin name o name@marketplace. La tabella sottostante elenca ogni forma di sessione. I sottocomandi shell init, update, details, prune, eval e eval init non hanno una forma di sessione. Se nomini un plugin che non è installato nel progetto corrente in /plugin enable, disable, uninstall o configure, Claude Code stampa Plugin "<plugin>" is not installed in this project invece di agire.

​
/reload-plugins

Applica le modifiche ai plugin in sospeso alla sessione in esecuzione senza riavviarla. Le modifiche in sospeso sono plugin che hai installato, aggiornato, abilitato, disabilitato o modificato su disco da quando la sessione è iniziata. Quando chiudi il pannello /plugin con modifiche in sospeso che hai fatto in esso, Claude Code esegue /reload-plugins per te. Eseguilo tu stesso dopo le modifiche ai plugin che accadono al di fuori del pannello, come un comando claude plugin che hai eseguito in un altro terminale.

​
Riepilogo ricaricamento

Claude Code ricarica ogni plugin attivo e stampa una riga di riepilogo, Reloaded: N plugins · N skills · N agents · N hooks · N plugin MCP servers · N plugin LSP servers, omettendo il conteggio del server MCP del plugin in una sessione senza un terminale interattivo. Quando un plugin qualsiasi ha fallito, il riepilogo aggiunge N errors during load. Run /plugin for details. Il conteggio delle skills copre ogni skill che un plugin fornisce, sia le sue entry commands/ che le skills SKILL.md. Il conteggio degli agents è il numero di agent caricati nella sessione, inclusi quelli che non provengono da plugin. Quando le dipendenze di un plugin ricaricato sono mancanti, Claude Code le installa, ricarica di nuovo, e aggiunge (+ N dependencies: <names>) resolved al riepilogo.

​
Ricaricamenti che cambiano gli strumenti MCP

Quando il ricaricamento aggiungerebbe o rimuoverebbe un server MCP del plugin o lo strumento LSP, e quel cambiamento invaliderebbe la cache del prompt, Claude Code non applica il ricaricamento. Stampa una riga come This reload changes MCP tools (<server>) — your next message will re-read the whole conversation instead of using the cache. Run /reload-plugins --force to apply. Passa --force per applicarlo comunque.

​
Sessioni senza un terminale interattivo

/reload-plugins viene eseguito anche in sessioni senza un terminale interattivo, come l’app desktop, l’Agent SDK e la modalità non interattiva con -p. Richiede Claude Code v2.1.260 o successivo. In quelle sessioni, il comando viene eseguito solo quando lo digiti nella sessione tu stesso, come nel prompt -p o nella casella del prompt dell’app desktop. Quando arriva in un altro modo, come attraverso Remote Control o un messaggio inoltrato da Slack, il comando risponde /reload-plugins isn't available over a remote connection in this session. e non ricarica nulla. Il ricaricamento in quelle sessioni non connette o disconnette i server MCP del plugin. Quei cambiamenti hanno effetto nella tua prossima sessione.

​
Flag che caricano un plugin per una sola sessione

Due flag claude caricano un plugin per una sola sessione, senza installarlo. Entrambi sono ripetibili. Gli autori di plugin li usano per testare un plugin prima di pubblicarlo. Per il flusso di lavoro carica-modifica-ricarica, vedi Sviluppa senza un marketplace. Un plugin che uno di questi flag carica è un plugin solo sessione. claude plugin list lo mostra come <name>@inline con ambito session, ma solo quando lo stesso flag precede il sottocomando. Ad esempio, esegui claude --plugin-dir ./my-plugin plugin list. Quando un plugin solo sessione condivide un nome con un plugin installato, Claude Code carica la copia solo sessione per quella sessione e salta quella installata. La copia installata si carica invece se hai disabilitato la copia solo sessione con claude plugin disable <name>@inline, o se le impostazioni gestite bloccano quel nome di plugin. Per la precedenza, vedi Riferimento caricamento plugin. Un amministratore può rifiutare entrambi i flag, e le cartelle nominate nella variabile CLAUDE_CODE_PLUGIN_DIRS, con l’impostazione gestita disableSideloadFlags. Claude Code stampa che il flag è disabilitato dalle impostazioni gestite della tua organizzazione ed esce con 1 senza avviare. Dall’Agent SDK, l’opzione plugins è l’equivalente di --plugin-dir.

​
Passaggi successivi