如何挑選外掛並安全地裝上它

一個 skill 就讓頁面明顯變好了，下一步很自然就會冒出來：不裝一個，一次裝十個。同事馬上就傳來連結："裝這個，很好用"。這些全部靠一個指令就裝上，陷阱也就在這裡。外掛看起來像一份能力清單，但實際上是程式碼，會在您的機器上以您的權限執行，並在每次和代理的對話裡佔用空間。

我們來看看外掛和 skill 有什麼不同、裡面可能裝著什麼，目錄從何而來、如何從隨便找到的來源裡分辨出可靠的，以及 Claude Code 在安裝前會顯示什麼、該怎麼讀。接著走完整個流程：安裝、在自己的任務上試用、停用、移除。最後談每次安裝前該做什麼，以及為什麼代理從網路上帶回來的任何 skill 也該問同樣的問題。

1. Skill 與 plugin

木匠把自己的作業程序寫下來：怎麼準備工作台、怎麼磨刀、怎麼照模板做出一整批。他一個人工作時，這些就放在自己的筆記本裡。後來隔壁工位的人來要一份，學徒又要另一份，一個月後對街的工坊也打電話來，一份一份寄出去就變得麻煩。於是他把幾份程序裝進一個箱子，側面貼上工坊的名牌，裡面再放一張說明：這裡有什麼、怎麼用。這樣的箱子可以整箱交出去、更新、編上版本號。

這就是外掛。不是又多一項能力，而是包在幾項能力外面的包裝。

外掛本身不是一項單獨的能力，而是分發好幾項能力的方式。它能做的一切，都是透過裡面裝的東西做到的：能力、助手、自動觸發的反應、連線。所以"外掛能做什麼"這個問題，最後都會變成另一個問題：裡面裝了什麼。

當別人開始來要您的 skills 時，就是自己做一個外掛的時候了。如果拿不準自己到底需要什麼 - skill、有獨立角色的助手，還是外掛 - 就問代理，但請它先問清楚問題，而不是馬上動手打包：它會做出草稿，裡面裝了什麼由您來檢查。判斷的原則很簡單：一再重複同一個請求 - skill；旁支的工作把對話弄亂了 - 助手；另一個專案也需要同一套東西 - 外掛。外掛具體怎麼一步步組裝，是另一個話題。這篇文章是寫給拿到箱子的人看的。

2. 外掛裡裝了什麼

箱子裡通常有五個隔間，而它們並非同樣無害。

• skills - 代理依描述自行套用，或依您的指令套用的程序；
• agents - 有獨立角色的助手，代理會把部分工作交給它們；
• hooks - 對事件的自動反應：一旦發生某件事，不必您開口就會執行指令；
• MCP servers - 與外部服務的連線，代理透過它們讀取和修改您電腦以外的東西；
• LSP servers - 針對特定語言的程式碼提示；它們需要另外安裝一個程式。

下面兩個隔間，正是這箱子要仔細驗收、不能隨手丟進角落的原因。裝了 hooks 和 MCP 的外掛，能做一些"一套能力"讓人想不到的事：執行指令、連到外部服務。裡面裝的是通了電的工具，不是掛在牆上的海報。hooks、MCP、agents 各自是什麼，是另外的話題；這裡只需要知道它們出現在外掛裡代表什麼。除了這五種，還有別的隔間，例如預設設定或代理的回應風格，但它們不會改變整體樣貌。

如果手邊沒有卡片，可以請代理打開外掛的儲存庫，說明它的資料夾裡放了什麼。

3. 名稱帶前綴

來自外掛的 skills 名稱會帶前綴：/外掛名稱:skill名稱，例如 /commit-commands:commit。隔壁的人可能也有一個"清理"，只要箱子上有名牌，就不會搞混。

代價是名稱變長：用上共用的一套東西，指令就得多打幾個字。專案資料夾裡自己的 skill 沒有前綴。

但也有好處。在 / 選單裡，看前綴就永遠知道這個指令從哪裡來、是誰的箱子。

4. 目錄和兩個步驟

箱子是從倉庫取來的。外掛目錄，英文叫 marketplace，是某人維護的一份別人的外掛清單。使用它分兩步：先加入目錄，再從裡面一個一個安裝外掛。加入目錄本身不會安裝任何東西，您只是拿到一份清單。

對大多數人來說，第一步早就做好了。指令 /plugin 會打開一個有四個分頁的面板：Discover - 在所有已加入的目錄中搜尋外掛；Installed - 已安裝的外掛；Marketplaces - 目錄清單；Errors - 載入錯誤。Anthropic 的官方目錄從第一次啟動就已加入，Discover 分頁裡馬上就看得到它的外掛：挑一個、打開、安裝。同樣的清單也在網站 claude.com/plugins 上，不想開 Claude Code 也能看。

