📘 תיעוד 42

גילוי והתקנה של תוספים מוכנים מראש דרך שווקים

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

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

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

מעוניין ליצור ולהפיץ שוק משלך? ראה יצירה והפצה של שוק תוספים.

#כיצד שווקים פועלים

שוק הוא קטלוג של תוספים שמישהו אחר יצר ושיתף. שימוש בשוק הוא תהליך בעל שני שלבים:

1. הוספת השוק: פעולה זו רושמת את הקטלוג ב-Claude Code כדי שתוכל לעיין במה שזמין. בשלב זה עדיין לא מותקנים תוספים.
2. התקנת תוספים בודדים: עיין בקטלוג והתקן את התוספים הרצויים.

#השוק הרשמי של Anthropic

Claude Code מוסיף את השוק הרשמי של Anthropic (claude-plugins-official) באופן אוטומטי בפעם הראשונה שתפעיל אותו בצורה אינטראקטיבית. אם Claude Code אינו מצליח להוסיף אותו, למשל בגלל שהרשת שלך חוסמת את ההורדה או שמדיניות שווקים (marketplace policy) חסמה ניסיון קודם, הוסף אותו בעצמך באמצעות הפקודה /plugin marketplace add anthropics/claude-plugins-official.

כדי לעיין במה שזמין, הרץ /plugin ועבור ללשונית Discover, או צפה בקטלוג בכתובת claude.com/plugins.

כדי להתקין תוסף מהשוק הרשמי, השתמש בפקודה /plugin install <name>@claude-plugins-official. לדוגמה, כדי להתקין את האינטגרציה של GitHub:

/plugin install github@claude-plugins-official

הפקודה /plugin פותחת חלונית אינטראקטיבית ב-CLI של הטרמינל. אם Claude משיב שהפקודה /plugin אינה זמינה בסביבה זו, השתמש ב-דפדפן התוספים באפליקציית Claude לשולחן העבודה, או הצהר על התוסף תחת enabledPlugins בקובץ .claude/settings.json עבור הפעלות ענן.

אם ההתקנה נכשלת, פעל לפי ההודעה ש-Claude Code מדווח:

• Marketplace "claude-plugins-official" not found: הוסף את השוק באמצעות /plugin marketplace add anthropics/claude-plugins-official, ולאחר מכן נסה שוב להתקין.
• התוסף לא נמצא בשוק: בדוק את שם התוסף.

הערה: השוק הרשמי מנוהל על ידי Anthropic, וההכללה בו היא לפי שיקול דעתה של Anthropic. טפסי ההגשה בתוך האפליקציה מוסיפים תוספים אל השוק הקהילתי, ולא לשוק הרשמי. כדי להפיץ תוספים באופן עצמאי, צור שוק משלך ושתף אותו עם משתמשים.

השוק הרשמי כולל מספר קטגוריות של תוספים:

#תבונת קוד (Code intelligence)

תוספי תבונת קוד מפעילים את כלי ה-LSP המובנה של Claude Code, ומעניקים ל-Claude את היכולת לקפוץ להגדרות, למצוא הפניות, ולראות שגיאות טיפוסים מיד לאחר עריכות. תוספים אלה מגדירים חיבורי Language Server Protocol, אותה טכנולוגיה שמפעילה את תבונת הקוד של VS Code. ב-הפעלות ענן, Claude Code אינו מפעיל שרתי שפה של תוספים, ולכן Claude אינו מקבל שם את כלי ה-LSP.

התקן את הקובץ הבינארי של שרת השפה מהטבלה שלהלן לפני השימוש בתוספים אלה, התוסף אינו מתקין אותו עבורך. אם כבר מותקן אצלך שרת שפה, Claude עשוי להציע לך להתקין את התוסף המתאים כאשר תפתח פרויקט.

#| csharp-lsp | csharp-ls |

| Go | gopls-lsp | gopls | | Java | jdtls-lsp | jdtls | | Kotlin | kotlin-lsp | kotlin-language-server | | Lua | lua-lsp | lua-language-server | | PHP | php-lsp | intelephense | | Python | pyright-lsp | pyright-langserver | | Rust | rust-analyzer-lsp | rust-analyzer | | Swift | swift-lsp | sourcekit-lsp | | TypeScript | typescript-lsp | typescript-language-server |

ניתן גם ליצור תוסף LSP משלך עבור שפות אחרות.

הערה: אם מופיעה השגיאה Executable not found in $PATH בלשונית ה-Errors של /plugin לאחר התקנת תוסף, התקן את הקובץ הבינארי המופיע בטבלת תבונת קוד עבור אותו תוסף.

#מה ש-Claude מקבל מתוספי תבונת קוד

ברגע שתוסף תבונת קוד מותקן והקובץ הבינארי של שרת השפה שלו זמין, Claude מקבל שתי יכולות:

