Попробуйте пример
Примеры на этой странице — это фрагменты, а не готовые моды. Каждый из них — код одного элемента и всего, что в него вложено. Чтобы посмотреть пример в своём терминале, создайте небольшой мод, следуя этим шагам, и вставьте в него пример. Мод добавляет команду/gallery, которая открывает панель и отрисовывает в ней пример. Панель — это боковая область рядом с транскриптом в широком полноэкранном терминале, а в остальных случаях — область в рамке над промптом.
1
Создайте мод
Создайте каталог Укажите точку входа в Сохраните код как
gallery, а внутри него — каталоги .claude-plugin и hooks. Назначение файлов объясняется в разделе Создание мода.Сохраните манифест как gallery/.claude-plugin/plugin.json:gallery/.claude-plugin/plugin.json
gallery/hooks/hooks.json:gallery/hooks/hooks.json
gallery/hooks/register.js. Он добавляет команду /gallery, которая открывает панель, и отрисовывает в ней Plain text:gallery/hooks/register.js
2
Запустите мод
В оболочке запустите Claude Code из каталога, содержащего В промпте Claude Code выполните
gallery:/gallery. Откроется панель с текстом Plain text.3
Подставьте пример
Скопируйте пример с этой страницы. В
register.js вставьте его вместо Text({ children: ['Plain text'] }), чтобы он шёл после return, и сохраните файл. Claude Code перезагружает модуль при каждом сохранении, поэтому снова выполните /gallery, чтобы увидеть новый пример.Выберите элемент
Примеры сгруппированы по тому, что вы хотите вывести на экран:- Вывод текста:
Text,MarkdownиLink - Вывод кода и изменений:
Code - Компоновка элементов:
Box - Ввод данных:
Button,InputиSelect - Рисование изображений:
Raster,Svg,ImageиClient
Вывод текста
Текст на экран выводят три элемента:Text — с вашим собственным оформлением, Markdown — для уже отформатированного содержимого и Link — для URL.
Text
Text отрисовывает строку с заданными вами стилями. В этом примере показаны обычный текст и восемь стилей, каждый на отдельной строке:


dimColor отрисовывает текст серым цветом. backgroundColor заливает фон только по ширине текста.
Markdown
Markdown форматирует текст так же, как форматируются ответы Claude. Передавайте содержимое в text, а не в children:


#. Встроенный код отрисовывается цветом без обратных кавычек. Цитата отрисовывается курсивом с чертой слева.
Link
Link отрисовывает подпись, а за ней — её URL:


Вывод кода и изменений
Code отрисовывает исходный текст с подсветкой синтаксиса в цветах самого Claude Code или diff. В расширении VS Code Code показывает свой source как обычный текст, без цветов, номеров строк и подсветки diff, которые видны на этих снимках экрана.
Code
Укажите язык в language или передайте path, чтобы Claude Code определил язык по нему. С startLine строки нумеруются начиная с этого числа:


Code в виде diff
С format: 'diff' в source передаются один или несколько фрагментов (hunks) в формате unified diff:


@@ Claude Code отрисовывает номера строк. Если удалённая и добавленная строки похожи, изменившиеся слова подсвечиваются ярче.
Компоновка элементов
Box
Box располагает своё содержимое в строку или в столбец и может отрисовывать рамку. В этом примере над блоком в рамке размещается строка слов:


Ввод данных
Button, Input и Select — это элементы управления: пользователь переходит между ними клавишей Tab и работает с тем, на котором находится фокус. Какие клавиши до них доходят, описано в разделе Фокус клавиатуры и горячие клавиши.
Откройте панель с focus: true, чтобы она попыталась получить фокус клавиатуры. Вводимые буквы попадают в Input, как только на нём оказывается фокус. Как выбрать поле, которое получит фокус при открытии панели, описано в разделе Горячая клавиша и первый фокус.
Button
Кнопка вызывает onPress. В этом примере показаны кнопка по умолчанию, кнопка plain с горячей клавишей и приглушённая кнопка:




Input
Input — это текстовое поле, которое по умолчанию содержит одну строку и вызывает onSubmit, когда пользователь нажимает Enter:


⏎ отображается submitLabel:




rows значение 2 или больше для поля, которое содержит несколько строк, например для заметки или сообщения коммита:
rows требуется Claude Code v2.1.301 или новее. В более ранних версиях поле содержит одну строку.
Поле занимает заданное количество строк, даже если оно пустое, но не больше высоты панели или полосы, в которой оно отрисовано. Пока на поле находится фокус, более длинный текст прокручивается внутри него.
- В терминале Enter по-прежнему отправляет ввод. Там пользователь начинает новую строку, вводя обратную косую черту и затем нажимая Enter, или нажимая Shift+Enter, если эмулятор терминала это поддерживает. Это те же клавиши, что и в промпте.
- В терминале клавиши Up и Down перемещают между строками поля. С первой и последней строки они переводят к предыдущему или следующему элементу управления.
onSubmitиonInputполучают весь текст, строки которого объединены через\n.
Select
Select позволяет пользователю выбрать один из нескольких вариантов и вызывает onSelect со значением value выбранного варианта:






