# Claude Code 2.1.285: ponowna konfiguracja wtyczki

> W Claude Code 2.1.285 dodano polecenie claude plugin configure. Dowiedz się, jak sprawdzić ustawienia wtyczki w dokumentacji i zmienić token lub adres bez ponownej instalacji.

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


<div class="aside" data-semantic="key-takeaway" role="note" aria-label="Najważniejsze informacje w tej sekcji">

Najważniejsze informacje

W Claude Code 2.1.285 dodano polecenie terminala `claude plugin configure <plugin>`. Bez flag pokazuje, które ustawienia wtyczki są skonfigurowane, a które nie, nie wyświetlając ich wartości. Flaga `--values-stdin` zapisuje nowe wartości z pliku JSON przekazanego na standardowe wejście, bez konieczności ponownej instalacji wtyczki. Zwykłe wartości są przechowywane w `settings.json` w sekcji `pluginConfigs`, natomiast wartości pól oznaczonych jako `sensitive: true` są zapisywane w bezpiecznym magazynie poświadczeń systemu.

</div>

Ten poradnik jest przeznaczony dla osób, które mają już zainstalowaną wtyczkę Claude Code deklarującą ustawienia `userConfig`, takie jak adres, token lub ścieżka do folderu. Może pomóc poprawić błędnie wprowadzoną wartość albo wymienić token bez ponownej instalacji wtyczki. Wszystkie poniższe informacje opierają się na oficjalnej dokumentacji i dzienniku zmian Claude Code. Artykuł nie zawiera wyników własnego testu.

