Places de marché de plugins

Les places de marché de plugins sont des catalogues de plugins disponibles qui facilitent la découverte, l’installation et la gestion des extensions Claude Code. Ce guide vous montre comment utiliser les places de marché existantes et créer les vôtres pour la distribution en équipe.

Aperçu

Une place de marché est un fichier JSON qui liste les plugins disponibles et décrit où les trouver. Les places de marché fournissent :

Découverte centralisée : Parcourez les plugins de plusieurs sources en un seul endroit
Gestion des versions : Suivez et mettez à jour les versions des plugins automatiquement
Distribution en équipe : Partagez les plugins requis dans votre organisation
Sources flexibles : Support pour les dépôts git, les dépôts GitHub, les chemins locaux et les gestionnaires de paquets

Prérequis

Claude Code installé et en cours d’exécution
Familiarité de base avec le format de fichier JSON
Pour créer des places de marché : Dépôt Git ou environnement de développement local

Ajouter et utiliser les places de marché

Ajoutez des places de marché en utilisant les commandes /plugin marketplace pour accéder aux plugins de différentes sources :

Ajouter des places de marché GitHub

Ajouter un dépôt GitHub contenant .claude-plugin/marketplace.json

/plugin marketplace add owner/repo

Ajouter des dépôts Git

Ajouter n'importe quel dépôt git

/plugin marketplace add https://gitlab.com/company/plugins.git

Ajouter des places de marché locales pour le développement

Ajouter un répertoire local contenant .claude-plugin/marketplace.json

/plugin marketplace add ./my-marketplace

Ajouter un chemin direct vers le fichier marketplace.json

/plugin marketplace add ./path/to/marketplace.json

Ajouter un marketplace.json distant via URL

/plugin marketplace add https://url.of/marketplace.json

Installer des plugins depuis les places de marché

Une fois que vous avez ajouté des places de marché, installez les plugins directement :

Installer depuis n'importe quelle place de marché connue

/plugin install plugin-name@marketplace-name

Parcourir les plugins disponibles de manière interactive

/plugin

Vérifier l’installation de la place de marché

Après avoir ajouté une place de marché :

Lister les places de marché : Exécutez /plugin marketplace list pour confirmer qu’elle est ajoutée
Parcourir les plugins : Utilisez /plugin pour voir les plugins disponibles depuis votre place de marché
Tester l’installation : Essayez d’installer un plugin pour vérifier que la place de marché fonctionne correctement

Configurer les places de marché d’équipe

Configurez l’installation automatique de places de marché pour les projets d’équipe en spécifiant les places de marché requises dans .claude/settings.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"
      }
    }
  }
}

Lorsque les membres de l’équipe font confiance au dossier du dépôt, Claude Code installe automatiquement ces places de marché et tous les plugins spécifiés dans le champ enabledPlugins.

Créer votre propre place de marché

Construisez et distribuez des collections de plugins personnalisées pour votre équipe ou communauté.

Prérequis pour la création de place de marché

Dépôt Git (GitHub, GitLab, ou autre hébergement git)
Compréhension du format de fichier JSON
Un ou plusieurs plugins à distribuer

Créer le fichier de place de marché

Créez .claude-plugin/marketplace.json à la racine de votre dépôt :

{
  "name": "company-tools",
  "owner": {
    "name": "DevTools Team",
    "email": "[email protected]"
  },
  "plugins": [
    {
      "name": "code-formatter",
      "source": "./plugins/formatter",
      "description": "Formatage automatique du code à la sauvegarde",
      "version": "2.1.0",
      "author": {
        "name": "DevTools Team"
      }
    },
    {
      "name": "deployment-tools",
      "source": {
        "source": "github",
        "repo": "company/deploy-plugin"
      },
      "description": "Outils d'automatisation de déploiement"
    }
  ]
}

Schéma de place de marché

Champs requis

Champ	Type	Description
`name`	string	Identifiant de la place de marché (kebab-case, pas d’espaces)
`owner`	object	Informations du mainteneur de la place de marché
`plugins`	array	Liste des plugins disponibles

Métadonnées optionnelles

Champ	Type	Description
`metadata.description`	string	Brève description de la place de marché
`metadata.version`	string	Version de la place de marché
`metadata.pluginRoot`	string	Chemin de base pour les sources de plugins relatives

Entrées de plugins

Les entrées de plugins sont basées sur le schéma de manifeste de plugin (avec tous les champs rendus optionnels) plus les champs spécifiques à la place de marché (source, category, tags, strict), avec name étant requis.

Champs requis :

Champ	Type	Description
`name`	string	Identifiant du plugin (kebab-case, pas d’espaces)
`source`	string\|object	D’où récupérer le plugin

Champs de plugin optionnels

Champs de métadonnées standard :