• אבחון אוטומטי (Automatic diagnostics): לאחר כל עריכת קובץ ש-Claude מבצע, שרת השפה מדווח בחזרה על שגיאות ואזהרות, כך ש-Claude רואה שגיאות טיפוסים, ייבואים חסרים ובעיות תחביר מבלי להריץ מהדר או linter. אם Claude מכניס שגיאה, הוא מבחין בה ומתקן אותה באותו התור.
• ניווט בקוד (Code navigation): Claude יכול להשתמש בשרת השפה כדי לקפוץ להגדרות, למצוא הפניות, לקבל מידע על טיפוסים בריחוף סמן (hover), לרשום סמלים (symbols), למצוא מימושים ולעקוב אחר היררכיות קריאה. פעולות אלו מעניקות ל-Claude ניווט מדויק יותר מאשר חיפוש מבוסס grep, אם כי הזמינות עשויה להשתנות לפי השפה והסביבה.

אין צורך להגדיר אבחונים מעבר להתקנת התוסף. כדי לקרוא אותם בעצמך, לחץ על Ctrl+O כאשר Claude Code מציג חיווי כגון Found 3 new diagnostic issues in 2 files.

אם נתקלת בבעיות, ראה פתרון בעיות בתבונת קוד.

#אינטגרציות חיצוניות

תוספים אלה כוללים שרתי MCP מוגדרים מראש, כדי שתוכל לחבר את Claude לשירותים חיצוניים ללא הגדרה ידנית:

• בקרת גרסאות: github, gitlab
• ניהול פרויקטים: atlassian (Jira/Confluence), asana, linear, notion
• עיצוב: figma
• תשתית: vercel, firebase, supabase
• תקשורת: slack
• ניטור: sentry

#סקירת אבטחה אוטומטית

התוסף security-guidance בודק כל שינוי ש-Claude מבצע לאיתור פגיעויות נפוצות ומורה ל-Claude לתקן את מה שהוא מוצא באותו session. ראה איתור בעיות אבטחה בזמן ש-Claude כותב קוד כדי ללמוד מה הוא בודק וכיצד להוסיף כללים ספציפיים לפרויקט.

#תהליכי עבודה לפיתוח (Development workflows)

תוספים שמוסיפים מיומנויות וסוכנים למשימות פיתוח נפוצות:

• commit-commands: תהליכי עבודה של git commit כולל commit, push ויצירת PR
• pr-review-toolkit: סוכנים ייעודיים לסקירת pull requests
• agent-sdk-dev: כלים לבנייה עם ה-Claude Agent SDK
• plugin-dev: ערכת כלים ליצירת תוספים משלך

#סגנונות פלט (Output styles)

התאמה אישית של האופן שבו Claude מגיב:

• explanatory-output-style: תובנות לימודיות לגבי בחירות מימוש
• learning-output-style: מצב למידה אינטראקטיבי לבניית מיומנויות

#השוק הקהילתי

השוק הקהילתי בכתובת anthropics/claude-plugins-community מארח תוספי צד שלישי שעברו את תהליך האימות האוטומטי ובדיקת הבטיחות של Anthropic. כל תוסף מקובע ל-commit SHA ספציפי בקטלוג. שלא כמו השוק הרשמי, עליך להוסיף אותו ידנית:

/plugin marketplace add anthropics/claude-plugins-community

לאחר מכן התקן ממנו תוספים באמצעות שם השוק claude-community:

/plugin install <plugin-name>@claude-community

כדי להגיש תוסף משלך לשוק הקהילתי, ראה הגשת התוסף שלך לשוק הקהילתי במדריך ליצירת תוספים.

#נסה זאת בעצמך: הוספת שוק ההדגמה

חברת Anthropic מתחזקת גם שוק תוספי הדגמה (claude-code-plugins) עם תוספים לדוגמה שמראים מה אפשרי במערכת התוספים. שלא כמו השוק הרשמי, עליך להוסיף שוק זה ידנית.

1. הוספת השוק: מתוך Claude Code, הרץ את הפקודה plugin marketplace add עבור השוק anthropics/claude-code:

   העתק

   /plugin marketplace add anthropics/claude-code

   פעולה זו מורידה את קטלוג השוק והופכת את התוספים שבו לזמינים עבורך.

2. עיון בתוספים זמינים: הרץ /plugin כדי לפתוח את מנהל התוספים. פעולה זו פותחת ממשק לשוניות שניתן לנווט ביניהן באמצעות Tab, או Shift+Tab כדי לחזור אחורה:

   • Discover: עיון בתוספים זמינים מכל השווקים שלך
   • Installed: צפייה וניהול של התוספים המותקנים שלך
   • Marketplaces: הוספה, הסרה או עדכון של השווקים שהוספת
   • Errors: צפייה בשגיאות טעינה של תוספים
   • Stats: צפייה ב-עלות של כל אחת מהמיומנויות שלך בהקשר ובאיזו תדירות נעשה בה שימוש, בהפעלות שבהן הפקודה /skill-doctor זמינה

   עבור ללשונית Discover כדי לראות תוספים מהשוק שהרגע הוספת. כאשר מנהל המערכת שלך אישר את השוק ברשימת ההיתרים דרך ההגדרה המנוהלת pluginSuggestionMarketplaces, תוספים המסומנים כרלוונטיים לתיקיית העבודה הנוכחית שלך מוצמדים למעלה עם התווית suggested for this directory.

