# Claude Code: plugininstellingen wijzigen zonder herinstallatie

> Claude Code 2.1.285 introduceerde het commando claude plugin configure. Zo controleer je plugininstellingen in de documentatie en wijzig je een token of adres zonder opnieuw te installeren.

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


<div class="aside" data-semantic="key-takeaway" role="note" aria-label="Key takeaway for this section">

Belangrijkste punt

Claude Code 2.1.285 introduceerde het terminalcommando `claude plugin configure <plugin>`. Zonder vlaggen toont het welke plugininstellingen zijn ingesteld en welke niet, zonder de waarden weer te geven. Met `--values-stdin` slaat het nieuwe waarden op uit een JSON-bestand dat als invoer wordt aangeleverd, zonder de plugin opnieuw te installeren. Gewone waarden worden in `settings.json` onder `pluginConfigs` opgeslagen, terwijl waarden voor velden met `sensitive: true` in de beveiligde referentieopslag van het systeem worden opgeslagen.

</div>

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



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

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

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

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

```bash
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](https://ailoot.ai/blog/nl/skills-subagents-mcp-plugins-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](https://ailoot.ai/blog/nl/telegram-ai-agent-plugins/) werkt anders dan een plugin installeren in Claude Code.

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

### Bronnen

- [Claude Code CHANGELOG, vermelding 2.1.285](https://github.com/anthropics/claude-code/commit/ec44ca97dc86c33d934c8d55b24959aabf076871.patch)
- [Claude Code: verwijzing naar plugincommando's](https://code.claude.com/docs/en/plugins/cli-reference.md)
- [Claude Code: verwijzing naar pluginmanifest, gebruikersconfiguratie](https://code.claude.com/docs/en/plugins-reference.md)

</div>





Maak kennis met [Ailoot](https://ailoot.ai/).

## Vragen en antwoorden

### Waarom meldt configure dat mijn geïnstalleerde plugin niet gevonden wordt?

Gebruik de volledige identificatie name@marketplace uit claude plugin list en controleer of de plugin binnen de juiste scope is geïnstalleerd. Alleen de korte pluginnaam wordt door deze opdracht niet geaccepteerd.

### Hoe controleer ik een gewijzigd token zonder het af te drukken?

Voer claude plugin configure uit met de volledige pluginidentificatie en controleer of het gevoelige veld als ingesteld wordt aangeduid. Herstart Claude Code na het opslaan en commit het JSON-invoerbestand met het token niet.


## Ailoot · Het bedrijf en zijn projectenportefeuille

Ailoot bouwt op opgebouwde operationele ervaring, een groot klantenbestand, een stabiele dienst en doorlopende KPI-controle.

Het bedrijf en zijn projectenportefeuille: miljoenen klanten; maandelijkse verkopen in de miljarden.

Ailoot gebruikt die operationele ervaring voor API-toegang tot AI-functies in klantproducten, agents, applicaties en automatiseringen.