Empfehlen Sie Ihr Plugin von Ihrer CLI aus

​

Funktionsweise

1. Scannt nach Hinweiszeilen und entfernt sie, bevor die Ausgabe das Modell erreicht
2. Überprüft, dass der Hinweis auf ein Plugin in einem offiziellen Anthropic-Marketplace abzielt
3. Überprüft, dass das Plugin nicht bereits installiert ist und nicht zuvor aufgefordert wurde
4. Zeigt dem Benutzer eine Installationsaufforderung an, die den Befehl benennt, der den Hinweis ausgegeben hat

​

Hint ausgeben

• CLAUDECODE: wird auf jeder Claude Code-Version gesetzt, daher erreicht es die meisten Sitzungen. Es wird auch in tmux-Sitzungen und stdio-MCP-Server-Subprozessen gesetzt, die Claude Code startet. IDE-Erweiterungen setzen es auch in ihren integrierten Terminals, wo ein Mensch Ihre CLI direkt ausführen kann.
• CLAUDE_CODE_CHILD_SESSION: wird nur in Subprozessen gesetzt, die Claude Code selbst startet, wie z. B. Tool-Aufrufe, Hook-Befehle und Statuszeilen-Befehle, daher erreicht das Tag normalerweise kein menschliches Terminal. Ein langlebiger Prozess, der innerhalb einer Sitzung gestartet wurde, wie z. B. ein tmux-Server, erfasst die Variable, daher zeigen Shells, die später von diesem Prozess aus gestartet werden, immer noch das rohe Tag.

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

​

Wählen Sie, wo Sie ausgeben

​

Was der Benutzer sieht

─────────────────────────────────────────────────────────────
  Plugin-Empfehlung

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

    Plugin: example-cli
    Marketplace: claude-plugins-official
    Offizielle Integration für example-cli-Bereitstellungen

    Möchten Sie es installieren?
    ❯ 1. Ja, example-cli installieren
      2. Nein
      3. Nein, und zeige mir keine Plugin-Installationshinweise mehr

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

• 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.
• Einmal pro Sitzung: Auf allen CLIs auf dem Computer erscheint höchstens eine Hinweisaufforderung pro Claude Code-Sitzung.
• Nur in der Hauptinteraktiven Sitzung: Claude Code zeigt die Aufforderung nur in der Terminalsitzung an, in die der Benutzer tippt. Claude Code fordert nie für einen Befehl auf, den ein Subagent ausführt, und fordert nie auf, wenn der Benutzer Claude Code im nicht-interaktiven Modus mit dem Flag -p oder über das Agent SDK ausführt. Claude Code entfernt die Hinweiszeile trotzdem aus der Befehlsausgabe in allen diesen Fällen.
• Telemetrie-Opt-outs: Sitzungen, in denen Analysen deaktiviert sind, zeigen nie Hinweisaufforderungen. Dies umfasst Sitzungen mit DISABLE_TELEMETRY oder CLAUDE_CODE_DISABLE_NONESSENTIAL_TRAFFIC gesetzt, und Sitzungen bei Drittanbietern wie Amazon Bedrock oder Google Cloud’s Agent Platform, wo das automatische Telemetrie-Opt-out gilt.

​

Hinweisformat

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

​

Anforderungen

• 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.
• 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.

• 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.
• Gate on an environment variable: Geben Sie nur aus, wenn CLAUDECODE oder CLAUDE_CODE_CHILD_SESSION gesetzt ist. Siehe Emit the hint, um zu erfahren, wie sich die beiden Variablen unterscheiden.

​

Bringen Sie Ihr Plugin in den offiziellen Marketplace

​

Siehe auch

• Erstellen Sie Plugins: Erstellen Sie das Plugin, das Ihre CLI empfiehlt
• Erstellen und verteilen Sie einen Plugin-Marketplace: Hosten Sie Plugins außerhalb des offiziellen Marketplace
• Umgebungsvariablen: Vollständige Referenz für CLAUDECODE und verwandte Variablen