3. התקנת תוסף: בחר תוסף כדי להציג את פרטיו. חלונית הפרטים מציגה מה התוסף מכיל ומה העלות שלו:

   • הערכת Context cost כדי שתוכל לראות כמה טוקנים התוסף יוסיף ל-חלון ההקשר שלך בכל תור
   • תאריך Last updated של התוסף
   • סעיף Will install המפרט את הפקודות, הסוכנים, המיומנויות, ה-hooks ושרתי ה-MCP וה-LSP של התוסף, כדי שתוכל לבדוק בדיוק מה הוא מוסיף לפני ההתקנה

   לא כל תוסף מספק את הנתונים שמאחורי השדות האלה. עבור תוספים משווקים מקומיים או מותאמים אישית, ייתכן שלא תראה את שורות Context cost ו-Last updated, וסעיף Will install עשוי להציג במקום זאת Components will be discovered at installation.

   בחר טווח התקנה (installation scope):

   • User scope: התקנה עבור עצמך בכל הפרויקטים
   • Project scope: התקנה עבור כל השותפים במאגר זה
   • Local scope: התקנה עבור עצמך במאגר זה בלבד

   לדוגמה, בחר ב-commit-commands, תוסף שמוסיף מיומנויות של תהליכי עבודה ב-git, והתקן אותו ב-user scope שלך.

   ניתן גם להתחיל את ההתקנה משורת הפקודה:

   העתק

   /plugin install commit-commands@claude-code-plugins

   ראה קובצי הגדרות כדי לקרוא עוד על טווחים.

4. שימוש בתוסף החדש שלך: אם סיכום ההתקנה מדווח Run /reload-plugins to activate., Claude Code מריץ את הטעינה מחדש הזו עבורך. אם הטעינה מחדש מזהירה שההודעה הבאה שלך תקרא מחדש את השיחה, הרץ /reload-plugins --force כדי להפעיל את התוסף.

   מיומנויות של תוספים מקבלות קידומת לפי שם התוסף, כך ש-commit-commands מספק מיומנויות כמו /commit-commands:commit.

   נסה זאת על ידי ביצוע שינוי בקובץ והרצת:

   העתק

   /commit-commands:commit

   פעולה זו מעבירה את השינויים שלך ל-stage, מייצרת הודעת commit, ויוצרת את ה-commit.

   כל תוסף פועל בצורה שונה. בדוק את פרטי התוסף בלשונית Discover כדי לראות את הפקודות והמיומנויות שהוא מספק, או בקר בדף הבית שלו להנחיות שימוש.

#הוספת שווקים

השתמש בפקודה /plugin marketplace add כדי להוסיף שווקים ממקורות שונים.

טיפ קיצורים: ניתן להשתמש ב-/plugin market במקום ב-/plugin marketplace, וב-rm במקום ב-remove.

• מאגרי GitHub: בפורמט owner/repo, לדוגמה anthropics/claude-code
• כתובות Git: כל כתובת URL של מאגר git, כולל GitLab, Bitbucket ושרתים באירוח עצמי
• נתיבים מקומיים: ספריות או נתיבים ישירים לקובצי marketplace.json
• כתובות URL מרוחקות: כתובות URL ישירות לקובצי marketplace.json מתארחים

#הוספה מ-GitHub

הוסף מאגר GitHub המכיל קובץ .claude-plugin/marketplace.json באמצעות הפורמט owner/repo, כאשר owner הוא שם המשתמש או הארגון ב-GitHub ו-repo הוא שם המאגר.

לדוגמה, anthropics/claude-code מתייחס למאגר claude-code שבבעלות anthropics:

/plugin marketplace add anthropics/claude-code

#הוספה מספקי Git אחרים

הוסף מאגר שוק של git על ידי אספקת כתובת ה-URL המלאה שלו. עבור כתובת https://, שאלת הכללת הסיומת .git תלויה בספק המארח:

• github.com ו-gitlab.com: Claude Code מזהה כתובת URL של מאגר עם או בלי הסיומת .git ומשכפל אותו. הוספת כתובת gitlab.com ללא הסיומת דורשת את Claude Code בגרסה v2.1.232 ואילך. לפני גרסה v2.1.232, Claude Code התייחס אליה כאל קישור ישיר לקובץ marketplace.json מתארח.
• Azure DevOps: השמט את הסיומת. Claude Code משכפל כל כתובת URL שהנתיב שלה מכיל /_git/. אם תוסיף .git לנתיב /_git/, השכפול ייכשל.
• כל שאר המארחים, כולל שרתי GitLab בניהול עצמי: כלול את הסיומת .git כדי ש-Claude Code ישכפל את המאגר במקום להתייחס לכתובת כקישור ישיר לקובץ marketplace.json מתארח. עבור מארח שכתובות השכפול שלו אינן כוללות את הסיומת, כגון AWS CodeCommit, הוסף את השוק כרשומת git ב-extraKnownMarketplaces במקום זאת. Claude Code משכפל רשומת git בין אם כתובת ה-URL שלה מסתיימת ב-.git ובין אם לא.

