管理您組織的外掛程式

外掛程式市集讓 Team 和 Enterprise 方案擁有者將精選外掛程式分配給組織中的所有人。您可以建立市集、新增外掛程式，並精確控制團隊成員可以看到和使用哪些外掛程式。您分配的外掛程式會出現在聊天中（網頁版和 Claude Desktop 的聊天標籤）、Claude Cowork 和 Claude Code 工作階段中，其中成員使用相同的 Claude 帳戶登入。

要求：您必須先為組織啟用 Cowork 和技能，才能使用外掛程式市集。

如需這些控制項的參考版本，請參閱 Claude Code 文件中的 管理您組織的外掛程式。

「清單」標籤列出您組織管理的每項技能和外掛程式，包括使用者為自己建立的技能和外掛程式。技能和外掛程式現在位於同一頁面上，因此您無需在設定之間切換。

對於每個項目，表格會顯示其來源、版本、功能、對象以及過去 30 天內有多少人使用過它。

若要尋找項目，請按名稱搜尋或使用篩選器：

您的組織管理的技能會出現在 組織程式庫下。您可以在 市集標籤中管理外掛程式市集。

若要對項目採取行動，請按一下其列末尾的功能表按鈕。您可以檢視詳細資料和檔案、查看版本歷史記錄，以及變更預設和群組存取權。

對於使用者建立的技能和外掛程式，清單標籤會顯示中繼資料和分享狀態。它不會顯示檔案本身。

Anthropic 提供不同功能的內建外掛程式市集，例如法律和財務。預設會將知識工作市集新增到您的組織。

若要新增 Anthropic 建立的市集：

如果知識工作市集與您的團隊無關，請將其移除：

Anthropic 建立的市集會顯示可讀的名稱，例如「知識工作」，而不是基礎儲存庫 slug。

除了 Anthropic 建立的市集外，您還可以建立自己的市集。有兩種方式可以將外掛程式新增到您建立的市集：

您可以並行使用兩種方法。例如，為核心外掛程式執行 GitHub 同步市集，為臨時工具執行單獨的手動市集。

如果您上傳的外掛程式名稱與現有外掛程式相同，它會自動覆寫先前的版本。您無需先刪除舊版本。

GitHub 同步可讓您在儲存庫中以程式碼形式管理外掛程式。推送變更時，您可以觸發同步以更新市集，手動或自動進行。

準備您的儲存庫

您可以連接託管在 github.com 或組織的 GitHub Enterprise 主機上的儲存庫。在 github.com 上，您的儲存庫必須是 私人或內部—組織市集不允許公開儲存庫。若要從 GitLab 同步，請參閱 設定 GitLab 同步市集。

GitHub 同步市集在 marketplace.json 中支援的 source 類型集合比 Claude Code 更窄。市集儲存庫內外掛程式資料夾的相對路徑（例如 "source": "./plugins/my-plugin"）完全受支援，是最簡單的選項。github、url 和 git-subdir 來源類型也受支援。npm、archive 和 command 來源類型不受支援。

外掛程式來源在三種情況下可以是私人的：

所有其他來源都在沒有憑證的情況下獲取，因此必須是 github.com、gitlab.com 或 bitbucket.org 上的公開存儲庫。任何其他主機上的來源都會被拒絕。

如果您的插件代碼位於不符合上述條件的私有存儲庫中，請將這些插件文件夾複製到市場存儲庫中，並將每個插件的來源更改為相對路徑（git subtree 或供應文件的 CI 步驟效果很好）。

有關插件結構和格式的詳細信息，請參閱插件清單參考。

其他資源：

連接存儲庫

您的個人 GitHub 令牌已驗證以確認您有訪問權限，然後 Cowork 使用其 GitHub App 安裝令牌進行同步操作。

看不到您的存儲庫？確保 Claude GitHub App 已安裝在該存儲庫中。

同步如何工作

連接存儲庫時會自動運行初始同步。在 GitHub 創建流程中，您也可以關閉「自動同步」（默認開啟）。啟用後，當拉取請求合併到市場跟蹤的分支或有人直接推送到該分支時，會運行同步。

打開或關閉自動同步的人必須在 GitHub 上對該存儲庫具有管理員級別的訪問權限。這通過其個人 GitHub 連接進行檢查，該連接與 Claude GitHub App 安裝分開。沒有管理員訪問權限時，即使 App 安裝正確且手動更新有效，頁面也會顯示「無法訪問存儲庫。確保存儲庫存在且已安裝 Claude GitHub App」。

Claude GitHub App 的Webhooks（讀取和寫入）權限也必須在安裝上獲得批准。在引入此權限之前創建的安裝上，GitHub 會顯示「Claude 正在請求更新的權限」提示，需要存儲庫或組織管理員批准。

