Claude Code: איך להגדיר מחדש תוסף מותקן בלי להתקין אותו מחדש (2.1.285)

המדריך מיועד למשתמשים שכבר התקינו תוסף של Claude Code שמצהיר על הגדרות userConfig, כגון כתובת, אסימון או נתיב לתיקייה. עליכם לתקן ערך שהוזן באופן שגוי או להחליף אסימון בלי להתקין מחדש את התוסף. כל המידע שלהלן מבוסס על התיעוד הרשמי ועל יומן השינויים של Claude Code. המאמר אינו כולל הרצת בדיקה מקורית.

מידע על השימוש ב־Ailoot זמין בתיעוד.

מה נוסף בגרסה 2.1.285#

ברשומת יומן השינויים של Claude Code לגרסה 2.1.285 (קומיט מתאריך 29 בספטמבר 2026) מופיעות כמה שורות על תוספים. שתיים מהן רלוונטיות למאמר הזה:

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

כלומר, הפקודה החדשה claude plugin configure <plugin> מציגה את הגדרות התוסף ואת אלה שאינן מוגדרות, או שומרת ערכים חדשים שנקראים מהקלט הסטנדרטי כשמשתמשים בה עם --values-stdin.

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

כלומר, 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 and Plugins in Claude Code יכול לעזור לכם לבחור בין סוגי הרחבות. אם עדיין לא בחרתם תוסף, תוכלו להתחיל עם 10 התוספים המובילים ל־Claude Code. יש מדריך נפרד לבוט Telegram: התקנת תוסף בסוכן Telegram מתבצעת באופן שונה מהתקנת תוסף ב־Claude Code.

הכירו את Ailoot.