跳至主要內容

為您的組織管理外掛程式

外掛程式市集讓 Team 和 Enterprise 方案擁有者將精選外掛程式分發給組織中的所有人。您可以建立市集、新增外掛程式,並精確控制團隊成員可以看到和使用哪些外掛程式。您分發的外掛程式會同時出現在聊天(網頁版和 Claude Desktop 中的聊天標籤)和 Claude Cowork 中。

Team 和 Enterprise 方案的擁有者和主要擁有者可以在 組織設定 > 外掛程式中管理組織外掛程式。

要求:您必須先為組織啟用 Cowork 和 Skills,才能使用外掛程式市集。


使用 Anthropic 內建市集

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

若要新增 Anthropic 內建市集:

  1. 按一下「新增外掛程式」。

  2. 選取「瀏覽 Anthropic 來源」。

  3. 在您想要為組織中的所有人顯示的每個外掛程式上按一下「新增」。

若要移除知識工作市集(如果與您的團隊無關):

  1. 找到知識工作

  2. 按一下右上角的功能表按鈕。

  3. 選取「移除」。

Anthropic 內建市集會顯示易讀的名稱(例如「知識工作」),而不是基礎儲存庫 slug。


建立您自己的市集

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

  • 手動上傳:透過管理員 UI 上傳個別外掛程式 ZIP 檔案。最適合快速迭代、一次性工具或不使用 GitHub 進行外掛程式開發的團隊。

  • GitHub 同步:連接私人 GitHub 儲存庫,Cowork 會自動從中同步外掛程式。最適合多個開發人員協作開發外掛程式或您想要版本控制更新的情況。

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

設定手動市集

  1. 按一下「新增外掛程式」並選取「上傳檔案」作為來源。

  2. 如果這是您第一次設定市集,「上傳到新市集」會自動選取。稍後上傳外掛程式時,您將能夠選擇「新增到現有市集」。

  3. 輸入市集的名稱。

  4. 將檔案拖入,或按一下上傳提示並選取您的檔案。檔案必須是有效的 .zip,大小不超過 50 MB。

  5. 對您想要新增的每個外掛程式重複此步驟。

  6. 按一下「上傳」將您的外掛程式新增到新市集。

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

設定 GitHub 同步市集

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

準備您的儲存庫

您的儲存庫必須是私人或內部的——組織市集不允許公開儲存庫。您可以連接在 github.com 或組織的 GitHub Enterprise 主機上託管的儲存庫。

GitHub 同步市集在 marketplace.json 中支援的 source 類型集合比 Claude Code 更窄。市集儲存庫內外掛程式資料夾的相對路徑(例如 "source": "./plugins/my-plugin")完全受支援,是最簡單的選項。githuburlgit-subdir 來源類型也受支援。npmarchivecommand 來源類型不受支援。

外掛程式來源在兩種情況下可以是私人的:與市集儲存庫擁有者共享的 github.com 來源(組織同步透過 Claude GitHub App 擷取),或組織 GitHub Enterprise 主機上安裝了組織 GitHub Enterprise App 的來源。所有其他來源都在沒有認證的情況下擷取,因此不同擁有者下的 github.com 儲存庫和其他主機上的儲存庫(例如 GitLab 或 Bitbucket)必須是公開的。

如果您的外掛程式程式碼位於不符合上述條件的私人儲存庫中,請將這些外掛程式資料夾複製到市集儲存庫中,並將每個外掛程式的來源變更為相對路徑(git subtree 或供應檔案的 CI 步驟效果很好)。

如需外掛程式結構和格式的詳細資訊,請參閱外掛程式參考文件

其他資源:

連接儲存庫

  1. 確保為您的組織啟用了 Cowork 和 Skills。

  2. 按一下「新增外掛程式」並選取「GitHub」作為來源。

  3. owner/repo 格式輸入儲存庫(例如 acme-corp/claude-plugins)。

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

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

同步如何運作

當您連接儲存庫時,初始同步會自動執行。之後,組織擁有者可以選擇加入每個市場的持續自動更新,方法是前往 組織設定 > 外掛程式,點擊市場右上角的選單按鈕,然後切換「自動同步」開啟:

