跳至主要內容

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

昨日已更新

外掛程式市集允許 Team 和 Enterprise 方案擁有者透過 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 上。

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

其他資源:

連接儲存庫

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

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

  3. 點擊「新增外掛程式」並選擇「GitHub」作為來源。

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

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

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

同步如何運作

當您連接儲存庫時,初始同步會自動執行。之後,您可以透過在組織設定 > 外掛程式中點擊市集上的「檢查更新」來手動觸發同步。

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

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


控制外掛程式分發

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

偏好設定

功能

成員看到的內容

自動安裝

自動為所有組織成員安裝

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

可用

在外掛程式目錄中列出

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

不可用

完全隱藏在目錄中

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

設定偏好設定

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

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

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

成員體驗

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

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


更新和移除外掛程式

手動市集

若要更新外掛程式,請上傳具有相同外掛程式名稱的新 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 市集的名稱也會被阻止。


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

情境

建議方法

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

GitHub 同步

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

GitHub 同步

您想要自動更新傳播

GitHub 同步

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

GitHub 同步

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

手動上傳

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

手動上傳

沒有 GitHub 存取權限的環境

手動上傳

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

手動上傳


疑難排解

上傳被拒絕

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

外掛程式未出現給成員

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

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

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

GitHub 同步因內容錯誤而失敗

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

同步失敗後外掛程式消失

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

連接時看不到 GitHub 儲存庫

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

是否回答了您的問題?