Plugins：别人写好的工具，装上就能用

📍 Claude Code 干活

应用商店里挂着一排发光的插件盒，有人正在挑选

「Claude Code 干活」板块终篇：站在巨人肩膀上

你读完了这个板块的前 9 篇——

会让 Claude 读 / 改文件
会跑命令、管 permission
会写 CLAUDE.md
知道 context / checkpoint / 省钱
会用常用的 slash command
会写自定义 Skill

最后一步——你不用什么都自己写。社区里老手写好的 Plugin,直接装到你的 Claude Code,几分钟拥有别人三个月调出来的工作流。

这就是 Plugin。

Plugin 跟 Skill 的关系

左 Skill，右 Plugin

简单一句话：

Skill 是你自己写的。Plugin 是别人写的 Skill + Tool + Hook 的打包版。

	Skill	Plugin
来源	你自己写	别人写好发布
形态	一个文件夹（里面一个 `SKILL.md`）	一个完整目录：可包含多个 Skill、子智能体、Hook（钩子，在特定时机自动运行的脚本）、MCP 服务器（接外部服务的工具）
安装	你手动放进 `.claude/skills/`	`/plugin install 插件名@市场名`，再选安装范围
更新	你手动改	官方市场的插件默认自动更新；也可以在 `/plugin` 的 Installed 标签里点 Update now
典型例子	`weekly-report/SKILL.md`	`commit-commands`（官方插件，一组提交代码、推送、开 PR 的命令）

类比:

Skill = 你自家厨房自己做的菜
Plugin = 米其林大厨打包好的预制菜套装

新手节奏:先装几个高频 Plugin 用熟，然后有什么 Plugin 没覆盖的需求，自己写 Skill 补。

官方 Marketplace 在哪

应用商店式的 Plugin 浏览页面，6 个 tile 卡片

先搞清楚一个概念：Claude Code 的插件市场（marketplace）本质上是一个个 git 仓库——谁都可以把自己的插件集合做成一个仓库，你把仓库地址加进来，里面的插件就能装。

Anthropic 自己维护三个通用市场，名字很像，别搞混：

市场	市场名（安装时写在 `@` 后面）	怎么加
官方市场	`claude-plugins-official`	不用你加：第一次启动 Claude Code 交互会话时自动加好
社区市场	`claude-community`	`/plugin marketplace add anthropics/claude-plugins-community`
演示市场	`claude-code-plugins`	`/plugin marketplace add anthropics/claude-code`（只有十几个示例插件，已被官方市场取代）

旧教程常让你运行 /plugin marketplace add anthropics/claude-code，那加的是演示市场，不是官方市场。演示市场里的大部分插件（比如 code-review、commit-commands）官方市场里都有同名的，从官方市场装就行，免得装出两份。

两步走:

第 1 步：直接打开插件面板

/plugin

官方市场已经默认加好了。面板打开在 Discover（发现）标签，列出你加过的所有市场里的插件，可以打字搜索，回车打开详情。

网页上也能逛：claude.com/marketplace/plugins 能看到每个插件的安装量，部分插件带 Anthropic verified（官方验证）标记。

第 2 步（可选）：加别的市场

想用社区插件，再加社区市场；别人发给你的第三方市场同理：

/plugin marketplace add anthropics/claude-plugins-community

（格式是 GitHub用户/仓库名。加成功会显示 Successfully added marketplace: 市场名，之后安装时 @ 后面写的就是这个市场名。）

5 类值得装的 Plugin

下面列的是「应该装这一类」——用 /plugin 面板在你加的 marketplace 里搜对应关键词挑当下的好选。各家仓库里的包名 + 维护者会随时间变，别照搬下面假设的包名。

1. PR review 类(关键词搜：code review / pr review)

做什么：让 Claude 自动 review 你的 git diff,找 bug / 性能问题 / 风格问题，生成结构化 review comment。

用它：在 git 仓库里说「review 一下我这个分支的改动」，装好就能自动跑。

2. commit message 类(关键词搜：commit / conventional commits)

做什么：看已暂存的改动（staged changes），自动写一条好的 commit message，符合 conventional commits（约定式提交，一种统一的提交说明格式）规范。

用它：在 Claude Code 里说「写个 commit message」，自动跑。

3. 中文写作类(关键词搜：chinese / 中文)

做什么：专门优化中文表达——删虚词、动词起头、不长篇大论。最适合中文用户。

用它：写中文邮件 / 周报 / 报告时它会自动召唤。

4. 一键部署类(关键词搜：deploy / cloudflare / vercel)

做什么：把当前目录一键部署到 Cloudflare Pages / Vercel / Netlify —— 自动建项目、配域名、推代码。

用它：在静态项目目录说「部署到 Cloudflare」。

5. 报错智能修复类(关键词搜：bug / doctor / error fix)

做什么：你跑代码报了一个错，贴报错给 Claude，它自动搜资料 + 找根因 + 给出修复方案。比单纯让 Claude 「看看这个错」更深入。

用它：跑代码报错时直接贴 traceback（报错堆栈，程序出错时打印的那一大段调用记录）。

