# Claude Code : reconfigurer un plugin avec plugin configure

> Claude Code 2.1.285 a introduit la commande claude plugin configure. Découvrez comment vérifier les paramètres d’un plugin dans la documentation et modifier un jeton ou une adresse sans réinstaller le plugin.

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


<div class="aside" data-semantic="key-takeaway" role="note" aria-label="À retenir dans cette section">

À retenir

Claude Code 2.1.285 a introduit la commande de terminal `claude plugin configure <plugin>`. Sans option, elle indique quels paramètres du plugin sont définis et lesquels ne le sont pas, sans afficher leurs valeurs. Avec `--values-stdin`, elle enregistre de nouvelles valeurs provenant d’un fichier JSON fourni en entrée, sans réinstaller le plugin. Les valeurs ordinaires sont stockées dans `settings.json` sous `pluginConfigs`, tandis que les valeurs des champs marqués `sensitive: true` sont stockées dans le gestionnaire sécurisé des identifiants du système.

</div>

Ce guide s’adresse aux personnes qui ont déjà installé un plugin Claude Code déclarant des paramètres `userConfig`, comme une adresse, un jeton ou un chemin de dossier. Vous devez corriger une valeur saisie par erreur ou remplacer un jeton sans réinstaller le plugin. Tout ce qui suit s’appuie sur la documentation et le journal des modifications officiels de Claude Code. L’article ne comprend pas de test effectué par l’auteur.