啟用自動同步會在連接的儲存庫上建立 webhook。切換開啟的人必須在 GitHub 上對該儲存庫具有管理員級別的存取權限。這是透過其個人 GitHub 連接進行檢查的,該連接與 Claude GitHub App 安裝分開。如果沒有管理員存取權限,即使 App 已正確安裝且手動更新有效,頁面也會顯示「無法存取儲存庫。確保儲存庫存在且已安裝 Claude GitHub App」。

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

啟用後,當包含外掛程式版本更新的拉取請求合併到儲存庫的預設分支時,自動同步會執行。直接推送到預設分支不會觸發同步。您可以隨時透過點擊市場上的「更新」來手動觸發同步。

在同步期間,Cowork 會比較您儲存庫中的最新提交與上次同步的提交。如果沒有任何變更,同步會被跳過。如果有變更,Cowork 會讀取清單、驗證每個外掛程式,並將市場中的所有外掛程式替換為儲存庫的目前狀態。同步可能需要長達 30 分鐘,具體取決於外掛程式的數量。

重要:如果同步失敗,外掛程式可能會暫時為您的團隊成員移除。如果發生這種情況,請檢查失敗訊息,修復儲存庫中的問題,推送更新,然後再次觸發同步。同步成功後,請驗證您的安裝偏好設定仍然設定正確,因為它們可能在失敗期間被重設。

在手動上傳和 GitHub 同步之間選擇

情境

建議方法

外掛程式在版本控制中維護,具有 CI/CD

GitHub 同步

多個開發人員協作開發外掛程式

GitHub 同步

您想要自動更新傳播

GitHub 同步

您需要在市場中擁有超過 100 個外掛程式

GitHub 同步

快速原型設計或一次性工具

手動上傳

由非工程團隊建立的外掛程式

手動上傳

沒有 GitHub 存取權限的環境

手動上傳

在將外掛程式新增到同步的儲存庫之前測試它

手動上傳


控制外掛程式分發

一旦您的市場有外掛程式,您可以使用安裝偏好設定來控制它們的分發方式。對於每個外掛程式,您可以設定四個選項之一:

偏好設定

它的作用

成員看到的內容

預設安裝

自動為所有組織成員安裝

外掛程式會出現在他們的已安裝清單中,無需任何操作。成員可以選擇卸載。

可供安裝

列在外掛程式目錄中

成員在瀏覽外掛程式時會看到它,並可以自行安裝。

不可用

完全隱藏在目錄中

成員看不到或無法安裝外掛程式。適用於暫存或棄用外掛程式。

必需

自動為所有組織成員安裝,無法移除

外掛程式會出現在他們的已安裝清單中,無需任何操作,且無法停用或卸載。

設定偏好設定

  1. 組織設定 > 外掛程式中,瀏覽至您的市場。

  2. 為每個外掛程式選擇安裝偏好設定。

  3. 變更會在每個成員的下一個工作階段或外掛程式重新整理時生效。

成員體驗

成員透過瀏覽外掛程式模式瀏覽可用的外掛程式。自動安裝的外掛程式會自動出現在其已安裝清單中。可用的外掛程式會顯示在目錄中供自助安裝。

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


按群組自訂外掛程式存取

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

群組層級外掛程式存取適用於企業方案,並可由管理員及以上人員設定。

群組覆寫的運作方式

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

當您為外掛程式設定群組層級覆寫時,它會取代該群組成員的組織範圍設定。解析順序為:群組設定、組織範圍設定、市場預設值。

為群組設定外掛程式存取

  1. 組織設定 > 外掛程式中,瀏覽至您的市場。

  2. 找到您要自訂的外掛程式。

  3. 自訂存取欄中,按一下「新增群組」。

  4. 選取群組並選擇上述列出的其中一個安裝偏好設定。

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

當成員屬於多個群組時會發生什麼

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

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

注意:這與群組支出限制的解析方式不同。支出限制會根據您的多群組支出限制設定套用較高或較低的群組值。外掛程式存取會套用最寬鬆的值,因為此處的群組旨在為需要工具的團隊啟用存取,而不是作為安全邊界。如果您需要硬性封鎖外掛程式,請將其組織範圍偏好設定設為「不可用」,並僅向應該擁有存取權的群組授予存取權。

刪除群組時會發生什麼

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

