Claude Code: configurare i plugin senza reinstallarli

Questa guida è rivolta a chi ha già installato un plugin di Claude Code che dichiara impostazioni userConfig, come un indirizzo, un token o il percorso di una cartella. Potresti dover correggere un valore inserito in modo errato o sostituire un token senza reinstallare il plugin. Tutte le informazioni che seguono si basano sulla documentazione ufficiale e sul changelog di Claude Code. L'articolo non include i risultati di una prova originale.

Le informazioni sull'uso di Ailoot sono disponibili nella documentazione.

Novità della versione 2.1.285#

La voce del changelog di Claude Code per la versione 2.1.285 (un commit datato 29 September 2026) contiene diverse righe sui plugin. Due sono pertinenti a questo articolo:

Added claude plugin configure <plugin> to show a plugin's options and which are unset, or save new values read from stdin with --values-stdin

Ciò significa che il nuovo comando claude plugin configure <plugin> mostra le impostazioni di un plugin e indica quali non sono configurate, oppure salva nuovi valori letti dallo standard input se usato con --values-stdin.

Added <server>.<key>=<value> to claude plugin install --config, so a bundled .mcpb MCP server's own settings can be set at install time and it starts without visiting /plugin → Configure

Ciò significa che claude plugin install --config ora supporta il formato <server>.<key>=<value>, che consente di fornire durante l'installazione le impostazioni di un server MCP incluso in un plugin in un file .mcpb, così che il server si avvii senza passare da /plugin → Configure.

La documentazione dei comandi conferma il requisito di versione: claude plugin configure richiede Claude Code v2.1.285 o successivo. Il comando non è disponibile nelle versioni precedenti.

Differenze rispetto a /plugin configure#

