跳转到主要内容

为您的组织管理插件

插件市场让 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(读取和写入)权限。

这是否解答了您的问题?