Champ	Type	Description
`description`	string	Brève description du plugin
`version`	string	Version du plugin
`author`	object	Informations de l’auteur du plugin
`homepage`	string	Page d’accueil ou URL de documentation du plugin
`repository`	string	URL du dépôt de code source
`license`	string	Identifiant de licence SPDX (ex. MIT, Apache-2.0)
`keywords`	array	Tags pour la découverte et la catégorisation des plugins
`category`	string	Catégorie du plugin pour l’organisation
`tags`	array	Tags pour la recherche
`strict`	boolean	Exiger plugin.json dans le dossier du plugin (par défaut : true) ¹

Champs de configuration des composants :

Champ	Type	Description
`commands`	string\|array	Chemins personnalisés vers les fichiers ou répertoires de commandes
`agents`	string\|array	Chemins personnalisés vers les fichiers d’agents
`hooks`	string\|object	Configuration de hooks personnalisés ou chemin vers le fichier de hooks
`mcpServers`	string\|object	Configurations de serveur MCP ou chemin vers la config MCP

^{1 - Quand strict: true (par défaut), le plugin doit inclure un fichier manifeste plugin.json, et les champs de la place de marché complètent ces valeurs. Quand strict: false, le plugin.json est optionnel. S’il manque, l’entrée de la place de marché sert de manifeste de plugin complet.}

Sources de plugins

Chemins relatifs

Pour les plugins dans le même dépôt :

{
  "name": "my-plugin",
  "source": "./plugins/my-plugin"
}

Dépôts GitHub

{
  "name": "github-plugin",
  "source": {
    "source": "github",
    "repo": "owner/plugin-repo"
  }
}

Dépôts Git

{
  "name": "git-plugin",
  "source": {
    "source": "url",
    "url": "https://gitlab.com/team/plugin.git"
  }
}

Entrées de plugins avancées

Les entrées de plugins peuvent remplacer les emplacements de composants par défaut et fournir des métadonnées supplémentaires. Notez que ${CLAUDE_PLUGIN_ROOT} est une variable d’environnement qui se résout vers le répertoire d’installation du plugin (pour plus de détails voir Variables d’environnement) :

{
  "name": "enterprise-tools",
  "source": {
    "source": "github",
    "repo": "company/enterprise-plugin"
  },
  "description": "Outils d'automatisation de flux de travail d'entreprise",
  "version": "2.1.0",
  "author": {
    "name": "Enterprise Team",
    "email": "[email protected]"
  },
  "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
}

Relation de schéma : Les entrées de plugins utilisent le schéma de manifeste de plugin avec tous les champs rendus optionnels, plus les champs spécifiques à la place de marché (source, strict, category, tags). Cela signifie que tout champ valide dans un fichier plugin.json peut aussi être utilisé dans une entrée de place de marché. Quand strict: false, l’entrée de la place de marché sert de manifeste de plugin complet si aucun plugin.json n’existe. Quand strict: true (par défaut), les champs de la place de marché complètent le fichier manifeste propre du plugin.

Héberger et distribuer les places de marché

Choisissez la meilleure stratégie d’hébergement pour vos besoins de distribution de plugins.

Héberger sur GitHub (recommandé)

GitHub fournit la méthode de distribution la plus facile :

Créer un dépôt : Configurez un nouveau dépôt pour votre place de marché
Ajouter le fichier de place de marché : Créez .claude-plugin/marketplace.json avec vos définitions de plugins
Partager avec les équipes : Les membres de l’équipe ajoutent avec /plugin marketplace add owner/repo

Avantages : Contrôle de version intégré, suivi des problèmes et fonctionnalités de collaboration d’équipe.

Héberger sur d’autres services git

Tout service d’hébergement git fonctionne pour la distribution de places de marché, en utilisant une URL vers un dépôt git arbitraire. Par exemple, en utilisant GitLab :

/plugin marketplace add https://gitlab.com/company/plugins.git

Utiliser des places de marché locales pour le développement

Testez votre place de marché localement avant la distribution :

Ajouter une place de marché locale pour les tests

/plugin marketplace add ./my-local-marketplace

Tester l'installation de plugin

/plugin install test-plugin@my-local-marketplace

Gérer les opérations de place de marché

Lister les places de marché connues

Lister toutes les places de marché configurées

/plugin marketplace list

Affiche toutes les places de marché configurées avec leurs sources et statuts.

Mettre à jour les métadonnées de place de marché

Actualiser les métadonnées de place de marché

/plugin marketplace update marketplace-name

Actualise les listes de plugins et les métadonnées depuis la source de la place de marché.

Supprimer une place de marché

/plugin marketplace remove marketplace-name

Supprime la place de marché de votre configuration.

Supprimer une place de marché désinstallera tous les plugins que vous avez installés depuis celle-ci.

Dépannage des places de marché

Problèmes courants de place de marché

Place de marché ne se charge pas

Symptômes : Impossible d’ajouter la place de marché ou de voir les plugins depuis celle-ci Solutions :