Il comando /plugin configure <plugin> (con l'alias config) era già disponibile all'interno di una sessione interattiva di Claude Code. Apre una finestra di dialogo per le impostazioni userConfig e richiede la versione v2.1.147 o successiva. Tuttavia, /plugin funziona solo in una sessione interattiva: in un'invocazione non interattiva, come claude -p, Claude Code risponde che /plugin non è disponibile in quell'ambiente.

Secondo la documentazione, i comandi claude plugin si eseguono da una shell o da uno script, al di fuori di una sessione di Claude Code. Questo permette anche di eseguire claude plugin configure senza aprire una finestra di dialogo. La documentazione non descrive come si comporta questo comando senza un terminale interattivo né dove salva i valori segreti su un server privo di ambiente grafico. Verifica il comportamento nel tuo ambiente prima di usarlo in CI.

Passaggio 1. Verificare quali impostazioni sono configurate#

La documentazione richiede l'identificatore completo del plugin nel formato name@marketplace, come mostrato da claude plugin list. Il comando configure non accetta un nome senza @marketplace.

claude plugin list
claude plugin configure formatter@my-marketplace

Sostituisci formatter@my-marketplace con l'identificatore del tuo plugin. Senza flag, il comando elenca ogni impostazione con le etichette required o optional, poi sensitive per un campo segreto, seguite da set o not set. Non stampa i valori salvati.

Se ti serve un output leggibile da una macchina, aggiungi --json. L'output includerà i valori salvati per i campi ordinari, ma il contenuto di un campo segreto non viene mai stampato.

Passaggio 2. Modificare un valore usando un file#

I valori vengono forniti come oggetto JSON, in cui ogni chiave è il nome di un'impostazione del manifest e ogni valore è una stringa senza interruzioni di riga. La documentazione mostra un metodo basato su file: scrivi l'oggetto in values.json e passa il file allo standard input del comando. Qui, api_url è la chiave usata nell'esempio della documentazione. Per il tuo plugin, usa il nome dell'impostazione che ti serve, indicato nel manifest o nell'output del passaggio 1.

{"api_url": "NEW_ADDRESS"}

claude plugin configure formatter@my-marketplace --values-stdin < values.json

Quando salvi, si applicano le regole seguenti:

• Le impostazioni omesse dal JSON mantengono i valori precedenti. Puoi fornire solo il campo che stai modificando.
• La descrizione del flag si riferisce in generale all'impostazione dei valori e non specifica una regola distinta per i campi segreti. Dopo il salvataggio, usa il passaggio 1 per verificare che il campo pertinente risulti set.
• Claude Code controlla ogni valore rispetto al tipo dichiarato e stampa Configuration saved. Restart Claude Code to apply it. Ciò significa che l'impostazione è stata salvata e avrà effetto dopo il riavvio di Claude Code.
• Se il JSON contiene una chiave non dichiarata nel manifest o un valore che non supera la convalida, il comando non salva nulla, stampa Failed to save configuration: seguito dal motivo e termina con il codice 1.

Se scrivi un token in values.json, ricorda che si tratta di un normale file su disco. Eliminalo dopo aver salvato la configurazione e non aggiungere un file del genere al repository.

Dove viene salvato il valore#

Secondo la documentazione del manifest dei plugin, i valori ordinari vengono salvati sotto pluginConfigs nel file settings.json dell'utente. I valori dei campi contrassegnati con sensitive: true vengono invece salvati nell'archivio credenziali sicuro del sistema, non in settings.json; l'input per questi campi viene mascherato.

Non serve cercare in settings.json il valore di un campo segreto. claude plugin configure ne mostra lo stato con le etichette sensitive e set o not set.

install --config: impostare un valore durante l'installazione#

Per una nuova installazione, claude plugin install offre il flag --config <key=value>. Imposta un valore userConfig dichiarato nel manifest e richiede la versione v2.1.147 o successiva. Ripeti il flag per ogni impostazione. Dalla versione 2.1.285, una chiave nel formato <server>.<key> imposta un valore del server MCP incluso, dichiarato nel user_config specifico del server.

Nell'esempio seguente, sostituisci formatter@my-marketplace con l'identificatore del tuo plugin, api_url con il nome dell'impostazione nel manifest e l'intero segnaposto NEW_ADDRESS con il tuo valore. Mantieni le virgolette intorno all'argomento.

claude plugin install formatter@my-marketplace --config 'api_url=NEW_ADDRESS'

Il comando da usare dipende dal fatto che il plugin sia già installato: install --config imposta i valori durante la prima installazione, mentre plugin configure --values-stdin modifica i valori di un plugin già installato.

Per le impostazioni di un server MCP incluso, la documentazione indica altri metodi: plugin install --config oppure Configure in /plugin. Non suggerisce il comando plugin configure per queste impostazioni.

Se il comando non trova il plugin#

Se claude plugin configure non trova un plugin caricato con quell'identificatore, stampa No installed plugin has the id "<plugin>". e termina con il codice 1. Per prima cosa verifica di aver fornito l'identificatore completo name@marketplace riportato da claude plugin list. Il solo nome del plugin non basta.

Il comando all'interno della sessione mostra un messaggio diverso. Se indichi un plugin che non è installato nel progetto corrente quando usi /plugin enable, disable, uninstall o configure, Claude Code stampa Plugin "<plugin>" is not installed in this project e non esegue alcuna operazione.

Conclusione#

Per modificare un token o un indirizzo di un plugin già installato in Claude Code 2.1.285 o successivo, trova il suo identificatore con claude plugin list, controlla lo stato delle impostazioni con claude plugin configure, fornisci il nuovo valore da un file con --values-stdin e riavvia Claude Code. I valori dei campi segreti non vengono salvati in settings.json, quindi verificane lo stato usando lo stesso comando.

La guida a Skills, Subagents, MCP e Plugins in Claude Code può aiutarti a scegliere tra i tipi di estensione. Se non hai ancora scelto un plugin, puoi partire dai 10 migliori plugin per Claude Code. Esiste una guida separata per un bot Telegram: installare un plugin in un agente Telegram funziona in modo diverso dall'installazione in Claude Code.

Scopri Ailoot.