Claude Code משכפל גם כתובת gitlab.com עם תתי-קבוצות מקוננות, כגון https://gitlab.com/group/subgroup/project.

כלול את הקידומת https://. גרסה v2.1.196 של Claude Code ומעלה דוחות כתובת שהוקלדה בלעדיה, כגון gitlab.com/company/plugins.git, כקיצור owner/repo לא תקין של GitHub, והשגיאה מורה לך להוסיף את הקידומת. גרסאות קודמות פירשו זאת בטעות כנתיב מאגר ב-GitHub ונכשלו בזמן השכפול.

שימוש ב-HTTPS:

/plugin marketplace add https://gitlab.com/company/plugins.git

שימוש ב-SSH:

/plugin marketplace add [email protected]:company/plugins.git

Claude Code משכפל כתובת SSH בין אם היא מסתיימת ב-.git ובין אם לא.

כדי להוסיף ענף או תג ספציפי, הוסף # ואחריו את ה-ref:

/plugin marketplace add https://gitlab.com/company/plugins.git#v1.0.0

#הוספה מנתיבים מקומיים

הוסף ספרייה מקומית המכילה קובץ .claude-plugin/marketplace.json:

/plugin marketplace add ./my-marketplace

ניתן גם להוסיף נתיב ישיר לקובץ marketplace.json:

/plugin marketplace add ./path/to/marketplace.json

#הוספה מכתובות URL מרוחקות

הוסף קובץ marketplace.json מרוחק דרך כתובת URL:

/plugin marketplace add https://example.com/marketplace.json

הערה: לשווקים מבוססי כתובת URL יש כמה מגבלות בהשוואה לשווקים מבוססי Git. אם התקנות תוספים משוק מבוסס URL נכשלות, ראה פתרון בעיות.

#התקנת תוספים

לאחר שהוספת שווקים, תוכל להתקין תוסף לפי שם:

/plugin install plugin-name@marketplace-name

הפקודה פותחת את פרטי התוסף, שבהם אתה בוחר טווח התקנה. אותן אפשרויות מוצגות כאשר אתה מריץ /plugin, עובר ללשונית Discover, ולוחץ על Enter על תוסף:

• User scope: התקנה עבור עצמך בכל הפרויקטים
• Project scope: התקנה עבור כל השותפים במאגר זה, פעולה המוסיפה את התוסף לקובץ .claude/settings.json
• Local scope: התקנה עבור עצמך במאגר זה בלבד, שאינה משותפת עם שותפים

כדי להתקין ללא שלב אינטראקטיבי, השתמש בפקודת המעטפת claude plugin install, אשר מתקינה ל-user scope אלא אם תעביר את הדגל --scope. עבור תוסף בעל מקור מסוג command, העבר את הדגל --yes כדי לאשר את הפקודה שהוא מציג.

ייתכן שתראה גם תוספים עם טווח managed. אלה מותקנים על ידי מנהלי מערכת דרך הגדרות מנוהלות ולא ניתן לשנות אותם.

Claude Code מחפש את התוסף בעותק המקומי שלו של קטלוג השוק. האופן שבו אתה מציין את שם התוסף קובע אם Claude Code ירענן את העותק הזה תחילה:

• עם שם שוק: כאשר אתה מתקין plugin-name@marketplace-name, בתוך הפעלה או באמצעות claude plugin install, Claude Code מרענן את אותו שוק לפני החיפוש. Claude Code מריץ את הרענון גם אם כיבית את העדכון האוטומטי עבור השוק או שהגדרת את משתנה הסביבה DISABLE_AUTOUPDATER. לפני גרסה v2.1.232, Claude Code לא רענן את השוק לפני החיפוש. Claude Code מדלג על רענון זה כאשר:
  • השוק לא נוסף מ-GitHub, מספק Git אחר, או מכתובת URL מרוחקת.
  • ספריית זרע (seed directory) מספקת את השוק.
  • Claude Code רענן את השוק בתוך 30 השניות האחרונות.
  • הגדרת את משתנה הסביבה CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC.
  • הגדרות מנוהלות חוסמות את השוק, ובמקרה זה Claude Code גם מסרב להתקנה.
• שם התוסף בלבד: כאשר אתה מריץ /plugin install plugin-name בתוך הפעלה, Claude Code מרענן רק את השווקים שהוא גם מעדכן ברקע, ורק לאחר שהחיפוש נכשל. כאשר אתה מריץ claude plugin install plugin-name, Claude Code קורא את הקטלוגים השמורים במטמון מבלי לרענן. כדי להתקין תוסף שפורסם לאחר הרענון האחרון שלך, הרץ /plugin marketplace update <marketplace-name> בתוך הפעלה או claude plugin marketplace update <marketplace-name> במעטפת שלך, ולאחר מכן נסה שוב להתקין.

