תיעוד 222

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

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

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

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

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

#כיצד פועלות זירות מסחר

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

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

#זירת המסחר הרשמית של 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: השתמש ב-דפדפן התוספים.
הרחבת VS Code: התקן מתוך תיבת הדו-שיח Manage plugins.
הפעלות ענן (Cloud sessions): הגדר את התוסף תחת enabledPlugins בקובץ .claude/settings.json.

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

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

[!NOTE] זירת המסחר הרשמית נאצרת על ידי Anthropic, וההכללה בה נתונה לשיקול דעתה של Anthropic. טופסי ההגשה בתוך האפליקציה מוסיפים תוספים ל-זירת המסחר הקהילתית, ולא לזירה הרשמית. כדי להפיץ תוספים באופן עצמאי, צור זירת מסחר משלך ושתף אותה עם משתמשים.

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

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

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

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

שפה	תוסף	קובץ בינארי נדרש
C/C++	`clangd-lsp`	`clangd`
C

#| `csharp-lsp` | `csharp-ls` |

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

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

#מה Claude מרוויח מתוספי בינת קוד

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

אבחון אוטומטי (Automatic diagnostics): לאחר כל עריכת קובץ ש-Claude מבצע, שרת השפה מדווח בחזרה על שגיאות ואזהרות, כך ש-Claude רואה שגיאות טיפוסים, ייבואים חסרים ובעיות תחביר בלי להריץ מהדר (compiler) או בודק סטטי (linter). אם Claude מכניס שגיאה, הוא מבחין בכך ומתקן אותה באותו תור.
ניווט בקוד (Code navigation): Claude יכול להשתמש בשרת השפה כדי לקפוץ להגדרות, למצוא הפניות, לקבל מידע על טיפוסים בריחוף עכבר, לרשום סמלים (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 לתקן את מה שהוא מוצא באותה הפעלה. ראה איתור בעיות אבטחה בזמן ש-Claude כותב קוד לגבי מה שהוא בודק וכיצד להוסיף כללים ייעודיים לפרויקט.

#תהליכי עבודה לפיתוח

תוספים שמוסיפים מיומנויות וסוכנים עבור משימות פיתוח נפוצות:

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

#סגנונות פלט

התאם אישית את האופן שבו 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) עם תוספים לדוגמה שמראים מה אפשרי באמצעות מערכת התוספים. שלא כמו זירת המסחר הרשמית, עליך להוסיף זירה זו ידנית.

הוספת זירת המסחר: מתוך Claude Code, הרץ את הפקודה plugin marketplace add עבור זירת המסחר anthropics/claude-code:
```
/plugin marketplace add anthropics/claude-code
```
פעולה זו מורידה את קטלוג זירת המסחר והופכת את התוספים שלה לזמינים עבורך.
עיון בתוספים הזמינים: הרץ /plugin כדי לפתוח את מנהל התוספים. פקודה זו פותחת ממשק לשוניות שניתן לעבור ביניהן באמצעות Tab, או Shift+Tab כדי לחזור אחורה:
- Discover: עיון בתוספים זמינים מכל זירות המסחר שלך
- Installed: צפייה וניהול של התוספים המותקנים שלך
- Marketplaces: הוספה, הסרה או עדכון של זירות המסחר שהוספת
- Errors: צפייה בשגיאות טעינה של תוספים
- Stats: צפייה ב-כמה כל אחת מהמיומנויות שלך עולה בהקשר ובאיזו תדירות משתמשים בה, בהפעלות שבהן /skill-doctor זמין
עבור ללשונית Discover כדי לראות תוספים מזירת המסחר שהרגע הוספת. כאשר מנהל המערכת שלך הוסיף את זירת המסחר לרשימת ההיתרים באמצעות ההגדרה המנוהלת pluginSuggestionMarketplaces, תוספים המסומנים כרלוונטיים לספריית העבודה הנוכחית שלך מוצמדים למעלה עם התווית suggested for this directory.
התקנת תוסף: בחר תוסף כדי להציג את פרטיו. חלונית הפרטים מציגה מה התוסף מכיל וכמה הוא עולה:
- הערכת עלות הקשר (Context cost) כדי שתוכל לראות כמה אסימונים (tokens) התוסף יוסיף ל-חלון ההקשר שלך בכל תור
- תאריך עודכן לאחרונה (Last updated) של התוסף
- סעיף יתקין (Will install) המפרט את הפקודות, הסוכנים, המיומנויות, ה-hooks, שרתי ה-MCP ושרתי ה-LSP של התוסף, כדי שתוכל לבדוק בדיוק מה הוא מוסיף לפני ההתקנה
לא כל תוסף מספק את הנתונים שמאחורי השדות האלה. עבור תוספים מזירות מסחר מקומיות או מותאמות אישית, ייתכן שלא תראה את השורות Context cost ו-Last updated, וסעיף Will install עשוי להציג במקום זאת Components will be discovered at installation.

בחר טווח התקנה (scope):
- User scope: התקנה עבור עצמך בכל הפרויקטים
- Project scope: התקנה עבור כל המשתתפים במאגר זה
- Local scope: התקנה עבור עצמך במאגר זה בלבד
לדוגמה, בחר ב-commit-commands, תוסף שמוסיף מיומנויות לתהליך עבודה ב-git, והתקן אותו בטווח המשתמש (user scope) שלך.

באפשרותך גם להתחיל את ההתקנה משורת הפקודה:
```
/plugin install commit-commands@claude-code-plugins
```
ראה קובצי הגדרות כדי ללמוד עוד על טווחים.
שימוש בתוסף החדש שלך: אם סיכום ההתקנה מדווח 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 כדי להוסיף זירות מסחר ממקורות שונים.

