Claude Code: Πώς να αναδιαμορφώσετε ένα εγκατεστημένο πρόσθετο χωρίς να το επανεγκαταστήσετε (2.1.285)

Αυτός ο οδηγός απευθύνεται σε χρήστες που έχουν ήδη εγκαταστήσει ένα πρόσθετο Claude Code το οποίο δηλώνει ρυθμίσεις userConfig, όπως μια διεύθυνση, ένα διακριτικό ή μια διαδρομή φακέλου. Χρειάζεται να διορθώσετε μια τιμή που καταχωρίστηκε λανθασμένα ή να αντικαταστήσετε ένα διακριτικό χωρίς να επανεγκαταστήσετε το πρόσθετο. Όσα ακολουθούν βασίζονται στην επίσημη τεκμηρίωση και στο αρχείο καταγραφής αλλαγών του Claude Code. Το άρθρο δεν περιλαμβάνει πρωτότυπη δοκιμή.

Πληροφορίες για τη χρήση του Ailoot είναι διαθέσιμες στην τεκμηρίωση.

Τι προστέθηκε στην έκδοση 2.1.285#

Η καταχώριση του αρχείου καταγραφής αλλαγών του Claude Code για την έκδοση 2.1.285 (ένα commit με ημερομηνία 29 Σεπτεμβρίου 2026) περιέχει αρκετές γραμμές σχετικά με τα πρόσθετα. Δύο από αυτές είναι σχετικές με αυτό το άρθρο:

Προστέθηκε η εντολή claude plugin configure <plugin> για την εμφάνιση των επιλογών ενός πρόσθετου και όσων δεν έχουν οριστεί, ή για την αποθήκευση νέων τιμών που διαβάζονται από το stdin με τη σημαία --values-stdin

Αυτό σημαίνει ότι η νέα εντολή claude plugin configure <plugin> εμφανίζει τις ρυθμίσεις ενός πρόσθετου και ποιες δεν έχουν οριστεί, ή αποθηκεύει νέες τιμές που διαβάζονται από την τυπική είσοδο όταν χρησιμοποιείται με τη σημαία --values-stdin.

Προστέθηκε το <server>.<key>=<value> στο claude plugin install --config, ώστε οι ρυθμίσεις ενός διακομιστή MCP που περιλαμβάνεται σε αρχείο .mcpb να μπορούν να οριστούν κατά την εγκατάσταση και να εκκινείται χωρίς επίσκεψη στη διαδρομή /plugin → Configure

Αυτό σημαίνει ότι το claude plugin install --config υποστηρίζει πλέον τη μορφή <server>.<key>=<value>, επιτρέποντας να παρέχονται κατά την εγκατάσταση οι ρυθμίσεις ενός διακομιστή MCP που περιλαμβάνεται σε ένα πρόσθετο μέσα σε αρχείο .mcpb, ώστε ο διακομιστής να εκκινείται χωρίς επίσκεψη στη διαδρομή /plugin → Configure.

Η αναφορά εντολών επιβεβαιώνει την απαίτηση έκδοσης: το claude plugin configure απαιτεί Claude Code v2.1.285 ή μεταγενέστερη έκδοση. Η εντολή δεν υπάρχει σε παλαιότερες εκδόσεις.

Πώς διαφέρει από το /plugin configure#

Η εντολή /plugin configure <plugin> (με το ψευδώνυμο config) ήταν ήδη διαθέσιμη μέσα σε μια διαδραστική συνεδρία Claude Code. Ανοίγει ένα παράθυρο διαλόγου για τις ρυθμίσεις userConfig και απαιτεί v2.1.147 ή μεταγενέστερη έκδοση. Ωστόσο, το /plugin λειτουργεί μόνο σε διαδραστική συνεδρία: σε μια μη διαδραστική κλήση, όπως claude -p, το Claude Code απαντά ότι το /plugin δεν είναι διαθέσιμο σε αυτό το περιβάλλον.

Σύμφωνα με την τεκμηρίωση, οι εντολές claude plugin εκτελούνται από κέλυφος ή σκριπτ, εκτός μιας συνεδρίας Claude Code. Αυτό σας επιτρέπει επίσης να εκτελέσετε το claude plugin configure χωρίς να ανοίξετε παράθυρο διαλόγου. Η τεκμηρίωση δεν περιγράφει τη συμπεριφορά αυτής της εντολής χωρίς διαδραστικό τερματικό ή πού αποθηκεύει τις μυστικές τιμές σε διακομιστή χωρίς γραφικό περιβάλλον. Ελέγξτε το στο δικό σας περιβάλλον πριν τη χρησιμοποιήσετε σε CI.

