מהם תוספי 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.

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

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

• מיומנות (Skill) היא יחידת הוראה בודדת ש-Claude טוען כאשר המשימה דורשת זאת. ראו מהי למעשה מיומנות של סוכן (Agent Skill).
• שרת MCP הוא תהליך נפרד החושף כלים לסוכן באמצעות פרוטוקול, לרוב מדובר בשירות רשת שאתם מריצים בעצמכם.
• קובץ חוקים כגון CLAUDE.md הוא הקשר (context) של פרויקט, הנקרא בתחילת הסשן וחלה על הכל.
• תוסף (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 קולט את העריכות שלך ללא צורך ב-restart, ו-claude plugin validate ./my-plugin בודק את ה-manifest, את ה-frontmatter של היכולות וה-agent, ואת hooks/hooks.json לפני שמישהו אחר רואה אותם.

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

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

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

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

עלות הפעלה. הרצת כישור (skill) של תוסף מצרפת את ההוראות שלו לשיחה, לכן אתם משלמים על גוף הכישורים רק כאשר נעשה בו שימוש. גוף הכישורים הוא החלק הזול, אך מה שהכישור מורה לסוכן לעשות אינו בהכרח כזה: שיטת ה-Depth Tree של ה-unlazy skill מוציאה כמעט את כל ה-tokens שלה על המעברים הנוספים שהיא כופה לפני שהסוכן רשאי להכריז על משימה כגמורה, ולא על הקובץ שהתקנתם. סוכן הוא דבר שונה. סוכן משנה (subagent) מריץ שיחה משלו עם prompt מערכת משלו ו-cache משלו, כשהוא מתחיל ללא hits ב-cache, לכן תוסף שתהליך העבודה שלו מייצר סוכנים עולה משמעותית יותר ממה שהערכת ה-context שלו מרמזת.

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

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

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

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

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

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

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

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

FAQ

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

לא. אין תשלום עבור מערכת התוספים, עבור הוספת marketplace, או עבור התקנת תוסף. העלות היא צריכת טוקנים, המחויבת לפי התוכנית שלכם או לפי הוצאות ה-API שלכם, בדיוק כמו כל הקשר (context) אחר. תוסף מוסיף הקשר קבוע בכל תור, מוסיף עוד כאשר נעשה שימוש באחת מהמיומנויות (skills) או הסוכנים שלו, ועשוי לחייב תור אחד יקר ללא מטמון (uncached) אם הוא מספק שרת 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-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 לפני האישור, והקפידו על נהלים מחמירים יותר בשרת מאשר במחשב נייד, שכן החשבון בשרת מחזיק בדרך כלל מפתחות וטוקנים שעלולים להיגנב.