Recomende seu plugin a partir de sua CLI

​

Como funciona

1. Verifica linhas de dica e as remove antes da saída chegar ao modelo
2. Verifica se a dica aponta para um plugin em um marketplace oficial da Anthropic
3. Verifica se o plugin ainda não foi instalado e não foi solicitado antes
4. Mostra ao usuário um prompt de instalação que nomeia o comando que emitiu a dica

​

Emita a dica

• CLAUDECODE: definida em todas as versões do Claude Code, portanto atinge a maioria das sessões. Também é definida em sessões tmux e subprocessos do servidor MCP stdio que Claude Code inicia. Extensões IDE também a definem em seus terminais integrados, onde um humano pode estar executando seu CLI diretamente.
• CLAUDE_CODE_CHILD_SESSION: definida apenas em subprocessos que o próprio Claude Code gera, como chamadas de ferramenta, comandos hook e comandos da linha de status, portanto a tag normalmente não atinge um terminal humano. Um processo de longa duração que foi iniciado dentro de uma sessão, como um servidor tmux, captura a variável, portanto shells iniciados posteriormente a partir desse processo ainda mostram a tag bruta. Requer Claude Code v2.1.172 ou posterior, portanto sessões em versões mais antigas perdem a dica.

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

​

Escolha onde emitir

​

O que o usuário vê

─────────────────────────────────────────────────────────────
  Recomendação de Plugin

    O comando example-cli sugere instalar um plugin.

    Plugin: example-cli
    Marketplace: claude-plugins-official
    Integração oficial para implantações example-cli

    Você gostaria de instalá-lo?
    ❯ 1. Sim, instalar example-cli
      2. Não
      3. Não, e não mostrar dicas de instalação de plugin novamente

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

• Uma vez por plugin: após o prompt ser exibido, Claude Code registra o plugin e nunca o solicita novamente, independentemente da resposta do usuário.
• Uma vez por sessão: em todas as CLIs da máquina, no máximo um prompt de dica aparece por sessão do Claude Code.

​

Formato da dica

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

​

Requisitos

• Linha própria: a tag deve ocupar sua própria linha. Uma tag incorporada no meio da linha, por exemplo dentro de uma instrução de log, é ignorada. Espaço em branco à esquerda e à direita na linha é permitido.
• Marketplace oficial: o value deve fazer referência a um plugin em um marketplace controlado pela Anthropic, como claude-plugins-official. Dicas que apontam para outros marketplaces são silenciosamente descartadas.

• Escrever para stderr: stderr mantém a tag fora de pipelines de shell, como example-cli deploy | jq. Claude Code verifica ambos os fluxos, portanto stdout também funciona.
• Gate em uma variável de ambiente: emita apenas quando CLAUDECODE ou CLAUDE_CODE_CHILD_SESSION estiver definido. Consulte Emitir a dica para saber como as duas variáveis diferem.

​

Coloque seu plugin no marketplace oficial

​

Veja também

• Criar plugins: construa o plugin que sua CLI recomenda
• Criar e distribuir um marketplace de plugins: hospede plugins fora do marketplace oficial
• Variáveis de ambiente: referência completa para CLAUDECODE e variáveis relacionadas