Βήμα 1. Δείτε ποιες ρυθμίσεις έχουν οριστεί#

Η τεκμηρίωση απαιτεί το πλήρες αναγνωριστικό πρόσθετου στη μορφή name@marketplace, όπως εμφανίζεται με την εντολή claude plugin list. Η εντολή configure δεν δέχεται όνομα χωρίς @marketplace.

claude plugin list
claude plugin configure formatter@my-marketplace

Αντικαταστήστε το formatter@my-marketplace με το αναγνωριστικό του πρόσθετού σας. Χωρίς σημαίες, η εντολή παραθέτει κάθε ρύθμιση με ετικέτες: required ή optional, στη συνέχεια sensitive για ένα μυστικό πεδίο, και έπειτα set ή not set. Δεν εκτυπώνει τις αποθηκευμένες τιμές.

Αν χρειάζεστε έξοδο αναγνώσιμη από μηχανή, προσθέστε --json. Η έξοδος θα περιλαμβάνει τότε τις αποθηκευμένες τιμές για τα συνηθισμένα πεδία, αλλά τα περιεχόμενα ενός μυστικού πεδίου δεν εκτυπώνονται ποτέ.

Βήμα 2. Αλλάξτε μια τιμή χρησιμοποιώντας αρχείο#

Οι τιμές παρέχονται ως αντικείμενο JSON, όπου κάθε κλειδί είναι ένα όνομα ρύθμισης από το μανιφέστο και κάθε τιμή είναι συμβολοσειρά χωρίς αλλαγές γραμμής. Η τεκμηρίωση παρουσιάζει μια μέθοδο μέσω αρχείου: γράψτε το αντικείμενο στο values.json και περάστε αυτό το αρχείο στην τυπική είσοδο της εντολής. Εδώ, το api_url είναι το κλειδί που χρησιμοποιείται στο παράδειγμα της τεκμηρίωσης. Για το δικό σας πρόσθετο, χρησιμοποιήστε το όνομα της ρύθμισης που χρειάζεστε από το μανιφέστο του ή από την έξοδο του βήματος 1.

{"api_url": "NEW_ADDRESS"}

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

Κατά την αποθήκευση ισχύουν οι ακόλουθοι κανόνες:

• Οι ρυθμίσεις που παραλείπονται από το JSON διατηρούν τις προηγούμενες τιμές τους. Μπορείτε να παρέχετε μόνο το πεδίο που αλλάζετε.
• Η περιγραφή της σημαίας αναφέρεται γενικά στον ορισμό τιμών και δεν αναφέρει ξεχωριστό κανόνα για μυστικά πεδία. Μετά την αποθήκευση, χρησιμοποιήστε το βήμα 1 για να ελέγξετε ότι το σχετικό πεδίο επισημαίνεται ως set.
• Το Claude Code ελέγχει κάθε τιμή σε σχέση με τον δηλωμένο τύπο της και εκτυπώνει Configuration saved. Restart Claude Code to apply it. Αυτό σημαίνει ότι η ρύθμιση έχει αποθηκευτεί και θα τεθεί σε ισχύ μετά την επανεκκίνηση του Claude Code.
• Αν το JSON περιέχει κλειδί που δεν έχει δηλωθεί στο μανιφέστο ή μια τιμή αποτύχει στην επικύρωση, η εντολή δεν αποθηκεύει τίποτα, εκτυπώνει Failed to save configuration: ακολουθούμενο από τον λόγο και τερματίζει με κωδικό 1.

Αν γράψετε ένα διακριτικό στο values.json, θυμηθείτε ότι πρόκειται για συνηθισμένο αρχείο στον δίσκο. Διαγράψτε το μετά την αποθήκευση της ρύθμισης και μην προσθέσετε τέτοιο αρχείο στο αποθετήριο.

Πού αποθηκεύεται η τιμή#

Σύμφωνα με την τεκμηρίωση του μανιφέστου πρόσθετου, οι συνηθισμένες τιμές αποθηκεύονται κάτω από το pluginConfigs στο settings.json του χρήστη. Οι τιμές για πεδία που έχουν επισημανθεί με sensitive: true αποθηκεύονται στο ασφαλές αποθετήριο διαπιστευτηρίων του συστήματος αντί στο settings.json· η είσοδος για αυτά τα πεδία αποκρύπτεται.

