Рекомендуйте ваш плагин из вашего CLI

​

Как это работает

1. Сканирует строки подсказок и удаляет их перед тем, как вывод достигнет модели
2. Проверяет, что подсказка указывает на плагин в официальном маркетплейсе Anthropic
3. Проверяет, что плагин ещё не установлен и на него не было предложения ранее
4. Показывает пользователю предложение об установке, в котором указана команда, выведшая подсказку

​

Выведите подсказку

• CLAUDECODE: устанавливается в каждой версии Claude Code, поэтому достигает большинства сеансов. Она также устанавливается в tmux сеансах и подпроцессах stdio MCP сервера, которые запускает Claude Code. Расширения IDE также устанавливают её в своих интегрированных терминалах, где пользователь может запускать ваш CLI напрямую.
• CLAUDE_CODE_CHILD_SESSION: устанавливается только в подпроцессах, которые сам Claude Code порождает, таких как вызовы инструментов, команды hook и команды строки состояния, поэтому тег обычно не достигает терминала пользователя. Долгоживущий процесс, запущенный внутри сеанса, такой как tmux сервер, захватывает переменную, поэтому оболочки, позже запущенные из этого процесса, всё ещё показывают необработанный тег. Требует Claude Code v2.1.172 или позже, поэтому сеансы на более старых версиях пропускают подсказку.

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

​

Выберите место для вывода

​

Что видит пользователь

─────────────────────────────────────────────────────────────
  Рекомендация плагина

    Команда example-cli предлагает установить плагин.

    Плагин: example-cli
    Маркетплейс: claude-plugins-official
    Официальная интеграция для развёртываний example-cli

    Хотите ли вы установить его?
    ❯ 1. Да, установить example-cli
      2. Нет
      3. Нет, и больше не показывать предложения об установке плагинов

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

• Один раз на плагин: после того как приглашение показано, Claude Code записывает плагин и никогда больше не предлагает его, независимо от ответа пользователя.
• Один раз за сеанс: на всех CLI на машине одновременно может появиться максимум одно приглашение подсказки за сеанс Claude Code.

​

Формат подсказки

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

​

Требования

• Отдельная строка: тег должен занимать отдельную строку. Тег, встроенный в середину строки, например внутри оператора логирования, игнорируется. Пробелы в начале и конце строки допускаются.
• Официальный маркетплейс: value должен ссылаться на плагин в контролируемом Anthropic маркетплейсе, таком как claude-plugins-official. Подсказки, указывающие на другие маркетплейсы, молча отбрасываются.

• Выводите в stderr: stderr держит тег вне конвейеров оболочки, таких как example-cli deploy | jq. Claude Code сканирует оба потока, поэтому stdout также работает.
• Обусловьте на переменной окружения: выводите только когда установлена переменная окружения CLAUDECODE или CLAUDE_CODE_CHILD_SESSION. Смотрите Выведите подсказку, чтобы узнать, чем отличаются эти две переменные.

​

Добавьте ваш плагин в официальный маркетплейс

​

См. также

• Создание плагинов: создайте плагин, который рекомендует ваш CLI
• Создание и распространение маркетплейса плагинов: размещайте плагины вне официального маркетплейса
• Переменные окружения: полный справочник по CLAUDECODE и связанным переменным