Skip to main content
Claude Code plugin 是一個目錄，包含 skills、agents、hooks、MCP 伺服器或其他元件，Claude Code 會將其作為一個單位進行安裝和載入。大多數 plugins 來自 marketplace，marketplace 是一個目錄，列出 plugins 及其取得位置。您也可以從某人提供給您的資料夾中載入 plugin，或建立您自己的。
以下情況在其他頁面中說明：
若要立即試用 plugin，請在 Claude Code 終端機工作階段中執行 /plugin，並從 Discover 標籤安裝一個，該標籤列出來自您的 marketplaces 的 plugins。從那裡：

​
了解什麼是 plugin

Plugin 是一個元件目錄，通常帶有 manifest。Manifest 是位於 .claude-plugin/plugin.json 的 JSON 檔案，它為 plugin 提供名稱，並可以新增版本、描述和其他中繼資料。元件是 plugin 新增到 Claude Code 的內容，例如：
  • Skills：SKILL.md 指令，Claude 在相關時載入，您也可以作為命令執行
  • Agents：Claude 可以委派給的子代理定義
  • Hooks：Claude Code 在其生命週期中的特定點執行的命令，例如每次編輯後
  • hook 模組：以 JavaScript 函式撰寫的 hook，也可以繪製窗格並新增命令。具有 hook 模組的外掛稱為 mod。有些 mod 內建於 Claude Code。
  • MCP servers：工具伺服器，Claude Code 在啟用 plugin 時連接到
此圖表顯示一個名為 my-plugin 的 plugin，其中包含 skill、agent、hooks 和 MCP 伺服器，以及 plugin 載入後您從每個檔案獲得的內容。 Diagram in two columns joined by five straight arrows. Left, the directory of a plugin named my-plugin, holding a manifest at .claude-plugin/plugin.json, skills/review/SKILL.md, agents/reviewer.md, hooks/hooks.json, .mcp.json, and other components. Right, what each file gives you in your session: the manifest sets the plugin name, my-plugin; the skill runs as /my-plugin:review; the agent file is a subagent Claude can delegate to; the hooks file holds hooks that run on lifecycle events; and .mcp.json adds an MCP server that gives Claude tools. Diagram in two columns joined by five straight arrows. Left, the directory of a plugin named my-plugin, holding a manifest at .claude-plugin/plugin.json, skills/review/SKILL.md, agents/reviewer.md, hooks/hooks.json, .mcp.json, and other components. Right, what each file gives you in your session: the manifest sets the plugin name, my-plugin; the skill runs as /my-plugin:review; the agent file is a subagent Claude can delegate to; the hooks file holds hooks that run on lifecycle events; and .mcp.json adds an MCP server that gives Claude tools. 如需 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 中的