Claude Code 插件新手指南:3 个市场、3 种范围,装好第一个插件

Anthropic 官方维护的 Claude Code 插件目录 anthropics/claude-plugins-official，从 10 月 16 日起连着三天上了 GitHub 的 trending 榜，10 月 18 日我们查到它有 42072 颗星。仓库简介写的是：由 Anthropic 管理的官方高质量 Claude Code 插件目录。

按官方文档的说法，安装插件会把它的 skills、agents、hooks 和 MCP servers 添加到你机器上的 Claude Code。Anthropic 的支持地区政策写明，Claude Code 只在列出的国家和地区提供，这份列表里没有中国大陆和香港，能不能用以官方页面为准。文中的命令和按钮名都取自 10 月 18 日的官方中文文档。

01｜先分清三个官方市场

市场是插件的目录，由仓库里的 .claude-plugin/marketplace.json 文件定义。Anthropic 为 Claude Code 发布了三个通用市场，分别是官方、社区和演示，各自放在一个 GitHub 仓库里。装插件时，@ 后面输入的是市场名称。

官方市场叫 claude-plugins-official；社区市场叫 claude-community，这个名字和它的仓库名 claude-plugins-community 不一样；演示市场叫 claude-code-plugins。官方市场收 Anthropic 维护的插件，也收合作伙伴和其他作者的插件。社区市场是作者提交给 Anthropic 的第三方插件。演示市场只有一小组示例插件，用来展示插件可以包含什么。

官方市场不用自己加，你第一次启动交互式终端会话时，Claude Code 会替你添加它。社区和演示市场要在会话里手动添加，命令分别是 /plugin marketplace add anthropics/claude-plugins-community 和 /plugin marketplace add anthropics/claude-code。

如果教程或较旧的说明让你运行后面这条，它添加的是演示市场，不是官方市场。演示市场的大多数插件在官方市场里也有同名的一份，比如 code-review、feature-dev、commit-commands 和 security-guidance。文档建议从 claude-plugins-official 安装这些，这样不会装出两个副本。

官方市场列出的内容大部分来自合作伙伴和其他作者，工具供应商发布插件，把 Claude Code 连到自家的服务上。Anthropic 自己维护的是一个较小的集合，例如 commit-commands、code-review、feature-dev 和语言服务器插件。目录经常变化，所以文档没有列出清单。

要看里面有什么，可以在会话里用 /plugin 的 Discover 选项卡搜索，也可以在网页上浏览 Claude Marketplace（claude.com/marketplace/plugins），那里显示安装次数，部分插件标着 Anthropic verified。许多流行插件不在任何 Anthropic 市场里，而在作者自己的市场。Anthropic 不审查第三方市场，添加之前先读文档里插件安全和信任那一页。

02｜在终端里装第一个插件

官方文档用 commit-commands 做示例，这个插件添加了提交、推送和打开拉取请求的命令。装别的插件步骤相同，把出现 commit-commands 和 claude-plugins-official 的地方换成它的插件名和市场名就行。先在你的项目里用 claude 启动 Claude Code，然后运行带插件名和市场名的安装命令：

/plugin install commit-commands@claude-plugins-official

在会话里，这条命令不会马上安装。它会打开 /plugin 面板，停在这个插件的详情页，让你先查看、再选择范围。只想逛一逛的话，运行不带插件名的 /plugin，面板会在 Discover 选项卡上打开，列出你的市场里的插件。在这里输入文字可以搜索，在某个插件上按 Enter 就打开它的详情。

详情页显示插件的描述，还可能显示三项内容。Will install 列出插件要添加的命令、agents、skills、hooks，以及 MCP 和 LSP 服务器。Last updated 只对官方市场里的插件显示。Context cost 也只有官方市场的插件才有，它给出两个 token 估算：Every turn 是插件加进你发送的每条消息里的内容，When invoked 是它的 skills 和 agents 被 Claude 加载后再加的内容。

这组估算在你按市场名打开插件时出现，比如上面那条命令，从 Marketplaces 选项卡打开也会出现，从 Discover 列表进来的详情页不显示。插件能运行 hooks 和 MCP 服务器，所以装之前把这一页读完。

接着从三个安装选项里挑一个。Install for you (user scope) 让你在这台机器上的每个项目里都能用这个插件。如果点的是 Install for all collaborators on this repository (project scope)，在这个仓库里工作的每个人都会启用它。第三个选项 Install for you, in this repo only (local scope) 只给你自己，也只在这个仓库里生效。范围定下来以后，Claude Code 会安装插件和它声明的依赖项，然后打印一段安装摘要。一个人自己学着用，我们选 user scope 就够了。

摘要的最后一句告诉你，插件在这次会话里能不能用。看到 Plugin is now active.，说明已经激活，不用重新加载。如果它后面还跟着 Its bundled MCP server needs configuration before it can start，插件已激活，但它捆绑的 MCP 服务器要先设置，在 /plugin 的 Installed 选项卡选中插件，再选 Configure。

看到 Run /reload-plugins to apply.，面板会关闭，Claude Code 替你重新加载；如果重新加载会让提示缓存失效，它会警告，并让插件保持待处理，这时运行 /reload-plugins --force 能强制激活，代价是一次不走缓存的请求。看到 The plugin couldn't be loaded，去 Errors 选项卡看原因。

最后确认插件在工作。输入 /，在插件名下面找它的 skill，格式是 /<plugin>:<skill>，装好 commit-commands 后会出现 /commit-commands:commit。另外两个地方也会列出它：/plugin 的 Installed 选项卡列出插件和它的范围；在 shell 里运行 claude plugin list，打印的是同一份列表，带 Version、Scope 和 Status 几行。

