תיעוד 72

מדידת עלות ושימוש של תוסף

מדדו את עלות הטוקנים של תוסף Claude Code, בדקו אם אנשים עדיין משתמשים בו, ובחרו את אירועי הטלמטריה לשאלות על תוספים ברמת הארגון.

כל סשן שבו תוסף מופעל כולל את השמות והתיאורים של ה-skills, ה-agents והפקודות שלו בהקשר של Claude, והטוקנים האלה נספרים מול השימוש של המשתמש בין אם התוסף מופעל בפועל ובין אם לא. הדף הזה מראה איך לראות את המספר הזה עבור תוסף, איך להקטין אותו אם אתם מתחזקים את התוסף, ואיפה השימוש מופיע כדי שתוכלו לדעת אם תוסף עדיין בשימוש.

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

[!NOTE]

המקרים האלה מכוסים בדפים אחרים:

בדיקה עד כמה התוסף משנה באופן אמין את ההתנהגות של Claude: ראו בדיקת תוספים עם evals

קיצוץ ההקשר של הסשן שלכם: ראו ניהול תוספים מותקנים ואת דף חלון ההקשר

התחילו במדידת העלות של תוסף.

#מדידת העלות של תוסף

כדי לראות מה תוסף מוסיף להקשר של Claude, הריצו את claude plugin details עם שם התוסף. מריצים את זה ב-shell, לא בשורת הפקודה של סשן Claude Code שרץ. התוסף חייב להיות טעון: מותקן, בספריית skills, או מועבר עם --plugin-dir באותה פקודה, כמו ב-claude --plugin-dir ./formatter plugin details formatter.

הדוגמה הזו קוראת תוסף מותקן בשם formatter שיש לו שני skills, פקודה, agent, hook ושרת MCP:

claude plugin details formatter

formatter 1.0.0
  Description: Formats and lints code on save
  Source: formatter@my-marketplace

Component inventory
  Skills (3)  format-all, format-code, lint-fix
  Agents (1)  style-reviewer
  Hooks (1)  PostToolUse  (harness-only , no model context cost)
  MCP servers (1)  formatter-tools  (tool schemas resolved at runtime; not counted)
  LSP servers (0)

Projected token cost
  Always-on:   ~146 tok   added to every session

Per-component (rounded)
  component       always-on  on-invoke
  format-code           ~40        ~30
  lint-fix              ~50        ~30
  style-reviewer        ~40        ~40
  format-all           < 20        ~30

  On-invoke cost is paid each time a skill or agent fires.
  Token counts are estimates and may differ from actual usage.

כל חלק בפלט עונה על שאלה אחרת:

Component inventory: מה Claude Code מצא בתוסף. פקודות נספרות יחד עם skills, ולכן format-all מופיע תחת Skills. ל-hooks ולשרתי MCP אין אומדן עלות ואין שורה לכל רכיב. כדי לראות מה כלי ה-MCP של תוסף מוסיפים, הריצו /context בסשן שבו התוסף מופעל וקראו את הקטגוריה MCP tools.
Always-on: הטוקנים ששמות ותיאורים של ה-skills, ה-agents והפקודות של התוסף מוסיפים לכל סשן שבו התוסף מופעל, בין אם משהו רץ ובין אם לא. זה המספר שכל משתמש נושא, וזה המספר שכדאי להקטין.
Per-component: כל שורה מפצלת skill, agent או פקודה אחד לחלק ה-always-on שלו ולעלות ה-on-invoke, שהיא הגוף שנטען רק כשהרכיב הזה רץ. השתמשו בעמודת always-on כדי למצוא איזה רכיב תורם הכי הרבה.

#הורדת נתון ה-always-on

אם אתם מתחזקים את התוסף, השינויים האלה מקטינים את מה שהוא מוסיף לכל סשן. אם אתם רק משתמשים בו, האפשרויות שלכם הן להשבית או להסיר אותו. ראו ניהול תוספים מותקנים.

נתון ה-always-on סופר את השם של כל רכיב בתוספת ה-frontmatter של description ו-when_to_use. כדי להוריד אותו:

קצרו תיאורים של skills ושל agents.
פצלו תוסף גדול כדי שמשתמשים יתקינו רק את הרכיבים שהם צריכים.

