Claude Code 插件（Plugins）怎麼裝：添加 marketplace、推薦插件與和 Skill 的區別

本文根據 Claude Code 官方插件文檔整理，核對日期 2026-10-07。插件市場裏的插件變化很快，官方文檔也不列具體清單，以 /plugin 裏的 Discover 標籤和 claude.com/marketplace 為準。

適用於誰

• 看到別人分享「裝這個 Claude Code 插件就有 /commit 命令」，想知道怎麼裝的人；
• 搜「claude code plugin 安裝」「marketplace add」「plugin 和 skill 的區別」的人；
• 想把自己團隊的一套技能、Hooks、MCP 配置打包分發給同事的人。

結論先說

1. 插件 = 一個打包好的目錄，裏面可以有技能（Skills）、子代理（Agents）、Hooks、MCP 伺服器等，作為一個整體安裝、啟用、更新。
2. Skill 是單個能力，插件是一組能力的「安裝包」。技能、子代理、Hooks、MCP 不裝插件也能單獨用；想一次裝好別人做好的一整套、並能隨市場更新，才用插件。
3. 插件來自 marketplace（插件市場）——一個帶 .claude-plugin/marketplace.json 的倉庫或目錄，相當於目錄清單，不是商店。Anthropic 官方市場 claude-plugins-official 在你第一次啟動交互式會話時會自動添加。
4. 安裝：會話裏輸入 /plugin 瀏覽，或 /plugin install 插件名@市場名，再選安裝範圍。
5. 插件以你的身份運行代碼，無論來自哪個市場，裝之前都要看它帶了哪些 Hooks 和 MCP 伺服器。

步驟一：安裝一個官方插件

以官方文檔的例子 commit-commands（提供提交、推送、開 PR 的命令）為例：

1. 在項目裏運行 claude，然後輸入：

text
   /plugin install commit-commands@claude-plugins-official
   

在會話裏這條命令不會立即安裝，而是打開插件詳情面板讓你先檢查。不知道裝什麼的話，直接輸入 /plugin，在 Discover 標籤裏搜尋瀏覽。

1. 看詳情面板：「Will install」列出它會加入的命令、子代理、技能、Hooks、MCP / LSP 伺服器；官方市場的插件還會顯示「Context cost」——Every turn 是每條消息都要佔用的 token，When invoked 是技能被調用時額外佔用的 token。

1. 選安裝範圍（見下一節）。

1. 看安裝結果的最後一句：Plugin is now active. 表示立刻能用；提示 Run /reload-plugins to apply. 時運行 /reload-plugins；提示加載失敗就去 /plugin 的 Errors 標籤看原因。

1. 確認可用：輸入 /，插件的技能會以 /插件名:技能名 的形式出現，比如 /commit-commands:commit。

也可以不進會話，直接在終端裏裝（適合寫進初始化腳本）：

bash
claude plugin install commit-commands@claude-plugins-official

注意：在從沒打開過交互式會話的機器上，官方市場還沒註冊，腳本里要先執行 claude plugin marketplace add anthropics/claude-plugins-official。

步驟二：選對安裝範圍

選 project 範圍時要知道：提交配置只是「為大家啟用」，並不會替同事下載，每位同事還要自己運行一次 claude plugin install 名字@市場 --scope project。

終端、桌面版的本地會話、VS Code 擴展讀的是同一套設定文件，所以在一個地方裝了 user 範圍的插件，另外兩個地方也能用。雲端會話（含 claude.ai/code 網頁版）不會加載你本地設定裏的插件。

步驟三：添加其他插件市場

很多插件不在 Anthropic 的市場裏，而在作者自己的倉庫裏。先添加市場，再安裝：

text
/plugin marketplace add 作者/倉庫名
/plugin install 插件名@市場名

市場名是對方 marketplace.json 裏的 name 字段，添加成功後 Claude Code 會打印出來。/plugin marketplace add 支持幾種來源：

新版本還支持一步完成：/plugin install deploy-helper --marketplace your-org/plugins（v2.1.275 及以後）。私有倉庫會用你本機已有的 git 憑據去拉取。

Anthropic 的三個市場

一個容易踩的坑：網上不少舊教學讓你 /plugin marketplace add anthropics/claude-code，那加的是示例市場，不是官方市場。code-review、feature-dev、commit-commands、security-guidance 等在兩邊都有，官方建議從 claude-plugins-official 裝，避免裝兩份。

Anthropic 還發布了一些主題市場，比如 anthropics/skills（官方技能合集）、anthropics/knowledge-work-plugins，同樣用 /plugin marketplace add 添加。

推薦先看哪些

