Recommander votre plugin depuis votre CLI

​

Fonctionnement

1. Analyse les lignes d’indice et les supprime avant que la sortie n’atteigne le modèle
2. Vérifie que l’indice cible un plugin dans une marketplace officielle d’Anthropic
3. Vérifie que le plugin n’est pas déjà installé et n’a pas été proposé auparavant
4. Affiche à l’utilisateur une invite d’installation qui nomme la commande qui a émis l’indice

​

Émettre l’indice

• CLAUDECODE : définie sur chaque version de Claude Code, elle atteint donc le plus de sessions. Elle est également définie dans les sessions tmux et les sous-processus du serveur MCP stdio que Claude Code démarre. Les extensions IDE la définissent également dans leurs terminaux intégrés, où un utilisateur humain peut exécuter directement votre CLI.
• CLAUDE_CODE_CHILD_SESSION : définie uniquement dans les sous-processus que Claude Code lui-même génère, tels que les appels d’outils, les commandes hook et les commandes de ligne d’état, de sorte que la balise n’atteint normalement pas un terminal humain. Un processus de longue durée qui a été démarré à l’intérieur d’une session, tel qu’un serveur tmux, capture la variable, de sorte que les shells lancés ultérieurement à partir de ce processus affichent toujours la balise brute. Nécessite Claude Code v2.1.172 ou version ultérieure, de sorte que les sessions sur les versions antérieures manquent l’indice.

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" />`)
}

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

​

Choisir où émettre

​

Ce que voit l’utilisateur

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

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

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

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

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

• Une fois par plugin : après l’affichage de l’invite, Claude Code enregistre le plugin et ne le propose jamais plus, quel que soit la réponse de l’utilisateur.
• Une fois par session : sur tous les CLIs de la machine, au maximum une invite d’indice apparaît par session Claude Code.

​

Format de l’indice

<claude-code-hint v="1" type="plugin" value="example-cli@claude-plugins-official" />

​

Exigences

• Ligne propre : la balise doit occuper sa propre ligne. Une balise intégrée au milieu d’une ligne, par exemple à l’intérieur d’une instruction de journal, est ignorée. Les espaces blancs de début et de fin sur la ligne sont autorisés.
• Marketplace officielle : la value doit référencer un plugin dans une marketplace contrôlée par Anthropic, telle que claude-plugins-official. Les indices pointant vers d’autres marketplaces sont silencieusement supprimés.

• Écrire sur stderr : stderr garde la balise hors des pipelines shell tels que example-cli deploy | jq. Claude Code analyse les deux flux, donc stdout fonctionne aussi.
• Conditionner sur une variable d’environnement : n’émettez que lorsque CLAUDECODE ou CLAUDE_CODE_CHILD_SESSION est défini. Consultez Émettre l’indice pour savoir comment les deux variables diffèrent.

​

Obtenir votre plugin dans la marketplace officielle

​

Voir aussi

• Créer des plugins : créez le plugin que votre CLI recommande
• Créer et distribuer une marketplace de plugins : hébergez des plugins en dehors de la marketplace officielle
• Variables d’environnement : référence complète pour CLAUDECODE et les variables associées