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# Empfehlen Sie Ihr Plugin von Ihrer CLI aus

6 

7> Geben Sie einen einzeiligen Marker von Ihrer CLI aus, damit Claude Code Benutzer auffordert, Ihr offizielles Plugin zu installieren.

8 

9Wenn Sie eine CLI oder ein SDK verwalten und ein Plugin im offiziellen Anthropic-Marketplace haben, kann Ihr Tool Claude Code-Benutzer auffordern, dieses Plugin zu installieren. Ihre CLI schreibt einen einzeiligen Marker auf stderr, wenn sie erkennt, dass sie in Claude Code ausgeführt wird. Claude Code liest den Marker, entfernt ihn aus der Ausgabe und zeigt dem Benutzer eine einmalige Installationsaufforderung an.

10 

11Claude Code entfernt die Hinweiszeile aus der Befehlsausgabe, bevor sie an das Modell gesendet wird, sodass der Marker nie in der Konversation erscheint und nicht zur Token-Nutzung zählt. Das Protokoll erfordert keine zusätzlichen Befehle und ändert nicht, was Ihre CLI für Benutzer außerhalb von Claude Code ausgibt.

12 

13Diese Seite ist für CLI- und SDK-Verwalter. Wenn Sie nach der Installation von Plugins suchen, siehe [Plugins entdecken und installieren](/de/discover-plugins).

14 

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

16 Funktionsweise

17</h2>

18 

19Claude Code setzt die [`CLAUDECODE`](/de/env-vars) Umgebungsvariable auf `1` für jeden Befehl, den es über die Bash- und PowerShell-Tools ausführt, und für [hook](/de/hooks)-Befehle. Wenn Ihre CLI diese Variable sieht, schreibt sie ein selbstschließendes `<claude-code-hint />`-Tag auf stderr. Bei hook-Befehlen wird das Hinweis-Tag entfernt und ignoriert. Nur die Ausgabe von Bash- und PowerShell-Tools löst die Installationsaufforderung aus.

20 

21Wenn Claude Code die Befehlsausgabe empfängt, führt es folgende Schritte aus:

22 

231. Scannt nach Hinweiszeilen und entfernt sie, bevor die Ausgabe das Modell erreicht

242. Überprüft, dass der Hinweis auf ein Plugin in einem offiziellen Anthropic-Marketplace abzielt

253. Überprüft, dass das Plugin nicht bereits installiert ist und nicht zuvor aufgefordert wurde

264. Zeigt dem Benutzer eine Installationsaufforderung an, die den Befehl benennt, der den Hinweis ausgegeben hat

27 

28Claude Code installiert ein Plugin nie automatisch. Der Benutzer bestätigt immer.

29 

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

31 Geben Sie den Hinweis aus

32</h2>

33 

34Geben Sie die Ausgabe an die `CLAUDECODE` Umgebungsvariable ab, damit der Marker nie im Terminal eines menschlichen Benutzers erscheint. Schreiben Sie dann das Tag auf stderr auf seiner eigenen Zeile.

35 

36Die folgenden Beispiele geben einen Hinweis für ein Plugin namens `example-cli` im offiziellen Marketplace aus:

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 

70Ersetzen Sie `example-cli` durch den Namen Ihres Plugins im offiziellen Marketplace.

71 

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

73 Wählen Sie, wo Sie ausgeben

74</h2>

75 

76Sie kontrollieren, welche Code-Pfade den Hinweis ausgeben. Claude Code dedupliziert nach Plugin, daher hat die Ausgabe bei jeder Aufrufen keinen Nachteil. Berührungspunkte, die gut funktionieren, sind:

77 

78| Platzierung | Warum es funktioniert |

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

80| `--help` Ausgabe | Claude führt häufig Hilfe aus, wenn eine unbekannte CLI erkundet wird |

81| Fehler bei unbekanntem Unterbefehl | Erreicht den Moment, in dem Claude über Ihre Schnittstelle verwirrt ist |

82| Anmeldungs- oder Authentifizierungserfolg | Der Benutzer ist bereits in einer Einrichtungsmentalität |

83| Willkommensnachricht beim ersten Ausführen | Ein natürlicher Onboarding-Moment |

84 

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

86 Was der Benutzer sieht

87</h2>

88 

89Wenn der Hinweis alle Überprüfungen besteht, zeigt Claude Code eine Aufforderung wie die folgende an:

90 

91```text theme={null}

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

93 Plugin-Empfehlung

94 

95 Der Befehl example-cli schlägt vor, ein Plugin zu installieren.

96 

97 Plugin: example-cli

98 Marketplace: claude-plugins-official

99 Offizielle Integration für example-cli-Bereitstellungen

100 

101 Möchten Sie es installieren?

102 ❯ 1. Ja, example-cli installieren

103 2. Nein

104 3. Nein, und zeige mir keine Plugin-Installationshinweise mehr

105 

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

107```

108 

