外掛程式市集允許 Team 和 Enterprise 方案擁有者透過 Cowork 將精選外掛程式分發給整個組織中的所有人。您可以建立市集、新增外掛程式,並精確控制團隊成員可以看到和使用哪些外掛程式。
Team 和 Enterprise 方案的擁有者和主要擁有者可以在 Claude Desktop 上管理組織外掛程式。
要求:在使用外掛程式市集之前,必須為您的組織啟用 Cowork 和 Skills。
有兩種方式可以將外掛程式新增到市集:
手動上傳—透過管理員 UI 上傳個別外掛程式 ZIP 檔案。最適合快速迭代、一次性工具或不使用 GitHub 進行外掛程式開發的團隊。
GitHub 同步—連接私人 GitHub 儲存庫,Cowork 會自動從中同步外掛程式。最適合多個開發人員協作開發外掛程式或您想要版本控制的更新。
您可以並行使用兩種方法—例如,為核心外掛程式使用 GitHub 同步市集,為臨時工具使用單獨的手動市集。
設定手動市集
開啟 Claude Desktop 並前往 組織設定 > 外掛程式。
點擊「新增外掛程式」並選擇「上傳檔案」作為來源。
如果這是您第一次設定市集,「上傳到新市集」將被自動選中。
在今後上傳外掛程式時,您將能夠選擇「新增到現有市集」。
輸入市集的名稱。
拖曳您的檔案,或點擊上傳提示並選擇您的檔案。
注意:檔案必須是有效的 .zip 檔案,大小不超過 50 MB。
對您想要新增的每個外掛程式重複此步驟。
點擊「上傳」將您的外掛程式新增到新市集。
如果您上傳的外掛程式名稱與現有外掛程式相同,它會自動覆蓋先前的版本—無需先刪除舊版本。
設定 GitHub 同步市集
GitHub 同步讓您可以在儲存庫中將外掛程式作為程式碼進行管理。當您推送變更時,可以觸發同步以更新您的市集。
準備您的儲存庫
您的儲存庫必須是私人或內部—組織市集不允許公開儲存庫。託管在自訂 GitHub Enterprise Server 執行個體上的儲存庫不受支援。您的儲存庫必須託管在 github.com 上。
有關外掛程式結構和格式的詳細資訊,請參閱外掛程式參考文件。
其他資源:
連接儲存庫
確保為您的組織啟用了 Cowork 和 Skills。
前往組織設定 > 外掛程式。
點擊「新增外掛程式」並選擇「GitHub」作為來源。
以
owner/repo格式輸入儲存庫(例如,acme-corp/claude-plugins)。
您的個人 GitHub 令牌會被驗證以確認您有存取權限,然後 Cowork 使用其 GitHub App 安裝令牌進行同步操作。
看不到您的儲存庫?確保 Cowork GitHub App 已安裝在該儲存庫中。
同步如何運作
當您連接儲存庫時,初始同步會自動執行。之後,您可以透過在組織設定 > 外掛程式中點擊市集上的「檢查更新」來手動觸發同步。
在同步期間,Cowork 會比較您儲存庫中的最新提交與上次同步的提交。如果沒有任何變更,同步將被跳過。如果有變更,Cowork 會讀取清單、驗證每個外掛程式,並將市集中的所有外掛程式替換為儲存庫的目前狀態。根據外掛程式的數量,同步可能需要長達 30 分鐘。
重要:如果同步失敗,外掛程式可能會暫時被移除給您的團隊成員。如果發生這種情況,請檢查失敗訊息,修復儲存庫中的問題,推送更新,然後再次觸發同步。同步成功後,驗證您的安裝偏好設定是否仍然設定正確—它們可能在失敗期間被重設。
控制外掛程式分發
一旦您的市集有外掛程式,您可以使用安裝偏好設定來控制它們的分發方式。對於每個外掛程式,您可以設定以下三個選項之一:
偏好設定 | 功能 | 成員看到的內容 |
自動安裝 | 自動為所有組織成員安裝 | 外掛程式出現在他們的已安裝清單中,無需任何操作。成員可以選擇卸載。 |
可用 | 在外掛程式目錄中列出 | 成員在瀏覽外掛程式時會看到它,並可以自行安裝。 |
不可用 | 完全隱藏在目錄中 | 成員看不到或無法安裝外掛程式。適用於暫存或棄用外掛程式。 |
設定偏好設定
在組織設定 > 外掛程式中,導覽到您的市集。
為每個外掛程式選擇安裝偏好設定。
變更將在每個成員的下一個工作階段或外掛程式重新整理時生效。
成員體驗
成員透過 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-marketplaceclaude-code-pluginsclaude-plugins-officialanthropic-marketplaceanthropic-pluginsagent-skillslife-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 安裝令牌。
