# Claude Code: změna konfigurace pluginu bez reinstalace

> Claude Code 2.1.285 přidal příkaz claude plugin configure. Jak v dokumentaci zkontrolovat nastavení pluginu a změnit token nebo adresu bez opětovné instalace.

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


<div class="aside" data-semantic="key-takeaway" role="note" aria-label="Hlavní poznatek z této části">

Hlavní poznatek

Claude Code 2.1.285 přidal terminálový příkaz `claude plugin configure <plugin>`. Bez příznaků zobrazí, která nastavení pluginu jsou nastavena a která nejsou, aniž by vypisoval jejich hodnoty. Pomocí `--values-stdin` uloží nové hodnoty ze vstupního JSON souboru, aniž by plugin znovu instaloval. Běžné hodnoty se ukládají do `settings.json` pod `pluginConfigs`, zatímco hodnoty polí označených `sensitive: true` se ukládají do zabezpečeného úložiště přihlašovacích údajů systému.

</div>

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



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

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

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

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

```bash
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](https://ailoot.ai/blog/cs/skills-subagents-mcp-plugins-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](https://ailoot.ai/blog/cs/telegram-ai-agent-plugins/) se od instalace v Claude Code liší.

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

### Zdroje

- [Claude Code CHANGELOG, záznam 2.1.285](https://github.com/anthropics/claude-code/commit/ec44ca97dc86c33d934c8d55b24959aabf076871.patch)
- [Claude Code: referenční příručka příkazů pluginu](https://code.claude.com/docs/en/plugins/cli-reference.md)
- [Claude Code: referenční příručka manifestu pluginu, uživatelská konfigurace](https://code.claude.com/docs/en/plugins-reference.md)

</div>





Poznejte [Ailoot](https://ailoot.ai/).

## Časté otázky

### Proč configure hlásí, že nainstalovaný plugin nenašel?

Použijte úplný identifikátor name@marketplace z `claude plugin list` a zkontrolujte instalaci pluginu v příslušném rozsahu. Samotný krátký název tento příkaz nepřijímá.

### Jak ověřit změněný token, aniž bych ho vypsal?

Spusťte `claude plugin configure` s úplným identifikátorem pluginu a ověřte, že je citlivé pole označené jako nastavené. Po uložení restartujte Claude Code; vstupní JSON s tokenem neukládejte do Gitu.


## Ailoot · Společnost a její portfolio projektů

Ailoot staví na dlouhodobých provozních zkušenostech, široké klientské základně, stabilních službách a průběžném sledování KPI.

Společnost a její portfolio projektů: miliony zákazníků; měsíční tržby v miliardách.

Ailoot využívá tyto provozní zkušenosti k poskytování přístupu přes API k funkcím AI v produktech zákazníků, agentech, aplikacích a automatizacích.