מהם תוספי Claude Code ומה העלות שלהם?

מהו תוסף Claude Code

תוסף Claude Code הוא ספרייה אחת של רכיבים ש-Claude Code טוען ומנהל כיחידה אחת. רכיבים אלו הם מיומנויות (skills), סוכנים (agents), נקודות עגינה (hooks), שרתי MCP, שרתי LSP וצגים ברקע (background monitors). התקנת תוסף מוסיפה את כל חלקיו בבת אחת, תחת שם אחד, ונטרולו מסיר אותם באותה הדרך.

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

קובץ ה-manifest האופציונלי ב-.claude-plugin/plugin.json מעניק שם לתוסף, ושם זה הופך למרחב שמות (namespace). מיומנות בתוסף ששמו commit-commands מופעלת כ-/commit-commands:commit, כך ששני תוספים יכולים להפיץ כל אחד מיומנות בשם commit מבלי שאחד יסתיר את השני. סוכני תוספים מוגדרים באותו אופן ברשימת ה-@-mention, כ-plugin-name:agent-name.

תוסף, מיומנות, שרת MCP או קובץ חוקים

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

• מיומנות (skill) היא יחידת הוראה בודדת ש־Claude טוען כאשר המשימה דורשת זאת. ראו מהי למעשה מיומנות של סוכן.
• שרת MCP הוא תהליך נפרד החושף כלים לסוכן באמצעות פרוטוקול, לרוב כשירות רשת שאתם מריצים בעצמכם.
• קובץ חוקים כגון CLAUDE.md הוא הקשר פרויקט שנקרא בתחילת הסשן וחלה על הכל.
• תוסף (plugin) הוא קונטיינר שיכול להכיל מיומנויות, סוכנים, hooks והגדרות של שרת MCP יחד, בצירוף מספר גרסה וערוץ הפצה.

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

מיקום התוספים ותוכנם

תוסף המותקן מתוך marketplace מועתק למטמון מקומי ב-~/.claude/plugins/cache במקום להריץ אותו מהמיקום שבו הוא שובט. כל גרסה מותקנת מקבלת ספרייה משלה. בעת עדכון או הסרה, ספריית הגרסה הישנה מסומנת כיתומה ונמחקת כעבור שבועיים לערך; כך, סשן שכבר טען את הגרסה הישנה ימשיך לעבוד במקום להיכשל באמצע משימה.

מכיוון שהנתיב משתנה בכל עדכון, אסור לתוסף להגדיר את מיקומו באופן קשיח (hardcode). Hooks ותצורות MCP בתוך תוסף משתמשים ב-${CLAUDE_PLUGIN_ROOT}, שמתורגם לנתיב ההתקנה הנוכחי. מידע (state) שחייב להישמר לאחר עדכון צריך להיכתב ל-${CLAUDE_PLUGIN_DATA}, שמתורגם לספרייה יציבה תחת ~/.claude/plugins/data/.

רק ספריית התוסף עצמו מועתקת למטמון, עובדה שגורמת לבעיה נפוצה. נתיב שמצביע אל מחוץ לשורש התוסף, כגון ../shared-utils, יעבוד בזמן פיתוח עם נתיב מקומי אך יישבר לאחר ההתקנה, כיוון שקבצים אלו לא הועתקו.

מבנה הקבצים נראה כך.

my-plugin/
├── .claude-plugin/
│   └── plugin.json
├── skills/
│   └── code-review/
│       └── SKILL.md
├── agents/
├── hooks/
│   └── hooks.json
├── .mcp.json
└── bin/

רק plugin.json ממוקם בתוך .claude-plugin/. כל השאר נמצא בשורש התוסף. הצבת skills/ או hooks/ בתוך .claude-plugin/ היא הסיבה הנפוצה ביותר לכך שתוסף מותקן בהצלחה אך אינו מבצע דבר: Claude Code מחפש את הספריות הללו בשורש, אינו מוצא אותן, וטוען תוסף ללא רכיבים.

קובץ ה-manifest עצמו קטן.

{
  "name": "my-first-plugin",
  "description": "A greeting plugin to learn the basics",
  "version": "1.0.0"
}

כיצד להתקין תוסף עבור Claude Code

ההתקנה מורכבת משני שלבים, כאשר השלב הראשון אינו מתקין דבר. עליך להוסיף Marketplace, שהוא קטלוג של תוספים, ולאחר מכן להתקין מתוכו תוספים בודדים. ה-Marketplace הרשמי של Anthropic, ה-claude-plugins-official, נרשם עבורך באופן אוטומטי בפעם הראשונה שבה אתה מפעיל את Claude Code במצב אינטראקטיבי. Marketplace אחרים עליך להוסיף בעצמך.

