跳至主要內容

為您的組織管理外掛程式

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

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

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


使用 Anthropic 內建市集

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

若要新增 Anthropic 內建市集:

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

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

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

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

  1. 找到 知識工作

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

  3. 選取「移除」。

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


建立您自己的市集

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

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

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

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

設定手動市集

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

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

  3. 輸入市集的名稱。

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

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

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

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

設定 GitHub 同步市集

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

準備您的儲存庫

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

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

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

其他資源:

連接儲存庫

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

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

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

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

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

同步的運作方式

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

啟用自動同步會在連接的儲存庫上建立 Webhook。切換此選項的人必須在 GitHub 上擁有該儲存庫的管理員級別存取權限。這是透過其個人 GitHub 連接進行檢查,與 Claude GitHub 應用程式安裝分開。如果沒有管理員存取權限,即使應用程式安裝正確且手動更新有效,頁面也會顯示「無法存取儲存庫。請確保儲存庫存在且已安裝 Claude GitHub 應用程式」。

Claude GitHub 應用程式的 Webhooks(讀取和寫入)權限也必須在安裝時獲得批准。在引入此權限之前建立的安裝上,GitHub 會顯示「Claude 正在要求更新的權限」提示,需要儲存庫或組織管理員批准。

啟用後,當包含外掛程式版本更新的提取請求合併到儲存庫的預設分支時,自動同步就會執行。直接推送到預設分支不會觸發同步。您可以隨時按一下市集上的「更新」來手動觸發同步。

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

將您的變更推送至連線的存放庫,然後前往 組織設定 > 外掛程式,找到您的市集,然後按一下「更新」以觸發同步。每次同步都會將所有外掛程式取代為存放庫的目前狀態。如果擁有者已為市集啟用「自動同步」,則每當將包含外掛程式版本更新的提取要求合併至存放庫的預設分支時,也會執行同步。

若要移除外掛程式,請從存放庫刪除它並觸發同步。


限制

限制

備註

外掛程式 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 安裝令牌。

開啟「自動同步」時出現「無法存取儲存庫」

如果手動更新有效,但開啟「自動同步」顯示「無法存取儲存庫。確保儲存庫存在且已安裝 Claude GitHub App」,可能有兩個原因:

  • 您沒有儲存庫的管理員存取權限。開啟自動同步會建立 webhook,這需要透過您的個人 GitHub 連接對儲存庫進行管理員級別的存取。請要求儲存庫管理員啟用切換,或升級您的 GitHub 存取權限。

  • Claude GitHub App 的 Webhooks 權限尚未獲得批准。在較舊的安裝上,GitHub 會顯示「Claude 正在要求更新的權限」提示。儲存庫或組織管理員需要在安裝上批准Webhooks(讀取和寫入)權限。

是否回答了您的問題?