Claude Code : reconfigurer un plugin avec plugin configure

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.

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.

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.

{"api_url": "NEW_ADDRESS"}

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.

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 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 fonctionne différemment de l’installation dans Claude Code.

Découvrez Ailoot.