🧩 פרק 13

תוספים, סביבות פיתוח ואינטגרציות

מערכת התוספים (Plugins) של קלוד קוד מאפשרת להרחיב את היכולות באמצעות מיומנויות (Skills), סוכנים (Agents), הוקים (Hooks), מודול הוקים, שרתי MCP ורכיבים נוספים כמו שרתי שפה (LSP). תוסף הוא ספרייה של רכיבים שקלוד קוד מתקין וטוען כיחידה אחת, בדרך כלל עם מניפסט .claude-plugin/plugin.json שנותן לתוסף שם ויכול להוסיף גרסה, תיאור ומטא-דאטה נוסף. רוב התוספים מגיעים ממרקטפלייס, שהוא קטלוג. אפשר גם לטעון תוסף מתיקייה שקיבלת, או לבנות אחד בעצמך.

בדוגמה של תוסף בשם my-plugin: המניפסט קובע את השם, skills/review/SKILL.md רץ כ-/my-plugin:review, agents/reviewer.md הוא סוכן משנה שקלוד יכול להאציל אליו, hooks/hooks.json מחזיק הוקים על אירועי מחזור חיים (למשל אחרי כל עריכה), ו-.mcp.json מוסיף שרת MCP שנותן כלים. מודול הוקים הוא הוקים שנכתבים כפונקציות JavaScript, ויכול גם לצייר חלוניות ולהוסיף פקודות. תוסף שיש בו מודול כזה נקרא mod. חלק מה-mods מובנים בתוך קלוד קוד.

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

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

• הגדרה עצמאית (ספריית .claude/): מתאימה לתהליכי עבודה אישיים, התאמות ספציפיות לפרויקט וניסויים מהירים. שמות המיומנויות מופיעים ישירות, למשל /hello. מומלץ להתחיל בהגדרה עצמאית בתוך .claude/ לצורך איטרציות מהירות, ולהסב אותה לתוסף כשמוכנים לשתף.
• תוספים (תיקיות עצמאיות עם מיומנויות, סוכנים, הוקים או מניפסט .claude-plugin/plugin.json): מתאימים לשיתוף עם חברי צוות, הפצה לקהילה, גרסאות מנוהלות ושימוש חוזר בין פרויקטים. שמות המיומנויות כוללים מרחב שמות, למשל /plugin-name:hello.

#מה תוסף מופעל מוסיף לסשן

תוסף מופעל הוא חלק מכל סשן, גם בסשנים שבהם לא משתמשים בו:

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

אפשר לבדוק את טביעת הרגל בשלבים האלה:

• לפני ההתקנה: הערכת Context cost לתוסף במרקטפלייס הרשמי של אנתרופיק מופיעה כשפותחים אותו מלשונית Marketplaces ב-/plugin, וגם כשפותחים אותו תוך ציון המרקטפלייס. חלונית הפרטים שמגיעים אליה מרשימת Discover אינה מציגה את ההערכה.
• אחרי ההתקנה: claude plugin details <name> מציג את טביעת הרגל של תוסף מותקן. שורת Always-on היא מספר הטוקנים שהתוסף מוסיף לכל סשן שבו הוא מופעל, והשורות לפי רכיב מראות איזו מיומנות או איזה סוכן תורמים הכי הרבה. לשונית Installed מקבצת תוספים תחת Not used recently, ושם אפשר לראות מה אפשר לכבות.
• לעצור בלי להסיר: משביתים עם /plugin, או במעטפת עם claude plugin disable.

חשבון claude.ai הוא מקור נפרד לתוספים, לצד מרקטפלייסים. כל תוסף שמופעל בחשבון, וכל תוסף שהארגון מפעיל לחבריו, מגיע לקלוד קוד בלי התקנה ממרקטפלייס. בסשן טרמינל הסנכרון רץ ברקע בכל הפעלה כל עוד אתה מחובר לאותו חשבון. בסשני Cowork ההורדה מתבצעת בתחילת הסשן. ב-/plugin וב-claude plugin list הם מופיעים תחת המזהה <name>@synced. אפשר לכבות תוסף בטווח שלך, אלא אם הארגון סימן אותו כחובה. תוסף שהתקנת עם /plugin או עם claude plugin install נשאר על המחשב הזה ואינו נוסף לחשבון claude.ai. אותו פורמט תוסף מותקן גם ב-claude.ai וב-Cowork, ושם נטען סט רכיבים אחר. מי שמשתמש רק בצ'אט של claude.ai או ב-Cowork, בלי קלוד קוד, עובד לפי התיעוד הנפרד של התוספים באותן סביבות.

מלכודת: הרחבת VS Code ותוסף JetBrains הם הדרך להריץ את קלוד קוד בתוך ה-IDE. הם אינם תוסף של קלוד קוד במובן של הפרק הזה.

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

#כיצד פועלים מרקטפלייסים

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

1. הוספת המרקטפלייס: פעולה זו רושמת את הקטלוג בקלוד קוד כדי שתוכל לעיין במה שזמין. בשלב זה אף תוסף אינו מותקן עדיין.
2. התקנת תוספים בודדים: עיון בקטלוג והתקנת התוספים הרצויים לפי שם, למשל commit-commands@claude-plugins-official.

