Référence Marketplace

• Le fichier marketplace : Champs de niveau supérieur et Entrées de plugin
• La source d’une entrée : Sources de plugin
• Un objet source dans les paramètres : Sources marketplace
• Sortie de claude plugin validate <path> : Messages de validation, qui mappe chaque message au champ qu’il nomme

​

Fichier marketplace

​

Noms réservés

• Noms de marketplace officiels : claude-code-marketplace, claude-code-plugins, claude-plugins-official, anthropic-marketplace, anthropic-plugins, agent-skills, anthropic-agent-skills, life-sciences, knowledge-work-plugins, claude-for-legal, claude-for-financial-services, financial-services-plugins, first-party-plugins et claude-tag-plugins. Réservés sauf si la marketplace provient d’une source marketplace github ou git sous github.com/anthropics/.
• Noms de marketplace communautaire : claude-community, claude-plugins-community et healthcare. Réservés selon la même règle que les noms officiels.
• Noms de répertoire de plugin : anthropic-plugin-directory et claude-plugin-directory. Réservés selon la même règle que les noms officiels.
• Noms qui usurpent l’identité d’une marketplace officielle : des noms tels que official-claude-plugins ou claude-plugins-v2, et tout nom contenant un caractère non-ASCII. L’erreur est Marketplace name impersonates an official Anthropic/Claude marketplace. Un caractère de contrôle ou de formatage bidirectionnel dans un nom signale également Marketplace name cannot contain control or bidirectional-formatting characters.
• Une autre orthographe d’un nom réservé : un nom qui diffère d’un nom réservé uniquement par un point final, ou par un symbole autre qu’un trait d’union à la place d’un trait d’union, donc claude.code.plugins compte comme claude-code-plugins. claude plugin validate accepte un tel nom ; l’ajout de la marketplace échoue avec is another spelling of "<reserved>", a reserved marketplace name, et une marketplace déjà enregistrée sous l’une d’elles cesse de se charger. Cette vérification nécessite Claude Code v2.1.280 ou ultérieure.
• Noms que Claude Code utilise pour les plugins qui ne proviennent pas d’une marketplace : inline pour les plugins chargés avec --plugin-dir, builtin pour les plugins intégrés, skills-dir pour les plugins chargés automatiquement à partir de .claude/skills/ et synced pour les plugins synchronisés à partir de votre compte claude.ai. claude-plugin-test est également réservé. skills-dir apparaît également comme {"source": "skills-dir"} dans strictKnownMarketplaces et blockedMarketplaces, décrits sous Valeurs source valides uniquement dans les listes de politique.
• npm, pip, uv, cargo, github et gh : réservés dans n’importe quelle casse. Cette vérification nécessite Claude Code v2.1.275 ou ultérieure.
• Noms commençant par claudeai- : réservés pour les marketplaces hébergées sur claude.ai. claude plugin marketplace add refuse toute autre marketplace qui en utilise un avec Cannot add marketplace "<name>": names starting with "claudeai-" are reserved for marketplaces hosted on claude.ai.

​

Champs de niveau supérieur

​

Entrées de plugin

​

Comment une entrée se combine avec plugin.json

• Pas de plugin.json : l’entrée est le manifeste indépendamment de strict. Chaque champ de manifeste dans l’entrée s’applique, y compris mcpServers, lspServers, userConfig et channels.
• plugin.json présent : plugin.json est le manifeste. Le mode strict décide si les six champs de composant de l’entrée, commands, agents, skills, hooks, outputStyles et themes, sont combinés avec lui ou rejetés comme un conflit. L’entrée mcpServers, lspServers, userConfig et channels ne s’appliquent pas. Déclarez-les dans plugin.json.

​

Hooks dans une entrée

​

Champs d’affichage

• Pour un champ que vous définissez sur l’entrée, les utilisateurs voient la valeur de l’entrée, même quand plugin.json en définit une différente.
• Pour un champ que l’entrée laisse non défini, les utilisateurs voient la valeur plugin.json.

​

Mode strict

​

Sources de plugin