怎么 install / uninstall / update

4 格流程 → 下载 → 装进 brain → 准备好

安装

/plugin install 插件名@市场名

（比如 /plugin install code-review@claude-plugins-official。@市场名 建议总是带上：同一个插件可能在好几个市场里都有。）或者在 /plugin 面板的 Discover 标签里选中安装。

在会话里打这条命令不会马上装，而是先打开插件详情，安装过程是这样的：

看详情：Will install 一栏列出它会装进来哪些命令、Skill、Hook、MCP 服务器，装之前先看一眼
选安装范围：Install for you（只给你自己，所有项目都能用）/ Install for all collaborators on this repository（这个仓库的所有协作者都启用）/ Install for you, in this repo only（只在这个仓库里给你自己用）
看最后一句提示：Plugin is now active. 就是装好能用了；提示 Run /reload-plugins to activate. 的，Claude Code 会自动帮你运行 /reload-plugins（重新加载插件），一般不用重启

装好后打 /，能看到 /插件名:技能名 这种带插件名前缀的命令，比如装了 commit-commands 就有 /commit-commands:commit。

（还没加过的第三方市场，2.1.275 起也可以一步到位：/plugin install 插件名 --marketplace 用户名/仓库名，它会先问你要不要加这个市场，再打开插件详情。）

看你装了什么

/plugin list

列出所有已装的 Plugin（版本、安装范围、是否启用）。也可以在 /plugin 面板里按 Tab 切到 Installed（已安装）标签看。

更新

官方市场的插件默认自动更新：会话开始后 Claude Code 会在后台检查，更新好了会提示 Plugin updated: … Run /reload-plugins to apply，运行 /reload-plugins 或下次开会话就是新版。社区市场和第三方市场默认不自动更新，想打开就在 /plugin 的 Marketplaces 标签里选中那个市场，点 Enable auto-update
手动更新某一个：在 /plugin 的 Installed 标签里选中它，点 Update now；或者在终端（不是会话里）运行 claude plugin update 插件名@市场名
连市场一起刷新：会话里的 /plugin marketplace update 市场名 会把这个市场刷到最新，顺带升级从它装的插件（终端里的 claude plugin marketplace update 只刷新目录、不升级插件）

会话里没有 /plugin update 这个子命令（打了只会打开插件面板）。更新完运行 /reload-plugins 就生效，不用重装。

卸载

/plugin uninstall 插件名@市场名

干干净净移除——所有它注册的命令 / Skill / Hook 全部移除。

安全：装别人的 Plugin 之前看什么

Plugin 会继承 Claude Code 的工具能力——它带的命令和 hook 可以读你的文件、跑你的命令、调用外部 API，而且没有一个细粒度的「权限清单」替你把关。所以安全全靠装之前把好门,3 条原则：

✅ 1. 只加可信的 marketplace

marketplace 就是 git 仓库，加谁的仓库 = 信谁这个人/组织。新手建议先只用默认的官方市场，再加社区口碑明确的仓库；不认识的个人仓库，先过第 2 条再说。市场名只说明谁维护这份目录，不代表里面每个插件都安全。

✅ 2. 装前看源码

装之前先看 /plugin 详情页的 Will install：它会装进来哪些命令、Skill、Hook、MCP 服务器。再去插件的源码仓库（通常就在 marketplace 仓库里，也可能是别的 git 仓库）点开看看。重点看 hooks/、.mcp.json 和 bin/：hooks 和 MCP 服务器会在你电脑上以你的用户权限、在沙箱外自己运行，权限规则管不到；bin/ 里的程序会被加进 Claude 跑命令时的路径，Claude 随时能调用。看到「中文写作助手」里藏着读 ~/.ssh/ 的命令——直接拒绝。

✅ 3. 让 Claude 替你审

最省事的一招：把插件仓库链接发给 Claude Code，说「帮我看看这个插件的源码有没有危险操作」——让 AI 审 AI 的插件，几十秒出结论。

发布你自己的 Plugin

一个作者把 Plugin 盒装好递进 community 网络

如果你写了一个特别好用的 Skill + Tool 组合，可以打包成 Plugin 分享给社区。

Step 1：建一个 Plugin 仓库

前两行建好插件文件夹并进到里面，后面四行搭出基本结构：

touch .claude-plugin/plugin.json → 插件清单（注意：放在 .claude-plugin/ 目录里）
touch .claude-plugin/marketplace.json → 市场清单：别人能按名字安装，靠的就是它
mkdir skills hooks → 按需建，用哪类建哪类

mkdir my-plugin-name
cd my-plugin-name

mkdir .claude-plugin
touch .claude-plugin/plugin.json
touch .claude-plugin/marketplace.json
mkdir skills hooks

plugin.json 长这样(就这么简单):

{
  "name": "my-plugin-name",
  "version": "0.1.0",
  "description": "一句话说清楚这个 Plugin 干嘛的",
  "author": { "name": "你的名字" }
}

marketplace.json 把这个仓库变成一个只有一个插件的小市场：