Рисование изображений
Raster
Raster — это сетка цветных символьных ячеек для тепловой карты, спарклайна или игрового поля. Его отрисовывает терминал. В этом примере используется функция cellsOf из начального модуля, которая упаковывает ячейки в строку, принимаемую Raster. Подробнее см. в разделе Отрисовка сетки цветных ячеек:


Raster округляет каждый цвет до более ограниченной палитры, поэтому 0x2e7d32 отрисовывается как #337733.
Svg
Svg отрисовывает SVG-документ в приложении Desktop и расширении VS Code:
Svg, открывается пустой. Чтобы отрисовать там что-то другое, проверьте e.surface и верните другое дерево.
Image и Client
Для Image и Client примеров здесь нет. Image отрисовывает PNG или необработанные пиксели в терминале. Client — это область, которую отрисовывает ваш второй файл, для анимации и ввода указателем. Их пропсы перечислены в справочнике по элементам.
Image отрисовывается как картинка в следующих терминалах:
- kitty 0.28 или новее
- Ghostty
- iTerm2 3.5 или новее. Для отрисовки в iTerm2 требуется Claude Code v2.1.305 или новее.
alt элемента Image. Пишите текст alt, который понятен сам по себе, поскольку он также отображается, помимо прочего, в следующих случаях:
- GNU screen: сессия, запущенная внутри screen, в любом терминале.
- tmux: сессия, запущенная внутри tmux, для которой не выполнено одно из требований для отрисовки внутри tmux.
- Фоновые сессии: любая фоновая сессия, из какого бы терминала к ней ни подключались.
- iTerm2 без полноэкранной отрисовки: в iTerm2 картинка отрисовывается только при полноэкранной отрисовке и не отрисовывается, если для
CLAUDE_CODE_ALT_SCREEN_FULL_REPAINTустановлено значение1. Чтобы увидеть картинку, выполните/tui fullscreenв промпте Claude Code и не устанавливайте эту переменную. - Путь к файлу в качестве источника в iTerm2 или tmux: в iTerm2 и внутри tmux элемент
Image, у которогоsourceуказываетfile, показывает текстaltвместо картинки. Если у вашего мода есть пользователи iTerm2 или tmux, передавайте картинку в base64 вsource.pngилиsource.rgba, а не как путь вsource.file.
CLAUDE_CODE_FORCE_TERMINAL_IMAGES значение 1. Не следует устанавливать её внутри GNU screen, внутри tmux старше 3.3, во всплывающем окне tmux или при выключенной опции tmux allow-passthrough. В этих случаях пользователи не увидят картинку, а вместо текста alt увидят рамку.
Отрисовка Image внутри tmux
Если Image показывает текст alt внутри tmux, проверьте следующие требования, а также другие случаи отображения текста alt, например фоновую сессию:
- Claude Code v2.1.310 или новее
- tmux 3.3 или новее
- Claude Code запущен в панели tmux, а не во всплывающем окне tmux
- tmux запущен внутри kitty 0.28 или новее, Ghostty или iTerm2 3.5 или новее
- Опции tmux
focus-eventsиallow-passthroughимеют значениеon. Внутри kitty или Ghosttyallow-passthroughтакже может иметь значениеall. - Внутри iTerm2 tmux запущен без
-CC, полноэкранная отрисовка включена, аCLAUDE_CODE_ALT_SCREEN_FULL_REPAINTне установлена. - Внутри iTerm2 окно tmux не больше окна iTerm2. Чтобы проверить это, выполните
tmux display-message -p '#{window_bigger}'в этом окне tmux. Если команда выводит1, подгоните размер окна tmux, затем перезапустите Claude Code. - Автор мода передаёт картинку как байты
pngилиrgba, а не как путьfile. Если вы используете мод, который написали не вы, и остальные требования выполнены, попросите его автора проверить это требование.
~/.tmux.conf.
Где ещё может отрисовывать мод
Все примеры отрисовываются на панели. Мод также может отрисовывать в других местах и вызывать Claude Code, чтобы тот что-то показал за него:- Панель и полоса: Выбор места для отрисовки
- Собственные строки Claude Code, например индикатор загрузки: Изменение того, что уже отрисовывает Claude Code
- Всплывающее уведомление, строка состояния и строка лога: Показать что-то, не начиная ход
- Диалог с вопросом: Удержание вызова инструмента до решения пользователя
Дальнейшие шаги
- Отрисовка в интерфейсе: пошаговое создание панели с вкладками
- Тестирование отрисовки: нажатие ваших кнопок из теста
- Справочник по элементам: основные свойства каждого элемента и приложения, которые его отрисовывают