群組設定在市場重新同步時是否會保留?

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


更新和移除外掛程式

手動市場

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

若要移除外掛程式,請在組織設定 > 外掛程式中從您的市場刪除它。

GitHub 同步的市場

將您的變更推送至連線的儲存庫,然後前往組織設定 > 外掛程式,找到您的市場,然後按一下「更新」以觸發同步。每次同步都會將所有外掛程式替換為儲存庫的目前狀態。如果擁有者已為市場啟用「自動同步」,則每當將包含外掛程式版本更新的提取要求合併至儲存庫的預設分支時,也會執行同步。

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


限制

限制

備註

最大外掛程式 ZIP 大小(上傳)

50 MB

在用戶端和伺服器端強制執行

每個市場的最大外掛程式數(手動)

100

每個市場

每個市場的最大外掛程式數(GitHub 同步)

500

每個市場

最大外掛程式名稱長度

64 個字元

必須使用以連字號分隔的小寫字詞

同步逾時

30 分鐘

每個同步操作

GitHub 儲存庫可見性

僅限私人或內部使用

託管在 github.com 或 GitHub Enterprise Server 上。不支援公開儲存庫。


命名規則

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

  • claude-code-marketplace

  • claude-code-plugins

  • claude-plugins-official

  • anthropic-marketplace

  • anthropic-plugins

  • agent-skills

  • life-sciences

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

注意:外掛程式作者可以設定 displayName,讓外掛程式在目錄中顯示易讀的名稱,而不是其 slug。如果作者未設定,外掛程式會顯示其 slug(例如 deployment-tools)。


疑難排解

上傳遭拒

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

外掛程式未為成員顯示

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

更新的外掛程式未為成員反映

變更會在每個成員的下一個工作階段或外掛程式重新整理時生效。如果更新仍未顯示,請檢查市集中的外掛程式版本以確認上傳成功。

GitHub 同步因內容錯誤而失敗

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

同步失敗,顯示「尚不支援外部外掛程式來源」,或外掛程式被略過,顯示「在 github.com 上找不到儲存庫。檢查 URL 並確保儲存庫是公開的。」

marketplace.json 中的一個或多個外掛程式項目使用指向已連接儲存庫外部的 sourcegithuburlgit-subdir 來源),組織同步無法擷取它。私人來源只在兩種情況下有效:github.com 儲存庫與您的市集儲存庫共享相同的擁有者,或您組織的 GitHub Enterprise 主機上的儲存庫已安裝您的 GitHub Enterprise App。

對於任何其他私人來源,請將外掛程式資料夾移至市集儲存庫,並將每個項目的 source 變更為相對路徑(例如 "./plugins/my-plugin"),然後推送並重新同步。或者,透過組織設定 > 外掛程式 > 新增外掛程式 > 上傳檔案個別上傳受影響的外掛程式,然後選擇「新增至現有市集」。透過成員自己的自訂功能表上傳的外掛程式僅為該成員安裝,不會分發到您的組織。

同步失敗後外掛程式消失

失敗的 GitHub 同步可能會暫時從您的市集中移除外掛程式。修正根本問題、成功重新同步,然後驗證安裝偏好設定是否設定正確,因為它們可能已被重設。

連接時看不到 GitHub 儲存庫

確保 Claude GitHub App 已安裝在該儲存庫中。首先檢查您的個人 GitHub 權杖以確認存取權限,但同步本身使用 GitHub App 安裝權杖。

開啟「自動同步」時出現「無法存取儲存庫」

如果手動更新有效,但開啟「自動同步」顯示「無法存取儲存庫。確保儲存庫存在且已安裝 Claude GitHub App」,可能有兩個原因:

  • 您沒有儲存庫的管理員存取權限。開啟自動同步會建立 webhook,這需要透過您的個人 GitHub 連接對儲存庫進行管理員級別的存取權限。請要求儲存庫管理員啟用切換,或升級您的 GitHub 存取權限。

  • Claude GitHub App 的 Webhooks 權限尚未獲得批准。在較舊的安裝上,GitHub 會顯示「Claude 正在要求更新的權限」提示。儲存庫或組織管理員需要在安裝上批准Webhooks(讀取和寫入)權限。

是否回答了您的問題?