Claude Code

Claude Code 插件成本:14 天未用仍占上下文

官方插件文档:启用的插件每轮常驻名称与描述,示例约 146 tok;满 14 天且 10 个会话未用才进「最近未使用」。附成本归属字段与市场白名单治理。

2026-11-12 17:34:56 · 主编:刘立永

Claude Code 2.1.319 收紧了插件市场接管:声明过的市场名不能再从别处添加,声明市场列出的插件一律从它重装。影响更日常的是成本口径——官方插件文档写明,启用的插件哪怕一次没触发,其技能、命令、子代理的名称与描述每轮都进上下文,额度按会话累积,与用不用无关。

官方口径:常驻的只是名称和描述

官方文档《Measure plugin cost and usage》写明:每个启用插件的会话都会把 skills、agents、commands 的名称与描述放进上下文,计入用量并挤占窗口,即使插件什么都没跑;全文只在被使用时才加载。MCP 服务器每轮新增什么遵循 MCP tool search,不是无条件全量。常见误读是「整个插件每轮都进上下文」,官方说法窄得多。

数字怎么看:官方示例里 claude plugin details formatter 输出 Always-on: ~146 tok added to every session(文档示例值,不是实测);安装前 /plugin 的 Marketplaces 标签显示 Context cost 区块,分 Every turn: 与 When invoked: 两行,Always-on 达到 2000 tokens 及以上时 Every turn: 会高亮。这个数由每个组件的 name 加 description 与 when_to_use frontmatter 构成,想降下来只能缩短描述或拆分大插件。Hooks 与 MCP servers 不给成本估算——hook 是 harness-only、无模型上下文成本,MCP 工具 schema 在运行时解析;要看 MCP 实际加了多少,在启用该插件的会话里跑 /context 读 MCP tools 行。该命令在 shell 里跑。

成本归属:把花费记到插件和市场

同一份官方页给出一条容易被忽略的字段:API 花费的成本计数器上有 plugin.name 与 marketplace.name,当活跃的 skill 或 subagent 属于某个插件时设置。口径要看清——它归的是「插件被触发时的花费」,常驻那份开销不单独拆出来。另一层是网关侧:2.1.317 起提供 GET /v1/organizations/analytics/cost,可按开发者、按天、按 IdP 组读历史花费(本频道 11 月 11 日稿已展开,此处只作衔接)。两层回答的是不同问题:谁的人花了钱,与哪个插件花了钱,做预算时别混成一张表。

14 天且 10 个会话:清理阈值别记错

官方原文是 at least 14 days and 10 sessions——至少 14 天且 10 个会话未使用,插件才进 /plugin 的 Installed 页 Not used recently 分组,详情页同时出现 Last used: 行。是「且」不是「或」。更要注意排除项:用 --plugin-dir 或 skills 目录加载的、由 managed settings 启用或 seed 目录挂载的、含 theme/output style/monitor/workflow 的插件,都不进这个分组;LSP 服务器只要给出诊断或响应代码导航就算 used;组织一旦设了 strictKnownMarketplaces,分组和 Last used: 行都不显示。含义很实际:靠分组做季度清理,会漏掉共享基线里那批插件,而它们照样每轮占上下文。

权限与白名单:官方原文与第三方说法分开看

官方 overview 页的原文是 what the plugin runs, it runs as you、can run code with your user privileges,以及插件定义的 MCP servers 在启用它的每个会话旁运行、hooks 在各自事件上触发。「hooks 与 MCP 在沙箱外运行」是第三方技术说明的措辞,官方 overview 页没写 sandbox,引用时须标成二手。治理侧官方只给了概括句:组织可通过 managed settings 允许或阻止市场、强制安装插件、关闭 session-only loading。2.1.319 的 CHANGELOG 补了细节:extraKnownMarketplaces 声明过的名字不能再从别处添加,来自别处的条目隐藏,声明市场列出的插件从它重装;被接管来源的数据按 cleanupPeriodDays 暂存,options 与 secrets 要跑 claude plugin restore-set-aside 才恢复。

给企业技术团队的三条动作

第一,先量后装、按清单管。安装前看 Context cost,安装后在 shell 跑 claude plugin details <name记下 Always-on,按项目建一份插件基线;季度用 Not used recently 清理,但 managed/seed 目录那批单独盘,别指望分组会列出来。

第二,成本拆两层。把 plugin.name、marketplace.name 接进 OpenTelemetry 成本计数器,与网关按人、按 IdP 组的报表分开看;按项目分账号或分预算池,避免一个共享账号把几个客户的花费混成一笔。

第三,凭据与共享环境配置保护同步做。插件以你的用户权限运行,装第三方市场前审 hooks 文件与 MCP 配置;用 strictKnownMarketplaces、blockedMarketplaces 做白名单,把 settings 基线纳入版本管理与变更审计,借升级窗口做一轮凭据轮换。

我们给山东的制造、商贸客户做用友、金蝶、管家婆等 ERP 实施和系统集成时,最怕「装了组件没人记得、月底账对不上」。后来统一按清单管:谁装、装在哪些机器、走哪个账号,和 ERP 授权与账套一起进变更记录。编码 Agent 的插件与 MCP 也照这套办法:先量后装、按项目归属、定期清。

参考来源:
1. Anthropic 官方文档《Measure plugin cost and usage》(2026-11-12 检索,成本数字与清理阈值) https://code.claude.com/docs/en/plugins/measure.md
2. Anthropic 官方文档《Plugins overview》(2026-11-12 检索,权限与上下文口径) https://code.claude.com/docs/en/plugins
3. GitHub anthropics/claude-code CHANGELOG(截至 2026-11-12 检索,2.1.319/2.1.317 条目) https://github.com/anthropics/claude-code/blob/main/CHANGELOG.md
4. SSD Nodes《Claude Code plugins: what they are and cost》(2026-11-12 检索,第三方口径) https://ssdnodes.com/learn/claude-code-plugins-explained
5. AI Business Weekly《Claude Code Plugins: How to Install, Use and Build Them》(2026-11-12 检索,第三方转述) https://aibusinessweekly.net/p/claude-code-plugins