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. コマンドはスキルと一緒に数えられる
  2. フックと MCP サーバーには、費用の見積もりが出ない。MCP の道具の分は、プラグインを有効にしたセッションで /context を実行し、MCP tools の欄を見る
  3. 数字は目安で、実際の使用量とは少しずれる

常時分を減らす方法

自分で作っているプラグインなら、次の2つが効きます。

ただし、スキルの説明は「どの依頼で呼ばれるか」の手がかりでもあります。短くしすぎると、呼ばれなくなることがあります。短くしたあとは、評価(eval)で呼び出されるかを確かめるのが安全です。評価の仕組みは プラグインの評価(eval) で説明しています。

利用者の側から見ると、減らす方法は無効にするか、外すかの2つです。

公式のマーケットプレイスのプラグインは、入れる前に費用が見えます。 /plugin で選ぶと詳細に Context cost の欄が出て、常時分が2,000トークン以上のときは強調されます。自分たちのマーケットプレイスのプラグインには、この欄は出ません。

使われているかを調べる

Claude Code は、プラグインの使われ方を作者へ送り返しません。記録は、入れた人のパソコンに残ります。確かめ方は相手によって変わります。

立場調べ方
組織の管理者計測のイベント(OpenTelemetry)と Analytics API で、全員分を集計
相談できる同僚各自が /plugin・/skill-doctor・/doctor・/usage を実行
どちらでもないClaude Code からは分からない

各自のパソコンで使う4つのコマンドを整理します。

「Not used recently」が出ない場合もあります。プラグインのフォルダを直接指定した場合、管理設定で有効にされた場合、テーマや出力スタイルなど、呼び出しを数えられない部品が入っている場合です。組織が入れられるマーケットプレイスを制限しているときも出ません。

組織全体の計測

管理者は、2つの方法で全員分を測れます。

「どのプラグインが入っているか」と「実際に使われたか」は別のイベントです。導入数だけを見て、使われていないものを残さないようにします。社内での配り方は プラグインの依存関係 の記事も参考になります。

まとめ

  1. プラグインは有効なだけで、名前と説明の分の使用量を毎回使う
  2. claude plugin details プラグイン名 で、常時分と呼び出し時の分の目安が見える
  3. 減らすには説明を短くするか、プラグインを分ける。短くしたら呼ばれるかを確かめる
  4. 使われているかは /plugin・/skill-doctor・/doctor・/usage で、組織ならテレメトリで調べる

出典:Measure plugin cost and usage(公式ドキュメント)

永上裕之

ユニコスクール株式会社 代表取締役。AIエージェント専門のスクール&コミュニティを運営しています。

この記事はAIを使って下書きし、著者が事実確認・加筆しています。ツールの機能や料金は変わることがあるため、最新の情報は各社の公式ページでご確認ください。

関連する記事