SpyBara
Go Premium

plugins/measure.md 2026-09-27 23:59 UTC to 2026-09-28 22:01 UTC

This page contains 2 additions and 2 deletions.

2026
Fri 25 23:58 Mon 28 22:59

Kosten und Nutzung von Plugins messen

Messen Sie die Token-Kosten eines Claude Code-Plugins, finden Sie heraus, ob es noch verwendet wird, und wählen Sie die Telemetrie-Events für organisationsweite Plugin-Fragen aus.

Jede Sitzung, in der ein Plugin aktiviert ist, enthält die Namen und Beschreibungen seiner Skills, Agents und Commands im Kontext von Claude, und diese Token werden gegen die Nutzung des Benutzers angerechnet, unabhängig davon, ob das Plugin verwendet wird oder nicht. Diese Seite zeigt, wie Sie diese Zahl für ein Plugin sehen, wie Sie sie reduzieren, wenn Sie das Plugin verwalten, und wo die Nutzung angezeigt wird, damit Sie feststellen können, ob ein Plugin noch verwendet wird.

Diese Seite ist für Plugin-Autoren und Verwalter. Wenn Sie Claude Code für eine Organisation verwalten, behandelt Messung über eine Flotte die gleichen Fragen auf jedem Computer.

Beginnen Sie mit Messen Sie, was ein Plugin kostet.

Messen Sie, was ein Plugin kostet

Um zu sehen, was ein Plugin zu Claudes Kontext hinzufügt, führen Sie claude plugin details mit dem Namen des Plugins aus. Sie führen es in Ihrer Shell aus, nicht an der Eingabeaufforderung einer laufenden Claude Code-Sitzung. Das Plugin muss geladen sein: installiert, in einem Skills-Verzeichnis oder mit --plugin-dir im gleichen Befehl übergeben, wie in claude --plugin-dir ./formatter plugin details formatter.

Dieses Beispiel liest ein installiertes Plugin namens formatter, das zwei Skills, einen Command, einen Agent, einen Hook und einen MCP-Server hat:

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.

Jeder Teil der Ausgabe beantwortet eine andere Frage:

  • Component inventory: was Claude Code im Plugin gefunden hat. Commands werden mit Skills gezählt, daher erscheint format-all unter Skills. Hooks und MCP-Server erhalten keine Kostenschätzung und keine Pro-Komponenten-Zeile; um zu sehen, was die MCP-Tools eines Plugins hinzufügen, führen Sie /context in einer Sitzung mit aktiviertem Plugin aus und lesen Sie die Kategorie MCP tools.
  • Always-on: die Token, die die Namen und Beschreibungen der Skills, Agents und Commands des Plugins zu jeder Sitzung hinzufügen, in der das Plugin aktiviert ist, unabhängig davon, ob etwas ausgeführt wird. Dies ist die Zahl, die jeder Benutzer trägt, und die zu reduzierende.
  • Per-component: jede Zeile teilt einen Skill, Agent oder Command in seinen Always-on-Anteil und seine On-invoke-Kosten auf, die nur geladen werden, wenn diese Komponente ausgeführt wird. Verwenden Sie die Always-on-Spalte, um zu finden, welche Komponente am meisten beiträgt.

Reduzieren Sie die Always-on-Zahl

Wenn Sie das Plugin verwalten, reduzieren diese Änderungen, was es zu jeder Sitzung hinzufügt. Wenn Sie es nur verwenden, sind Ihre Optionen, es zu deaktivieren oder zu deinstallieren; siehe Installierte Plugins verwalten.

Die Always-on-Zahl zählt den Namen jeder Komponente plus ihre description und when_to_use Frontmatter. Um sie zu reduzieren:

  • Verkürzen Sie Skill- und Agent-Beschreibungen.
  • Teilen Sie ein großes Plugin auf, damit Benutzer nur die Komponenten installieren, die sie benötigen.

Die Beschreibung eines Skills ist auch das, wogegen Claude eine Anfrage abgleicht, daher kann eine kürzere verhindern, dass der Skill ausgelöst wird. Nachdem Sie Beschreibungen gekürzt haben, überprüfen Sie das Auslösen mit einem tool_used: Skill Grader in Ihrer Eval-Suite.

