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

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

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

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

插件里能放的组件：

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

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

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

Anthropic 在 2025 年 10 月 9 日向所有 Claude Code 用户开放插件，当时是公开测试版。它的公告说谁都可以托管市场：一个 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 的市场指南，文件里必须有 name、owner 和 plugins 数组，数组里每一项都要有自己的 name 和 source。相对路径从市场根目录算起，也就是包含 .claude-plugin/ 的那个文件夹。条目也可以指向别处，比如另一个 GitHub 仓库或一个 npm 包。

条目名称是安装用的 ID，插件 plugin.json 里的 name 则是技能的前缀。两者对不上，按清单里的名称安装就会报“找不到插件”。第一次提交时就让两个名称一致，以后要改就两个一起改。推送之前运行 claude plugin validate ./my-marketplace，它会检查 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"
    }
  ]
}

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

用 /plugin 安装和管理插件

/plugin 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。

# 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

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

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

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

{
  "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 的技能页也帮不上忙，那里是粘贴进 AI 对话用的现成提示词。

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

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

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

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

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

子智能体放在 agents/ 里，每个子智能体对应一个 Markdown 文件，写法和我们《Claude Code 子智能体》里讲的独立子智能体一样。放进插件以后，子智能体文件的 hooks、mcpServers 和 permissionMode 字段会被忽略，钩子和服务器要在插件这一层声明。

常见问题

资料来源

1. Claude Code 文档：插件概览 (2026年11月3日 查阅)https://code.claude.com/docs/en/plugins
2. Claude Code 文档：创建 Claude Code 插件 (2026年11月2日 查阅)https://code.claude.com/docs/en/plugins/create
3. Claude Code 文档：给插件添加组件 (2026年11月2日 查阅)https://code.claude.com/docs/en/plugins/components
4. Claude Code 文档：安装和管理插件 (2026年11月2日 查阅)https://code.claude.com/docs/en/plugins/install
5. Claude Code 文档：创建插件市场 (2026年11月2日 查阅)https://code.claude.com/docs/en/plugins/create-marketplace
6. Claude 博客：用插件定制 Claude Code (2026年11月2日 查阅)https://claude.com/blog/claude-code-plugins