# Claude Code 插件和插件市场是什么？

> 想把一整套配置一次装给别人，就用 Claude Code 插件：技能、子智能体、钩子、MCP 服务器等组件一起装上、一起加载。插件市场是一份名录，列出有哪些插件、各自从哪里获取。

Mindket 编辑部 · 发布于 2026-11-01 · 更新于 2026-11-03 · https://mindket.com/cn/blog/claude-code-plugins

## 要点

- 确认安装前，先在插件详情里看清它带的钩子和 MCP 服务器，官方市场的也不例外。
- 清单里写了 `version`，每次发布新版就要改这个号，不然用户收不到更新。
- 删市场之前，先去 Installed 标签看看有哪些插件是从它那里装的。

## 插件里装什么，你到底需不需要

在 Claude Code 会话里输入 `/plugin install commit-commands@claude-plugins-official`，就能从 Anthropic 的官方市场装一个插件。@ 前面是插件名，后面是市场名。

团队要让每个人一次装齐几样东西时，才值得自己做插件，比如代码审查用的技能，加上与它配套的格式化钩子。只给自己用的一个技能，我们不会专门包成插件。[技能](https://mindket.com/cn/blog/how-to-create-agent-skill)放在 `~/.claude/skills/` 里，电脑上每个项目本来就能用。

插件里能放的[组件](https://code.claude.com/docs/en/plugins/components)：

- 技能，用得上的时候才加载。
- 子智能体，接手 Claude 派出去的任务。
- 钩子，在 Claude Code 生命周期的特定节点运行。
- MCP 服务器，插件启用期间保持连接。
- 语言服务器、监视器、输出样式、配色主题和命令行工具。

**单放一个技能，还是做成插件**

| | 放在 ~/.claude/skills/ 的技能 | 插件 |
| --- | --- | --- |
| 你电脑上的每个项目里都能用 | ✓ 是 | ✓ 是 |
| 把多个技能、子智能体、钩子或 MCP 服务器作为一个整体 | ✗ 否 | ✓ 是 |
| 从插件市场获得更新 | ✗ 否 | ✓ 是 |
| 技能名带前缀，比如 /my-plugin:review | ✗ 否 | ✓ 是 |

来源：[Claude Code 文档：插件概览](https://code.claude.com/docs/en/plugins) (2026-11-03 查阅)

> 插件的代码以你的用户权限运行，官方市场来的也一样。插件启用后，每个会话都会加载它，不管这次用不用得上。Claude 能自行调用的技能、子智能体和命令，每一轮都会把名称和描述放进上下文。插件的 MCP 服务器随每个会话一起运行，钩子在对应事件发生时触发。

## 插件市场：一份你可以自己托管的名录

Anthropic 在 2025 年 10 月 9 日向所有 Claude Code 用户开放插件，当时是公开测试版。[它的公告](https://claude.com/blog/claude-code-plugins)说谁都可以托管市场：一个 git 仓库、GitHub 仓库或网址，里面放一份格式正确的 `marketplace.json` 就行。

第一次启动交互式终端会话时，Claude Code 会自动添加 `claude-plugins-official`。其他市场用 `/plugin marketplace add` 添加一次即可，后面可以跟 GitHub 的 `owner/repo`、git 地址、本地路径，或某个 `marketplace.json` 的 https 网址。本地路径要以 `./` 或 `../` 开头，因为不带前缀的 `name/name` 会被当成 GitHub 仓库。

只有来源是 `github.com/anthropics/` 下仓库的市场，才能用官方或社区的名称，比如 `claude-plugins-official` 和 `claude-community`。其余市场一律算第三方，你们公司自己的也不例外。

你自己的市场，就是下面这份 `.claude-plugin/marketplace.json`。按 [Anthropic 的市场指南](https://code.claude.com/docs/en/plugins/create-marketplace)，文件里必须有 `name`、`owner` 和 `plugins` 数组，数组里每一项都要有自己的 `name` 和 `source`。相对路径从市场根目录算起，也就是包含 `.claude-plugin/` 的那个文件夹。条目也可以指向别处，比如另一个 GitHub 仓库或一个 npm 包。

条目名称是安装用的 ID，插件 `plugin.json` 里的 `name` 则是技能的前缀。两者对不上，按清单里的名称安装就会报“找不到插件”。第一次提交时就让两个名称一致，以后要改就两个一起改。推送之前运行 `claude plugin validate ./my-marketplace`，它会检查 JSON 语法、必填字段，以及市场里存放的每个插件。

````json
{
  "name": "my-marketplace",
  "description": "Plugins for my team",
  "owner": {
    "name": "Your Name"
  },
  "plugins": [
    {
      "name": "my-first-plugin",
      "source": "./plugins/my-first-plugin",
      "description": "A greeting plugin to learn the basics"
    }
  ]
}

````

[![Claude 官方账号（@claudeai）2025 年 10 月 9 日插件系列帖子里的一条回复，上一条帖子展示了 /plugin marketplace add 命令，后面跟着 anthropics/claude-code：任何人都可以托管插件市场或做插件，只需要一个带有 .claude-plugin/marketplace.json 文件的 git 仓库](https://mindket.com/blog/shots/x-claudeai-plugin-marketplaces.webp?v=b1dd143dedeb)](https://x.com/claudeai/status/1976332887722164307)

Claude 在 X 上，2025 年 10 月 9 日

> X 官方嵌入卡片的截图，拍摄于 2026 年 11 月 3 日，时间为美国太平洋时间，未收入链接预览。点击截图可到 X 上打开原帖。

## 用 /plugin 安装和管理插件

`/plugin install` 不会马上装上插件，而是先[打开插件详情](https://code.claude.com/docs/en/plugins/install)，列出它要添加的命令、子智能体、技能、钩子，以及 MCP 和 LSP 服务器。官方市场里的插件，详情里还会估算它占多少上下文，分每轮对话的占用和技能加载后的占用。不带名称运行 `/plugin`，会打开一个面板，列出你各个市场里的全部插件。

想让每个项目都开着这个插件，就选用户作用域，它会写进 `~/.claude/settings.json` 的 `enabledPlugins`。项目作用域写进要提交的 `.claude/settings.json`，本地作用域写进 `.claude/settings.local.json`。几个作用域都设了同一个插件时，本地优先于项目，项目优先于用户。

团队用的插件适合项目作用域，这条设置会写进大家都会拉取的文件。不过共享的只是“启用”这条设置，插件本身还得下载到每个人自己的电脑上，所以每位同事都要用 `--scope project` 装一次。

装完输入 `/`，找 `/commit-commands:commit` 这样的技能。`/plugin` 的 Installed 标签会列出插件和它的作用域，加载失败的话，Errors 标签会写明原因。

来自 `claude-plugins-official` 的插件会自动更新。社区、第三方和本地市场默认关闭自动更新，要在 Marketplaces 标签里逐个打开。删掉一个市场，你从它那里装的插件会全部被卸载。正在运行的会话会一直用已经加载的版本，直到你运行 `/reload-plugins`。

````bash
# Inside a Claude Code session
/plugin
/plugin marketplace add your-org/plugins
/plugin install commit-commands@claude-plugins-official
/reload-plugins

# From your shell, for setup scripts
claude plugin install formatter@your-org --scope project
claude plugin list
claude plugin disable formatter@your-org
claude plugin update formatter@your-org

````

**装好的插件会出现在哪里**

1. 设置。记着你加过哪些插件市场，启用了哪些插件。
2. 磁盘。`~/.claude/plugins/` 里放着 Claude Code 拉取并安装的内容。
3. 会话。插件在启动时加载，或者在你运行 `/reload-plugins` 时加载。

来源：[Claude Code 文档：插件概览](https://code.claude.com/docs/en/plugins) (2026-11-03 查阅)

## 自己做插件：目录结构、清单和第一次运行

插件从清单写起，也就是 `.claude-plugin/plugin.json`。按 [Anthropic 的插件创建指南](https://code.claude.com/docs/en/plugins/create)，必填的只有 `name`，它用来识别插件，也是每个技能和子智能体的前缀，不能有空格。`description` 是用户在 `/plugin` 里看到的说明。`version` 可以不写。写了的话，用户会一直用这个版本，等你把号码改掉才会更新。

`.claude-plugin/` 里别放别的东西。组件放在这里不会被加载。Anthropic 的排错文档就把“`skills/` 放进了 `.claude-plugin/`”列为原因之一：插件能加载，技能却不见了。

````json
{
  "name": "my-first-plugin",
  "description": "A greeting plugin to learn the basics",
  "version": "1.0.0",
  "author": {
    "name": "Your Name"
  }
}

````

1. 用 `mkdir -p my-first-plugin/.claude-plugin` 建好插件文件夹和放清单的文件夹。
2. 把上面的清单存为 `my-first-plugin/.claude-plugin/plugin.json`。
3. 在 `my-first-plugin/skills/hello/SKILL.md` 写一个技能，头信息里要有名称和描述。
4. 运行 `claude plugin validate ./my-first-plugin`。按 Anthropic 的指南，通过时会打印 `✔ Validation passed`，否则每个要改的字段各占一行。
5. 用 `claude --plugin-dir ./my-first-plugin` 启动会话，再运行 `/my-first-plugin:hello`。这个参数只在本次会话里加载插件，不会写进你的设置。改完文件，运行 `/reload-plugins` 就能载入改动。

> 技能、子智能体或钩子已经放在 `.claude/` 下了？把这些文件夹复制到插件根目录，再把设置文件里的 `hooks` 对象移到 `hooks/hooks.json`。原件删掉之前，两份都会加载。技能不会冲突，因为插件里的技能带前缀，但两处都有的钩子会运行两次。

## 能从 Mindket 拿到插件吗？

用 `/plugin` 拿不到。Mindket 是独立的商店，与 Anthropic 没有关联，也不提供 `marketplace.json`，对它运行 `/plugin marketplace add`，什么也读不到。Mindket 的[技能页](https://mindket.com/cn/skills)也帮不上忙，那里是粘贴进 AI 对话用的现成提示词。

不过，按插件结构组织的[工具包](https://mindket.com/cn/kits)能加载。工具包是纯文本文件打成的 zip，里面可以有技能、规则、提示词和模板，条目页会列出 README 和文件清单。用 `claude --plugin-dir` 指向 zip 包或解压出来的文件夹，这次会话就会加载它，钩子也照常触发。

工具包的 zip 外面没有套一层以工具包命名的文件夹，文件直接放在最顶层。工具包里的东西不会自己运行，带脚本的工具包要先由审核员读过，买家才拿得到。

> 我们在 2026 年 11 月 2 日和 3 日读了 Anthropic 关于 Claude Code 的页面，没有亲手装过这些插件，所以命令和参数以那两天的文档为准。

## 参考：插件里每样东西放在哪里

插件根目录下的 CLAUDE.md 不会被加载，要写的指令应当放进技能里。

子智能体放在 `agents/` 里，每个子智能体对应一个 Markdown 文件，写法和我们[《Claude Code 子智能体》](https://mindket.com/cn/blog/claude-code-subagents)里讲的独立子智能体一样。放进插件以后，子智能体文件的 `hooks`、`mcpServers` 和 `permissionMode` 字段[会被忽略](https://code.claude.com/docs/en/plugins/components)，钩子和服务器要在插件这一层声明。

| 位置 | 放什么 |
| --- | --- |
| `.claude-plugin/plugin.json` | 清单，这个文件夹里只放它 |
| `skills/` | 每个技能一个文件夹，里面放 SKILL.md |
| `commands/` | 单个 Markdown 文件，是技能的旧形式 |
| `agents/` | 每个子智能体一个 Markdown 文件 |
| `hooks/hooks.json` | 钩子配置，放在顶层的 "hooks" 键下 |
| `.mcp.json` | MCP 服务器定义，在 `/mcp` 里显示为 `plugin:my-plugin:db` 这样的名称 |
| `.lsp.json` | 提供诊断和代码跳转的语言服务器 |
| `bin/` | 可执行文件，插件启用期间会加入 Claude 所用 shell 的 PATH |

## 常见问题

### Claude Code 插件和 VS Code、JetBrains 里的 Claude Code 扩展是一回事吗？

VS Code 扩展和 JetBrains 插件的作用，是让你在这些编辑器里运行 Claude Code。Claude Code 插件则是 Claude Code 自己加载的组件包，不管你在哪里运行 Claude Code，加载的都是同一套。

### 插件市场和 Claude Marketplace 是一回事吗？

Claude Marketplace 是 claude.com/marketplace 这个网站，用来浏览插件、连接器和合作伙伴的产品，不能用 `/plugin marketplace add` 添加。在那里找到的插件有个 Claude Code 按钮，点一下会复制在终端里用的安装命令。

### 插件在云端会话或 claude.ai 上能用吗？

只能用一部分。云端会话，包括浏览器里的 claude.ai/code，不会加载你本地设置里的插件。claude.ai 和 Cowork 也能装同一种格式的插件，但这两处加载的组件不同，顶层带 `bin/` 文件夹的插件也装不上。

### 不经过市场，能让插件在每个会话里自动加载吗？

能，放进你的技能文件夹就行。运行 `claude plugin init my-tool`，它会在 `~/.claude/skills/my-tool/` 里生成一个起步插件。这个插件不用加参数，也不用安装，每个会话都会以 `my-tool@skills-dir` 这个 ID 加载它。根目录的 SKILL.md 以 `/my-tool` 运行，`skills/` 文件夹里的技能则带 `/my-tool:` 前缀。

### 怎样停用插件而不卸载它？

禁用就行：在 `/plugin` 的 Installed 标签里选中它按空格，或在终端运行 `claude plugin disable`。不过插件已经启动的监视器，会一直运行到会话结束。拿不准该关哪个，可以运行 `claude plugin details`，它会显示插件给每个会话增加多少 token。

## 资料来源

- [Claude Code 文档：插件概览](https://code.claude.com/docs/en/plugins) (2026-11-03 查阅)
- [Claude Code 文档：创建 Claude Code 插件](https://code.claude.com/docs/en/plugins/create) (2026-11-02 查阅)
- [Claude Code 文档：给插件添加组件](https://code.claude.com/docs/en/plugins/components) (2026-11-02 查阅)
- [Claude Code 文档：安装和管理插件](https://code.claude.com/docs/en/plugins/install) (2026-11-02 查阅)
- [Claude Code 文档：创建插件市场](https://code.claude.com/docs/en/plugins/create-marketplace) (2026-11-02 查阅)
- [Claude 博客：用插件定制 Claude Code](https://claude.com/blog/claude-code-plugins) (2026-11-02 查阅)

[浏览工具包](https://mindket.com/cn/kits)