用途:提供构建和分发 Claude Code 插件的快速参考,覆盖插件清单与市场配置、打包命令、智能体、技能与 hooks。
主要能力:说明插件结构(.claude-plugin/plugin.json 为必需清单,命令、技能、智能体、hooks、.mcp.json、.lsp.json 放在插件根目录,不要放进 .claude-plugin/);列出清单字段,其中 name 会成为技能命名空间前缀,如 /my-plugin:hello;介绍市场管理命令,例如 /plugin marketplace add owner/repo、/plugin marketplace list、/plugin marketplace update、remove;插件安装与作用域,例如 /plugin install plugin-name@marketplace-name,以及 claude plugin install ... --scope project 或 --scope local;启用、禁用、卸载;交互式 UI /plugin 的 Discover、Installed、Marketplaces、Errors 标签。
使用方式:本地开发可用 claude --plugin-dir ./my-plugin 加载,支持多个 --plugin-dir;修改后需重启 Claude Code。技能写为 skills/my-skill/SKILL.md,命令写为 commands/hello.md,hooks 写为 hooks/hooks.json,LSP 配置写在 .lsp.json。团队自动提示可配置 extraKnownMarketplaces 与 enabledPlugins。
适用场景:个人实验可先用独立 .claude/ 工作流,需要团队共享、社区分发或版本化发布时转为插件。
限制:/plugin 需要 Claude Code 1.0.33+;技能不显示时可删除 ~/.claude/plugins/cache 后重启并重装;LSP 二进制缺失需在 Errors 标签查看并安装;市场不加载需确认 .claude-plugin/marketplace.json 存在;插件被缓存,插件目录之外的路径不可用。官方市场自动更新默认开启,第三方与本地默认关闭;可用 DISABLE_AUTOUPDATER 与 FORCE_AUTOUPDATE_PLUGINS 控制。具体插件清单与安装示例以资料所述为准。