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

Ukur biaya dan penggunaan plugin

Ukur biaya token plugin Claude Code, cari tahu apakah orang masih menggunakannya, dan pilih peristiwa telemetri untuk pertanyaan plugin di seluruh organisasi.

Setiap sesi di mana plugin diaktifkan mencakup nama dan deskripsi skills, agents, dan commands-nya dalam konteks Claude, dan token tersebut dihitung terhadap penggunaan pengguna terlepas dari apakah plugin digunakan atau tidak. Halaman ini menunjukkan cara melihat angka tersebut untuk plugin, cara menguranginya jika Anda memelihara plugin, dan di mana penggunaan ditampilkan sehingga Anda dapat mengetahui apakah plugin masih digunakan.

Halaman ini untuk penulis dan pemelihara plugin. Jika Anda mengelola Claude Code untuk organisasi, Measure across a fleet mencakup pertanyaan yang sama di setiap mesin.

Mulai dengan Measure what a plugin costs.

Measure what a plugin costs

Untuk melihat apa yang ditambahkan plugin ke konteks Claude, jalankan claude plugin details dengan nama plugin. Anda menjalankannya di shell Anda, bukan di prompt sesi Claude Code yang sedang berjalan. Plugin harus dimuat: diinstal, di direktori skills, atau diteruskan dengan --plugin-dir dalam perintah yang sama, seperti dalam claude --plugin-dir ./formatter plugin details formatter.

Contoh ini membaca plugin yang diinstal bernama formatter yang memiliki dua skills, satu command, satu agent, satu hook, dan satu server 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.

Setiap bagian dari output menjawab pertanyaan yang berbeda:

  • Component inventory: apa yang ditemukan Claude Code di plugin. Commands dihitung dengan skills, jadi format-all muncul di bawah Skills. Hooks dan server MCP tidak mendapatkan estimasi biaya dan tidak ada baris per-component; untuk melihat apa yang ditambahkan tools MCP plugin, jalankan /context dalam sesi dengan plugin diaktifkan dan baca kategori MCP tools.
  • Always-on: token yang ditambahkan nama dan deskripsi skills, agents, dan commands plugin ke setiap sesi di mana plugin diaktifkan, terlepas dari apakah ada yang berjalan. Ini adalah angka yang dibawa setiap pengguna, dan yang harus dikurangi.
  • Per-component: setiap baris membagi satu skill, agent, atau command menjadi bagian always-on dan biaya on-invoke, yang merupakan body yang dimuat hanya ketika component tersebut berjalan. Gunakan kolom always-on untuk menemukan component mana yang berkontribusi paling banyak.

Lower the always-on figure

Jika Anda memelihara plugin, perubahan ini mengurangi apa yang ditambahkannya ke setiap sesi. Jika Anda hanya menggunakannya, pilihan Anda adalah menonaktifkan atau mencopot pemasangannya; lihat Manage installed plugins.

Angka always-on menghitung nama setiap component ditambah description dan when_to_use frontmatter-nya. Untuk menurunkannya:

  • Perpendek deskripsi skill dan agent.
  • Pisahkan plugin besar sehingga pengguna hanya memasang component yang mereka butuhkan.

Deskripsi skill juga apa yang dicocokkan Claude terhadap permintaan, jadi yang lebih pendek dapat menghentikan skill dari pemicu. Setelah Anda memangkas deskripsi, periksa pemicu dengan grader tool_used: Skill dalam suite eval Anda.

Untuk apa yang berkontribusi setiap jenis component, lihat plugin components.

Cost shown to users before install

Plugin di marketplace resmi menunjukkan biayanya kepada pengguna sebelum pemasangan. Di /plugin, ketika pengguna menjelajahi daftar plugin marketplace dan memilih plugin, pane detail menunjukkan bagian Context cost dengan baris Every turn: dan baris When invoked:. Ketika angka always-on adalah 2.000 token atau lebih, baris Every turn: muncul disorot.

Plugin di marketplace Anda sendiri tidak memiliki bagian Context cost.

Check whether a plugin is used

Claude Code tidak melaporkan penggunaan plugin kembali ke pembuatnya. Penggunaan dicatat di mesin setiap orang yang memasang plugin, jadi apa yang dapat Anda pelajari tergantung pada hubungan Anda dengan orang-orang tersebut:

  • Anda mengelola Claude Code untuk organisasi mereka: peristiwa OpenTelemetry dan Analytics API menghitung pemasangan dan aktivasi skill di setiap mesin. Lihat Measure across a fleet.
  • Mereka adalah rekan kerja yang dapat Anda tanyai: Claude Code setiap pengguna menunjukkan kepada mereka apakah mereka masih menggunakan plugin, di empat tempat: panel /plugin, /skill-doctor, /doctor, dan /usage. Keempat perintah ini dijalankan pengguna di prompt Claude Code dalam sesi di mesin mereka sendiri.
  • Tidak satupun: Anda tidak memiliki sinyal penggunaan dari Claude Code untuk plugin tersebut.

Not used recently in `/plugin`