אם הרענון לפני התקנה עם שם נכשל, למשל בגלל שאתה במצב לא מקוון, Claude Code מחפש את התוסף בקטלוג השמור במטמון בכל זאת. הפקודה claude plugin install מדווחת marketplace not refreshed בהודעת ההצלחה שלה, והפקודה /plugin install מציגה את הכשל מעל פרטי התוסף או בהודעת "לא נמצא" שלו.

כאשר אתה מתקין מממשק /plugin, סיכום ההתקנה מציין האם התוסף פעיל בהפעלה הנוכחית שלך:

• Plugin is now active.: Claude Code הפעיל את התוסף כחלק מההתקנה.
• Run /reload-plugins to activate.: התוסף עדיין אינו פעיל, מכיוון שהפעלתו תפסול את מטמון הפרומפטים או מכיוון שניסיון ההפעלה נכשל. לאחר מכן Claude Code מריץ את /reload-plugins עבורך. אם טעינה מחדש זו מזהירה מפני פסילת מטמון הפרומפטים, הרץ /reload-plugins --force כדי להפעיל את התוסף בכל זאת.
• אם טעינת התוסף נכשלת, הסיכום מדווח על הכשל ולשונית Errors של /plugin מציגה את הפירוט.

לפני גרסה v2.1.221, שום התקנה לא נכנסה לתוקף בהפעלה הנוכחית עד שהרצת /reload-plugins או הפעלת מחדש.

פקודת המעטפת claude plugin install אינה רצה בתוך הפעלה קיימת, ולכן Claude Code טוען את התוספים שהיא מתקינה בפעם הבאה שתפעיל את Claude Code, או כאשר תריץ /reload-plugins בהפעלה שכבר פתוחה.

אזהרה: ודא שאתה נותן אמון בתוסף לפני התקנתו. חברת Anthropic אינה שולטת באילו שרתי MCP, קבצים או תוכנות אחרות כלולים בתוספים, ואינה יכולה לאמת שהם פועלים כמתוכנן. עיין בדף הבית של כל תוסף למידע נוסף.

#ניהול תוספים מותקנים

הרץ /plugin ועבור ללשונית Installed כדי לצפות, להפעיל, להשבית או להסיר את התוספים שלך. הרשימה מקובצת לפי טווח וממוינת כך שתראה בעיות תחילה: תוספים עם שגיאות טעינה או תלויות שלא נפתרו מופיעים בראש, אחריהם המועדפים שלך, ותוספים מושבתים מקופלים מאחורי כותרת מכווצת בתחתית.

מתוך הרשימה תוכל:

• ללחוץ על f כדי לסמן או לבטל סימון של התוסף הנבחר כמועדף
• להקליד כדי לסנן לפי שם תוסף או תיאור
• ללחוץ על Enter כדי לפתוח את תצוגת הפרטים של התוסף ולהפעיל, להשבית או להסיר אותו

Claude Code מציג גם את התוספים שמסונכרנים מחשבון ה-claude.ai שלך בלשונית Installed, כאשר המקור שלהם מוגדר כ-synced. תוכל להפעיל או להשבית אותם שם, אלא אם הארגון שלך סימן אותם כנדרשים. כדי להסיר תוסף כזה, כבה אותו ב-claude.ai. תוספים מסונכרנים מופיעים בהפעלות טרמינל ב-Claude Code בגרסה v2.1.273 ומעלה.

כאשר אתה מסיר תוסף שמוגדר כפעיל בקובץ .claude/settings.json של הפרויקט, Claude Code שואל לאיזה טווח אתה מתכוון: להשבית אותו עבורך בלבד, פעולה הכותבת דריסה (override) לקובץ .claude/settings.local.json שלך ומשאירה את התוסף מותקן עבור הפרויקט, או להסיר אותו עבור כולם, פעולה המסירה אותו מקובץ .claude/settings.json המשותף.

תצוגת הפרטים מציגה את הרכיבים שהתוסף תורם: פקודות, מיומנויות, סוכנים, hooks, שרתי MCP ושרתי LSP. אותו מלאי רכיבים זמין גם משורת הפקודה באמצעות claude plugin details.

Claude Code מציג גם תוספי שוק שהתקנת בעצמך אך לא השתמשת בהם לפחות שבועיים, לאורך טווח של 10 הפעלות לפחות, תחת הכותרת Not used recently בלשונית Installed. תצוגת הפרטים מציגה שורת Last used עבור כל תוסף. השתמש במידע זה כדי לאתר תוספים שעדיין מוסיפים עלות עלייה ועלות הקשר למרות שאינך משתמש בהם יותר, ולאחר מכן השבת או הסר אותם.

