Skip to main content

Documentation Index

Fetch the complete documentation index at: https://code.claude.com/docs/llms.txt

Use this file to discover all available pages before exploring further.

Если вы поддерживаете CLI или SDK и у вас есть плагин в официальном маркетплейсе Anthropic, ваш инструмент может предложить пользователям Claude Code установить этот плагин. Ваш CLI выводит однострочный маркер в stderr, когда обнаруживает, что работает внутри Claude Code. Claude Code читает маркер, удаляет его из вывода и показывает пользователю одноразовое предложение об установке. Claude Code удаляет строку подсказки из вывода команды перед отправкой её модели, поэтому маркер никогда не появляется в разговоре и не учитывается при подсчёте использованных токенов. Протокол не требует дополнительных команд и не изменяет то, что ваш CLI выводит для пользователей вне Claude Code. Эта страница предназначена для разработчиков CLI и SDK. Если вы ищете информацию об установке плагинов, см. Обнаружение и установка плагинов.

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

Claude Code устанавливает переменную окружения CLAUDECODE в значение 1 для каждой команды, которую он запускает через инструменты Bash и PowerShell. Когда ваш CLI видит эту переменную, он выводит самозакрывающийся тег <claude-code-hint /> в stderr. Когда Claude Code получает вывод команды, он:
  1. Сканирует строки подсказок и удаляет их перед тем, как вывод достигнет модели
  2. Проверяет, что подсказка указывает на плагин в официальном маркетплейсе Anthropic
  3. Проверяет, что плагин ещё не установлен и на него не было предложения ранее
  4. Показывает пользователю предложение об установке, в котором указана команда, выведшая подсказку
Claude Code никогда не устанавливает плагин автоматически. Пользователь всегда подтверждает.

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

Обусловьте вывод переменной окружения CLAUDECODE, чтобы маркер никогда не появлялся в терминале обычного пользователя. Затем выведите тег в stderr на отдельной строке. Следующие примеры выводят подсказку для плагина с именем example-cli в официальном маркетплейсе: 
if (process.env.CLAUDECODE) {
  process.stderr.write(
    '<claude-code-hint v="1" type="plugin" value="example-cli@claude-plugins-official" />\n',
  )
}
Замените example-cli на имя вашего плагина в официальном маркетплейсе.

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

Вы контролируете, какие пути кода выводят подсказку. Claude Code дедублицирует по плагину, поэтому вывод при каждом вызове не имеет никаких недостатков. Хорошо работают следующие точки:
РазмещениеПочему это работает
Вывод --helpClaude часто запускает справку при изучении незнакомого CLI
Ошибки неизвестной подкомандыДостигает момента, когда Claude запутался в вашем интерфейсе
Успешный вход или аутентификацияПользователь уже находится в режиме настройки
Приветственное сообщение при первом запускеЕстественный момент адаптации

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

Когда подсказка проходит все проверки, Claude Code показывает приглашение, подобное следующему: 
─────────────────────────────────────────────────────────────
  Рекомендация плагина

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

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

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

─────────────────────────────────────────────────────────────
Приглашение указывает команду, которая произвела подсказку, чтобы пользователи могли заметить несоответствие между инструментом и плагином, который он рекомендует. Если пользователь не ответит в течение 30 секунд, приглашение закрывается как Нет. Частота приглашений ограничена:
  • Один раз на плагин: после того как приглашение показано, Claude Code записывает плагин и никогда больше не предлагает его, независимо от ответа пользователя.
  • Один раз за сеанс: на всех CLI на машине одновременно может появиться максимум одно приглашение подсказки за сеанс Claude Code.
Выбор Да устанавливает плагин в область пользователя. Выбор Нет, и больше не показывать предложения об установке плагинов отключает все будущие приглашения подсказок для пользователя.

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

Подсказка — это самозакрывающийся тег с тремя обязательными атрибутами. 
<claude-code-hint v="1" type="plugin" value="example-cli@claude-plugins-official" />
АтрибутОбязательныйОписание
vДаВерсия протокола. 1 — единственное поддерживаемое значение
typeДаТип подсказки. plugin — единственное поддерживаемое значение
valueДаИдентификатор плагина в форме name@marketplace
Значения атрибутов могут быть заключены в двойные кавычки или оставлены без кавычек. Значения без кавычек не могут содержать пробелы. Последовательности экранирования не поддерживаются.

​
Требования

Claude Code применяет два условия перед действием на основе подсказки. Подсказки, которые не проходят ни одну из проверок, отбрасываются:
  • Отдельная строка: тег должен занимать отдельную строку. Тег, встроенный в середину строки, например внутри оператора логирования, игнорируется. Пробелы в начале и конце строки допускаются.
  • Официальный маркетплейс: value должен ссылаться на плагин в контролируемом Anthropic маркетплейсе, таком как claude-plugins-official. Подсказки, указывающие на другие маркетплейсы, молча отбрасываются.
Строка подсказки всегда удаляется из вывода перед тем, как она достигнет модели, даже если версия или тип не распознаны, поэтому маркер никогда не учитывается при подсчёте использованных токенов. Остальные рекомендации рекомендуются, но не обязательны. Claude Code не может наблюдать, следует ли ваш CLI им:
  • Выводите в stderr: stderr держит тег вне конвейеров оболочки, таких как example-cli deploy | jq. Claude Code сканирует оба потока, поэтому stdout также работает.
  • Обусловьте на CLAUDECODE: выводите только когда установлена переменная окружения CLAUDECODE. Это предотвращает появление маркера для пользователей, запускающих ваш CLI напрямую.

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

Протокол подсказок вступает в силу только для плагинов, которые указаны в официальном маркетплейсе Anthropic. Чтобы отправить плагин, используйте одну из встроенных форм отправки: Если вы работаете с контактом партнёра Anthropic, свяжитесь с ним для координации листинга.

​
См. также