插件市场允许 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 已安装在该存储库中。
同步工作原理
连接存储库时会自动运行初始同步。之后,组织所有者可以选择通过转到组织设置 > 插件(在库下)、点击市场右上角的菜单按钮,然后打开"自动同步"来为每个市场启用继续自动更新:
然后,每当 PR 合并到该存储库时,GitHub 市场将自动同步。您也可以通过点击市场上的"更新"来手动触发同步。
在同步期间,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 安装令牌。