[!TIP] קיצורי דרך: באפשרותך להשתמש ב-/plugin market במקום ב-/plugin marketplace, וב-rm במקום ב-remove.

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

#הוספה מ-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 המלאה שלו. עבור כתובת URL בפרוטוקול https://, השאלה אם לכלול את הסיומת .git תלויה במארח:

github.com ו-gitlab.com: Claude Code מזהה כתובת URL של מאגר עם הסיומת .git או בלעדיה ומשכפל אותה. הוספת כתובת URL של 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 ישכפל את המאגר במקום להתייחס לכתובת ה-URL כאל קישור ישיר לקובץ marketplace.json מתארח. עבור מארח שכתובות השכפול שלו אינן נושאות את הסיומת, כגון AWS CodeCommit, הוסף את זירת המסחר כרשומת git ב-extraKnownMarketplaces במקום זאת. Claude Code משכפל רשומת git בין אם כתובת ה-URL שלה מסתיימת ב-.git ובין אם לא.

Claude Code משכפל גם כתובת URL של 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

[!NOTE] לזירות מסחר מבוססות URL יש מגבלות מסוימות בהשוואה לזירות מסחר מבוססות Git. אם התקנות תוספים מזירת מסחר מבוססת URL נכשלות, ראה פתרון בעיות.

#הוספה מ-claude.ai

בהפעלות טרמינל שבהן תוספים מסתנכרנים מחשבון ה-claude.ai שלך, claude.ai יכול גם להציג רשימה של זירות מסחר עבורך, כגון ספריית התוספים של הארגון שלך והעלאות משלך ב-claude.ai. הפקודה claude plugin marketplace list מדפיסה אותן בסעיף From claude.ai:, ולשונית Marketplaces ב-/plugin מציגה אותן. בחר אחת שם כדי להוסיף אותה. הוספת זירת מסחר מ-claude.ai דורשת את Claude Code גרסה v2.1.273 או גרסה מאוחרת יותר.

כדי להוסיף אחת מהמעטפת שלך, הרץ את claude plugin marketplace add עם הדגל --claudeai והשם המוצג ברשימה:

claude plugin marketplace add --claudeai claudeai-organization-library

Claude Code רושם את זירת המסחר תחת שם מקומי שמתחיל ב-claudeai-, הנגזר מהשם ש-claude.ai מציג ברשימה: זירת מסחר הרשומה כ-"Organization library" נרשמת כ-claudeai-organization-library. התקן את התוספים שלה לפי שם זה, לדוגמה באמצעות claude plugin install <plugin>@claudeai-organization-library.

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

הסעיף From claude.ai: יכול להציג גם זירות מסחר מבוססות git המשותפות דרך claude.ai. אתה מוסיף אותן באמצעות פקודת marketplace add הרגילה, תוך שימוש במקור שהרשימה מדפיסה.

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

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

כדי להתקין לפי שם:

/plugin install plugin-name@marketplace-name

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

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

כדי להתקין ללא שלב אינטראקטיבי, השתמש בפקודת המעטפת claude plugin install, אשר מתקינה בטווח משתמש אלא אם אתה מעביר את הדגל --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 בהפעלה שכבר פתוחה.

[!WARNING] ודא שאתה סומך על תוסף לפני התקנתו. Anthropic אינה שולטת באילו שרתי MCP, קבצים או תוכנות אחרות נכללים בתוספים ואינה יכולה לאמת שהם פועלים כמתוכנן. בדוק את דף הבית של כל תוסף למידע נוסף.

#הוספת זירת מסחר והתקנה בפקודה אחת

כדי להתקין תוסף מזירת מסחר שעדיין לא הוספת, ציין את מקור זירת המסחר באמצעות --marketplace. דורש את Claude Code גרסה v2.1.275 או גרסה מאוחרת יותר.

/plugin install quality-review-plugin --marketplace your-org/plugins

המקור מקבל את אותם הפורמטים כמו /plugin marketplace add, כגון owner/repo של GitHub, כתובת URL של git, או נתיב מקומי, פרט לכך שאינו יכול להכיל רווחים. ציין את שם התוסף בלבד, ללא סיומת @marketplace.

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

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

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

מתוך הרשימה באפשרותך:

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

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

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

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

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

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

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

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

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

החל מ-Claude Code גרסה v2.1.195, האפשרויות 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

[!WARNING] הסרת זירת מסחר תסיר את ההתקנה של כל התוספים שהתקנת ממנה.

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

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

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

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

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

החלף את מצב העדכון האוטומטי עבור זירות מסחר בודדות דרך ממשק המשתמש:

הרץ /plugin כדי לפתוח את מנהל התוספים
בחר ב-Marketplaces
בחר זירת מסחר מהרשימה
בחר ב-Enable auto-update או ב-Disable auto-update

ב-claude-plugins-official, ברוב זירות המסחר הרשמיות האחרות של Anthropic, וב-זירות מסחר שנוספו מ-claude.ai, עדכון אוטומטי מופעל כברירת מחדל. בזירות מסחר אחרות של צד שלישי ובזירות מסחר לפיתוח מקומי, עדכון אוטומטי מושבת כברירת מחדל.

מנהלי מערכת יכולים גם להגדיר "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 מוסיף זירות מסחר אלה ללא בקשת אישור נוספת.

החל מ-Claude Code גרסה v2.1.195, הוספת זירת המסחר אינה מתקינה תוספים המגיעים ממקור חיצוני, בכל מסלול שטוען תוספים. תוסף שרק קובץ .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 אינה מופיעה:

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

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

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

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

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

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

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

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