插件：
把一整套配置装进一个盒子

• 官方建议：先在 .claude/ 里写，好用了再打包成插件。
• 插件和市场：插件放在"市场"（marketplace）里发布。市场就是一份插件目录，一个 GitHub 仓库就能当市场。
• 安全：插件能在你电脑上以你的身份运行任意代码（钩子、MCP 服务器都是程序）。只装你信任的来源。

试一试：在 /plugin 面板里挑一个装上

输入 /plugin 打开插件管理器。点列表里的插件看详情，再选一个安装范围：

示意：插件是官方市场里真实存在的，面板的排版和"每轮约多少 token"是示意数字；装之前以面板上的实际数字为准。

• 装完就生效：安装摘要最后一行写 Plugin is now active. 就能直接用；写 Run /reload-plugins to activate. 时 Claude Code 会替你重新加载；如果它提示下一条消息要重读整段对话，输入 /reload-plugins --force。在另一个终端用 claude plugin 命令装的，要在对话里输入 /reload-plugins。
• 社区市场：第三方插件经过自动审核后放在 anthropics/claude-plugins-community，要自己添加，安装时写 @claude-community。

名字带前缀

plugin.json 里的 name 就是前缀。插件 my-team-kit 里的技能 review 叫 /my-team-kit:review，子代理叫 my-team-kit:security-reviewer。这样两个插件都有叫 review 的技能也不会打架。

路径用变量，别写死

装插件时，Claude Code 会把整个文件夹拷贝到 ~/.claude/plugins/cache/，每个版本一个目录（从本地文件夹添加的市场是例外：插件直接从原文件夹读，改了就生效）。所以插件里引用自己的文件，要用这几个变量：

• 拷贝以后，插件够不着自己文件夹外面的文件，../shared/ 这种路径会失效。
• 钩子命令里的变量要用双引号包起来（在 JSON 里写成 \"），路径里有空格也不出错："\"${CLAUDE_PLUGIN_ROOT}\"/scripts/format.sh"。

试一试：改了代码，同事能收到吗？

三步试一遍

• --plugin-dir 只在这次会话里加载，不用安装，适合边改边试。改了文件，对话里输入 /reload-plugins 就能用上新的。
• 懒得建文件夹？claude plugin init my-helper --with skills hooks 会在 ~/.claude/skills/my-helper/ 生成一个骨架，下次启动自动加载为 my-helper@skills-dir，不用安装。

• claude plugin validate ./pr-review 检查的是格式：plugin.json、hooks/hooks.json、各文件开头的 frontmatter。"放错位置、没被加载"它查不出来，要用 claude plugin details pr-review 或 /plugin 详情页看实际装进了什么。
• 装上后在 /plugin 的 Errors 标签页看有没有加载错误；更细的用 claude --debug。

team-plugins/                     # 推到 GitHub：your-org/team-plugins
├── .claude-plugin/
│   └── marketplace.json          # 市场目录
└── plugins/
    └── my-team-kit/              # 第 6 节做的插件
        ├── .claude-plugin/plugin.json
        └── skills/ …

1. 检查：claude plugin validate ./team-plugins，看到 ✔ Validation passed。
2. 本地试装：/plugin marketplace add ./team-plugins，再 /plugin install my-team-kit@my-team。
3. 推到 GitHub，同事执行 /plugin marketplace add your-org/team-plugins，然后安装。私有仓库也行，同事有读权限就能装。
4. 发新版：改 plugin.json 里的 version（第 5 节），再推送。

让同事一打开项目就收到提示

把市场和要启用的插件写进项目的 .claude/settings.json，提交到仓库。同事信任这个项目文件夹后，市场会自动加好；插件如果还没装，Claude Code 会提示他运行对应的安装命令。

• 第三方和本地市场默认不自动更新，要在 /plugin → Marketplaces 里打开；官方市场默认自动更新。
• 想让更多人用：先跑 claude plugin validate，再从官方表单提交到社区市场。官方市场由 Anthropic 自己挑选，没有申请入口。

终端画面为教学示意，输出的措辞和数字是虚构的；命令、市场名、插件名与官方文档一致。