Claude Codeプラグインのトークン費用を測る方法

この記事の要点
- プラグインを有効にすると、使わなくても、スキル・エージェント・コマンドの名前と説明が毎回の文脈に入り、使用量を使う
- claude plugin details を実行すると、常時分とそのつど分の目安が見える。常時分は説明を短くするか、プラグインを分けて減らす
- 使われているかは、/plugin・/skill-doctor・/doctor・/usage の4か所と、組織ならテレメトリで調べられる
活用例:社内で配っているプラグインの使用量への影響を測り、使われていないものを整理する
- 部署
- 情報システム・開発基盤
- 使うもの
- Claude Code の claude plugin details と /doctor・/usage
- AIに任せる
- 各プラグインの費用の一覧づくり
- 人が決める
- 外すプラグインの判断・説明を短くする基準
Claude Code のプラグインは便利ですが、入れるほど、毎回の会話に載る文章も増えます。使っていないプラグインでも、有効になっているだけで使用量を使っているのをご存じでしょうか。
この記事では、公式ドキュメント「Measure plugin cost and usage」(2026年11月16日確認)にもとづいて、費用の測り方と、使われているかの調べ方をまとめます。
結論:有効なだけで、名前と説明が毎回入る
プラグインが有効なセッションでは、中にあるスキル・エージェント・コマンドの名前と説明が、Claude の文脈に毎回含まれます。ほかの部分(スキルの本文など)は、使われたときだけ読み込まれます。
つまり費用は2種類あります。
- 常時分:毎回のセッションに必ず加わる。名前と説明の分
- 呼び出し時:スキルやエージェントが動くたびに加わる。本文の分
減らすべきなのは、全員が毎回払っている常時分です。
測り方:claude plugin details
ターミナル(Claude Code の画面の中ではなく普通のシェル)で、プラグイン名を付けて実行します。プラグインは読み込まれている必要があります(インストール済み、スキルのフォルダ内、または同じコマンドで --plugin-dir を付ける)。
claude plugin details formatter
公式の例では、次のような見やすい報告が出ます。
- 部品の一覧(スキル3・エージェント1・フック1・MCPサーバー1)
- 見込みのトークン:常時分の合計(例は約146トークン)
- 部品ごとの表:常時分と、呼び出し時の分
読み方の要点は3つです。
- コマンドはスキルと一緒に数えられる
- フックと MCP サーバーには、費用の見積もりが出ない。MCP の道具の分は、プラグインを有効にしたセッションで
/contextを実行し、MCP tools の欄を見る - 数字は目安で、実際の使用量とは少しずれる
常時分を減らす方法
自分で作っているプラグインなら、次の2つが効きます。
- スキルやエージェントの説明(description と when_to_use)を短くする
- 大きなプラグインを分けて、必要な部品だけ入れてもらえるようにする
ただし、スキルの説明は「どの依頼で呼ばれるか」の手がかりでもあります。短くしすぎると、呼ばれなくなることがあります。短くしたあとは、評価(eval)で呼び出されるかを確かめるのが安全です。評価の仕組みは プラグインの評価(eval) で説明しています。
利用者の側から見ると、減らす方法は無効にするか、外すかの2つです。
公式のマーケットプレイスのプラグインは、入れる前に費用が見えます。 /plugin で選ぶと詳細に Context cost の欄が出て、常時分が2,000トークン以上のときは強調されます。自分たちのマーケットプレイスのプラグインには、この欄は出ません。
使われているかを調べる
Claude Code は、プラグインの使われ方を作者へ送り返しません。記録は、入れた人のパソコンに残ります。確かめ方は相手によって変わります。
| 立場 | 調べ方 |
|---|---|
| 組織の管理者 | 計測のイベント(OpenTelemetry)と Analytics API で、全員分を集計 |
| 相談できる同僚 | 各自が /plugin・/skill-doctor・/doctor・/usage を実行 |
| どちらでもない | Claude Code からは分からない |
各自のパソコンで使う4つのコマンドを整理します。
- /plugin の「Not used recently」:14日以上かつ10セッション以上使っていないプラグインが、この見出しの下に移る。最後に使った日も出る
- /skill-doctor:スキルごとの費用と、使われた回数を出す。一度も使われていないスキルに印がつく
- /doctor:自分で入れたスキル・MCP・プラグインのうち、使われなかったものを無効にするよう勧める
- /usage:有料プランで、最近の使用量を、スキル・サブエージェント・プラグイン・MCP ごとの割合で見せる
「Not used recently」が出ない場合もあります。プラグインのフォルダを直接指定した場合、管理設定で有効にされた場合、テーマや出力スタイルなど、呼び出しを数えられない部品が入っている場合です。組織が入れられるマーケットプレイスを制限しているときも出ません。
組織全体の計測
管理者は、2つの方法で全員分を測れます。
- OpenTelemetry のイベント:自社の集計の場所へ送る(先に送り先の設定が必要)
- Analytics API:Anthropic 側の記録から取れる。送り先の設定は不要
「どのプラグインが入っているか」と「実際に使われたか」は別のイベントです。導入数だけを見て、使われていないものを残さないようにします。社内での配り方は プラグインの依存関係 の記事も参考になります。
まとめ
- プラグインは有効なだけで、名前と説明の分の使用量を毎回使う
claude plugin details プラグイン名で、常時分と呼び出し時の分の目安が見える- 減らすには説明を短くするか、プラグインを分ける。短くしたら呼ばれるかを確かめる
- 使われているかは /plugin・/skill-doctor・/doctor・/usage で、組織ならテレメトリで調べる
出典:Measure plugin cost and usage(公式ドキュメント)
この記事はAIを使って下書きし、著者が事実確認・加筆しています。ツールの機能や料金は変わることがあるため、最新の情報は各社の公式ページでご確認ください。


