Recommander votre plugin depuis votre CLI

Si vous maintenez une CLI ou un SDK, votre outil peut inviter les utilisateurs de Claude Code à installer votre plugin. Lorsque votre CLI détecte qu’elle s’exécute dans Claude Code, faites-la écrire une balise <claude-code-hint /> sur une seule ligne vers stderr. Claude Code supprime la ligne de la sortie des outils Bash et PowerShell avant que le modèle ne voie la sortie, puis affiche à l’utilisateur une invite d’installation unique. Cette page s’applique uniquement si votre plugin est répertorié dans claude-plugins-official ou une autre marketplace avec l’un des noms de marketplace officiels d’Anthropic. La marketplace communautaire, claude-community, n’en fait pas partie.

Pour publier un plugin, consultez Publier et distribuer un plugin.

Émettre l’indice

Émettez la balise uniquement lorsque CLAUDECODE ou CLAUDE_CODE_CHILD_SESSION est défini, afin qu’elle n’apparaisse pas lorsqu’une personne exécute votre CLI directement. Claude Code définit CLAUDECODE=1 dans les commandes qu’il exécute via les outils Bash et PowerShell et dans les commandes hook. À partir de la v2.1.172, il définit également CLAUDE_CODE_CHILD_SESSION=1 là-bas. Les variables diffèrent dans les processus qui les portent :

CLAUDECODE : défini par chaque version de Claude Code. Les extensions IDE le définissent également dans leurs terminaux intégrés, donc une vérification sur CLAUDECODE seul émet également la balise lorsqu’une personne exécute votre CLI elle-même dans l’un de ces terminaux
CLAUDE_CODE_CHILD_SESSION : défini uniquement dans les sous-processus que Claude Code lui-même démarre. Utilisez-le lorsque vous pouvez exiger la v2.1.172 ou une version ultérieure

La référence des variables d’environnement contient les détails. Les exemples suivants vérifient CLAUDECODE pour la portée la plus large et émettent un indice pour un plugin nommé example-cli dans la marketplace officielle :

if (process.env.CLAUDECODE) {
  process.stderr.write(
    '<claude-code-hint v="1" type="plugin" value="example-cli@claude-plugins-official" />\n',
  )
}

import os, sys

if os.environ.get("CLAUDECODE"):
    print(
        '<claude-code-hint v="1" type="plugin" value="example-cli@claude-plugins-official" />',
        file=sys.stderr,
    )

if os.Getenv("CLAUDECODE") != "" {
    fmt.Fprintln(os.Stderr,
        `<claude-code-hint v="1" type="plugin" value="example-cli@claude-plugins-official" />`)
}

if [ -n "$CLAUDECODE" ]; then
  printf '%s\n' '<claude-code-hint v="1" type="plugin" value="example-cli@claude-plugins-official" />' >&2
fi

Remplacez example-cli par le nom de votre plugin dans la marketplace officielle. Vous pouvez émettre l’indice à chaque invocation, car Claude Code demande une fois pour chaque plugin. Pour vérifier l’émetteur, exécutez CLAUDECODE=1 example-cli dans un terminal et confirmez que la ligne de balise apparaît sur stderr, puis exécutez example-cli sans la variable et confirmez que rien d’extra ne s’affiche.

Format de l’indice

La balise doit occuper sa propre ligne ; Claude Code ignore une balise intégrée au milieu d’une ligne. La balise prend trois attributs, tous obligatoires :

Attribut	Description
`v`	Version du protocole. `1` est la seule valeur prise en charge
`type`	Type d’indice. `plugin` est la seule valeur prise en charge
`value`	Identifiant du plugin sous la forme `name@marketplace`

Les valeurs peuvent être entre guillemets doubles ou sans guillemets ; une valeur sans guillemets ne peut pas contenir d’espaces. Claude Code supprime la ligne de la sortie même lorsque v ou type n’est pas reconnu.

Vérifier quand l’invite apparaît

L’invite n’apparaît que dans les sessions de terminal interactives. Dans les exécutions claude -p, dans les exécutions de sous-agent et dans la sortie des commandes hook, la balise est supprimée et aucune invite n’est affichée. Toutes ces vérifications doivent également réussir :

Officiel et installable : value nomme un plugin que Claude Code trouve dans sa copie locale d’une marketplace officielle, qui n’est pas déjà installé, et qu’aucune politique ne bloque
Analytics activé : une session où les analytics de Claude Code sont désactivés ne demande jamais, par exemple une avec DISABLE_TELEMETRY, DO_NOT_TRACK, ou CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC défini, ou une sur un fournisseur tiers tel qu’Amazon Bedrock, où la désactivation automatique de la télémétrie s’applique
Limites de fréquence : une invite par session, une invite au total par plugin indépendamment de la réponse de l’utilisateur, et aucune une fois que 100 plugins ont été demandés sur cette machine
Non désactivé : l’utilisateur n’a pas choisi Non, et ne plus afficher les conseils d’installation de plugins
Session locale et assistée : l’espace de travail de la session est local plutôt que sur une machine cloud ou distante, et la session n’est pas exécutée sans surveillance. Par exemple, une session démarrée avec --cloud, une servant Remote Control, ou un coéquipier d’une équipe d’agents ne demande jamais

Aperçu de ce que l’utilisateur voit

Lorsque les vérifications dans Vérifier quand l’invite apparaît réussissent, Claude Code affiche une boîte de dialogue Recommandation de plugin comme suit :

─────────────────────────────────────────────────────────────
  Recommandation de plugin

    La commande example-cli suggère d'installer un plugin.

    Plugin : example-cli
    Marketplace : claude-plugins-official
    Description : Intégration officielle pour les déploiements example-cli

    Voulez-vous l'installer ?
    ❯ 1. Oui, installer
      2. Non
      3. Non, et ne plus afficher les conseils d'installation de plugins

─────────────────────────────────────────────────────────────

La boîte de dialogue nomme le premier mot de la commande shell que Claude a exécutée, afin que les utilisateurs puissent détecter une discordance. Chaque réponse a un effet :

Oui, installer : installe le plugin au niveau utilisateur
Non, et ne plus afficher les conseils d’installation de plugins : désactive les futures invites d’indice pour cet utilisateur
Pas de réponse pendant 30 secondes : compte comme Non

Étapes suivantes

Publier et distribuer un plugin : les routes dans chaque marketplace, y compris la marketplace officielle, que l’indice nécessite
Référence des commandes de plugin : la commande shell qui installe le même plugin en dehors d’une session

Plugins

Utiliser les plugins

Créer des plugins

Exécuter une marketplace

Gérer les plugins de votre organisation

Dépannage

Référence

Recommander votre plugin depuis votre CLI

Émettre l’indice

Format de l’indice

Vérifier quand l’invite apparaît

Aperçu de ce que l’utilisateur voit

Étapes suivantes

​Émettre l’indice

​Format de l’indice

​Vérifier quand l’invite apparaît

​Aperçu de ce que l’utilisateur voit

​Étapes suivantes

Émettre l’indice

Format de l’indice

Vérifier quand l’invite apparaît

Aperçu de ce que l’utilisateur voit

Étapes suivantes