當官方目錄裡沒有需要的外掛時，第二種目錄就派上用場：社群目錄，或是某個放著目錄檔案的別人的儲存庫。加入它只需一個指令，從裡面安裝外掛也是一個指令：

/plugin marketplace add anthropics/claude-plugins-community   # 加入社群目錄
/plugin install 外掛名稱@claude-community                  # 從中安裝一個外掛
/plugin list                                                  # 確認外掛已在清單中

加入別人的目錄，用的也是上面第一個指令，只是換成它的位址。

有個最容易踩到的細節（我自己也不例外）。安裝時用的目錄名稱，不是來自儲存庫的名稱，而是來自目錄本身的說明：儲存庫叫 anthropics/claude-plugins-community，但安裝時用的是 claude-community。目錄的名稱在 Marketplaces 分頁裡看得到。

官方目錄裡放著不同類型的外掛。GitHub 整合是 MCP，連到外部服務。某種語言的程式碼提示，比如 typescript-lsp，是 LSP。security-guidance 會檢查代理的每個改動有沒有典型的安全漏洞。

5. 對來源的三種信任等級

外掛不會自己從資料夾裡載入：得明確安裝，這不是走形式。裡面是會以您的權限執行的程式碼，也就是能做到您在這台電腦上能做的一切。所以任何外掛的第一個問題，不是"它能做什麼"，而是"它從哪裡來"。

官方目錄。由 Anthropic 維護，內容經過篩選。提供程式碼提示的小型官方外掛，安裝時不必多想。

社群目錄。通過 Anthropic 自動審查的第三方外掛，每個都固定在目錄裡的某個版本上。這是一道過濾，不是保證：沒有人驗證過外掛做的是不是它承諾的那件事。

任意儲存庫或資料夾。完全沒有審查。您得自己看作者是誰、有沒有清楚的說明，以及資料夾裡放了什麼。

同一個工作階段裡可能同時遇到全部三種等級：一個設計外掛來自社群目錄，另一個來自 Anthropic 目錄，第三個來自只放了單一外掛的別人的儲存庫。這沒問題，只要您隨時清楚自己站在哪個等級上。

謹慎程度要看外掛本身。它能做的越多，也就是裡面的 hooks 和 MCP 越多，來源離官方越遠，就越該仔細看。

6. Claude Code 在安裝前會顯示什麼

來源決定該看多仔細，細節則由 Claude Code 自己顯示：在 /plugin 面板的 Discover 分頁打開外掛，就會看到它的卡片。

卡片上有三行，是這一切的重點所在。

• Will install - 內容組成：會裝進多少 skills、agents、hooks、MCP 和 LSP；
• Context cost - 外掛會在代理的上下文視窗裡多佔多少，也就是代理每一輪都要重讀的那部分；
• Last updated - 外掛上次更新的時間。

Will install:  skills: 8   agents: 1   hooks: 2   MCP servers: 1
Context cost:  ~1.5k tokens
Last updated:  2 weeks ago

數字是隨手舉的例子，每個外掛各不相同。讀懂內容組成很簡單，但這只是初步判斷：如果裡面只有 skills，外掛多半是負責讀取和提出建議；有 hooks 或 MCP，它就會執行指令或連到外部，這時該打開說明，弄清楚具體是哪些。卡片沒有顯示全部：外掛還可能帶來卡片上沒列出的執行檔和預設設定。對陌生的來源，也該看一眼儲存庫。

卡片不會問的第三個問題是：這個外掛適不適合您。就算是好的外掛，也可以選擇不裝。它可能和您自己的 skill 重複、帶進別的作業系統用的腳本，或是解決一個您根本沒有的問題。

7. 外掛分給誰

箱子分給誰，是安裝時就先決定好的。有三個選項。

• user - 給您，在所有專案裡都有效；
• project - 給所有用這個儲存庫工作的人：設定會寫進 .claude/settings.json，隨專案一起流通；
• local - 只給您，而且只在這個專案裡，同事看不到。

還有一種 managed：由管理員安裝，您無法更改。大多數人不會遇到它。

規則只有一條：選最窄的合用 scope。外掛啟用的地方越少，它會被觸發的情境就越少，之後要清理的東西也越少。範圍窄不代表可疑的外掛就變安全了：在啟用的地方，它照樣能做同樣的事。project scope 值得特別提一句：您決定的不只是自己的事。同事打開這個儲存庫，就會被提示安裝您寫進去的東西。

從面板安裝時會問 scope；/plugin install 也會打開一張讓您挑選的卡片。

8. 安裝並檢查

如果安裝順利，最後會出現兩種訊息之一：外掛已經生效，或是要求您執行 /reload-plugins。遇到第二種就執行它；如果指令提醒重新載入會重讀整個對話，就加上 --force 再試一次。不需要重新啟動 Claude Code。

外掛裝好了沒有，看 /plugin list 就知道：它會出現在清單裡，它的 skills 也會帶著前綴出現在 / 選單中。

