插件市场允许 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 安装令牌。
