跳至主要內容

為您的組織管理外掛程式

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

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

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


使用 Anthropic 內建市集

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

若要新增 Anthropic 內建市集:

  1. 前往組織設定 > 外掛程式

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

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

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

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

  1. 前往組織設定 > 外掛程式

  2. 尋找知識工作

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

  4. 選取「移除」。

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


建立您自己的市集

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

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

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

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

設定手動市集

  1. 前往組織設定 > 外掛程式

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

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

  4. 輸入市集的名稱。

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

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

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

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

設定 GitHub 同步市集

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

準備您的儲存庫

您的儲存庫必須是私人或內部 — 組織市集不允許公開儲存庫。託管在自訂 GitHub Enterprise Server 執行個體上的儲存庫不受支援。您的儲存庫必須託管在 github.com 上。

GitHub 同步市集在 marketplace.json 中支援的 source 類型集合比 Claude Code CLI 更窄。連接儲存庫內外掛程式資料夾的相對路徑(例如 "source": "./plugins/my-plugin")完全受支援。githuburlgit-subdir 來源類型僅在目標儲存庫為公開時受支援。不支援 npmpip 來源類型。如果您的外掛程式程式碼位於單獨的私人儲存庫中,請將這些外掛程式資料夾複製到市集儲存庫(git 子模組、git 子樹或 CI 步驟效果很好),並使用相對路徑參考它們。

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

其他資源:

連接儲存庫

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

  2. 前往組織設定 > 外掛程式

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

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

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

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

同步的運作方式

當您連接儲存庫時,初始同步會自動執行。之後,組織擁有者可以前往 組織設定 > 外掛程式(在 程式庫下),點擊市集右上角的選單按鈕,然後切換「自動同步」來選擇按市集繼續自動更新:

GitHub 市集將在 PR 合併到該儲存庫時自動同步。您也可以點擊市集上的「更新」來手動觸發同步。

同步期間,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 同步的市集

將您的變更推送至連線的存放庫,然後前往組織設定 > 外掛程式,找到您的市集,並按一下「更新」以觸發同步。每次同步都會將所有外掛程式替換為存放庫的目前狀態。請注意,如果擁有者已為 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 來源),且目標儲存庫是私人的。組織同步目前只能從公開儲存庫擷取外部來源。將外掛程式資料夾移到市場儲存庫中,並將每個項目的 source 變更為相對路徑(例如 "./plugins/my-plugin"),然後推送並重新同步。或者,透過自訂 > 新增外掛程式 > 建立外掛程式 > 上傳外掛程式個別上傳受影響的外掛程式。

同步失敗後外掛程式消失

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

連接時看不到 GitHub 儲存庫

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

是否回答了您的問題?