ככל שאתם מעמיקים בעבודה עם Claude Code, אתם בונים לעצמכם כלים: פקודות מותאמות, סוכנים, הוקס, חיבורי MCP. בשלב מסוים עולה שאלה טבעית — איך משתפים את כל זה? איך לוקחים סביבת עבודה שבניתם בעמל ומעבירים אותה לחבר לצוות, לפרויקט אחר, או לקהילה כולה? בדיוק לשם כך קיימים Plugins. במדריך הזה נבין מה זה plugin, מה הוא יכול להכיל, איך מתקינים ומנהלים plugins, ואיך בונים ומפרסמים plugin משלכם.
✅ מה תלמדו במדריך הזה
- מה זה Plugin ב-Claude Code ואיזו בעיה הוא פותר
- מה plugin יכול לארוז — Skills, Agents, Hooks, שרתי MCP ועוד
- מבנה התיקייה והקובץ
plugin.json— שדות חובה ורשות - מה זה Marketplace ואיך מוסיפים אחד
- איך מתקינים ומנהלים plugins דרך פקודת
/plugin - איך לבנות ולפרסם plugin משלכם, צעד אחר צעד
- איך מפעילים plugins לכל הצוות דרך
settings.json - שיקולי אבטחה ומגבלות שחשוב להכיר לפני שמתקינים
מה זה Plugin ב-Claude Code?
Plugin הוא תיקייה עצמאית שמרחיבה את Claude Code ביכולות מותאמות. במקום להגדיר כל כלי בנפרד בכל פרויקט מחדש, plugin אורז יחד אוסף של הרחבות — פקודות, סוכנים, הוקס, חיבורים — לחבילה אחת שאפשר להתקין, לעדכן ולשתף בקלות.
אפשר לחשוב על זה כך: עד עכשיו התאמתם את Claude Code לעצמכם דרך תיקיית .claude בפרויקט. זה עובד מצוין לשימוש אישי. אבל ברגע שאתם רוצים לחלק את ההתאמות האלה לאחרים — בלי שכל אחד יעתיק קבצים ידנית — אתם צריכים אריזה. ה-plugin הוא האריזה הזו.
Plugin מול הגדרה עצמאית ב-.claude
ל-Claude Code יש שתי דרכים להוסיף יכולות, ושתיהן לגיטימיות — הן פשוט מתאימות למצבים שונים:
📁 הגדרה עצמאית (.claude/)
קבצים בתיקיית .claude של הפרויקט. שמות קצרים — פקודה נקראת /hello. מתאים לזרימות עבודה אישיות או ספציפיות לפרויקט אחד. אין ניהול גרסאות ואין הפצה מובנית.
🧩 Plugin
חבילה עם שם ייחודי. הרכיבים מקבלים namespace — אותה פקודה תיקרא /my-plugin:hello. מתאים לשיתוף עם צוות או קהילה, תומך בגרסאות, ב-marketplaces ובהפצה אוטומטית.
/deploy-tools:release). כך שני plugins שונים יכולים להגדיר פקודה בשם release בלי להתנגש זה בזה.
מה Plugin יכול להכיל?
Plugin הוא מודולרי — הוא יכול לכלול כל שילוב של הרכיבים הבאים. לא חייבים את כולם; plugin יכול להיות מורכב מרכיב אחד בלבד או מכמה רכיבים יחד.
| רכיב | מה הוא נותן |
|---|---|
| Skills | מיומנויות מותאמות — תיקייה עם קובץ SKILL.md שמכיל הנחיות שמופעלות לפי הקשר המשימה |
| Agents | תתי-סוכנים ייעודיים למשימות מסוימות, כל אחד עם חלון קונטקסט נפרד משלו |
| Hooks | מטפלי אירועים שרצים אוטומטית באירועי מחזור החיים של Claude Code |
| שרתי MCP | חיבורים מוכנים מראש לכלים ושירותים חיצוניים — מתחילים אוטומטית כשה-plugin פעיל |
| שרתי LSP | אינטליגנציית קוד בזמן אמת — אבחון שגיאות, מעבר להגדרה, מציאת שימושים |
| Output Styles | התאמה של אופן התגובה של Claude למשתמש |
| קבצי הרצה (bin/) | כלי שורת פקודה שמתווספים ל-PATH כל עוד ה-plugin פעיל |
מבנה התיקייה וקובץ plugin.json
plugin הוא בסך הכל תיקייה עם מבנה מוסכם. הליבה שלו היא תיקיית .claude-plugin שמכילה קובץ אחד — plugin.json, ה-manifest שמתאר את ה-plugin. כל שאר התיקיות יושבות בשורש ה-plugin, לא בתוך .claude-plugin.
plugin.json נכנס לתוך .claude-plugin/. כל שאר התיקיות — skills/, agents/, hooks/ וכן הלאה — חייבות לשבת בשורש ה-plugin. אם תכניסו אותן בטעות לתוך .claude-plugin/, Claude Code לא יזהה אותן.
הקובץ plugin.json
ה-manifest מתאר את ה-plugin. למעשה הוא אופציונלי — אם תשמיטו אותו, Claude Code יזהה אוטומטית את הרכיבים בתיקיות ברירת המחדל. אבל מומלץ להגדיר אותו. השדה היחיד שהוא חובה הוא name:
| שדה | חובה? | מה הוא עושה |
|---|---|---|
name |
כן | מזהה ייחודי ב-kebab-case, ללא רווחים. משמש ל-namespace של הרכיבים |
version |
לא | גרסה סמנטית. אם הוגדרה — משתמשים יקבלו עדכון רק כשתעלו אותה |
description |
לא | הסבר קצר על מטרת ה-plugin |
author |
לא | פרטי היוצר — name וכן email ו-url אופציונליים |
keywords |
לא | תגיות שעוזרות לגלות את ה-plugin |
version ב-plugin.json, אתם חייבים להעלות אותה בכל שחרור — אחרת משתמשים לא יקבלו את השינויים, גם אם דחפתם קומיטים. אם תשמיטו את version לגמרי, Claude Code ישתמש ב-SHA של הקומיט, וכל קומיט ייחשב לגרסה חדשה.
מה זה Marketplace?
Marketplace הוא קטלוג שעוזר למשתמשים לגלות ולהתקין plugins. אפשר לחשוב עליו כמו חנות אפליקציות: הוספת marketplace נותנת לכם גישה לעיין באוסף שלו, אבל אתם עדיין בוחרים בעצמכם איזה plugin להתקין.
marketplace הוא בעצמו ריפו (בדרך כלל ב-GitHub) שמכיל קובץ marketplace.json בתוך תיקיית .claude-plugin. הקובץ מגדיר שם, בעלים, ורשימת ה-plugins:
השדה source קובע מאיפה ה-plugin נמשך — נתיב יחסי בתוך הריפו, ריפו אחר ב-GitHub, כתובת Git כללית, או חבילת npm. כך marketplace אחד יכול לרכז plugins ממקורות שונים.
כדי להוסיף marketplace, משתמשים בפקודה /plugin marketplace add עם הריפו:
claude-plugins-official) שכולל plugins מאומתים — בהם חיבורי LSP לשפות כמו TypeScript, Python ו-Rust, חיבורי MCP לשירותים כמו GitHub, Slack ו-Supabase, וכלי זרימת עבודה מוכנים. אפשר לעיין בו גם בכתובת claude.com/plugins.
התקנה וניהול — פקודת /plugin
כל ניהול ה-plugins מתבצע דרך הפקודה /plugin. בלי ארגומנטים היא פותחת ממשק אינטראקטיבי עם ארבע לשוניות: Discover (עיון ב-plugins זמינים), Installed (ניהול המותקנים — הפעלה, כיבוי, הסרה), Marketplaces (הוספה והסרה של מקורות), ו-Errors (שגיאות טעינה).
אפשר גם לעבוד ישירות בפקודות. כך מתקינים plugin — בפורמט שם-plugin@שם-marketplace:
בעת ההתקנה אתם בוחרים scope — היכן ההגדרה תישמר. זה קובע אם ה-plugin אישי לכם, משותף עם הצוות, או נכפה על ידי הארגון:
| Scope | קובץ ההגדרות | מתי להשתמש |
|---|---|---|
| user | ~/.claude/settings.json |
plugins אישיים שיעבדו בכל הפרויקטים שלכם (ברירת המחדל) |
| project | .claude/settings.json |
plugins של הצוות — משותפים דרך גיט |
| local | .claude/settings.local.json |
plugins אישיים לפרויקט מסוים — לא עולים לגיט |
| managed | הגדרות מנוהלות | plugins שהארגון אוכף — לקריאה בלבד, לא ניתן לעקוף |
איך לבנות plugin משלכם
בניית plugin פשוטה בהרבה ממה שזה נשמע. הנה התהליך מקצה לקצה — מתיקייה ריקה ועד plugin שאחרים יכולים להתקין.
צרו את התיקייה וה-manifest
צרו תיקייה ל-plugin, ובתוכה תיקיית .claude-plugin עם קובץ plugin.json שמכיל לפחות את השדה name.
הוסיפו רכיבים
הוסיפו את התיקיות שאתם צריכים בשורש ה-plugin — skills/, agents/, hooks/, קובץ .mcp.json וכן הלאה.
בדקו מקומית
הריצו claude --plugin-dir ./my-plugin כדי לטעון את ה-plugin בלי להתקין אותו. אחרי שינויים, /reload-plugins טוען מחדש.
פרסמו דרך marketplace
צרו ריפו ב-GitHub עם .claude-plugin/marketplace.json שמצביע על ה-plugin. אחרים יוסיפו אותו עם /plugin marketplace add.
כדאי לדעת על שתי פקודות עזר נוספות: claude --plugin-dir מאפשרת גם לטעון כמה plugins בו-זמנית במהלך פיתוח, ו-/plugin validate . בודקת שה-plugin.json, ה-frontmatter של ה-skills והקובץ hooks/hooks.json תקינים — שווה להריץ אותה לפני פרסום.
.claude שאתם רוצים להפוך ל-plugin — פשוט העתיקו את התיקיות skills/, agents/ ו-commands/ לתוך תיקיית ה-plugin, והוסיפו plugin.json. הפורמט זהה, כך שאין מה להמיר.
הפעלת plugins לכל הצוות
אחד היתרונות הגדולים של plugins הוא היכולת להפעיל אותם אוטומטית לכל הצוות. במקום שכל מפתח יתקין ידנית, מגדירים את ה-plugins הרצויים בקובץ .claude/settings.json של הפרויקט — וזה עולה לגיט.
כאן extraKnownMarketplaces מצביע על ה-marketplace של הצוות, ו-enabledPlugins מגדיר אילו plugins פעילים. כשחבר צוות חדש מושך את הריפו ונותן בו אמון, Claude Code יציע לו להתקין את ה-marketplace ואת ה-plugins האלה — והסביבה שלו תהיה זהה לכולם, בלי הגדרה ידנית.
אבטחה ומגבלות שחשוב להכיר
plugins הם כלי חזק — וככל כלי חזק, צריך להבין את הסיכונים לפני שמשתמשים בו.
שתי מגבלות טכניות נוספות ששווה להכיר:
ארגונים יכולים לאכוף מדיניות: דרך הגדרות מנוהלות אפשר להגביל את ההתקנה ל-marketplaces מאושרים בלבד (strictKnownMarketplaces), או לחסום מקורות מסוימים. כך צוותי אבטחה שולטים במה שנכנס לסביבת הפיתוח.
שאלות נפוצות
סיכום
Plugins הם הדרך של Claude Code להפוך התאמות אישיות לנכס משותף. ראינו מה plugin יכול לארוז — Skills, Agents, Hooks ושרתי MCP — את מבנה התיקייה וקובץ ה-plugin.json, את תפקיד ה-marketplace כקטלוג הפצה, ואת התהליך המלא לבניית plugin ולפרסומו. אם בניתם לעצמכם זרימת עבודה טובה ב-Claude Code, plugin הוא הצעד הטבעי הבא: ארזו אותה פעם אחת, ותנו לכל הצוות — או לכל הקהילה — ליהנות ממנה.
🚀 רוצים ללמוד את Claude Code מההתחלה?
הקורס המלא בעברית — מההתקנה ועד Sub-Agents, Hooks ו-Plugins, עם דוגמאות מעשיות
לקורס המלא ←