Claude Code 外掛(Plugins)教學:怎麼裝、從哪找、每個吃多少 token,我實際裝了 7 個官方外掛

部分實測2026.10.15

Claude Code 的外掛(plugin)把技能、子代理、hooks、MCP 伺服器打包成一包,一行指令就能裝。這篇照官方文件整理怎麼從市集安裝、三種安裝範圍、怎麼停用和移除、安不安全,以及我在測試機上實際裝了 7 個官方熱門外掛,量它們每次對話多吃多少 token。官方市集我數到 315 個外掛。2026 年 10 月 15 日實測。

更新 2026/10/15・約 10 分鐘讀完・查證環境:Vercel Sandbox 的雲端測試機(Ubuntu、2 核心 4 GB),Claude Code 2.1.299,沒有登入。用 claude plugin 指令加入官方市集、安裝 7 個外掛、看每個外掛的內容和 token 估算、停用、移除,也建了一個空白外掛並驗證。登入之後在對話裡實際使用外掛、/plugin 的畫面沒有測

先講結論

  • 外掛是一包現成的設定:裡面可以有技能(Skills)、子代理、hooks、MCP 伺服器。在 Claude Code 裡打 /plugin 就能逛和安裝;寫成指令是 /plugin install 外掛名稱@市集名稱。
  • 我裝了 7 個官方熱門外掛:每次對話常駐多吃的 token 從 0 到約 194 個不等,真正用到技能時才會再載入幾百到兩千多個。純 hooks 或 MCP 伺服器的外掛,常駐是 0(MCP 的工具說明要連上才算得出來)。
  • 外掛能用你的權限在電腦上執行程式。官方市集叫 claude-plugins-official,舊教學裡的 anthropics/claude-code 是示範市集,不是官方的。裝之前先看它會裝進什麼。
目錄
  1. 外掛是什麼
  2. 從哪裡找外掛
  3. 怎麼安裝
  4. 實測:7 個官方外掛,各吃多少 token
  5. 停用、更新、移除
  6. 自己做一個外掛
  7. 安全嗎
  8. 這篇沒有測的

在社群裡常看到有人分享「裝這個外掛,Claude Code 會變好用」,附上一行 /plugin install 開頭的指令。照著貼之前,你大概會想知道三件事:外掛到底是什麼?裝了會不會讓 Claude Code 變慢、變貴?安不安全?

這篇照 Claude Code 官方文件回答這三件事。我也在雲端測試機上實際操作了一遍:加入官方市集、裝了 7 個熱門外掛、看每個外掛會讓每次對話多吃多少 token,再停用、移除,最後自己建一個空白外掛。測試機沒有登入 Claude 帳號,所以登入之後在對話裡實際使用外掛的部分,這篇沒有。

外掛是什麼

官方的定義是:外掛是一個資料夾,裡面可以放這幾種東西,Claude Code 會把它們當成一組來安裝和載入:

  • 技能(Skills):一份 SKILL.md 說明書,Claude 判斷用得到時會讀,你也可以當指令直接叫。
  • 子代理:可以把工作交給它的分身。
  • Hooks:在固定時機自動執行的指令,例如每次改完檔案之後。
  • MCP 伺服器:讓 Claude 多一組工具,例如查文件、操作瀏覽器。

這些東西單獨也能用。技能、子代理、hooks、MCP 怎麼個別設定,站上各有一篇:Skills、子代理、Hooks、MCP。官方的建議是:想把好幾樣包成一包,給同事用、裝在很多專案、或發布成有版本的東西,才需要外掛。反過來說,裝別人做好的外掛,就是一行指令拿到一整套設定,之後還能跟著更新。

從哪裡找外掛

外掛放在「市集」裡。市集其實只是一個 GitHub 上的目錄,列出有哪些外掛、去哪裡下載。Anthropic 自己有三個:

市集名稱 來源 內容
claude-plugins-official anthropics/claude-plugins-official 官方市集,Anthropic 維護的加上合作夥伴的
claude-community anthropics/claude-plugins-community 作者投稿的社群外掛
claude-code-plugins anthropics/claude-code 示範用的幾個範例

有一個容易搞混的地方:很多舊教學叫你執行 /plugin marketplace add anthropics/claude-code,那加的是示範市集,不是官方市集。官方文件特別提醒,code-review、commit-commands 這幾個兩邊都有,要從官方市集裝,免得裝成兩份。這個 anthropics/claude-code 的 repo 裡還有什麼、為什麼找不到原始碼,在 Claude Code GitHub。