מוסיפים מרקטפלייס פעם אחת. אחר כך התוספים שלו מופיעים בלשונית Discover, ומתקינים עם /plugin install <plugin>@<marketplace> בסשן או עם claude plugin install <plugin>@<marketplace> במעטפת. <marketplace> הוא השם שבו המרקטפלייס נרשם.

אם פקודת ההתקנה שקיבלת משתמשת בשם אחרי @ שאינו claude-plugins-official, מוסיפים את המרקטפלייס הזה קודם. אפשר גם להוסיף מרקטפלייס ולהתקין ממנו בפקודה אחת, כמתואר בהמשך.

אתר Claude Marketplace בכתובת claude.com/marketplace משמש לעיון בתוספים, במחברים (connectors), במוצרי שותפים ובשותפי שירות. הוספת מרקטפלייס בקלוד קוד נעשית מול קטלוג עם .claude-plugin/marketplace.json. האתר עצמו אינו יעד לפקודה /plugin marketplace add.

כדי שתוסף שכבר הותקן ייתן מיומנות שאפשר להריץ, הוא צריך להיות נוכח בשלוש שכבות:

• הגדרות: רשימת המרקטפלייסים שנוספו והתוספים שמופעלים.
• דיסק: ~/.claude/plugins/ מחזיק את מה שקלוד קוד הוריד והתקין.
• סשן: התוספים נטענים בעלייה, או כשמריצים טעינת תוספים מחדש.

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

#המרקטפלייס הרשמי של אנתרופיק

קלוד קוד מוסיף את המרקטפלייס הרשמי של אנתרופיק (claude-plugins-official) באופן אוטומטי בהפעלה האינטראקטיבית הראשונה של סשן טרמינל, אלא אם מדיניות מנוהלת חוסמת אותו. קלוד קוד אינו מוסיף בעצמו את מרקטפלייס הקהילה, ואינו מוסיף בעצמו את claude-code-plugins. אם המרקטפלייס הרשמי אינו רשום, אפשר להוסיף אותו ידנית:

/plugin marketplace add anthropics/claude-plugins-official

במכונה שעדיין לא נפתח בה סשן אינטראקטיבי, המרקטפלייס הרשמי אינו רשום. סקריפט שמתקין ממנו מריץ קודם claude plugin marketplace add anthropics/claude-plugins-official.

כדי לעיין בתוספים הזמינים, מריצים /plugin ועוברים ללשונית Discover, או צופים בקטלוג באתר claude.com/marketplace/plugins. כפתור Claude Code באתר מעתיק את פקודת ההתקנה בצורת המעטפת: claude plugin install <name>@claude-plugins-official.

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

/plugin install github@claude-plugins-official

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

הפקודה /plugin פותחת חלונית אינטראקטיבית ב-CLI של הטרמינל. אם קלוד משיב /plugin isn't available in this environment., התוספים שכבר הותקנו כן נטענים, ומתקינים ומנהלים אותם מהמעטפת עם claude plugin. דרכי התקנה לפי סביבה מפורטות בהמשך, בסעיף התקנת תוספים.

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

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

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

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

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

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

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

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

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

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

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

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

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

#סגנונות פלט

התאמת אופן המענה של קלוד:

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

#מרקטפלייס הקהילה

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

/plugin marketplace add anthropics/claude-plugins-community

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

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

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

#שלוש רמות של שמות מרקטפלייס

שם המרקטפלייס משייך אותו לאחת משלוש רמות. קלוד קוד מקבל את השמות הרשמיים ואת שמות הקהילה רק כשהמקור הוא מאגר תחת github.com/anthropics/:

בכל רמה, תוסף שמתקינים יכול להריץ קוד בהרשאות המשתמש שלך.

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

#התנסות מעשית: התקנת תוסף מהמרקטפלייס הרשמי

הדוגמה מתקינה את commit-commands מהמרקטפלייס הרשמי. התוסף מוסיף פקודות ל-commit, ל-push ולפתיחת pull request. אותם צעדים מתאימים לכל תוסף: מחליפים את commit-commands ואת claude-plugins-official בשם התוסף ובשם המרקטפלייס. אם התוסף מגיע ממרקטפלייס אחר, מוסיפים את המרקטפלייס קודם. קלוד קוד מוסיף את המרקטפלייס הרשמי בעצמו בהפעלה האינטראקטיבית הראשונה של סשן טרמינל, ולכן הדוגמה מדלגת על השלב הזה.

1. פתיחת פרטי התוסף: מפעילים את קלוד קוד עם claude בתוך הפרויקט, ומריצים:

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

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

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

• Will install: הפקודות, הסוכנים, המיומנויות, ההוקים, ושרתי ה-MCP וה-LSP שהתוסף מוסיף
• Last updated: מוצג לתוסף במרקטפלייס הרשמי של אנתרופיק
• Context cost: לתוסף במרקטפלייס הרשמי, שתי הערכות טוקנים. Every turn הוא מה שהתוסף מוסיף לכל הודעה ששולחים, ו-When invoked הוא מה שהמיומנויות והסוכנים שלו מוסיפים אחרי שקלוד טוען אותם. ההערכות מופיעות כשפותחים את התוסף תוך ציון המרקטפלייס, כמו בפקודה של צעד 1, או מלשונית Marketplaces. חלונית הפרטים שמגיעים אליה מרשימת Discover אינה מציגה אותן.

