> ## Documentation Index
> Fetch the complete documentation index at: https://code.claude.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# 發佈和分發外掛程式

> 透過您自己的市集或 Anthropic 的社群市集發佈 Claude Code 外掛程式，包括發行前檢查清單以及使用者如何取得更新。

發佈 Claude Code 外掛程式意味著在市集中列出它，市集是一個 JSON 目錄，列出外掛程式及其取得位置，以便其他人可以按名稱安裝它並接收您的更新。您可以執行自己的市集或將您的外掛程式提交到 Anthropic 的社群市集。若要在不發佈的情況下共享外掛程式，請將外掛程式的目錄或其 `.zip` 檔案發送給人們以供他們自行載入。

本頁面適用於已準備好共享工作外掛程式的作者。

<Note>
  這些情況涵蓋在其他頁面上：

  * **您的外掛程式尚未完成**：從 [建立外掛程式](/docs/zh-TW/plugins/create) 開始
  * **您維護的 CLI 或 SDK 在官方市集中有外掛程式**：請參閱 [從您的 CLI 推薦您的外掛程式](/docs/zh-TW/plugins/cli-hints)
</Note>

從 [選擇分發方式](#choose-how-to-distribute) 開始，比較分發選項。如果您已經知道您的路線，請前往 [準備您的外掛程式以供發行](#prepare-your-plugin-for-release)，然後按照您的路線部分，了解要告訴使用者什麼以及他們如何接收您的更新。

<h2 id="choose-how-to-distribute">
  選擇分發方式
</h2>

根據誰需要安裝外掛程式來選擇分發選項：

| 路線                                                      | 誰可以安裝                                         | 您需要什麼                                                        | 使用者是否自動取得您的更新？ |
| :------------------------------------------------------ | :-------------------------------------------- | :----------------------------------------------------------- | :------------- |
| [無市集](#share-a-plugin-without-a-marketplace)            | 您發送外掛程式資料夾或其 `.zip` 的人                        | 外掛程式的資料夾                                                     | 無。他們載入您發送的副本   |
| [您自己的市集](#publish-through-your-own-marketplace)         | 任何可以存取存放庫的人，可以是您的團隊可以複製的私人存放庫                 | 包含列出您的外掛程式的 `.claude-plugin/marketplace.json` 的 git 存放庫或其他主機 | 關閉             |
| [Anthropic 的社群市集](#submit-to-the-community-marketplace) | 任何新增 `anthropics/claude-plugins-community` 的人 | 透過外掛程式目錄提交表單的提交                                              | 關閉             |

自動更新是使用者端的每個市集設定，在背景中取得新版本。

<h2 id="prepare-your-plugin-for-release">
  準備您的外掛程式以供發行
</h2>

名稱、版本、驗證和從市集安裝決定了發行是否對安裝它的人有效。在第一次發行前檢查它們，然後在之後的每次發行前再次檢查。

<Steps>
  <Step title="選擇永久名稱">
    使用者透過 `name@marketplace` 安裝、啟用和設定您的外掛程式，因此重新命名的外掛程式對每個現有安裝都是不同的外掛程式。選擇 kebab-case 名稱，例如 `deploy-helper`，因為 `claude plugin validate` 會對其他形式發出警告，並將其視為永久名稱。在 `plugin.json` 中設定 `displayName` 以取得使用者看到的標籤。
  </Step>

  <Step title="決定您將如何版本化">
    如果您在 `plugin.json` 中設定 `version` 並稍後推送提交而不更改它，`claude plugin update` 會列印 `<name> is already at the latest version (1.0.0).`，使用者會保留舊副本。要麼在每次發行時遞增 `version`，要麼在 git 託管的市集中省略它，以便 Claude Code 改用提交 SHA。請參閱 [版本和更新](/docs/zh-TW/plugins/loading#versions-and-updates)。
  </Step>

  <Step title="驗證">
    在您的 shell 中，執行 `claude plugin validate --strict ./your-plugin`。乾淨的執行會列印 `✔ Validation passed`。

    * **在 CI 中**：保留 `--strict`，它也會因為警告（例如未知的資訊清單欄位或缺少 `version`）而以結束代碼 1 失敗執行。如果您在上一步中選擇省略 `version`，請刪除 `--strict`。
    * **路徑**：驗證報告不以 `./` 開頭的元件路徑。在 hook 命令和 MCP 伺服器設定中，將檔案稱為 `${CLAUDE_PLUGIN_ROOT}/...`。請參閱 [路徑規則](/docs/zh-TW/plugins/manifest-reference#path-rules)。
  </Step>

  <Step title="從本機市集安裝它">
    在您的 shell 中，使用 `claude plugin marketplace add ./path-to-marketplace` 新增列出外掛程式的本機市集，從中安裝外掛程式，並啟動工作階段以確認它載入。

    * 對於最小的有效市集，請參閱 [建立市集](/docs/zh-TW/plugins/create-marketplace)。
    * 若要了解安裝是載入您的來源目錄還是快取副本，請參閱 [就地和複製的外掛程式](/docs/zh-TW/plugins/loading#in-place-and-copied-plugins)。
  </Step>

  <Step title="填入使用者看到的中繼資料">
    在 `plugin.json` 中設定 `description`、`author`、`homepage` 和 `repository`，並在外掛程式根目錄新增 `README.md`。`homepage` 必須解析為 URL。[資訊清單參考](/docs/zh-TW/plugins/manifest-reference#fields) 列出每個欄位。
  </Step>

  <Step title="執行您的評估套件">
    如果您有評估套件，請在 shell 中執行 `claude plugin eval`。它執行外掛程式的測試案例並評分結果，這在您變更外掛程式時會捕捉迴歸。請參閱 [使用評估測試外掛程式](/docs/zh-TW/plugin-evals)。
  </Step>
</Steps>

<h2 id="share-a-plugin-without-a-marketplace">
  不使用市集共享外掛程式
</h2>

如果外掛程式在 git 存放庫中，人們可以複製它並載入簽出，或從他們的 shell 使用指向您附加到發行的 `.zip` 的 `--plugin-url` 啟動 Claude Code。若要取得您的下一個版本，他們會拉取或再次下載。如果它不在存放庫中，請將目錄或其 `.zip` 發送給他們。他們可以透過以下兩種方式之一載入它：

* **對於一個工作階段**：他們從他們的 shell 使用 `claude --plugin-dir ./deploy-helper` 啟動 Claude Code，其中路徑是複製、解壓縮的資料夾或 `.zip` 本身。請參閱 [為一個工作階段載入外掛程式的旗標](/docs/zh-TW/plugins/cli-reference#flags-that-load-a-plugin-for-one-session)。
* **對於每個工作階段**：他們將外掛程式目錄（包含其 `.claude-plugin/plugin.json`）移到 `~/.claude/skills/` 下，以便 Claude Code [在每個工作階段中載入它](/docs/zh-TW/plugins/loading#find-where-a-plugin-came-from)。

將 `.claude-plugin/marketplace.json` 新增到同一存放庫是讓人們按名稱安裝並使用命令更新的方式；請參閱 [透過您自己的市集發佈](#publish-through-your-own-marketplace)。

<h3 id="ship-a-plugin-with-your-own-tool">
  使用您自己的工具發送外掛程式
</h3>

如果您維護 CLI 或 SDK，請在市集中發佈外掛程式，並讓您的安裝程式或安裝後訊息執行或列印使用者需要的兩個命令：`claude plugin marketplace add <source>`，然後 `claude plugin install <name>@<marketplace>`。對於當某人使用您的工具時的工作階段內發現，請參閱 [從您的 CLI 推薦您的外掛程式](/docs/zh-TW/plugins/cli-hints)。

<h2 id="publish-through-your-own-marketplace">
  透過您自己的市集發佈
</h2>

您自己的市集是一個 `.claude-plugin/marketplace.json` 檔案，列出您的外掛程式，新增到 git 存放庫。一旦檔案在存放庫中，外掛程式就會發佈，沒有提交表單。您可以將檔案保留在外掛程式自己的存放庫中或在單獨的存放庫中。

<h3 id="add-the-marketplace-file-to-your-repository">
  將市集檔案新增到您的存放庫
</h3>

若要從外掛程式自己的存放庫發佈，請在 `.claude-plugin/` 中的 `plugin.json` 旁邊儲存市集檔案，其中一個項目的 `source` 是 `"./"`，存放庫根目錄。給予項目與 `plugin.json` 相同的 `name`，根據 [保持項目名稱和資訊清單名稱相同](/docs/zh-TW/plugins/create-marketplace#keep-the-entry-name-and-the-manifest-name-the-same)：

```json .claude-plugin/marketplace.json theme={null}
{
  "name": "your-marketplace",
  "owner": { "name": "Your Name" },
  "plugins": [
    { "name": "deploy-helper", "source": "./" }
  ]
}
```

在您的 shell 中，在存放庫中執行 `claude plugin validate .` 以在推送前檢查檔案。

[建立市集](/docs/zh-TW/plugins/create-marketplace) 涵蓋一個存放庫中有多個外掛程式的佈局。

<h3 id="control-who-can-install">
  控制誰可以安裝
</h3>

任何可以複製存放庫的人都可以從中安裝，因此如果存放庫是私人的，市集也是私人的。對於 git 存放庫以外的主機，請參閱 [託管市集](/docs/zh-TW/plugins/host-marketplace)。若要到達整個公司的每個人，包括不使用 git 的人，請參閱 [推出到整個公司](/docs/zh-TW/plugins/host-marketplace#roll-out-to-a-whole-company)。

<h3 id="tell-users-how-to-install">
  告訴使用者如何安裝
</h3>

告訴您的使用者新增市集，然後從他們的 shell 安裝外掛程式，用您的替換來源和名稱：

* 新增市集一次：`claude plugin marketplace add your-org/your-marketplace`，其中引數是 GitHub `owner/repo` 速記、URL 或路徑
* 安裝外掛程式：`claude plugin install deploy-helper@your-marketplace`
* 或從工作階段內執行兩者：`/plugin install deploy-helper --marketplace your-org/your-marketplace`。需要 Claude Code v2.1.275 或更新版本。請參閱 [在一個命令中新增市集和安裝](/docs/zh-TW/plugins/install#add-a-marketplace-and-install-in-one-command)

<h3 id="ship-updates-to-users">
  向使用者發送更新
</h3>

使用者在要求時或為您的市集啟用自動更新時接收發行：

* **應要求**：使用者 shell 中的 `claude plugin update deploy-helper@your-marketplace` 會重新整理市集，並在您的外掛程式版本已變更時安裝新副本
* **自動更新**：預設為您的市集關閉。請參閱 [啟用自動更新](/docs/zh-TW/plugins/host-marketplace#turn-on-auto-update)。啟用後，它會在工作階段開始後延遲執行與 `claude plugin update` 相同的操作

[安裝外掛程式](/docs/zh-TW/plugins/install) 涵蓋使用者端命令，[自動更新何時執行](/docs/zh-TW/plugins/loading#when-auto-update-runs) 涵蓋時序。

<h2 id="submit-to-the-community-marketplace">
  提交到社群市集
</h2>

Anthropic 的社群市集 `claude-community` 是透過外掛程式目錄提交表單列出提交的外掛程式的公開市集。

使用者在 Claude Code 工作階段中使用 `/plugin marketplace add anthropics/claude-plugins-community` 新增社群市集，並將其安裝為 `@claude-community`。

有關社群市集與官方市集的差異，請參閱 [Anthropic 的市集](/docs/zh-TW/plugins/anthropic-marketplaces)。

若要將您的外掛程式提交到社群市集，請使用其中一個應用程式內表單：

* **claude.ai**：[claude.ai/admin-settings/directory/submissions/plugins/new](https://claude.ai/admin-settings/directory/submissions/plugins/new)
* **Console**：[platform.claude.com/plugins/submit](https://platform.claude.com/plugins/submit)

claude.ai 表單需要 Team 或 Enterprise 組織以及目錄權限，預設情況下擁有者持有該權限。不是 Team 或 Enterprise 組織一部分的個人作者可以改用 Console 表單。

在您提交前，在 shell 中本機執行 `claude plugin validate ./your-plugin`，用您的外掛程式目錄的路徑替換 `./your-plugin`。驗證通過時，Claude Code 會列印 `✔ Validation passed`，或如果有警告，則列印 `✔ Validation passed with warnings`。警告不會使驗證失敗；新增 `--strict` 以將它們視為錯誤。

列出的外掛程式出現在 [`anthropics/claude-plugins-community`](https://github.com/anthropics/claude-plugins-community) 目錄中，在幾乎每種情況下都固定到特定的提交 SHA。

提交和您的外掛程式出現在 `marketplace.json` 之間可能會有延遲。若要檢查您的外掛程式是否可安裝，請在 [社群目錄](https://github.com/anthropics/claude-plugins-community/blob/main/.claude-plugin/marketplace.json) 中搜尋其名稱。

官方市集 `claude-plugins-official` 不透過這些表單接受提交。如果您與 Anthropic 合作夥伴聯絡合作，請詢問他們有關官方市集列表。

<h2 id="ship-updates-renames-and-removals">
  發送更新、重新命名和移除
</h2>

<h3 id="release-a-new-version">
  發行新版本
</h3>

如果您透過您自己的市集發佈，並且您的 `plugin.json` 設定 `version`，請遞增它並推送。執行 `claude plugin update` 或啟用自動更新的使用者會接收新版本，如 [向使用者發送更新](#ship-updates-to-users) 下所述。

<h3 id="tag-a-release">
  標記發行
</h3>

當其他外掛程式在您的上宣告版本範圍時，在 git 中標記發行，因為這些範圍針對標籤進行解析。否則您不需要標籤。

若要標記，請從外掛程式目錄在 shell 中執行 `claude plugin tag`。它建立一個 `{name}--v{version}` 標籤。新增 `--push` 以將標籤發送到 `origin`。[`plugin tag` 參考](/docs/zh-TW/plugins/cli-reference#plugin-tag) 列出其旗標。

<h3 id="rename-or-remove-a-plugin">
  重新命名或移除外掛程式
</h3>

永遠不要變更已發佈外掛程式的 `name`。重新命名後，已安裝它的使用者會失去外掛程式，因為他們的安裝是在舊名稱下記錄的。您的市集檔案中的 `renames` 項目會改為遷移它們。當您想要不同的標籤時，變更 `displayName`。

如果重新命名是不可避免的，請使用市集檔案的 `renames` 對應，以便現有安裝遷移而不是因 [`Plugin "<name>" not found in marketplace`](/docs/zh-TW/plugins/troubleshooting#plugin-not-found-in-marketplace) 而失敗。若要從市集移除外掛程式，或取得完整的 `renames` 詳細資訊，請參閱託管頁面上的 [重新命名或移除外掛程式](/docs/zh-TW/plugins/host-marketplace#rename-or-remove-a-plugin)。[市集參考](/docs/zh-TW/plugins/marketplace-reference#top-level-fields) 有該欄位。

<h2 id="declare-dependencies">
  宣告依賴項
</h2>

如果您的外掛程式需要來自同一市集的另一個外掛程式被啟用，請在 `plugin.json` 的 `dependencies` 陣列中列出它。每個項目是一個裸名稱或具有 semver `version` 範圍的物件。當使用者安裝您的外掛程式時，Claude Code 也會安裝並啟用依賴項。

[外掛程式依賴項](/docs/zh-TW/plugins/dependencies) 涵蓋範圍語法、跨市集依賴項以及使用者如何修剪他們不再需要的依賴項。

<h2 id="next-steps">
  後續步驟
</h2>

* [託管和維護市集](/docs/zh-TW/plugins/host-marketplace)：發行新版本並讓使用者保持最新狀態
* [外掛程式依賴項](/docs/zh-TW/plugins/dependencies)：宣告和版本化您的外掛程式所依賴的外掛程式
* [從您的 CLI 推薦您的外掛程式](/docs/zh-TW/plugins/cli-hints)：提示您的 CLI 的 Claude Code 使用者安裝外掛程式
* [測量外掛程式成本和使用情況](/docs/zh-TW/plugins/measure)：查看您的外掛程式在上下文中的成本以及人們是否使用它