# Claude Code: Näin muutat asennetun pluginin asetuksia asentamatta sitä uudelleen (2.1.285)

> Claude Code 2.1.285 toi käyttöön komennon claude plugin configure. Näin tarkistat dokumentaatiosta pluginin asetukset ja vaihdat tokenin tai osoitteen asentamatta pluginia uudelleen.

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


<div class="aside" data-semantic="key-takeaway" role="note" aria-label="Tämän osion tärkein asia">

Tärkein asia

Claude Code 2.1.285 toi käyttöön päätekomennon `claude plugin configure <plugin>`. Ilman valitsimia komento näyttää, mitkä pluginin asetukset on määritetty ja mitkä ovat määrittämättä, paljastamatta niiden arvoja. Valitsin `--values-stdin` tallentaa uudet arvot syötteenä annetusta JSON-tiedostosta asentamatta pluginia uudelleen. Tavalliset arvot tallennetaan `settings.json`-tiedostoon `pluginConfigs`-avaimen alle, kun taas `sensitive: true` -merkityille kentille annetut arvot tallennetaan järjestelmän suojattuun tunnistetietovarastoon.

</div>

Tämä opas on tarkoitettu käyttäjille, joilla on jo asennettuna Claude Code -plugin, jonka asetuksissa on `userConfig`-määrityksiä, kuten osoite, token tai kansion polku. Haluat korjata väärin syötetyn arvon tai vaihtaa tokenin asentamatta pluginia uudelleen. Kaikki jäljempänä oleva perustuu Claude Coden viralliseen dokumentaatioon ja muutoslokiin. Artikkeliin ei sisälly omaa testiajoa.

