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

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.

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.

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ä.

{"api_url": "NEW_ADDRESS"}

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.

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 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 toimii eri tavalla kuin pluginin asentaminen Claude Codeen.

Tutustu Ailootiin.