
🎬 פרק 42 בסדרה הדרכות קלוד מ-0 ל-100
בניתם עם Claude Code סקיל, סוכן או הוקים בתיקייה של פרויקט אחד, ועכשיו אתם רוצים אותם גם בפרויקט אחר, או אצל חבר לצוות? פלאגין משלכם אורז את כל הכלים האלה לתיקייה אחת, שאפשר להעביר ולהתקין בכל מקום. המדריך הזה מסביר מתי כדאי לבנות פלאגין ומה יש בתוכו. הוא מסביר גם איך בודקים, מתקינים ומעבירים אותו, ומראה מה קרה כש-Claude ארז את הכלים של אתר חנות הפרחים.
במדריך הזה:
- מה זה פלאגין, ומתי בונים אחד.
- מה יש בתוך פלאגין, ומה משתנה בשמות.
- איך הופכים כלים קיימים לפלאגין, והמלכודת של "פעמיים".
- איך בודקים, מתקינים ומעבירים פלאגין.
- מה קרה בהדגמה באפליקציה.
1מה זה פלאגין
לפי התיעוד, פלאגין הוא תיקייה אחת שאורזת יחד כמה סוגי כלים. במקור: "A plugin is a directory of skills, agents, hooks, and MCP servers".
| מה אפשר לארוז | איפה זה יושב בפלאגין | ראינו בפרק |
|---|---|---|
| סקילים | skills/<שם>/SKILL.md | 28 |
| סוכנים | agents/<שם>.md | 31 |
| הוקים | hooks/hooks.json | 30 |
| חיבורים (MCP) | .mcp.json | 29 |
אפשר לארוז גם דברים נוספים, כמו פלאגין שפה (פרק 41) או ערכת צבעים, אבל ארבעת אלה הם הבסיס.
2מתי בונים פלאגין, ומתי לא
לא כל הגדרה צריכה להפוך לפלאגין. לפי התיעוד:
- כל עוד ההגדרות בתיקייה
.claudeמשרתות פרויקט אחד, או רק אתכם, משאירים אותן כמו שהן. במקור: "Keep that standalone setup while it serves one project or only you." - בונים פלאגין כשרוצים לשתף עם הצוות, להתקין בכמה פרויקטים, או לפרסם גרסאות. במקור: "Make a plugin when you want to share the setup with teammates, install it in several projects, or publish versioned releases."
הגדרות רגילות (.claude) | פלאגין | |
|---|---|---|
| איפה עובד | בפרויקט אחד | בכל פרויקט שמתקינים בו |
| שם של סקיל | /check-order | /flower-tools:check-order |
| איך משתפים | מעתיקים קבצים ביד | מעבירים תיקייה אחת ומתקינים |
3מה יש בתוך פלאגין
ככה נראה הפלאגין שנבנה בהדגמה:
flower-tools/
├── .claude-plugin/
│ └── plugin.json
├── skills/
│ └── check-order/
│ └── SKILL.md
├── agents/
│ └── site-checker.md
└── hooks/
├── hooks.json
├── protect-spec.js
├── notify-done.js
└── notify-done.ps1plugin.jsonהוא קובץ קטן עם השם, הגרסה והתיאור של הפלאגין. לפי התיעוד, רק השם הוא חובה.- ולידו תיקייה לכל סוג: סקילים, סוכנים והוקים.
.claude-plugin שמים רק את plugin.json. לפי התיעוד, כלים שנשמרים שם לא נטענים. את skills, agents ו-hooks שמים ליד התיקייה הזו, לא בתוכה.ודבר אחד משתנה בשמות: לכל סקיל ולכל סוכן מצטרף שם הפלאגין, לפני השם שלו. הסקיל check-order נקרא עכשיו /flower-tools:check-order, והסוכן site-checker נקרא flower-tools:site-checker.
${CLAUDE_PLUGIN_ROOT}, הנתיב של תיקיית הפלאגין. ככה הם עובדים בכל מחשב ובכל פרויקט.4הופכים כלים קיימים לפלאגין
אם הכלים כבר קיימים אצלכם בתיקייה .claude של פרויקט, התיעוד מתאר ארבעה שלבים:
- יוצרים תיקייה לפלאגין, ובתוכה
.claude-plugin/plugin.jsonעם השם שלו. - מעתיקים לתוכה את התיקיות
skillsו-agents. - מעתיקים את ההוקים מקובץ ההגדרות (
.claude/settings.json) לקובץhooks/hooks.jsonבפלאגין. - בודקים שהפלאגין עובד, ורק אז מוחקים את המקור.
.claude, הוא ממשיך לעבוד ליד העותק שבפלאגין. סקיל יופיע פעמיים, בשני שמות. הוק שנמצא בשני המקומות ירוץ פעמיים בכל פעם. אצלנו, למשל, חלון "קלוד סיים" היה קופץ פעמיים. לכן, אחרי שבודקים שהפלאגין עובד, מוחקים את המקור.5בודקים ומתקינים
- בדיקת תקינות. הפקודה הרשמית בודקת את המבנה ואת הקבצים:
claude plugin validate ./flower-marketplace/plugins/flower-tools --strictכשהכול תקין, מופיע ✔ Validation passed.
- התקנה מחנות מקומית. כדי להתקין פלאגין מהמחשב שלכם, יוצרים "חנות" קטנה (בתיעוד: marketplace): תיקייה עם קובץ
.claude-plugin/marketplace.jsonשמפרט את הפלאגינים שבה. אחר כך מוסיפים אותה ומתקינים ממנה:
claude plugin marketplace add ./flower-marketplace --scope projectclaude plugin install flower-tools@flower-marketplace --scope project--scope project מתקין את הפלאגין רק לפרויקט הנוכחי. בלי זה הוא מותקן לכל הפרויקטים שלכם.
- בדיקה שהוא פעיל. הפקודה
claude plugin listמציגה את הפלאגין עםStatus: ✔ enabled. שיחה חדשה טוענת אותו, ובשיחה פתוחה כותבים/reload-plugins.
6מעבירים את הפלאגין הלאה
לפי התיעוד, יש שלוש דרכים:
| הדרך | למי זה מתאים |
|---|---|
| שולחים את התיקייה, או קובץ zip שלה | חבר לצוות, מחשב נוסף שלכם |
| מוסיפים אותה לחנות משלכם (marketplace) | צוות שרוצה מקום אחד לכל הכלים, עם עדכונים |
| מגישים אותה לחנות של Anthropic | כלי שכולם יכולים להשתמש בו |
claude plugin marketplace add שומרת בהגדרות את הנתיב המלא של החנות במחשב שלכם. מי שמקבל את התיקייה צריך להריץ אותה מחדש במחשב שלו. Claude בדק את זה בהדגמה: הוא הדמה מחשב אחר, והרצה מחדש החליפה את הנתיב הישן בנתיב החדש.7מה קרה בהדגמה
פתחתי שיחה חדשה באפליקציה של Claude, ונתתי את הבקשה הראשונה שבסוף המדריך. הכלים שנארזו הם אלה שבנינו בפרקים הקודמים בתיקייה של אתר חנות הפרחים: הסקיל שבודק את טופס ההזמנה (פרק 28), השמירה על מסמך האפיון וחלון "קלוד סיים" (פרק 30), והסוכן שבודק את האתר (פרק 31).
- קרא את התיעוד הרשמי על יצירת פלאגינים.
- אסף הכול לפלאגין אחד בשם
flower-tools, בתוך חנות מקומית בשםflower-marketplaceשבתיקיית האתר. - בדיקת התקינות הרשמית עברה, גם לפלאגין וגם לחנות:
✔ Validation passed. - בדק על עותק שההוקים עובדים: בתיקייה זמנית, עריכה של
SPEC.mdנחסמה עם ההודעה בעברית, וההוק של סוף התשובה רץ. - התקין את הפלאגין רק לאתר:
✔ Successfully installed plugin: flower-tools@flower-marketplace (scope: project). - מחק את המקור: את הסקיל, הסוכן וקובצי ההוקים מתוך
.claude, ואת בלוק ההוקים מקובץ ההגדרות. כל אלה שמורים ב-Git, אז אפשר לשחזר. - וידא שכל כלי נטען פעם אחת, בלי כפילויות.
- כתב קובץ README בעברית עם הוראות התקנה למי שמקבל את החבילה.
הכול לקח שמונה דקות וחצי. קבצי האתר עצמם לא השתנו. Claude עדכן עוד קובץ אחד: תהליך העבודה מפרק 35, שקורא לסוכן, עבר לשם החדש flower-tools:site-checker. בלי זה הוא היה נשבר אחרי המחיקה.
8חשוב לדעת
- כל פלאגין פעיל עולה קצת בכל שיחה: השמות והתיאורים של הסקילים והסוכנים שלו נכנסים להקשר של Claude בכל תור. אצלנו, לפי
claude plugin details, זה בערך 295 טוקנים קבועים בכל שיחה. - הוקים רצים בלי לשאול: הוקים של פלאגין רצים בכל שיחה שבה הוא פעיל. לפני שמתקינים פלאגין של מישהו אחר, כדאי לקרוא מה ההוקים שלו עושים (על זה דיברנו בפרק 40).
- שמות: שם של פלאגין כתוב באותיות קטנות באנגלית, עם מקפים במקום רווחים, למשל
flower-tools. - עריכות: פלאגין שמותקן מחנות מקומית נטען מהתיקייה עצמה. אחרי שינוי בקבצים שלו, פותחים שיחה חדשה או כותבים
/reload-plugins.
בקשות להעתקה
תארוז לי לפלאגין אחד, בשם my-tools, את הסקילים, הסוכנים וההוקים שבנינו בתיקייה הזאת. תעבוד לפי התיעוד הרשמי של Claude Code על יצירת פלאגינים. תבדוק שהפלאגין תקין, ותתקין אותו לפרויקט הזה בלבד, מתוך מרקטפלייס מקומי שיושב כאן בתיקייה. אחרי שהוא מותקן, תוריד את המקור הישן, כדי ששום דבר לא ירוץ פעמיים. בסוף תסכם לי בקצרה מה נוצר ואיך מעבירים את זה למישהו אחר.
תעבור על התיקייה .claude בפרויקט הזה ותגיד לי אילו סקילים, סוכנים והוקים יש בה, ואילו מהם שווה לארוז לפלאגין שאפשר להשתמש בו גם בפרויקטים אחרים. אל תשנה אף קובץ.
קיבלתי תיקיית פלאגין ממישהו אחר. תבדוק אותה עם claude plugin validate, ותסביר לי במילים פשוטות מה כל סקיל, סוכן והוק בה עושה. אל תתקין כלום עד שאאשר.
בקצרה
- פלאגין אורז סקילים, סוכנים, הוקים וחיבורים לתיקייה אחת שאפשר להעביר.
- בונים אותו כשרוצים לשתף עם הצוות או להשתמש בכמה פרויקטים. לפרויקט אחד, או רק בשבילכם, ההגדרות הרגילות מספיקות.
- בתוך
.claude-pluginיש רק אתplugin.json, ולכל סקיל מצטרף שם הפלאגין. - בודקים עם
claude plugin validate, ומתקינים מחנות מקומית. - אחרי שהפלאגין עובד, מוחקים את המקור, כדי ששום דבר לא ירוץ פעמיים.
