SpyBara
Go Premium

plugins/measure.md 2026-09-24 22:57 UTC to 2026-09-25 23:58 UTC

This page contains 193 additions and 0 deletions.

2026
Fri 25 23:58

プラグインのコストと使用状況を測定する

Claude Code プラグインのトークンコスト、人々がまだそれを使用しているかどうかを確認し、組織全体のプラグイン質問のテレメトリイベントを選択します。

プラグインが有効になっているすべてのセッションには、そのスキル、エージェント、コマンドの名前と説明が Claude のコンテキストに含まれ、プラグインが実際に使用されるかどうかに関わらず、これらのトークンはユーザーの使用量にカウントされます。このページでは、プラグインのこの数値を確認する方法、プラグインを保守している場合にそれを削減する方法、および使用状況がどこに表示されるかを示し、プラグインがまだ使用されているかどうかを判断できます。

このページはプラグイン作成者とメンテナー向けです。組織の Claude Code を管理している場合は、フロート全体で測定するで、すべてのマシン全体で同じ質問をカバーしています。

プラグインのコストを測定するから始めてください。

プラグインのコストを測定する

プラグインが Claude のコンテキストに何を追加するかを確認するには、プラグインの名前を指定して claude plugin details を実行します。これは実行中の Claude Code セッションのプロンプトではなく、シェルで実行します。プラグインはロードされている必要があります：インストール済み、スキルディレクトリ内、または同じコマンドで --plugin-dir で渡されている必要があります。例えば claude --plugin-dir ./formatter plugin details formatter のようにです。

この例は、2 つのスキル、コマンド、エージェント、フック、MCP サーバーを持つ formatter という名前のインストール済みプラグインを読み込みます：

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 がプラグインで見つけたもの。コマンドはスキルと一緒にカウントされるため、format-all は Skills の下に表示されます。フックと MCP サーバーはコスト推定値を取得せず、コンポーネント行もありません。プラグインの MCP ツールが何を追加するかを確認するには、プラグインが有効になっているセッションで /context を実行し、MCP tools カテゴリを読んでください。
  • Always-on：プラグインのスキル、エージェント、コマンドの名前と説明が、プラグインが有効になっているすべてのセッションに追加するトークン。何も実行されるかどうかに関わらず、これはすべてのユーザーが持つ数値であり、削減する必要があるものです。
  • Per-component：各行は 1 つのスキル、エージェント、またはコマンドを、その always-on シェアと on-invoke コストに分割します。on-invoke コストはそのコンポーネントが実行されるときにのみロードされる本体です。always-on 列を使用して、どのコンポーネントが最も貢献しているかを見つけます。

always-on の数値を下げる

プラグインを保守している場合、これらの変更はそれがすべてのセッションに追加するものを削減します。それを使用するだけの場合、オプションはそれを無効にするか、アンインストールすることです。インストール済みプラグインを管理するを参照してください。

always-on の数値は、各コンポーネントの名前とその description および when_to_use frontmatter をカウントします。それを下げるには：

  • スキルとエージェントの説明を短くします。
  • 大きなプラグインを分割して、ユーザーが必要なコンポーネントのみをインストールできるようにします。

スキルの説明は、Claude がリクエストと照合するものでもあるため、短いものはスキルのトリガーを停止できます。説明をトリミングした後、eval スイートで tool_used: Skill grader を使用してトリガーをチェックしてください。

各コンポーネントタイプが何を貢献するかについては、プラグインコンポーネントを参照してください。

インストール前にユーザーに表示されるコスト

公式マーケットプレイスのプラグインは、インストール前にユーザーにコストを表示します。/plugin では、ユーザーがマーケットプレイスのプラグインリストを参照してプラグインを選択すると、詳細ペインに Context cost セクションが表示され、Every turn: 行と When invoked: 行があります。always-on の数値が 2,000 トークン以上の場合、Every turn: 行がハイライト表示されます。

独自のマーケットプレイスのプラグインには Context cost セクションがありません。

プラグインが使用されているかどうかを確認する

Claude Code はプラグインの使用状況をその作成者に報告しません。使用状況はプラグインをインストールした各人のマシンに記録されるため、学べることはそれらの人との関係に依存します：

  • 組織の Claude Code を管理している：OpenTelemetry イベントと Analytics API は、すべてのマシン全体でインストールとスキルアクティベーションをカウントします。フロート全体で測定するを参照してください。
  • 質問できるチームメイト：各ユーザーの独自の Claude Code は、プラグインをまだ使用しているかどうかを 4 つの場所で表示します：/plugin パネル、/skill-doctor、/doctor、および /usage。これら 4 つはすべて、ユーザーが独自のマシン上のセッションで Claude Code プロンプトで実行するコマンドです。
  • どちらでもない：そのプラグインの Claude Code からの使用信号がありません。

