1> ## Documentation Index

2> Fetch the complete documentation index at: https://code.claude.com/docs/llms.txt

3> Use this file to discover all available pages before exploring further.

4 

5# Recommander votre plugin depuis votre CLI

6 

7> Émettez un marqueur d'une ligne depuis votre CLI pour que Claude Code invite les utilisateurs à installer votre plugin officiel.

8 

9Si vous maintenez une CLI ou un SDK et disposez d'un plugin dans la marketplace officielle d'Anthropic, votre outil peut inviter les utilisateurs de Claude Code à installer ce plugin. Votre CLI écrit un marqueur d'une ligne sur stderr lorsqu'elle détecte qu'elle s'exécute dans Claude Code. Claude Code lit le marqueur, le supprime de la sortie et affiche à l'utilisateur une invite d'installation unique.

10 

11Claude Code supprime la ligne d'indice de la sortie de la commande avant de l'envoyer au modèle, de sorte que le marqueur n'apparaît jamais dans la conversation et n'est pas comptabilisé dans l'utilisation des tokens. Le protocole ne nécessite aucune commande supplémentaire et ne change pas ce que votre CLI affiche pour les utilisateurs en dehors de Claude Code.

12 

13Cette page est destinée aux mainteneurs de CLI et de SDK. Si vous cherchez à installer des plugins, consultez [Découvrir et installer des plugins](/fr/discover-plugins).

14 

15<h2 id="how-it-works">

16 Fonctionnement

17</h2>

18 

19Claude Code définit la variable d'environnement [`CLAUDECODE`](/fr/env-vars) à `1` pour chaque commande qu'elle exécute via les outils Bash et PowerShell, et pour les commandes [hook](/fr/hooks). Lorsque votre CLI voit cette variable, elle écrit une balise auto-fermante `<claude-code-hint />` sur stderr. Dans les commandes hook, la balise d'indice est supprimée et ignorée. Seule la sortie des outils Bash et PowerShell déclenche l'invite d'installation.

20 

21Lorsque Claude Code reçoit la sortie de la commande, elle :

22 

231. Analyse les lignes d'indice et les supprime avant que la sortie n'atteigne le modèle

242. Vérifie que l'indice cible un plugin dans une marketplace officielle d'Anthropic

253. Vérifie que le plugin n'est pas déjà installé et n'a pas été proposé auparavant

264. Affiche à l'utilisateur une invite d'installation qui nomme la commande qui a émis l'indice

27 

28Claude Code n'installe jamais un plugin automatiquement. L'utilisateur confirme toujours.

29 

30<h2 id="emit-the-hint">

31 Émettre l'indice

32</h2>

33 

34Conditionnez l'émission sur la variable d'environnement `CLAUDECODE` afin que le marqueur n'apparaisse jamais dans le terminal d'un utilisateur humain. Ensuite, écrivez la balise sur stderr sur sa propre ligne.

35 

36Les exemples suivants émettent un indice pour un plugin nommé `example-cli` dans la marketplace officielle :

37 

38<CodeGroup>

39 ```javascript Node.js theme={null}

40 if (process.env.CLAUDECODE) {

41 process.stderr.write(

42 '<claude-code-hint v="1" type="plugin" value="example-cli@claude-plugins-official" />\n',

43 )

44 }

45 ```

46 

47 ```python Python theme={null}

48 import os, sys

49 

50 if os.environ.get("CLAUDECODE"):

51 print(

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

53 file=sys.stderr,

54 )

55 ```

56 

57 ```go Go theme={null}

58 if os.Getenv("CLAUDECODE") != "" {

59 fmt.Fprintln(os.Stderr,

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

61 }

62 ```

63 

64 ```shell Shell theme={null}

65 [ -n "$CLAUDECODE" ] &&

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

67 ```

68</CodeGroup>

69 

70Remplacez `example-cli` par le nom de votre plugin dans la marketplace officielle.

71 

72<h2 id="choose-where-to-emit">

73 Choisir où émettre

74</h2>

75 

76Vous contrôlez les chemins de code qui émettent l'indice. Claude Code déduplique par plugin, donc émettre à chaque invocation n'a aucun inconvénient. Les points de contact qui fonctionnent bien incluent :

77 

78| Placement | Pourquoi cela fonctionne |

79| :----------------------------------------- | :--------------------------------------------------------------------- |

80| Sortie `--help` | Claude exécute souvent l'aide lors de l'exploration d'une CLI inconnue |