我在測試機上把官方市集的目錄打開來數,10 月 15 日一共有 315 個外掛,大部分是各家服務自己出的,像 AWS、Atlassian、Canva、Cloudflare、Datadog,讓 Claude Code 可以直接接他們的服務。想用網頁逛,官方的 Claude Marketplace 網站(claude.com/marketplace)可以搜尋,還看得到安裝次數。

官方文件寫,Claude Code 第一次開互動式的對話時,會自動把官方市集加進來。我的測試機只跑過指令、沒開過對話,市集清單裡就只有一個內建的 Anthropic 目錄,官方市集要自己加:

claude plugin marketplace add anthropics/claude-plugins-official

這行是從 GitHub 複製一份目錄下來,1 秒就好。

怎麼安裝

在 Claude Code 對話裡

打 /plugin,會打開外掛的面板,Discover 分頁列出你所有市集的外掛,可以打字搜尋。

知道名稱的話,直接打:

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

格式是「外掛名稱@市集名稱」。在對話裡這樣打不會馬上安裝,而是先打開這個外掛的說明頁,列出它會裝進什麼,官方市集的外掛還會顯示 token 的估算,看完再選安裝範圍。

三種安裝範圍

  • 使用者範圍:這台電腦上你的所有專案都能用,記在 ~/.claude/settings.json。
  • 專案範圍:記在專案的 .claude/settings.json,跟著程式碼進版本控制,同事拉下來也會啟用(但每個人還是要自己裝一次)。
  • 本機範圍:只有你、只在這個專案,記在 .claude/settings.local.json。

同一個外掛在不同範圍設定不一樣時,本機蓋過專案,專案蓋過使用者。終端機、桌面版、VS Code 外掛讀的是同一組設定,在其中一個裝了,另外兩個也有。

在終端機直接裝

不想開對話,或要寫在安裝腳本裡,用:

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

預設是使用者範圍,加 --scope project 或 --scope local 可以改。另外,用 claude -p 跑的非互動模式不能打 /plugin,但已經裝好的外掛照樣會載入。

實測:7 個官方外掛,各吃多少 token

外掛不是裝了放著就沒事。官方文件說得很清楚:啟用的外掛每次對話都會載入,它的技能、子代理的名稱和說明,每一輪都會帶給 Claude,這些都算在你的用量裡;MCP 伺服器會跟著每個對話一起跑,hooks 也會照時機觸發。

claude plugin details 會列出一個外掛的內容和 token 估算。我在測試機上裝了 7 個常被推薦的官方外掛,每個安裝都在 1 秒左右,結果如下:

外掛 裡面有什麼 每次對話常駐 真正用到時再加
code-review 1 個技能 約 13 這次沒記到
frontend-design 1 個技能 約 59 約 2,300
commit-commands 3 個技能 約 71 每個 130 到 420
feature-dev 1 個技能+3 個子代理 約 194 技能約 1,200,子代理 440 到 660
security-guidance 4 個 hooks 0 不佔模型的 context
context7 1 個 MCP 伺服器 0 工具說明連上才算
playwright 1 個 MCP 伺服器 0 工具說明連上才算

單位是 token。幾個看得出來的地方:

技能型的外掛常駐很小,十幾到兩百個 token,比一則短訊息還少。真正的成本在用到的那一刻:frontend-design 一叫出來就要讀約 2,300 個 token 的說明。

security-guidance 這種只有 hooks 的外掛,詳細資料裡註明它在 Claude Code 這一層執行,不佔模型的 context,所以常駐是 0。社群外掛就不一定這麼小,我另外清點過近 4 萬顆星的 oh-my-claudecode,每次對話常駐約 2,940 個 token,在 oh-my-claudecode 是什麼。它和 /security-review、Claude Security 外掛各管什麼,我實測過 /security-review 抓漏洞,整理在 Claude Code Security 怎麼用。

MCP 型的外掛顯示 0,不代表沒成本。工具的說明要等 MCP 伺服器連上才知道有多少,這個估算沒算進去。MCP 工具多的話,影響可能比技能型的大。

所以實際的建議是:外掛不用怕裝,但不用的就停掉。裝了之後到底吃多少,可以在 /usage 的用量拆解裡看到每個外掛占的比例,看法在 Claude Code 用量怎麼看。官方的 /plugin 面板裡,已安裝的分頁有一組「最近沒用到」,可以從那裡挑。

停用、更新、移除