בתוספים ממרקטפלייס מקומי או מותאם אישית עשוי להופיע במקום זאת הכיתוב Components will be discovered at installation.

תוסף יכול להריץ הוקים ושרתי 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): התוסף זמין לך במאגר הזה בלבד

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

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

4. קריאת סיכום ההתקנה: המשפט האחרון בסיכום אומר אם התוסף שמיש בסשן הזה:

• פעיל עכשיו: Plugin is now active. אין צורך בטעינה מחדש.
• פעיל, אבל שרת דורש הגדרה: אחרי Plugin is now active. מופיע Its bundled MCP server needs configuration before it can start. שרת ה-MCP הארוז בתוסף אינו עולה עד שמגדירים את האפשרויות שלו. בוחרים את התוסף בלשונית Installed ב-/plugin ובוחרים Configure.
• נדרשת טעינה מחדש: Run /reload-plugins to apply. החלונית נסגרת וקלוד קוד מריץ את הטעינה בעצמו. אם הטעינה תפסול את מטמון הפרומפט, מופיעה אזהרה והתוסף נשאר ממתין. מריצים /reload-plugins --force כדי להפעיל אותו בכל זאת. הפעולה עולה בקשה אחת בלי מטמון.
• הטעינה נכשלה: 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 אינה מופיעה, הסיבה נמצאת בלשונית Errors, ובסעיף פתרון בעיות בהמשך.

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

התקנה מכל מרקטפלייס אחר דורשת קודם הוספה של המרקטפלייס. אם מצאתם תוסף ב-claude.com/marketplace, כפתור Claude Code מעתיק את פקודת ההתקנה בצורת המעטפת.

אפשר לעבור בין הלשוניות של /plugin עם Tab:

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

#הוספת מרקטפלייסים

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

הפקודה /plugin marketplace add מאפשרת להוסיף מרקטפלייסים ממקורות שונים. קיצור: אפשר להשתמש ב-/plugin market במקום ב-/plugin marketplace.

מהמעטפת, claude plugin marketplace add מקבל את אותם מקורות.

כוללים את הקידומת https:// בכל כתובת, או משתמשים בצורה git@host:path ל-SSH. כתובת חשופה כמו gitlab.example.com/your-group/your-marketplace.git נקראת כקיצור GitHub מסוג owner/repo ונדחית.

כשהפקודה מצליחה היא מדפיסה Successfully added marketplace: <name>. התוספים מופיעים בלשונית Discover בפתיחה הבאה של /plugin, בלי טעינה מחדש. אם ההוספה נכשלת, מתאימים את הודעת השגיאה להנחיות פתרון הבעיות של תוספים בתיעוד הרשמי.

#הוספה והתקנה בפקודה אחת

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

#הוספה והתקנה בסשן

מריצים /plugin install בסשן עם שם התוסף והמקור. דורש גרסה v2.1.275 ומעלה. בסשן המקור אינו יכול להכיל רווחים:

/plugin install deploy-helper --marketplace your-org/plugins

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

#הוספה והתקנה מהמעטפת

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

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

/plugin marketplace add anthropics/claude-code

אנתרופיק מתחזקת גם את המרקטפלייס claude-code-plugins במאגר anthropics/claude-code. השם claude-code-plugins הוא שם ברמה הרשמית, וקלוד קוד אינו מוסיף את המרקטפלייס הזה בעצמו. מוסיפים אותו ידנית בפקודה הזו. הפעולה מורידה את הקטלוג ומנגישה את התוספים שבו. התקנה ממנו:

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

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

הוספת מאגר Git מתבצעת באמצעות ציון כתובת ה-URL המלאה שלו. עבור כתובות https://, שאלת הצורך בסיומת .git תלויה בשרת המארח:

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

שימוש ב-HTTPS:

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

שימוש ב-SSH:

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

בשכפול דרך 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 מרוחק באמצעות כתובת ישירה:

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

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

#מרקטפלייס פרטי

מרקטפלייס פרטי הוא מאגר שצריך הרשאות כדי לשכפל אותו, ב-GitHub או בכל שרת git אחר. מוסיפים אותו באותה פקודה /plugin marketplace add או claude plugin marketplace add. קלוד קוד משכפל עם הרשאות ה-git שכבר קיימות במכונה, ואינו שואל:

• HTTPS: עוזרי הרשאות ה-git חלים, כך שגישה שהוגדרה עם gh auth login, עם macOS Keychain או עם git-credential-store עובדת. בקשות של git ותוכניות askpass כבויות, כולל תוכנית שמוגדרת ב-GIT_ASKPASS, ולכן השכפול נכשל במקום לבקש הרשאה כש-git היה צריך לשאול.
• SSH: השרת כבר נמצא בקובץ known_hosts, והמפתח עובד בלי בקשת passphrase. אם הגדרת ה-git מציינת תוכנית SSH ב-GIT_SSH_COMMAND, ב-GIT_SSH או ב-core.sshCommand, קלוד קוד מריץ את התוכנית הזו.
• קיצור GitHub owner/repo: קלוד קוד בודק אם מפתח ה-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 דורשת גרסה v2.1.273 ומעלה.

