Créer un Marketplace de Plugins Claude Code : Guide 2026

Sommaire

---

Créer un marketplace de plugins Claude Code : réponse rapide {#promesse}

Pour créer un marketplace de plugins Claude Code, vous avez besoin de trois choses : un dépôt Git (GitHub, GitLab, Bitbucket), un fichier .claude-plugin/marketplace.json à la racine qui liste vos plugins, et au moins un plugin avec son propre .claude-plugin/plugin.json. Vos utilisateurs ajoutent ensuite votre marketplace avec la commande /plugin marketplace add owner/repo puis installent un plugin avec /plugin install nom@votre-marketplace.

En juin 2026, l'écosystème Claude Code recense 77 marketplaces communautaires et plus de 1 208 plugins publiés. Créer le vôtre n'a jamais été aussi simple, et c'est devenu le format de référence pour distribuer des skills, hooks, sous-agents et serveurs MCP au sein d'une équipe ou d'une communauté.

Voici le guide pas à pas, avec les pièges à éviter et le marketplace.json complet.

Qu'est-ce qu'un marketplace de plugins Claude Code ? {#definition}

Un marketplace de plugins Claude Code est un dépôt Git qui sert de registre centralisé pour un ou plusieurs plugins. Il ne contient pas obligatoirement le code des plugins lui-même : il peut simplement pointer vers d'autres dépôts qui les hébergent.

La hiérarchie skill → plugin → marketplace

Pour bien comprendre comment créer un marketplace de plugins Claude Code, il faut d'abord distinguer trois niveaux d'abstraction qui se confondent souvent dans la documentation :

Cette hiérarchie est ce qui rend le système puissant : un skill se réutilise dans plusieurs plugins, un plugin s'installe depuis plusieurs marketplaces, et un marketplace peut référencer des plugins hébergés ailleurs.

Ce qu'un marketplace contient réellement

Un marketplace de plugins Claude Code minimal n'est qu'un dépôt avec un seul fichier obligatoire : .claude-plugin/marketplace.json. Ce fichier JSON liste les plugins disponibles et indique où les trouver (URL, repo, chemin local). C'est un registre, pas un magasin d'applications.

Le code des plugins peut soit être inclus dans le même repo (monorepo), soit pointer vers des dépôts externes. Cette flexibilité est ce qui permet de distribuer des plugins Claude Code sans imposer une architecture rigide.

Pourquoi créer son propre marketplace de plugins Claude Code ? {#pourquoi}

Si vous vous demandez s'il vaut la peine de créer un marketplace de plugins Claude Code au lieu d'installer ceux des autres, voici les trois cas d'usage où ça change tout.

Standardiser les pratiques d'une équipe

Quand cinq développeurs utilisent Claude Code sur le même monorepo, chacun finit par installer ses propres skills, ses propres hooks, ses propres sous-agents. Le résultat : des PRs hétérogènes, des conventions divergentes, des incidents qui auraient pu être évités. Un marketplace interne pousse une base commune que tout le monde installe en une commande, et que la maintenabilité tire vers le haut.

Distribuer une expertise verticale

Si vous êtes consultant ou freelance spécialisé sur un domaine (DevSecOps, finance, e-commerce), votre marketplace devient votre signature professionnelle. Les plugins qui automatisent vos workflows métier sont autant de preuves d'expertise pour vos prospects, et autant de cadeaux d'entrée pour la communauté.

Construire un produit en propre

Plusieurs éditeurs de plugins Claude Code monétisent leurs marketplaces en open core : un plugin gratuit pour attirer, un plugin "pro" pour vendre. C'est un canal d'acquisition technique très efficace dans l'écosystème agent IA. Pour une API SaaS construite avec Claude Code, vous pouvez exposer des outils métier à vos clients via un marketplace dédié — voir par exemple comment [une API ImmoAPI s'intègre](https://immoapi.app) avec des assistants IA pour des cas d'usage immobilier.

Comment structurer un marketplace de plugins Claude Code ? {#structure}

L'arborescence d'un marketplace de plugins Claude Code respecte une convention stricte. Tout ce qui sort de cette convention casse l'installation par la CLI.

Arborescence cible

mon-marketplace/
├── .claude-plugin/
│   └── marketplace.json
├── plugins/
│   ├── quality-review/
│   │   ├── .claude-plugin/
│   │   │   └── plugin.json
│   │   ├── skills/
│   │   │   └── review-pr/
│   │   │       └── SKILL.md
│   │   ├── hooks/
│   │   │   └── post-edit.sh
│   │   └── agents/
│   │       └── reviewer.md
│   └── ci-helper/
│       ├── .claude-plugin/
│       │   └── plugin.json
│       └── skills/
│           └── ...
└── README.md

Règles d'or à mémoriser

Cette structure n'est pas négociable : la CLI Claude Code scanne ces chemins exacts pour valider votre marketplace.

Étape 1 : préparer le dépôt GitHub du marketplace {#etape-1}

On commence par le commencement : un repo Git vide et bien nommé.

Choisir un nom de marketplace

Le nom de votre marketplace est ce que les utilisateurs taperont après @ lors de l'installation : /plugin install quality-review@mon-marketplace. Quelques règles :

Initialiser le dépôt

mkdir mon-marketplace && cd mon-marketplace
git init
mkdir -p .claude-plugin plugins
echo "# Mon Marketplace Claude Code" > README.md

Le README est important : c'est ce que verront les utilisateurs avant de décider d'ajouter votre marketplace. Listez vos plugins, leur statut (alpha/beta/stable) et leur licence.

Préparer la licence et le CONTRIBUTING

Une licence permissive (MIT, Apache 2.0) maximise l'adoption. Si vous voulez monétiser, considérez une licence à double face (BSL ou ELv2 pour le code source, commercial pour l'usage en production).

Étape 2 : créer la structure de plugin Claude Code {#etape-2}

Pour cet exemple, on crée un plugin "quality-review" qui contient un skill de revue de pull request.

Le manifeste plugin.json

mkdir -p plugins/quality-review/.claude-plugin
mkdir -p plugins/quality-review/skills/review-pr

Fichier plugins/quality-review/.claude-plugin/plugin.json :

{
  "$schema": "https://code.claude.com/schemas/plugin.json",
  "name": "quality-review",
  "version": "0.1.0",
  "description": "Skills et hooks pour standardiser la revue de code sur Claude Code",
  "author": {
    "name": "Votre Nom",
    "email": "vous@example.com",
    "url": "https://example.com"
  },
  "license": "MIT",
  "homepage": "https://github.com/votre-org/mon-marketplace",
  "keywords": ["code-review", "quality", "lint"],
  "compatibility": {
    "claude-code": ">=2.0.0"
  }
}

Le skill review-pr

Fichier plugins/quality-review/skills/review-pr/SKILL.md :

---
name: review-pr
description: Analyse une pull request et produit une revue structurée
user-invocable: true
---

# Revue de pull request

Quand l'utilisateur invoque ce skill, exécute la séquence suivante :

1. Lance \`gh pr diff\` pour récupérer le diff complet
2. Identifie les changements à risque : modifications de migrations, secrets, dépendances
3. Vérifie la couverture de tests des fichiers modifiés
4. Produit un rapport en trois sections : Critique, Recommandé, Optionnel
5. Termine par une note globale de 1 à 5 et une recommandation merge / changes-requested

Notez l'échappement des backticks dans le SKILL.md — la convention est de tripler les backticks pour les blocs de code.

Ajouter un hook (optionnel)

Fichier plugins/quality-review/hooks/post-edit.sh :

#!/usr/bin/env bash
# Hook exécuté après chaque édition de fichier .ts ou .tsx
if [[ "$1" =~ \.(ts|tsx)$ ]]; then
  npx prettier --write "$1" 2>/dev/null
  npx eslint --fix "$1" 2>/dev/null
fi

Et déclarer ce hook dans le plugin.json via la clé hooks. Pour aller plus loin sur les hooks, consultez le [guide des hooks Claude Code](/blog/claude-code-hooks-automatiser-workflow) qui détaille tous les événements disponibles.

Étape 3 : écrire le fichier marketplace.json {#etape-3}

C'est le fichier central qui transforme votre repo en marketplace de plugins Claude Code valide.

Le marketplace.json minimum

Fichier .claude-plugin/marketplace.json à la racine :

{
  "$schema": "https://code.claude.com/schemas/marketplace.json",
  "name": "mon-marketplace",
  "version": "1.0.0",
  "description": "Marketplace de plugins Claude Code pour la qualité de code et la CI",
  "owner": {
    "name": "Votre Équipe",
    "email": "contact@example.com",
    "url": "https://example.com"
  },
  "plugins": [
    {
      "name": "quality-review",
      "description": "Skills et hooks pour la revue de code",
      "source": "./plugins/quality-review",
      "category": "code-quality",
      "tags": ["review", "lint", "ci"],
      "strict": true
    }
  ]
}

Comprendre le champ source

Le champ source accepte quatre formats, et le choix dépend de votre stratégie de distribution :

Le champ strict

Quand strict vaut true, la CLI Claude Code valide le plugin.json contre le schéma officiel avant d'installer. C'est recommandé pour les marketplaces publics : ça évite les bugs silencieux d'installation. Pour un marketplace privé d'équipe en phase exploratoire, false peut faire gagner du temps.

Ajouter plusieurs plugins

Pour distribuer plusieurs plugins, ajoutez simplement des entrées dans le tableau plugins. Chaque entrée peut référencer un plugin local (./plugins/...) ou distant. Vous pouvez mixer les deux dans le même marketplace.

Étape 4 : tester le marketplace localement {#etape-4}

Avant de pousser sur GitHub, validez votre marketplace de plugins Claude Code en local.

Validation par la CLI

Dans un autre terminal, depuis n'importe quel projet :

claude
> /plugin marketplace add /chemin/absolu/vers/mon-marketplace

Si la CLI affiche Marketplace 'mon-marketplace' added (1 plugin available), vous êtes bons. Sinon, elle pointe la ligne du JSON en erreur.

Tester l'installation d'un plugin

> /plugin install quality-review@mon-marketplace
> /plugin list

Le skill review-pr devrait maintenant être disponible. Vous pouvez l'invoquer avec /review-pr ou laisser Claude le déclencher en lui demandant naturellement de réviser une PR.

Tester la désinstallation

> /plugin remove quality-review
> /plugin marketplace remove mon-marketplace

C'est un cycle d'itération court qui vous évite de polluer un repo GitHub avec des commits "fix typo marketplace.json" en boucle.

Comment distribuer un marketplace de plugins Claude Code via GitHub ? {#distribuer}

Une fois le marketplace validé en local, la distribution est triviale.

Pousser sur GitHub

git add .
git commit -m "feat: initial marketplace with quality-review plugin"
gh repo create mon-marketplace --public --source=. --push

Documenter l'ajout dans le README

Votre README doit expliquer comment installer votre marketplace en deux lignes. Mettez un titre H2 ## Installation suivi d'un bloc de code qui contient les deux commandes :

/plugin marketplace add votre-org/mon-marketplace
/plugin install quality-review@mon-marketplace

C'est ce que recopieront vos utilisateurs. La friction d'installation doit être nulle.

Annoncer le marketplace

Quelques canaux qui fonctionnent en 2026 :

Maintenir le marketplace

À chaque update d'un plugin, bumpez la version dans son plugin.json ET tagguez le repo (git tag v0.2.0 && git push --tags). Les utilisateurs rafraîchissent leur copie locale du catalogue avec /plugin marketplace update mon-marketplace. Si vous épinglez les sources sur des tags Git (acme/plugin#v0.2.0), vos utilisateurs ont un contrôle fin du moment où ils upgradent.

Quelles erreurs éviter quand on crée un marketplace Claude Code ? {#erreurs}

Voici les pièges qui font perdre des heures aux mainteneurs de marketplaces Claude Code en 2026.

Mauvais emplacement du marketplace.json

Le fichier DOIT être à .claude-plugin/marketplace.json à la racine du dépôt, pas à marketplace.json tout court, pas à .claude/marketplace.json. Une faute de chemin = marketplace invisible pour la CLI.

Confondre plugin.json et marketplace.json

Le plugin.json décrit un plugin, le marketplace.json liste plusieurs plugins. Ils n'ont pas le même schéma. Mettre des entrées plugin dans le marketplace ou inversement casse les deux.

Trop de plugins dans un seul plugin

Un plugin doit faire une chose. Si vous mettez 12 skills hétérogènes dans un seul plugin "utils", vos utilisateurs n'en activeront que 2 mais paieront le coût d'instruction des 10 autres dans le contexte. C'est l'erreur de design la plus fréquente.

Oublier le champ compatibility

Sans champ compatibility.claude-code dans plugin.json, votre plugin peut être installé sur des versions de Claude Code qui ne supportent pas vos features. Le résultat : tickets d'utilisateurs frustrés qui ne savent pas que c'est un problème de version.

Versionner sans tagger

La version dans plugin.json doit suivre semver, et chaque release doit avoir un tag Git correspondant. Sans tags, les utilisateurs qui veulent épingler une version sont coincés sur main qui peut casser à tout moment.

Skills trop verbeux

Un SKILL.md qui fait 400 lignes consomme trop de contexte. Visez 50-150 lignes maximum, et déportez la logique complexe dans des scripts externes que le skill invoque. Sinon, chaque invocation pollue le contexte de l'utilisateur et dégrade la qualité des réponses Claude. Pour comprendre la gestion fine du contexte, voyez [gérer le contexte avec Claude Code](/blog/claude-code-gerer-contexte-compact-context-rot-2026).

Hooks non idempotents

Si votre hook post-edit.sh modifie le fichier qu'il vient de recevoir et que cette modification déclenche un nouveau post-edit, vous avez créé une boucle infinie. Tous les hooks Claude Code doivent être idempotents : exécutés deux fois de suite, ils produisent le même résultat.

FAQ — Créer un marketplace de plugins Claude Code {#faq}

Faut-il publier un marketplace sur GitHub pour qu'il fonctionne ?

Non. Un marketplace peut être servi depuis n'importe quel dépôt Git (GitLab, Bitbucket, Gitea auto-hébergé) ou même un chemin local pour un usage personnel. GitHub est juste l'option par défaut parce que c'est ce que la majorité des utilisateurs ont déjà configuré.

Combien de plugins peut contenir un marketplace Claude Code ?

Aucune limite technique. Le marketplace officiel d'Anthropic en contient une trentaine, le plus gros marketplace communautaire en avait plus de 300 fin mai 2026. La limite pratique est la maintenabilité : au-delà de 20-30 plugins, scinder en plusieurs marketplaces thématiques améliore la découvrabilité.

Peut-on monétiser un marketplace de plugins Claude Code ?

Oui, plusieurs modèles sont déjà pratiqués : open-core (plugins gratuits + version pro payante), abonnement à un marketplace privé, services associés (formation, intégration). La CLI Claude Code n'a pas encore de système de paiement intégré, le billing se gère côté éditeur.

Quelle est la différence entre un skill et un plugin Claude Code ?

Un skill est une instruction Markdown unique qui définit un comportement. Un plugin est un bundle qui peut contenir plusieurs skills, plus des hooks, des sous-agents et des serveurs MCP. Le plugin est l'unité de distribution, le skill est l'unité de logique. Pour le détail, voir [créer des commandes personnalisées Claude Code](/blog/claude-code-skills-creer-commandes-personnalisees).

Comment vérifier qu'un marketplace est compatible avec ma version de Claude Code ?

La CLI valide automatiquement le champ compatibility.claude-code de chaque plugin avant installation. Si la version ne match pas, l'installation est refusée avec un message explicite. Vous pouvez aussi inspecter le marketplace.json à la main, le champ est documenté.

Faut-il signer cryptographiquement les plugins distribués ?

C'est en discussion chez Anthropic pour fin 2026 mais ce n'est pas encore obligatoire. Pour un marketplace public, le combo "tags Git signés GPG + checksums dans les release notes GitHub" est la meilleure pratique actuelle. Pour un marketplace d'entreprise, hébergez sur Git interne avec ACL et c'est suffisant.

Un marketplace privé d'entreprise peut-il référencer des plugins publics GitHub ?

Oui, et c'est même la pratique recommandée : votre marketplace.json interne peut mixer des plugins publics (acme-corp/...) et des plugins privés (votre-org/...). Tant que les développeurs ont les droits Git sur les sources, l'installation fonctionne.

Comment passer d'un usage individuel à un marketplace d'équipe ?

Mettez à plat les skills et hooks que vous utilisez en local (~/.claude/), regroupez-les en plugins thématiques, créez le marketplace.json puis poussez sur un repo d'équipe. La migration prend généralement 2-3 heures pour une stack mature. C'est le type d'exercice couvert en profondeur dans notre [formation Claude Code](https://www.formation-claudecode.com/).

Peut-on déclencher des actions cloud depuis un plugin de marketplace ?

Oui, via les routines Claude Code qui s'invoquent depuis vos plugins. Voir [Claude Code Routines et automatisations cloud](/blog/claude-code-routines-automatisations-cloud-2026) pour le pattern complet.

Ressources complémentaires {#ressources}