📘 תיעוד 71

פרסום והפצה של תוסף

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

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

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

[!NOTE]

המקרים האלה מכוסים בדפים אחרים:

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

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

#בחירת דרך ההפצה

בחרו אפשרות הפצה לפי מי צריך להתקין את התוסף:

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

#הכנת התוסף לשחרור

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

1. בחירת שם קבוע

משתמשים מתקינים, מפעילים ומגדירים את התוסף לפי name@marketplace, ולכן תוסף ששמו השתנה הוא תוסף אחר לכל התקנה קיימת. בחרו שם ב-kebab-case כמו deploy-helper, כי claude plugin validate מזהיר על צורות אחרות, והתייחסו אליו כקבוע. הגדירו displayName ב-plugin.json לתווית שהמשתמשים רואים.

2. החלטה איך לנהל גרסאות

אם מגדירים version ב-plugin.json ואחר כך דוחפים קומיטים בלי לשנות אותו, claude plugin update מדפיס <name> is already at the latest version (1.0.0). והמשתמשים נשארים עם העותק הישן. או שמעלים את version בכל שחרור, או שמשמיטים אותו במרקטפלייס שמתארח ב-git כדי ש-Claude Code ישתמש ב-SHA של הקומיט במקום. ראו גרסאות ועדכונים.

3. אימות

במעטפת, הריצו claude plugin validate --strict ./your-plugin. הרצה נקייה מדפיסה ✔ Validation passed.

• ב-CI: השאירו את --strict, שגם מכשיל את ההרצה עם קוד יציאה 1 על אזהרות כמו שדה מניפסט לא מוכר או version חסר. הסירו את --strict אם בחרתם להשמיט את version בשלב הקודם.
• נתיבים: האימות מדווח על נתיבי רכיבים שלא מתחילים ב-./. בתוך פקודות hook ובהגדרות שרת MCP, הפנו לקבצים כ-${CLAUDE_PLUGIN_ROOT}/.... ראו כללי נתיבים.

4. התקנה ממרקטפלייס מקומי

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

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

5. מילוי המטא-דאטה שהמשתמשים רואים

הגדירו description, author, homepage ו-repository ב-plugin.json, והוסיפו README.md בשורש התוסף. homepage חייב להתפרש כ-URL. הפניית המניפסט מפרטת כל שדה.

6. הרצת חבילת ה-eval

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

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

אם התוסף נמצא במאגר git, אנשים יכולים לשכפל אותו ולטעון את העותק שנשכפל, או להפעיל את Claude Code מהמעטפת עם --plugin-url שמצביע על קובץ .zip שמצרפים לשחרור. כדי לקבל את הגרסה הבאה הם מושכים או מורידים שוב. אם הוא לא במאגר, שלחו להם את הספרייה או קובץ .zip שלה. הם טוענים אותו באחת משתי דרכים:

• לסשן אחד: הם מפעילים את Claude Code מהמעטפת עם claude --plugin-dir ./deploy-helper, כשהנתיב הוא השכפול, התיקייה אחרי חילוץ, או קובץ ה-.zip עצמו. ראו דגלים שטוענים תוסף לסשן אחד.
• לכל סשן: הם מעבירים את ספריית התוסף, עם .claude-plugin/plugin.json שלה, אל מתחת ל-~/.claude/skills/. מכאן והלאה Claude Code טוען אותו בהפעלה, אלא אם המנהל שלהם חסם תוספי תיקיית skills.

הוספת .claude-plugin/marketplace.json לאותו מאגר היא מה שמאפשר לאנשים להתקין לפי שם ולעדכן בפקודה. ראו פרסום דרך מרקטפלייס משלכם.

#שילוח תוסף עם הכלי שלכם

אם מתחזקים CLI או SDK, פרסמו את התוסף במרקטפלייס, ותנו למתקין או להודעה שאחרי ההתקנה להריץ או להדפיס את שתי הפקודות שמשתמש צריך: claude plugin marketplace add <source>, ואז claude plugin install <name>@<marketplace>. לגילוי מתוך סשן כשמישהו משתמש בכלי, ראו המלצה על התוסף מתוך ה-CLI.

#פרסום דרך מרקטפלייס משלכם

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

#הוספת קובץ המרקטפלייס למאגר

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

.claude-plugin/marketplace.json

{
  "name": "your-marketplace",
  "owner": { "name": "Your Name" },
  "plugins": [
    { "name": "deploy-helper", "source": "./" }
  ]
}

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

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

#שליטה במי יכול להתקין

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

#הסבר למשתמשים איך להתקין

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