התיאור של skill הוא גם מה ש-Claude מתאים מולו בקשה, ולכן תיאור קצר יותר יכול לעצור את הפעלת ה-skill. אחרי שקיצרתם תיאורים, בדקו הפעלה עם grader מסוג tool_used: Skill בערכת ה-eval שלכם.

למה שכל סוג רכיב תורם, ראו רכיבי תוסף.

#עלות שמוצגת למשתמשים לפני ההתקנה

תוספים בשוק הרשמי מציגים את העלות שלהם למשתמשים לפני ההתקנה. ב-/plugin, כשמשתמש מדפדף ברשימת התוספים של שוק ובוחר תוסף, חלונית הפרטים מציגה מקטע Context cost עם שורה Every turn: ושורה When invoked:. כשנתון ה-always-on הוא 2,000 טוקנים או יותר, השורה Every turn: מופיעה מודגשת.

לתוסף בשוק שלכם אין מקטע Context cost.

#בדיקה אם תוסף בשימוש

Claude Code לא מדווח למחבר על השימוש בתוסף. השימוש נרשם במכונה של כל אדם שהתקין את התוסף, ולכן מה שאפשר ללמוד תלוי בקשר שלכם לאנשים האלה:

אתם מנהלים את Claude Code עבור הארגון שלהם: אירועי OpenTelemetry ו-Analytics API סופרים התקנות והפעלות skill על פני כל מכונה. ראו מדידה על פני צי.
הם חברי צוות שאפשר לשאול: Claude Code של כל משתמש מראה לו אם הוא עדיין משתמש בתוסף, בארבעה מקומות: החלונית /plugin, /skill-doctor, /doctor ו-/usage. כל הארבעה הם פקודות שהמשתמש מריץ בשורת Claude Code בסשן במכונה שלו.
אף אחד מאלה: אין לכם אות שימוש מ-Claude Code עבור התוסף הזה.

לשימוש בתוסף שמופיע במדריך של Anthropic, ראו מעקב אחרי שימוש בתוסף שפורסם ב-claude.com.

#לא בשימוש לאחרונה ב-`/plugin`

בלשונית Installed של /plugin, תוסף שהמשתמש התקין משוק עובר תחת כותרת Not used recently אחרי שלא היה בשימוש לפחות 14 ימים ו-10 סשנים. פרטי התוסף גם מציגים שורה Last used:. למה שמשתמשים עושים עם הכותרת והשורה האלה, ראו מציאת תוספים שכבר לא בשימוש.

הכותרת Not used recently אף פעם לא מופיעה עבור:

תוספים שנטענו עם --plugin-dir או מספריית skills
תוספים שהופעלו דרך הגדרות מנוהלות, או שחוברו מספריית seed
תוספים שכוללים theme, output style, monitor או workflow, כי אלה בשימוש בלי הפעלה שנעקבת

שרת שפה של תוסף נספר כבשימוש כשהוא מספק אבחון או עונה לבקשת ניווט בקוד, ולכן תוסף LSP שהשרת שלו פעיל בסשנים שלכם לא מופיע כלא בשימוש.

כשהארגון של המשתמש מגדיר strictKnownMarketplaces, לא הכותרת ולא השורה Last used: מופיעות.

#מציאת skills שלעולם לא רצים

הריצו /skill-doctor כדי לראות מה כל אחד מה-skills שלכם עולה ובאיזו תדירות הוא בשימוש. הוא מסמן skills שנמצאים ברשימת ה-skills של Claude אבל מעולם לא הופעלו, כולל skills מתוספים.

בסשן אינטראקטיבי, הדוח נפתח בלשונית Stats של מנהל /plugin. ראו מציאת skills שלא בשימוש למה שהדוח מכסה ואיפה הוא זמין.

#תוספים שלא בשימוש ב-`/doctor`

בדיקת /doctor מפרטת כל skill, שרת MCP ותוסף שהמשתמש התקין, וממליצה להשבית את אלה שלא היו בשימוש. ראו /doctor במדריך הפקודות.

#חלק השימוש ב-`/usage`

בתוכנית Pro, Max, Ultra, Team או Enterprise, פירוט /usage מייחס שימוש אחרון ל-skills, ל-subagents, לתוספים ולשרתי MCP כחלק מהסך. ראו שימוש בפקודה /usage.