/plugin marketplace add anthropics/claude-code
/plugin install commit-commands@claude-code-plugins

שים לב שה-repository הוא anthropics/claude-code בעוד שה-Marketplace נקרא claude-code-plugins. השם נגזר מקובץ הקטלוג שנמצא בתוך ה-repository, ולא מנתיב ה-repository עצמו; לכן, קרא את שם ה-Marketplace מתוך הלשונית Marketplaces ב-/plugin לפני שתקליד פקודת התקנה.

לאחר ההתקנה, קרא את שורת הסיכום. Plugin is now active. מציין שהרכיבים נטענו בסשן הנוכחי. Run /reload-plugins to activate. מציין שהם לא נטענו, ועליך להריץ את הפקודה המצוינת. אם /reload-plugins מציג אזהרה שהוא יקרא מחדש את השיחה, הרץ אותו שוב בתור /reload-plugins --force. לאחר מכן ודא שהתוסף אכן קיים: /plugin מציג אותו תחת הלשונית Installed, /help מפרט את היכולות שלו תחת Custom commands, וכל רכיב שנכשל בטעינה יופיע תחת הלשונית Errors עם סיבת הכישלון.

ההתקנה דורשת הגדרת Scope, וה-Scope קובע למי התוסף יהיה זמין. ה-Scope מסוג User מיועד עבורך, בכל פרויקט. ה-Scope מסוג Project כותב את התוסף לתוך ה-.claude/settings.json של ה-repository תחת enabledPlugins, כך שכל מי שמשכפל (clone) את ה-repository יוצע לו התוסף. ה-Scope מסוג Local מיועד עבורך, ב-repository זה בלבד.

עבור סקריפט, Dockerfile, או כל סשן שבו לוח אינטראקטיבי אינו זמין, השתמש בגרסת ה-shell. היא מתקינה את התוסף ב-Scope מסוג User, אלא אם תעביר את הדגל --scope.

claude plugin install commit-commands@claude-code-plugins --scope project
claude plugin list

claude plugin install רץ מחוץ לסשן, לכן סשן שכבר פתוח לא יראה את התוסף החדש עד שתריץ /reload-plugins או תתחיל סשן חדש.

ניהול התוספים הקיימים מתבצע באותה צורה בשני המקומות. /plugin list מדפיס את רשימת התוספים המותקנים, ומקבל את הפרמטרים --enabled או --disabled. /plugin disable name@marketplace מכבה תוסף מבלי להסיר אותו, /plugin enable מפעיל אותו מחדש, ו-/plugin uninstall מסיר אותו. פקודות ה-slash פותחות את לוח התוספים כדי להחיל את השינוי, וזו הסיבה שגרסאות ה-shell של claude plugin ... הן אלו שיש להשתמש בהן בתוך סקריפטים.

כדי להפיץ Marketplace לצוות שלם, הוסף אותו ל-.claude/settings.json של הפרויקט. חברי הצוות יתבקשו להתקין אותו ברגע שיאשרו את תיקיית ה-repository.

{
  "extraKnownMarketplaces": {
    "my-team-tools": {
      "source": {
        "source": "github",
        "repo": "your-org/claude-plugins"
      }
    }
  }
}

בזמן שאתה בונה תוסף משלך, דלג על ה-Marketplace לחלוטין. claude --plugin-dir ./my-plugin טוען תיקייה עבור הסשן הנוכחי, /reload-plugins קולט את העריכות שלך ללא צורך באתחול, ו-claude plugin validate ./my-plugin בודק את ה-manifest, את ה-skill ואת ה-agent frontmatter, וכן את hooks/hooks.json לפני שמישהו אחר רואה אותם.

מה העלות של תוסף Claude Code?

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

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

עלות הקשר (context) קבוע. מה שתוסף מוסיף נשאר בתוך ה-context שלכם ונקרא מחדש בכל שלב של הסשן. לפני ההתקנה, תצוגת הפרטים /plugin מציגה הערכה ב-tokens מסוג Context cost, בתוספת מקטע Will install המפרט את הפקודות, המיומנויות, ה-agents, ה-hooks, ושרתי ה-MCP וה-LSP שאתם עומדים להוסיף. קראו את שניהם. תוספים מ-marketplaces מקומיים או מותאמים אישית עשויים שלא לספק נתונים אלו, ובמקרה כזה תצטרכו להעריך את העלות בעצמכם. תוסף שכולל שרת MCP הוא בדרך כלל הכבד ביותר, כיוון שהגדרות הכלים הן גדולות, אם כי במודלים התומכים בחיפוש כלי MCP, הגדרות אלו נדחות עד לרגע שבו הכלי נדרש.