• בתוך סשן: מריצים /plugin ועוברים ללשונית Marketplaces, שמציגה את המרקטפלייסים מ-claude.ai. בוחרים אחד כדי להוסיף אותו.
• מהמעטפת: claude plugin marketplace list מדפיס אותם תחת הסעיף From claude.ai:. אחר כך מריצים 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

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

הסעיף From claude.ai: יכול להציג גם מרקטפלייסים מבוססי Git ששותפו דרך claude.ai, והוא מדפיס מקור לכל אחד מהם. מוסיפים אותם לפי המקור הזה, כמו כל מרקטפלייס אחר, לא עם --claudeai.

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

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

/plugin install plugin-name@marketplace-name

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

• 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 באותו מחשב קוראים את אותם קובצי הגדרות. תוסף שהותקן בטווח משתמש באחד מהם זמין גם בשניים האחרים.

סשן ענן, כולל דפדפן ב-claude.ai/code, אינו טוען את התוספים שהותקנו על המכונה, ואינו טוען תוספים שקובץ .claude/settings.json של המאגר מפעיל. תוספים שהארגון מפיץ דרך הגדרות מנוהלות מטופלים בנפרד. פירוט לפי סביבה מופיע בהמשך.

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

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

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

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

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

#התקנה מהמעטפת

claude plugin install מתקין בלי לפתוח סשן של קלוד קוד, למשל מתוך סקריפט הקמה.

• טווח: User scope כברירת מחדל. מעבירים --scope project או --scope local כדי לשנות.
• מתי התוספים נטענים: בהפעלה הבאה של קלוד קוד, או כשמריצים /reload-plugins בסשן שכבר פתוח.
• המרקטפלייס כבר נוסף: במכונה בלי סשן אינטראקטיבי קודם, רושמים קודם את המרקטפלייס הרשמי כפי שתואר למעלה. להתקנה ממרקטפלייס שעדיין לא נוסף, מהמעטפת ובלי אישור, משתמשים ב---marketplace. זה דורש גרסה v2.1.292 ומעלה.

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

בסיום הפקודה מדפיסה Successfully installed plugin: formatter@your-org (scope: project).

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

#התקנה לפי סביבה

אפליקציית שולחן העבודה, בסשן מקומי או ב-SSH בלשונית Code:

1. לוחצים על + ליד תיבת הפרומפט ובוחרים Add plugins. אם תפריט + מציג Plugins במקום Add plugins, בוחרים Plugins ואז Browse plugins. דפדפן התוספים נפתח עם התוספים מהמרקטפלייסים שלך.
2. מוצאים את התוסף ובוחרים אותו. בדוגמה של commit-commands, מוצאים את commit-commands ובוחרים אותו.
3. בוחרים טווח: חשבון המשתמש, הפרויקט הזה, או מקומי בלבד.

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

VS Code, בחלונית קלוד קוד:

1. מקלידים /plugins בתיבת הפרומפט כדי לפתוח את Manage plugins.
2. בלשונית Plugins מחפשים את התוסף ולוחצים Install. בדוגמה מחפשים את commit-commands. אם הלשונית ריקה, מוסיפים קודם את anthropics/claude-plugins-official בלשונית Marketplaces.
3. בוחרים טווח: Install for you, Install for this project, או Install locally.

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

סשן ענן, כולל הדפדפן ב-claude.ai/code: אין דפדפן תוספים, והסשן אינו טוען תוספים שהתקנת על המכונה שלך ואינו טוען תוספים שקובץ .claude/settings.json של המאגר מפעיל. תוספים שהארגון מפיץ דרך הגדרות מנוהלות מטופלים בנפרד בתיעוד הארגוני. שאר חלקי ההגדרה שזמינים גם בסשן ענן מתוארים בתיעוד סביבות הענן. דפדפן התוספים אינו זמין בסשני הענן של אפליקציית שולחן העבודה.

מקומות בלי דפדפן תוספים משלהם:

• JetBrains: תוסף JetBrains מריץ את קלוד קוד בטרמינל של ה-IDE, ומשתמשים שם בצעדי הטרמינל.
• claude -p והרצות לא אינטראקטיביות: /plugin אינו רץ, וקלוד משיב /plugin isn't available in this environment. תוספים שכבר הותקנו כן נטענים. מתקינים ומנהלים מהמעטפת.
• Agent SDK: טוענים תוספים דרך אפשרות התוספים של ה-SDK.

אם קלוד קוד מדווח שתוסף שמופעל ב-.claude/settings.json של המאגר אינו מותקן, השותף מריץ פעם אחת את claude plugin install <name>@<marketplace> --scope project, כמתואר בטווח הפרויקט.

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

#תוספים מחשבון claude.ai

ב-/plugin וב-claude plugin list הם מופיעים תחת המזהה <name>@synced. אפשר לכבות תוסף בטווח שלך, אלא אם הארגון סימן אותו כחובה. פירוט הניהול מופיע בסעיף ניהול תוספים מותקנים.

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

לשונית Installed ב-/plugin מציגה את התוספים עם פעולות להפעלה, להשבתה, לעדכון או להסרה. בסשן מריצים /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 של השרת.

תצוגת הפרטים מציגה גם את הרכיבים שהתוסף תורם: פקודות, מיומנויות, סוכנים, הוקים, שרתי MCP ושרתי LSP.