• הוסיפו את המרקטפלייס פעם אחת: claude plugin marketplace add your-org/your-marketplace, כשהארגומנט הוא קיצור GitHub מסוג owner/repo, כתובת URL, או נתיב
• התקינו את התוסף: claude plugin install deploy-helper@your-marketplace
• או עשו את שניהם מתוך סשן: /plugin install deploy-helper --marketplace your-org/your-marketplace. נדרש Claude Code v2.1.275 או חדש יותר. ראו הוספת מרקטפלייס והתקנה בפקודה אחת
• או עשו את שניהם מהמעטפת בפקודה אחת: claude plugin install deploy-helper --marketplace your-org/your-marketplace. נדרש Claude Code v2.1.292 או חדש יותר

#שילוח עדכונים למשתמשים

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

• לפי בקשה: claude plugin update deploy-helper@your-marketplace במעטפת של המשתמש מרענן את המרקטפלייס ומתקין את העותק החדש כשהגרסה של התוסף השתנתה
• עדכון אוטומטי: כבוי כברירת מחדל למרקטפלייס שלכם. ראו הפעלת עדכון אוטומטי. אחרי שהוא פועל, הוא עושה אותו דבר כמו claude plugin update בהשהיה אחרי שהסשן מתחיל

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

#הגשה לספרייה של Anthropic

הספרייה של Anthropic היא הקטלוג שאנשים מדפדפים בו ב-claude.ai וב-Cowork כדי להוסיף תוספים ומחברים. רישום אחד שם מגיע לאנשים ב-claude.ai, ב-Cowork וב-Claude Code. מגישים מפורטל המפתחים ב-claude.ai/directory/manage, והגשת תוסף ב-claude.com מלווה את הפורטל.

המרקטפלייס הרשמי של Anthropic, claude-plugins-official, לא מקבל הגשות דרך פורטל הספרייה. אם עובדים עם איש קשר שותף ב-Anthropic, שאלו אותו על רישום במרקטפלייס הרשמי.

כדי להגיש תוסף:

1. אישור שאפשר להגיש

הגשה דורשת תוכנית claude.ai בתשלום. ב-Pro, ב-Max וב-Ultra מגישים מהחשבון שלכם. ב-Team וב-Enterprise, Owner יכול להגיש, וב-Enterprise Owner יכול גם להעניק את הרשאת Directory לחברים אחרים דרך תפקיד מותאם תחת Organization settings > Roles. ראו אישור שאפשר להגיש לספרייה.

2. אימות התוסף מקומית

הריצו claude plugin validate ./your-plugin --strict במעטפת. החליפו את ./your-plugin בנתיב לספריית התוסף. הפקודה תופסת שגיאות מניפסט מקומית. plugin validate מפרט אילו קבצים כל הרצה קוראת. הפורטל מחיל כללי ספרייה נוספים שה-CLI לא בודק, אז הרצה מקומית נקייה לא מבטיחה אימות נקי בפורטל.

רשימת הבדיקות לפני הגשת תוסף ב-claude.com כוללת את הבדיקות להרצה ולתיקון לפני ההגשה.

3. בדיקה מה נטען איפה

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

4. הגשה בפורטל המפתחים

פתחו את פורטל המפתחים ב-claude.ai/directory/manage ועקבו אחרי הגשת תוסף ב-claude.com.

שאר התהליך מתועד ב-claude.com:

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

#איך תוסף רשום מגיע למשתמשי Claude Code

אדם שמתקין את התוסף מהספרייה ב-claude.ai מחזיק אותו בחשבון, ו-Claude Code טוען אותו כ-<name>@synced. תוספים שמסונכרנים מ-claude.ai מכסה מה הם רואים ואיך מכבים את זה.

#שילוח עדכונים, שינויי שם והסרות

#שחרור גרסה חדשה

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

#תיוג שחרור

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

כדי לתייג, הריצו claude plugin tag במעטפת מתוך ספריית התוסף. זה יוצר תגית {name}--v{version}. הוסיפו --push כדי לשלוח את התגית ל-origin. הפניית plugin tag מפרטת את הדגלים שלה.

#שינוי שם או הסרת תוסף

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

אם שינוי שם בלתי נמנע, השתמשו במפת renames של קובץ המרקטפלייס כדי שהתקנות קיימות יעברו במקום להיכשל עם Plugin "<name>" not found in marketplace. כדי להסיר תוסף מהמרקטפלייס, או לפרטים המלאים של renames, ראו שינוי שם או הסרת תוסף בדף האירוח. הפניית המרקטפלייס כוללת את השדה.

#הצהרה על תלויות

אם התוסף צריך שתוסף אחר מאותו מרקטפלייס יהיה מופעל, רשמו אותו במערך dependencies של plugin.json. כל רשומה היא שם חשוף או אובייקט עם טווח version ב-semver. כשמשתמש מתקין את התוסף, Claude Code מתקין ומפעיל גם את התלות.

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

#הצעדים הבאים

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