打開的箱子會佔用工作台。啟用的外掛從第一秒起，就會把自己 skills 的簡介，也就是名稱和說明，加進代理的上下文視窗。完整內容只在 skill 真正派上用場時才會載入，但這些簡介會一直留在那裡。連到外部服務的部分會馬上帶來工具名稱，說明則視需要才載入；自動反應幾乎不佔視窗空間。視窗越滿，每個回答就越貴、越慢。

真正的代價只有比較才看得出來：/context 會顯示視窗裡塞了什麼。安裝前跑一次，安裝後再跑一次。

1) 沒裝外掛：做自己的任務，記住結果
2) 裝上外掛，需要的話執行 /reload-plugins
3) 再做一次同樣的任務
4) 比較並決定：保留、停用，還是移除

這裡刻意沒有寫出比較的結果：每個人的答案都不一樣。判斷標準很簡單：您能不能用兩句話說清楚這個外掛在做什麼，並且說出一個保留或移除它的理由 - 而且是從自己的試跑得出來的，不是從說明裡看來的。

9. 停用、移除、去掉目錄

三個動作，各不相同。/plugin disable 只是停用，不會移除：外掛不再佔用視窗，想恢復就用 /plugin enable。/plugin uninstall 完全移除。/plugin marketplace remove 去掉整個目錄，連同從裡面安裝的所有外掛一起刪除。這一點很容易忘記。

/plugin disable 外掛名稱@目錄      # 停用，但不會失去它
/plugin uninstall 外掛名稱@目錄    # 完全移除
/plugin marketplace remove 目錄       # 去掉目錄和從裡面安裝的一切

這些指令會打開同一個面板並讓它保持開啟，按 Esc 關閉。在 Installed 分頁裡，同樣的事不用指令也能做：有問題的外掛排在上面，停用的收合在下面。如果移除的是為整個專案啟用的外掛，Claude Code 會問：只影響您，還是所有人。

清理。您自己裝的外掛，如果連續十個工作階段、兩週都沒用過，Claude Code 會收進 Installed 分頁的"Not used recently"標題底下，卡片上也會顯示外掛上次運作的時間。另外 /doctor 會列出沒在用的外掛，連同它們在上下文裡的代價。一套工具能不能一直是一套工具，取決於您是不是還記得裡面有什麼、為什麼裝。

更新。官方目錄會自動更新，並要求執行 /reload-plugins；第三方目錄預設不會。更新幾乎等於重新安裝一次：內容組成可能改變，值得把卡片重新打開看一遍。

如果出了問題，包括安裝過程本身出錯：Errors 分頁會顯示原因。接下來可以停用、重新安裝，最後手段是清空外掛快取再重裝一次。如果 Marketplaces 分頁裡的官方目錄不見了，/plugin marketplace add anthropics/claude-plugins-official 能把它找回來。

10. 不只是外掛

代理依您的要求從別人的儲存庫下載、放進專案資料夾的 skill，情況一樣，只是少了目錄、卡片和 scope。除了您沒有人會去檢查它。

問題是一樣的。它從哪裡來。裡面裝了什麼：SKILL.md 一分鐘就讀完，但要檢查的是整個資料夾 - 它引用的腳本和檔案也一樣。它預先允許自己用哪些工具：allowed-tools 欄位。它顯示的是不必另外詢問就能用的東西，不是可能發生的一切的完整清單。來自第三方服務儲存庫的 skill 完全可能允許自己執行指令，而對一個要向外傳送東西的 skill 來說，這很正常。但這件事該在第一次執行前看清楚，而不是之後才發現。

和外掛只有一點不同。skill 沒有卡片，但它全部的內容都以純文字的形式放在旁邊，第一次執行前就能讀完。

11. 每次安裝前該做什麼

六個步驟，順序和文章裡出現的一樣。

1. 來源。官方目錄、社群目錄還是別人的儲存庫 - 這決定了接下來該看多仔細。
2. 內容組成。卡片上的"Will install"；hooks 和 MCP 代表執行指令和連到外部，遇到它們就打開說明看。
3. 代價。卡片上的"Context cost"，以及安裝前後的 /context：外掛的代價從您的每一次請求裡扣。
4. Scope。選最窄的合用範圍；project scope 也是替同事做的決定。
5. 試跑。安裝前後各做一次同樣的任務，結論來自自己的測試，不是說明文字。
6. 決定。保留、停用或移除；過幾週 Installed 分頁會提醒您哪些一直沒在用。

貼了名牌的箱子，是為了讓程序能整套交出去、不必一份一份寄送而發明的，這在兩個方向上都成立。拿到箱子的人看看名牌、打開蓋子，只把今天用得上的東西放上工作台。

外掛面板和訊息文字會隨版本改變；如果您的畫面和這裡描述的不一樣，請以每一行的意思為準，而不是它的確切樣子。