עלות הפעלה. הרצת מיומנות (skill) של תוסף מצרפת את ההוראות שלה לשיחה, לכן אתם משלמים על גוף המיומנות רק כאשר נעשה בה שימוש. סוכן (agent) פועל אחרת. סוכן משנה מנהל שיחה משלו עם system prompt משלו ו-cache משלו, כשהוא מתחיל ללא התאמות ב-cache. לכן, תוסף שתהליך העבודה שלו מפעיל סוכנים עולה משמעותית יותר ממה שהערכת ה-context שלו מרמזת.

עלות cache. הפעלה או השבתה של תוסף באמצע סשן עלולה לאלץ את הבקשה הבאה לעבד מחדש את כל השיחה שלכם. מיומנויות, פקודות, סוכנים, hooks, שרתי LSP, צגים וערכות נושא לעולם לא גורמים לכך: מה שהם מוסיפים מתווסף לאחר ההיסטוריה הקיימת, כך שהבקשה הבאה משלמת על התוכן החדש ועדיין קוראת את כל מה שלפניו מה-cache. היוצא מן הכלל הוא תוסף המספק שרת MCP. אם הכלים שלו נדחים על ידי חיפוש כלים, ה-cache נשמר. אם הם נטענים לתוך ה-prompt prefix, הבקשה הבאה קוראת מחדש את כל השיחה כקלט שלא עבר cache. זו בדיוק הסיבה ש-/reload-plugins מזהיר ומסרב במקרה כזה עד שתעבירו את --force.

אתם יכולים לנטר זאת במקום לנחש. כל תגובת API מדווחת על cache_read_input_tokens ו-cache_creation_input_tokens, ו-שורת סטטוס מותאמת אישית המציגה שימוש חי ב-tokens מציגה את שניהם מולכם. סשן תקין קורא הרבה יותר ממה שהוא יוצר. אם היקף היצירה נשאר גבוה לאורך זמן, משהו ב-prefix שלכם משתנה בכל שלב. לתמונה רחבה יותר של מה שממלא את ה-window, ראו כיצד לנהל את ה-context window של Claude Code ו-מה המשמעות האמיתית של ספירות ה-tokens הללו.

פעולת תחזוקה אחת משתלמת מעצמה. הכרטיסייה Installed מקבצת תוספים שלא השתמשתם בהם בשבועיים האחרונים תחת כותרת Not used recently, עם שורת Last used בתצוגת הפרטים. תוספים אלו עדיין עולים לכם בזמן עלייה וב-context בכל סשן. השביתו או הסירו אותם.

תוסף פועל בהרשאות המשתמש שלך

התיעוד של Anthropic מצהיר זאת בגלוי: תוספים ושווקי תוספים הם רכיבים בעלי רמת אמון גבוהה, המסוגלים להריץ קוד שרירותי על המכונה שלך בהרשאות המשתמש שלך. אין מדובר בסיכון תיאורטי. ה-hooks של תוסף מריצים פקודות shell באירועי session, כולל לפני ואחרי קריאות לכלים. הספרייה bin/ שלו מתווספת ל-PATH של כלי ה-Bash כל עוד התוסף פעיל. שרתי ה-MCP שלו הם תהליכים שהוא מפעיל. שום דבר כאן אינו מבודד (sandboxed) מחשבון המשתמש שלך.

במחשב נייד, סיכון זה מוגבל למה שהמשתמש יכול לגשת אליו. בשרת, בדרך כלל אין זה המצב. החשבון שמריץ את ה-agent מחזיק לעיתים קרובות מפתחות SSH, אסימוני פריסה (deploy tokens), session של cloud CLI, וגישה ל-socket של Docker; לכן, "קוד שרירותי כמשתמש שלך" משמעותו השתלטות על המכונה. אם Claude Code רץ על גבי VPS, קראו את כיצד להריץ את Claude Code בבטחה על VPS לפני התקנה של כל דבר, ואת כיצד להרחיק אישורים מהישג ידו של agent לפני התקנת תוסף שמתקשר עם שירות חיצוני.

קיימים אמצעי הגנה מסוימים, וכדאי להכיר אותם. תוסף ברמת הפרויקט מגיע מתוך ה-repository ולא ממך, לכן הוא נטען רק לאחר שנתת אמון ב-workspace; שרתי ה-MCP שלו עדיין דורשים אישור פר-שרת, שרתי ה-LSP שלו ממתינים לאישור זה, וניטור הרקע שלו אינו נטען כלל. סוכנים שמגיעים כחלק מתוסף אינם מורשים להגדיר hooks, שרתי MCP או מצב הרשאות. תוספים מהשוק מועתקים לתוך ה-cache, כאשר קישורים סימבוליים (symlinks) שמצביעים אל מחוץ לשוק נדחים, כך שתוסף אינו יכול למשוך קבצי מארח שרירותיים.

