插件市场让团队和企业计划所有者可以向组织中的所有人分发精选插件。您可以创建市场、向其中添加插件,并精确控制团队成员可以看到和使用哪些插件。您分发的插件会同时出现在聊天(网页版和 Claude Desktop 中的聊天标签)和 Claude Cowork 中。
团队和企业计划的所有者和主要所有者可以在组织设置 > 插件中管理组织插件。
要求:在使用插件市场之前,必须为您的组织启用 Cowork 和 Skills。
使用 Anthropic 内置市场
Anthropic 为不同功能(如法律和财务)提供内置插件市场。默认情况下,知识工作市场会添加到您的组织中。
添加 Anthropic 内置市场:
转到组织设置 > 插件。
点击"添加插件"。
选择"浏览 Anthropic 来源"。
对于您希望为组织中的每个人显示的每一个,点击"添加"。
如果知识工作市场与您的团队无关,请将其删除:
转到组织设置 > 插件。
找到知识工作。
点击右上角的菜单按钮。
选择"删除"。
Anthropic 内置市场显示可读名称,如"知识工作",而不是底层存储库 slug。
创建您自己的市场
除了 Anthropic 内置市场外,您还可以创建自己的市场。有两种方法可以向您创建的市场添加插件:
手动上传:通过管理员 UI 上传单个插件 ZIP 文件。最适合快速迭代、一次性工具或不使用 GitHub 进行插件开发的团队。
GitHub 同步:连接私有 GitHub 存储库,Cowork 会自动从中同步插件。最适合多个开发人员协作开发插件或您希望进行版本控制的更新。
您可以并行使用两种方法。例如,为核心插件运行 GitHub 同步市场,为临时工具运行单独的手动市场。
设置手动市场
转到组织设置 > 插件。
点击"添加插件"并选择"上传文件"作为来源。
如果这是您第一次设置市场,"上传到新市场"会自动选中。稍后上传插件时,您将能够选择"添加到现有市场"。
输入市场的名称。
将文件拖入,或点击上传提示并选择您的文件。文件必须是有效的 .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 已安装在该仓库中。
同步工作原理
连接仓库时会自动运行初始同步。之后,组织所有者可以通过进入组织设置 > 插件(在库下),点击市场右上角的菜单按钮,然后切换"自动同步"来选择按市场继续自动更新:
GitHub 市场将在 PR 合并到该仓库时自动同步。你也可以通过点击市场上的"更新"来手动触发同步。
同步期间,Cowork 会比较你仓库中的最新提交与上次同步的提交。如果没有变化,同步将被跳过。如果有变化,Cowork 会读取清单、验证每个插件,并用仓库的当前状态替换市场中的所有插件。同步可能需要长达 30 分钟,具体取决于插件数量。
重要提示:如果同步失败,插件可能会暂时为你的团队成员移除。如果发生这种情况,请检查失败消息,在你的仓库中修复问题,推送更新,然后再次触发同步。同步成功后,验证你的安装偏好设置仍然正确设置——它们可能在失败期间被重置。
在手动上传和 GitHub 同步之间选择
场景 | 推荐方法 |
插件在版本控制中维护,带有 CI/CD | GitHub 同步 |
多个开发者协作开发插件 | GitHub 同步 |
你想要自动更新传播 | GitHub 同步 |
你需要在市场中拥有超过 100 个插件 | GitHub 同步 |
快速原型设计或一次性工具 | 手动上传 |
由非工程团队构建的插件 | 手动上传 |
无法访问 GitHub 的环境 | 手动上传 |
在将插件添加到同步仓库之前测试它 | 手动上传 |
控制插件分发
一旦你的市场有了插件,你可以使用安装偏好设置来控制它们的分发方式。对于每个插件,你可以设置四个选项之一:
偏好设置 | 它的作用 | 成员看到的内容 |
默认安装 | 自动为所有组织成员安装 | 插件在他们的已安装列表中显示,无需任何操作。成员可以选择卸载。 |
可供安装 | 在插件目录中列出 | 成员在浏览插件时看到它,可以自己安装。 |
不可用 | 完全从目录中隐藏 | 成员看不到或无法安装该插件。适用于暂存或弃用插件。 |
必需 | 自动为所有组织成员安装,无法移除 | 插件在他们的已安装列表中显示,无需任何操作,无法禁用或卸载。 |
设置偏好设置
在组织设置 > 插件中,导航到你的市场。
为每个插件选择安装偏好设置。
更改在每个成员的下一个会话或插件刷新时生效。
成员体验
成员通过浏览插件模态框浏览可用插件。自动安装的插件自动显示在他们的已安装列表中。可用插件显示在目录中供自助安装。
成员无法编辑组织管理的插件,这可以防止对共享工具的冲突更改。
按组自定义插件访问
企业管理员可以为特定群组覆盖插件的组织范围安装偏好设置。例如,您可以为工程团队自动安装插件,允许法务团队自行安装,并对其他所有人隐藏。
群组级别的插件访问权限在企业计划中可用,由管理员及以上权限的用户配置。
群组覆盖的工作原理
您的市场中的每个插件都有一个组织范围的安装偏好设置(默认安装、可供安装、必需或不可用)。默认情况下,每个群组都继承该组织范围的设置。
当您为插件设置群组级别覆盖时,它会替换该群组成员的组织范围设置。解析顺序为:群组设置、组织范围设置、市场默认设置。
为群组设置插件访问权限
在组织设置 > 插件中,导航到您的市场。
找到您要自定义的插件。
在自定义访问权限列中,点击"添加群组"。
选择群组并选择上面列出的安装偏好设置之一。
手动创建的群组和来自您身份提供商的 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 市场的名称也被禁止。
注意:插件作者可以设置 displayName,以便插件在目录中显示可读的名称而不是其 slug。如果作者未设置,插件将显示其 slug(例如,deployment-tools)。
故障排除
上传被拒绝
常见原因:文件超过 50 MB、不是有效的 ZIP 文件,或市场已达到 100 个插件的限制。检查文件大小和格式,如果已满容量,请删除未使用的插件。
插件未为成员显示
检查市场设置中插件的安装偏好。如果设置为不可用,成员将看不到它。还要确认为您的组织启用了 Cowork 和 Skills。
更新的插件未为成员反映
更改将在每个成员的下一个会话或插件刷新时生效。如果更新仍未显示,请通过检查市场中的插件版本来确认上传成功。
GitHub 同步因内容错误而失败
您的仓库中的一个或多个插件可能格式不正确。修复格式问题,将更新推送到 GitHub,然后再次触发同步。有关插件结构要求,请参阅插件参考文档。
同步失败,显示"尚不支持外部插件源",或插件被跳过,显示"在 github.com 上找不到存储库。检查 URL 并确保存储库是公开的。"
您的 marketplace.json 中的一个或多个插件条目使用指向连接的存储库外部的 source(github、url 或 git-subdir 源),且目标存储库是私有的。组织同步目前只能从公开存储库获取外部源。将插件文件夹移到市场存储库中,并将每个条目的 source 更改为相对路径(例如,"./plugins/my-plugin"),然后推送并重新同步。或者,通过自定义 > 添加插件 > 创建插件 > 上传插件单独上传受影响的插件。
同步失败后插件消失
失败的 GitHub 同步可能会暂时从您的市场中删除插件。修复根本问题,重新同步成功,然后验证安装偏好设置是否正确——它们可能已被重置。
连接时看不到 GitHub 仓库
确保 Claude GitHub App 已安装在该存储库中。首先检查您的个人 GitHub 令牌以确认访问权限,但同步本身使用 GitHub App 安装令牌。

