Recomienda tu plugin desde tu CLI

​

Cómo funciona

1. Busca líneas de sugerencia y las elimina antes de que la salida llegue al modelo
2. Verifica que la sugerencia apunte a un plugin en un marketplace oficial de Anthropic
3. Verifica que el plugin no esté ya instalado y no haya sido sugerido antes
4. Muestra al usuario un mensaje de instalación que nombra el comando que emitió la sugerencia

​

Emite la sugerencia

• CLAUDECODE: se establece en cada versión de Claude Code, por lo que llega a la mayoría de sesiones. También se establece en sesiones de tmux y subprocesos del servidor MCP de stdio que Claude Code inicia, y las extensiones de IDE la establecen en sus terminales integradas, donde un usuario humano puede estar ejecutando tu CLI directamente.
• CLAUDE_CODE_CHILD_SESSION: se establece solo en subprocesos que el propio Claude Code genera, como llamadas de herramientas, comandos de hook y comandos de línea de estado, por lo que la etiqueta normalmente no llega a una terminal humana. Un proceso de larga duración que se inició dentro de una sesión, como un servidor tmux, captura la variable, por lo que los shells lanzados posteriormente desde ese proceso aún muestran la etiqueta sin procesar. Requiere Claude Code v2.1.172 o posterior, por lo que las sesiones en versiones anteriores pierden la sugerencia.

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

​

Elige dónde emitir

​

Lo que ve el usuario

─────────────────────────────────────────────────────────────
  Recomendación de Plugin

    El comando example-cli sugiere instalar un plugin.

    Plugin: example-cli
    Marketplace: claude-plugins-official
    Integración oficial para implementaciones de example-cli

    ¿Te gustaría instalarlo?
    ❯ 1. Sí, instalar example-cli
      2. No
      3. No, y no mostrar sugerencias de instalación de plugins nuevamente

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

• Una vez por plugin: después de que se muestre el mensaje, Claude Code registra el plugin y nunca vuelve a solicitar para él, independientemente de la respuesta del usuario.
• Una vez por sesión: en todas las CLI de la máquina, como máximo aparece un mensaje de sugerencia por sesión de Claude Code.

​

Formato de sugerencia

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

​

Requisitos

• Línea propia: la etiqueta debe ocupar su propia línea. Una etiqueta incrustada a mitad de línea, por ejemplo dentro de una declaración de registro, se ignora. Se permite espacios en blanco al principio y al final de la línea.
• Marketplace oficial: el value debe hacer referencia a un plugin en un marketplace controlado por Anthropic como claude-plugins-official. Las sugerencias que apuntan a otros marketplaces se descartan silenciosamente.

• Escribe en stderr: stderr mantiene la etiqueta fuera de tuberías de shell como example-cli deploy | jq. Claude Code escanea ambas secuencias, por lo que stdout también funciona.
• Condiciona en una variable de entorno: solo emite cuando CLAUDECODE o CLAUDE_CODE_CHILD_SESSION está establecida. Consulta Emitir la sugerencia para saber cómo difieren las dos variables.

​

Obtén tu plugin en el marketplace oficial

​

Ver también

• Crea plugins: construye el plugin que tu CLI recomienda
• Crea y distribuye un marketplace de plugins: aloja plugins fuera del marketplace oficial
• Variables de entorno: referencia completa para CLAUDECODE y variables relacionadas