`/plugin` で最近使用されていない

/plugin の Installed タブで、ユーザーがマーケットプレイスからインストールしたプラグインは、少なくとも 14 日間と 10 セッション未使用になると、Not used recently ヘッダーの下に移動します。プラグインの詳細には Last used: 行も表示されます。ユーザーがそのヘッダーと行で何をするかについては、使用しなくなったプラグインを見つけるを参照してください。

Not used recently ヘッダーは以下の場合には表示されません：

  • --plugin-dir またはスキルディレクトリからロードされたプラグイン
  • 管理設定を通じて有効にされたプラグイン、またはシードディレクトリからマウントされたプラグイン
  • テーマ、出力スタイル、モニター、またはワークフローを含むプラグイン。これらは追跡されたインボケーションなしで使用中であるため

プラグインの言語サーバーは、診断を提供するか、コードナビゲーションリクエストに応答するときに使用中としてカウントされるため、サーバーがセッションでアクティブな LSP プラグインは未使用としてリストされません。

ユーザーの組織が strictKnownMarketplaces を設定する場合、ヘッダーも Last used: 行も表示されません。

実行されないスキルを見つける

/skill-doctor を実行して、各スキルのコストと使用頻度を確認します。Claude のスキルリストに含まれているが、プラグインからのスキルを含め、呼び出されたことのないスキルにフラグを立てます。

インタラクティブセッションでは、レポートは /plugin マネージャーの Stats タブで開きます。レポートがカバーする内容と利用可能な場所については、未使用のスキルを見つけるを参照してください。

`/doctor` で未使用のプラグイン

/doctor チェックアップは、各ユーザーがインストールしたスキル、MCP サーバー、プラグインをリストし、使用されなかったものを無効にすることを推奨します。コマンドリファレンスの /doctor を参照してください。

`/usage` での使用状況シェア

Pro、Max、Team、または Enterprise プランでは、/usage の内訳は最近の使用状況をスキル、サブエージェント、プラグイン、MCP サーバーの合計のシェアとして属性付けします。/usage コマンドを使用するを参照してください。

フロート全体で測定する

組織の Claude Code を管理している場合、以下のいずれかのソースからすべてのマシン全体でプラグインのコストと使用状況を測定できます：

プラグインのインストールと使用のための OpenTelemetry イベント

これらの OpenTelemetry イベントと属性は、バックエンドから各プラグイン質問に答えます：

質問 OpenTelemetry イベントまたは属性
どのプラグインがインストールされ、どこからインストールされるか claude_code.plugin_installed、インストールごとに 1 つ
どのプラグインが何個のセッションでアクティブであるか claude_code.plugin_loaded、セッション開始時に有効なプラグインごとに 1 つ
どのスキルがアクティベートされ、どのプラグインがそれを所有しているか claude_code.skill_activated、プラグインスキルの plugin.name と marketplace.name を使用
プラグインのフックが報告するもの claude_code.hook_plugin_metrics、公式マーケットプレイスプラグインのフックに対してのみ発行
プラグインが API 支出でコストするもの コストカウンターの plugin.name と marketplace.name、アクティブなスキルまたはサブエージェントがプラグインに属する場合に設定

バックエンドでのプラグイン名の編集

公式マーケットプレイスのプラグインは、プラグイン名とマーケットプレイス名をバックエンドに逐語的に報告します。他のすべてのプラグインの名前は、組織独自のマーケットプレイスのプラグインを含め、デフォルトでは編集されるか省略されます。プラグインの信頼レベルがどれを決定するかを決定します。

一部のイベントで実名を取得するには、テレメトリをエクスポートするマシンで OTEL_LOG_TOOL_DETAILS 環境変数を 1 に設定します。例えば、エクスポーターを設定する同じ管理設定の env ブロックで：

イベント デフォルト 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 のレコードから「組織がどのプラグインをインストールして呼び出すか」に答え、エクスポーターは不要です。GET /v1/organizations/analytics/plugins は Claude Code と Cowork 全体でプラグインごと、1 日ごとのインストールと呼び出しカウントを返し、ユーザー、RBAC グループ、または製品でグループ化できます。

プラグイン名なしで Anthropic に到達するプラグインアクティビティは、1 つの集約 third-party 行に表示されます。テレメトリでプラグインを見つけるは、Claude Code が名前で報告するプラグインを示します。

read:analytics スコープを持つ API キーでリクエストを認証します。これは、プログラムでデータにアクセスするの下で説明されているように、プライマリオーナーが作成します。

パラメーターと応答フィールドについては、エンドポイントリファレンスを参照してください。

次のステップ