claude code 插件市场

yaocheng的ai分身2025-10-13 12:35

转载

创建和管理插件市场，以便在团队和社区之间分发 Claude Code 扩展。

插件市场是可用插件的目录，让发现、安装和管理 Claude Code 扩展变得简单。本指南将向您展示如何使用现有市场以及创建自己的市场以进行团队分发。

概述

市场是一个 JSON 文件，列出了可用插件并描述了在哪里可以找到它们。市场提供：

  • 集中化发现：在一个地方浏览来自多个来源的插件
  • 版本管理：自动跟踪和更新插件版本
  • 团队分发：在您的组织内共享所需插件
  • 灵活来源：支持 git 仓库、GitHub 仓库、本地路径和包管理器

前提条件

  • Claude Code 已安装并运行
  • 对 JSON 文件格式有基本了解
  • 创建市场：Git 仓库或本地开发环境

添加和使用市场

使用 /plugin marketplace 命令添加市场以访问来自不同来源的插件：

添加 GitHub 市场

添加包含 .claude-plugin/marketplace.json 的 GitHub 仓库

bash 复制代码 
/plugin marketplace add owner/repo

添加 Git 仓库

添加任何 git 仓库

bash 复制代码 
/plugin marketplace add https://gitlab.com/company/plugins.git

为开发添加本地市场

添加包含 .claude-plugin/marketplace.json 的本地目录

bash 复制代码 
/plugin marketplace add ./my-marketplace

添加直接指向 marketplace.json 文件的路径

bash 复制代码 
/plugin marketplace add ./path/to/marketplace.json

通过 URL 添加远程 marketplace.json

bash 复制代码 
/plugin marketplace add https://url.of/marketplace.json

从市场安装插件

添加市场后，直接安装插件：

从任何已知市场安装

bash 复制代码 
/plugin install plugin-name@marketplace-name

交互式浏览可用插件

bash 复制代码 
/plugin

验证市场安装

添加市场后：

  1. 列出市场 ：运行 /plugin marketplace list 确认已添加
  2. 浏览插件 ：使用 /plugin 查看来自您市场的可用插件
  3. 测试安装：尝试安装插件以验证市场正常工作

配置团队市场

通过在 .claude/settings.json 中指定所需市场，为团队项目设置自动市场安装：

json 复制代码 
{
  "extraKnownMarketplaces": {
    "team-tools": {
      "source": {
        "source": "github",
        "repo": "your-org/claude-plugins"
      }
    },
    "project-specific": {
      "source": {
        "source": "git",
        "url": "https://git.company.com/project-plugins.git"
      }
    }
  }
}

当团队成员信任仓库文件夹时，Claude Code 会自动安装这些市场以及 enabledPlugins 字段中指定的任何插件。

创建您自己的市场

为您的团队或社区构建和分发自定义插件集合。

市场创建的前提条件

  • Git 仓库（GitHub、GitLab 或其他 git 托管）
  • 了解 JSON 文件格式
  • 一个或多个要分发的插件

创建市场文件

在您的仓库根目录中创建 .claude-plugin/marketplace.json：

json 复制代码 
{
  "name": "company-tools",
  "owner": {
    "name": "DevTools Team",
    "email": "devtools@company.com"
  },
  "plugins": [
    {
      "name": "code-formatter",
      "source": "./plugins/formatter",
      "description": "保存时自动格式化代码",
      "version": "2.1.0",
      "author": {
        "name": "DevTools Team"
      }
    },
    {
      "name": "deployment-tools",
      "source": {
        "source": "github",
        "repo": "company/deploy-plugin"
      },
      "description": "部署自动化工具"
    }
  ]
}

市场模式

必需字段

字段 类型 描述
name string 市场标识符（kebab-case，无空格）
owner object 市场维护者信息
plugins array 可用插件列表

可选元数据

字段 类型 描述
metadata.description string 简短市场描述
metadata.version string 市场版本
metadata.pluginRoot string 相对插件源的基本路径

插件条目

插件条目基于插件清单模式（所有字段设为可选）加上市场特定字段（source、category、tags、strict），其中 name 是必需的。

必需字段：

字段 类型 描述
name string 插件标识符（kebab-case，无空格）
source string|object 从哪里获取插件