官方文檔明確說「目錄變化快，不在文檔裏列清單」，所以這裏只列官方文檔點名提到的 Anthropic 自維護插件，具體以 Discover 標籤為準：

• commit-commands：提交、推送、開 PR 的命令；
• code-review、feature-dev：代碼審查與功能開發流程；
• security-guidance：寫代碼時提示安全問題；
• 語言伺服器插件（code intelligence）：讓 Claude 獲得跳轉定義、查引用等代碼智能。

想在網頁上先看看，可以瀏覽 claude.com/marketplace/plugins，那裏顯示安裝量，部分插件標有「Anthropic verified」。

管理：啟用、停用、更新、卸載

• 會話裏：/plugin 後按 Tab 切到 Installed 標籤，可以啟用、停用、更新、卸載；也可以直接 /plugin disable 名字、/plugin uninstall 名字。
• 終端裏：claude plugin list、claude plugin enable / disable / uninstall 名字@市場。
• 更新：官方市場預設自動更新，其他市場（含社區和第三方）預設關閉，可以在 Marketplaces 標籤裏逐個開啟。手動更新單個插件用 claude plugin update 名字@市場；沒有「一鍵更新全部」的命令，可以在 Marketplaces 標籤選中某個市場點「Update marketplace」。更新後當前會話仍用舊版本，運行 /reload-plugins 或新開會話生效。
• 刪除市場：/plugin marketplace remove 名字 會順帶卸載從這個市場裝的所有插件。

插件很占上下文嗎？啟用的插件在每個會話都生效：每個能被 Claude 自動調用的技能、子代理的名稱和描述每一輪都在上下文裏，即使這次沒用到。用 claude plugin details 名字 可以看它「Always-on」每次固定佔多少 token；不常用的插件停用即可，不必卸載。

安裝第三方插件前的安全檢查

官方的檢查順序：

1. claude plugin marketplace list 看市場是從哪個倉庫添加的；
2. 在 /plugin 的詳情面板看「Will install」；
3. 點「Open homepage / View on GitHub」讀源碼，重點看 hooks/hooks.json（每個 Hook 執行什麼命令）、.mcp.json（每個伺服器的命令或網址）、bin/ 目錄下的所有文件；
4. 裝好後可以用 claude plugin details 名字 再核對一次組件清單。

還要記住：開啟自動更新的市場會在後台更新插件，你審過的文件可能會變。官方市場名（如 claude-plugins-official）只認 github.com/anthropics/ 下的倉庫，冒用這些名字的市場會被拒絕加載。

想自己做插件

最小結構是一個目錄加一份清單文件：

text
my-plugin/
├── .claude-plugin/plugin.json   # 名稱、版本、描述
├── skills/review/SKILL.md       # 生成 /my-plugin:review
├── agents/reviewer.md           # 子代理
├── hooks/hooks.json             # Hooks
└── .mcp.json                    # MCP 伺服器

開發時不需要市場，用 claude --plugin-dir ./my-plugin 直接加載測試；做好後放進自己的 marketplace 倉庫分享給團隊。完整步驟見官方《Create a Claude Code plugin》。

常見問題

Q：插件和 VS Code 裏的「Claude Code 擴展」是一回事嗎？

不是。VS Code / JetBrains 裏的是 IDE 擴展，用來在編輯器裏使用 Claude Code；這裏說的插件是給 Claude Code 本身增加技能、Hooks 等能力的包。

Q：claude.ai 網頁版能用這些插件嗎？

同樣的插件格式也能裝到 claude.ai 和 Cowork，但能加載的組件不同，見 claude.com 上的插件說明。你在 Claude Code 裏裝的插件不會同步到 claude.ai 帳號；反過來，在 claude.ai 目錄裏添加的插件會同步到 Claude Code，顯示為 名字@synced。

Q：提示 Plugin "xxx" not found in any marketplace？

說明你已添加的市場裏沒有這個插件：檢查拼寫，或者先 /plugin marketplace add 添加它所在的市場。

Q：插件裏的技能怎麼調用？

插件技能帶命名空間：/插件名:技能名。沒有和其他命令重名時，有些也可以直接用短名。技能本身的寫法詳見本站《Claude Skills 是什麼、怎麼裝、推薦哪些》。

參考資料

• Plugins overview（官方）：https://code.claude.com/docs/en/plugins/overview
• Install and manage plugins（官方）：https://code.claude.com/docs/en/plugins/install
• Anthropic's marketplaces（官方）：https://code.claude.com/docs/en/plugins/anthropic-marketplaces
• Plugin security and trust（官方）：https://code.claude.com/docs/en/plugins/security
• Create a Claude Code plugin（官方）：https://code.claude.com/docs/en/plugins/create