Полноэкранная визуализация — это добровольный исследовательский предпросмотр и требует Claude Code v2.1.88 или более поздней версии. Включите её с помощью CLAUDE_CODE_NO_FLICKER=1. Поведение может измениться на основе обратной связи. vim или htop, и отображает только видимые в данный момент сообщения. Это снижает объём данных, отправляемых на ваш терминал при каждом обновлении.
Различие наиболее заметно в эмуляторах терминала, где пропускная способность визуализации является узким местом, таких как встроенный терминал VS Code, tmux и iTerm2. Если позиция прокрутки вашего терминала прыгает в начало, пока Claude работает, или экран мигает при потоковой передаче выходных данных инструмента, этот режим решает эту проблему.
Термин «полноэкранная» описывает то, как Claude Code захватывает поверхность рисования терминала, так же как это делает vim. Это не имеет никакого отношения к максимизации окна вашего терминала и работает при любом размере окна.
Включение полноэкранной визуализации
Установите переменную окружения CLAUDE_CODE_NO_FLICKER при запуске Claude Code:
CLAUDE_CODE_NO_FLICKER=1 claude
~/.zshrc или ~/.bashrc:
export CLAUDE_CODE_NO_FLICKER=1
Что изменилось
Полноэкранная визуализация изменяет способ, которым CLI рисует на вашем терминале. Поле ввода остаётся зафиксированным в нижней части экрана вместо того, чтобы перемещаться при потоковой передаче выходных данных. Если поле ввода остаётся на месте, пока Claude работает, полноэкранная визуализация активна. В дереве визуализации сохраняются только видимые сообщения, поэтому память остаётся постоянной независимо от длины диалога.
Поскольку диалог находится в альтернативном буфере экрана вместо истории прокрутки вашего терминала, несколько вещей работают по-другому:
| До | Сейчас | Подробности |
|---|
Cmd+f или поиск tmux для поиска текста | Ctrl+o затем / для поиска, или Ctrl+o затем [ для записи диалога в собственную историю прокрутки, чтобы Cmd+f снова работал | Поиск и просмотр диалога |
| Встроенное выделение и копирование нажатием и перетаскиванием терминала | Встроенное выделение, копирование автоматически при отпускании мыши | Использование мыши |
Cmd-клик для открытия URL | Клик по URL | Использование мыши |
Использование мыши
Полноэкранная визуализация захватывает события мыши и обрабатывает их внутри Claude Code:
- Клик в поле ввода подсказки для позиционирования курсора в любом месте вводимого вами текста.
- Клик по свёрнутому результату инструмента для его развёртывания и просмотра полного выходного сигнала. Клик снова для свёртывания. Вызов инструмента и его результат развёртываются вместе. Кликабельны только сообщения, которые имеют больше для отображения.
- Клик по URL или пути к файлу для его открытия. Пути к файлам в выходных данных инструмента, такие как те, которые выводятся после Edit или Write, открываются в вашем приложении по умолчанию. Простые
http:// и https:// URL открываются в вашем браузере. В большинстве терминалов это заменяет встроенный Cmd-клик или Ctrl-клик, который захват мыши перехватывает. Во встроенном терминале VS Code и аналогичных терминалах на основе xterm.js продолжайте использовать Cmd-клик. Claude Code уступает собственному обработчику ссылок терминала там, чтобы избежать открытия ссылок дважды.
- Клик и перетаскивание для выделения текста в любом месте диалога. Двойной клик выделяет слово, соответствуя границам слов iTerm2, поэтому путь к файлу выделяется как одна единица. Тройной клик выделяет строку.
- Прокрутка колесом мыши для перемещения по диалогу.
Выделенный текст копируется в буфер обмена автоматически при отпускании мыши. Чтобы отключить это, переключите Copy on select в /config. Если это отключено, нажмите Ctrl+Shift+c для ручного копирования. На терминалах, поддерживающих протокол клавиатуры kitty, таких как kitty, WezTerm, Ghostty и iTerm2, Cmd+c также работает. Если у вас активно выделение, Ctrl+c копирует вместо отмены.
Прокрутка диалога
Полноэкранная визуализация обрабатывает прокрутку внутри приложения. Используйте эти сочетания клавиш для навигации:
| Сочетание клавиш | Действие |
|---|
PgUp / PgDn | Прокрутка вверх или вниз на половину экрана |
Ctrl+Home | Переход в начало диалога |
Ctrl+End | Переход к последнему сообщению и повторное включение автоследования |
| Колесо мыши | Прокрутка на несколько строк за раз |
PgUp, PgDn, Home или End, таких как клавиатуры MacBook, удерживайте Fn с клавишами со стрелками: Fn+↑ отправляет PgUp, Fn+↓ отправляет PgDn, Fn+← отправляет Home, и Fn+→ отправляет End. Это делает Ctrl+Fn+→ сочетанием клавиш для перехода в конец. Если это кажется неудобным, прокрутите в конец колесом мыши, чтобы возобновить следование, или переназначьте scroll:bottom на что-то более доступное.
Прокрутка вверх приостанавливает автоследование, чтобы новый выходной сигнал не тянул вас обратно в конец. Нажмите Ctrl+End или прокрутите в конец, чтобы возобновить следование.
Эти действия переназначаемы. См. Сочетания клавиш для их настройки. Названия действий — scroll:pageUp, scroll:pageDown, scroll:top и scroll:bottom. Дополнительные действия без привязки по умолчанию включают scroll:lineUp, scroll:lineDown, scroll:halfPageUp, scroll:halfPageDown, scroll:fullPageUp и scroll:fullPageDown.
Регулировка скорости прокрутки колеса
Если прокрутка колесом мыши кажется медленной, ваш терминал может отправлять одно событие прокрутки на физический щелчок без множителя. Некоторые терминалы, такие как Ghostty и iTerm2 с включённой более быстрой прокруткой, уже усиливают события колеса. Другие, включая встроенный терминал VS Code, отправляют ровно одно событие на щелчок. Claude Code не может определить, какой из них.
Установите CLAUDE_CODE_SCROLL_SPEED для умножения базового расстояния прокрутки:
export CLAUDE_CODE_SCROLL_SPEED=3
3 соответствует значению по умолчанию в vim и аналогичных приложениях. Параметр принимает значения от 1 до 20.
Поиск и просмотр диалога
Нажмите Ctrl+o для входа в режим стенограммы. При активной полноэкранной визуализации режим стенограммы получает навигацию и поиск в стиле less:
| Клавиша | Действие |
|---|
/ | Открыть поиск. Введите для поиска совпадений, Enter для принятия, Esc для отмены и восстановления позиции прокрутки |
n / N | Переход к следующему или предыдущему совпадению. Работает после закрытия строки поиска |
j / k или ↑ / ↓ | Прокрутка на одну строку |
g / G или Home / End | Переход в начало или конец |
Ctrl+u / Ctrl+d | Прокрутка на половину страницы |
Ctrl+b / Ctrl+f или Space / b | Прокрутка на полную страницу |
Esc, q или Ctrl+o | Выход из режима стенограммы |
Cmd+f вашего терминала и поиск tmux не видят диалог, потому что он находится в альтернативном буфере экрана, а не в собственной истории прокрутки. Чтобы вернуть содержимое вашему терминалу, нажмите Ctrl+o для входа в режим стенограммы сначала, затем:
[: записывает полный диалог в собственный буфер истории прокрутки вашего терминала со всеми развёрнутыми выходными данными инструмента. Диалог теперь является обычным текстом в вашем терминале, поэтому Cmd+f, режим копирования tmux и любой другой встроенный инструмент могут искать или выбирать его. Длительные сеансы могут на момент приостановиться, пока это происходит. Это длится до выхода из режима стенограммы с помощью Esc или q, что возвращает вас к полноэкранной визуализации. Следующий Ctrl+o начинается заново.v: записывает диалог во временный файл и открывает его в $VISUAL или $EDITOR.
Нажмите Esc, q или Ctrl+o для возврата к подсказке.
Использование с tmux
Полноэкранная визуализация работает внутри tmux с двумя оговорками.
Прокрутка колесом мыши требует режима мыши tmux. Если ваш ~/.tmux.conf ещё не включает его, добавьте эту строку и перезагрузите конфигурацию:
Без режима мыши события колеса идут в tmux вместо Claude Code. Прокрутка с клавиатуры с помощью PgUp и PgDn работает в любом случае. Claude Code выводит однократную подсказку при запуске, если обнаруживает tmux с отключённым режимом мыши.
Полноэкранная визуализация несовместима с режимом интеграции tmux в iTerm2, который является режимом, в который вы входите с помощью tmux -CC. В режиме интеграции iTerm2 отображает каждую панель tmux как встроенное разделение вместо того, чтобы позволить tmux рисовать на терминале. Альтернативный буфер экрана и отслеживание мыши не работают правильно там: колесо мыши ничего не делает, и двойной клик может повредить состояние терминала. Не включайте полноэкранную визуализацию в сеансах tmux -CC. Обычный tmux внутри iTerm2 без -CC работает нормально.
Сохранение встроенного выделения текста
Захват мыши — наиболее частая точка трения, особенно по SSH или внутри tmux. Когда Claude Code захватывает события мыши, встроенное копирование при выделении вашего терминала перестаёт работать. Выделение, которое вы делаете с помощью нажатия и перетаскивания, существует внутри Claude Code, а не в буфере выделения вашего терминала, поэтому режим копирования tmux, подсказки Kitty и аналогичные инструменты его не видят.
Claude Code пытается записать выделение в буфер обмена, но путь, который он использует, зависит от вашей установки. Внутри tmux он записывает в буфер вставки tmux. По SSH он возвращается к последовательностям escape OSC 52, которые некоторые терминалы блокируют по умолчанию. Claude Code выводит уведомление после каждого копирования, сообщая вам, какой путь он использовал.
Если вы полагаетесь на встроенное выделение вашего терминала, установите CLAUDE_CODE_DISABLE_MOUSE=1 для отказа от захвата мыши, сохраняя визуализацию без мерцания и плоскую память:
CLAUDE_CODE_NO_FLICKER=1 CLAUDE_CODE_DISABLE_MOUSE=1 claude
PgUp, PgDn, Ctrl+Home и Ctrl+End всё ещё работает, и ваш терминал обрабатывает выделение встроенным образом. Вы теряете клик для позиционирования курсора, клик для развёртывания выходных данных инструмента, клик по URL и прокрутку колесом внутри Claude Code.
Исследовательский предпросмотр
Полноэкранная визуализация — это функция исследовательского предпросмотра. Она была протестирована на распространённых эмуляторах терминала, но вы можете столкнуться с проблемами визуализации на менее распространённых терминалах или необычных конфигурациях.
Если вы столкнулись с проблемой, запустите /feedback внутри Claude Code для её сообщения, или откройте проблему в репозитории claude-code на GitHub. Включите название и версию вашего эмулятора терминала.
Чтобы отключить полноэкранную визуализацию, отмените установку переменной окружения или установите CLAUDE_CODE_NO_FLICKER=0.