במעטפת, claude plugin details <name> מיועד לתוסף מותקן. שורת Always-on היא מספר הטוקנים שהתוסף מוסיף לכל סשן שבו הוא מופעל, והשורות לפי רכיב מראות איזו מיומנות או איזה סוכן תורמים הכי הרבה.

הלשונית יכולה להציג גם תוספים בטווח Managed. אי אפשר להפעיל, להשבית או להסיר אותם כאן.

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

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

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

/plugin list

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

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

/plugin disable plugin-name@marketplace-name

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

/plugin enable plugin-name@marketplace-name

במזהים אלה, plugin-name הוא שם התוסף ברשומת המרקטפלייס, אשר יכול להיות שונה מהשם ב-plugin.json של התוסף עצמו. מגרסה v2.1.195 ומעלה, הפקודות מקבלות כל אחד משני השמות.

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

/plugin uninstall plugin-name@marketplace-name

#תוספים מסונכרנים מ-claude.ai

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

• הפעלה או השבתה: דרך לשונית Installed, אלא אם הארגון סימן את התוסף כחובה.
• הסרה: מכבים את התוסף ב-claude.ai.

כשקלוד קוד מסנכרן תוסף שנוסף, עודכן או הוסר לתוך סשן אינטראקטיבי, מופיע Plugins changed. Run /reload-plugins to activate. מריצים /reload-plugins כדי לטעון את השינוי באותו סשן, או משאירים אותו להפעלה הבאה.

#הסרת תוסף שהפרויקט מפעיל

כשבוחרים Uninstall לתוסף שקובץ .claude/settings.json של המאגר מפעיל, מהלשונית Installed או עם /plugin uninstall, קלוד קוד שואל אם להשבית עבורך או להסיר לכולם:

• Disable for me: לוחצים y. קלוד קוד כותב false לתוסף בקובץ .claude/settings.local.json ומשאיר אותו מותקן לפרויקט.
• Uninstall for everyone: לוחצים u. קלוד קוד מסיר את התוסף מקובץ .claude/settings.json המשותף.

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

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

#תוספים עם תלויות

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

• התקנה: קלוד קוד מתקין ומפעיל גם את התלויות המוצהרות, באותו טווח. הודעת ההצלחה מפרטת אותן.
• הפעלה: קלוד קוד מפעיל גם תלויות שמותקנות אבל מושבתות. אם תלות מוצהרת אינה מותקנת, ההפעלה נכשלת וההודעה אומרת להתקין אותה קודם.
• השבתה: אם תוסף מופעל אחר עדיין צריך את התוסף שציינת, קלוד קוד מסרב ומדפיס פקודה משורשרת שמשביתה את שניהם בסדר הנכון.
• הסרה: תלויות שהותקנו אוטומטית נשארות עד שמריצים claude plugin prune במעטפת.

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

#ניהול מהמעטפת

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

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

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

עבור שינויים המתרחשים מחוץ לתפריט, יש להריץ את /reload-plugins ידנית:

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

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

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

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

בעת טעינה מחדש, קלוד קוד טוען את כל התוספים הפעילים ומציג מונים עבור תוספים, מיומנויות, סוכנים, הוקים, שרתי MCP ושרתי LSP (ללא מונה שרתי MCP בסשן ללא טרמינל אינטראקטיבי). במונה המיומנויות נספרות כל המיומנויות שהתוסף מספק: הן רשומות commands/ והן מיומנויות SKILL.md (לפני גרסה v2.1.246 נספרו רק רשומות commands/).

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

#ניהול מרקטפלייסים

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

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

/plugin marketplace remove marketplace-name

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

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

הסשן הרץ ממשיך עם הגרסאות שכבר נטענו. אחרי עדכון מופיע Plugin updated: <name> · Run /reload-plugins to apply, והסשן הבא טוען את הגרסאות החדשות אוטומטית.

ברירות המחדל לפי סוג מרקטפלייס:

• מופעל כברירת מחדל: claude-plugins-official ושאר השמות הרשמיים של מרקטפלייסים, למעט knowledge-work-plugins ו-first-party-plugins, וגם מרקטפלייסים שנוספו מ-claude.ai.
• כבוי כברירת מחדל: כל מרקטפלייס אחר, כולל מרקטפלייס הקהילה, מרקטפלייסים של צד שלישי, ומרקטפלייסים לפיתוח מקומי.

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

עדכון אוטומטי מדלג על תוסף שרשומת המרקטפלייס שלו כוללת headersHelper. קלוד קוד אינו מריץ את הפקודה ואינו מוריד את הארכיון במסלול זה.

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

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

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

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

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

export DISABLE_AUTOUPDATER=1
export FORCE_AUTOUPDATE_PLUGINS=1

#עדכון תוספים עכשיו

לעדכון תוסף אחד, פותחים אותו בלשונית Installed בסשן ובוחרים Update now, או מריצים במעטפת:

claude plugin update <plugin>@<marketplace>