Tietoa Ailootin käytöstä on [dokumentaatiossa](https://ailoot.ai/docs/).



## Mitä versio 2.1.285 lisäsi

Claude Coden version 2.1.285 muutoslokissa (29. syyskuuta 2026 päivätty commit) on useita pluginia käsitteleviä rivejä. Kaksi niistä on tämän artikkelin kannalta olennaisia:

> Lisättiin `claude plugin configure <plugin>` näyttämään pluginin vaihtoehdot ja määrittämättä olevat asetukset tai tallentamaan stdin-syötteestä luetut uudet arvot valitsimella `--values-stdin`

Tämä tarkoittaa, että uusi komento `claude plugin configure <plugin>` näyttää pluginin asetukset ja niistä määrittämättä olevat tai tallentaa standardisyötteestä luetut uudet arvot, kun komentoa käytetään valitsimen `--values-stdin` kanssa.

> Lisättiin `claude plugin install --config` -komentoon `<server>.<key>=<value>`, jotta mukana toimitettavan `.mcpb`-tiedoston MCP-palvelimen omat asetukset voi määrittää asennuksen yhteydessä ja palvelin käynnistyy ilman `/plugin` → Configure -näkymässä käyntiä

Tämä tarkoittaa, että `claude plugin install --config` tukee nyt muotoa `<server>.<key>=<value>`. Näin pluginin mukana `.mcpb`-tiedostossa toimitettavan MCP-palvelimen asetukset voi antaa asennuksen yhteydessä, jolloin palvelin käynnistyy ilman `/plugin` → Configure -näkymässä käyntiä.

Komentoviite vahvistaa versioedellytyksen: `claude plugin configure` vaatii Claude Code -version v2.1.285 tai uudemman. Komentoa ei ole aiemmissa versioissa.

## Miten tämä eroaa /plugin configure -komennosta

`/plugin configure <plugin>` -komento (jonka alias on `config`) oli jo käytettävissä vuorovaikutteisessa Claude Code -istunnossa. Se avaa `userConfig`-asetusten valintaikkunan ja vaatii version v2.1.147 tai uudemman. `/plugin` toimii kuitenkin vain vuorovaikutteisessa istunnossa: ei-vuorovaikutteisessa kutsussa, kuten `claude -p`, Claude Code ilmoittaa, ettei `/plugin` ole käytettävissä kyseisessä ympäristössä.

Dokumentaation mukaan `claude plugin` -komennot suoritetaan komentotulkista tai komentosarjasta Claude Code -istunnon ulkopuolella. Siksi myös `claude plugin configure` -komentoa voi käyttää avaamatta valintaikkunaa. Dokumentaatiossa ei kuvata, miten komento toimii ilman vuorovaikutteista päätettä tai mihin se tallentaa salaiset arvot palvelimella, jossa ei ole graafista ympäristöä. Selvitä tämä omassa ympäristössäsi ennen komennon käyttöä CI:ssä.





## Vaihe 1. Katso, mitkä asetukset on määritetty

Dokumentaatio edellyttää pluginin koko tunnistetta muodossa `name@marketplace`, joka näkyy komennon `claude plugin list` tulosteessa. `configure`-komento ei hyväksy nimeä ilman `@marketplace`-osaa.

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

Korvaa `formatter@my-marketplace` oman pluginisi tunnisteella. Ilman valitsimia komento luettelee jokaisen asetuksen ja näyttää tunnisteena ensin `required` tai `optional`, sitten salaisen kentän kohdalla `sensitive` ja lopuksi joko `set` tai `not set`. Komento ei tulosta tallennettuja arvoja.

Jos tarvitset koneellisesti luettavaa tulostetta, lisää `--json`. Tällöin tuloste sisältää tavallisten kenttien tallennetut arvot, mutta salaisen kentän sisältöä ei koskaan tulosteta.

## Vaihe 2. Muuta arvoa tiedoston avulla

Arvot annetaan JSON-objektina, jonka kukin avain on manifestista löytyvä asetuksen nimi ja kukin arvo rivinvaihtoja sisältämätön merkkijono. Dokumentaatiossa näytetään tiedostoa käyttävä menetelmä: kirjoita objekti tiedostoon `values.json` ja anna tiedosto komennon standardisyötteeksi. Tässä `api_url` on dokumentaation esimerkissä käytetty avain. Käytä omalle pluginillesi sen manifestissa tai vaiheen 1 tulosteessa näkyvää tarvitsemasi asetuksen nimeä.

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

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

Tallennuksessa pätevät seuraavat säännöt:

- JSON-objektista pois jätettyjen asetusten aiemmat arvot säilyvät. Voit antaa vain muuttamasi kentän.
- Valitsimen kuvauksessa puhutaan arvojen asettamisesta yleisesti, eikä siinä esitetä salaisille kentille erillistä sääntöä. Tarkista tallennuksen jälkeen vaiheen 1 avulla, että kyseisen kentän tila on `set`.
- Claude Code tarkistaa jokaisen arvon sen ilmoitettua tyyppiä vasten ja tulostaa `Configuration saved. Restart Claude Code to apply it.` Tämä tarkoittaa, että asetus on tallennettu ja tulee voimaan, kun Claude Code käynnistetään uudelleen.
- Jos JSON sisältää avaimen, jota ei ole määritelty manifestissa, tai arvo ei läpäise validointia, komento ei tallenna mitään, tulostaa `Failed to save configuration:` ja sen jälkeen syyn sekä poistuu koodilla `1`.

Jos kirjoitat tokenin tiedostoon `values.json`, muista, että se on tavallinen tiedosto levyllä. Poista tiedosto asetusten tallentamisen jälkeen äläkä lisää sitä repositorioon.

## Mihin arvo tallennetaan

Pluginmanifestin dokumentaation mukaan tavalliset arvot tallennetaan käyttäjän `settings.json`-tiedostoon `pluginConfigs`-avaimen alle. `sensitive: true` -merkityille kentille annetut arvot tallennetaan järjestelmän suojattuun tunnistetietovarastoon `settings.json`-tiedoston sijaan; näiden kenttien syöte peitetään.

Salaisen kentän arvoa ei kannata etsiä `settings.json`-tiedostosta. `claude plugin configure` näyttää sen tilan tunnisteilla `sensitive` ja `set` tai `not set`.

## install --config: aseta arvo asennuksen yhteydessä

Uutta asennusta varten `claude plugin install` -komennossa on valitsin `--config <key=value>`. Se asettaa manifestissa määritellyn `userConfig`-asetuksen ja vaatii version v2.1.147 tai uudemman. Toista valitsin kullekin asetukselle. Versiosta 2.1.285 alkaen muotoa `<server>.<key>` oleva avain asettaa mukana toimitettavan MCP-palvelimen asetuksen, joka on määritelty palvelimen omassa `user_config`-määrityksessä.

Korvaa alla olevassa esimerkissä `formatter@my-marketplace` oman pluginisi tunnisteella, `api_url` manifestissa näkyvällä asetuksen nimellä ja koko `NEW_ADDRESS`-paikkamerkki omalla arvollasi. Säilytä argumentin ympärillä olevat lainausmerkit.

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

Komennon valinta riippuu siitä, onko plugin jo asennettu: `install --config` asettaa arvot ensimmäisen asennuksen yhteydessä, kun taas `plugin configure --values-stdin` muuttaa jo asennetun pluginin arvoja.

Mukana toimitettavan MCP-palvelimen asetuksiin dokumentaatio luettelee muita menetelmiä: `plugin install --config` tai `/plugin`-näkymän **Configure**. Se ei suosittele `plugin configure` -komentoa kyseisten asetusten muuttamiseen.

## Jos komento ei löydä pluginia

Jos `claude plugin configure` ei löydä kyseisellä tunnisteella ladattua pluginia, se tulostaa `No installed plugin has the id "<plugin>".` ja poistuu koodilla `1`. Tarkista ensin, että annoit komennolle koko `name@marketplace`-tunnisteen, joka näkyy komennon `claude plugin list` tulosteessa. Pelkkä pluginin nimi ei riitä.

Istunnonaikainen komento antaa oman ilmoituksensa. Jos nimeät pluginin, jota ei ole asennettu nykyiseen projektiin, käyttäessäsi komentoja `/plugin enable`, `disable`, `uninstall` tai `configure`, Claude Code tulostaa `Plugin "<plugin>" is not installed in this project` eikä tee mitään.

## Yhteenveto

Jos haluat vaihtaa tokenin tai osoitteen Claude Code 2.1.285:ssä tai uudemmassa jo asennetussa pluginissa, etsi sen tunniste komennolla `claude plugin list`, tarkista asetusten tila komennolla `claude plugin configure`, anna uusi arvo tiedostosta valitsimella `--values-stdin` ja käynnistä Claude Code uudelleen. Salaisille kentille annetut arvot eivät tallennu `settings.json`-tiedostoon, joten tarkista niiden tila samalla komennolla.

Opas aiheesta [Skills, Subagents, MCP ja Plugins Claude Codessa](https://ailoot.ai/blog/fi/skills-subagents-mcp-plugins-claude-code/) voi auttaa valitsemaan laajennustyyppien välillä. Jos et ole vielä valinnut pluginia, voit aloittaa oppaasta Claude Coden 10 parasta pluginia. Telegram-botille on oma opas: [pluginin asentaminen Telegram-agenttiin](https://ailoot.ai/blog/fi/telegram-ai-agent-plugins/) toimii eri tavalla kuin pluginin asentaminen Claude Codeen.

<div class="section" role="doc-bibliography" aria-label="Lähteet">

### Lähteet

- [Claude Code CHANGELOG, versio 2.1.285](https://github.com/anthropics/claude-code/commit/ec44ca97dc86c33d934c8d55b24959aabf076871.patch)
- [Claude Code: plugin-komentojen viite](https://code.claude.com/docs/en/plugins/cli-reference.md)
- [Claude Code: pluginmanifestin viite, käyttäjän asetukset](https://code.claude.com/docs/en/plugins-reference.md)

</div>





Tutustu [Ailootiin](https://ailoot.ai/).

## Kysymyksiä tästä oppaasta: Claude Code: Näin muutat asennetun pluginin asetuksia asentamatta sitä uudelleen (2.1.285)

### Miksi configure ilmoittaa, ettei asennettua pluginiani löydy?

Käytä `claude plugin list` -komennon näyttämää täydellistä name@marketplace-tunnistetta ja tarkista pluginin olevan asennettu oikeaan rajaukseen. Pelkkää lyhyttä pluginin nimeä ei hyväksytä tähän komentoon.

### Miten tarkistan muutetun tokenin tulostamatta sitä?

Suorita `claude plugin configure` pluginin täydellä tunnisteella ja tarkista arkaluonteisen kentän olevan merkitty asetetuksi. Käynnistä Claude Code uudelleen tallennuksen jälkeen. Älä commitoi tokenin sisältävää JSON-syötetiedostoa.


## Ailoot · Yritys ja sen projektisalkku

Ailoot perustuu kertyneeseen toimintakokemukseen, laajaan asiakaskuntaan, vakaaseen palveluun ja jatkuvaan KPI-seurantaan.

Yritys ja sen projektisalkku: miljoonia asiakkaita; kuukausittainen myynti miljardiluokassa.

Ailoot hyödyntää tätä toimintakokemusta tarjotessaan API-yhteyden tekoälytoimintoihin asiakkaiden tuotteissa, agenteissa, sovelluksissa ja automaatioissa.