Δεν έχει νόημα να αναζητήσετε την τιμή ενός μυστικού πεδίου στο settings.json. Το claude plugin configure εμφανίζει την κατάστασή του με τις ετικέτες sensitive και set ή not set.

install --config: ορίστε μια τιμή κατά την εγκατάσταση#

Για νέα εγκατάσταση, η εντολή claude plugin install παρέχει τη σημαία --config <key=value>. Ορίζει μια ρύθμιση userConfig που δηλώνεται στο μανιφέστο και απαιτεί v2.1.147 ή μεταγενέστερη έκδοση. Επαναλάβετε τη σημαία για κάθε ρύθμιση. Από την έκδοση 2.1.285, ένα κλειδί στη μορφή <server>.<key> ορίζει μια ρύθμιση διακομιστή MCP που περιλαμβάνεται στο πρόσθετο και δηλώνεται στο δικό του user_config.

Στο παρακάτω παράδειγμα, αντικαταστήστε το formatter@my-marketplace με το αναγνωριστικό του πρόσθετού σας, το api_url με το όνομα της ρύθμισης από το μανιφέστο του και ολόκληρο το σύμβολο κράτησης θέσης NEW_ADDRESS με τη δική σας τιμή. Διατηρήστε τα εισαγωγικά γύρω από το όρισμα.

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

Η εντολή που θα χρησιμοποιήσετε εξαρτάται από το αν το πρόσθετο είναι εγκατεστημένο: το install --config ορίζει τιμές κατά την πρώτη εγκατάσταση, ενώ το plugin configure --values-stdin αλλάζει τιμές για ένα ήδη εγκατεστημένο πρόσθετο.

Για ρυθμίσεις που ανήκουν σε διακομιστή MCP που περιλαμβάνεται στο πρόσθετο, η τεκμηρίωση αναφέρει άλλες μεθόδους: plugin install --config ή Configure στο /plugin. Δεν προτείνει την εντολή plugin configure για αυτές τις ρυθμίσεις.

Αν η εντολή δεν μπορεί να εντοπίσει το πρόσθετο#

Αν το claude plugin configure δεν μπορεί να εντοπίσει ένα φορτωμένο πρόσθετο με αυτό το αναγνωριστικό, εκτυπώνει No installed plugin has the id "<plugin>". και τερματίζει με κωδικό 1. Ελέγξτε πρώτα ότι δώσατε το πλήρες αναγνωριστικό name@marketplace από την εντολή claude plugin list. Το όνομα του πρόσθετου μόνο του δεν αρκεί.

Η εντολή μέσα στη συνεδρία έχει το δικό της μήνυμα. Αν ονομάσετε ένα πρόσθετο που δεν είναι εγκατεστημένο στο τρέχον έργο όταν χρησιμοποιείτε τα /plugin enable, disable, uninstall ή configure, το Claude Code εκτυπώνει Plugin "<plugin>" is not installed in this project και δεν κάνει τίποτα.

Συμπέρασμα#

Για να αλλάξετε ένα διακριτικό ή μια διεύθυνση για ένα ήδη εγκατεστημένο πρόσθετο στο Claude Code 2.1.285 ή μεταγενέστερη έκδοση, βρείτε το αναγνωριστικό του με την εντολή claude plugin list, ελέγξτε την κατάσταση των ρυθμίσεών του με την εντολή claude plugin configure, δώστε τη νέα τιμή από αρχείο με τη σημαία --values-stdin και επανεκκινήστε το Claude Code. Οι τιμές μυστικών πεδίων δεν αποθηκεύονται στο settings.json, οπότε ελέγξτε την κατάστασή τους με την ίδια εντολή.

Ο οδηγός για τα Skills, Subagents, MCP και Plugins στο Claude Code μπορεί να σας βοηθήσει να επιλέξετε ανάμεσα στους τύπους επεκτάσεων. Αν δεν έχετε επιλέξει ακόμη πρόσθετο, μπορείτε να ξεκινήσετε με τα 10 κορυφαία πρόσθετα Claude Code. Υπάρχει ξεχωριστός οδηγός για ένα bot Telegram: η εγκατάσταση ενός πρόσθετου σε έναν agent Telegram λειτουργεί διαφορετικά από την εγκατάσταση ενός πρόσθετου στο Claude Code.

Γνωρίστε το Ailoot.