Für das, was jeder Komponententyp beiträgt, siehe Plugin-Komponenten.

Kosten, die Benutzern vor der Installation angezeigt werden

Plugins im offiziellen Marketplace zeigen ihre Kosten Benutzern vor der Installation an. In /plugin, wenn ein Benutzer die Plugin-Liste eines Marketplace durchsucht und ein Plugin auswählt, zeigt der Detailbereich einen Abschnitt Context cost mit einer Zeile Every turn: und einer Zeile When invoked:. Wenn die Always-on-Zahl 2.000 Token oder mehr beträgt, wird die Zeile Every turn: hervorgehoben.

Ein Plugin in Ihrem eigenen Marketplace hat keinen Abschnitt Context cost.

Überprüfen Sie, ob ein Plugin verwendet wird

Claude Code meldet die Nutzung eines Plugins nicht an seinen Autor zurück. Die Nutzung wird auf dem Computer jeder Person aufgezeichnet, die das Plugin installiert hat, daher hängt das, was Sie erfahren können, von Ihrer Beziehung zu diesen Personen ab:

  • Sie verwalten Claude Code für ihre Organisation: die OpenTelemetry-Events und die Analytics API zählen Installationen und Skill-Aktivierungen auf jedem Computer. Siehe Messung über eine Flotte.
  • Sie sind Teamkollegen, die Sie fragen können: Claudes eigenes Claude Code zeigt jedem Benutzer, ob er das Plugin noch verwendet, an vier Stellen: das /plugin Panel, /skill-doctor, /doctor und /usage. Alle vier sind Commands, die der Benutzer an der Claude Code-Eingabeaufforderung in einer Sitzung auf seinem eigenen Computer ausführt.
  • Keines von beiden: Sie haben kein Nutzungssignal von Claude Code für dieses Plugin.

Nicht kürzlich verwendet in `/plugin`

Auf der Registerkarte Installed von /plugin wird ein Plugin, das der Benutzer aus einem Marketplace installiert hat, unter einer Kopfzeile Not used recently verschoben, sobald es mindestens 14 Tage und 10 Sitzungen lang nicht verwendet wurde. Die Details des Plugins zeigen auch eine Zeile Last used:. Für das, was Benutzer mit dieser Kopfzeile und Zeile tun, siehe Finden Sie Plugins, die Sie nicht mehr verwenden.

Die Kopfzeile Not used recently wird niemals angezeigt für:

  • Plugins, die mit --plugin-dir oder aus einem Skills-Verzeichnis geladen werden
  • Plugins, die durch verwaltete Einstellungen aktiviert werden, oder aus einem Seed-Verzeichnis bereitgestellt werden
  • Plugins, die ein Theme, einen Output-Stil, einen Monitor oder einen Workflow enthalten, da diese ohne eine verfolgbare Invokation verwendet werden

Der Language Server eines Plugins wird als verwendet gezählt, wenn er Diagnosen liefert oder eine Code-Navigationsanfrage beantwortet, daher wird ein LSP-Plugin, dessen Server in Ihren Sitzungen aktiv ist, nicht als ungenutzt aufgelistet.

Wenn die Organisation des Benutzers strictKnownMarketplaces setzt, werden weder die Kopfzeile noch die Zeile Last used: angezeigt.

Finden Sie Skills, die nie ausgeführt werden

Führen Sie /skill-doctor aus, um zu sehen, was jeder Ihrer Skills kostet und wie oft er verwendet wird. Es kennzeichnet Skills, die in Claudes Skill-Listing vorhanden sind, aber nie aufgerufen wurden, einschließlich Skills aus Plugins.

In einer interaktiven Sitzung wird der Bericht auf der Registerkarte Stats des /plugin-Managers geöffnet. Siehe Finden Sie ungenutzte Skills für das, was der Bericht abdeckt und wo er verfügbar ist.

Ungenutzte Plugins in `/doctor`

