מערכת התוספים (Plugins) של קלוד קוד מאפשרת לארוז יחד מיומנויות (Skills), סוכני משנה (Agents), הוקים (Hooks), שרתי MCP, שרתי שפה (LSP) ומוניטורים ברקע לחבילה אחת שאפשר להתקין ולשתף בין פרויקטים, צוותים והקהילה.
קלוד קוד תומך בשתי דרכים להרחבת היכולות:
הגדרה עצמאית (ספריית .claude/): מתאימה לתהליכי עבודה אישיים, התאמות ספציפיות לפרויקט וניסויים מהירים. שמות המיומנויות מופיעים ישירות, למשל /hello. מומלץ להתחיל בהגדרה עצמאית בתוך .claude/ לצורך איטרציות מהירות, ולהסב אותה לתוסף כשרוצים לשתף.
תוספים (תיקיות עצמאיות עם מיומנויות, סוכנים, הוקים או מניפסט .claude-plugin/plugin.json): מתאימים לשיתוף עם חברי צוות, הפצה לקהילה, גרסאות מנוהלות ושימוש חוזר בין פרויקטים. שמות המיומנויות כוללים מרחב שמות, למשל /plugin-name:hello.
גישה
שמות מיומנויות
מתאים במיוחד עבור
הגדרה עצמאית (ספריית .claude/)
/hello
תהליכי עבודה אישיים, התאמות ספציפיות לפרויקט, ניסויים מהירים
תוספים (תיקיות עצמאיות עם מיומנויות, סוכנים, הוקים או מניפסט .claude-plugin/plugin.json)
/plugin-name:hello
שיתוף עם חברי צוות, הפצה לקהילה, גרסאות מנוהלות, שימוש חוזר בין פרויקטים
ניתן גם להפעיל תוספים ישירות בחשבון claude.ai ברמה אישית או ארגונית, וקלוד קוד מסנכרן אותם אוטומטית לתוך הסשנים ללא צורך בהתקנה ממרקטפלייס.
קלוד קוד מוסיף את המרקטפלייס הרשמי של אנתרופיק (claude-plugins-official) באופן אוטומטי בהפעלה האינטראקטיבית הראשונה. אם קלוד קוד אינו מצליח להוסיף אותו, למשל בגלל חסימת הרשת להורדה או בגלל שמדיניות מרקטפלייסים מנוהלת חסמה ניסיון קודם, ניתן להוסיף אותו ידנית באמצעות:
כדי לעיין בתוספים הזמינים, מריצים /plugin ועוברים ללשונית Discover, או צופים בקטלוג באתר claude.com/plugins.
כדי להתקין תוסף מהמרקטפלייס הרשמי, משתמשים בפקודה /plugin install <name>@claude-plugins-official. לדוגמה, להתקנת אינטגרציית GitHub:
/plugin install github@claude-plugins-official
הפקודה /plugin פותחת חלונית אינטראקטיבית בטרמינל. אם קלוד משיב שהפקודה אינה זמינה בסביבה זו, משתמשים בדפדפן התוספים באפליקציית Claude Desktop, או מגדירים את התוסף תחת enabledPlugins בקובץ .claude/settings.json עבור סשנים בענן.
אם ההתקנה נכשלת, פועלים לפי הודעת השגיאה:
Marketplace "claude-plugins-official" not found: מוסיפים את המרקטפלייס באמצעות הפקודה /plugin marketplace add anthropics/claude-plugins-official, ולאחר מכן מנסים שוב להתקין.
התוסף אינו נמצא במרקטפלייס: בודקים את איות שם התוסף.
המרקטפלייס הרשמי מנוהל ומתוחזק על ידי אנתרופיק, וההכללה בו היא לפי שיקול דעתה הבלעדי. טפסי הגשת התוספים באפליקציה מוסיפים תוספים למרקטפלייס הקהילה ולא למרקטפלייס הרשמי. להפצת תוספים באופן עצמאי, יוצרים מרקטפלייס עצמאי ומשתפים אותו עם משתמשים.
תוספי בינת קוד מפעילים את כלי ה-LSP המובנה של קלוד קוד, ומעניקים לקלוד את היכולת לקפוץ להגדרות, למצוא אזכורים ולראות שגיאות טיפוסים מיד לאחר עריכת קבצים. תוספים אלה מגדירים חיבורי פרוטוקול שרת שפה (Language Server Protocol), אותה טכנולוגיה המפעילה את בינת הקוד ב-VS Code. בסשנים בענן, קלוד קוד אינו מפעיל שרתי שפה של תוספים, ולכן קלוד אינו מקבל את כלי ה-LSP שם.
יש להתקין את הבינארי של שרת השפה מהטבלה הבאה לפני השימוש בתוספים אלה, כיוון שהתוסף אינו מתקין אותו עבורך. אם שרת השפה כבר מותקן במחשב, קלוד עשוי להציע להתקין את התוסף המתאים בעת פתיחת פרויקט.
ניתן גם ליצור תוספי LSP מותאמים אישית לשפות אחרות. אם מופיעה השגיאה Executable not found in $PATH בלשונית Errors ב-/plugin לאחר התקנת תוסף, יש להתקין את הבינארי המופיע בטבלה.
לאחר התקנת תוסף בינת קוד והימצאות הבינארי של שרת השפה, קלוד מקבל שתי יכולות:
אבחון אוטומטי (Automatic diagnostics): לאחר כל עריכת קובץ שקלוד מבצע, שרת השפה מדווח בחזרה שגיאות ואזהרות, וכך קלוד רואה שגיאות טיפוסים, ייבואים חסרים ובעיות תחביר בלי להריץ מהדר או linter. אם קלוד יוצר שגיאה, הוא מזהה ומתקן אותה באותו תור. כדי לקרוא את האבחונים בעצמך, לוחצים Ctrl+O כאשר מופיע חיווי כגון Found 3 new diagnostic issues in 2 files.
ניווט בקוד (Code navigation): קלוד יכול להשתמש בשרת השפה כדי לקפוץ להגדרות, למצוא אזכורים, לקבל מידע על טיפוסים בריחוף (hover), לרשום סמלים, למצוא מימושים ולהתחקות אחר היררכיית קריאות. פעולות אלו מספקות לקלוד ניווט מדויק יותר מחיפוש מבוסס grep.
מרקטפלייס הקהילה בכתובת anthropics/claude-plugins-community מארח תוספי צד שלישי שעברו אימות אוטומטי וסריקת בטיחות של אנתרופיק. כל תוסף מוצמד למזהה commit SHA ספציפי בקטלוג. מוסיפים אותו ידנית:
אנתרופיק מתחזקת גם מרקטפלייס תוספי הדגמה (claude-code-plugins) עם תוספים לדוגמה הממחישים את יכולות המערכת. מוסיפים אותו ידנית בארבעה שלבים:
הוספת המרקטפלייס:
בתוך קלוד קוד, מריצים את פקודת ההוספה עבור המרקטפלייס 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 המציגה כמה טוקנים התוסף יוסיף לחלון ההקשר בכל תור
תאריך העדכון האחרון (Last updated) של התוסף
סעיף Will install המפרט את הפקודות, הסוכנים, המיומנויות, ההוקים, ושרתי ה-MCP וה-LSP שהתוסף כולל
בתוספים ממרקטפלייסים מקומיים או מותאמים אישית שדות אלה עשויים שלא להופיע, ובמקומם עשוי להופיע הכיתוב Components will be discovered at installation.
בוחרים טווח התקנה (Scope):
User scope: התקנה עבור המשתמש בכל הפרויקטים
Project scope: התקנה עבור כל השותפים במאגר זה (מוסיף את התוסף לקובץ .claude/settings.json)
Local scope: התקנה עבור המשתמש במאגר זה בלבד
לדוגמה, בוחרים בתוסף commit-commands ומתקינים אותו בטווח User scope.
ניתן גם להפעיל את ההתקנה ישירות משורת הפקודה:
שימוש בתוסף החדש:
אם סיכום ההתקנה מדווח Run /reload-plugins to activate., קלוד קוד מריץ את הטעינה מחדש באופן אוטומטי. אם הטעינה מזהירה ששליחת ההודעה הבאה תקרא מחדש את השיחה, מריצים /reload-plugins --force להפעלת התוסף.
מיומנויות התוסף מקבלות מרחב שמות לפי שם התוסף, ולכן commit-commands מספק מיומנויות כגון /commit-commands:commit.
בודקים זאת על ידי ביצוע שינוי בקובץ והרצה:
/commit-commands:commit
הפקודה מעבירה את השינויים ל-stage, מייצרת הודעת commit ויוצרת את ה-commit.
הפקודה /plugin marketplace add מאפשרת להוסיף מרקטפלייסים ממקורות שונים.
קיצורי דרך: ניתן להשתמש ב-/plugin market במקום ב-/plugin marketplace, וב-rm במקום ב-remove.
הוספת מאגר Git מתבצעת באמצעות ציון כתובת ה-URL המלאה שלו. עבור כתובות https://, שאלת הצורך בסיומת .git תלויה בשרת:
בשרתי github.com ו-gitlab.com: קלוד קוד מזהה את הכתובת עם או בלי סיומת .git ומשכפל אותה. הוספת כתובת gitlab.com ללא הסיומת דורשת גרסה v2.1.232 ומעלה (לפני כן קלוד קוד התייחס אליה כקישור ישיר לקובץ marketplace.json). קלוד קוד תומך גם ב-subgroups מקוננים ב-gitlab.com.
בשרתי Azure DevOps: יש להשמיט את הסיומת .git. קלוד קוד משכפל כל כתובת שנתיבה כולל /_git/. הוספת סיומת .git לנתיב כזה תכשיל את השכפול.
בכל שרת אחר, כולל שרתי GitLab בניהול עצמי: יש לכלול את הסיומת .git כדי שקלוד קוד ישכפל את המאגר ולא יתייחס לכתובת כקישור ישיר לקובץ marketplace.json. בשרתים שכתובות השכפול שלהם אינן כוללות סיומת זו (כגון AWS CodeCommit), מגדירים את המרקטפלייס כרשומת git בהגדרה extraKnownMarketplaces.
חובה לכלול את הקידומת https://. מגרסה v2.1.196 ומעלה, כתובת שהוזנה ללא קידומת זו נדחית כשגיאת קיצור דרך לא תקינה של GitHub owner/repo.
בסשנים בטרמינל שבהם מוגדר סנכרון תוספים מחשבון claude.ai, הפקודה claude plugin marketplace list מציגה מרקטפלייסים אלה תחת הסעיף From claude.ai:, והם מופיעים גם בלשונית Marketplaces ב-/plugin. הוספה מ-claude.ai דורשת גרסה v2.1.273 ומעלה.
להוספה מהמעטפת, מריצים claude plugin marketplace add עם הדגל --claudeai והשם המוצג ברשימה:
claude plugin marketplace add --claudeai claudeai-organization-library
קלוד קוד רושם את המרקטפלייס תחת שם מקומי המתחיל בקידומת claudeai-, הנגזר משמו ב-claude.ai: מרקטפלייס הרשום כ-"Organization library" יירשם כ-claudeai-organization-library. התקנת תוספים ממנו נעשית לפי שם זה, למשל:
claude plugin install <plugin>@claudeai-organization-library
בעת התנתקות או כניסה עם חשבון אחר, המרקטפלייס נשאר מוגדר אך אינו מציג תוספים, ותוספים שכבר הותקנו ממנו ממשיכים להיטען כרגיל.
הפקודה פותחת את פרטי התוסף לבחירת טווח ההתקנה (Scope):
User scope: התקנה אישית התקפה בכל הפרויקטים
Project scope: התקנה לכל השותפים במאגר, הנשמרת בקובץ .claude/settings.json
Local scope: התקנה אישית במאגר זה בלבד, שאינה משותפת עם אחרים
Managed scope: תוספים שהותקנו על ידי מנהלי מערכת דרך הגדרות מנוהלות, ואינם ניתנים לשינוי
להתקנה שאינה אינטראקטיבית, משתמשים בפקודת המעטפת claude plugin install, שמתקינה כברירת מחדל בטווח User scope אלא אם מועבר הדגל --scope. עבור תוסף בעל מקור command, מוסיפים את הדגל --yes לאישור הפקודה המוצגת.
רענון קטלוג המרקטפלייס בעת התקנה:
התקנה עם ציון שם מרקטפלייס: בעת התקנת plugin-name@marketplace-name, קלוד קוד מרענן את המרקטפלייס לפני החיפוש (מגרסה v2.1.232 ומעלה), גם אם עדכונים אוטומטיים כובו או שהוגדר DISABLE_AUTOUPDATER. הרענון נדלג אם המרקטפלייס לא נוסף מ-Git או מ-URL מרוחק, אם הוא מגיע מספריית seed, אם הוא רוענן ב-30 השניות האחרונות, אם הוגדר CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC, או אם הגדרות מנוהלות חוסמות אותו.
התקנה לפי שם תוסף בלבד: בסשן אינטראקטיבי, קלוד קוד מרענן רק מרקטפלייסים שמתעדכנים ברקע ורק אם החיפוש במטמון נכשל. בהרצת claude plugin install plugin-name מהמעטפת, המערכת קוראת מהמטמון בלי לרענן. לעדכון תוסף שפורסם לאחר הרענון האחרון, מריצים /plugin marketplace update <marketplace-name> בסשן או מהמעטפת, ומנסים שוב.
חיווי מצב ההתקנה בממשק /plugin:
Plugin is now active.: קלוד קוד הפעיל את התוסף מיד כחלק מתהליך ההתקנה.
Run /reload-plugins to activate.: התוסף אינו פעיל עדיין, משום שהפעלתו תבטל את ה-prompt cache או שניסיון ההפעלה נכשל. קלוד קוד מריץ את הטעינה מחדש בעצמו. אם מופיעה אזהרה על ה-prompt cache, מריצים /reload-plugins --force להפעלתו.
אם טעינת התוסף נכשלה, השגיאה מדווחת בסיכום ופירוטה מוצג בלשונית Errors.
תוספים המותקנים מפקודת המעטפת claude plugin install ייטענו בסשן הבא של קלוד קוד, או בעת הרצת /reload-plugins בסשן פתוח.
המקור מקבל את אותם הפורמטים הנתמכים ב-/plugin marketplace add (כגון owner/repo של GitHub, כתובת Git או נתיב מקומי), ללא רווחים. שם התוסף ניתן ללא סיומת @marketplace. אם המרקטפלייס טרם נוסף, מוצג המקור שזוהה ומבוקש אישור להוספתו.
הרצת הפקודה /plugin ומעבר ללשונית Installed מאפשרים לצפות בתוספים, להפעילם, להשביתם או להסירם. הרשימה מקובצת לפי טווח (scope) וממוינת כך שבעיות מופיעות בראש הרשימה, לאחר מכן מועדפים, ותוספים מושבתים מקופלים בתחתית.
פעולות מתוך הרשימה:
לחיצה על f: הוספה או הסרה של התוסף הנבחר ממועדפים
הקלדה: סינון הרשימה לפי שם התוסף או תיאורו
לחיצה על Enter: פתיחת תצוגת פרטים להפעלה, השבתה או הסרה של התוסף
תוספים המסונכרנים מחשבון claude.ai מופיעים בלשונית Installed עם המקור synced (בגרסה v2.1.273 ומעלה). ניתן להפעילם או להשביתם שם, אלא אם הארגון סימן אותם כחובה. הסרתם נעשית דרך claude.ai.
בעת הסרת תוסף שהופעל בקובץ .claude/settings.json של הפרויקט, קלוד קוד שואל לגבי היקף ההסרה: השבתה עבורך בלבד (נרשמת דריסה ב-.claude/settings.local.json והתוסף נשאר לפרויקט), או הסרה עבור כל השותפים מ-.claude/settings.json.
תוספים שלא היו בשימוש לאחרונה:
תוספי מרקטפלייס שהותקנו עצמאית ולא נעשה בהם שימוש במשך שבועיים לפחות, לאורך 10 סשנים לפחות, מוצגים תחת הכותרת Not used recently בלשונית Installed, לצד שורת Last used. שרתי שפה של תוספי LSP נחשבים בשימוש כשהם מספקים אבחונים או עונים לבקשות ניווט (מגרסה v2.1.203 ומעלה). תוספים בניהול ארגוני, תוספים שנטענו דרך --plugin-dir, ותוספים המספקים ערכת עיצוב, סגנון פלט, מוניטור או תהליך עבודה, אינם מסומנים לעולם כלא בשימוש.
פקודות ניהול ישירות:
הצגת רשימת תוספים מותקנים:
/plugin list
(הוספת הדגלים --enabled או --disabled מציגה רק תוספים במצב זה).
השבתת תוסף:
/plugin disable plugin-name@marketplace-name
הפעלה מחדש של תוסף:
/plugin enable plugin-name@marketplace-name
(החל מגרסה v2.1.195, פקודות אלו פועלות ומקבלות הן את שם התוסף במרקטפלייס והן את שמו ב-plugin.json אם הם שונים).
הסרה מלאה של תוסף:
/plugin uninstall plugin-name@marketplace-name
ניהול טווחים דרך ה-CLI:
claude plugin install formatter@your-org --scope project
claude plugin uninstall formatter@your-org --scope project
בעת סגירת תפריט /plugin, קלוד קוד מריץ /reload-plugins באופן אוטומטי להחלת השינויים שבוצעו (החל מגרסה v2.1.268). אם הטעינה מחדש תבטל את ה-prompt cache, מופיעה אזהרה והשינויים ממתינים; הרצת /reload-plugins --force מחילה אותם מיידית.
עבור שינויים שמבוצעים מחוץ לתפריט, מריצים /reload-plugins ידנית:
פקודת claude plugin שהורצה בטרמינל אחר
עריכת קבצים בתוסף שנטען עם --plugin-dir בזמן פיתוח
עדכון אוטומטי של תוסף שהציג התראה המבקשת לטעון מחדש
סנכרון מחשבון claude.ai שהוסיף, עדכן או הסיר תוסף
בסשנים ללא טרמינל אינטראקטיבי (כגון Claude Desktop, Agent SDK, ומצב -p, מגרסה v2.1.260 ומעלה), הפקודה /reload-plugins פועלת רק בהקלדה ישירה בסשן (ולא דרך חיבור מרוחק כגון Remote Control), והיא אינה מחברת או מנתקת שרתי MCP של תוספים (שינויים אלה נכנסים לתוקף בסשן הבא).
הפקודה מציגה ספירה כוללת של תוספים, מיומנויות (הכוללת הן קובצי commands/ והן קובצי SKILL.md, מגרסה v2.1.246 ומעלה), סוכנים, הוקים, שרתי MCP ושרתי LSP.
מריצים /plugin ועוברים ללשונית Marketplaces כדי לצפות בכל המרקטפלייסים שהוגדרו, במקורותיהם ובמצבם, להוסיף מרקטפלייסים חדשים, לעדכן רישומים או להסיר מרקטפלייסים שאינם נחוצים עוד.
קלוד קוד בודק עדכונים למרקטפלייסים ולתוספים המותקנים ברקע לאחר תחילת הסשן, עם השהיה אקראית של עד עשר דקות. אם תוספים עודכנו, מוצגת התראה המציעה להריץ /reload-plugins, או שהגרסאות החדשות ייטענו בהפעלה הבאה.
שינוי הגדרת עדכון אוטומטי למרקטפלייס דרך הממשק מתבצע בארבעה שלבים:
מריצים /plugin לפתיחת מנהל התוספים.
בוחרים בלשונית Marketplaces.
בוחרים מרקטפלייס מהרשימה.
בוחרים Enable auto-update או Disable auto-update.
במרקטפלייס הרשמי claude-plugins-official ובמרקטפלייסים שנוספו מ-claude.ai העדכון האוטומטי מופעל כברירת מחדל. במרקטפלייסים מקומיים או של צד שלישי הוא מושבת כברירת מחדל. מנהלי מערכת יכולים להגדיר "autoUpdate": true על כל רשומת extraKnownMarketplaces בהגדרות מנוהלות.
להשבתת עדכונים אוטומטיים עבור קלוד קוד ותוספי מרקטפלייס, מגדירים את משתנה הסביבה DISABLE_AUTOUPDATER. כדי להשאיר עדכוני תוספים פעילים תוך השבתת עדכוני קלוד קוד בלבד, מגדירים במקביל:
מנהלי צוות יכולים להגדיר התקנת מרקטפלייסים אוטומטית לפרויקטים על ידי הוספת תצורת מרקטפלייס לקובץ .claude/settings.json. ברגע שחבר צוות נותן אמון בספריית המאגר, קלוד קוד מוסיף מרקטפלייסים אלה ללא בקשת אישור נוספת:
החל מגרסה v2.1.195, הוספת המרקטפלייס אינה מתקינה תוספים המגיעים ממקור חיצוני באופן אוטומטי. תוסף שהופעל רק ב-.claude/settings.json של הפרויקט ומגיע ממקור חיצוני אינו נטען עד שחבר הצוות מתקין אותו בפועל, וקלוד קוד מציג את פקודת claude plugin install שיש להריץ.
תוספים ומרקטפלייסים הם רכיבים בעלי הרשאות גבוהות שיכולים להריץ קוד שרירותי במחשבך בהרשאות המשתמש שלך. יש להתקין תוספים ולהוסיף מרקטפלייסים אך ורק ממקורות מהימנים. ארגונים יכולים להגביל את המרקטפלייסים שמשתמשים מורשים להוסיף באמצעות הגבלות מרקטפלייס מנוהלות.
תהליך יצירת תוסף עם מיומנות מותאמת אישית מורכב מחמישה שלבים:
יצירת תיקיית התוסף:
כל תוסף חי בתיקייה משלו המכילה את המיומנויות, הסוכנים או ההוקים, לצד מניפסט אופציונלי בנתיב .claude-plugin/plugin.json. המיקום אינו משנה עבור המדריך המהיר, כיוון שמצביעים עליו באמצעות הדגל --plugin-dir בשלב הבדיקה. יוצרים את התיקייה במיקום נוח:
mkdir my-first-plugin
שאר השלבים מתבצעים מתיקיית האב ומפנים לנתיבים יחסיים בתוכה.
יצירת מניפסט התוסף:
קובץ המניפסט בנתיב .claude-plugin/plugin.json מגדיר את זהות התוסף: שם, תיאור וגרסה. קלוד קוד משתמש במטא דאטה הזה כדי להציג את התוסף במנהל התוספים.
יוצרים את תיקיית .claude-plugin:
mkdir my-first-plugin/.claude-plugin
ויוצרים את הקובץ my-first-plugin/.claude-plugin/plugin.json עם התוכן הבא:
{
"name": "my-first-plugin",
"description": "A greeting plugin to learn the basics",
"version": "1.0.0",
"author": {
"name": "Your Name"
}
}
שדה
ייעוד
name
מזהה ייחודי ומרחב שמות למיומנויות. מיומנויות מקבלות קידומת זו (למשל /my-first-plugin:hello).
description
מוצג במנהל התוספים בעת דפדוף או התקנה.
version
אופציונלי. אם מוגדר, משתמשים מקבלים עדכונים רק בעת העלאת ערך זה, למעט תוספים ממקור command או תוסף שנטען ישירות במקומו (loaded in place). אם מושמט, הגרסה נקבעת לפי המקור הבא במדרג ניהול הגרסאות.
author
אופציונלי. מועיל לייחוס היוצרים.
הוספת מיומנות:
מיומנויות שוכנות בספריית skills/. כל מיומנות היא תיקייה המכילה קובץ SKILL.md. שם התיקייה הופך לשם המיומנות, בתוספת קידומת מרחב השמות של התוסף (תיקיית hello/ בתוסף בשם my-first-plugin יוצרת את המיומנות /my-first-plugin:hello).
יוצרים את תיקיית המיומנות:
mkdir -p my-first-plugin/skills/hello
ויוצרים את הקובץ my-first-plugin/skills/hello/SKILL.md עם התוכן הבא:
---
description: Greet the user with a friendly message
disable-model-invocation: true
---
Greet the user warmly and ask how you can help them today.
בדיקת התוסף:
מריצים את קלוד קוד עם הדגל --plugin-dir כדי לטעון את התוסף:
claude --plugin-dir ./my-first-plugin
לאחר שהסשן נפתח, מפעילים את המיומנות החדשה:
/my-first-plugin:hello
קלוד יגיב בהודעת ברכה. הרצת /help ומעבר ללשונית Custom commands תציג את המיומנות תחת מרחב השמות של התוסף.
מיומנויות תוסף מקבלות תמיד מרחב שמות (כמו /my-first-plugin:hello) כדי למנוע התנגשויות בין תוספים שונים שמכילים מיומנויות בעלות שם זהה. כדי לשנות את קידומת מרחב השמות, מעדכנים את שדה name בתוך plugin.json.
הוספת ארגומנטים למיומנות:
הפיכת המיומנות לדינמית נעשית באמצעות קבלת קלט מהמשתמש. שומר המקום $ARGUMENTS לוכד כל טקסט שהמשתמש מזין לאחר שם המיומנות.
מעדכנים את הקובץ my-first-plugin/skills/hello/SKILL.md:
---
description: Greet the user with a personalized message
---
במקום להעביר את הדגל --plugin-dir בכל הפעלה, אפשר להחזיק תוסף ישירות בספריית המיומנויות כדי שקלוד קוד יטען אותו אוטומטית. הפקודה יוצרת שלד ראשוני:
claude plugin init my-tool
הפקודה יוצרת את ~/.claude/skills/my-tool/ עם מניפסט .claude-plugin/plugin.json וקובץ SKILL.md בסיסי. בסשן הבא התוסף ייטען כ-my-tool@skills-dir ללא צורך במרקטפלייס וללא שלב התקנה.
תוסף שמכיל מיומנות אחת בלבד יכול למקם קובץ SKILL.md ישירות בשורש התוסף במקום ליצור תיקיית skills/. קלוד קוד טוען אותו כמיומנות בודדת ומשתמש בשדה name שב-frontmatter לצורך שם ההפעלה. יש להשתמש במבנה תיקיית skills/ עבור תוספים שעשויים להתרחב בעתיד ליותר ממיומנות אחת.
מלכודת נפוצה: אין לשים את commands/, agents/, skills/ או hooks/ בתוך תיקיית .claude-plugin/. רק plugin.json שוכן בתוך .claude-plugin/. כל שאר התיקיות חייבות להיות ישירות בשורש התוסף. שורש התוסף הוא התיקייה העצמאית של התוסף, ולעולם לא ~/.claude/. קלוד קוד לא קורא קובץ .mcp.json שמונח ישירות ב-~/.claude/.mcp.json.
description: תיאור שמוצג במנהל התוספים בעת עיון והתקנה.
version: אופציונלי. אם מוגדר, משתמשים מקבלים עדכונים רק כשהגרסה מועלית, למעט תוספים ממקור command או תוסף שנטען במקום (loaded in place). אם מושמט, הגרסה נקבעת לפי המקור הבא במדרג ניהול הגרסאות.
author: אופציונלי, לייחוס היוצרים. קיימים שדות נוספים כגון homepage, repository ו-license.
תוספים יכולים לכלול מיומנויות סוכן (Agent Skills) להרחבת היכולות של קלוד. מיומנויות אלו מופעלות על ידי המודל: קלוד משתמש בהן באופן אוטומטי בהתאם להקשר המשימה.
כל קובץ SKILL.md מכיל YAML frontmatter והוראות. יש לכלול שדה description כדי שקלוד יידע מתי להשתמש במיומנות:
---
description: Reviews code for best practices and potential issues. Use when reviewing code, checking PRs, or analyzing code quality.
---
When reviewing code, check for:
1. Code organization and structure
2. Error handling
3. Security concerns
4. Test coverage
לאחר התקנת התוסף, בודקים את סיכום ההתקנה: אם מופיע Plugin is now active., התוסף מוכן לשימוש. אם מופיעה ההודעה Run /reload-plugins to activate., קלוד קוד מריץ את הטעינה בעצמו, או שמריצים ידנית /reload-plugins --force אם הופקה אזהרה על ביטול ה-prompt cache.
עבור שפות נפוצות כגון TypeScript, Python ו-Rust, מומלץ להתקין תוספי LSP מוכנים מהמרקטפלייס הרשמי. יוצרים תוספי LSP מותאמים אישית רק כאשר נדרשת תמיכה בשפות שאינן מכוסות.
משתמשים שמתקינים את התוסף חייבים לוודא שהבינארי של שרת השפה מותקן במחשבם.
כדי לאמת שהשרת עולה, מפעילים את קלוד קוד כשהתוסף פעיל ובודקים את לשונית Errors ב-/plugin: שרת שפה שנכשל בהפעלה יופיע שם, למשל עם ההודעה Executable not found in $PATH כשהבינארי חסר. הגדרה שאינה תקינה נדלגת, וניתן להריץ claude --debug כדי לאתר את הסיבה.
מוניטורים ברקע מאפשרים לתוסף לעקוב אחר לוגים, קבצים או סטטוס חיצוני ברקע ולהודיע לקלוד בעת הגעת אירועים. קלוד קוד מפעיל כל מוניטור אוטומטית כשהתוסף פעיל, ללא צורך בהוראה יזומה לקלוד להתחיל במעקב.
מוסיפים קובץ monitors/monitors.json בשורש התוסף עם מערך של רשומות מעקב:
אנתרופיק מתחזקת שני מרקטפלייסים ציבוריים עבור קלוד קוד:
claude-plugins-official: אוסף תוספים שנבחר ומתוחזק על ידי אנתרופיק בלבד. קלוד קוד רושם אותו אוטומטית בהפעלה האינטראקטיבית הראשונה.
claude-community: המרקטפלייס הציבורי של הקהילה, שאליו מגיעות הגשות של צד שלישי לאחר סקירה. משתמשים מוסיפים אותו באמצעות /plugin marketplace add anthropics/claude-plugins-community ומתקינים ממנו עם הסיומת @claude-community.
להגשת תוסף לסקירה עבור מרקטפלייס הקהילה, משתמשים באחד הטפסים:
טופס ב-claude.ai: בכתובת claude.ai/admin-settings/directory/submissions/plugins/new. דורש ארגון מסוג Team או Enterprise והרשאת ניהול ספרייה (לבעלי ארגון, Owners, יש הרשאה זו כברירת מחדל).
טופס ב-Console: בכתובת platform.claude.com/plugins/submit. מיועד ליוצרים עצמאיים שאינם חלק מארגון Team או Enterprise.
לפני ההגשה יש להריץ מקומית את פקודת האימות:
claude plugin validate ./your-plugin
צינור הסקירה מריץ בדיקה זו על כל הגשה לצד סריקת אבטחה אוטומטית. אם הבדיקה עוברת, מודפס ✔ Validation passed, או ✔ Validation passed with warnings אם יש אזהרות. אזהרות אינן מכשילות את האימות, אך הוספת הדגל --strict גורמת להן להיחשב כשגיאות.
תוספים שאושרו מוצמדים למזהה commit SHA ספציפי בקטלוג של anthropics/claude-plugins-community, ותהליך CI מעדכן את ההצמדה אוטומטית בעת דחיפת שינויים חדשים למאגר. הקטלוג הציבורי מסתנכרן מדי לילה מצינור הסקירה, ולכן עשוי לחול עיכוב בין האישור להופעת התוסף ב-marketplace.json.
המרקטפלייס הרשמי, claude-plugins-official, מנוהל בנפרד לפי שיקול דעתה של אנתרופיק בלבד. אין תהליך הגשת בקשות עבורו, וטפסי ההגשה אינם מוסיפים תוספים אליו.
הדגל --plugin-dir מאפשר לבדוק תוספים בזמן פיתוח בטעינה ישירה ללא התקנה:
claude --plugin-dir ./my-plugin
הדגל מקבל גם ארכיון .zip של תיקיית התוסף:
claude --plugin-dir ./my-plugin.zip
כאשר לתוסף שנטען דרך --plugin-dir יש שם זהה לתוסף מותקן ממרקטפלייס, העותק המקומי מקבל עדיפות לאותו סשן. הדבר מאפשר לבדוק שינויים בתוסף מותקן בלי להסיר אותו קודם. החריג היחיד הוא תוספים שהגדרות מנוהלות כופות את הפעלתם או השבתתם, שבהם הדגל אינו יכול לעקוף.
טעינת שינויים בזמן אמת:
כאשר מבצעים שינויים בתוסף, מריצים /reload-plugins כדי להחיל את העדכונים בלי להפעיל את קלוד מחדש. הפקודה טוענת מחדש תוספים, מיומנויות, סוכנים, הוקים, שרתי MCP של תוספים ושרתי LSP של תוספים. בסשן שאינו מכיל טרמינל אינטראקטיבי, שינויים בשרתי MCP של תוספים ממתינים לסשן הבא.
בדיקת רכיבי התוסף:
מנסים מיומנויות באמצעות /plugin-name:skill-name.
מוודאים שסוכנים מופיעים ב-/context תחת Custom Agents, או פונים אליהם ישירות עם אזכור של שמם המלא.
מפעילים את האירוע שההוק מתאים לו, למשל מבקשים מקלוד לערוך קובץ עבור הוק מסוג PostToolUse, ובודקים את השפעתו. קלוד קוד מתעד בלוג הניפוי (debug log) אילו הוקים הותאמו, את קודי היציאה שלהם ואת הפלט שלהם.
טעינת מספר תוספים במקביל נעשית על ידי ציון הדגל מספר פעמים:
claude --plugin-dir ./plugin-one --plugin-dir ./plugin-two
הערכת ביצועים באמצעות claude plugin eval:
בדיקת התוסף באמצעות --plugin-dir מראה שהוא יכול לעבוד. כדי לגלות באיזו תדירות קלוד אכן פונה אליו ומקבל את התוצאה הנכונה, מריצים את הפקודה:
claude plugin eval
הפקודה מריצה בדיקות הערכה מוגדרות מראש מול התוסף ומודדת את שיעורי ההצלחה וההפעלה שלו בפועל.
שרת השפה אינו מופעל: מוודאים שהבינארי מותקן וזמין ב-$PATH. בודקים בלשונית Errors ב-/plugin לקבלת פרטים נוספים.
צריכת זיכרון גבוהה: שרתי שפה כגון rust-analyzer ו-pyright עלולים לצרוך זיכרון רב בפרויקטים גדולים. במקרה של בעיות זיכרון, משביתים את התוסף באמצעות /plugin disable <plugin-name> ומסתמכים על כלי החיפוש המובנים של קלוד.
אבחונים חיוביים שגויים (False positives) ב-monorepos: שרתי שפה עשויים לדווח על שגיאות ייבוא שלא נפתרו עבור חבילות פנימיות אם סביבת העבודה אינה מוגדרת במדויק. שגיאות אלו אינן מונעות מקלוד לערוך קוד בהצלחה.