SpyBara
Go Premium

plugins/overview.md 2026-09-24 22:57 UTC to 2026-09-25 23:58 UTC

This page contains 142 additions and 0 deletions.

2026
Fri 25 23:58

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。從那裡：

了解什麼是 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 載入後您從每個檔案獲得的內容。

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 中的 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 載入其元件。

Diagram of the marketplace path in three boxes, left to right. A marketplace, a catalog of plugins, lists a plugin. The plugin is one directory installed as a unit, holding skills, agents, hooks, MCP servers, and other components. You install the plugin into Claude Code, which loads its components. Diagram of the marketplace path in three boxes, left to right. A marketplace, a catalog of plugins, lists a plugin. The plugin is one directory installed as a unit, holding skills, agents, hooks, MCP servers, and other components. You install the plugin into Claude Code, which loads its components.

安裝和管理 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 後，這些頁面涵蓋接下來的內容：