测量插件成本和使用情况
测量 Claude Code 插件的令牌成本，了解人们是否仍在使用它，并为组织范围的插件问题选择遥测事件。
启用插件的每个会话都会在 Claude 的上下文中包含其 skills、agents 和 commands 的名称和描述，这些令牌会计入用户的使用情况，无论插件是否被使用。本页面展示了如何查看插件的这个数字、如果你维护插件如何减少它，以及使用情况在哪里显示，以便你可以判断插件是否仍在被使用。
本页面适用于插件作者和维护者。如果你为组织管理 Claude Code，跨机队测量涵盖了每台机器上的相同问题。
从测量插件的成本开始。
测量插件的成本
要查看插件添加到 Claude 上下文的内容，请使用插件的名称运行claude plugin details。你在 shell 中运行它，而不是在运行的 Claude Code 会话的提示符处。插件必须被加载：已安装、在 skills 目录中，或通过同一命令中的 --plugin-dir 传递，如 claude --plugin-dir ./formatter plugin details formatter。
此示例读取一个名为 formatter 的已安装插件，该插件有两个 skills、一个 command、一个 agent、一个 hook 和一个 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.
输出的每个部分回答了一个不同的问题：
- Component inventory：Claude Code 在插件中找到的内容。Commands 与 skills 一起计数，所以
format-all出现在Skills下。Hooks 和 MCP 服务器没有成本估计和每个组件行；要查看插件的 MCP 工具添加的内容，请在启用插件的会话中运行/context，并阅读MCP tools类别。 - Always-on：插件的 skills、agents 和 commands 的名称和描述添加到启用插件的每个会话中的令牌，无论是否有任何东西运行。这是每个用户携带的数字，也是要减少的数字。
- Per-component：每一行将一个 skill、agent 或 command 分成其 always-on 份额和其 on-invoke 成本，后者是仅在该组件运行时加载的主体。使用 always-on 列来找出哪个组件贡献最多。
降低 always-on 数字
如果你维护插件，这些更改会减少它添加到每个会话的内容。如果你只是使用它，你的选择是禁用或卸载它；请参阅管理已安装的插件。
always-on 数字计算每个组件的名称加上其 description 和 when_to_use frontmatter。要降低它：
- 缩短 skill 和 agent 描述。
- 分割大型插件，以便用户只安装他们需要的组件。
skill 的描述也是 Claude 匹配请求的内容，所以较短的描述可以阻止 skill 触发。修剪描述后，使用 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 计算每台机器上的安装和 skill 激活。请参阅跨机队测量。
- 他们是你可以询问的队友：每个用户自己的 Claude Code 在四个地方向他们显示他们是否仍在使用插件：
/plugin面板、/skill-doctor、/doctor和/usage。所有四个都是用户在自己机器上的会话中在 Claude Code 提示符处运行的命令。 - 都不是：你没有来自 Claude Code 的该插件的使用信号。
`/plugin` 中最近未使用
在 /plugin 的Installed选项卡上，用户从市场安装的插件在至少 14 天和 10 个会话未使用后，会移到Not used recently标题下。插件的详细信息也显示一个 Last used: 行。有关用户对该标题和行的处理，请参阅查找你不再使用的插件。
Not used recently标题永远不会出现在：
- 使用
--plugin-dir加载或从 skills 目录加载的插件 - 通过托管设置启用或从种子目录挂载的插件
- 包含主题、输出样式、监视器或工作流的插件，因为这些在没有跟踪调用的情况下使用
插件的语言服务器在传递诊断或回答代码导航请求时计为已使用，所以一个 LSP 插件，其服务器在你的会话中处于活动状态，不会被列为未使用。
当用户的组织设置strictKnownMarketplaces时，标题和 Last used: 行都不会出现。
查找永远不运行的 skills
运行 /skill-doctor 以查看你的每个 skill 的成本以及它被使用的频率。它标记在 Claude 的 skill 列表中但从未被调用的 skills，包括来自插件的 skills。
在交互式会话中，报告在 /plugin 管理器的Stats选项卡中打开。请参阅查找未使用的 skills了解报告涵盖的内容以及它在哪里可用。
`/doctor` 中未使用的插件
/doctor 检查列出每个用户安装的 skill、MCP 服务器和插件，并建议禁用未使用的插件。请参阅命令参考中的 /doctor。
`/usage` 中的使用情况份额
在 Pro、Max、Team 或 Enterprise 计划上，/usage 分解将最近的使用情况归因于 skills、subagents、插件和 MCP 服务器，作为总数的份额。请参阅使用 /usage 命令。
跨机队测量
如果你为组织管理 Claude Code，你可以从以下任一来源跨每台机器测量插件成本和使用情况：
- OpenTelemetry 事件：Claude Code 在你配置导出器后将这些导出到你自己的后端。请参阅插件安装和使用的 OpenTelemetry 事件。
- Analytics API：来自 Anthropic 的记录，无需导出器。请参阅查询 Analytics API。
插件安装和使用的 OpenTelemetry 事件
这些 OpenTelemetry 事件和属性从你的后端回答每个插件问题：
| 问题 | OpenTelemetry 事件或属性 |
|---|---|
| 安装了哪些插件，来自哪里 | claude_code.plugin_installed，每次安装一个 |
| 哪些插件在多少个会话中处于活动状态 | claude_code.plugin_loaded，会话开始时每个启用的插件一个 |
| 哪些 skills 激活，哪个插件拥有它们 | claude_code.skill_activated，带有插件 skills 的 plugin.name 和 marketplace.name |
| 插件的 hooks 报告什么 | claude_code.hook_plugin_metrics，仅为官方市场插件中的 hooks 发出 |
| 插件在 API 支出中的成本 | 成本计数器上的 plugin.name 和 marketplace.name，在活跃 skill 或 subagent 属于插件时设置 |
后端中的编辑插件名称
来自官方市场的插件将其插件名称和市场名称逐字报告到你的后端。所有其他插件的名称默认被编辑或省略，包括来自你组织自己市场的插件。插件的信任等级决定了哪个。
要在某些事件上获取真实名称，请在导出遥测的机器上将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 的每个插件、每天的安装和调用计数，你可以按用户、RBAC 组或产品分组。
到达 Anthropic 而没有插件名称的插件活动出现在一个聚合 third-party 行中。在遥测中查找插件说明 Claude Code 按名称报告的插件。
使用具有 read:analytics 范围的 API 密钥对请求进行身份验证，Primary Owner 按照以编程方式访问数据中的描述创建。
有关参数和响应字段，请参阅端点参考。
后续步骤
- 使用 evals 测试插件：测量插件引导 Claude 的可靠性，而不仅仅是它的成本
- 降低 always-on 数字：在插件中更改什么以减少其每轮成本
- 插件安全和信任：哪些遥测字段携带插件名称以及何时被编辑
- 监视使用情况：完整的 OpenTelemetry 事件参考