Claude Code Plugin 插件安装与说明

​ 你可能已经用 Claude Code 写了不少代码，觉得挺好用的。但有一天你发现一个问题：别人的 Claude Code 好像"技能更多"，能自动审 PR、能直接查 Jira、能帮你管 Linear 任务……而你的 Claude Code 只会读文件写代码。

​ 差距不在模型，而在Plugin插件。

​ Claude Code 的 Plugin 系统，就是让你给 Claude Code"装 App"的机制。就像手机出厂时只有基础功能，但你可以从 App Store 装各种应用来扩展能力一样。Plugin 让你（或者别人）把好用的工作流打包分享，一行命令就能装上。

​ 这篇文章不讲原理，只管带你从零开始装插件、用插件、最后自己写一个。

一、Plugin 是什么

​ Plugin 是可以分享和安装的 Claude Code 扩展包。

​ 你可能已经接触过 Claude Code 的一些扩展机制。CLAUDE.md 里写规则、Hooks 配自动化脚本。这些都好用，但有个共同问题：不方便分享。

​ 你在自己项目里精心配了一套 PR 审查流程，同事想用怎么办？把文件复制过去？版本怎么管？更新了怎么同步？

​ Plugin 解决的就是这个分发问题。它把各种扩展能力（Skills、Hooks、MCP 配置、LSP 配置）打包成一个目录，支持版本管理和一键安装。

​ 这四样东西，你当然可以每个都手动配。但如果有人已经配好了一套"TypeScript 最佳实践插件"，里面包含类型检查 LSP + 代码规范 Skill + 自动格式化 Hook，你装一下就全有了，这就是 Plugin 的价值。

二、如何使用

2.1 第一步：添加插件市场

​ 插件通过 Marketplace（市场） 分发，你需要先告诉 Claude Code 去哪里找插件。

​ 打开 Claude Code，输入下面命令，这条命令会注册官方插件市场。

/plugin marketplace add anthropics/claude-code

​ 这行命令把 Anthropic 官方的插件市场注册到你的 Claude Code 里。anthropics/claude-code 是 GitHub 上的仓库地址，Claude Code 会从这里读取可用的插件列表。

​ 看到类似下面的输出，就说明添加成功了：

(1) 管理市场

/plugin marketplace list     # 看看已经添加了哪些市场
/plugin marketplace remove claude-plugins-official  # 不想要了可以删掉

小提示：/plugin marketplace 可以简写成 /plugin market，少打几个字。

​ 除了官方市场，你也可以添加团队内部的市场、第三方市场，甚至本地目录：

# 公司内部 GitLab 上的插件市场
/plugin marketplace add https://gitlab.com/my-company/claude-plugins.git

# 指定某个版本/分支
/plugin marketplace add https://gitlab.com/my-company/claude-plugins.git#v2.0.0

# 本地目录（适合开发调试）
/plugin marketplace add ./my-local-marketplace

2.2 第二步：浏览和安装插件

​ 市场添加好了，接下来看看有什么可以装的。

​ 输入 /plugin，会打开一个交互式的插件管理界面。切到 Discover 标签页，就能看到市场里所有可用的插件。

​ 或者直接用命令安装：

/plugin install github@claude-plugins-official

​ 这条命令的意思是：从 claude-plugins-official 这个市场里，安装名叫 github 的插件。

(1) 官方市场里有什么

​ Anthropic 官方市场里的插件大致分三类：

• 代码智能类（LSP 插件）

  ​ 这类插件给 Claude Code 接入语言服务器，让它在分析代码时能拿到类型信息、定义跳转、引用查找等能力，相当于给 Claude 装了一个"IDE 级别的代码理解引擎"。

  /plugin install typescript-lsp    # TypeScript / JavaScript
  /plugin install pyright-lsp       # Python
  /plugin install rust-analyzer-lsp # Rust
  /plugin install gopls-lsp         # Go
  

• 外部集成类

  ​ 这类插件让 Claude 能直接操作外部服务，不用你当中间人复制粘贴：

  /plugin install github     # GitHub Issue / PR / 代码搜索
  /plugin install linear     # Linear 任务管理
  /plugin install sentry     # Sentry 错误监控
  /plugin install figma      # Figma 设计稿
  /plugin install slack      # Slack 消息
  /plugin install notion     # Notion 文档
  

• 工作流类

  这类插件封装了特定的工作流程：

  /plugin install commit-commands    # Git 提交工作流
  /plugin install pr-review-toolkit  # PR 审查工具包
  

(2) 安装范围

​ 安装时可以指定这个插件的生效范围：

# 默认：只对你个人生效，所有项目都能用
/plugin install github

# 项目级别：写入项目配置，团队成员都能用
/plugin install github --scope project

# 仅当前项目、仅你自己（会被 gitignore）
/plugin install github --scope local

​ 怎么选？ 个人偏好的工具用默认的 user 范围；团队都需要的用 project 范围，这样新人 clone 仓库就自动有了。

2.3 第三步：使用已安装的插件

​ 装好之后，怎么用？大多数时候你什么都不用做。

• 以 github 插件为例，装好之后 Claude Code 就自动获得了操作 GitHub 的能力。你直接用自然语言说就行：
  • “帮我看看分配给我的 Issue”
  • “审阅一下 PR #42”
  • “创建一个 bug Issue，标题是’登录页在 Safari 下白屏’”
• 如果插件里包含 Skills（斜杠命令），你可以用 /插件名:命令名 来调用：

/pr-review-toolkit:review     # 调用 PR 审查插件的 review 命令
/commit-commands:commit        # 调用提交插件的 commit 命令

(1) 管理已安装的插件

/plugin                    # 打开插件管理界面，查看所有已安装的插件
/plugin disable github     # 暂时禁用某个插件（不卸载）
/plugin enable github      # 重新启用
/plugin uninstall github   # 彻底卸载
/reload-plugins            # 修改了插件配置后，不用重启，刷新一下就行

三、常见问题

3.1 插件装了但命令没出现？

​ 试试 /reload-plugins 刷新一下。如果还不行，检查插件目录结构是否正确，特别是 SKILL.md 是不是放对了位置。

3.2 Plugin 和 MCP 什么关系？

​ Plugin 可以包含 MCP 配置。比如 github 插件内部就有一个 .mcp.json，安装插件时 MCP Server 会自动配好，不需要你再手动 claude mcp add。

​ 简单理解：MCP 是一种能力（连接外部服务），Plugin 是一种打包方式（把各种能力捆在一起分发）。

3.3 多个插件会冲突吗？

​ 一般不会。每个插件的命令都带有插件名前缀（/插件名:命令名），不会互相覆盖。但如果两个插件都配了同名的 Hook，可能会有执行顺序的问题，留意一下就好。

3.4 怎么看一个插件里有什么？

​ 在插件管理界面（/plugin）里选中一个插件，可以看到它包含的所有 Skills、Hooks、MCP 配置等信息。

四、总结

• 添加市场 — /plugin marketplace add anthropics/claude-code，告诉 Claude Code 去哪找插件。
• 安装插件 — /plugin install 插件名，一行命令装好使用插件 — 大多数自动生效，有命令的用 /插件名:命令名 调用

​ Plugin 系统的设计哲学很简单：把好用的工作流变成可安装、可分享、可版本管理的包。 你不需要一开始就装一堆插件，先从一两个最能提效的开始（比如你常用语言的 LSP 插件），体验到好处后再慢慢扩展。