外掛程式市集允許 Team 和 Enterprise 方案擁有者透過 Claude 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 上。
GitHub 同步市集在 marketplace.json 中支援的 source 類型集合比 Claude Code CLI 更窄。連接儲存庫內外掛程式資料夾的相對路徑(例如 "source": "./plugins/my-plugin")完全受支援。github、url 和 git-subdir 來源類型僅在目標儲存庫為公開時受支援。不支援 npm 和 pip 來源類型。如果您的外掛程式程式碼位於單獨的私人儲存庫中,請將這些外掛程式資料夾複製到市集儲存庫(git 子模組、git 子樹或 CI 步驟效果很好),並使用相對路徑參考它們。
如需外掛程式結構和格式的詳細資訊,請參閱 外掛程式參考文件。
其他資源:
連接儲存庫
確保為您的組織啟用了 Cowork 和 Skills。
前往 組織設定 > 外掛程式。
按一下「新增外掛程式」並選擇「GitHub」作為來源。
以
owner/repo格式輸入儲存庫(例如acme-corp/claude-plugins)。
您的個人 GitHub 權杖已驗證以確認您有存取權,然後 Cowork 使用其 GitHub App 安裝權杖進行同步操作。
看不到您的儲存庫?確保 Claude GitHub App 已安裝在該儲存庫中。
同步的運作方式
連接儲存庫時會自動執行初始同步。之後,組織擁有者可以選擇按市集繼續自動更新,方法是前往 組織設定 > 外掛程式(在 程式庫下),按一下市集右上角的功能表按鈕,然後切換「自動同步」開啟:
GitHub 市集將在每次 PR 合併到該儲存庫時自動同步。您也可以按一下市集上的「更新」來手動觸發同步。
在同步期間,Cowork 會比較您儲存庫中的最新提交與上次同步的提交。如果沒有任何變更,則跳過同步。如果有變更,Cowork 會讀取資訊清單、驗證每個外掛程式,並將市集中的所有外掛程式替換為儲存庫的目前狀態。根據外掛程式的數量,同步最多可能需要 30 分鐘。
重要:如果同步失敗,外掛程式可能會暫時為您的團隊成員移除。如果發生這種情況,請檢查失敗訊息,修正儲存庫中的問題,推送更新,然後再次觸發同步。同步成功後,驗證您的安裝偏好設定仍然設定正確—它們可能在失敗期間被重設。
控制外掛程式分發
一旦您的市集有外掛程式,您可以使用安裝偏好設定來控制它們的分發方式。對於每個外掛程式,您可以設定四個選項之一:
偏好設定 | 它的作用 | 成員看到的內容 |
預設安裝 | 自動為所有組織成員安裝 | 外掛程式會自動出現在他們的已安裝清單中,無需任何操作。成員可以選擇卸載。 |
可供安裝 | 列在外掛程式目錄中 | 成員在瀏覽外掛程式時可以看到它,並可以自行安裝。 |
不可用 | 完全隱藏在目錄中 | 成員無法看到或安裝外掛程式。適用於暫存或棄用外掛程式。 |
必需 | 自動為所有組織成員安裝,無法移除 | 外掛程式會自動出現在他們的已安裝清單中,無法停用或卸載。 |
設定偏好設定
在組織設定 > 外掛程式中,瀏覽至您的市集。
為每個外掛程式選擇安裝偏好設定。
變更會在每個成員的下一個工作階段或外掛程式重新整理時生效。
成員體驗
成員透過 Cowork 中的瀏覽外掛程式模式瀏覽可用的外掛程式。自動安裝的外掛程式會自動出現在他們的已安裝清單中。可用的外掛程式會顯示在目錄中供自助安裝。
成員無法編輯組織管理的外掛程式,這可防止對共用工具進行衝突的變更。
按群組自訂外掛程式存取
企業管理員可以為特定群組覆寫外掛程式的組織範圍安裝偏好設定。例如,您可以為工程群組自動安裝外掛程式,讓法務部門可以自行安裝,並將其隱藏在其他所有人之外。
群組層級的外掛程式存取適用於企業方案,由管理員及以上人員設定。
群組覆寫的運作方式
您市集中的每個外掛程式都有組織範圍的安裝偏好設定(預設安裝、可供安裝、必需或不可用)。根據預設,每個群組都會繼承該組織範圍的設定。
當您為外掛程式設定群組層級覆寫時,它會取代該群組成員的組織範圍設定。解析順序為:群組設定、組織範圍設定、市集預設值。
為群組設定外掛程式存取
在組織設定 > 外掛程式中,瀏覽至您的市集。
找到您要自訂的外掛程式。
在自訂存取欄中,按一下以新增群組覆寫。
選擇群組並選擇上面列出的四個安裝偏好設定之一。
手動建立的群組和來自您身分識別提供者的 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-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.com 上找不到儲存庫。請檢查 URL 並確保儲存庫是公開的。」
您的marketplace.json中的一個或多個外掛程式項目使用指向已連接儲存庫外部的source(github、url或git-subdir來源),且目標儲存庫是私人的。組織同步目前只能從公開儲存庫擷取外部來源。將外掛程式資料夾移至市場儲存庫,並將每個項目的source變更為相對路徑(例如"./plugins/my-plugin"),然後推送並重新同步。或者,透過自訂 > 新增外掛程式 > 建立外掛程式 > 上傳外掛程式個別上傳受影響的外掛程式。
同步失敗後外掛程式消失
失敗的 GitHub 同步可能會暫時從您的市場中移除外掛程式。修正根本問題,成功重新同步,然後驗證安裝偏好設定是否設定正確—它們可能已被重設。
連接時看不到 GitHub 儲存庫
確保 Cowork GitHub App 已安裝在該儲存庫中。首先檢查您的個人 GitHub 權杖以確認存取權限,但同步本身使用 GitHub App 安裝權杖。

