Claude Code 深度学习手册

主题

发现与安装插件 ​

通过 marketplace 目录发现并安装预制插件，扩展 Claude Code 能力。

是什么 ​

插件（plugins）用 skills、agents、hooks 和 MCP servers 扩展 Claude Code。插件 marketplace 是别人创建并分享的插件目录，让你无需自己构建即可发现与安装这些扩展。

使用 marketplace 是两步流程：先添加 marketplace（注册目录、可浏览，但还不安装任何插件），再单独安装你想要的插件。类似添加应用商店：添加商店让你能浏览其收藏，但仍需逐个选择下载。

怎么工作 ​

  • 官方 Anthropic marketplace（claude-plugins-official）在启动 Claude Code 时自动可用；运行 /plugin 进入 Discover 标签浏览，或访问 claude.com/plugins。
  • 其他 marketplace 需手动添加：用 /plugin marketplace add 支持 GitHub（owner/repo）、Git URL（带 .git，可用 #ref 指定分支或标签）、本地路径、远程 marketplace.json URL。
  • /plugin 打开管理器，含四个标签（Tab/Shift+Tab 切换）：Discover、Installed、Marketplaces、Errors。
  • 在 Discover 标签选中插件可查看详情：Context cost（每轮新增的 token 估算）、Last updated 日期、Will install 区块（列出命令/agents/skills/hooks/MCP 与 LSP servers）。
  • 安装时选择 scope：User scope（默认，跨所有项目）、Project scope（写入 .claude/settings.json，共享给协作者）、Local scope（仅本仓库、不共享）。
  • 也可命令行直接安装：/plugin install plugin-name@marketplace-name（默认 User scope）。
  • 安装、启用或禁用插件后，运行 /reload-plugins 即可在不重启的情况下生效。
  • 插件的 skills 按插件名做命名空间，例如 commit-commands 提供 /commit-commands:commit。

怎么配置 / 用法 ​

添加 marketplace 并安装插件：

shell
/plugin marketplace add anthropics/claude-code
/plugin install commit-commands@claude-code-plugins
/reload-plugins

官方 marketplace 安装（如 GitHub 集成）：

shell
/plugin install github@claude-plugins-official

社区 marketplace：

shell
/plugin marketplace add anthropics/claude-plugins-community
/plugin install <plugin-name>@claude-community

管理插件：

shell
/plugin disable plugin-name@marketplace-name
/plugin enable plugin-name@marketplace-name
/plugin uninstall plugin-name@marketplace-name

管理 marketplace：

shell
/plugin marketplace list
/plugin marketplace update marketplace-name
/plugin marketplace remove marketplace-name

CLI 指定 scope：claude plugin install formatter@your-org --scope project。团队 marketplace 写入 .claude/settings.json 的 extraKnownMarketplaces，成员信任仓库目录后会被提示安装。

什么时候用 ​

  • 想用现成的 skills、agents、hooks 或 MCP server 扩展 Claude Code，而不自己构建时
  • 需要连接外部服务（github、gitlab、jira、figma、slack、sentry 等）的预配置 MCP 集成时
  • 想为某语言开启代码智能（LSP：跳转定义、查引用、即时类型错误）时
  • 团队希望为项目统一自动安装 marketplace 与插件时

限制 / 坑 ​

  • 插件和 marketplace 是高度受信任组件，会以你的用户权限执行任意代码；只安装/添加你信任的来源，Anthropic 无法验证第三方插件内容。
  • Code intelligence（LSP）插件需在系统上安装对应语言服务器二进制；若 $PATH 找不到会在 Errors 标签报错。
  • 插件被复制到 cache，引用插件目录之外文件的路径不会生效。
  • 移除 marketplace 会同时卸载从它安装的所有插件。
  • URL 型 marketplace 相比 Git 型有限制，安装时可能遇到 path not found 错误。

硬事实速查（12 条） ​

  • 官方 marketplace 名为 claude-plugins-official，启动时自动可用，由 Anthropic 策划。
  • 社区 marketplace 为 anthropics/claude-plugins-community（安装名 claude-community），插件经自动校验与安全筛查并固定到具体 commit SHA。
  • 演示 marketplace 为 anthropics/claude-code（名 claude-code-plugins），含示例插件，需手动添加。
  • 安装语法为 /plugin install plugin-name@marketplace-name，默认安装到 User scope。
  • /plugin marketplace 可简写为 /plugin market，remove 可简写为 rm。
  • 三种安装 scope：User、Project、Local；另有管理员通过 managed settings 安装的 managed scope，不可修改。
  • 代码智能插件给 Claude 两种能力：每次编辑后自动诊断（按 Ctrl+O 内联查看），以及基于语言服务器的代码导航（跳转定义、查引用、悬停类型等）。
  • 官方提供 11 种语言的 LSP 插件，如 pyright-lsp（需 pyright-langserver）、typescript-lsp、rust-analyzer-lsp、gopls-lsp 等。
  • 外部集成插件按类别分：源码控制 github/gitlab、项目管理 atlassian/asana/linear/notion、设计 figma、基础设施 vercel/firebase/supabase、通信 slack、监控 sentry。
  • security-guidance 插件会审查 Claude 的每次改动并在同一会话内修复发现的常见漏洞。
  • 官方 Anthropic marketplace 默认开启自动更新；第三方与本地开发 marketplace 默认关闭。设 DISABLE_AUTOUPDATER 禁用全部，配合 FORCE_AUTOUPDATE_PLUGINS=1 可仅保留插件自动更新。
  • 若 skills 不出现，可清缓存 rm -rf ~/.claude/plugins/cache 后重启并重装；若插件未找到，用 /plugin marketplace update claude-plugins-official 刷新。

官方出处：https://code.claude.com/docs/en/discover-plugins