Claude Code: změna konfigurace pluginu bez reinstalace

Tento návod je určen uživatelům, kteří už mají nainstalovaný plugin Claude Code deklarující nastavení userConfig, například adresu, token nebo cestu ke složce. Potřebujete opravit chybně zadanou hodnotu nebo vyměnit token bez opětovné instalace pluginu. Vše níže vychází z oficiální dokumentace a changelogu Claude Code. Článek neobsahuje vlastní testovací běh.

Informace o používání Ailoot najdete v dokumentaci.

Co přinesla verze Claude Code 2.1.285?#

Záznam pro verzi 2.1.285 v changelogu Claude Code (commit datovaný 29. září 2026) obsahuje několik řádků o pluginech. Pro tento článek jsou relevantní dva z nich:

Přidán claude plugin configure <plugin> pro zobrazení možností pluginu a toho, které nejsou nastavené, nebo pro uložení nových hodnot načtených ze standardního vstupu pomocí --values-stdin

To znamená, že nový příkaz claude plugin configure <plugin> zobrazí nastavení pluginu a to, která z nich nejsou nastavená, nebo při použití s --values-stdin uloží nové hodnoty načtené ze standardního vstupu.

Přidána možnost <server>.<key>=<value> pro claude plugin install --config, takže lze při instalaci nastavit vlastní nastavení serveru MCP přibaleného v .mcpb a spustit jej bez návštěvy /plugin → Configure

To znamená, že claude plugin install --config nyní podporuje formát <server>.<key>=<value>, který umožňuje zadat při instalaci nastavení serveru MCP přibaleného k pluginu v souboru .mcpb, takže se server spustí bez návštěvy /plugin → Configure.

Referenční příručka příkazů potvrzuje požadovanou verzi: claude plugin configure vyžaduje Claude Code v2.1.285 nebo novější. Ve starších verzích tento příkaz neexistuje.

Jak se změna nastavení pluginu v Claude Code liší od /plugin configure?#

Příkaz /plugin configure <plugin> (s aliasem config) byl už dostupný v interaktivní relaci Claude Code. Otevře dialog pro nastavení userConfig a vyžaduje v2.1.147 nebo novější. /plugin však funguje jen v interaktivní relaci: při neinteraktivním spuštění, například claude -p, Claude Code odpoví, že /plugin v daném prostředí není dostupný.

Podle dokumentace se příkazy claude plugin spouštějí z shellu nebo skriptu, mimo relaci Claude Code. Příkaz claude plugin configure tak můžete spustit i bez otevření dialogu. Dokumentace nepopisuje, jak se tento příkaz chová bez interaktivního terminálu ani kam ukládá tajné hodnoty na serveru bez grafického prostředí. Než jej použijete v CI, ověřte si to ve vlastním prostředí.

Krok 1. Zjistěte, která nastavení jsou nastavena#

Dokumentace vyžaduje úplný identifikátor pluginu ve formátu name@marketplace, jak jej zobrazuje claude plugin list. Příkaz configure nepřijímá název bez @marketplace.

claude plugin list
claude plugin configure formatter@my-marketplace

Nahraďte formatter@my-marketplace identifikátorem svého pluginu. Bez příznaků příkaz vypíše každé nastavení se štítky: required nebo optional, potom sensitive u tajného pole a následně set nebo not set. Uložené hodnoty nevypisuje.

Potřebujete-li strojově čitelný výstup, přidejte --json. Výstup pak bude obsahovat uložené hodnoty běžných polí, ale obsah tajného pole se nikdy nevypíše.

Krok 2. Změňte hodnotu pomocí souboru#

Hodnoty se předávají jako objekt JSON, v němž je každý klíč názvem nastavení z manifestu a každá hodnota je řetězec bez zalomení řádků. Dokumentace uvádí postup se souborem: zapište objekt do values.json a předejte tento soubor příkazu na standardním vstupu. api_url je klíč použitý v příkladu dokumentace. U vlastního pluginu použijte název potřebného nastavení z jeho manifestu nebo z výstupu v kroku 1.

{"api_url": "NEW_ADDRESS"}

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

