Gérer les plugins Claude Code pour votre organisation

​

Pré-installer et exiger des plugins

​

Choisir un mécanisme de livraison

• Paramètres gérés par le serveur : définissez les clés de plugin en JSON à Paramètres de l’organisation > Claude Code > Paramètres gérés. Nécessite un rôle Propriétaire dans votre organisation Claude. Une session cloud récupère ces paramètres avant d’installer les plugins.
• Politiques MDM : sur macOS, livrez un plist dont les clés de niveau supérieur sont les clés de paramètres. Sur Windows, stockez l’ensemble du document JSON en tant que chaîne dans une valeur de registre. Le domaine plist et la clé de registre se trouvent dans Où chaque mécanisme stocke la politique.
• Fichier de paramètres gérés : placez un managed-settings.json au chemin système de la plateforme. Vous pouvez également ajouter des fichiers au répertoire drop-in managed-settings.d/ à côté de celui-ci. Les chemins de fichier par plateforme se trouvent dans Où chaque mécanisme stocke la politique, et les règles de fusion drop-in se trouvent dans Diviser une politique basée sur fichier entre les équipes.

​

Quelle source gérée s’applique sur une machine

​

Exiger un marketplace et ses plugins

{
  "extraKnownMarketplaces": {
    "your-marketplace": {
      "source": { "source": "github", "repo": "your-org/your-marketplace" },
      "autoUpdate": true
    }
  },
  "enabledPlugins": {
    "code-formatter@your-marketplace": true,
    "deploy-helper@your-marketplace": true
  }
}

• autoUpdate : true garde le marketplace et ses plugins en actualisation en arrière-plan, et false désactive cela. Voir Définir la politique de mise à jour.
• source : github est l’un de plusieurs types de sources. Une source git prend une url pour GitLab ou un hôte interne, et une source url prend l’adresse d’un marketplace.json hébergé. Chaque forme de source se trouve dans la référence du marketplace.

• Marketplaces : une entrée de marketplace gérée remplace une entrée de priorité inférieure du même nom, et les champs des deux entrées ne fusionnent pas.
• Copies --plugin-dir : --plugin-dir charge un plugin à partir d’un répertoire local pour une session. Pour ce qui se passe quand le nom de cette copie correspond à un plugin que votre enabledPlugins géré nomme, voir Conflits de noms.

​

Exiger des plugins par référentiel

• Sessions interactives : Claude Code enregistre le marketplace uniquement après que le contributeur accepte la boîte de dialogue de confiance de l’espace de travail pour ce dossier.
• Exécutions non interactives -p : les entrées s’appliquent uniquement dans un dossier dont la confiance que l’utilisateur a déjà acceptée de manière interactive, ou dont vous définissez l’indicateur hasTrustDialogAccepted dans ~/.claude.json.

​

Quand chaque surface applique les clés de plugin

​

Confirmer le déploiement

• Sur une machine : démarrez Claude Code et exécutez /plugin. Le marketplace et les plugins sont listés.
• En IC : exécutez claude -p avec --output-format stream-json --verbose. L’événement init liste les plugins chargés sous plugins.

​

Ensemencer les conteneurs et l’IC

CLAUDE_CODE_PLUGIN_CACHE_DIR=/opt/claude-seed claude plugin marketplace add your-org/your-marketplace
CLAUDE_CODE_PLUGIN_CACHE_DIR=/opt/claude-seed claude plugin install code-formatter@your-marketplace

• Lecture seule : Claude Code n’écrit jamais dans le seed et force autoUpdate à off pour les marketplaces de seed.
• Les entrées de seed ont la priorité : à chaque démarrage, un marketplace déclaré dans le seed remplace l’entrée de l’utilisateur du même nom. Les utilisateurs se désabonnent d’un plugin de seed avec claude plugin disable, pas en supprimant le marketplace.
• La mise à jour et la suppression échouent : claude plugin marketplace update <name> et remove sans --scope sur un marketplace de seed échouent avec un message qui nomme le répertoire du seed.
• La politique s’applique toujours : la liste blanche et la liste noire vérifient également la source enregistrée d’un marketplace de seed. Autorisez la source à partir de laquelle vous avez construit le seed.