• ref : une branche ou une balise. Par défaut, la branche par défaut du référentiel.
• sha : un SHA de commit complet de 40 caractères en minuscules. Lorsque vous définissez à la fois ref et sha, Claude Code extrait sha. Sur la plupart des hôtes git, y compris GitHub, GitLab et Bitbucket, cela signifie que l’installation réussit même si la branche ou la balise nommée par ref a depuis été supprimée en amont, tant que le commit est toujours accessible à partir du référentiel. Certains serveurs, tels que AWS CodeCommit, ne supportent pas la récupération de commits par SHA. Sur ces serveurs, le ref doit toujours exister et le commit épinglé doit être accessible à partir de celui-ci.

​

Source de plugin avec chemin relatif

{ "name": "formatter", "source": "./plugins/formatter" }

• github, git, file et directory : Claude Code a les fichiers de la marketplace.
• url : Claude Code récupère uniquement marketplace.json, donc les chemins relatifs ne peuvent pas se résoudre. Donnez à chaque plugin une source d’objet à la place, telle que github ou git-subdir.
• settings : les chemins relatifs sont rejetés d’emblée.

​

Noms nus sous pluginRoot

• Il doit lui-même être un chemin relatif à l’intérieur de la marketplace.
• Il n’a aucun effet sur une source qui commence déjà par ./.
• Une source qui contient un /, telle que team-a/formatter, n’est pas un nom nu et a toujours besoin du préfixe ./, même lorsque metadata.pluginRoot est défini.

​

Source de plugin github

{
  "name": "formatter",
  "source": {
    "source": "github",
    "repo": "your-org/formatter",
    "ref": "v2.0.0",
    "sha": "a1b2c3d4e5f6a7b8c9d0e1f2a3b4c5d6e7f8a9b0"
  }
}

​

Source de plugin url

{
  "name": "formatter",
  "source": {
    "source": "url",
    "url": "https://gitlab.example.com/your-group/formatter.git",
    "ref": "main"
  }
}

​

Source de plugin git-subdir

{
  "name": "formatter",
  "source": {
    "source": "git-subdir",
    "url": "https://github.com/your-org/monorepo.git",
    "path": "tools/formatter"
  }
}

​

Source de plugin npm

• package : un nom de package, ou un nom scopé tel que @your-org/formatter
• version : une version ou une plage
• registry : une URL de registre pour un package qui n’est pas sur le registre par défaut

{
  "name": "formatter",
  "source": {
    "source": "npm",
    "package": "@your-org/formatter",
    "version": "^2.0.0",
    "registry": "https://npm.example.com"
  }
}

​

Source de plugin archive

{
  "name": "formatter",
  "source": {
    "source": "archive",
    "url": "https://artifacts.example.com/formatter-2.0.0.zip",
    "sha256": "6bfa50e3d2e00c052b46abe51fff89346ac803e45771f76dcf6df1ab74cca5e1"
  }
}

​

Source de plugin command

• command : une commande shell qui imprime le chemin absolu du répertoire du plugin en une seule ligne et quitte 0. Claude Code affiche la chaîne entière aux utilisateurs pour examen avant de l’exécuter. Écrivez-la en ASCII imprimable, au maximum 500 caractères, sans suite de quatre espaces ou plus.
• timeout : un nombre entier de secondes de 1 à 600. Par défaut 60.
• mode : copy, la valeur par défaut, ou link. Voir Mode copie et mode lien.

{
  "name": "formatter",
  "source": {
    "source": "command",
    "command": "my-tool claude-plugin-path",
    "timeout": 120
  }
}

​

Ce que la commande doit faire

• Shell et répertoire de travail : Claude Code exécute la commande via sh, ou via cmd.exe sur Windows, à partir du répertoire personnel de l’utilisateur. Donnez un chemin absolu ou une commande sur PATH.
• Sortie : imprimez exactement une ligne sur stdout, le chemin absolu du répertoire du plugin, et quittez 0 dans les timeout secondes.
• Contenu du répertoire : le répertoire contient le plugin complet au moment où la commande quitte. Le chemin peut différer d’une exécution à l’autre.

​

Sortie qui échoue l’installation ou la mise à jour

• Pas de contenu de plugin : le répertoire imprimé n’a pas de contenu de plugin à son niveau supérieur, tel qu’un répertoire .claude-plugin/ ou un répertoire skills/, commands/, agents/ ou hooks/.
• Le répertoire de la session elle-même : le répertoire imprimé est celui dans lequel Claude Code a été démarré, ou l’un de ses parents.
• Un chemin réseau : sur Windows, le chemin imprimé est un chemin UNC.
• Trop volumineux à copier : en mode copie, le répertoire est plus grand que 256 MiB ou a plus de 20 000 entrées.