שני סוגי תוספים לעולם אינם מופיעים ככאלה שלא נעשה בהם שימוש:

• תוספים שהארגון שלך מנהל או שאתה טוען באמצעות --plugin-dir
• תוספים שתורמים ערכת נושא (theme), סגנון פלט, מוניטור או תהליך עבודה, מאחר שהם מספקים ערך ללא צורך בהפעלה שניתן לעקוב אחריה

הכותרת Not used recently ושורת Last used שתיהן מוסתרות כאשר הארגון שלך מגביל שווקים באמצעות strictKnownMarketplaces.

שרת שפה (language server) של תוסף נחשב כפעיל כאשר הוא מספק אבחונים או עונה על בקשת ניווט בקוד, כך שתוסף LSP שהשרת שלו פעיל בהפעלות שלך אינו מופיע ככזה שלא נעשה בו שימוש. לפני גרסה v2.1.203, לא ניתן היה לספור פעילות של שרת שפה כשימוש, ולכן תוספים התורמים שרת LSP הוחרגו מהקבוצה לחלוטין, באותו אופן שבו תוספי ערכות נושא וסגנונות פלט מוחרגים עדיין.

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

כאשר אתה מתקין תוסף שמצהיר על תלויות, פלט ההתקנה מפרט אילו תלויות הותקנו אוטומטית לצידו.

תוכל גם לנהל תוספים באמצעות פקודות ישירות:

• כאשר אתה מריץ /plugin disable, /plugin enable, או /plugin uninstall, Claude Code פותח את חלונית התוספים כדי לבצע את השינוי ומשאיר אותה פתוחה. לחץ על Esc כדי לסגור את החלונית לפני הקלדת פקודה נוספת. הסעיף החלת שינויים בתוספים ללא הפעלה מחדש מתאר מתי השינוי נכנס לתוקף בהפעלה שלך.
• עבור סקריפטים, השתמש במקום זאת בפקודות המעטפת claude plugin, שאינן פותחות את החלונית.

הצגת רשימת התוספים המותקנים ללא פתיחת התפריט:

/plugin list

העבר את הדגל --enabled או --disabled כדי להציג רק תוספים במצב זה.

השבתת תוסף מבלי להסיר אותו:

/plugin disable plugin-name@marketplace-name

הפעלה מחדש של תוסף מושבת:

/plugin enable plugin-name@marketplace-name

במזהים אלה, plugin-name הוא ה-name של התוסף בתוך רשומת השוק, אשר עשוי להיות שונה מה-name בקובץ plugin.json של התוסף עצמו.

החל מגרסה v2.1.195 של Claude Code, האפשרויות Enable ו-Disable בממשק /plugin עובדות עבור תוספים ששני השמות שלהם שונים, והפקודות /plugin enable ו-/plugin disable מקבלות כל אחד מהשמות. כאשר אתה משבית תוסף כזה בגרסה ישנה יותר, Claude Code מדווח already disabled ומשאיר אותו פעיל.

הסרה מוחלטת של תוסף:

/plugin uninstall plugin-name@marketplace-name

האפשרות --scope מאפשרת לך למקד לטווח ספציפי באמצעות פקודות CLI:

claude plugin install formatter@your-org --scope project
claude plugin uninstall formatter@your-org --scope project

#החלת שינויים בתוספים ללא הפעלה מחדש

כאשר אתה סוגר את תפריט /plugin, Claude Code מריץ את /reload-plugins עבורך כדי להחיל את השינויים שביצעת בו, כגון התקנה, הפעלה, השבתה והסרה של תוספים. אם הטעינה מחדש תפסול את מטמון הפרומפטים, היא מתריעה ומשאירה את השינויים במצב ממתין במקום זאת; הרץ /reload-plugins --force כדי להחיל אותם בכל זאת. אם Claude עדיין מגיב כאשר אתה סוגר את התפריט, הטעינה מחדש תרוץ לאחר שהתגובה תסתיים.

עבור שינויי תוספים המתרחשים מחוץ לתפריט, הרץ את /reload-plugins בעצמך. שינויים אלה כוללים:

• פקודת claude plugin שהרצת בטרמינל אחר
• עריכות בתוסף שטענת באמצעות --plugin-dir בזמן שאתה מפתח אותו
• עדכון אוטומטי של תוסף שההתראה שלו מבקשת ממך לטעון מחדש
• סנכרון מחשבון ה-claude.ai שלך שהוסיף, עדכן או הסיר תוסף והציג התראה המבקשת ממך לטעון מחדש
• שינוי ב-תיקיית --plugin-dir ש-Claude Code השהה מכיוון שהחלתו תפסול את מטמון הפרומפטים

לפני גרסה v2.1.268, תוספים שהפעלת, השבתת או הסרת בתפריט, והתקנות שלא הופעלו במהלך ההתקנה, נשארו במצב ממתין עד שהרצת /reload-plugins.

