Plugins 概述

了解什麼是 Claude Code plugin，何時需要使用 plugin 而不是獨立的 skill 或 MCP 伺服器，以及應該閱讀哪個頁面來安裝或建立 plugin。

Claude Code plugin 是一個目錄，包含 skills、agents、hooks、MCP 伺服器或其他元件，Claude Code 會將其作為一個單位進行安裝和載入。大多數 plugins 來自 marketplace，marketplace 是一個目錄，列出 plugins 及其取得位置。您也可以從某人提供給您的資料夾中載入 plugin，或建立您自己的。

若要立即試用 plugin，請在 Claude Code 終端機工作階段中執行 /plugin，並從 Discover 標籤安裝一個，該標籤列出來自 Anthropic 官方 marketplace 和您已新增的任何 marketplace 的 plugins。從那裡：

• 安裝和管理 plugins：完整的安裝步驟、範圍和其他介面
• 建立 plugin：建立您自己的
• 決定您是否需要 plugin：plugin 是否是您想要的正確工具

了解什麼是 plugin

Plugin 是一個元件目錄，通常帶有 manifest。Manifest 是位於 .claude-plugin/plugin.json 的 JSON 檔案，它為 plugin 提供名稱，並可以新增版本、描述和其他中繼資料。元件是 plugin 新增到 Claude Code 的內容，例如：

• Skills：SKILL.md 指令，Claude 在相關時載入，您也可以作為命令執行
• Agents：Claude 可以委派給的子代理定義
• Hooks：Claude Code 在其生命週期中的特定點執行的命令，例如每次編輯後
• MCP servers：工具伺服器，Claude Code 在啟用 plugin 時連接到

此圖表顯示一個名為 my-plugin 的 plugin，其中包含上述每種元件之一，以及 plugin 載入後您從每個檔案獲得的內容。

如需 plugin 可以包含的每種元件類型及其示例，請參閱 Plugin 元件。若要查看每個部分在 plugin 目錄中的位置，請使用該頁面上的 plugin 探索工具。

決定您是否需要 plugin

Skills、子代理、hooks 和 MCP 伺服器都可以獨立運作，無需 plugin。例如，您在 ~/.claude/skills/ 中保存的 skill 在您機器上的每個專案中都可用。若要單獨設定其中一個，請參閱 Skills、Subagents、Hooks 或 MCP。

當您想要將多個 skills、子代理、hooks 或 MCP 伺服器打包為一個單位時，請使用 plugin。安裝一個以獲得某人建立的設定，只需一個命令並從其 marketplace 獲得更新。建立一個以將您自己的設定提供給隊友，在許多專案中安裝它，或發佈版本化版本。

啟用的 plugin 對您的工作階段的影響

啟用的 plugin 是每個工作階段的一部分，不僅是您使用它的工作階段。這有幾個後果值得在安裝之前了解：

• 上下文和使用情況：對於每個 skill、agent 和 Claude 可以自行調用的命令，名稱和描述都在 Claude 的每個回合的上下文中，以便 Claude 知道它存在。這些令牌計入您的使用情況，並在上下文視窗中留下更少的空間，即使在 plugin 中沒有任何內容執行的工作階段中也是如此。skill 或 agent 的完整文本僅在使用時載入。Plugin 的 MCP 伺服器每個回合新增的內容遵循 MCP 工具搜尋。
• 程序：plugin 定義的 MCP 伺服器在啟用它的每個工作階段旁邊執行，其 hooks 在其事件處觸發。
• 權限：plugin 執行的內容以您的身份執行。請參閱 Plugin 安全性和信任，了解首先要檢查的內容。

您可以在每個階段檢查 plugin 的佔用空間：

• 安裝前：從 /plugin 中的 Marketplaces 標籤開啟 plugin。Anthropic 官方 marketplace 中的 Plugins 在那裡顯示 Context cost 估計。
• 安裝後：測量 plugin 的成本顯示如何讀取 plugin 的佔用空間，Installed 標籤的 Not used recently 群組列出您可以關閉的 plugins。
• 在不卸載的情況下停止它：使用 /plugin 或在您的 shell 中使用 claude plugin disable 停用 plugin。請參閱管理已安裝的 plugins。

從 marketplace 取得 plugins

Marketplace 是一個儲存庫或目錄，具有 .claude-plugin/marketplace.json 檔案，該檔案列出 plugins 及其取得位置。它是一個目錄，不是託管商店。您新增一次 marketplace，然後按名稱從中安裝 plugins，例如 commit-commands@claude-plugins-official。