​

Restreindre ce que les utilisateurs peuvent installer

• Avant un téléchargement : les listes s’appliquent quand un utilisateur ajoute un marketplace et à chaque installation, mise à jour, actualisation et mise à jour automatique.
• Au démarrage de la session : les listes s’appliquent à nouveau aux plugins déjà installés, donc un plugin installé dont la source du marketplace ne correspond plus ne se charge pas. /plugin le liste avec Marketplace "<name>" is not in the allowed marketplace list ou Marketplace "<name>" is blocked by enterprise policy.

• La console d’administration claude.ai : Claude Code applique les deux listes dans les sessions qui lisent les paramètres gérés par le serveur. claude.ai les vérifie également quand quelqu’un dans votre organisation ajoute un nouveau marketplace à partir d’un référentiel git sur claude.ai, ou à partir de Personnaliser dans l’application Claude Desktop en dehors de son onglet Code. Cela couvre un marketplace qu’un membre ajoute pour son propre compte et un ajouté pour toute l’organisation sous Paramètres de l’organisation > Plugins. claude.ai refuse un référentiel que la liste blanche n’admet pas ou que la liste noire nomme. Il ne re-vérifie pas un marketplace qui a été ajouté dans l’un ou l’autre endroit avant que vous définissiez les listes, et il ne vérifie pas les plugins téléchargés.
• Un fichier de paramètres gérés, une politique au niveau du système d’exploitation ou une autre source gérée : Claude Code applique les deux listes où il lit cette source. claude.ai ne la lit pas.

​

Matrice de contrôle

• enabledPlugins : vous pouvez le définir dans n’importe quelle portée, et les paramètres gérés le verrouillent.
• syncClaudeAiPlugins : chaque utilisateur peut également le définir dans ses propres paramètres utilisateur ou locaux. Voir sa portée dans la référence des paramètres.
• CLAUDE_CODE_DISABLE_OFFICIAL_MARKETPLACE_AUTOINSTALL : c’est une variable d’environnement que vous livrez via le bloc env géré montré sous Désactiver les mises à jour pour toute la flotte.

​

Alias pour les clés du marketplace

• Version : les alias nécessitent Claude Code v2.1.232 ou ultérieur, et les clients plus anciens les ignorent. Dans un fichier qu’une flotte mixte lit, gardez les noms canoniques.
• Les deux orthographes définies : quand un fichier définit les deux orthographes, la valeur de la clé canonique s’applique.

​

Liste blanche avec strictKnownMarketplaces

• github : { "source": "github", "repo": "your-org/approved-plugins" }, avec ref et path optionnels.
• Caractère générique de propriétaire github : { "source": "github", "repo": "your-org/*" } correspond à chaque référentiel sous ce propriétaire. Le * doit représenter le nom de référentiel entier. Claude Code ignore les entrées telles que */plugins et your-org/tools-* comme invalides, donc elles ne correspondent à rien. Nécessite Claude Code v2.1.223 ou ultérieur.
• git : { "source": "git", "url": "https://gitlab.example.com/tools/plugins.git" }, avec ref et path optionnels.
• url : { "source": "url", "url": "https://plugins.example.com/marketplace.json" }, avec headers optionnels.
• file et directory : { "source": "file", "path": "/opt/marketplace/marketplace.json" } ou { "source": "directory", "path": "/opt/marketplace/plugins" }, avec des chemins absolus.
• hostPattern : { "source": "hostPattern", "hostPattern": "^github\\.example\\.com$" }, comparé à l’hôte des sources github, git et url. Le motif correspond n’importe où dans le nom d’hôte, donc ancrez-le avec ^ et $ comme montré pour correspondre à l’hôte entier. Une source github compte toujours comme github.com. Utilisez une entrée hostPattern pour un serveur GitHub Enterprise Server ou un hôte GitLab où les développeurs créent leurs propres marketplaces. La page GHES a l’exemple travaillé.
• pathPattern : { "source": "pathPattern", "pathPattern": "^/opt/approved/" }, comparé au path des sources file et directory. Le motif correspond n’importe où dans le chemin, donc commencez-le par ^ pour épingler un préfixe de répertoire. ".*" autorise chaque chemin local.
• skills-dir : { "source": "skills-dir" } garde les plugins du répertoire de compétences en chargement tandis qu’une liste blanche est définie, et ne correspond à aucun marketplace.

