חנות פלאגינים משלכם: מעלים ל-GitHub, מתקינים ומתעדכנים כצוות

📘 מדריך מעשי🎬 פרק 44⏱️ 7 דקות קריאה🗓️ עודכן 15.11.2026
מדריכים מעשיים · הדרכות קלוד מ-0 ל-100
חנות פלאגינים משלכם: מעלים ל-GitHub, מתקינים ומתעדכנים כצוות

🎬 פרק 44 בסדרה הדרכות קלוד מ-0 ל-100

בפרק הקודם Claude Code הכין את הפלאגין של אתר חנות הפרחים כקובץ zip. זה עובד, אבל על כל שיפור צריך לשלוח לכולם קובץ חדש. חנות פלאגינים (marketplace) פותרת את זה: מעלים אותה פעם אחת, כל אחד מתקין ממנה, ומי שהתקין מקבל את הגרסה החדשה בפקודת עדכון. המדריך הזה מסביר איך בונים חנות, איך מתקינים ממנה ואיך מתעדכנים, לפי התיעוד הרשמי, ומה קרה כש-Claude העלה את החנות של האתר למאגר פרטי ב-GitHub.

במדריך הזה:

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

1מה זו חנות פלאגינים?

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

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

json
{
  "name": "flower-marketplace",
  "owner": { "name": "אתר חנות הפרחים" },
  "plugins": [
    {
      "name": "flower-tools",
      "source": "./plugins/flower-tools",
      "description": "בדיקת טופס ההזמנה, בדיקת דפי האתר ושמירה על SPEC.md"
    }
  ]
}
  • name: השם של החנות. משתמשים בו בהתקנה (flower-tools@flower-marketplace).
  • owner: מי אחראי על החנות.
  • plugins: רשימת הפלאגינים. לכל אחד שם ומקור (source). כאן המקור הוא תיקייה בתוך אותו מאגר.
טיפ: לפני שמשתפים, מריצים בדיקה על התיקייה של החנות. היא בודקת את המבנה, את השדות החובה ואת כל פלאגין ברשימה:
claude plugin validate ./flower-marketplace
שימו לב: נתיב עם .. נכשל בבדיקה. נתיב לתיקייה שלא קיימת עובר את הבדיקה, ונכשל רק בהתקנה. לכן גם מתקינים פעם אחת אצלכם לפני ששולחים.

2איך מוסיפים חנות ומתקינים ממנה?

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

בתוך שיחה:

/plugin marketplace add owner/repo
/plugin install flower-tools@flower-marketplace

בטרמינל:

claude plugin marketplace add owner/repo
claude plugin install flower-tools@flower-marketplace

owner/repo הוא השם של המאגר ב-GitHub. אפשר להוסיף חנות גם מכתובת Git מלאה או מתיקייה במחשב.

מאגר פרטי

ל-Claude Code אין הרשאה משלו ל-GitHub. הוא מריץ את git במחשב ומשתמש בהרשאה שכבר שמורה בו. אם git clone של המאגר עובד אצלכם בלי לבקש סיסמה, גם ההוספה של החנות תעבוד.

  • כל חבר צוות צריך הרשאת קריאה למאגר ב-GitHub (מזמינים אותו למאגר).
  • אם אין הרשאה שמורה, אפשר להתחבר עם gh auth login ואז gh auth setup-git.
  • לפי התיעוד, משתנה סביבה כמו GITHUB_TOKEN לבד לא מספיק. הוא עובד רק דרך כלי ששומר הרשאות, כמו ה-CLI של GitHub.

3איך מתעדכנים?

מצד מי שמפרסם: משפרים את הפלאגין, מעלים את מספר הגרסה (version) ב-plugin.json, ושומרים בחנות (commit ו-push).

לפי התיעוד, יש שתי דרכים, ואסור לערבב ביניהן:

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

מצד מי שהתקין: מריצים עדכון, או מדליקים עדכון אוטומטי.

/plugin marketplace update flower-marketplace
claude plugin update flower-tools@flower-marketplace
שימו לב: בחנות משלכם, העדכון האוטומטי כבוי כברירת מחדל. כל משתמש מדליק אותו לבד: /plugin ← Marketplaces ← בוחרים את החנות ← Enable auto-update.

4הטריק לצוות: החנות בהגדרות של הפרויקט

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

claude plugin marketplace add owner/repo --scope project

הפקודה כותבת את החנות לקובץ .claude/settings.json של הפרויקט. בהדגמה נכתב בו רק המקור, בלי נתיב מקומי:

json
{
  "extraKnownMarketplaces": {
    "flower-marketplace": {
      "source": { "source": "github", "repo": "owner/flower-marketplace" }
    }
  }
}

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