Die /doctor-Überprüfung listet jeden benutzerinstallierten Skill, MCP-Server und Plugin auf und empfiehlt, die nicht verwendeten zu deaktivieren. Siehe /doctor in der Befehlsreferenz.

Nutzungsanteil in `/usage`

In einem Pro-, Max-, Team- oder Enterprise-Plan teilt die /usage-Aufschlüsselung die aktuelle Nutzung als Anteil des Gesamtbetrags auf Skills, Subagents, Plugins und MCP-Server auf. Siehe Verwenden des /usage-Befehls.

Messung über eine Flotte

Wenn Sie Claude Code für eine Organisation verwalten, können Sie Plugin-Kosten und -Nutzung auf jedem Computer aus einer dieser Quellen messen:

OpenTelemetry-Events für Plugin-Installationen und -Nutzung

Diese OpenTelemetry-Events und Attribute beantworten jede Plugin-Frage von Ihrem Backend:

Frage OpenTelemetry-Event oder Attribut
Welche Plugins werden installiert und von wo claude_code.plugin_installed, eine pro Installation
Welche Plugins sind in wie vielen Sitzungen aktiv claude_code.plugin_loaded, eine pro aktiviertem Plugin beim Sitzungsstart
Welche Skills werden aktiviert und welches Plugin besitzt sie claude_code.skill_activated, mit plugin.name und marketplace.name für Plugin-Skills
Was die Hooks eines Plugins melden claude_code.hook_plugin_metrics, nur für Hooks in offiziellen Marketplace-Plugins ausgegeben
Was ein Plugin in API-Ausgaben kostet plugin.name und marketplace.name auf dem Cost Counter, gesetzt, wenn der aktive Skill oder Subagent zu einem Plugin gehört

Redigierte Plugin-Namen in Ihrem Backend

Plugins aus dem offiziellen Marketplace melden ihren Plugin-Namen und Marketplace-Namen an Ihr Backend wörtlich. Der Name jedes anderen Plugins wird standardmäßig redigiert oder weggelassen, einschließlich eines Plugins aus dem eigenen Marketplace Ihrer Organisation. Der Trust Tier des Plugins entscheidet, welcher.

Um echte Namen bei einigen Events zu erhalten, setzen Sie die Umgebungsvariable OTEL_LOG_TOOL_DETAILS auf 1 auf den Computern, die Telemetrie exportieren, zum Beispiel im env-Block der gleichen verwalteten Einstellungen, die den Exporter konfigurieren:

Event Standard Mit OTEL_LOG_TOOL_DETAILS=1
plugin_loaded plugin.name und marketplace.name sind die Literalzeichenfolge third-party Echte Namen
plugin_installed, skill_activated plugin.name und marketplace.name weggelassen; bei skill_activated ist skill.name custom_skill Echte Namen
Cost Counter plugin.name ist third-party; marketplace.name abwesend Echter plugin.name; marketplace.name immer noch abwesend

Bei plugin_loaded identifiziert plugin_id_hash standardmäßig immer noch jedes Plugin, daher können Sie unterschiedliche Drittanbieter-Plugins zählen.

Abfragen der Analytics API

Im Enterprise-Plan beantwortet die Analytics API „welche Plugins installiert und ruft meine Organisation auf" aus Anthropics Aufzeichnungen auf, ohne dass ein Exporter erforderlich ist. GET /v1/organizations/analytics/plugins gibt pro Plugin, pro Tag Installations- und Invokationszählungen über Claude Code und Cowork zurück, die Sie nach Benutzer, RBAC-Gruppe oder Produkt gruppieren können.

Plugin-Aktivität, die Anthropic ohne Plugin-Namen erreicht, wird in einer aggregierten Zeile third-party angezeigt. Finden Sie Plugins in der Telemetrie sagt, welche Plugins Claude Code nach Namen meldet.

Authentifizieren Sie die Anfrage mit einem API-Schlüssel, der den Bereich read:analytics hat, den ein Primary Owner wie unter Zugriff auf Daten programmgesteuert beschrieben erstellt.

Siehe die Endpoint-Referenz für die Parameter und Antwortfelder.

Nächste Schritte