הפקודה /reload-plugins רצה גם בהפעלות ללא טרמינל אינטראקטיבי, כגון אפליקציית שולחן העבודה, ה-Agent SDK ו-מצב לא אינטראקטיבי עם -p. דורש את Claude Code בגרסה v2.1.260 ומעלה. שתי מגבלות חלות בהפעלות אלו:

• הפקודה רצה רק כאשר אתה מקליד אותה ישירות לתוך ההפעלה, למשל בפרומפט של -p או בתיבת הפרומפט של אפליקציית שולחן העבודה. כאשר אתה שולח אותה דרך חיבור מרוחק במקום זאת, כגון Remote Control או הודעת צ'אט מועברת, הפקודה מסרבת לפעול מבלי לטעון מחדש דבר.
• הטעינה מחדש אינה מחברת או מנתקת שרתי MCP של תוספים. שינויים אלה ייכנסו לתוקף בהפעלה הבאה שלך.

Claude Code טוען מחדש את כל התוספים הפעילים ומציג מונים עבור תוספים, מיומנויות, סוכנים, hooks, שרתי MCP של תוספים ושרתי LSP של תוספים, תוך השמטת מונה שרתי ה-MCP של תוספים בהפעלה ללא טרמינל אינטראקטיבי. בספירת המיומנויות, Claude Code כולל כל מיומנות שתוסף מספק: הן את הרשומות שלו ב-commands/ והן את מיומנויות ה-SKILL.md שלו. לפני גרסה v2.1.246, Claude Code ספר רק רשומות ב-commands/, כך שהוא היה יכול לטעון מחדש מיומנויות SKILL.md של תוסף ועדיין לדווח על 0 skills בסיכום.

לטעינה מחדש יש עלות טוקנים בבקשה הבאה: רכיבים שנטענו מחדש מכריזים על עצמם בתוכן המצורף לשיחה, בעוד שההיסטוריה הקיימת עדיין נקראת ממטמון הפרומפטים. תוסף המספק שרתי MCP עולה יותר כאשר הכלים שלו אינם נדחים על ידי חיפוש כלים: השינוי פוסל את המטמון והבקשה הבאה קוראת מחדש את כל השיחה. ראה הפעלה או השבתה של תוסף לפרטים.

#ניהול שווקים

תוכל לנהל שווקים דרך הממשק האינטראקטיבי של /plugin או באמצעות פקודות CLI.

#שימוש בממשק האינטראקטיבי

הרץ /plugin ועבור ללשונית Marketplaces כדי:

• להציג את כל השווקים שהוספת יחד עם המקורות והסטטוס שלהם
• להוסיף שווקים חדשים
• לעדכן רשימות שוק כדי למשוך את התוספים העדכניים ביותר
• להסיר שווקים שאינך זקוק להם יותר

#שימוש בפקודות CLI

תוכל גם לנהל שווקים באמצעות פקודות ישירות.

הצגת רשימה של כל השווקים המוגדרים:

/plugin marketplace list

רענון רשימות תוספים מתוך שוק:

/plugin marketplace update marketplace-name

הסרת שוק:

/plugin marketplace remove marketplace-name

אזהרה: הסרת שוק תסיר כל תוסף שהתקנת ממנו.

#הגדרת עדכונים אוטומטיים

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

Claude Code בודק עדכוני שווקים ותוספים לאחר תחילת ההפעלה שלך, עם השהיה אקראית של עד עשר דקות, כך שההפעלה הפעילה ממשיכה להשתמש בגרסאות שנטענו בעלייה. אם תוספים כלשהם עודכנו, תראה התראה המבקשת ממך להריץ /reload-plugins, או שהגרסאות החדשות ייטענו בהפעלה הבאה שלך.

העדכון האוטומטי משמיט גם תוסף שרשומת השוק שלו מצהירה על headersHelper: Claude Code אינו מריץ את הפקודה ואינו מוריד את הארכיון בנתיב זה; סעיף זה מציין מתי Claude Code מציג את התוסף בלשונית Errors של /plugin כדי שתוכל לעדכן אותו מהתצוגה שלו.

Claude Code מעדכן תוספים בעלי מקור command בקצב נפרד מהגדרת העדכון האוטומטי של השוק וממשתנה הסביבה DISABLE_AUTOUPDATER. במקום זאת, הוא מריץ מחדש את הפקודה פעם אחת בכל הפעלה ומתקין את הפלט כגרסת תוסף חדשה כאשר ה-hash שלו השתנה.

הפעלה או כיבוי של עדכון אוטומטי עבור שווקים בודדים דרך ממשק המשתמש:

1. הרץ /plugin כדי לפתוח את מנהל התוספים
2. בחר ב-Marketplaces
3. בחר שוק מתוך הרשימה
4. בחר ב-Enable auto-update או ב-Disable auto-update

השוק claude-plugins-official ורוב השווקים הרשמיים האחרים של Anthropic מוגדרים עם עדכון אוטומטי מופעל כברירת מחדל. שווקי צד שלישי ושווקי פיתוח מקומיים מוגדרים עם עדכון אוטומטי מושבת כברירת מחדל.

