Claude Code: plugininstellingen wijzigen zonder herinstallatie

Deze handleiding is bedoeld voor gebruikers die al een Claude Code-plugin hebben geïnstalleerd die userConfig-instellingen declareert, zoals een adres, een token of een mappad. Je moet een onjuist ingevoerde waarde corrigeren of een token vervangen zonder de plugin opnieuw te installeren. Alles hieronder is gebaseerd op de officiële Claude Code-documentatie en het wijzigingslogboek. Dit artikel bevat geen oorspronkelijke testuitvoering.

Informatie over het gebruik van Ailoot vind je in de documentatie.

Wat versie 2.1.285 heeft toegevoegd#

De vermelding voor versie 2.1.285 in het Claude Code-wijzigingslogboek (een commit van 29 september 2026) bevat verschillende regels over plugins. Twee daarvan zijn relevant voor dit artikel:

claude plugin configure <plugin> toegevoegd om de opties van een plugin en de niet-ingestelde opties weer te geven, of om nieuwe waarden op te slaan die met --values-stdin uit stdin zijn gelezen

Dit betekent dat het nieuwe commando claude plugin configure <plugin> de instellingen van een plugin toont en welke daarvan niet zijn ingesteld, of nieuwe waarden opslaat die uit standaardinvoer zijn gelezen wanneer het met --values-stdin wordt gebruikt.

<server>.<key>=<value> toegevoegd aan claude plugin install --config, zodat de eigen instellingen van een meegeleverde .mcpb MCP-server tijdens de installatie kunnen worden ingesteld en de server start zonder /plugin → Configure te openen

Dit betekent dat claude plugin install --config nu de vorm <server>.<key>=<value> ondersteunt. Daarmee kunnen de instellingen van een MCP-server die met een plugin in een .mcpb-bestand is meegeleverd tijdens de installatie worden opgegeven, zodat de server start zonder /plugin → Configure te openen.

De commandoverwijzing bevestigt de versievereiste: claude plugin configure vereist Claude Code v2.1.285 of hoger. In eerdere versies bestaat dit commando niet.

Hoe dit verschilt van /plugin configure#

Het commando /plugin configure <plugin> (met de alias config) was al beschikbaar in een interactieve Claude Code-sessie. Het opent een dialoogvenster voor userConfig-instellingen en vereist v2.1.147 of hoger. /plugin werkt echter alleen in een interactieve sessie: bij een niet-interactieve aanroep zoals claude -p meldt Claude Code dat /plugin niet beschikbaar is in die omgeving.

Volgens de documentatie voer je claude plugin-commando's uit vanuit een shell of script, buiten een Claude Code-sessie. Zo kun je claude plugin configure ook uitvoeren zonder een dialoogvenster te openen. De documentatie beschrijft niet hoe dit commando zich gedraagt zonder een interactieve terminal, of waar het geheime waarden opslaat op een server zonder grafische omgeving. Controleer dit in je eigen omgeving voordat je het in CI gebruikt.

Stap 1. Bekijk welke instellingen zijn ingesteld#

De documentatie vereist de volledige plugin-ID in de vorm name@marketplace, zoals weergegeven door claude plugin list. Het commando configure accepteert geen naam zonder @marketplace.

claude plugin list
claude plugin configure formatter@my-marketplace

Vervang formatter@my-marketplace door de ID van je plugin. Zonder vlaggen geeft het commando voor elke instelling labels weer: required of optional, vervolgens sensitive voor een geheim veld, gevolgd door set of not set. De opgeslagen waarden worden niet weergegeven.

Voeg --json toe als je machineleesbare uitvoer nodig hebt. De uitvoer bevat dan opgeslagen waarden voor gewone velden, maar de inhoud van een geheim veld wordt nooit weergegeven.

Stap 2. Wijzig een waarde met een bestand#

Waarden worden aangeleverd als een JSON-object, waarbij elke sleutel een instellingsnaam uit het manifest is en elke waarde een tekenreeks zonder regeleinden. De documentatie beschrijft een methode met een bestand: schrijf het object naar values.json en geef dat bestand via standaardinvoer door aan het commando. Hier is api_url de sleutel die in het documentatievoorbeeld wordt gebruikt. Gebruik voor je eigen plugin de naam van de instelling die je nodig hebt uit het manifest of uit de uitvoer van stap 1.

{"api_url": "NEW_ADDRESS"}

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