109Die Aufforderung benennt den Befehl, der den Hinweis erzeugt hat, damit Benutzer einen Mismatch zwischen dem Tool und dem Plugin, das es empfiehlt, erkennen können. Wenn der Benutzer nicht innerhalb von 30 Sekunden antwortet, wird die Aufforderung als **Nein** verworfen.

110 

111Die Häufigkeit der Aufforderung ist begrenzt:

112 

113* **Einmal pro Plugin**: Nachdem die Aufforderung angezeigt wurde, zeichnet Claude Code das Plugin auf und fordert es nie wieder auf, unabhängig von der Antwort des Benutzers.

114* **Einmal pro Sitzung**: Auf allen CLIs auf dem Computer erscheint höchstens eine Hinweisaufforderung pro Claude Code-Sitzung.

115 

116Wenn Sie **Ja** auswählen, wird das Plugin im Benutzerbereich installiert. Wenn Sie **Nein, und zeige mir keine Plugin-Installationshinweise mehr** auswählen, werden alle zukünftigen Hinweisaufforderungen für den Benutzer deaktiviert.

117 

118<h2 id="hint-format">

119 Hinweisformat

120</h2>

121 

122Der Hinweis ist ein selbstschließendes Tag mit drei erforderlichen Attributen.

123 

124```text theme={null}

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

126```

127 

128| Attribut | Erforderlich | Beschreibung |

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

130| `v` | Ja | Protokollversion. `1` ist der einzige unterstützte Wert |

131| `type` | Ja | Hinweistyp. `plugin` ist der einzige unterstützte Wert |

132| `value` | Ja | Plugin-Identifier in der Form `name@marketplace` |

133 

134Attributwerte können mit doppelten Anführungszeichen zitiert oder unzitiert gelassen werden. Unzitierte Werte können keine Leerzeichen enthalten. Escape-Sequenzen werden nicht unterstützt.

135 

136<h2 id="requirements">

137 Anforderungen

138</h2>

139 

140Claude Code erzwingt zwei Bedingungen, bevor es auf einen Hinweis reagiert. Hinweise, die eine der beiden Überprüfungen nicht bestehen, werden verworfen:

141 

142* **Eigene Zeile**: Das Tag muss auf seiner eigenen Zeile stehen. Ein Tag, das in der Mitte einer Zeile eingebettet ist, z. B. in einer Log-Anweisung, wird ignoriert. Führende und nachfolgende Leerzeichen auf der Zeile sind zulässig.

143* **Offizieller Marketplace**: Der `value` muss auf ein Plugin in einem von Anthropic kontrollierten Marketplace wie `claude-plugins-official` verweisen. Hinweise, die auf andere Marketplaces verweisen, werden stillschweigend verworfen.

144 

145Die Hinweiszeile wird immer aus der Ausgabe entfernt, bevor sie das Modell erreicht, auch wenn die Version oder der Typ nicht erkannt wird, sodass der Marker nie zur Token-Nutzung zählt.

146 

147Die verbleibende Anleitung wird empfohlen, aber nicht erzwungen. Claude Code kann nicht beobachten, ob Ihre CLI sie befolgt:

148 

149* **Schreiben Sie auf stderr**: stderr hält das Tag aus Shell-Pipelines wie `example-cli deploy | jq` heraus. Claude Code scannt beide Streams, daher funktioniert auch stdout.

150* **Gate on `CLAUDECODE`**: Geben Sie nur aus, wenn die `CLAUDECODE` Umgebungsvariable gesetzt ist. Dies verhindert, dass der Marker Benutzern angezeigt wird, die Ihre CLI direkt ausführen.

151 

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

153 Bringen Sie Ihr Plugin in den offiziellen Marketplace

154</h2>

155 

156Das Hinweisprotokoll wird nur für Plugins wirksam, die im offiziellen Anthropic-Marketplace aufgelistet sind, `claude-plugins-official`. Anthropic kuratiert diesen Marketplace nach eigenem Ermessen, und die In-App-Einreichungsformulare fügen Plugins stattdessen zum [Community-Marketplace](/de/plugins#submit-your-plugin-to-the-community-marketplace) hinzu, den das Hinweisprotokoll nicht überprüft. Wenn Sie mit einem Anthropic-Partner-Kontakt zusammenarbeiten, wenden Sie sich an ihn, um die Auflistung im offiziellen Marketplace zu koordinieren.

157 

158<h2 id="see-also">

159 Siehe auch

160</h2>

161 

162* [Erstellen Sie Plugins](/de/plugins): Erstellen Sie das Plugin, das Ihre CLI empfiehlt

163* [Erstellen und verteilen Sie einen Plugin-Marketplace](/de/plugin-marketplaces): Hosten Sie Plugins außerhalb des offiziellen Marketplace

164* [Umgebungsvariablen](/de/env-vars): Vollständige Referenz für `CLAUDECODE` und verwandte Variablen