
🎬 פרק 44 בסדרה הדרכות קלוד מ-0 ל-100
בפרק הקודם Claude Code הכין את הפלאגין של אתר חנות הפרחים כקובץ zip. זה עובד, אבל על כל שיפור צריך לשלוח לכולם קובץ חדש. חנות פלאגינים (marketplace) פותרת את זה: מעלים אותה פעם אחת, כל אחד מתקין ממנה, ומי שהתקין מקבל את הגרסה החדשה בפקודת עדכון. המדריך הזה מסביר איך בונים חנות, איך מתקינים ממנה ואיך מתעדכנים, לפי התיעוד הרשמי, ומה קרה כש-Claude העלה את החנות של האתר למאגר פרטי ב-GitHub.
במדריך הזה:
- מה זו חנות פלאגינים, ומה יש בקובץ שלה.
- איך מוסיפים חנות ומתקינים ממנה, גם ממאגר פרטי.
- איך מפרסמים גרסה חדשה ואיך כולם מתעדכנים.
- הטריק לצוות: החנות בהגדרות של הפרויקט.
- מה קרה בהדגמה באפליקציה.
1מה זו חנות פלאגינים?
חנות היא תיקייה, או מאגר ב-Git (למשל ב-GitHub), עם קובץ אחד: .claude-plugin/marketplace.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/repoclaude plugin install flower-tools@flower-marketplaceowner/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-marketplaceclaude plugin update flower-tools@flower-marketplace/plugin ← Marketplaces ← בוחרים את החנות ← Enable auto-update.4הטריק לצוות: החנות בהגדרות של הפרויקט
אם כל הצוות עובד באותו מאגר של פרויקט, מריצים פעם אחת מתוך התיקייה של הפרויקט:
claude plugin marketplace add owner/repo --scope projectהפקודה כותבת את החנות לקובץ .claude/settings.json של הפרויקט. בהדגמה נכתב בו רק המקור, בלי נתיב מקומי:
{
"extraKnownMarketplaces": {
"flower-marketplace": {
"source": { "source": "github", "repo": "owner/flower-marketplace" }
}
}
}עושים commit לקובץ. לפי התיעוד, כל חבר צוות שפותח את התיקייה ומאשר אותה מקבל את החנות, בלי להקליד כלום.
5מה קרה בהדגמה
פתחתי ב-GitHub מאגר פרטי וריק, ופתחתי שיחה חדשה באפליקציה של Claude. ביקשתי להעלות אליו את החנות של אתר חנות הפרחים, לדמות חבר צוות חדש ולפרסם עדכון. ביקשתי גם לא לגעת בקבצי האתר ובהגדרות שלי.
- העתקה: Claude העתיק את החנות לתיקייה נפרדת על שולחן העבודה, בלי תוצאות הבדיקות הישנות. הוא גם הוסיף
.gitignore. - README: Claude כתב בחנות README שמסביר איך מוסיפים אותה מ-GitHub, איך מתקינים ממנה ואיך מתעדכנים.
- בדיקה:
claude plugin validate --strictעבר לחנות ולפלאגין. - העלאה: הוא עשה
git initו-commit, ואז push לענףmainבמאגר הפרטי. לא נפתח חלון התחברות, כי ההרשאה כבר הייתה שמורה במחשב. - חבר צוות מדומה: Claude פתח תיקייה ריקה, עם הגדרות Claude Code נפרדות ונקיות (
CLAUDE_CONFIG_DIR), כדי לא לגעת בהגדרות שלי. הניסיון הראשון נכשל בשגיאהFilename too long, כי התיקייה הזמנית הייתה בנתיב ארוך מדי בשביל Windows. הוא עבר לנתיב קצר, ואז ההוספה עבדה. - התקנה:
marketplace addעם--scope project, ואחריוinstall. הפלאגיןflower-toolsהותקן בגרסה 1.0.1. - עדכון: Claude הוסיף לפלאגין קובץ
CHANGELOG.mdוהעלה את הגרסה ל-1.0.2, רק ב-plugin.json. הוא הריץ שוב את הבדיקה ועשה commit ו-push. - אצל חבר הצוות: הוא הריץ שתי פקודות עדכון,
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החנות נשמרת בהגדרות של הפרויקט, וכל חבר צוות שמאשר את התיקייה מקבל אותה.
