跳至主要內容

為您的組織管理 Claude Cowork 外掛程式

外掛程式市集允許 Team 和 Enterprise 方案擁有者透過 Claude Cowork 將精選外掛程式分發給組織中的所有人。您可以建立市集、新增外掛程式,並精確控制團隊成員可以看到和使用哪些外掛程式。

Team 和 Enterprise 方案的擁有者和主要擁有者可以在 Claude Desktop 上管理組織外掛程式。

需求:在使用外掛程式市集之前,必須為您的組織啟用 Cowork 和 Skills。

有兩種方式可以將外掛程式新增到市集:

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

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

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


設定手動市集

  1. 開啟 Claude Desktop 並前往 組織設定 > 外掛程式

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

  3. 如果這是您第一次設定市集,「上傳到新市集」將被自動選中。

    1. 往後上傳外掛程式時,您將能夠選擇「新增到現有市集」。

  4. 輸入市集的名稱。

  5. 將檔案拖入,或按一下上傳提示並選擇您的檔案。

    1. 注意:檔案必須是有效的 .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 分鐘。

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


控制外掛程式分發

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

偏好設定

它的作用

成員看到的內容

預設安裝

自動為所有組織成員安裝

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

可供安裝

列在外掛程式目錄中

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

不可用

完全隱藏在目錄中

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

必需

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

外掛程式會自動出現在他們的已安裝清單中,無法停用或卸載。

設定偏好設定

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

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

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

成員體驗

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

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


按群組自訂外掛程式存取

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

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

群組覆寫的運作方式

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

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

為群組設定外掛程式存取

  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 市集的名稱也會被封鎖。


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

情境

建議方法

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

GitHub 同步

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

GitHub 同步

您想要自動更新傳播

GitHub 同步

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

GitHub 同步

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

手動上傳

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

手動上傳

無法存取 GitHub 的環境

手動上傳

在將外掛程式新增至同步儲存庫之前進行測試

手動上傳


疑難排解

上傳遭拒

常見原因:檔案超過 50 MB、不是有效的 ZIP 檔案,或市集已達到 100 個外掛程式的限制。檢查檔案大小和格式,如果已達容量,請移除未使用的外掛程式。

外掛程式未出現在成員面前

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

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

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

GitHub 同步因內容錯誤而失敗

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

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

您的marketplace.json中的一個或多個外掛程式項目使用指向已連接儲存庫外部的sourcegithuburlgit-subdir來源),且目標儲存庫是私人的。組織同步目前只能從公開儲存庫擷取外部來源。將外掛程式資料夾移至市場儲存庫,並將每個項目的source變更為相對路徑(例如"./plugins/my-plugin"),然後推送並重新同步。或者,透過自訂 > 新增外掛程式 > 建立外掛程式 > 上傳外掛程式個別上傳受影響的外掛程式。

同步失敗後外掛程式消失

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

連接時看不到 GitHub 儲存庫

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

是否回答了您的問題?