假如你是在网页 claude.com/marketplace 上找到的插件，它的 Claude Code 按钮复制下来的是 shell 形式的安装命令 claude plugin install <name>@claude-plugins-official。

03｜三种范围分别写进哪个文件

范围决定谁能用到这个插件，也决定哪个设置文件把它记成已启用。user scope 的条目写进 ~/.claude/settings.json 里的 enabledPlugins。project scope 的条目写进仓库的 .claude/settings.json，由你提交。

提交后协作者那边会打开这个插件，但不会把它下载到他们的机器上，所以每个协作者还要自己运行一次 claude plugin install <name>@<marketplace> --scope project。local scope 的条目写进 .claude/settings.local.json。同一个插件在几个范围里都设置过时，本地设置覆盖项目设置，项目设置覆盖用户设置。

有些插件的作者用 defaultEnabled 字段把它设成默认关闭。这样的插件装上后保持关闭，要在 shell 里运行 claude plugin enable <name>，或者在会话里 /plugin 的 Installed 选项卡把它打开。终端、桌面应用的本地会话，以及同一台电脑上的 VS Code 扩展，读的是同一批设置文件，所以你在其中一处按 user scope 装的插件，另外两处也能用。

04｜桌面应用、VS Code 和云会话

在桌面应用 Code 选项卡的本地或 SSH 会话里，点提示框旁边的 + 按钮，选 Plugins，再选 Add plugin，插件浏览器会打开。找到 commit-commands 选中它，再选范围：你的用户账户、这个项目，或者仅本地。以后要启用、禁用或卸载，走 + > Plugins > Manage plugins。

在 VS Code 的 Claude Code 面板里，在提示框输入 /plugins 打开 Manage plugins，在 Plugins 选项卡搜索 commit-commands，点 Install，再选范围。选项卡里一个插件都没有时，先在 Marketplaces 选项卡添加 anthropics/claude-plugins-official。改动直接用到打开的会话上，不用重启。

云会话没有插件浏览器，浏览器里的 claude.ai/code 也算在内。它不会加载你在自己机器上装的插件，也不会加载仓库 .claude/settings.json 里打开的插件。JetBrains 插件是在 IDE 的终端里运行 Claude Code，所以照终端的步骤做。用 claude -p 这类非交互方式运行时，/plugin 不起作用，Claude 会回复 /plugin isn't available in this environment.，已经装好的插件照常加载，管理它们要用 shell 里的 claude plugin 命令。

05｜从 shell 安装，添加别的市场

不想打开会话的时候，比如写进初始化脚本，可以直接在 shell 里运行 claude plugin install。它默认装到 user scope，传 --scope project 或 --scope local 可以改。装好的插件在你下次启动 Claude Code 时加载，或者在已打开的会话里运行 /reload-plugins 时加载。在一台还没人打开过交互式会话的新机器上，官方市场还没注册，脚本要先添加它，再安装：

claude plugin marketplace add anthropics/claude-plugins-official

claude plugin install commit-commands@claude-plugins-official

插件不在官方市场里时才需要添加市场，比如同事发布的插件。每个市场只添加一次，之后它的插件出现在 Discover 选项卡，用 /plugin install <plugin>@<marketplace> 安装。在会话里运行 /plugin marketplace add，后面跟市场的来源。

GitHub 仓库写 owner/repo，可以加 #ref 固定分支或标签；其他主机上的 git 仓库写完整的克隆 URL；本地目录用 ./ 或 ../ 开头的路径，因为裸写的 name/name 会被当成 GitHub 仓库；托管的 marketplace.json 写它的 https:// 地址。成功时打印 Successfully added marketplace: <name>，下次打开 /plugin 就能在 Discover 里看到它的插件。

06｜更新、停用和卸载

/plugin 的 Installed 选项卡列出你的插件，在会话里运行 /plugin 后按 Tab 切过去。在列表上输入文字能按名称或描述过滤，按 Space 启用或禁用选中的插件，按 f 收藏，按 Enter 打开详情。详情菜单里有 Disable plugin 或 Enable plugin、Update now 和 Uninstall。

你自己装的、最近没用过的插件会归到 Not used recently 标题下，详情里有一行 Last used，用它找出还在增加启动和上下文成本的插件，停用或卸载掉。想看一个插件给每次会话加了多少，在 shell 里运行 claude plugin details <name>，Always-on 那一行就是 token 数。

插件来自的市场打开了自动更新时，插件会自动更新。claude-plugins-official 等官方市场默认打开（knowledge-work-plugins 和 first-party-plugins 除外），社区、第三方和本地开发市场默认关闭。会话启动后，Claude Code 刷新这些市场，更新插件在磁盘上的副本，正在运行的会话保持已加载的版本，你会看到 Plugin updated: <name> · Run /reload-plugins to apply。

要手动更新单个插件，在 Installed 选项卡打开它选 Update now，或者运行 claude plugin update <plugin>@<marketplace>。没有一次更新所有插件的命令，要更新从某个市场装的插件，到 Marketplaces 选项卡选中市场，再选 Update marketplace。

卸载一个由仓库 .claude/settings.json 启用的插件时，Claude Code 会问你是只给自己停用，还是给所有人卸载。按 y 是 Disable for me，它在你的 .claude/settings.local.json 里给插件写入 false，项目里仍然保留安装。按 u 是 Uninstall for everyone，它从共享的 .claude/settings.json 里删掉这个插件。删除整个市场时，Claude Code 会卸载你从这个市场装的每一个插件，并删掉设置文件里对应的 enabledPlugins 条目，Marketplaces 选项卡会在你确认之前列出这些插件的名字。