claude plugin disable commit-commands@claude-plugins-official
claude plugin enable commit-commands@claude-plugins-official
claude plugin uninstall commit-commands@claude-plugins-official
claude plugin update commit-commands@claude-plugins-official

停用就是保留檔案、暫時不載入。我在測試機上停用後,claude plugin list 裡它的狀態變成 disabled,其他的照常啟用;移除也是 1 秒左右。在對話裡用 /plugin 的已安裝分頁,也能做一樣的事。

自己做一個外掛

claude plugin init 可以幫你建一個空白外掛:

claude plugin init my-plugin

我在測試機上跑,它建在 ~/.claude/skills/my-plugin,裡面只有兩個檔:一個 .claude-plugin/plugin.json(名稱、版本 0.1.0、待填的說明),和一份 SKILL.md 範本。訊息說它下次開對話會自動載入,想馬上用,在對話裡打 /reload-plugins。

改好之後用 claude plugin validate 檢查格式。我驗證這個空白外掛,結果是通過,只附了一個警告:沒有填作者資訊。

想先試、不想裝,可以用 claude --plugin-dir <資料夾> 只在這一次對話載入。要給別人裝,官方文件有發布到自己市集或投稿到 Anthropic 目錄的說明。

安全嗎

官方文件那一頁的第一句就是:你裝的外掛,可以用你的使用者權限在電腦上執行任意程式。它能做的包括:

  • hooks 在固定時機跑 shell 指令;
  • 背景指令(monitors)在對話開始時自己啟動;
  • MCP 和 LSP 伺服器以程式的形式在你電腦上跑;
  • 外掛的 bin/ 資料夾會加進 Claude 執行指令時的路徑。

市集分三級:官方、社群、第三方。官方和社群的名稱,Claude Code 只接受來自 Anthropic 自己 GitHub 帳號的來源,冒名的會被擋。但市集的名稱只代表誰發布這份目錄,不代表裡面每個外掛都被逐一審過。

比較穩的做法是:先從官方市集挑,裝之前看說明頁列的「會裝進什麼」,有 hooks 或 MCP 的多看一眼它要跑什麼。用 Telegram 遙控 Claude Code 的 Channels 也是一個外掛,裝起來的樣子在 Claude Code 遠端操作。

這篇沒有測的

登入之後在對話裡實際叫用外掛的技能;/plugin 面板的畫面和 Context cost 的顯示;從 claude.ai 帳號同步過來的外掛。我的測試機沒有登入,只用了 claude plugin 這組指令。

常見問題

Claude Code 的外掛是什麼?跟 Skills、MCP 差在哪?

外掛是一個資料夾,把技能、子代理、hooks、MCP 伺服器這些東西打包在一起,一次裝好、一起更新。技能、MCP 單獨也能用,官方的建議是:想把好幾樣東西包成一包、給別人或多個專案用,才需要外掛。

Claude Code 外掛怎麼安裝?

在 Claude Code 對話裡打 /plugin,從 Discover 分頁挑;或直接打 /plugin install 外掛名稱@claude-plugins-official,它會先打開說明頁讓你選安裝範圍。不想開對話,可以在終端機用 claude plugin install,預設裝在使用者範圍,所有專案都能用。

裝外掛會不會比較耗用量?

會一點。啟用的外掛,它的技能和子代理的名稱、說明每次對話都會帶著。我量到的 7 個外掛,常駐是 0 到約 194 個 token;真正叫用技能時才會再多幾百到兩千多個。不常用的外掛可以停用,不必移除。

外掛安全嗎?

官方文件寫得很直接:外掛可以用你的使用者權限在電腦上執行任意程式,包括 hooks、背景指令、MCP 伺服器。官方和社群市集的名稱只接受來自 Anthropic 自己 GitHub 的來源,但市集名稱只代表誰發布目錄,裝之前還是要看它會裝什麼。

這篇怎麼查證的

這篇只有一部分實際跑過,其餘依官方文件整理,查證日期 2026/10/15(Vercel Sandbox 的雲端測試機(Ubuntu、2 核心 4 GB),Claude Code 2.1.299,沒有登入。用 claude plugin 指令加入官方市集、安裝 7 個外掛、看每個外掛的內容和 token 估算、停用、移除,也建了一個空白外掛並驗證。登入之後在對話裡實際使用外掛、/plugin 的畫面沒有測)。哪些有跑、哪些沒跑,文中各段有寫。價格與方案以官方頁面為準,工具改版後內容可能過期。