אין פקודה שמעדכנת את כל התוספים בבת אחת. כדי לעדכן יחד את התוספים שהותקנו ממרקטפלייס אחד, עוברים ללשונית Marketplaces, בוחרים את המרקטפלייס, ובוחרים Update marketplace. הפעולה מרעננת את רשימת המרקטפלייס, מעדכנת את התוספים שהותקנו ממנו, ומדווחת על תוסף שהושאר לעדכון ידני. תוסף עם מקור command, או שרשומת המרקטפלייס שלו מגדירה פקודת headersHelper, אינו מתעדכן בדרך הזו. מעדכנים אותו מתצוגת Installed או עם claude plugin update <plugin>@<marketplace>.

הרצת claude plugin marketplace update במעטפת בלי שם מרעננת את הרשימה של כל מרקטפלייס, ומשאירה את התוספים המותקנים בגרסה הנוכחית שלהם.

#עדכון אוטומטי ממרקטפלייס פרטי

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

#הגדרת מרקטפלייסים לצוות

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

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

claude plugin install <name>@<marketplace> --scope project

הוספת extraKnownMarketplaces לקובץ .claude/settings.json:

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

#מדריך מהיר ליצירת תוסף ראשון

מדריך מהיר זה מלווה יצירת תוסף עם מיומנות מותאמת אישית: יצירת מניפסט, הוספת מיומנות ובדיקה מקומית באמצעות הדגל --plugin-dir.

#דרישות מוקדמות

• קלוד קוד מותקן ומאומת

#יצירת התוסף הראשון שלך

1. יצירת ספריית התוסף: כל תוסף שוכן בספרייה משלו המכילה מיומנויות, סוכנים או הוקים, לצד מניפסט אופציונלי בכתובת .claude-plugin/plugin.json. המיקום אינו משנה עבור שלב זה, כיוון שניתן לכוון אליו את קלוד קוד באמצעות הדגל --plugin-dir. יוצרים את הספרייה בכל מיקום נוח:

mkdir my-first-plugin

השלבים הבאים מתבצעים מתוך ספריית האב ומפנים לנתיבים יחסיים כגון my-first-plugin/....

2. יצירת מניפסט התוסף: קובץ המניפסט בכתובת .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"
  }
}

3. הוספת מיומנות: מיומנויות שוכנות בספריית 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.

4. בדיקת התוסף שלך: מריצים את קלוד קוד עם הדגל --plugin-dir לטעינת התוסף:

claude --plugin-dir ./my-first-plugin

לאחר הפעלת קלוד קוד, מנסים את המיומנות החדשה:

/my-first-plugin:hello

קלוד ישיב בברכת שלום. מריצים /help ופותחים את לשונית Custom commands כדי לראות את המיומנות תחת מרחב השמות של התוסף.

מיומנויות של תוספים מקבלות תמיד מרחב שמות (כגון /my-first-plugin:hello) כדי למנוע התנגשויות כאשר למספר תוספים יש מיומנויות בעלות אותו שם. לשינוי קידומת מרחב השמות, מעדכנים את השדה name ב-plugin.json.

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

מעדכנים את הקובץ my-first-plugin/skills/hello/SKILL.md:

---
description: Greet the user with a personalized message
---

# Hello Skill

Greet the user named "$ARGUMENTS" warmly and ask how you can help them today. Make the greeting personal and encouraging.

מריצים /reload-plugins להחלת השינויים, ולאחר מכן מנסים את המיומנות עם שם:

/my-first-plugin:hello Alex

קלוד יברך אותך בשמך.

#פיתוח תוסף בתוך ספריית המיומנויות

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

claude plugin init my-tool

פקודה זו יוצרת את הספרייה ~/.claude/skills/my-tool/ עם מניפסט .claude-plugin/plugin.json וקובץ SKILL.md ראשוני. בסשן הבא התוסף נטען כ-my-tool@skills-dir ללא צורך במרקטפלייס או בהתקנה.

#מבנה התוסף

תוספים יכולים לכלול מיומנויות, סוכנים מותאמים אישית, הוקים, שרתי MCP, שרתי LSP וניטור רקע. מודול הוקים שנכתב כפונקציות JavaScript, ויכול גם לצייר חלוניות ולהוסיף פקודות, הופך את התוסף ל-mod. חלק מה-mods מובנים בקלוד קוד.

מלכודת נפוצה: אין לשים את הספריות commands/, agents/, skills/ או hooks/ בתוך ספריית .claude-plugin/. רק הקובץ plugin.json שוכן בתוך .claude-plugin/. כל שאר הספריות חייבות להיות ברמת השורש של התוסף. שורש התוסף הוא הספרייה האישית של התוסף (לדוגמה my-first-plugin/) ולא ~/.claude/. לדוגמה, קלוד קוד אינו קורא קובץ .mcp.json הממוקם ב-~/.claude/.mcp.json.

תוסף הכולל מיומנות אחת בלבד יכול למקם את הקובץ SKILL.md ישירות בשורש התוסף במקום ליצור ספריית skills/. קלוד קוד טוען אותו כמיומנות בודדת ומשתמש בשדה name שב-frontmatter כשם ההפעלה. יש להשתמש במבנה ספריית skills/ עבור תוספים שעשויים להתרחב מעבר למיומנות אחת.

#פיתוח תוספים מורכבים יותר

לאחר הכרת תוספים בסיסיים, ניתן ליצור הרחבות מורכבות יותר.

#הוספת מיומנויות (Skills) לתוסף

