# Claude Code: configurare i plugin senza reinstallarli

> Claude Code 2.1.285 ha introdotto il comando claude plugin configure. Come controllare le impostazioni dei plugin nella documentazione e modificare un token o un indirizzo senza reinstallare.

Source: https://ailoot.ai/blog/it/claude-code-plugin-configure-2-1-285/
Canonical: https://ailoot.ai/blog/it/claude-code-plugin-configure-2-1-285/
Language: it
Publisher: Ailoot (https://ailoot.ai/)
Translation: guide-050
Revision: sha256-8c231482d9691ac8ca14e417efc2c6708453e0672018d61c74e05f4c2fcf2dc6


<div class="aside" data-semantic="key-takeaway" role="note" aria-label="Punto chiave di questa sezione">

Punto chiave

Claude Code 2.1.285 ha introdotto il comando da terminale `claude plugin configure <plugin>`. Senza flag, mostra quali impostazioni del plugin sono configurate e quali non lo sono, senza stamparne i valori. Con `--values-stdin`, salva nuovi valori da un file JSON fornito come input, senza reinstallare il plugin. I valori ordinari vengono salvati in `settings.json` sotto `pluginConfigs`, mentre i valori dei campi contrassegnati con `sensitive: true` vengono salvati nell'archivio credenziali sicuro del sistema.

</div>

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](https://ailoot.ai/docs/).



## 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`.

```bash
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.

```json
{"api_url": "NEW_ADDRESS"}
```

```bash
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.

```bash
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](https://ailoot.ai/blog/it/skills-subagents-mcp-plugins-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](https://ailoot.ai/blog/it/telegram-ai-agent-plugins/) funziona in modo diverso dall'installazione in Claude Code.

<div class="section" role="doc-bibliography" aria-label="Fonti">

### Fonti

- [Claude Code CHANGELOG, voce 2.1.285](https://github.com/anthropics/claude-code/commit/ec44ca97dc86c33d934c8d55b24959aabf076871.patch)
- [Claude Code: riferimento ai comandi dei plugin](https://code.claude.com/docs/en/plugins/cli-reference.md)
- [Claude Code: riferimento al manifest dei plugin, configurazione utente](https://code.claude.com/docs/en/plugins-reference.md)

</div>





Scopri [Ailoot](https://ailoot.ai/).

## Domande frequenti

### Perché configure dice che il plugin installato non esiste?

Usa l’identificativo completo name@marketplace restituito da `claude plugin list` e verifica che il plugin sia installato nell’ambito pertinente. Questo comando non accetta il solo nome breve del plugin.

### Come controllo un token modificato senza stamparlo?

Esegui `claude plugin configure` con l’identificativo completo del plugin e verifica che il campo sensibile risulti impostato. Riavvia Claude Code dopo il salvataggio; non inserire in un commit il file JSON di input contenente il token.


## Ailoot · L’azienda e il suo portafoglio di progetti

Ailoot si basa su un’esperienza operativa consolidata, un’ampia base di clienti, un servizio stabile e un controllo costante dei KPI.

L’azienda e il suo portafoglio di progetti: milioni di clienti; vendite nell’ordine dei miliardi ogni mese.

Ailoot mette questa esperienza operativa al servizio dell’accesso API alle funzioni AI nei prodotti dei clienti, negli agenti, nelle applicazioni e nelle automazioni.