Di tab Installed dari /plugin, plugin yang dipasang pengguna dari marketplace bergerak di bawah header Not used recently setelah tidak digunakan selama minimal 14 hari dan 10 sesi. Detail plugin juga menunjukkan baris Last used:. Untuk apa yang dilakukan pengguna dengan header dan baris tersebut, lihat Find plugins you no longer use.

Header Not used recently tidak pernah muncul untuk:

  • Plugin yang dimuat dengan --plugin-dir atau dari direktori skills
  • Plugin yang diaktifkan melalui managed settings, atau dipasang dari seed directory
  • Plugin yang menyertakan tema, output style, monitor, atau workflow, karena ini digunakan tanpa invocation yang dilacak

Language server plugin dihitung sebagai digunakan ketika memberikan diagnostik atau menjawab permintaan navigasi kode, jadi plugin LSP yang servernya aktif dalam sesi Anda tidak terdaftar sebagai tidak digunakan.

Ketika organisasi pengguna menetapkan strictKnownMarketplaces, baik header maupun baris Last used: tidak muncul.

Find skills that never run

Jalankan /skill-doctor untuk melihat apa yang dikerjakan setiap skill Anda dan seberapa sering digunakan. Ini menandai skills yang ada dalam daftar skill Claude tetapi tidak pernah dijalankan, termasuk skills dari plugins.

Dalam sesi interaktif, laporan terbuka di tab Stats manajer /plugin. Lihat Find unused skills untuk apa yang dicakup laporan dan di mana tersedia.

Unused plugins in `/doctor`

Checkup /doctor mencantumkan setiap skill yang dipasang pengguna, server MCP, dan plugin, dan merekomendasikan menonaktifkan yang tidak digunakan. Lihat /doctor dalam referensi commands.

Usage share in `/usage`

Pada paket Pro, Max, Team, atau Enterprise, breakdown /usage mengatribusikan penggunaan terbaru kepada skills, subagents, plugins, dan server MCP sebagai bagian dari total. Lihat Using the /usage command.

Measure across a fleet

Jika Anda mengelola Claude Code untuk organisasi, Anda dapat mengukur biaya dan penggunaan plugin di setiap mesin dari salah satu sumber ini:

OpenTelemetry events for plugin installs and use

Peristiwa OpenTelemetry dan atribut ini menjawab setiap pertanyaan plugin dari backend Anda:

Pertanyaan OpenTelemetry event atau atribut
Plugin mana yang dipasang, dan dari mana claude_code.plugin_installed, satu per pemasangan
Plugin mana yang aktif dalam berapa banyak sesi claude_code.plugin_loaded, satu per plugin yang diaktifkan pada awal sesi
Skill mana yang diaktifkan, dan plugin mana yang memilikinya claude_code.skill_activated, dengan plugin.name dan marketplace.name untuk plugin skills
Apa yang dilaporkan hooks plugin claude_code.hook_plugin_metrics, dipancarkan hanya untuk hooks di plugin marketplace resmi
Apa yang dikerjakan plugin dalam pengeluaran API plugin.name dan marketplace.name pada cost counter, diatur ketika skill atau subagent aktif milik plugin

Redacted plugin names in your backend

Plugin dari marketplace resmi melaporkan nama plugin dan nama marketplace mereka ke backend Anda secara verbatim. Setiap plugin lainnya namanya diredaksi atau dihilangkan secara default, termasuk plugin dari marketplace organisasi Anda sendiri. Trust tier plugin menentukan mana.

Untuk mendapatkan nama asli pada beberapa peristiwa, atur variabel lingkungan OTEL_LOG_TOOL_DETAILS ke 1 pada mesin yang mengekspor telemetri, misalnya di blok env dari managed settings yang sama yang mengonfigurasi exporter:

Event Default Dengan OTEL_LOG_TOOL_DETAILS=1
plugin_loaded plugin.name dan marketplace.name adalah string literal third-party Nama asli
plugin_installed, skill_activated plugin.name dan marketplace.name dihilangkan; pada skill_activated, skill.name adalah custom_skill Nama asli
Cost counter plugin.name adalah third-party; marketplace.name tidak ada plugin.name asli; marketplace.name masih tidak ada

Pada plugin_loaded, plugin_id_hash masih mengidentifikasi setiap plugin secara default, jadi Anda dapat menghitung plugin pihak ketiga yang berbeda.

Query the Analytics API

Pada paket Enterprise, Analytics API menjawab "plugin mana yang dipasang dan dijalankan organisasi saya" dari catatan Anthropic, tanpa exporter yang diperlukan. GET /v1/organizations/analytics/plugins mengembalikan per-plugin, per-hari install dan invocation counts di seluruh Claude Code dan Cowork, yang dapat Anda kelompokkan berdasarkan pengguna, RBAC group, atau produk.

Aktivitas plugin yang mencapai Anthropic tanpa nama plugin muncul dalam satu baris agregat third-party. Find plugins in telemetry mengatakan plugin mana yang dilaporkan Claude Code berdasarkan nama.

Autentikasi permintaan dengan API key yang memiliki scope read:analytics, yang dibuat Primary Owner seperti dijelaskan di bawah Access data programmatically.

Lihat endpoint reference untuk parameter dan response fields.

Next steps