Marchés de plugins - Claude Code Docs

Les marchés 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 marchés existants et créer le vôtre pour la distribution en équipe.

Aperçu

Un marché est un fichier JSON qui répertorie les plugins disponibles et décrit où les trouver. Les marchés offrent :

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

Conditions préalables

Claude Code installé et en cours d’exécution
Familiarité de base avec le format de fichier JSON
Pour créer des marchés : Référentiel Git ou environnement de développement local

Ajouter et utiliser les marchés

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

Ajouter des marchés GitHub

Ajouter un référentiel GitHub contenant .claude-plugin/marketplace.json

/plugin marketplace add owner/repo

Ajouter des référentiels Git

Ajouter n'importe quel référentiel git

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

Ajouter des marchés locaux 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 à partir des marchés

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

Installer à partir de n'importe quel marché connu

/plugin install plugin-name@marketplace-name

Parcourir les plugins disponibles de manière interactive

/plugin

Vérifier l’installation du marché

Après avoir ajouté un marché :

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

Configurer les marchés d’équipe

Configurez l’installation automatique des marchés pour les projets d’équipe en spécifiant les marchés requis 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 référentiel, Claude Code installe automatiquement ces marchés et tous les plugins spécifiés dans le champ enabledPlugins.

Créer votre propre marché

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

Conditions préalables pour la création de marché

Référentiel Git (GitHub, GitLab ou autre hébergement git)
Compréhension du format de fichier JSON
Un ou plusieurs plugins à distribuer

Créer le fichier du marché

Créez .claude-plugin/marketplace.json à la racine de votre référentiel :

{
  "name": "company-tools",
  "owner": {
    "name": "DevTools Team",
    "email": "[email protected]"
  },
  "plugins": [
    {
      "name": "code-formatter",
      "source": "./plugins/formatter",
      "description": "Automatic code formatting on save",
      "version": "2.1.0",
      "author": {
        "name": "DevTools Team"
      }
    },
    {
      "name": "deployment-tools",
      "source": {
        "source": "github",
        "repo": "company/deploy-plugin"
      },
      "description": "Deployment automation tools"
    }
  ]
}

Schéma du marché

Champs obligatoires

Champ	Type	Description
`name`	string	Identifiant du marché (kebab-case, sans espaces)
`owner`	object	Informations sur le responsable du marché
`plugins`	array	Liste des plugins disponibles

Métadonnées optionnelles

Champ	Type	Description
`metadata.description`	string	Brève description du marché
`metadata.version`	string	Version du 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 du manifeste de plugin (avec tous les champs rendus optionnels) plus les champs spécifiques au marché (source, category, tags, strict), name étant obligatoire.

Champs obligatoires :

