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

> Claude Code 2.1.285 הוסיפה את הפקודה claude plugin configure. איך לבדוק את הגדרות התוסף בתיעוד ולשנות אסימון או כתובת בלי להתקין מחדש.

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


<div class="aside" data-semantic="key-takeaway" role="note" aria-label="הנקודה המרכזית בסעיף זה">

הנקודה המרכזית

Claude Code 2.1.285 הוסיפה את פקודת המסוף `claude plugin configure <plugin>`. ללא דגלים, היא מציגה אילו הגדרות של התוסף מוגדרות ואילו אינן מוגדרות, בלי להציג את ערכיהן. באמצעות `--values-stdin`, היא שומרת ערכים חדשים מקובץ JSON שמועבר כקלט, בלי להתקין מחדש את התוסף. ערכים רגילים נשמרים ב־`settings.json` תחת `pluginConfigs`, ואילו ערכים של שדות המסומנים `sensitive: true` נשמרים במאגר האישורים המאובטח של המערכת.

</div>

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

מידע על השימוש ב־Ailoot זמין ב[תיעוד](https://ailoot.ai/docs/).



## מה נוסף בגרסה 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 ואילך. הפקודה אינה קיימת בגרסאות קודמות.

## במה היא שונה מ־<bdi>/plugin</bdi> 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`.

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

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

```bash
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 <bdi>--config</bdi>: הגדרת ערך במהלך ההתקנה

בהתקנה חדשה, `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` בערך משלכם. השאירו את המרכאות סביב הארגומנט.

```bash
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](https://ailoot.ai/blog/he/skills-subagents-mcp-plugins-claude-code/) יכול לעזור לכם לבחור בין סוגי הרחבות. אם עדיין לא בחרתם תוסף, תוכלו להתחיל עם 10 התוספים המובילים ל־Claude Code. יש מדריך נפרד לבוט Telegram: [התקנת תוסף בסוכן Telegram](https://ailoot.ai/blog/he/telegram-ai-agent-plugins/) מתבצעת באופן שונה מהתקנת תוסף ב־Claude Code.

<div class="section" role="doc-bibliography" aria-label="מקורות">

### מקורות

- [Claude Code CHANGELOG, רשומת 2.1.285](https://github.com/anthropics/claude-code/commit/ec44ca97dc86c33d934c8d55b24959aabf076871.patch)
- [Claude Code: מדריך פקודות התוספים](https://code.claude.com/docs/en/plugins/cli-reference.md)
- [Claude Code: מדריך למניפסט התוספים, הגדרות משתמש](https://code.claude.com/docs/en/plugins-reference.md)

</div>





הכירו את [Ailoot](https://ailoot.ai/).

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

### למה configure אומר שלא נמצא התוסף המותקן שלי?

השתמשו במזהה name@marketplace המלא מתוך claude plugin list ובדקו שהתוסף מותקן בתחום המתאים. הפקודה הזאת אינה מקבלת את שם התוסף הקצר לבדו.

### איך לבדוק אסימון שהשתנה בלי להדפיס אותו?

הריצו claude plugin configure עם המזהה המלא של התוסף ובדקו שהשדה הרגיש מסומן כמוגדר. הפעילו מחדש את Claude Code אחרי השמירה; אל תשמרו ב-commit את קובץ קלט ה-JSON שמכיל את האסימון.


## Ailoot · החברה ופורטפוליו הפרויקטים שלה

Ailoot נשענת על ניסיון תפעולי מצטבר, בסיס לקוחות רחב, שירות יציב ובקרה שוטפת של KPI.

החברה ופורטפוליו הפרויקטים שלה: מיליוני לקוחות; מכירות בהיקף של מיליארדים מדי חודש.

Ailoot משתמשת בניסיון התפעולי הזה כדי לספק גישת API ליכולות AI במוצרי לקוחות, בסוכנים, באפליקציות ובאוטומציות.