81| Erreurs de sous-commande inconnue | Atteint le moment où Claude est confus par votre interface |

82| Succès de connexion ou d'authentification | L'utilisateur est déjà dans un état d'esprit de configuration |

83| Message de bienvenue de première exécution | Un moment d'intégration naturel |

84 

85<h2 id="what-the-user-sees">

86 Ce que voit l'utilisateur

87</h2>

88 

89Lorsque l'indice passe tous les contrôles, Claude Code affiche une invite comme la suivante :

90 

91```text theme={null}

92─────────────────────────────────────────────────────────────

93 Recommandation de plugin

94 

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

96 

97 Plugin : example-cli

98 Marketplace : claude-plugins-official

99 Intégration officielle pour les déploiements example-cli

100 

101 Voulez-vous l'installer ?

102 ❯ 1. Oui, installer example-cli

103 2. Non

104 3. Non, et ne plus afficher les suggestions d'installation de plugins

105 

106─────────────────────────────────────────────────────────────

107```

108 

109L'invite nomme la commande qui a produit l'indice afin que les utilisateurs puissent détecter une discordance entre l'outil et le plugin qu'il recommande. Si l'utilisateur ne répond pas dans les 30 secondes, l'invite se ferme en tant que **Non**.

110 

111La fréquence des invites est limitée :

112 

113* **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.

114* **Une fois par session** : sur tous les CLIs de la machine, au maximum une invite d'indice apparaît par session Claude Code.

115 

116Sélectionner **Oui** installe le plugin à la portée utilisateur. Sélectionner **Non, et ne plus afficher les suggestions d'installation de plugins** désactive toutes les futures invites d'indice pour l'utilisateur.

117 

118<h2 id="hint-format">

119 Format de l'indice

120</h2>

121 

122L'indice est une balise auto-fermante avec trois attributs requis.

123 

124```text theme={null}

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

126```

127 

128| Attribut | Requis | Description |

129| :------- | :----- | :------------------------------------------------------------ |

130| `v` | Oui | Version du protocole. `1` est la seule valeur prise en charge |

131| `type` | Oui | Type d'indice. `plugin` est la seule valeur prise en charge |

132| `value` | Oui | Identifiant du plugin sous la forme `name@marketplace` |

133 

134Les valeurs d'attribut peuvent être entre guillemets doubles ou sans guillemets. Les valeurs sans guillemets ne peuvent pas contenir d'espaces. Les séquences d'échappement ne sont pas prises en charge.

135 

136<h2 id="requirements">

137 Exigences

138</h2>

139 

140Claude Code applique deux conditions avant d'agir sur un indice. Les indices qui échouent à l'un des contrôles sont supprimés :

141 

142* **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.

143* **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.

144 

145La ligne d'indice est toujours supprimée de la sortie avant qu'elle n'atteigne le modèle, même lorsque la version ou le type n'est pas reconnu, de sorte que le marqueur n'est jamais comptabilisé dans l'utilisation des tokens.

146 

147Les conseils restants sont recommandés mais non appliqués. Claude Code ne peut pas observer si votre CLI les suit :

148 

149* **É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.

150* **Conditionner sur `CLAUDECODE`** : n'émettez que lorsque la variable d'environnement `CLAUDECODE` est définie. Cela empêche le marqueur d'apparaître aux utilisateurs exécutant votre CLI directement.

151 

152<h2 id="get-your-plugin-into-the-official-marketplace">

153 Obtenir votre plugin dans la marketplace officielle

154</h2>

155 

156Le protocole d'indice ne prend effet que pour les plugins répertoriés dans la marketplace officielle d'Anthropic, `claude-plugins-official`. Anthropic gère cette marketplace à sa discrétion, et les formulaires de soumission intégrés à l'application ajoutent des plugins à la [marketplace communautaire](/fr/plugins#submit-your-plugin-to-the-community-marketplace) à la place, que le protocole d'indice ne vérifie pas. Si vous travaillez avec un contact partenaire d'Anthropic, contactez-le pour coordonner une inscription à la marketplace officielle.

157 

158<h2 id="see-also">

159 Voir aussi

160</h2>

161 

162* [Créer des plugins](/fr/plugins) : créez le plugin que votre CLI recommande

163* [Créer et distribuer une marketplace de plugins](/fr/plugin-marketplaces) : hébergez des plugins en dehors de la marketplace officielle

164* [Variables d'environnement](/fr/env-vars) : référence complète pour `CLAUDECODE` et les variables associées