Vérifiez que l’URL de la place de marché est accessible
Vérifiez que .claude-plugin/marketplace.json existe au chemin spécifié
Assurez-vous que la syntaxe JSON est valide en utilisant claude plugin validate
Pour les dépôts privés, confirmez que vous avez les permissions d’accès

Échecs d’installation de plugins

Symptômes : La place de marché apparaît mais l’installation de plugin échoue Solutions :

Vérifiez que les URLs sources de plugins sont accessibles
Vérifiez que les répertoires de plugins contiennent les fichiers requis
Pour les sources GitHub, assurez-vous que les dépôts sont publics ou que vous avez accès
Testez les sources de plugins manuellement en clonant/téléchargeant

Validation et tests

Testez votre place de marché avant de la partager :

Valider la syntaxe JSON de la place de marché

claude plugin validate .

Ajouter une place de marché pour les tests

/plugin marketplace add ./path/to/marketplace

Installer un plugin de test

/plugin install test-plugin@marketplace-name

Pour des flux de travail de test de plugins complets, voir Tester vos plugins localement. Pour le dépannage technique, voir Référence des plugins.

Prochaines étapes

Pour les utilisateurs de places de marché

Découvrir les places de marché communautaires : Recherchez sur GitHub des collections de plugins Claude Code
Contribuer des commentaires : Signalez les problèmes et suggérez des améliorations aux mainteneurs de places de marché
Partager des places de marché utiles : Aidez votre équipe à découvrir des collections de plugins précieuses

Pour les créateurs de places de marché

Construire des collections de plugins : Créez des places de marché thématiques autour de cas d’usage spécifiques
Établir le versioning : Implémentez des politiques claires de versioning et de mise à jour
Engagement communautaire : Recueillez des commentaires et maintenez des communautés de places de marché actives
Documentation : Fournissez des fichiers README clairs expliquant le contenu de votre place de marché

Pour les organisations

Places de marché privées : Configurez des places de marché internes pour les outils propriétaires
Politiques de gouvernance : Établissez des directives pour l’approbation des plugins et la révision de sécurité
Ressources de formation : Aidez les équipes à découvrir et adopter efficacement des plugins utiles

Voir aussi

Plugins - Installation et utilisation des plugins
Référence des plugins - Spécifications techniques complètes et schémas
Développement de plugins - Créer vos propres plugins
Paramètres - Options de configuration des plugins

Commencer

Créer avec Claude Code

SDK de code Claude

Déploiement

Administration

Configuration

Référence

Ressources

​Aperçu

​Prérequis

​Ajouter et utiliser les places de marché

​Ajouter des places de marché GitHub

​Ajouter des dépôts Git

​Ajouter des places de marché locales pour le développement

​Installer des plugins depuis les places de marché

​Vérifier l’installation de la place de marché

​Configurer les places de marché d’équipe

​Créer votre propre place de marché

​Prérequis pour la création de place de marché

​Créer le fichier de place de marché

​Schéma de place de marché

​Champs requis

​Métadonnées optionnelles

​Entrées de plugins

​Champs de plugin optionnels

​Sources de plugins

​Chemins relatifs

​Dépôts GitHub

​Dépôts Git

​Entrées de plugins avancées

​Héberger et distribuer les places de marché

​Héberger sur GitHub (recommandé)

​Héberger sur d’autres services git

​Utiliser des places de marché locales pour le développement

​Gérer les opérations de place de marché

​Lister les places de marché connues

​Mettre à jour les métadonnées de place de marché

​Supprimer une place de marché

​Dépannage des places de marché

​Problèmes courants de place de marché

​Place de marché ne se charge pas

​Échecs d’installation de plugins

​Validation et tests

​Prochaines étapes

​Pour les utilisateurs de places de marché

​Pour les créateurs de places de marché

​Pour les organisations

​Voir aussi

Aperçu

Prérequis

Ajouter et utiliser les places de marché

Ajouter des places de marché GitHub

Ajouter des dépôts Git

Ajouter des places de marché locales pour le développement

Installer des plugins depuis les places de marché

Vérifier l’installation de la place de marché

Configurer les places de marché d’équipe

Créer votre propre place de marché

Prérequis pour la création de place de marché

Créer le fichier de place de marché

Schéma de place de marché

Champs requis

Métadonnées optionnelles

Entrées de plugins

Champs de plugin optionnels

Sources de plugins

Chemins relatifs

Dépôts GitHub

Dépôts Git

Entrées de plugins avancées

Héberger et distribuer les places de marché

Héberger sur GitHub (recommandé)

Héberger sur d’autres services git

Utiliser des places de marché locales pour le développement

Gérer les opérations de place de marché

Lister les places de marché connues

Mettre à jour les métadonnées de place de marché

Supprimer une place de marché

Dépannage des places de marché

Problèmes courants de place de marché

Place de marché ne se charge pas

Échecs d’installation de plugins

Validation et tests

Prochaines étapes

Pour les utilisateurs de places de marché

Pour les créateurs de places de marché

Pour les organisations

Voir aussi