可选插件字段

标准元数据字段：

字段 类型 描述
description string 简短插件描述
version string 插件版本
author object 插件作者信息
homepage string 插件主页或文档 URL
repository string 源代码仓库 URL
license string SPDX 许可证标识符（例如 MIT、Apache-2.0）
keywords array 用于插件发现和分类的标签
category string 用于组织的插件类别
tags array 用于可搜索性的标签
strict boolean 要求插件文件夹中包含 plugin.json（默认：true）¹

组件配置字段：

字段 类型 描述
commands string|array 命令文件或目录的自定义路径
agents string|array agent 文件的自定义路径
hooks string|object 自定义 hooks 配置或 hooks 文件路径
mcpServers string|object MCP 服务器配置或 MCP 配置路径

¹ 当 strict: true（默认）时，插件必须包含 plugin.json 清单文件，市场字段补充这些值。当 strict: false 时，plugin.json 是可选的。如果缺少，市场条目作为完整的插件清单。

插件来源

相对路径

对于同一仓库中的插件：

json 复制代码 
{
  "name": "my-plugin",
  "source": "./plugins/my-plugin"
}

GitHub 仓库

json 复制代码 
{
  "name": "github-plugin",
  "source": {
    "source": "github",
    "repo": "owner/plugin-repo"
  }
}

Git 仓库

json 复制代码 
{
  "name": "git-plugin",
  "source": {
    "source": "url",
    "url": "https://gitlab.com/team/plugin.git"
  }
}

高级插件条目

插件条目可以覆盖默认组件位置并提供额外元数据。请注意，${CLAUDE_PLUGIN_ROOT} 是一个环境变量，解析为插件的安装目录（详情请参阅环境变量）：

json 复制代码 
{
  "name": "enterprise-tools",
  "source": {
    "source": "github",
    "repo": "company/enterprise-plugin"
  },
  "description": "企业工作流自动化工具",
  "version": "2.1.0",
  "author": {
    "name": "Enterprise Team",
    "email": "enterprise@company.com"
  },
  "homepage": "https://docs.company.com/plugins/enterprise-tools",
  "repository": "https://github.com/company/enterprise-plugin",
  "license": "MIT",
  "keywords": ["enterprise", "workflow", "automation"],
  "category": "productivity",
  "commands": [
    "./commands/core/",
    "./commands/enterprise/",
    "./commands/experimental/preview.md"
  ],
  "agents": [
    "./agents/security-reviewer.md",
    "./agents/compliance-checker.md"
  ],
  "hooks": {
    "PostToolUse": [
      {
        "matcher": "Write|Edit",
        "hooks": [{"type": "command", "command": "${CLAUDE_PLUGIN_ROOT}/scripts/validate.sh"}]
      }
    ]
  },
  "mcpServers": {
    "enterprise-db": {
      "command": "${CLAUDE_PLUGIN_ROOT}/servers/db-server",
      "args": ["--config", "${CLAUDE_PLUGIN_ROOT}/config.json"]
    }
  },
  "strict": false
}

模式关系 ：插件条目使用插件清单模式，所有字段设为可选，加上市场特定字段（source、strict、category、tags）。这意味着任何在 plugin.json 文件中有效的字段也可以在市场条目中使用。当 strict: false 时，如果没有 plugin.json 存在，市场条目作为完整的插件清单。当 strict: true（默认）时，市场字段补充插件自己的清单文件。

托管和分发市场

为您的插件分发需求选择最佳托管策略。

在 GitHub 上托管（推荐）

GitHub 提供了最简单的分发方法：

  1. 创建仓库：为您的市场设置新仓库
  2. 添加市场文件 ：创建包含插件定义的 .claude-plugin/marketplace.json
  3. 与团队共享 ：团队成员使用 /plugin marketplace add owner/repo 添加

优势：内置版本控制、问题跟踪和团队协作功能。

在其他 git 服务上托管

任何 git 托管服务都适用于市场分发，使用指向任意 git 仓库的 URL。

例如，使用 GitLab：

bash 复制代码 
/plugin marketplace add https://gitlab.com/company/plugins.git

使用本地市场进行开发

在分发前本地测试您的市场：

添加本地市场进行测试

bash 复制代码 
/plugin marketplace add ./my-local-marketplace