מיומנויות מופעלות על ידי המודל: קלוד משתמש בהן אוטומטית בהתאם להקשר המשימה. מוסיפים ספריית skills/ בשורש התוסף עם תיקיות מיומנות המכילות קובצי SKILL.md:

my-plugin/
├── .claude-plugin/
│   └── plugin.json
└── skills/
    └── code-review/
        └── SKILL.md

כל קובץ 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

לאחר התקנת התוסף, אם סיכום ההתקנה מדווח Run /reload-plugins to apply., החלונית נסגרת וקלוד קוד מריץ את הטעינה. אם הטעינה מזהירה מפני פסילת מטמון הפרומפט, מריצים /reload-plugins --force.

#הוספת שרתי LSP לתוסף

תוספי LSP מעניקים לקלוד בינת קוד בזמן אמת. עבור שפות שאינן מכוסות בתוסף רשמי, ניתן ליצור תוסף LSP מותאם אישית על ידי הוספת קובץ .lsp.json לשורש התוסף:

{
  "go": {
    "command": "gopls",
    "args": ["serve"],
    "extensionToLanguage": {
      ".go": "go"
    }
  }
}

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

#הוספת ניטור ברקע (Monitors) לתוסף

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

מוסיפים קובץ monitors/monitors.json בשורש התוסף עם מערך של רשומות ניטור:

[
  {
    "name": "error-log",
    "command": "tail -F ./logs/error.log",
    "description": "Application error log"
  }
]

כל שורת פלט רגיל (stdout) מהפקודה נמסרת לקלוד כהתראה במהלך הסשן.

#הפצת הגדרות ברירת מחדל עם התוסף

תוספים יכולים לכלול קובץ settings.json בשורש התוסף להחלת הגדרות ברירת מחדל בעת הפעלת התוסף. נכון לעכשיו נתמכים רק המפתחות agent ו-subagentStatusLine.

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

{
  "agent": "security-reviewer"
}

דוגמה זו מפעילה את הסוכן security-reviewer המוגדר בספריית agents/ של התוסף. הגדרות מ-settings.json מקבלות עדיפות על פני הגדרות שהוצהרו ב-plugin.json. מפתחות לא מוכרים זוכים להתעלמות שקטה.

#ארגון תוספים מורכבים

בתוספים הכוללים רכיבים רבים, מומלץ לארגן את מבנה הספריות לפי פונקציונליות.

#בדיקת תוספים באופן מקומי

הדגל --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_CODE_PLUGIN_DIRS. קלוד קוד טוען כל נתיב באופן זהה לטעינה עם --plugin-dir. תוספים אלה נטענים בנוסף לתוספים המועברים ב---plugin-dir. הגדרות פרויקט והגדרות מקומיות אינן יכולות לקבוע משתנה זה. משתנה הסביבה CLAUDE_CODE_PLUGIN_DIRS דורש גרסה v2.1.280 ומעלה.

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

לטעינת מספר תוספים ממיקום יחיד, ניתן להעביר תיקייה המכילה אותם, למשל --plugin-dir ./plugins (דורש גרסה v2.1.265 ומעלה). קלוד קוד בודק את הרמה העליונה של התיקייה: אם אין בה מניפסט או רכיבי תוסף ברמה העליונה, קלוד קוד מתייחס אליה כאל תיקיית תוספים, וכל תת-ספרייה ישירה המכילה מניפסט .claude-plugin/plugin.json נטענת כתוסף נפרד. קלוד קוד מדלג על כל שאר התכנים בתיקייה ללא דיווח שגיאה, כולל תוספים ללא מניפסט. בסשן אינטראקטיבי קלוד קוד מנטר שינויים: תת-ספרייה שמתווספת נטענת כתוסף חדש ברגע שהמניפסט נוצר, ותת-ספרייה שמוסרת נפרקת. אם החלת שינוי באמצע שיחה תפסול את מטמון הפרומפט, קלוד קוד משהה את השינוי ומציג הודעה להרצת /reload-plugins.

לבדיקת תוסף הארוז כארכיון .zip ומאוחסן בכתובת URL, כגון תוצר בנייה ב-CI, משתמשים בדגל --plugin-url. קלוד קוד מוריד את הארכיון בעלייה וטוען אותו לאותו סשן בלבד. אם לא ניתן להוריד את הארכיון או שהארכיון אינו תקין, קלוד קוד עולה ללא התוסף ורושם שגיאת טעינה בלשונית Errors ב-/plugin. יש להפנות דגל זה אך ורק לארכיונים מהימנים:

claude --plugin-url https://example.com/my-plugin.zip --plugin-url https://example.com/other.zip

ניתן גם להעביר כתובות מופרדות ברווח כארגומנט יחיד במירכאות:

claude --plugin-url "https://example.com/my-plugin.zip https://example.com/other.zip"

#איתור שגיאות בתוספים

אם התוסף אינו פועל כמצופה:

1. בדיקת המבנה: ודא שהספריות נמצאות בשורש התוסף ולא בתוך .claude-plugin/.
2. בדיקת רכיבים בנפרד: בדוק כל מיומנות, סוכן והוק בנפרד.
3. שימוש בכלי אימות ואיתור שגיאות: שימוש בפקודות CLI ובשיטות ניפוי שגיאות.

#שיתוף התוספים שלך

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