5מה קרה בהדגמה

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

  1. העתקה: Claude העתיק את החנות לתיקייה נפרדת על שולחן העבודה, בלי תוצאות הבדיקות הישנות. הוא גם הוסיף .gitignore.
  2. README: Claude כתב בחנות README שמסביר איך מוסיפים אותה מ-GitHub, איך מתקינים ממנה ואיך מתעדכנים.
  3. בדיקה: claude plugin validate --strict עבר לחנות ולפלאגין.
  4. העלאה: הוא עשה git init ו-commit, ואז push לענף main במאגר הפרטי. לא נפתח חלון התחברות, כי ההרשאה כבר הייתה שמורה במחשב.
  5. חבר צוות מדומה: Claude פתח תיקייה ריקה, עם הגדרות Claude Code נפרדות ונקיות (CLAUDE_CONFIG_DIR), כדי לא לגעת בהגדרות שלי. הניסיון הראשון נכשל בשגיאה Filename too long, כי התיקייה הזמנית הייתה בנתיב ארוך מדי בשביל Windows. הוא עבר לנתיב קצר, ואז ההוספה עבדה.
  6. התקנה: marketplace add עם --scope project, ואחריו install. הפלאגין flower-tools הותקן בגרסה 1.0.1.
  7. עדכון: Claude הוסיף לפלאגין קובץ CHANGELOG.md והעלה את הגרסה ל-1.0.2, רק ב-plugin.json. הוא הריץ שוב את הבדיקה ועשה commit ו-push.
  8. אצל חבר הצוות: הוא הריץ שתי פקודות עדכון, marketplace update ואחריה plugin update, והתשובה הייתה updated from 1.0.1 to 1.0.2.

הכול לקח שמונה דקות. קבצי האתר לא השתנו, וההגדרות שלי ב-Claude Code נשארו כמו שהיו.

6חשוב לדעת

  • Windows ונתיבים ארוכים: חנות עוברת git clone לתיקייה עמוקה בתוך ההגדרות של Claude Code. אם התיקייה הזו כבר בנתיב ארוך, אפשר לקבל Filename too long. הפתרון בהדגמה היה נתיב קצר יותר. אפשרות נוספת היא להפעיל ב-git תמיכה בנתיבים ארוכים (core.longpaths).
  • שם החנות: יש שמות ששמורים ל-Anthropic, כמו claude-plugins-official ו-anthropic-marketplace. תבחרו שם משלכם.
  • שם הפלאגין ברשימה: השם ברשימה של החנות צריך להתאים לשם ב-plugin.json של הפלאגין.
  • חנות מקומית לא מתעדכנת לפי גרסה: פלאגין שמגיע מחנות שהוספתם מתיקייה במחשב נטען מהקבצים כמו שהם בכל שיחה. מספר הגרסה חשוב בחנות ב-Git.

בקשות להעתקה

תהפוך את התיקייה הזאת לחנות פלאגינים של Claude Code: תבדוק שיש בה .claude-plugin/marketplace.json תקין, תריץ claude plugin validate --strict, ותעלה אותה למאגר הפרטי והריק שפתחתי ב-GitHub: [כתובת המאגר]. תוסיף README שמסביר לחבר צוות איך מוסיפים את החנות, מתקינים ממנה ומתעדכנים. אל תעשה push לשום מאגר אחר.

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

שיפרתי את הפלאגין. תעלה את מספר הגרסה ב-plugin.json בלבד, תריץ שוב את הבדיקה, תעשה commit ו-push לחנות, ותגיד לי באילו פקודות חברי הצוות מקבלים את העדכון.

בקצרה

  • חנות פלאגינים היא תיקייה או מאגר ב-Git עם .claude-plugin/marketplace.json, ואפשר שתהיה פרטית.
  • מוסיפים עם /plugin marketplace add owner/repo, ומתקינים עם /plugin install name@marketplace.
  • במאגר פרטי Claude Code משתמש בהרשאת git שכבר שמורה במחשב.
  • בכל שיפור מעלים את version. העדכון האוטומטי בחנות משלכם כבוי כברירת מחדל.
  • עם --scope project החנות נשמרת בהגדרות של הפרויקט, וכל חבר צוות שמאשר את התיקייה מקבל אותה.
הדמות של Claude Code לעצלנים נחה על פוף עם לפטופ וקפה

עצרו שנייה ✋

כבד עליכם? מורכב לכם? יש דרך עצלה יותר.

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

  • אתרים
  • מערכות CRM
  • סרטונים
  • מותגים
  • אפליקציות

קודם יוצרים. אחר כך לומדים.