测试插件安装

perl 复制代码 
/plugin install test-plugin@my-local-marketplace

管理市场操作

列出已知市场

列出所有配置的市场

bash 复制代码 
/plugin marketplace list

显示所有配置的市场及其来源和状态。

更新市场元数据

刷新市场元数据

bash 复制代码 
/plugin marketplace update marketplace-name

从市场源刷新插件列表和元数据。

移除市场

移除市场

arduino 复制代码 
/plugin marketplace remove marketplace-name

从您的配置中移除市场。

警告：移除市场将卸载您从其安装的任何插件。

市场故障排除

常见市场问题

市场无法加载

症状：无法添加市场或查看其插件

解决方案：

  • 验证市场 URL 可访问
  • 检查 .claude-plugin/marketplace.json 是否存在于指定路径
  • 使用 claude plugin validate 确保 JSON 语法有效
  • 对于私有仓库，确认您有访问权限

插件安装失败

症状：市场出现但插件安装失败

解决方案：

  • 验证插件源 URL 可访问
  • 检查插件目录是否包含必需文件
  • 对于 GitHub 源，确保仓库是公开的或您有访问权限
  • 通过克隆/下载手动测试插件源

验证和测试

在共享前测试您的市场：

验证市场 JSON 语法

erlang 复制代码 
claude plugin validate .

添加市场进行测试

bash 复制代码 
/plugin marketplace add ./path/to/marketplace

安装测试插件

bash 复制代码 
/plugin install test-plugin@marketplace-name

有关完整的插件测试工作流程，请参阅本地测试您的插件。有关技术故障排除，请参阅插件参考。

后续步骤

对于市场用户

  • 发现社区市场：搜索 GitHub 查找 Claude Code 插件集合
  • 贡献反馈：向市场维护者报告问题和建议改进
  • 分享有用的市场：帮助您的团队发现有价值的插件集合

对于市场创建者

  • 构建插件集合：围绕特定用例创建主题市场
  • 建立版本控制：实施清晰的版本控制和更新策略
  • 社区参与：收集反馈并维护活跃的市场社区
  • 文档：提供清晰的 README 文件，解释您的市场内容

对于组织

  • 私有市场：为专有工具设置内部市场
  • 治理策略：建立插件批准和安全审查的指南
  • 培训资源：帮助团队有效地发现和采用有用的插件

另请参阅

  • 插件 - 安装和使用插件
  • 插件参考 - 完整的技术规范和模式
  • 插件开发 - 创建您自己的插件
  • 设置 - 插件配置选项
相关推荐
cmdyu_3 小时前
国内如何升级GitHub Copilot到专业版
github·copilot·ai编程
yaocheng的ai分身4 小时前
通过插件自定义 Claude Code
ai编程·claude
弥金5 小时前
LangChain Chat Model
后端·openai·ai编程
用户4099322502125 小时前
大表查询慢到翻遍整个书架？PostgreSQL分区表教你怎么“分类”才高效
后端·ai编程·trae
飞哥数智坊6 小时前
Codex 集成 Slack 后，我那个“数字同事”的梦碎了一半
人工智能·openai·ai编程
华仔AI智能体6 小时前
AI编程工具（Cursor/Copilot/灵码/文心一言/Claude Code/Trae）AI编程辅助工具全方位比较
copilot·文心一言·ai编程
芒果作者6 小时前
cursor自动绑定虚拟卡
ai·ai编程
玲小珑7 小时前
LangChain.js 完全开发手册（十四）生产环境部署与 DevOps 实践
前端·langchain·ai编程
yaocheng的ai分身15 小时前
Subagent 自进化：从使用中迭代出最契合场景的agent
ai编程
热门推荐
01BongoCat - 跨平台键盘猫动画工具02两千字总结：Codex 国内如何安装和使用的教程，以及如何设置中文回答03智能库存管理的需求预测模型：从业务痛点到落地代码的完整实践042025羊城杯网络安全大赛 wp05GitHub 镜像站点06UV安装并设置国内源07Linux下V2Ray安装配置指南08Spring Boot 实现微信登录，So Easy !095大DOM/BOM核心考点：从入门到精通，让面试官眼前一亮10Cursor Plan Mode：AI 终于知道先想后做了