#מדידה על פני צי

אם אתם מנהלים את Claude Code עבור ארגון, אפשר למדוד עלות ושימוש של תוספים על פני כל מכונה מאחד משני המקורות האלה:

אירועי OpenTelemetry: Claude Code מייצא אותם ל-backend שלכם אחרי שמגדירים exporter. ראו אירועי OpenTelemetry להתקנות ולשימוש בתוספים.
Analytics API: מוגש מהרשומות של Anthropic, בלי צורך ב-exporter. ראו שאילתה ל-Analytics API.

#אירועי OpenTelemetry להתקנות ולשימוש בתוספים

אירועי OpenTelemetry והמאפיינים האלה עונים על כל שאלה על תוסף מה-backend שלכם:

שאלה	אירוע או מאפיין OpenTelemetry
אילו תוספים מותקנים, ומאיפה	`claude_code.plugin_installed`, אחד לכל התקנה
אילו תוספים פעילים בכמה סשנים	`claude_code.plugin_loaded`, אחד לכל תוסף מופעל בתחילת סשן
אילו skills מופעלים, ואיזה תוסף הבעלים שלהם	`claude_code.skill_activated`, עם `plugin.name` ו-`marketplace.name` עבור skills של תוסף
מה ה-hooks של תוסף מדווחים	`claude_code.hook_plugin_metrics`, נשלח רק עבור hooks בתוספים מהשוק הרשמי
מה תוסף עולה בהוצאת API	`plugin.name` ו-`marketplace.name` במונה העלות, מוגדרים כשה-skill או ה-subagent הפעיל שייך לתוסף

#שמות תוספים מושחרים ב-backend שלכם

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

כדי לקבל שמות אמיתיים בחלק מהאירועים, הגדירו את משתנה הסביבה OTEL_LOG_TOOL_DETAILS ל-1 במכונות שמייצאות טלמטריה, למשל בבלוק env של אותן הגדרות מנוהלות שמגדירות את ה-exporter:

אירוע	ברירת מחדל	עם `OTEL_LOG_TOOL_DETAILS=1`
`plugin_loaded`	`plugin.name` ו-`marketplace.name` הם המחרוזת המילולית `third-party`	שמות אמיתיים
`plugin_installed`, `skill_activated`	`plugin.name` ו-`marketplace.name` מושמטים. ב-`skill_activated`, `skill.name` הוא `custom_skill`	שמות אמיתיים
מונה העלות	`plugin.name` הוא `third-party`. `marketplace.name` חסר	`plugin.name` אמיתי. `marketplace.name` עדיין חסר

ב-plugin_loaded, plugin_id_hash עדיין מזהה כל תוסף כברירת מחדל, כך שאפשר לספור תוספי צד שלישי נפרדים.

#שאילתה ל-Analytics API

בתוכנית Enterprise, Analytics API עונה על "אילו תוספים הארגון שלי מתקין ומפעיל" מהרשומות של Anthropic, בלי צורך ב-exporter. GET /v1/organizations/analytics/plugins מחזיר ספירות התקנה והפעלה לכל תוסף ולכל יום על פני Claude Code ו-Cowork, ואפשר לקבץ אותן לפי משתמש, קבוצת RBAC או מוצר.

פעילות תוסף שמגיעה ל-Anthropic בלי שם תוסף מופיעה בשורת third-party מצטברת אחת. מציאת תוספים בטלמטריה אומרת אילו תוספים Claude Code מדווח לפי שם.

אמתו את הבקשה עם מפתח API שיש לו היקף read:analytics, ש-Primary Owner יוצר כמתואר תחת גישה לנתונים באופן תכנותי.

ראו את הפניה ל-endpoint עבור הפרמטרים ושדות התשובה.

#הצעדים הבאים

בדיקת תוספים עם evals: מדדו עד כמה התוסף מכוון את Claude באופן אמין, לא רק מה הוא עולה
הורדת נתון ה-always-on: מה לשנות בתוסף כדי להקטין את העלות לכל תור
אבטחת תוספים ואמון: אילו שדות טלמטריה נושאים שמות תוספים ומתי הם מושחרים
ניטור שימוש: ההפניה המלאה לאירועי OpenTelemetry