Vous trouverez des informations sur l’utilisation d’Ailoot dans la [documentation](https://ailoot.ai/docs/).



## Nouveautés de la version 2.1.285

L’entrée du journal des modifications de Claude Code pour la version 2.1.285 (un commit daté du 29 septembre 2026) comporte plusieurs lignes sur les plugins. Deux d’entre elles sont pertinentes pour cet article :

> Ajout de `claude plugin configure <plugin>` pour afficher les options d’un plugin et celles qui ne sont pas définies, ou enregistrer de nouvelles valeurs lues depuis stdin avec `--values-stdin`

Cela signifie que la nouvelle commande `claude plugin configure <plugin>` affiche les paramètres d’un plugin et ceux qui ne sont pas définis, ou enregistre de nouvelles valeurs lues depuis l’entrée standard lorsqu’elle est utilisée avec `--values-stdin`.

> Ajout de `<server>.<key>=<value>` à `claude plugin install --config`, afin de définir à l’installation les paramètres propres à un serveur MCP intégré dans un fichier `.mcpb` et de le démarrer sans passer par `/plugin` → Configure

Cela signifie que `claude plugin install --config` prend désormais en charge le format `<server>.<key>=<value>`. Les paramètres d’un serveur MCP fourni avec un plugin dans un fichier `.mcpb` peuvent ainsi être renseignés lors de l’installation, et le serveur peut démarrer sans passer par `/plugin` → Configure.

La référence des commandes confirme la version requise : `claude plugin configure` nécessite Claude Code v2.1.285 ou une version ultérieure. Cette commande n’existe pas dans les versions précédentes.

## Différence avec /plugin configure

La commande `/plugin configure <plugin>` (avec l’alias `config`) était déjà disponible dans une session interactive Claude Code. Elle ouvre une boîte de dialogue pour les paramètres `userConfig` et nécessite la version v2.1.147 ou une version ultérieure. Cependant, `/plugin` fonctionne uniquement dans une session interactive : lors d’un appel non interactif tel que `claude -p`, Claude Code indique que `/plugin` n’est pas disponible dans cet environnement.

D’après la documentation, les commandes `claude plugin` s’exécutent depuis un shell ou un script, en dehors d’une session Claude Code. Vous pouvez ainsi lancer `claude plugin configure` sans ouvrir de boîte de dialogue. La documentation ne précise pas le comportement de cette commande sans terminal interactif ni l’endroit où elle stocke les valeurs secrètes sur un serveur sans environnement graphique. Vérifiez ces points dans votre environnement avant de l’utiliser en CI.





## Étape 1. Voir quels paramètres sont définis

La documentation exige l’identifiant complet du plugin au format `name@marketplace`, tel qu’affiché par `claude plugin list`. La commande `configure` n’accepte pas un nom sans `@marketplace`.

```bash
claude plugin list
claude plugin configure formatter@my-marketplace
```

Remplacez `formatter@my-marketplace` par l’identifiant de votre plugin. Sans option, la commande répertorie chaque paramètre avec les étiquettes suivantes : `required` ou `optional`, puis `sensitive` pour un champ secret, et enfin `set` ou `not set`. Elle n’affiche pas les valeurs enregistrées.

Si vous avez besoin d’une sortie lisible par machine, ajoutez `--json`. La sortie inclura alors les valeurs enregistrées des champs ordinaires, mais le contenu d’un champ secret ne sera jamais affiché.

## Étape 2. Modifier une valeur à l’aide d’un fichier

Les valeurs sont fournies sous la forme d’un objet JSON, où chaque clé est le nom d’un paramètre du manifeste et chaque valeur est une chaîne sans saut de ligne. La documentation présente une méthode avec un fichier : écrivez l’objet dans `values.json` et transmettez ce fichier à la commande via son entrée standard. Ici, `api_url` est la clé utilisée dans l’exemple de la documentation. Pour votre propre plugin, utilisez le nom du paramètre requis, indiqué dans son manifeste ou dans la sortie de l’étape 1.

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

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

Les règles suivantes s’appliquent lors de l’enregistrement :

- Les paramètres omis dans le JSON conservent leurs valeurs précédentes. Vous pouvez ne fournir que le champ que vous modifiez.
- La description de l’option fait référence aux valeurs des paramètres en général et ne précise pas de règle distincte pour les champs secrets. Après l’enregistrement, utilisez l’étape 1 pour vérifier que le champ concerné est marqué `set`.
- Claude Code vérifie chaque valeur en fonction du type déclaré et affiche `Configuration saved. Restart Claude Code to apply it.` Cela signifie que le paramètre a été enregistré et prendra effet après le redémarrage de Claude Code.
- Si le JSON contient une clé non déclarée dans le manifeste, ou si une valeur échoue à la validation, la commande n’enregistre rien, affiche `Failed to save configuration:` suivi du motif, puis se termine avec le code `1`.

Si vous écrivez un jeton dans `values.json`, gardez à l’esprit qu’il s’agit d’un fichier ordinaire sur le disque. Supprimez-le après avoir enregistré la configuration et ne l’ajoutez pas au dépôt.

## Où Claude Code stocke-t-il la configuration d’un plugin ?

D’après la documentation du manifeste de plugin, les valeurs ordinaires sont enregistrées sous `pluginConfigs` dans le fichier `settings.json` de l’utilisateur. Les valeurs des champs marqués `sensitive: true` sont stockées dans le gestionnaire sécurisé des identifiants du système au lieu de `settings.json` ; la saisie de ces champs est masquée.

Il est inutile de chercher la valeur d’un champ secret dans `settings.json`. `claude plugin configure` affiche son statut à l’aide des étiquettes `sensitive` et `set` ou `not set`.

## install --config : définir une valeur à l’installation

Pour une nouvelle installation, `claude plugin install` propose l’option `--config <key=value>`. Elle définit un paramètre `userConfig` déclaré dans le manifeste et nécessite la version v2.1.147 ou une version ultérieure. Répétez l’option pour chaque paramètre. À partir de la version 2.1.285, une clé au format `<server>.<key>` définit un paramètre du serveur MCP intégré, déclaré dans son propre `user_config`.

Dans l’exemple ci-dessous, remplacez `formatter@my-marketplace` par l’identifiant de votre plugin, `api_url` par le nom du paramètre indiqué dans son manifeste, et l’intégralité du texte de remplacement `NEW_ADDRESS` par votre propre valeur. Conservez les guillemets autour de l’argument.

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

La commande à utiliser dépend de l’installation du plugin : `install --config` définit les valeurs lors de la première installation, tandis que `plugin configure --values-stdin` modifie les valeurs d’un plugin déjà installé.

Pour les paramètres d’un serveur MCP intégré, la documentation indique d’autres méthodes : `plugin install --config` ou **Configure** dans `/plugin`. Elle ne recommande pas la commande `plugin configure` pour ces paramètres.

## Si la commande ne trouve pas le plugin

Si `claude plugin configure` ne trouve pas de plugin chargé correspondant à cet identifiant, elle affiche `No installed plugin has the id "<plugin>".` et se termine avec le code `1`. Vérifiez d’abord que vous avez fourni l’identifiant complet au format `name@marketplace` obtenu avec `claude plugin list`. Le nom du plugin seul ne suffit pas.

La commande utilisée dans la session affiche son propre message. Si vous indiquez un plugin qui n’est pas installé dans le projet actuel avec `/plugin enable`, `disable`, `uninstall` ou `configure`, Claude Code affiche `Plugin "<plugin>" is not installed in this project` et ne fait rien.

## Conclusion

Pour modifier le jeton ou l’adresse d’un plugin déjà installé dans Claude Code 2.1.285 ou une version ultérieure, trouvez son identifiant avec `claude plugin list`, vérifiez le statut des paramètres avec `claude plugin configure`, transmettez la nouvelle valeur depuis un fichier avec `--values-stdin`, puis redémarrez Claude Code. Les valeurs des champs secrets ne sont pas stockées dans `settings.json` ; vérifiez donc leur statut avec la même commande.

Le guide sur les [Skills, Subagents, MCP et Plugins dans Claude Code](https://ailoot.ai/blog/fr/skills-subagents-mcp-plugins-claude-code/) peut vous aider à choisir entre les types d’extensions. Si vous n’avez pas encore choisi de plugin, vous pouvez commencer par les 10 meilleurs plugins Claude Code. Un guide distinct concerne les bots Telegram : [installer un plugin dans un agent Telegram](https://ailoot.ai/blog/fr/telegram-ai-agent-plugins/) fonctionne différemment de l’installation dans Claude Code.

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

### Sources

- [Claude Code CHANGELOG, entrée 2.1.285](https://github.com/anthropics/claude-code/commit/ec44ca97dc86c33d934c8d55b24959aabf076871.patch)
- [Claude Code : référence des commandes de plugin](https://code.claude.com/docs/en/plugins/cli-reference.md)
- [Claude Code : référence du manifeste de plugin, configuration utilisateur](https://code.claude.com/docs/en/plugins-reference.md)

</div>





Découvrez [Ailoot](https://ailoot.ai/).

## Questions fréquentes : Claude Code : reconfigurer un plugin avec plugin configure

### Pourquoi configure ne trouve-t-il pas mon plugin installé ?

Utilisez l’identifiant complet name@marketplace de claude plugin list et vérifiez sa portée d’installation. Le nom court seul n’est pas accepté par cette commande.

### Comment vérifier un jeton modifié sans l’afficher ?

Lancez claude plugin configure avec l’identifiant complet et vérifiez que le champ sensible est marqué comme défini. Redémarrez Claude Code après sauvegarde ; ne commitez pas le JSON d’entrée contenant le jeton.


## Ailoot · L’entreprise et son portefeuille de projets

Ailoot s’appuie sur une expérience opérationnelle éprouvée, une large clientèle, un service stable et un suivi continu des KPI.

L’entreprise et son portefeuille de projets : des millions de clients ; des ventes qui se chiffrent en milliards chaque mois.

Ailoot met cette expérience opérationnelle au service de l’accès API aux fonctions d’IA dans les produits des clients, leurs agents, applications et automatisations.