Při ukládání platí tato pravidla:

• Nastavení vynechaná v JSON si zachovají předchozí hodnoty. Můžete zadat pouze pole, které měníte.
• Popis příznaku obecně hovoří o nastavování hodnot a neuvádí samostatné pravidlo pro tajná pole. Po uložení zkontrolujte v kroku 1, zda je příslušné pole označeno jako set.
• Claude Code kontroluje každou hodnotu podle deklarovaného typu a vypíše Configuration saved. Restart Claude Code to apply it. To znamená, že nastavení bylo uloženo a projeví se po restartu Claude Code.
• Pokud JSON obsahuje klíč, který není deklarován v manifestu, nebo hodnota neprojde validací, příkaz nic neuloží, vypíše Failed to save configuration: následované důvodem a skončí s kódem 1.

Pokud do souboru values.json zapíšete token, mějte na paměti, že jde o běžný soubor na disku. Po uložení konfigurace jej smažte a nepřidávejte jej do repozitáře.

Kam se hodnota ukládá#

Podle dokumentace manifestu pluginu se běžné hodnoty ukládají pod pluginConfigs v uživatelově souboru settings.json. Hodnoty polí označených sensitive: true se místo do settings.json ukládají do zabezpečeného úložiště přihlašovacích údajů systému; zadávaný obsah těchto polí je skrytý.

Nemá smysl hledat hodnotu tajného pole v settings.json. claude plugin configure zobrazuje jeho stav pomocí štítků sensitive a set nebo not set.

install --config: nastavení hodnoty při instalaci#

Při nové instalaci nabízí claude plugin install příznak --config <key=value>. Nastaví deklarované nastavení userConfig v manifestu a vyžaduje v2.1.147 nebo novější. Pro každé nastavení příznak zopakujte. Od verze 2.1.285 nastaví klíč ve formátu <server>.<key> nastavení přibaleného serveru MCP deklarované v jeho vlastním user_config.

V následujícím příkladu nahraďte formatter@my-marketplace identifikátorem svého pluginu, api_url názvem nastavení z jeho manifestu a celý zástupný text NEW_ADDRESS vlastní hodnotou. Uvozovky kolem argumentu ponechte.

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

Volba příkazu závisí na tom, zda je plugin nainstalovaný: install --config nastaví hodnoty při první instalaci, zatímco plugin configure --values-stdin změní hodnoty u již nainstalovaného pluginu.

Pro nastavení přibaleného serveru MCP dokumentace uvádí jiné metody: plugin install --config nebo Configure v /plugin. Pro tato nastavení nedoporučuje příkaz plugin configure.

Když příkaz nemůže najít plugin#

Pokud claude plugin configure nedokáže najít načtený plugin s daným identifikátorem, vypíše No installed plugin has the id "<plugin>". a skončí s kódem 1. Nejprve zkontrolujte, zda jste zadali úplný identifikátor name@marketplace z příkazu claude plugin list. Samotný název pluginu nestačí.

Příkaz v relaci má vlastní hlášení. Pokud při použití /plugin enable, disable, uninstall nebo configure zadáte plugin, který není nainstalovaný v aktuálním projektu, Claude Code vypíše Plugin "<plugin>" is not installed in this project a nic neprovede.

Závěr#

Chcete-li změnit token nebo adresu u již nainstalovaného pluginu v Claude Code 2.1.285 nebo novějším, najděte jeho identifikátor pomocí claude plugin list, zkontrolujte stav nastavení příkazem claude plugin configure, předejte novou hodnotu ze souboru pomocí --values-stdin a restartujte Claude Code. Hodnoty tajných polí se neukládají do settings.json, proto jejich stav kontrolujte stejným příkazem.

Návod Dovednosti, subagenti, MCP a pluginy v Claude Code vám pomůže vybrat mezi typy rozšíření. Pokud jste si ještě plugin nevybrali, můžete začít s 10 nejlepšími pluginy Claude Code. Samostatný návod se týká telegramového bota: instalace pluginu do telegramového agenta se od instalace v Claude Code liší.

Poznejte Ailoot.