Informacje o korzystaniu z Ailoot znajdziesz w [dokumentacji](https://ailoot.ai/docs/).



## Co dodano w wersji 2.1.285

Wpis dotyczący wersji 2.1.285 w dzienniku zmian Claude Code (commit z 29 września 2026 r.) zawiera kilka informacji o wtyczkach. Dwie z nich są istotne dla tego artykułu:

> Added `claude plugin configure <plugin>` to show a plugin's options and which are unset, or save new values read from stdin with `--values-stdin`

Oznacza to, że nowe polecenie `claude plugin configure <plugin>` pokazuje ustawienia wtyczki i te, które nie zostały skonfigurowane. Z flagą `--values-stdin` zapisuje nowe wartości odczytane ze standardowego wejścia.

> Added `<server>.<key>=<value>` to `claude plugin install --config`, so a bundled `.mcpb` MCP server's own settings can be set at install time and it starts without visiting `/plugin` → Configure

Oznacza to, że `claude plugin install --config` obsługuje teraz format `<server>.<key>=<value>`. Dzięki temu ustawienia serwera MCP dołączonego do wtyczki w pliku `.mcpb` można przekazać podczas instalacji, aby serwer uruchomił się bez otwierania `/plugin` → Configure.

Dokumentacja poleceń potwierdza wymaganie dotyczące wersji: `claude plugin configure` wymaga Claude Code v2.1.285 lub nowszej. Wcześniejsze wersje nie zawierają tego polecenia.

## Czym różni się od /plugin configure

Polecenie `/plugin configure <plugin>` (alias `config`) było już dostępne w interaktywnej sesji Claude Code. Otwiera okno konfiguracji ustawień `userConfig` i wymaga wersji v2.1.147 lub nowszej. Jednak `/plugin` działa wyłącznie w sesji interaktywnej: przy wywołaniu nieinteraktywnym, takim jak `claude -p`, Claude Code informuje, że `/plugin` jest niedostępne w tym środowisku.

Zgodnie z dokumentacją polecenia `claude plugin` uruchamia się z poziomu powłoki lub skryptu, poza sesją Claude Code. Można dzięki temu użyć `claude plugin configure` bez otwierania okna dialogowego. Dokumentacja nie opisuje zachowania tego polecenia bez interaktywnego terminala ani miejsca przechowywania poufnych wartości na serwerze bez środowiska graficznego. Przed użyciem w CI sprawdź to we własnym środowisku.





## Krok 1. Sprawdź, które ustawienia są skonfigurowane

Dokumentacja wymaga pełnego identyfikatora wtyczki w formacie `name@marketplace`, widocznego w wyniku `claude plugin list`. Polecenie `configure` nie przyjmuje nazwy bez `@marketplace`.

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

Zastąp `formatter@my-marketplace` identyfikatorem swojej wtyczki. Bez flag polecenie wyświetla etykietę przy każdym ustawieniu: `required` lub `optional`, a w przypadku pola poufnego dodatkowo `sensitive`, po czym wskazuje `set` lub `not set`. Nie wyświetla zapisanych wartości.

Jeśli potrzebujesz formatu czytelnego maszynowo, dodaj `--json`. Wynik będzie wtedy zawierał zapisane wartości zwykłych pól, ale zawartość pola poufnego nigdy nie zostanie wyświetlona.

## Krok 2. Zmień wartość za pomocą pliku

Wartości podaje się jako obiekt JSON, w którym każdy klucz jest nazwą ustawienia z manifestu, a każda wartość — ciągiem znaków bez znaków nowej linii. Dokumentacja przedstawia metodę opartą na pliku: zapisz obiekt w `values.json`, a następnie przekaż ten plik na standardowe wejście polecenia. `api_url` to klucz użyty w przykładzie z dokumentacji. W przypadku własnej wtyczki użyj nazwy ustawienia z jej manifestu lub z wyniku polecenia w kroku 1.

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

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

Podczas zapisywania obowiązują następujące zasady:

- Ustawienia pominięte w JSON zachowują poprzednie wartości. Możesz podać tylko pole, które zmieniasz.
- Opis flagi odnosi się ogólnie do ustawiania wartości i nie podaje osobnej zasady dla pól poufnych. Po zapisaniu użyj kroku 1, aby sprawdzić, czy odpowiednie pole jest oznaczone jako `set`.
- Claude Code sprawdza każdą wartość pod kątem zadeklarowanego typu i wyświetla `Configuration saved. Restart Claude Code to apply it.`. Oznacza to, że ustawienie zostało zapisane i zacznie obowiązywać po ponownym uruchomieniu Claude Code.
- Jeśli JSON zawiera klucz niezadeklarowany w manifeście albo wartość nie przejdzie walidacji, polecenie niczego nie zapisze, wyświetli `Failed to save configuration:` wraz z przyczyną i zakończy działanie kodem `1`.

Jeśli zapiszesz token w `values.json`, pamiętaj, że jest to zwykły plik na dysku. Usuń go po zapisaniu konfiguracji i nie dodawaj takiego pliku do repozytorium.

## Gdzie jest przechowywana wartość

Zgodnie z dokumentacją manifestu wtyczki zwykłe wartości są zapisywane w sekcji `pluginConfigs` pliku `settings.json` użytkownika. Wartości pól oznaczonych jako `sensitive: true` są przechowywane w bezpiecznym magazynie poświadczeń systemu zamiast w `settings.json`; dane wprowadzane w tych polach są maskowane.

Nie ma sensu szukać wartości pola poufnego w `settings.json`. `claude plugin configure` pokazuje jego stan za pomocą etykiet `sensitive` oraz `set` lub `not set`.

## install --config: ustaw wartość podczas instalacji

Przy nowej instalacji polecenie `claude plugin install` udostępnia flagę `--config <key=value>`. Ustawia ona wartość `userConfig` zadeklarowanego w manifeście i wymaga wersji v2.1.147 lub nowszej. Powtórz flagę dla każdego ustawienia. Od wersji 2.1.285 klucz w formacie `<server>.<key>` ustawia konfigurację serwera MCP dołączonego do wtyczki, zadeklarowaną w jego własnym `user_config`.

W poniższym przykładzie zastąp `formatter@my-marketplace` identyfikatorem swojej wtyczki, `api_url` nazwą ustawienia z jej manifestu, a cały symbol zastępczy `NEW_ADDRESS` własną wartością. Pozostaw cudzysłowy wokół argumentu.

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

Wybór polecenia zależy od tego, czy wtyczka jest już zainstalowana: `install --config` ustawia wartości podczas pierwszej instalacji, natomiast `plugin configure --values-stdin` zmienia wartości w już zainstalowanej wtyczce.

W przypadku ustawień należących do dołączonego serwera MCP dokumentacja wymienia inne metody: `plugin install --config` lub **Configure** w `/plugin`. Nie sugeruje użycia polecenia `plugin configure` dla tych ustawień.

## Jeśli polecenie nie może znaleźć wtyczki

Jeśli `claude plugin configure` nie znajdzie załadowanej wtyczki o podanym identyfikatorze, wyświetli `No installed plugin has the id "<plugin>".` i zakończy działanie kodem `1`. Najpierw sprawdź, czy podano pełny identyfikator `name@marketplace` z `claude plugin list`. Sama nazwa wtyczki nie wystarczy.

Polecenie działające w sesji wyświetla inny komunikat. Jeśli podczas używania `/plugin enable`, `disable`, `uninstall` lub `configure` wskażesz wtyczkę, która nie jest zainstalowana w bieżącym projekcie, Claude Code wyświetli `Plugin "<plugin>" is not installed in this project` i nie podejmie żadnego działania.

## Podsumowanie

Aby zmienić token lub adres w już zainstalowanej wtyczce w Claude Code 2.1.285 lub nowszym, znajdź jej identyfikator za pomocą `claude plugin list`, sprawdź stan ustawień poleceniem `claude plugin configure`, przekaż nową wartość z pliku za pomocą `--values-stdin` i uruchom ponownie Claude Code. Wartości pól poufnych nie są przechowywane w `settings.json`, dlatego ich stan sprawdzaj tym samym poleceniem.

[Poradnik dotyczący Skills, Subagents, MCP i Plugins w Claude Code](https://ailoot.ai/blog/pl/skills-subagents-mcp-plugins-claude-code/) pomoże Ci wybrać typ rozszerzenia. Jeśli jeszcze nie wybrałeś wtyczki, możesz zacząć od 10 najlepszych wtyczek do Claude Code. Osobny poradnik dotyczy bota Telegram: [instalowanie wtyczki w agencie Telegram](https://ailoot.ai/blog/pl/telegram-ai-agent-plugins/) przebiega inaczej niż instalowanie jej w Claude Code.

<div class="section" role="doc-bibliography" aria-label="Źródła">

### Źródła

- [Claude Code CHANGELOG, wpis dotyczący wersji 2.1.285](https://github.com/anthropics/claude-code/commit/ec44ca97dc86c33d934c8d55b24959aabf076871.patch)
- [Claude Code: dokumentacja poleceń wtyczek](https://code.claude.com/docs/en/plugins/cli-reference.md)
- [Claude Code: dokumentacja manifestu wtyczki, konfiguracja użytkownika](https://code.claude.com/docs/en/plugins-reference.md)

</div>





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

## Pytania i odpowiedzi

### Dlaczego configure nie znajduje zainstalowanej wtyczki?

Użyj pełnego identyfikatora name@marketplace z `claude plugin list` i sprawdź instalację w odpowiednim zakresie. Sama krótka nazwa wtyczki nie jest akceptowana przez to polecenie.

### Jak sprawdzić zmieniony token bez jego wyświetlania?

Uruchom `claude plugin configure` z pełnym identyfikatorem wtyczki i sprawdź, czy pole wrażliwe jest oznaczone jako ustawione. Po zapisie uruchom Claude Code ponownie; nie commituj wejściowego pliku JSON zawierającego token.


## Ailoot · Firma i jej portfel projektów

Ailoot opiera się na zgromadzonym doświadczeniu operacyjnym, szerokiej bazie klientów, stabilnej usłudze i stałej kontroli KPI.

Firma i jej portfel projektów: miliony klientów; miesięczna sprzedaż liczona w miliardach.

Ailoot wykorzystuje to doświadczenie operacyjne, zapewniając dostęp przez API do funkcji AI w produktach klientów, agentach, aplikacjach i automatyzacjach.