שום דבר מזה אינו מחליף בדיקה של מה שאתה מתקין. בדוק את רשימת ה-Will install, העדף תוספים שניתן לפתוח ולקרוא את קוד המקור שלהם, שמור את תוספי הצוות שלך ב-repository של שוק תוספים שבשליטתך, והרץ claude plugin validate על כל דבר שאתה כותב בעצמך.

FAQ

האם תוספים ל-Claude Code עולים כסף נוסף?

לא. אין תשלום עבור מערכת התוספים, עבור הוספת marketplace, או עבור התקנת תוסף. העלות היא צריכת טוקנים, המחויבת לפי התוכנית שלכם או לפי הוצאות ה-API, בדיוק כמו כל הקשר (context) אחר. תוסף מוסיף הקשר קבוע בכל תור, מוסיף עוד כאשר מופעלת אחת מהמיומנויות (skills) או הסוכנים שלו, ועשוי לחייב תור אחד יקר ללא מטמון אם הוא מספק שרת MCP שהכלים שלו נטענים לתוך קידומת ה-prompt. תצוגת הפירוט /plugin מציגה הערכה Context cost לפני ההתקנה.

מה ההבדל בין תוסף (plugin) למיומנות (skill)?

מיומנות היא יחידת הוראה בודדת. תוסף הוא חבילה שיכולה להכיל מיומנויות, סוכנים, hooks, שרתי MCP, שרתי LSP וצגים, עם שם, גרסה ו-marketplace שממנו ניתן להתקין אותו. כתבו מיומנות עצמאית ב-.claude/ כאשר היא מיועדת לכם ולפרויקט הנוכחי. מיומנות בעלת מטרה אחת כמו Ponytail, שדוחפת את הסוכן לעבר השינוי הקטן ביותר שעובד היא הדוגמה המובהקת לכך: קובץ אחד עם כלל אחד בתוכו, עד ליום שבו גם הצוות שלכם ירצה להשתמש בו. הפכו אותו לתוסף כאשר אנשים אחרים זקוקים לו וכאשר יש צורך לעדכן אותו לאורך זמן. מיומנויות של תוספים הן בעלות מרחב שמות (namespaced), לכן מיומנות בתוך תוסף מופעלת כ-/plugin-name:skill-name ולא כ-/skill-name.

התוסף הותקן אך המיומנויות שלו לא מופיעות. מה הבעיה?

בדקו תחילה את סיכום ההתקנה. אם הופיעה ההודעה Run /reload-plugins to activate., הרכיבים עדיין לא נטענו, ואם פעולת ה-reload מזהירה שהיא תקרא מחדש את השיחה, הריצו אותה מחדש כ-/reload-plugins --force. אם הוא נטען אך לא מציג דבר, פתחו את /plugin וקראו את לשונית Errors. טעות המבנה הנפוצה ביותר היא מיקום של skills/, agents/ או hooks/ בתוך .claude-plugin/, מקום שבו Claude Code לא מחפש אותם. זכרו שמיומנויות של תוספים הן בעלות מרחב שמות, לכן עליכם לחפש את /plugin-name:skill-name בלשונית Custom commands של /help. כמוצא אחרון, בצעו rm -rf ~/.claude/plugins/cache, הפעילו מחדש והתקינו שוב.

האם ניתן להתקין תוספים ללא הלוח האינטראקטיבי?

כן. השתמשו בפקודת ה-shell claude plugin install name@marketplace, שמתקינה בהיקף המשתמש (user scope) אלא אם כן תעבירו את --scope project או --scope local. זה עובד בסקריפטים, בתמונות (images) ובסביבות לא אינטראקטיביות שבהן הלוח /plugin אינו זמין. מכיוון שהפעולה מתבצעת מחוץ לסשן, סשן שכבר פתוח זקוק ל-/reload-plugins לפני שהתוסף ייכנס לתוקף.

האם בטוח להתקין תוסף מ-marketplace שמצאתי ב-GitHub?

התייחסו לכך כפי שהייתם מתייחסים להרצת סקריפט התקנה של אותו מאגר בעצמכם, שכן זה קרוב מאוד למה שזה בפועל. תוסף יכול להריץ פקודות shell דרך hooks, להוסיף קבצים ברי-הרצה ל-PATH של כלי ה-Bash, ולהפעיל שרתי MCP, הכל עם ההרשאות של המשתמש שלכם. Anthropic אינה שולטת או מאמתת את התוכן של תוספי צד-שלישי. התקינו ממקורות שאתם יכולים לקרוא, עברו על רשימת ה-Will install לפני האישור, והקפידו יותר בשרת מאשר במחשב נייד, שכן החשבון שם בדרך כלל מחזיק מפתחות וטוקנים ששווה לגנוב.