跳转到主要内容

为您的组织管理 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 安装令牌。

这是否解答了您的问题?