Claude Code 在您第一次啟動互動式終端機工作階段時新增 Anthropic 的官方 marketplace，除非受管原則阻止它。Claude Code 不會自行新增任何其他 marketplace，包括 Anthropic 的社群和演示 marketplaces。若要區分三個 Anthropic marketplaces，請閱讀 Anthropic 的 marketplaces。若要查看官方 marketplace 列出的內容，請在工作階段中開啟 /plugin 的 Discover 標籤或瀏覽 Claude Marketplace。

此圖表顯示從 marketplace 到您的工作階段的路徑。Marketplace 列出 plugin，您安裝該 plugin，Claude Code 載入其元件。

安裝和管理 plugins 有您執行 Claude Code 的每個位置的安裝步驟。在您開發 plugin 時，您不需要 marketplace：使用 --plugin-dir 直接從其資料夾載入它，如在沒有 marketplace 的情況下開發所示。

在您的工作階段中提供已安裝的 plugin

在您安裝的 plugin 為您提供可以執行的 skill 之前，它必須存在於以下每個層級：

• 設定：您的設定列出您已新增的 marketplaces 和啟用的 plugins。
• 磁碟：~/.claude/plugins/ 保存 Claude Code 已取得和安裝的內容。
• 工作階段：plugins 在啟動時載入，或當您重新載入 plugins時。

閱讀 Plugin 載入參考，了解每個層級的規則，包括哪個設定檔優先以及檔案在磁碟上的位置。

區分 Anthropic 的 marketplaces 和第三方 marketplaces

Marketplace 的名稱將其放在三個層級之一中。Claude Code 僅接受來自 github.com/anthropics/ 儲存庫的 marketplaces 的官方和社群名稱：

• 官方：具有 Anthropic 官方 marketplace 名稱之一的 marketplaces，包括 claude-plugins-official 和演示 marketplace claude-code-plugins。
• 社群：具有 Anthropic 社群名稱之一的 marketplaces，例如 claude-community。按名稱識別 Anthropic 的 marketplaces 列出它們。
• 第三方：所有其他 marketplaces。您的同事或您的組織發佈的 marketplace 是第三方。

無論層級如何，您安裝的 plugin 都可以使用您的使用者權限執行程式碼。閱讀 Plugin 安全性和信任，了解如何在安裝 plugin 之前檢查它。

通過受管設定，組織可以允許列表或阻止 marketplaces、強制安裝 plugins 並關閉僅工作階段載入。閱讀為您的組織管理 plugins，了解這些控制項。

了解安裝範圍

當您安裝 plugin 時，您選擇一個範圍，範圍決定誰啟用了 plugin：

• 使用者範圍：在此電腦上的每個專案中為您啟用
• 專案範圍：通過已提交的 .claude/settings.json 為在此儲存庫中工作的每個人啟用。每個協作者仍然在自己的機器上安裝它
• 本機範圍：僅在此儲存庫中為您啟用

您在終端機、桌面應用程式的本機工作階段或 VS Code 擴充功能中以使用者範圍安裝的 plugin 在該電腦上的其他兩個中可用，因為所有三個都讀取相同的設定檔。請參閱選擇安裝範圍，了解如何選擇一個。

雲端工作階段（包括瀏覽器中 claude.ai/code 的工作階段）不會載入您本機設定中的 plugins。如需終端機、VS Code 和桌面應用程式中的安裝步驟，以及雲端工作階段載入的內容，請參閱安裝 plugin。

後續步驟

大多數人首先從 Anthropic 的官方 marketplace 安裝 plugin，Claude Code 在您第一次啟動互動式終端機工作階段時新增該 marketplace。在終端機工作階段中執行 /plugin 以瀏覽它，或遵循安裝和管理 plugins，其中也涵蓋桌面應用程式和 VS Code。若要在開啟 Claude Code 之前查看該 marketplace 中的內容，請在網路上瀏覽 Claude Marketplace。

若要建立您自己的，建立 plugin 從空目錄開始，以工作中的 plugin 結束。

安裝或建立 plugin 後，這些頁面涵蓋接下來的內容：

• 分享您建立的內容：發佈和分發 plugin，透過您自己的 marketplace 或 Anthropic 的目錄
• 檢查它是否有效且被使用：使用 evals 測試 plugins 和測量 plugin 成本和使用情況
• 為您的團隊執行 marketplace：建立 marketplace，然後託管和維護 marketplace
• 為組織設定 plugin 原則：為您的組織管理 plugins
• 修復問題：Plugin 故障排除