啟用後，GitHub 存儲庫的自動同步在包含插件版本更新的拉取請求合併到存儲庫的默認分支時運行。直接推送到默認分支不會觸發同步。您可以通過點擊市場上的「重新同步」來手動觸發同步。

在同步期間，Cowork 將您存儲庫中的最新提交與上次同步的提交進行比較。如果沒有任何更改，則跳過同步。如果有更改，Cowork 會讀取清單、驗證每個插件，並用存儲庫的當前狀態替換市場中的所有插件。根據插件數量，同步最多可能需要 30 分鐘。

您可以從 gitlab.com 上的存儲庫或自管理 GitLab 實例中同步組織市場。有關支持的插件來源類型和哪些來源可以是私有的，請參閱上面的準備您的存儲庫。

開始前

第 1 步：添加 GitLab 配置

要添加 GitLab 配置：

您可以隨時從配置的菜單中使用測試連接重新運行測試。主機名之後無法更改。如果更改，請刪除配置並添加新配置。

第 2 步：添加市場

要添加市場：

Claude 會讀取專案的預設分支並驗證市集檔案，然後建立以專案路徑命名的市集。

步驟 3：自動同步

開啟 自動同步 後，每次推送到專案的預設分支都會透過 GitLab 專案上的 Webhook 觸發同步。如果您的權杖可以管理 Webhook（請參閱 開始前），Claude 會為您建立 Webhook，您無需進行其他操作。

您稍後可以從市集的選單中開啟或關閉 自動同步。開啟它會以相同方式設定 Webhook。

步驟 4：如果 Claude 無法建立 Webhook

如果權杖無法管理 Webhook，Claude 會在螢幕上顯示 在 GitLab 中完成 Webhook 設定訊息，其中包含 Webhook URL 和權杖。權杖只會顯示一次，因此請在關閉訊息前完成此步驟。

如果您遺失權杖，請從市集的選單中開啟 設定 Webhook，點擊「移除 Webhook」，然後點擊「啟用 Webhook」以取得新的權杖。舊權杖將停止運作。

市集包含外掛程式後，您可以使用安裝偏好設定來控制其分發方式。對於每個外掛程式，您可以設定四個選項之一：

成員在自訂 > 外掛程式中的探索標籤上瀏覽可用的外掛程式。您設定為「預設安裝」或「必需」的外掛程式會自動出現在他們的清單中。您設定為「可供安裝」的外掛程式會在探索上顯示，供成員自行新增。

成員無法編輯組織管理的外掛程式，這可防止對共用工具進行衝突的變更。

企業管理員可以針對特定群組覆寫外掛程式的組織範圍安裝偏好設定。例如，您可以為工程群組自動安裝外掛程式，使其可供法律部門自行安裝，並將其隱藏在其他所有人之外。

您的市集中的每個外掛程式都有組織範圍的安裝偏好設定（預設安裝、可供安裝、必需或不可用）。根據預設，每個群組都會繼承該組織範圍的設定。

當您為外掛程式設定群組層級覆寫時，它會取代該群組成員的組織範圍設定。解析順序為：群組設定，然後是組織範圍設定，然後是市集預設值。

手動建立的群組和來自您身分識別提供者的 SCIM 佈建群組都會出現在群組選擇器中，並以相同方式運作。

如果成員屬於兩個或多個群組，且這些群組對同一外掛程式有不同的設定，則會套用最寬鬆的設定。從最寬鬆到最嚴格的順序為：必需 > 預設安裝 > 可供安裝 > 不可用。

例如，如果群組 A 將外掛程式設定為「不可用」，群組 B 將其設定為「預設安裝」，則同時屬於兩個群組的成員會預設安裝該外掛程式。

如果群組被移除（例如，從您的身分識別提供者中刪除），覆寫會保留在管理 UI 中，但標記為孤立。它對成員沒有影響（因為沒有人屬於已刪除的群組），也不計入自訂存取徽章。您可以從外掛程式的「群組存取…」設定中清除孤立的覆寫。

是的。當您重新同步 GitHub 或 GitLab 連線的市集時，群組層級覆寫會保留。只有在外掛程式本身從市集中刪除時，才會移除它們。

擁有者或主要擁有者可以使用允許清單、封鎖清單或兩者來限制組織中的人員可以新增的外掛程式市集。您可以在 Claude Code 受管設定中設定這些清單，但它們也適用於 Claude 和 Claude Cowork。

若要設定允許清單或封鎖清單：

輸入您的 GitHub 組織名稱，完全按照 GitHub 顯示的方式，因為允許清單比對區分大小寫。如果來源同時在兩個清單上，則會被封鎖。

