תיעוד 63
התקנה וניהול של תוספים
התקינו תוספים של Claude Code משוק בכל משטח שבו אתם משתמשים, בחרו היקף התקנה, ועדכנו או הסירו אותם אחר כך.
התקנת תוסף מוסיפה את הכישורים, הסוכנים, ה-hooks ושרתי ה-MCP שלו ל-Claude Code במחשב שלכם.
הדף הזה מיועד לכל מי שמשתמש בתוספים במחשב או בחשבון שלו, בין אם בטרמינל, באפליקציית שולחן העבודה, ב-IDE או בסשן ענן: הוא מכסה התקנה, בחירת היקף, הוספת שווקים ושמירה על תוספים מעודכנים.
[!NOTE]
המקרים האלה מכוסים בדפים אחרים:
- אתם משתמשים בצ'אט של claude.ai או ב-Cowork, לא ב-Claude Code: ראו תוספים ב-claude.ai וב-Cowork
- Claude Code הדפיס שגיאה: מצאו אותה ב-פתרון בעיות בתוספים
התחילו ב-התקנת תוסף. אם מישהו שלח לכם פקודת התקנה שהשם שאחרי @ בה אינו claude-plugins-official, הוסיפו את השוק הזה קודם.
#התקנת תוסף
לדוגמה, הסעיף הזה מתקין את commit-commands מהשוק הרשמי של Anthropic, שמוסיף פקודות לביצוע commit, ל-push ולפתיחת pull requests.
אותם שלבים מתקינים כל תוסף אחר: החליפו את שמו ואת שם השוק שלו בכל מקום שבו מופיעים commit-commands ו-claude-plugins-official. אם התוסף מגיע משוק אחר, הוסיפו את השוק קודם.
בחרו את הלשונית לפי המקום שבו אתם מריצים את Claude Code.
#טרמינל
הפעילו את Claude Code עם claude בפרויקט שלכם, ואז:
1. פתחו את פרטי התוסף עם פקודת ההתקנה
הריצו את /plugin install עם שם התוסף והשוק. בסשן, הפקודה הזו לא מתקינה מיד: היא פותחת את לוח /plugin על פרטי התוסף כדי שתוכלו לעיין בו ולבחור היקף קודם.
/plugin install commit-commands@claude-plugins-officialכדי לדפדף במקום זה, הריצו את /plugin בלי שם תוסף: הלוח נפתח בלשונית Discover, שמפרטת את התוספים מהשווקים שלכם, ואפשר להקליד כדי לחפש, ואז ללחוץ Enter על תוסף כדי לפתוח את הפרטים שלו.
2. עיינו במה שהתוסף מוסיף
חלונית הפרטים מציגה את תיאור התוסף. היא יכולה גם להציג:
- Will install: הפקודות, הסוכנים, הכישורים, ה-hooks ושרתי ה-MCP וה-LSP שהתוסף מוסיף.
- Last updated: מוצג עבור תוסף בשוק הרשמי של Anthropic.
- Context cost: עבור תוסף בשוק הרשמי של Anthropic, שתי הערכות אסימונים. Every turn הוא מה שהתוסף מוסיף לכל הודעה שאתם שולחים, ו-When invoked הוא מה שהכישורים והסוכנים שלו מוסיפים ברגע ש-Claude טוען אותם. ההערכות מופיעות כשפותחים את התוסף על ידי ציון השוק שלו, כמו שפקודת שלב 1 עושה, או מלשונית Marketplaces. חלונית הפרטים שאליה מגיעים מרשימת Discover לא מציגה אותן.
תוספים משוק מקומי או מותאם אישית יכולים להציג Components will be discovered at installation במקום זאת.
תוסף יכול להריץ hooks ושרתי MCP, אז קראו את החלונית לפני שאתם מתקינים. ראו אבטחה ואמון בתוספים.
3. בחרו היקף
בחרו אחת משלוש אפשרויות ההתקנה:
- Install for you (user scope): אתם מקבלים את התוסף בכל פרויקט במחשב הזה
- Install for all collaborators on this repository (project scope): הוא מופעל עבור כל מי שעובד במאגר הזה
- Install for you, in this repo only (local scope): אתם מקבלים אותו במאגר הזה בלבד
בחירת היקף התקנה אומרת לאיזה קובץ הגדרות כל אחת כותבת, ואיזו חלה כשאותו תוסף מוגדר ביותר מאחד.
אחרי שאתם בוחרים היקף, Claude Code מתקין את התוסף יחד עם כל תלות שהוא מצהיר עליה, ואז מדפיס סיכום התקנה.
4. קראו את סיכום ההתקנה
המשפט האחרון בסיכום אומר לכם אם התוסף כבר שמיש בסשן הזה:
- Active now:
Plugin is now active.אין צורך בטעינה מחדש. - Active, but a server needs setup: אחרי
Plugin is now active.מופיעIts bundled MCP server needs configuration before it can start. שרת ה-MCP הארוז של התוסף לא יכול להתחיל עד שתגדירו את האפשרויות שלו. בחרו את התוסף בלשונית Installed ב-/pluginובחרו Configure כדי להגדיר את אפשרויות השרת. - Reload needed:
Run /reload-plugins to apply.הלוח נסגר ו-Claude Code מריץ את הטעינה מחדש הזו עבורכם. אם הטעינה מחדש תבטל את מטמון הפרומפט, הוא מזהיר ומשאיר את התוסף במצב ממתין במקום זאת. הריצו את/reload-plugins --forceכדי להפעיל אותו בכל זאת, וזה עולה בקשה אחת בלי מטמון. - Load failed:
The plugin couldn't be loaded. פתחו את לשונית Errors ב-/pluginכדי לראות את הסיבה, ואז ראו אחרי התקנה: התוסף לא עובד.
5. אשרו שהתוסף עובד
הקלידו / וחפשו את הכישורים של התוסף תחת השם שלו, בצורה /<plugin>:<skill>. עבור commit-commands, מופיע /commit-commands:commit. שני מקומות נוספים מפרטים את התוסף גם כן:
- פתחו את לשונית Installed ב-
/plugin, שמפרטת את התוסף עם ההיקף שלו. - במעטפת שלכם, הריצו את
claude plugin list, שמדפיס את אותה רשימה עם שורותVersion,Scopeו-Status.
אם /commit-commands:commit לא מופיע, ראו אחרי התקנה: התוסף לא עובד.
התקנה מכל שוק אחר דורשת שלב נוסף אחד קודם: הוספת השוק. Claude Code מוסיף עבורכם את השוק הרשמי של Anthropic בפעם הראשונה שאתם מתחילים סשן טרמינל אינטראקטיבי, ולכן הדוגמה מדלגת על השלב הזה. אם מצאתם תוסף ב-claude.com/marketplace, כפתור Claude Code שלו מעתיק את פקודת ההתקנה בצורת המעטפת שלה, claude plugin install <name>@claude-plugins-official.
#אפליקציית שולחן העבודה
בסשן מקומי או SSH בלשונית Code של אפליקציית שולחן העבודה:
1. פתחו את דפדפן התוספים
לחצו על כפתור + ליד תיבת הפרומפט ובחרו Add plugins. אם תפריט + מציג Plugins במקום Add plugins, בחרו Plugins, ואז Browse plugins. דפדפן התוספים נפתח עם התוספים מהשווקים שלכם.
2. בחרו את התוסף
מצאו את commit-commands ובחרו אותו.
3. בחרו היקף
בחרו היקף: חשבון המשתמש שלכם, הפרויקט הזה, או מקומי בלבד.
כדי להפעיל, להשבית או להסיר תוסף אחר כך, ראו התקנת תוספים באפליקציית שולחן העבודה.
#VS Code
בלוח Claude Code ב-VS Code:
1. פתחו את Manage plugins
הקלידו /plugins בתיבת הפרומפט כדי לפתוח את Manage plugins.
2. התקינו את התוסף
בלשונית Plugins, חפשו את commit-commands ולחצו Install. אם הלשונית לא מפרטת תוספים, הוסיפו את anthropics/claude-plugins-official בלשונית Marketplaces קודם.
3. בחרו היקף
בחרו היקף: Install for you, Install for this project, או Install locally.
השינויים שלכם חלים על סשנים פתוחים בלי הפעלה מחדש. ראו ניהול תוספים ב-VS Code.
#סשן ענן
לסשן ענן, כולל הדפדפן ב-claude.ai/code, אין דפדפן תוספים והוא לא טוען את התוספים שהתקנתם במחשב שלכם או את אלה שקובץ .claude/settings.json של המאגר מפעיל. עבור תוספים שהארגון שלכם מפיץ דרך הגדרות מנוהלות, ראו ניהול תוספים לארגון שלכם.
ראו אילו חלקים מההגדרה שלכם זמינים גם בסשן ענן עבור שאר ההגדרה שלכם.
#בחירת היקף התקנה
היקף ההתקנה של תוסף קובע מי מקבל את התוסף ואיזה קובץ הגדרות רושם אותו כמופעל:
- User scope: התוסף מופעל עבורכם בכל פרויקט במחשב הזה. הרשומה נכנסת ל-
enabledPluginsב-~/.claude/settings.json. - Project scope: התוסף מופעל עבור כל מי שעובד במאגר הזה. הרשומה נכנסת ל-
.claude/settings.json, שאותו אתם מבצעים commit. ביצוע commit לרשומה הזו מפעיל את התוסף עבור השותפים שלכם אבל לא מוריד אותו למחשבים שלהם, ולכן כל שותף גם מריץ פעם אחת אתclaude plugin install <name>@<marketplace> --scope project. ראו מופעל בהגדרות הפרויקט אבל לא מותקן. - Local scope: התוסף מופעל עבורכם במאגר הזה בלבד. הרשומה נכנסת ל-
.claude/settings.local.json.
חלק מהתוספים מוגדרים על ידי המחבר שלהם להתחיל כבויים, דרך השדה defaultEnabled. תוסף כזה מותקן אבל נשאר כבוי עד שאתם מפעילים אותו עם claude plugin enable <name> במעטפת, או מלשונית Installed של /plugin בסשן.
כשאותו תוסף מוגדר בכמה היקפים, ההגדרה המקומית גוברת על הגדרת הפרויקט, והגדרת הפרויקט גוברת על הגדרת המשתמש. ראו מציאת המקום שבו תוסף מופעל לכלל המלא.
הטרמינל, הסשנים המקומיים של אפליקציית שולחן העבודה, והרחבת VS Code במחשב אחד קוראים את אותם קובצי הגדרות, ולכן תוסף שאתם מתקינים בהיקף משתמש בכל אחד מהם זמין בשניים האחרים.
#JetBrains, הרצות לא אינטראקטיביות, ו-Agent SDK
בחלק מהמקומות שבהם אתם מריצים את Claude Code אין דפדפן תוספים משלהם:
- JetBrains IDEs: תוסף JetBrains מריץ את Claude Code בטרמינל של ה-IDE, אז השתמשו שם בשלבים של לשונית Terminal.
claude -pוהרצות לא אינטראקטיביות אחרות:/pluginלא רץ, ו-Claude עונה/plugin isn't available in this environment.תוספים שכבר התקנתם כן נטענים. התקינו ונהלו אותם מהמעטפת עם פקודותclaude plugin.- Agent SDK: טענו תוספים דרך אפשרות התוסף של ה-SDK. ראו טעינת תוספים ב-Agent SDK.
אם Claude Code מדווח שתוסף שמופעל בקובץ .claude/settings.json של המאגר אינו מותקן, ראו מופעל בהגדרות הפרויקט אבל לא מותקן.
[!TIP]
אם אתם מחברי תוסף שבודקים עותק של התוסף שלכם על הדיסק, הפעילו את Claude Code מהמעטפת עם
--plugin-dirכדי לטעון אותו לסשן אחד במקום להתקין אותו. ראו דגלים שטוענים תוסף לסשן אחד.
#תוספים מחשבון claude.ai שלכם
חשבון claude.ai שלכם הוא מקור נפרד של תוספים, לצד השווקים שמהם אתם מתקינים:
- מה מגיע: כל תוסף שאתם מפעילים עבור חשבון claude.ai שלכם, וכל תוסף שהארגון שלכם מפעיל עבור החברים שלו. בסשן טרמינל הם מסתנכרנים ברקע בכל פעם שאתם מפעילים את Claude Code כשאתם מחוברים עם החשבון הזה. בסשני Cowork הם יורדים כשהסשן מתחיל.
- איפה רואים אותם: ב-
/pluginוב-claude plugin listתחת המזהה<name>@synced. אפשר לכבות אחד בהיקף שלכם, אלא אם הארגון שלכם דורש אותו. - מה לא עובר לכיוון השני: תוספים שאתם מתקינים עם
/pluginאוclaude plugin installנשארים במחשב הזה ולא מתווספים לחשבון claude.ai שלכם.
לעיתוי הסנכרון, לדרישות ההתחברות ולכיבוי הסנכרון, ראו תוספים שמסונכרנים מ-claude.ai.
#התקנה מהמעטפת
הריצו את claude plugin install במעטפת כדי להתקין תוסף בלי להתחיל סשן Claude Code, למשל מסקריפט הגדרה.
- היקף: היקף משתמש כברירת מחדל. העבירו
--scope projectאו--scope localכדי לשנות אותו. - מתי התוספים נטענים: תוספים שהוא מתקין נטענים בפעם הבאה שאתם מפעילים את Claude Code, או כשאתם מריצים את
/reload-pluginsבסשן שכבר פתוח. - השוק במחשב חדש: במחשב שעדיין אף אחד לא פתח בו סשן Claude Code אינטראקטיבי, השוק הרשמי אינו רשום, ולכן סקריפט שמתקין ממנו מריץ את
claude plugin marketplace add anthropics/claude-plugins-officialלפני ההתקנה. ראו הוספה והתקנה מהמעטפת.
claude plugin install formatter@your-org --scope projectהפקודה מדפיסה Successfully installed plugin: formatter@your-org (scope: project) כשהיא מסתיימת.
חלק מהתוספים מותקנים על ידי הרצת פקודה שהשוק שלהם מציין, שנקראת מקור command. Claude Code מציג לכם את הפקודה הזו ומבקש מכם לאשר אותה לפני שהיא רצה. לסקריפט אין מי שיענה להנחיה הזו, אז העבירו שם --yes כדי לאשר אותה.
לשאר הדגלים של claude plugin install, ראו plugin install.
#הוספת שוק
הסעיף הזה נחוץ רק כשהתוסף שאתם רוצים אינו בשוק הרשמי של Anthropic, למשל אחד שעמית לעבודה פרסם או אחד משוק הקהילה של Anthropic.
שוק הוא קטלוג של תוספים, ו Claude Code צריך להכיר שוק לפני שאפשר להתקין ממנו. מוסיפים שוק פעם אחת. אחרי זה, התוספים שלו מופיעים בלשונית Discover ומתקינים עם /plugin install <plugin>@<marketplace> בסשן או claude plugin install <plugin>@<marketplace> במעטפת, כאשר <marketplace> הוא השם שהשוק נרשם תחתיו. כדי לעשות את שניהם בצעד אחד, ראו הוספת שוק והתקנה בפקודה אחת.
בסשן של Claude Code, הריצו /plugin marketplace add ואחריו את המקור של השוק: מאגר GitHub, מאגר git על כל מארח, תיקייה או קובץ מקומיים, או marketplace.json מתארח.
| מקור | מה מקלידים | דוגמה |
|---|---|---|
| מאגר GitHub | owner/repo. הוסיפו #ref כדי לנעוץ ענף או תגית. | /plugin marketplace add anthropics/claude-plugins-official, או /plugin marketplace add your-org/plugins#v1.2.0 כדי לנעוץ את התגית v1.2.0 |
| מאגר git על כל מארח | כתובת ה clone המלאה. הוסיפו #ref כדי לנעוץ ענף או תגית. | /plugin marketplace add https://gitlab.example.com/your-group/your-marketplace.git#v1.0.0 |
| תיקייה או קובץ מקומיים | נתיב יחסי או מוחלט לתיקייה שמחזיקה את .claude-plugin/marketplace.json, או לקובץ ה JSON עצמו. התחילו נתיב יחסי ב ./ או ../, כי Claude Code קורא name/name חשוף כמאגר GitHub. | /plugin marketplace add ./my-marketplace |
marketplace.json מתארח | כתובת ה https:// שלו | /plugin marketplace add https://example.com/marketplace.json |
מהמעטפת, claude plugin marketplace add מקבל את אותם מקורות.
[!TIP]
/plugin marketפועל גם כצורה קצרה של/plugin marketplace.
כללו את הקידומת https:// בכל כתובת, או השתמשו בצורה git@host:path עבור SSH. אם מקלידים gitlab.example.com/your-group/your-marketplace.git חשוף, Claude Code קורא אותו כקיצור GitHub מסוג owner/repo ודוחה אותו.
כשהפקודה מצליחה, היא מדפיסה Successfully added marketplace: <name>, והתוספים של השוק מופיעים בלשונית Discover בפעם הבאה שפותחים את /plugin, בלי צורך בטעינה מחדש. אם היא נכשלת, התאימו את הודעת השגיאה ב פתרון בעיות בתוספים.
#הוספת שוק והתקנה בפקודה אחת
כדי להתקין תוסף משוק שעדיין לא הוספתם, ציינו את מקור השוק עם --marketplace בפקודת ההתקנה, בסשן או מהמעטפת. המקור מקבל אותן צורות כמו /plugin marketplace add, כגון GitHub owner/repo, כתובת git, או נתיב מקומי. תנו את שם התוסף לבדו, בלי סיומת @marketplace.
#הוספה והתקנה בסשן
הריצו /plugin install בסשן של Claude Code עם התוסף והמקור. נדרש Claude Code v2.1.275 או חדש יותר. בסשן, המקור לא יכול להכיל רווחים.
/plugin install deploy-helper --marketplace your-org/pluginsאם עדיין לא הוספתם את השוק הזה, Claude Code מציג את המקור שפתר ומבקש לאשר לפני ההוספה. אחרי שהשוק נוסף, פרטי התוסף נפתחים ובוחרים היקף התקנה. אם המקור תואם לשוק שכבר הוספתם, Claude Code מדלג על האישור ופותח את פרטי התוסף בשוק הזה.
#הוספה והתקנה מהמעטפת
במעטפת, בלי להתחיל סשן, הריצו claude plugin install עם התוסף והמקור. נדרש Claude Code v2.1.292 או חדש יותר.
claude plugin install deploy-helper --marketplace your-org/pluginsפקודת המעטפת מוסיפה את השוק בלי שלב אישור. שוק שכבר הוספתם מאותו מקור נמצא בשימוש חוזר. שוק חדש נוסף תחת אותן בדיקות מדיניות ארגון כמו claude plugin marketplace add, ומוצהר בהגדרות המשתמש גם כשמעבירים --scope project.
אם עדיין לא הוספתם את השוק הזה, הפקודה מדפיסה Successfully added marketplace: <name> (declared in user settings) ואז מתקינה את התוסף.
#הוספת שוק פרטי
שוק פרטי הוא שוק במאגר שצריך אישורי גישה כדי לשכפל אותו, ב GitHub או בכל מארח git אחר. מוסיפים אותו באותה פקודה /plugin marketplace add או claude plugin marketplace add כמו שוק ציבורי. Claude Code משכפל אותו עם אישורי ה git שכבר נמצאים במכונה ולעולם לא מבקש קלט, ולכן לכל דרך חיבור יש דרישה:
- HTTPS: עוזרי אישורי הגישה של git חלים, כך שגישה שהגדרתם עם
gh auth login, ה Keychain של macOS, אוgit-credential-storeעובדת. הבקשות של Git ותוכניות askpass כבויות, כולל אחת שהוגדרה בGIT_ASKPASS, ולכן השכפול נכשל במקום לבקש קלט כש git היה צריך לבקש אישור גישה. - SSH: המארח חייב כבר להיות בקובץ
known_hostsוהמפתח חייב לעבוד בלי בקשת ביטוי סיסמה. אם הגדרת ה git מציינת תוכנית SSH בGIT_SSH_COMMAND, בGIT_SSH, או בcore.sshCommandשל הגדרות ה git, Claude Code מריץ את התוכנית הזו. - קיצור GitHub
owner/repo: Claude Code בודק אם מפתח ה SSH שלכם מאמת מולgithub.com, ואז משכפל דרך SSH אם כן ודרך HTTPS אם לא. הגדירוCLAUDE_CODE_PLUGIN_PREFER_HTTPS=1כדי לדלג על הבדיקה הזו ותמיד לשכפל דרך HTTPS.
אותם אישורי גישה חלים כשמריצים /plugin install, /plugin marketplace update, ו claude plugin update.
במארח GitHub Enterprise Server, ראו שוקי תוספים ב GHES לאישורי הגישה שכל פעולה צריכה.
אם הארגון רושם עבורכם את השוק דרך הגדרות מנוהלות, אתם לא מוסיפים אותו בעצמכם. ראו התקנה מראש ודרישת תוספים.
#הוספת שוק מ claude.ai
בסשנים בטרמינל שבהם תוספים מסתנכרנים מחשבון claude.ai, claude.ai יכול גם לרשום עבורכם שוקי תוספים, כגון ספריית התוספים של הארגון וההעלאות שלכם ל claude.ai. מוסיפים אחד מאלה לפי השם ולא לפי מקור. הוספת שוק מ claude.ai דורשת Claude Code v2.1.273 או חדש יותר.
הוסיפו שוק של claude.ai מלוח /plugin או מהמעטפת:
- בתוך סשן: הריצו
/pluginועברו ללשונית Marketplaces, שמציגה את השווקים מ claude.ai. בחרו שם אחד כדי להוסיף אותו. - מהמעטפת: הריצו
claude plugin marketplace list, שמדפיס אותם במקטעFrom claude.ai:. אחר כך הריצוclaude plugin marketplace addעם הדגל--claudeaiוהשם שמופיע ברשימה.
לדוגמה, הפקודה הזו מוסיפה שוק בשם claudeai-organization-library:
claude plugin marketplace add --claudeai claudeai-organization-libraryClaude Code רושם את השוק תחת שם מקומי שמתחיל ב claudeai-, שנגזר מהשם ש claude.ai מציג אותו תחתיו. לדוגמה, שוק שרשום כ "Organization library" הופך ל claudeai-organization-library. התקינו את התוספים שלו לפי השם הזה, למשל עם claude plugin install <plugin>@claudeai-organization-library.
אם יוצאים מהחשבון, או נכנסים לארגון claude.ai אחר, השוק נשאר מוגדר אבל לא מציג תוספים, והתוספים שכבר התקנתם ממנו ממשיכים להיטען.
המקטע From claude.ai: יכול גם לרשום שווקים מבוססי git ששותפו דרך claude.ai, והוא מדפיס מקור לכל אחד מהם. הוסיפו אותם לפי המקור הזה כמו ב הוספת שוק, לא עם --claudeai.
#ניהול תוספים מותקנים
לשונית Installed ב /plugin מציגה את התוספים שלכם עם פעולות להפעלה, להשבתה, לעדכון, או להסרה של כל אחד. בסשן של Claude Code, הריצו /plugin ולחצו על Tab כדי להגיע אליה, או הריצו /plugin enable, /plugin disable, או /plugin uninstall כדי לפתוח את הלוח ולבצע שם את השינוי. תוספים מושבתים מקובצים תחת כותרת מכווצת בתחתית הרשימה. השתמשו במקשים האלה ברשימה:
- הקלידו כדי לסנן לפי שם או תיאור.
- לחצו על Space כדי להפעיל או להשבית את התוסף שנבחר, ועל f כדי לסמן אותו כמועדף.
- לחצו על Enter כדי לפתוח את פרטי התוסף.
תפריט הפרטים של תוסף מציע Disable plugin או Enable plugin, Update now, ו Uninstall. שני פריטים נוספים מופיעים לתוספים שמקבלים הגדרות, ותוסף יכול להציג את שניהם:
- Configure options: מוצג כשמניפסט התוסף מצהיר על אפשרויות
userConfig. פותח את תיבת הדו שיח של האפשרויות האלה - Configure: מוצג כשהתוסף כולל שרת MCP ארוז. מגדיר את הגדרות
user_configשל השרת עצמו
הלשונית יכולה גם להציג תוספים בהיקף Managed. הארגון התקין אותם דרך הגדרות מנוהלות, ואי אפשר להפעיל, להשבית, או להסיר אותם כאן.
לתוסף מסונכרן שהארגון דורש ב claude.ai, ראו ניהול תוספים שמסונכרנים מ claude.ai.
כשסוגרים את לוח /plugin עם שינויים ממתינים שעשיתם בו, Claude Code מריץ עבורכם /reload-plugins כדי להחיל אותם. אם הטעינה מחדש תפסול את מטמון הפרומפט, הוא מזהיר ומשאיר את השינויים ממתינים. הריצו /reload-plugins --force כדי להחיל אותם בכל זאת.
#ניהול תוספים שמסונכרנים מ claude.ai
לשונית Installed ב /plugin מציגה גם את התוספים שמסונכרנים מחשבון claude.ai, עם synced כמקור שלהם. תוספים מסונכרנים מופיעים בסשנים בטרמינל ב Claude Code v2.1.273 או חדש יותר.
- הפעלה או השבתה: השתמשו בלשונית Installed, אלא אם הארגון סימן את התוסף כנדרש.
- הסרה: כבו את התוסף ב claude.ai.
כש Claude Code מסנכרן תוסף שנוסף, עודכן, או הוסר לתוך סשן אינטראקטיבי, רואים Plugins changed. Run /reload-plugins to activate. הריצו /reload-plugins כדי לטעון את השינוי בסשן הזה, או השאירו אותו לפעם הבאה שמתחילים את Claude Code.
#הסרת תוסף שהפרויקט מפעיל
כשבוחרים Uninstall לתוסף ש .claude/settings.json של המאגר הזה מפעיל, בין מלשונית Installed ובין עם /plugin uninstall, Claude Code שואל אם להשבית אותו עבורכם או להסיר אותו לכולם:
- Disable for me: לחצו על y. Claude Code כותב
falseעבור התוסף ב.claude/settings.local.jsonומשאיר אותו מותקן עבור הפרויקט. - Uninstall for everyone: לחצו על u. Claude Code מסיר את התוסף מ
.claude/settings.jsonהמשותף.
#לראות מה תוסף מותקן מוסיף לסשנים
במעטפת, הריצו claude plugin details <name> עבור תוסף מותקן. השורה Always-on היא מספר האסימונים שהתוסף מוסיף לכל סשן שבו הוא מופעל, ושורות הרכיבים מראות איזה skill או agent תורם הכי הרבה. לפלט המלא ולמשמעות של כל נתון, ראו מדידת העלות של תוסף.
#מציאת תוספים שכבר לא בשימוש
בלשונית Installed ב /plugin, תוספים שהתקנתם בעצמכם ולא השתמשתם בהם לאחרונה מופיעים תחת כותרת Not used recently, ופרטי כל תוסף מציגים שורת Last used. השתמשו בכותרת הזו ובשורה הזו כדי למצוא תוספים שעדיין מוסיפים עלות הפעלה והקשר, ואז השביתו או הסירו אותם.
#תוספים עם תלויות
תוסף יכול להצהיר על תוספים אחרים שהוא תלוי בהם. כשמתקינים, משביתים, או מסירים תוסף כזה משוק, Claude Code פועל גם על התלויות האלה:
- Install: Claude Code גם מתקין ומפעיל את התלויות המוצהרות של התוסף באותו היקף. הודעת ההצלחה מפרטת אותן.
- Enable: Claude Code גם מפעיל את התלויות של התוסף שמותקנות אבל מושבתות. אם תלות מוצהרת אינה מותקנת, ההפעלה נכשלת וההודעה אומרת להתקין אותה קודם.
- Disable: כשתוסף מופעל אחר עדיין צריך את זה שציינתם, Claude Code מסרב ומדפיס פקודה משורשרת שמשביתה את שניהם בסדר הנכון.
- Uninstall: תלויות שהותקנו אוטומטית נשארות עד שמריצים
claude plugin pruneבמעטפת. ראו plugin prune.
אם טענתם את התוסף עם --plugin-dir במקום זאת, ראו בדיקת תוסף והתלות שלו באופן מקומי.
#ניהול תוספים מהמעטפת
אפשר גם לנהל תוספים בלי להתחיל סשן של Claude Code. במעטפת, הריצו claude plugin install, enable, disable, או uninstall כפקודות טרמינל רגילות. הן משנות את אותן הגדרות שלוח /plugin משנה. כל אחת מקבלת --scope כדי לכוון להיקף אחד, ומשתמשת בהיקף ברירת מחדל כשמשמיטים אותו:
enableוdisableפועלים על ההיקף הספציפי ביותר שההגדרות שלו כבר רושמות את התוסף.installוuninstallפועלים על היקף המשתמש.
לדוגמה, הפקודות האלה משביתות ומפעילות מחדש תוסף, ואז מסירות אותו בהיקף הפרויקט:
claude plugin disable formatter@your-org
claude plugin enable formatter@your-org
claude plugin uninstall formatter@your-org --scope project#שמירה על תוספים מעודכנים
תוספים מתעדכנים אוטומטית כשלשוק שממנו הגיעו יש עדכון אוטומטי מופעל. אחרי שסשן מתחיל, Claude Code מרענן את השווקים האלה ומעדכן את העותקים על הדיסק של התוספים שהתקנתם מהם.
הסשן שרץ שומר את הגרסאות שכבר טען. אחרי עדכון, רואים Plugin updated: <name> · Run /reload-plugins to apply, והסשן הבא טוען את הגרסאות החדשות אוטומטית.
אלה ברירות המחדל של עדכון אוטומטי לכל סוג שוק:
- מופעל כברירת מחדל:
claude-plugins-officialושאר שמות השווקים הרשמיים מלבדknowledge-work-pluginsוfirst-party-plugins, ובנוסף שווקים שנוספו מ claude.ai. - כבוי כברירת מחדל: כל שוק אחר, כולל שוק הקהילה, שווקים של צד שלישי, ושווקי פיתוח מקומיים.
למועד שבו עדכון אוטומטי רץ, לתוספים שהוא מדלג עליהם, ולמשתני הסביבה שמכבים אותו, ראו מתי עדכון אוטומטי רץ.
#הפעלה או כיבוי של עדכון אוטומטי לשוק
בסשן של Claude Code, הריצו /plugin ועברו ללשונית Marketplaces. בחרו את השוק, ואז בחרו Enable auto-update או Disable auto-update.
#עדכון תוספים עכשיו
כדי לעדכן תוסף אחד, פתחו אותו בלשונית Installed ב /plugin במהלך סשן ובחרו Update now, או הריצו claude plugin update <plugin>@<marketplace> במעטפת.
אין פקודה שמעדכנת את כל התוספים בבת אחת. כדי לעדכן בבת אחת את התוספים שהתקנתם משוק אחד, עברו ללשונית Marketplaces ב /plugin, בחרו את השוק, ובחרו Update marketplace. זה מרענן את הרישום של השוק, מעדכן את התוספים שהתקנתם ממנו, ומדווח על כל תוסף שהשאיר לכם לעדכן בעצמכם. תוסף עם מקור command או עם רשומת שוק שמגדירה פקודת headersHelper אינו מתעדכן בדרך הזו, ולכן מעדכנים אותו מהתצוגה שלו בלשונית Installed או עם claude plugin update <plugin>@<marketplace>.
אם מריצים claude plugin marketplace update במעטפת בלי שם, זה מרענן את הרישום של כל שוק אבל משאיר את התוספים המותקנים בגרסאות הנוכחיות שלהם.
#עדכון אוטומטי משוק פרטי
לשוק פרטי, ראו מה עדכון אוטומטי ברקע עושה עם אישורי גישה לאופן שבו עדכונים אוטומטיים ברקע מאמתים דרך SSH ו HTTPS, ו פתרון בעיות בתוספים להודעות שרואים כשהם נכשלים.
#ניהול שווקים
לשונית Marketplaces ב /plugin מציגה כל שוק שרשמתם, יחד עם המקור שלו. בחרו אחד כדי לעיין בתוספים שלו, לעדכן את הרישום שלו, להפעיל או לכבות עדכון אוטומטי, או להסיר אותו.
אפשר גם להציג, לעדכן, ולהסיר שווקים בפקודות, מהמעטפת או בתוך סשן:
| פעולה | במעטפת | בתוך סשן |
|---|---|---|
| הצגת שווקים | claude plugin marketplace list | /plugin marketplace list |
| עדכון הרישום של שוק | claude plugin marketplace update <name> | /plugin marketplace update <name> |
| הסרת שוק | claude plugin marketplace remove <name> | /plugin marketplace remove <name> |
כשמסירים שוק, Claude Code מסיר כל תוסף שהתקנתם ממנו ומסיר את רשומות enabledPlugins שלהם מקובצי ההגדרות. לשונית Marketplaces מציינת את התוספים האלה לפני שהיא מבקשת אישור.
#השלבים הבאים
- השווקים של Anthropic: איך השוק הרשמי ושוק הקהילה נבדלים, ואיפה לעיין בכל אחד
- מדריך טעינת תוספים: למה תוסף נטען, לא נטען, או לא השתנה אחרי עדכון
- אבטחה ואמון בתוספים: מה לבדוק לפני שמתקינים תוסף משוק שאינך מכיר
- פתרון בעיות בתוספים: הודעות שגיאה של התקנה ושל שוק, והתיקונים שלהן
- יצירת תוסף: בנה תוסף משלך