​

Comment les entrées correspondent

• Une entrée sans ref ne couvre pas une source avec ref: "main".
• Une entrée pour your-org/your-marketplace ne couvre pas une URL git qui clone le même référentiel.
• Une barre oblique finale, un suffixe .git ou ssh:// à la place de https:// est une valeur différente. Quand un marketplace peut être cloné par plus d’une URL, préférez une entrée hostPattern.

​

Garder les plugins du répertoire de compétences en chargement

​

Marketplaces hébergés sur claude.ai

​

Verrouiller chaque source

​

Liste noire avec blockedMarketplaces

• Les URL git sont canonicalisées, donc les formes git@ et https://, les suffixes .git et les barres obliques finales d’un référentiel github.com correspondent tous à la même entrée.
• Une entrée github bloque également l’URL git équivalente, et vice versa.
• Pour une entrée owner/*, la comparaison du propriétaire est insensible à la casse.
• Une entrée sans ref ou path bloque chaque ref et chemin des référentiels qu’elle correspond.

{
  "blockedMarketplaces": [
    { "source": "github", "repo": "untrusted-org/*" }
  ]
}

​

Autoriser le marketplace officiel et le vôtre

{
  "strictKnownMarketplaces": [
    { "source": "github", "repo": "anthropics/claude-plugins-official" },
    { "source": "github", "repo": "your-org/*" },
    { "source": "skills-dir" }
  ],
  "extraKnownMarketplaces": {
    "claude-plugins-official": {
      "source": { "source": "github", "repo": "anthropics/claude-plugins-official" }
    },
    "your-marketplace": {
      "source": { "source": "github", "repo": "your-org/your-marketplace" }
    }
  },
  "enabledPlugins": {
    "code-formatter@your-marketplace": true,
    "deploy-helper@your-marketplace": true
  },
  "disableSideloadFlags": true
}

• La liste blanche n’enregistre rien : une entrée extraKnownMarketplaces le fait, et elle doit elle-même passer la liste blanche. Claude Code refuse d’enregistrer un marketplace géré dont la source ne correspond pas à la liste blanche.
• Le marketplace officiel ne s’enregistre que dans une session de terminal interactif : même là, il ne s’enregistre que quand la liste blanche le permet. Une exécution -p ou un terminal attaché à une session cloud ne l’enregistre jamais.
• Une tentative bloquée est mémorisée : si une machine a jamais fonctionné sous une politique qui bloquait le marketplace officiel, Claude Code enregistre la tentative bloquée et ne réessaie pas après le changement de politique. Un verrouillage [] est une telle politique. Cette machine l’enregistre à nouveau uniquement via une entrée extraKnownMarketplaces comme celle de cette politique, une entrée enabledPlugins pour l’un de ses plugins, ou un /plugin marketplace add manuel.

​

Définir la politique de mise à jour

​

Activer ou désactiver la mise à jour automatique par marketplace

• Si l’entrée gérée définit le champ, Claude Code rejette le basculement /plugin de l’utilisateur avec une erreur qui commence par Auto-update for '<name>' is set by.
• Si l’entrée gérée laisse le champ non défini, le basculement de l’utilisateur persiste.

​

Désactiver les mises à jour pour toute la flotte

{
  "env": {
    "DISABLE_AUTOUPDATER": "1"
  }
}

​

Assigner les canaux de version aux groupes d’utilisateurs

• Déployez des paramètres gérés par le point de terminaison séparés, tels qu’un fichier de paramètres gérés ou un profil MDM, sur les appareils de chaque groupe. Pour vérifier si le fichier ou le profil par groupe s’applique sur un appareil qui a également une source au niveau de l’organisation, voir Comment Claude Code combine les sources gérées.
• Définissez une politique de passerelle d’applications Claude par groupe. La passerelle applique la première politique dont la règle de correspondance correspond à un utilisateur, donc ordonnez les politiques pour que chaque utilisateur atteigne la politique de son groupe. La extraKnownMarketplaces de cette politique ne fusionne pas avec celle d’une autre politique, donc listez chaque marketplace dont le groupe a besoin, pas seulement son marketplace de canal.

{
  "extraKnownMarketplaces": {
    "stable-tools": {
      "source": { "source": "github", "repo": "your-org/stable-tools" }
    }
  }
}

​

Recommander des plugins

​

Auditer et examiner

​

Événements OpenTelemetry

​

API Analytics

​

Planifier ce que les paramètres gérés ne peuvent pas appliquer

• Ciblage par utilisateur ou par groupe : chaque clé de plugin s’applique à chaque utilisateur qui reçoit les paramètres. Les paramètres gérés par le serveur livrent une configuration par organisation. Pour une politique par groupe, utilisez des paramètres gérés par le point de terminaison séparés ou des politiques de passerelle, comme sous Assigner les canaux de version aux groupes d’utilisateurs.
• Restreindre les entrées à l’intérieur d’un marketplace autorisé : la liste blanche correspond aux sources de marketplace. Pour bloquer un plugin d’un marketplace autorisé, définissez-le sur false dans enabledPlugins géré.
• Masquer /plugin : aucune clé ne désactive la commande. L’équivalent le plus proche combine une liste blanche nommant uniquement votre marketplace, des entrées enabledPlugins gérées pour les plugins que vous fournissez, et disableSideloadFlags.
• Contrôler --plugin-dir via la liste blanche : la liste blanche ne couvre pas --plugin-dir. disableSideloadFlags le fait.
• Appliquer les bascules de plugin claude.ai via ces clés : Paramètres de l’organisation > Plugins et compétences ne définit pas les clés de cette page. Ce que les membres et votre organisation activent là atteint l’interface de ligne de commande sous forme de plugins synchronisés, qui ont leurs propres contrôles.

​

Dépanner la politique

• Le fichier géré n’a pas été analysé : quand un managed-settings.json n’est pas un JSON valide, Claude Code refuse de démarrer et imprime une erreur nommant le fichier. Un fichier qui s’analyse mais a une entrée invalide garde le reste de sa politique. Voir Entrées invalides dans les paramètres gérés.
• La source gérée n’a pas chargé : exécutez /status et cherchez Enterprise managed settings dans la ligne Setting sources. S’il manque, la source n’a pas chargé.
• Un utilisateur signale blocked by enterprise policy : le message nomme le marketplace ou sa source. Pour une liste blanche, il liste également les sources autorisées. Les entrées visibles par l’utilisateur se trouvent sur Dépanner les plugins.
• Un plugin que l’utilisateur a désactivé dans ~/.claude/settings.json se charge toujours : une autre source de paramètres l’a réactivé, comme une entrée enabledPlugins gérée qui le force-active. /plugin et claude plugin list affichent Disabled in ~/.claude/settings.json but still loads avec cette source de paramètres.

​

Étapes suivantes

• Référence du marketplace : les valeurs source que extraKnownMarketplaces, strictKnownMarketplaces et blockedMarketplaces acceptent
• Héberger et maintenir un marketplace : exécutez le marketplace vers lequel votre politique pointe
• Sécurité et confiance des plugins : ce qu’un plugin peut faire sur une machine et comment en examiner un avant l’installation
• Paramètres gérés par le serveur : livrez ces clés à partir de la console d’administration claude.ai
• Dépanner les plugins : les messages que les utilisateurs voient quand la politique les bloque