Bij het opslaan gelden de volgende regels:

• Instellingen die ontbreken in de JSON behouden hun vorige waarden. Je kunt alleen het veld opgeven dat je wijzigt.
• De beschrijving van de vlag verwijst in het algemeen naar het instellen van waarden en vermeldt geen afzonderlijke regel voor geheime velden. Controleer na het opslaan met stap 1 of het betreffende veld de status set heeft.
• Claude Code controleert elke waarde aan de hand van het gedeclareerde type en geeft Configuration saved. Restart Claude Code to apply it. weer. Dit betekent dat de instelling is opgeslagen en van kracht wordt nadat Claude Code opnieuw is gestart.
• Als de JSON een sleutel bevat die niet in het manifest is gedeclareerd, of als een waarde de validatie niet doorstaat, slaat het commando niets op, geeft het Failed to save configuration: weer, gevolgd door de reden, en wordt het afgesloten met code 1.

Als je een token naar values.json schrijft, onthoud dan dat dit een gewoon bestand op schijf is. Verwijder het nadat de configuratie is opgeslagen en voeg zo'n bestand niet toe aan de repository.

Waar de waarde wordt opgeslagen#

Volgens de documentatie over het pluginmanifest worden gewone waarden opgeslagen onder pluginConfigs in het settings.json-bestand van de gebruiker. Waarden voor velden met sensitive: true worden in de beveiligde referentieopslag van het systeem opgeslagen in plaats van in settings.json; invoer voor deze velden wordt gemaskeerd.

Het heeft geen zin om in settings.json naar de waarde van een geheim veld te zoeken. claude plugin configure toont de status ervan met de labels sensitive en set of not set.

install --config: stel een waarde in tijdens de installatie#

Voor een nieuwe installatie biedt claude plugin install de vlag --config <key=value>. Deze stelt een userConfig-instelling in die in het manifest is gedeclareerd en vereist v2.1.147 of hoger. Herhaal de vlag voor elke instelling. Vanaf versie 2.1.285 stelt een sleutel in de vorm <server>.<key> een instelling in van een meegeleverde MCP-server die in de eigen user_config van die server is gedeclareerd.

Vervang in het onderstaande voorbeeld formatter@my-marketplace door de ID van je plugin, api_url door de instellingsnaam uit het manifest en de volledige tijdelijke aanduiding NEW_ADDRESS door je eigen waarde. Behoud de aanhalingstekens rond het argument.

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

Welk commando je gebruikt, hangt ervan af of de plugin al is geïnstalleerd: install --config stelt waarden in tijdens de eerste installatie, terwijl plugin configure --values-stdin waarden wijzigt voor een al geïnstalleerde plugin.

Voor instellingen van een meegeleverde MCP-server vermeldt de documentatie andere methoden: plugin install --config of Configure in /plugin. De documentatie beveelt het commando plugin configure niet aan voor die instellingen.

Als het commando de plugin niet kan vinden#

Als claude plugin configure geen geladen plugin met die ID kan vinden, geeft het No installed plugin has the id "<plugin>". weer en wordt het afgesloten met code 1. Controleer eerst of je de volledige name@marketplace-ID uit claude plugin list hebt opgegeven. Alleen de pluginnaam is niet voldoende.

Het commando in de sessie heeft een eigen melding. Als je een plugin noemt die niet in het huidige project is geïnstalleerd wanneer je /plugin enable, disable, uninstall of configure gebruikt, geeft Claude Code Plugin "<plugin>" is not installed in this project weer en doet het niets.

Conclusie#

Als je een token of adres wilt wijzigen voor een plugin die al is geïnstalleerd in Claude Code 2.1.285 of hoger, zoek je de ID op met claude plugin list, controleer je de status van de instellingen met claude plugin configure, lever je de nieuwe waarde aan vanuit een bestand met --values-stdin en start je Claude Code opnieuw. Geheime veldwaarden worden niet in settings.json opgeslagen, dus controleer hun status met hetzelfde commando.

De handleiding over Skills, Subagents, MCP en Plugins in Claude Code kan je helpen kiezen tussen extensietypen. Als je nog geen plugin hebt gekozen, kun je beginnen met de top 10 Claude Code-plugins. Voor een Telegram-bot is er een aparte handleiding: een plugin installeren in een Telegram-agent werkt anders dan een plugin installeren in Claude Code.

Maak kennis met Ailoot.