Champ	Type	Description
`name`	string	Identifiant du plugin (kebab-case, sans 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 sur l’auteur du plugin
`homepage`	string	URL de la page d’accueil ou de la documentation du plugin
`repository`	string	URL du référentiel du code source
`license`	string	Identifiant de licence SPDX (par exemple, MIT, Apache-2.0)
`keywords`	array	Balises pour la découverte et la catégorisation des plugins
`category`	string	Catégorie du plugin pour l’organisation
`tags`	array	Balises 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 des hooks personnalisés ou chemin vers le fichier des hooks
`mcpServers`	string\|object	Configurations du serveur MCP ou chemin vers la configuration MCP

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

Sources de plugins

Chemins relatifs

Pour les plugins dans le même référentiel :

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

Référentiels GitHub

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

Référentiels 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 au 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": "Enterprise workflow automation tools",
  "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 du manifeste de plugin avec tous les champs rendus optionnels, plus les champs spécifiques au marché (source, strict, category, tags). Cela signifie que tout champ valide dans un fichier plugin.json peut également être utilisé dans une entrée de marché. Lorsque strict: false, l’entrée du marché sert de manifeste de plugin complet si aucun plugin.json n’existe. Lorsque strict: true (par défaut), les champs du marché complètent le fichier manifeste propre du plugin.

Héberger et distribuer les marchés

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 référentiel : Configurez un nouveau référentiel pour votre marché
Ajouter le fichier du 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 en équipe.

Héberger sur d’autres services git

N’importe quel service d’hébergement git fonctionne pour la distribution de marché, en utilisant une URL vers un référentiel git arbitraire. Par exemple, en utilisant GitLab :

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

Utiliser des marchés locaux pour le développement

Testez votre marché localement avant la distribution :

Ajouter un marché local pour les tests

/plugin marketplace add ./my-local-marketplace

Tester l'installation du plugin

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

Gérer les opérations du marché

Lister les marchés connus

Lister tous les marchés configurés

/plugin marketplace list

Affiche tous les marchés configurés avec leurs sources et leur statut.

Mettre à jour les métadonnées du marché

Actualiser les métadonnées du marché

/plugin marketplace update marketplace-name

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

Supprimer un marché

/plugin marketplace remove marketplace-name

Supprime le marché de votre configuration.

La suppression d’un marché désinstallera tous les plugins que vous avez installés à partir de celui-ci.

Dépannage des marchés

Problèmes courants du marché

Le marché ne se charge pas

Symptômes : Impossible d’ajouter le marché ou de voir les plugins à partir de celui-ci Solutions :

Vérifiez que l’URL du 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 référentiels privés, confirmez que vous avez les autorisations d’accès

Échecs d’installation de plugins

Symptômes : Le marché apparaît mais l’installation du plugin échoue Solutions :

Vérifiez que les URL sources des plugins sont accessibles
Vérifiez que les répertoires de plugins contiennent les fichiers requis
Pour les sources GitHub, assurez-vous que les référentiels sont publics ou que vous avez accès
Testez manuellement les sources de plugins en les clonant/téléchargeant

Validation et tests

Testez votre marché avant de le partager :

Valider la syntaxe JSON du marché

claude plugin validate .

Ajouter un marché pour les tests

/plugin marketplace add ./path/to/marketplace

Installer un plugin de test

/plugin install test-plugin@marketplace-name

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

Prochaines étapes

Pour les utilisateurs de marché

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

Pour les créateurs de marché

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

Pour les organisations

Marchés privés : Configurez des marchés internes pour les outils propriétaires
Politiques de gouvernance : Établissez des directives pour l’approbation des plugins et l’examen de la sécurité
Ressources de formation : Aidez les équipes à découvrir et adopter efficacement les 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

Administration

​Aperçu

​Conditions préalables

​Ajouter et utiliser les marchés

​Ajouter des marchés GitHub

​Ajouter des référentiels Git

​Ajouter des marchés locaux pour le développement

​Installer des plugins à partir des marchés

​Vérifier l’installation du marché

​Configurer les marchés d’équipe

​Créer votre propre marché

​Conditions préalables pour la création de marché

​Créer le fichier du marché

​Schéma du marché

​Champs obligatoires

​Métadonnées optionnelles

​Entrées de plugins

​Champs de plugin optionnels

​Sources de plugins

​Chemins relatifs

​Référentiels GitHub

​Référentiels Git

​Entrées de plugins avancées

​Héberger et distribuer les marchés

​Héberger sur GitHub (recommandé)

​Héberger sur d’autres services git

​Utiliser des marchés locaux pour le développement

​Gérer les opérations du marché

​Lister les marchés connus

​Mettre à jour les métadonnées du marché

​Supprimer un marché

​Dépannage des marchés

​Problèmes courants du marché

​Le marché ne se charge pas

​Échecs d’installation de plugins

​Validation et tests

​Prochaines étapes

​Pour les utilisateurs de marché

​Pour les créateurs de marché

​Pour les organisations

​Voir aussi

Aperçu

Conditions préalables

Ajouter et utiliser les marchés

Ajouter des marchés GitHub

Ajouter des référentiels Git

Ajouter des marchés locaux pour le développement

Installer des plugins à partir des marchés

Vérifier l’installation du marché

Configurer les marchés d’équipe

Créer votre propre marché

Conditions préalables pour la création de marché

Créer le fichier du marché

Schéma du marché

Champs obligatoires

Métadonnées optionnelles

Entrées de plugins

Champs de plugin optionnels

Sources de plugins

Chemins relatifs

Référentiels GitHub

Référentiels Git

Entrées de plugins avancées

Héberger et distribuer les marchés

Héberger sur GitHub (recommandé)

Héberger sur d’autres services git

Utiliser des marchés locaux pour le développement

Gérer les opérations du marché

Lister les marchés connus

Mettre à jour les métadonnées du marché

Supprimer un marché

Dépannage des marchés

Problèmes courants du marché

Le marché ne se charge pas

Échecs d’installation de plugins

Validation et tests

Prochaines étapes

Pour les utilisateurs de marché

Pour les créateurs de marché

Pour les organisations

Voir aussi