設定清單後，每當組織中的某人在 Claude、Claude Desktop 或 Cowork 中從 Git 存放庫新增市集時，Claude 都會檢查這些清單。這涵蓋使用者在「自訂」中為自己新增的市集，以及在組織設定 > 外掛程式和技能中為整個組織新增的市集。Claude 會拒絕清單不允許的任何存放庫，除了 Anthropic 內建的市集。

請記住：

如需清單接受的每個來源類型，請參閱 Claude Code 文件中的限制使用者可以安裝的內容。

若要更新外掛程式，請上傳一個具有相同外掛程式名稱的新 ZIP 檔案。新版本會自動覆蓋現有版本。外掛程式名稱是唯一識別碼，因此 legal 將始終取代 legal。

若要移除外掛程式，請在 組織設定 > 外掛程式和技能中的「庫存」標籤下將其刪除。

將您的變更推送到連接的儲存庫，然後前往 組織設定 > 外掛程式和技能，點擊「市集」標籤，找到您的市集，然後點擊「更新」以觸發同步。每次同步都會將所有外掛程式替換為儲存庫的目前狀態。如果擁有者已為市集啟用「自動同步」，則每當將包含外掛程式版本更新的提取請求合併到儲存庫的預設分支時，也會執行同步。

如需 GitLab 同步的市集，請參閱 設定 GitLab 同步的市集。

若要移除外掛程式，請從儲存庫中刪除它並觸發同步。

外掛程式名稱必須使用 以連字號分隔的小寫單字（例如 deployment-tools，而非 Deployment Tools）。以下市集名稱已保留，無法使用：

冒充官方 Anthropic 市集的名稱也會被封鎖。

常見原因：檔案超過 200 MB、不是有效的 ZIP 檔案，或市集已達到 1000 個外掛程式的限制。檢查檔案大小和格式，如果已達容量，請移除未使用的外掛程式。如果啟用了技能和外掛程式掃描，外掛程式也可能因被標記為惡意內容而被拒。檢查原因、修正問題，然後重新上傳外掛程式。

檢查市集設定中外掛程式的安裝偏好設定。如果設定為 無法使用，成員將看不到它。同時確認已為您的組織啟用 Cowork 和技能。

變更會在每個成員的下一個工作階段或外掛程式重新整理時生效。在 Claude Code 中，使用者在下次啟動 Claude Code 時會獲得變更。如果更新仍未顯示，請透過檢查市集中的外掛程式版本來確認上傳成功。

您的儲存庫中的一個或多個外掛程式可能格式不正確。修正格式問題，將更新推送到 GitHub，然後再次觸發同步。如需外掛程式結構要求，請參閱 外掛程式資訊清單參考。

您的 marketplace.json 中的一個或多個外掛程式項目使用指向連接儲存庫外部的 source（github、url 或 git-subdir 來源），組織同步無法擷取它。私人來源只在三種情況下有效：github.com 儲存庫與您的市集儲存庫共享擁有者、您組織的 GitHub Enterprise 主機上已安裝 GitHub Enterprise App 的儲存庫，或與您的市集儲存庫位於同一 GitLab 主機上的 url 或 git-subdir 來源（在 gitlab.com 上，也在相同的頂層群組或使用者命名空間下）。

對於任何其他私有來源，請將外掛程式資料夾移至市集存放庫，並將每個項目的 source 變更為相對路徑（例如 "./plugins/my-plugin"），然後推送並重新同步。或者，透過 組織設定 > 外掛程式和技能 個別上傳受影響的外掛程式，點擊「新增」、「上傳外掛程式」，然後選擇「新增至現有市集」。透過成員自己的自訂選單上傳的外掛程式僅針對該成員安裝，不會分發給您的組織，但如果啟用共享，成員可以與特定同事或群組共享外掛程式。

確保 Claude GitHub 應用程式已安裝在該存放庫中。系統會先檢查您的個人 GitHub 權杖以確認存取權，但同步本身會使用 GitHub 應用程式安裝權杖。

如果手動更新有效，但開啟「自動同步」顯示「無法存取存放庫。請確保存放庫存在且已安裝 Claude GitHub 應用程式」，可能有兩個原因：

如果在 GitLab 中新增市集時看到此訊息，請確保您已先新增 GitLab 設定。請參閱 設定 GitLab 同步市集下的 步驟 1：新增 GitLab 設定。

確保 URL 的主機名稱與已設定的 GitLab 主機名稱完全相符。

檢查專案的可見性是否為私人或內部。公開的 gitlab.com 專案無法用作組織市集。

確認執行個體可從公開網際網路透過 HTTPS 連線，且 Anthropic 的出站 IP 位址允許通過您的防火牆。「無法建立安全連線」通常表示 CA 憑證遺失或不正確。

權杖已過期、已撤銷，或缺少 設定 GitLab 同步市集下「開始前」部分中列出的範圍或角色。建立新權杖並將其貼到設定中（編輯 > 存取權杖）。