載入中

外掛程式

第 9 課7 分鐘
載入中

外掛程式

一旦您的整個團隊都在使用某個您信任的設定,它的價值就會大幅提升。問題在於如何搬移它。您建立了一個很棒的 .claude 目錄,裡面有技能(skills)、子代理(subagents)和鉤子(hooks),然後呢?每個人在各自的機器之間複製貼上檔案,並祈禱它們能保持同步。外掛程式(Plugin)解決了這個問題。外掛程式就是 Claude Code 用來封裝一套設定,並將其從一個人傳遞給下一個人的方式。

這件事有兩個面向,我們會兩邊都談。首先是使用其他人發布的外掛程式。其次是在您建立了值得分享的東西之後,如何將其封裝成您自己的外掛程式。

什麼是外掛程式

外掛程式是一個可安裝的單元。它打包了所有您原本需要手動分享的東西:技能、子代理、鉤子和 MCP 伺服器設定,還有更多像是語言伺服器協定(language server protocol)伺服器、背景監控器和佈景主題等延伸功能。一個版本,一次安裝。

外掛程式存放的位置決定了您如何安裝它。在一個工作階段中,您可以直接依名稱安裝一個外掛程式:

/plugin install github@claude-plugins-official

這個指令會先開啟外掛程式的詳細資訊,讓您可以檢視並選擇範圍。接著 Claude Code 會安裝它,並印出一份簡短摘要。它會說明外掛程式在此工作階段中已經啟用,或是提到 /reload-plugins,並由 Claude Code 為您執行重新載入。只有在重新載入警告您的下一則訊息將會重新讀取整個對話時,您才需要介入:執行 /reload-plugins --force 以強制啟用該外掛程式。

為您的團隊新增市集

對團隊來說,更好的做法是一次性新增一個私有市集(marketplace)。市集是一個共用來源,外掛程式會透過它來解析:

/plugin marketplace add your-org/claude-plugins

您可以隨意命名。一旦新增之後,此後每次安裝都會透過它來解析。您會得到集中化的探索、版本追蹤,以及統一管理的更新,而不是分散在每個人的筆記型電腦上。

您可以從「探索」(Discover)分頁瀏覽可用的項目。它會列出您市集中的外掛程式,方便您搜尋並挑選。

安裝前先閱讀

這裡是最重要的部分。外掛程式會以您的權限在您的機器上執行程式碼。它的鉤子會在每次符合條件的工具呼叫時觸發。所以如果您是為了它的技能而安裝某個外掛程式,您同時也會得到它的 PreToolUse 和 Stop 鉤子,無論您是否讀過它們。

想想這意味著什麼。一個社群外掛程式可能內建一個 Stop 鉤子,每次都會呼叫某個網路端點,而您的設定中不會有任何東西警告您這件事。這不是避免使用外掛程式的理由,而是先看清楚再說的理由。

安裝前,請檢查外掛程式的詳細資訊。Claude Code 會顯示它將安裝的內容,並估算上下文成本,同時附上一則明確的警告:Anthropic 並不控制第三方外掛程式內部的內容。

關於外掛程式的來源,有兩件事值得了解:

  • 一個外掛程式能進入社群市集,是因為撰寫它的人將其送交給了 Anthropic。
  • 官方市集則是在另一條獨立的審核流程上策劃而成。

但「被列出」不等於「值得信任」。所以這個原則依然成立:只從您真正信任的來源安裝外掛程式和新增市集,並在啟用之前檢查外掛程式實際上做了什麼。

元件與您的設定並行運作

外掛程式不會覆寫您的設定。它的元件會與您自己的設定並行運作。這大多是件好事,但它也帶來了您應該了解的後果。

鉤子會疊加。一個外掛程式的 PreToolUse 鉤子和您自己的 PreToolUse 鉤子都會在每次工具呼叫時觸發。兩者不會互相取代。這正是為什麼您應該先閱讀詳細資訊的原因。

技能、代理和指令會以外掛程式名稱為命名空間,因此它們永遠不會與您自己的項目衝突。

一旦外掛程式安裝完成,您就可以在外掛程式面板中查看它所新增的所有內容、管理它,以及解除安裝它。

封裝您自己的外掛程式

現在談另一面。一旦您建立了一個能正常運作的 .claude 目錄,不要讓您的團隊在各機器之間複製貼上。改為將其封裝起來。

好消息是您不需要重寫任何東西。您只需將 .claude 目錄中的部分內容複製到外掛程式自己的資料夾中:

text
svg-splitter-review/
├── .claude-plugin/plugin.json
├── skills/<skill-name>/SKILL.md
├── agents/<agent-name>.md
├── hooks/hooks.json
└── .mcp.json

鉤子是唯一需要離開 settings.json 的部分:將 hooks 物件複製到 hooks/hooks.json 中。其餘部分 Claude Code 會依照慣例自動發現。若要在分享外掛程式之前先試用它,請用該資料夾啟動一個工作階段:

claude --plugin-dir ./svg-splitter-review

一旦運作正常,就從 .claude 中刪除原本的檔案,並從 settings.json 中移除 hooks 物件。在您這麼做之前,每個鉤子都會執行兩次。

清單檔案

除此之外,還有一個選擇性的清單檔案(manifest)。它位於 .claude-plugin/plugin.json,其中包含名稱、版本、描述和作者資訊:

json
{
  "name": "svg-splitter-review",
  "version": "0.1.0",
  "description": "Reviews the SVG Splitter repo",
  "author": {
    "name": "Lewis Menelaws"
  }
}

這個清單檔案是選擇性的。即使省略它,Claude Code 仍會依照目錄慣例自動發現您的元件。但有幾個細節值得了解:

  • 名稱是唯一必填的欄位。 它會將您的技能命名空間化為 /plugin-name:skill-name,所以此外掛程式中的某個技能會以 /svg-splitter-review:<skill-name> 的形式執行。這可以避免您的技能與其他人的技能發生衝突。
  • 像對待任何其他相依套件一樣管理版本。 這正是讓更新與版本追蹤能在您整個團隊中正常運作的關鍵。

重點總結

兩條簡單的規則涵蓋了這裡的大部分內容:

  • 當您使用外掛程式時,安裝前先閱讀。外掛程式會以您的權限執行程式碼,所以請先查看它的鉤子、代理和 MCP 伺服器。
  • 當您建立外掛程式時,一旦設定能運作,就立刻將您的 .claude 封裝起來。一份清單,一次安裝。

這就是重點所在。一個可安裝的單元,讓您信任的設定能夠觸及您的整個團隊。