{
  "name": "my-marketplace",
  "description": "我自己的插件市场",
  "owner": { "name": "你的名字" },
  "plugins": [
    { "name": "my-plugin-name", "source": "./" }
  ]
}

最外层的 name 是市场名，别人安装时写在 @ 后面
plugins 里那一条的 name 要和 plugin.json 里的 name 一模一样；source 写 ./，意思是插件就在这个仓库的根目录

少了 marketplace.json 是最常见的坑：别人运行 /plugin marketplace add 时会报 Marketplace file not found，装不上。

Step 2：往目录里放内容

skills/ 放技能（每个是 技能名/SKILL.md，写法见上一篇）
agents/ 放子智能体（每个一份 markdown 文件）
hooks/hooks.json 放钩子配置（格式和 settings.json 里的 hooks 一样）
要接外部服务，根目录放一个 .mcp.json
commands/ 是旧格式（平铺的 markdown 命令文件），还能用，新插件用 skills/ 就行

注意：.claude-plugin/ 里只放 plugin.json 和 marketplace.json 这两个清单，其他东西都放在插件根目录，放错地方不会加载。

Step 3：检查、推到 GitHub，发布完成

先检查清单：

claude plugin validate .

看到 ✔ Validation passed 再往下：

git init
git add .
git commit -m "Initial release"
gh repo create my-plugin-name --public --source=. --remote=origin --push

gh 是 GitHub 官方的命令行工具，要先装好并用 gh auth login 登录。最后一行的意思是：在 GitHub 上建一个叫 my-plugin-name 的公开仓库，把当前目录设为它的本地仓库（--source=.），加上名叫 origin 的远程地址，再把刚才的提交推上去（--push）。只写 gh repo create my-plugin-name --public 的话，它只在 GitHub 上建一个空仓库，不会连上你本地这份代码，接着 git push -u origin main 会报找不到 origin。

自己建市场这条路没有提交审核这一步——推上去就算发布了。别人只要：

/plugin marketplace add 你的用户名/my-plugin-name
/plugin install my-plugin-name@my-marketplace

就能装你的插件（2.1.275 起也可以一步：/plugin install my-plugin-name --marketplace 你的用户名/my-plugin-name）。发个帖、写篇 README（说明文档）宣传一下，就是你的「上架」。

以后改了插件，记得把 plugin.json 里的 version 加一再推送；版本号没变的话，别人运行更新时会提示「已经是最新版」，拿不到你的新代码。

想进 Anthropic 的官方插件目录（claude.ai 上的那个目录）是另一条路：要在开发者门户提交、通过审核才会上架，提交者需要 Claude 付费账号。

收益:

给社区贡献，积累你的「公开作品」
好用的插件会在社区口口相传(GitHub star 就是你的评分)
学到「写给别人用的代码」跟「自己用」的差距

三个新手最容易踩的坑

❌ 坑 1：装一堆 Plugin 不卸载

/plugin list

新手第一个月可能装了 20 个 Plugin,实际只用 3 个——剩下的每个都在加载时消耗 context 跟启动时间。

修正:每月 review 一次,3 个月没用过的卸载。/plugin list 看一眼，/plugin uninstall 删一行。/plugin 的 Installed 标签会把最近没用过的插件单独列在 Not used recently 下面，一眼就能挑出来。

❌ 坑 2：装黑盒 Plugin 在敏感项目跑

“我装了一个不知名的 auto-deploy Plugin，在我公司生产代码库跑了。”

踩坑:它可能把你的代码 / 凭证发给作者的服务器——重要场景禁止装黑盒。

修正：生产 / 含密钥的项目只装来源清楚 + 源码公开 + 安装量高或带 Anthropic verified（官方验证）标记的 Plugin（插件目录没有评分，只有安装量和这个标记）。

❌ 坑 3:Plugin 跟自己写的 Skill 冲突

「我装了 chinese-writer Plugin，但我自己也写了一个 chinese-style Skill,两个被同时召唤，写出来的东西乱七八糟。」

踩坑:功能重叠 = Claude 不知道用哪个。

修正:装了 Plugin 之后，检查你自己的 Skill,有重叠的删掉一个(留 Plugin 或留自己的)。

「Claude Code 干活」板块完结撒花

恭喜你！读完这一篇，你已经掌握了 Claude Code 的核心日常工作流:

装好 + 跑通（「文件与编程进阶：Claude Code」板块 ✅）
读 / 改 / 跑 / 撤回 / 省钱（本板块前 7 篇 ✅）
用命令、写技能、装插件（本板块后 3 篇 ✅）

这套能力组合，已经让你能干 80% 的实际工作。

下一步：进阶板块等你

接下来是 「Claude Code 进阶」板块——给已经会基础操作的你，扩展更多场景(全部已上线):

主题	你能解锁的
VS Code / Cursor 插件	跟编辑器深度集成
桌面 App	可视化 GUI(图形界面)
Hooks	Claude 改完文件自动跑你的脚本
MCP	接外部服务(Slack / GitHub / 数据库)
Subagents	多个 Claude 并行干不同活
Worktrees	多 session 隔离不打架