Claude Code 2.1.285: ponowna konfiguracja wtyczki

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.

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.

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.

{"api_url": "NEW_ADDRESS"}

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.

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 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 przebiega inaczej niż instalowanie jej w Claude Code.

Poznaj Ailoot.