​

Mode copie et mode lien

• copy : Claude Code copie le répertoire dans le cache du plugin et dérive la version du plugin d’un hash des fichiers copiés. Votre outil peut supprimer ou réécrire le répertoire après la sortie de la commande. Une réexécution qui produit des fichiers identiques compte comme à jour.
• link : Claude Code remplit l’entrée du cache du plugin avec un lien vers chaque entrée de niveau supérieur du répertoire imprimé et charge les fichiers sur place. Rien n’est copié, les contenus de fichiers ne sont pas hashés, et les limites de taille ne s’appliquent pas. Utilisez-le pour un répertoire trop volumineux à copier, tel qu’une exportation SDK rendue.

• Gardez le répertoire en place : Claude Code charge le plugin via les liens à chaque démarrage, donc le répertoire imprimé doit rester où il est tant que le plugin reste installé.
• Imprimez un chemin différent pour signaler un nouveau contenu : la version provient du chemin réel du répertoire imprimé et de ses entrées de niveau supérieur, pas des fichiers à l’intérieur.
• Gardez les symlinks de niveau supérieur à l’intérieur du répertoire : l’installation échoue si une entrée de niveau supérieur est un symlink qui pointe en dehors du répertoire imprimé.
• Incluez node_modules : Claude Code saute l’installation de dépendance de package Node.js pour un plugin en mode lien, donc imprimez un répertoire qui contient déjà les packages dont le plugin a besoin.
• Sessions démarrées à l’intérieur du répertoire : une session démarrée dans le répertoire imprimé ou n’importe où en dessous ne charge pas le plugin.
• Pas sur Windows : Claude Code refuse d’installer un plugin en mode lien sur Windows. Déclarez "mode": "copy" là.

​

Sources marketplace

• claude plugin marketplace add : Claude Code crée la source à partir de la chaîne que vous passez.
• extraKnownMarketplaces : vous écrivez la source vous-même en tant qu’objet source.
• strictKnownMarketplaces et blockedMarketplaces : les administrateurs écrivent les sources dans ces deux listes de politique. strictKnownMarketplaces est la liste blanche et blockedMarketplaces est la liste noire.

​

Champs par type

​

Valeurs source valides uniquement dans les listes de politique

• hostPattern et pathPattern : expressions régulières que Claude Code teste contre une source avant de la récupérer.
• skills-dir : pas une source. Si vous définissez strictKnownMarketplaces du tout, les plugins du répertoire de compétences cessent de charger jusqu’à ce que vous ajoutiez {"source": "skills-dir"} à cette liste.
• owner/* : en tant que valeur repo github, correspond à chaque référentiel sous exactement ce propriétaire GitHub. Nécessite Claude Code v2.1.223 ou ultérieure.

​

Objets source dans les paramètres

{
  "extraKnownMarketplaces": {
    "your-marketplace": {
      "source": {
        "source": "git",
        "url": "https://git.example.com/your-org/your-marketplace.git",
        "ref": "main"
      }
    }
  }
}

{
  "strictKnownMarketplaces": [
    { "source": "github", "repo": "your-org/*" },
    { "source": "hostPattern", "hostPattern": "^git\\.example\\.com$" }
  ]
}

​

Messages de validation

​

Entrée invalide sur une source

• Un chemin relatif qui ne commence pas par ./, autre que "." ou un nom nu sous metadata.pluginRoot
• Un package npm contenant ..
• Un type source qui n’est pas l’un des sources de plugin
• Un type connu avec un champ obligatoire manquant ou du mauvais type, tel que github sans repo

​

Défaillances que la validation ne détecte pas

​

Étapes suivantes

• Créer une marketplace : créez une marketplace à partir de ces champs et installez-la localement
• Héberger et maintenir une marketplace : où mettre le fichier et comment les utilisateurs reçoivent les modifications
• Référence du manifeste de plugin : les champs plugin.json qu’une entrée peut remplacer
• Gérer les plugins pour votre organisation : recettes de liste blanche et liste noire qui utilisent ces valeurs source