1. הוספת תיעוד: הוסף קובץ README.md עם הוראות התקנה ושימוש.
2. בחירת אסטרטגיית גרסאות: החלט האם לקבוע שדה version מפורש או להסתמך על מנגנון ברירת המחדל.
3. יצירה או שימוש במרקטפלייס: הפץ את התוסף דרך מרקטפלייס לצורך התקנה.
4. בדיקה עם אחרים: תן לחברי צוות לבדוק את התוסף לפני הפצה רחבה.

#הגשת תוסף למרקטפלייס הקהילה

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

• claude-plugins-official: מרקטפלייס מנוהל ומפוקח על ידי אנתרופיק, הנרשם אוטומטית בהפעלה אינטראקטיבית ראשונה, אלא אם מדיניות מנוהלת חוסמת אותו. אם קלוד קוד הופעל באופן לא אינטראקטיבי לפני כן, ניתן לרשום אותו באמצעות claude plugin marketplace add anthropics/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 והרשאות ניהול ספרייה).
• 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 מעדכן את ההצמדה אוטומטית עם דחיפת commits חדשים למאגר שלך. הקטלוג הציבורי מסתנכרן מדי לילה מתהליך הבדיקה, ולכן ייתכן עיכוב בין האישור להופעת התוסף בקובץ marketplace.json.

המרקטפלייס הרשמי (claude-plugins-official) מנוהל בנפרד: אנתרופיק מחליטה אילו תוספים לכלול לפי שיקול דעתה, ואין עבורו תהליך הגשה פתוח.

#הסבת הגדרות קיימות לתוספים

אם כבר יש לך מיומנויות או הוקים בספריית .claude/, ניתן להסב אותם לתוסף לשיתוף ולהפצה קלים יותר בין פרויקטים וצוותים.

#שלבי ההגירה

1. יצירת מבנה התוסף: יוצרים ספריית תוסף חדשה בשורש הפרויקט לצד ספריית .claude/ הקיימת:

mkdir -p my-plugin/.claude-plugin

יוצרים את קובץ המניפסט בכתובת my-plugin/.claude-plugin/plugin.json:

{
  "name": "my-plugin",
  "description": "Migrated from standalone configuration",
  "version": "1.0.0"
}

2. העתקת הקבצים הקיימים: מעתיקים כל ספריית הגדרות קיימת לשורש התוסף:

cp -r .claude/commands my-plugin/
cp -r .claude/agents my-plugin/
cp -r .claude/skills my-plugin/

אם ספרייה מסוימת אינה קיימת, הפקודה cp תדווח שלא נמצא קובץ או ספרייה, וניתן להתעלם מכך. מריצים ls my-plugin כדי לוודא שכל הספריות הועתקו.

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

mkdir my-plugin/hooks

יוצרים את הקובץ my-plugin/hooks/hooks.json ומעתיקים אליו את אובייקט hooks מקובץ .claude/settings.json או settings.local.json, שכן הפורמט זהה. הפקודה מקבלת קלט JSON ב-stdin, ולכן משתמשים ב-jq לחילוץ נתיב הקובץ:

{
  "hooks": {
    "PostToolUse": [
      {
        "matcher": "Write|Edit",
        "hooks": [{ "type": "command", "command": "jq -r '.tool_input.file_path' | xargs npm run lint:fix" }]
      }
    ]
  }
}

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

claude --plugin-dir ./my-plugin

בודקים כל רכיב: הרצת פקודות, בדיקה שסוכנים מופיעים ב-/context, והפעלת האירוע שכל הוק מאזין לו כדי לוודא את פעולתו. קלוד קוד מתעד בלוג הניפוי אילו הוקים הופעלו וכיצד הסתיימו.

#מה משתנה בעת ההגירה

לאחר ההגירה מומלץ להסיר את הקבצים המקוריים מ-.claude/ כדי למנוע כפילויות. הגדרות סוכנים ב-.claude/agents/ ברמת הפרויקט או המשתמש דורסות סוכני תוסף בעלי אותו שם, ולכן גרסת התוסף תיכנס לתוקף רק לאחר הסרת המקור. מיומנויות תוסף מקבלות מרחב שמות (/plugin-name:skill-name), כך שהמיומנות המקורית וגרסת התוסף יישארו שתיהן זמינות אם לא יוסרו.

#אבטחה

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

#פתרון בעיות

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

אם מופיעה הודעת שגיאה שהפקודה אינה מוכרת או שהפקודה /plugin אינה מופיעה:

1. בדיקת הגרסה: הרצת claude --version לבדיקת הגרסה המותקנת.
2. עדכון קלוד קוד:

• ב-Homebrew: הרצת brew upgrade claude-code (או brew upgrade claude-code@latest אם הותקן cask זה).
• ב-npm: הרצת npm install -g @anthropic-ai/claude-code@latest.
• בהתקנה מקורית (Native installer): הרצה מחדש של פקודת ההתקנה.

3. הפעלה מחדש של קלוד קוד: פתיחה מחדש של הטרמינל והרצת claude.

בסשן לא אינטראקטיבי וב-claude -p התשובה /plugin isn't available in this environment. צפויה: מנהלים תוספים מהמעטפת.

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

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

אם סיכום ההתקנה מדווח The plugin couldn't be loaded, פירוט הסיבה נמצא בלשונית Errors ב-/plugin.

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

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