מנהלי מערכת יכולים גם להגדיר "autoUpdate": true בכל רשומת extraKnownMarketplaces בהגדרות מנוהלות, כדי להפעיל עדכון אוטומטי עבור שוק ארגוני מבלי לדרוש מכל משתמש לשנות זאת בעצמו.

כדי להשבית עדכונים אוטומטיים עבור Claude Code ועבור תוספים שנמשכו משווקים, הגדר את משתנה הסביבה DISABLE_AUTOUPDATER. תוספים עם מקור command פועלים לפי פתרון מחדש עצמאי של פעם בהפעלה. ראה עדכונים אוטומטיים לפרטים.

כדי להשאיר עדכונים אוטומטיים של תוספים מופעלים תוך השבתת העדכונים האוטומטיים של Claude Code, הגדר את FORCE_AUTOUPDATE_PLUGINS=1 יחד עם DISABLE_AUTOUPDATER:

export DISABLE_AUTOUPDATER=1
export FORCE_AUTOUPDATE_PLUGINS=1

#הגדרת שווקי צוות

מנהלי צוות יכולים להגדיר התקנת שוק אוטומטית עבור פרויקטים על ידי הוספת תצורת שוק לקובץ .claude/settings.json. ברגע שחבר צוות נותן אמון בתיקיית המאגר, Claude Code מוסיף שווקים אלה ללא בקשת אישור נוספת.

החל מגרסה v2.1.195 של Claude Code, הוספת השוק אינה מתקינה תוספים המגיעים ממקור חיצוני, בכל נתיב שטוען תוספים. תוסף שמופעל רק על ידי קובץ .claude/settings.json של הפרויקט, ומגיע ממקור חיצוני כגון מאגר GitHub או חבילת npm, אינו נטען עד שחבר הצוות מתקין אותו. עד אז, Claude Code מדווח על התוסף ככזה שאינו מותקן ומציג את פקודת claude plugin install שיש להריץ.

הוסף את extraKnownMarketplaces לקובץ .claude/settings.json של הפרויקט שלך:

{
  "extraKnownMarketplaces": {
    "my-team-tools": {
      "source": {
        "source": "github",
        "repo": "your-org/claude-plugins"
      }
    }
  }
}

עבור אפשרויות תצורה מלאות כולל extraKnownMarketplaces ו-enabledPlugins, ראה הגדרות תוספים.

#אבטחה

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

#פתרון בעיות

#הפקודה /plugin אינה מזוהה

אם מופיעה הודעת "unknown command" או שהפקודה /plugin אינה מופיעה:

1. בדוק את הגרסה שלך: הרץ claude --version כדי לראות מה מותקן.
2. עדכן את Claude Code:
   • Homebrew: הרץ brew upgrade claude-code, או brew upgrade claude-code@latest אם התקנת את ה-cask הזה
   • npm: הרץ npm install -g @anthropic-ai/claude-code@latest
   • מתקין מקורי (Native installer): הרץ שוב את פקודת ההתקנה מתוך התקנה
3. הפעל מחדש את Claude Code: לאחר העדכון, הפעל מחדש את הטרמינל שלך והרץ שוב claude.

#בעיות נפוצות

אם מיומנויות של תוספים אינן מופיעות, נקה את המטמון באמצעות rm -rf ~/.claude/plugins/cache, הפעל מחדש את Claude Code, והתקן מחדש את התוסף.

לפתרון בעיות מפורט כולל פתרונות, ראה פתרון בעיות במדריך השווקים. לכלי ניפוי שגיאות, ראה כלי פיתוח וניפוי שגיאות.

#בעיות בתבונת קוד

• שרת השפה אינו מופעל: ודא שהקובץ הבינארי מותקן וזמין במשתנה $PATH שלך. בדוק את לשונית Errors של /plugin לפרטים.
• צריכת זיכרון גבוהה: שרתי שפה כגון rust-analyzer ו-pyright עשויים לצרוך זיכרון משמעותי בפרויקטים גדולים. אם אתה חווה בעיות זיכרון, השבת את התוסף באמצעות /plugin disable <plugin-name> והסתמך במקום זאת על כלי החיפוש המובנים של Claude.
• אבחונים חיוביים שגויים (False positives) ב-monorepos: שרתי שפה עשויים לדווח על שגיאות ייבוא שלא נפתרו עבור חבילות פנימיות אם סביבת העבודה אינה מוגדרת כראוי. שגיאות אלו אינן משפיעות על היכולת של Claude לערוך קוד.

#השלבים הבאים

• בניית תוספים משלך: ראה תוספים כדי ליצור מיומנויות, סוכנים ו-hooks
• יצירת שוק: ראה יצירת שוק תוספים כדי להפיץ תוספים לצוות או לקהילה שלך
• הפניה טכנית: ראה הפניה לתוספים למפרטים מלאים